Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:quick_start_guide [2014/05/23 08:42]
naguirre [Connecting to the Rpi]
en:quick_start_guide [2016/01/13 20:28] (current)
Line 2: Line 2:
  
 ====== Raspberry pi quick start guide ====== ====== Raspberry pi quick start guide ======
-===== What you will need =====+===== What you need =====
   * A computer with Linux, MacosX or Windows   * A computer with Linux, MacosX or Windows
   * A Raspberry pi, Model B   * A Raspberry pi, Model B
-  * An SD Card, We recommend an 2GB class SD card +  * An SD Card, We recommend an 2GB class 10 SD card (class 4 can be broken much more quickly) 
-  * Download the latest official calaos image for raspberrypi :[[ http://calaos.fr/download/experimental/calaos-image-raspberrypi-2014-04-28.tar.xz]]+  * Download the latest official calaos image for raspberrypi :[[http://www.calaos.fr/download/stable/calaos-os/raspberrypi/]] 
 + 
 +====== Creating the SD card with calaos os ======  
  
-==== Creating the SD card with calaos os ==== 
 === Linux === === Linux ===
 Launch a terminal and go in the directory where you download the calaos os image. Launch a terminal and go in the directory where you download the calaos os image.
  
    $ cd ~/Downloads    $ cd ~/Downloads
-   $ tar xvf calaos-image-raspberrypi-2014-04-28.tar.xz+   $ tar xvf calaos-image-raspberrypi-v2.0.tar.xz
  
 Insert the sdcard into the sdcard reader of your PC. Insert the sdcard into the sdcard reader of your PC.
-You need to know what's the device created by linux when the card is inserted. The device name is something like /dev/sdX or /dev/mmcblkX.+You need to know which device was created by linux when the card was inserted. The device name is something like /dev/sdX or /dev/mmcblkX.
 To know the exact name use the following command : To know the exact name use the following command :
  
Line 32: Line 34:
 We need to ensure that this device is not mounted on your system We need to ensure that this device is not mounted on your system
  
-   $ sudo unmount /dev/mmvblk0p1 +   $ sudo umount /dev/mmvblk0p1 
-   $ sudo unmount /dev/mmvblk0p2+   $ sudo umount /dev/mmvblk0p2
    ...    ...
  
 or in case your device is detected as /dev/sdX or in case your device is detected as /dev/sdX
  
-   $ sudo unmount /dev/sdd1 +   $ sudo umount /dev/sdd1 
-   $ sudo unmount /dev/sdd2+   $ sudo umount /dev/sdd2
    ...    ...
  
Line 48: Line 50:
 No sdcard must appears in the resulting list. No sdcard must appears in the resulting list.
  
-Let's now copy the **calaos os** on the sdcard+Let's now copy **calaos os** on the sdcard
  
-   sudo dd if=calaos-image-raspberrypi-2014-04-28.sdimg of=/dev/mmcblk0 +   sudo dd if=calaos-image-raspberrypi-v2.0-20150214101639.rootfs.rpi-sdimg of=/dev/mmcblk0
- +
-Once the operation is terminated, you can remove the sdcard, and insert it in the Raspberry pi.+
  
 +Once the operation is completed, you can remove the sdcard, and insert it in the Raspberry pi.
  
 === Macos === === Macos ===
  
-You can use ApplePi-Baker. It's a free utility tha allows you to write an image to the sdcard.+You can use ApplePi-Baker. It's a free utility that allows you to write an image to the sdcard.
 It can be download here : [[http://www.tweaking4all.com/downloads/raspberrypi/ApplePi-Baker.zip]] It can be download here : [[http://www.tweaking4all.com/downloads/raspberrypi/ApplePi-Baker.zip]]
 +
  
 === Windows === === Windows ===
 You can use Win32DiskImager. You can download it here : [[http://sourceforge.net/projects/win32diskimager/]] You can use Win32DiskImager. You can download it here : [[http://sourceforge.net/projects/win32diskimager/]]
  
-==== Connecting to the Rpi ====+====== Connecting to the Rpi ====== 
  
-When you boot the raspberrypi, the network is configure to use dhcp, so you need to know what's the address the dhcp server give you. Or if you are using MacOS or Linux, you may try to connect to it with : +When you boot your raspberrypi, the network is configured to use dhcp, so you need to know what IP address the DHCP server gave to the Pi. Or if you are using MacOS or Linux, you may try to connect to it with : 
  
    ssh root@rasberrypi    ssh root@rasberrypi
Line 78: Line 80:
 NOTE : on Linux and MacosX you can use the Terminal to use ssh. On windows you need a program like putty to connect to the raspberrypi : [[http://www.putty.org/]] NOTE : on Linux and MacosX you can use the Terminal to use ssh. On windows you need a program like putty to connect to the raspberrypi : [[http://www.putty.org/]]
  
-==== Calaos Server configuration ====+======  Calaos Server configuration ====== 
  
-The first thing you have to do is to set the basics paramterers of your calaos installation : username and password.+You can set the basic parameters of your calaos installation : username and password.
  
     $ calaos_config set cn_user nico     $ calaos_config set cn_user nico
     $ calaos_config set cn_pass calaos_rox     $ calaos_config set cn_pass calaos_rox
  
-These user and password it those that you wille to use to connect with Calaos Web, Calaos Home or Calaos Installer. +These user and password are those that you will use to connect from Calaos Web, Calaos Home or Calaos Installer. 
-By default when you boot the raspberrypi with a **Calaos OS** image, calaos-server is not launched. You can launch it with command + 
 +Restart calaos_server to take this new parameters into account :  
 + 
 +    $ systemctl restart calaos_server 
 + 
 +To see if everything is working fine with calaos server, you can try to connect to the server via Calaos Web. Start your favorite web browser and connect to http://raspberrypi or http://ip_address     
 +You should be able to login, but nothing is displayed in the interface. It's completely **normal** as we don't have configured the whole installation yet. What we need now is to create the configuration of our houseand Calaos Installer will be used for that. 
 + 
 +======  House configuration with Calaos Installer ======  
 + 
 +Calaos Installer is an application for Linux, Macos X and Windows. 
 +You can download it here : [[http://www.calaos.fr/download/stable/calaos_installer/]] 
 + 
 +Install calaos-installer for you OS from this page, and launch it. 
 + 
 +On the interface, you should find a **Autodetection** button. Click on it. It launched the discovery process of Calaos Server trough the network. 
 +If Calaos Server is found, the IP address is displayed in the Window. You can then double click on it and connect to Calaos Server with the credentials you fixed in the first section of this guide. 
 + 
 +You can now add the Input/Output with calaos-installer depending on the Hardware connected to calaos-server. 
 +  
 +{{ :fr:calaos-installer.jpg?nolink |}} 
 + 
 +Click Calaos Server->Download Project from Calaos Server. 
 +This action download the configuration on the raspberry pi on your local machine to edit it. 
 + 
 +{{ :fr:ci_connection.jpg?nolink |}} 
 + 
 +You can put here the IP address (This address should have bee insert if audetection process has worked). Put also the user and password you give in the first part. Default values are user/pass 
 + 
 +If the download is ok, the connection between the raspberry-pi and your local PC is ok.  
 + 
 +Now add a new Room :  Click on  add Item -> Room 
 +And enter a friendly name for the new room. 
 + 
 +Now create a new virtual swith :  
 +add Item -> Internal Variable. 
 + 
 +Enter informations as on this screenshot: 
 + 
 +{{ :fr:ci-button.jpg?nolink |}}
  
-   systemctl start calaos-server+Save the confoguration, and send it to the raspberry-pi with :  Calaos Server -> Send project to calaos server.
  
-If you want it activated each time you start the cardenable the launch at startup with the following command :+You can see if everyhting is up and working, by connecting yourself to the web interface : (http://ip_raspberrypi)you may also use the mobile application or Calaos Home application. 
 +Here the result on the following interfaces :  
 +Calaos Home : 
 +{{ :fr:ch-interrupteur.jpg?nolink |}}
  
-   systemctl enable calaos-server +Calaos Web : 
-    +{{ :fr:cwa-interrupteur.jpg?nolink |}}
-To see if everything is fine with calaos server, you can try to connect to the server vie Calaos Web. Launch your favorite web browser and connect to http://raspberrypi or http://ip_address     +
-You should be able to login, but nothing is displayed in the interface. It's totally **normal** as we actually not configure the whole installation yet. What we need know is create the configuration of our house, and we will use Calaos Installer for that.+
  
-==== House configuration with Calaos Installer ====+Calaos Mobile : 
 +{{ :fr:cm-interrupteur.jpg?nolink |}}
  
 +You know now how to create I/O for Calaos. You can now create you complete Home Automation installation, depending on the hardware you own.