====== CALAOS-OS ======

Calaos-OS is a Linux distribution derived from Yocto/OpenEmbedded.  It does include all the necessary software for a Calaos home automation installation.

Available software package are disable by default and need to be activated on the the first use.

==== Available software ====

  * calaos-server
  * calaos-home
  * calaos-webapp

===== Configuration =====

==== SSH Console ====
For setting up Calaos-OS you need to connect using SSH to your Calaos server.

[[en:centrale_ssh|Establishing connection with SSH]]


==== Commands ====
=== systemctl ===

Calaos-OS use [[http://fr.wikipedia.org/wiki/Systemd|systemd]] for managing its services. So you can easily activate/desactivate calaos-server or calaos-home by using the following commands:

  systemctl enable calaos-server
  systemctl disable calaos-server

Or for calaos-home:
  systemctl enable calaos-home
  systemctl disable calaos-home

=== journalctl ===

This command is used to see system log for every services. You can see the logs of calaos-server:

  journalctl -lu calaos-server

You can also see calaos-home log (less useful in general, but can help for some cases):

  journalctl -lu calaos-home

=== Setting up network interfaces ===

Calaos-OS use now "connman" to manage network interface. You should do:
  connmanctl services
To display the list of network interfaces. For example "ethernet_000c29f63a80_cable" for an Ethernet card, MAC address and "cable" for a wired connexion.
The manual configuration is done via the following command:

  connmanctl config ethernet_000c29f63a80_cable --ipv4 manual 192.168.0.100 255.255.255.0 192.168.0.254
Replace the interface name using the one listed by the first command.


=== calaos_config ===

The first run of calaos-server will automatically create the configuration files in /etc/calaos.

   system start calaos-server

The important file is /etc/calaos/local_config.xml who hold the default name and password, "user" et "pass".

    <?xml version="1.0" encoding="UTF-8" ?>
      <calaos:config xmlns:calaos="http://www.calaos.fr">
      <calaos:option name="show_cursor" value="true" />
      <calaos:option name="dpms_enable" value="false" />
      <calaos:option name="smtp_server" value="" />
      <calaos:option name="cn_user" value="user" />
      <calaos:option name="cn_pass" value="pass" />
      <calaos:option name="longitude" value="2.322235" />
      <calaos:option name="latitude" value="48.864715" />
    </calaos:config>

They can be changed by the following commands:

   calaos_config set cn_user user
   calaos_config set cn_pass pass

To properly setup calaos options (like user name, password, mail server), you must use **calaos_config**.

[[en:centrale_console|Setup with calaos_config]]

==== Connecting the screen ====

=== RS232 touch screen ===

You can use a RS232 touch screen panel with either an RS232 port on the mainboard or using an Serial<->USB converter. You can use converter compatible with Linux like: [[http://www.ldlc.com/fiche/PB00144601.html]]

To use the serial port, you need to activate a systemd service:

For an Serial<->USB adaptor:
  systemctl enable usb-serial-touchscreen@ttyUSB0
  
For an integrated serial port:
  systemctl enable usb-serial-touchscreen@ttyS0

=== USB touchscreen ===

An USB touchscreen panel will be automatically detected when pluged in. No further action is required. If it doesn't work, the driver is not available for Linux.

==== Calibrating the touchscreen ====

To calibrate the screen, you need to run the following command:

  DISPLAY=:0 xinput_calibrator

Then you need to look and interact with the screen as asked. Once done, you need to go back to the console and take note of the returned values.

You should then create a file **90-calib.conf** with the following content:

  Section "InputClass"
        Identifier      "calibration"
        MatchProduct    "XXXXXXXX"
        Option  "Calibration"   "YYYYYYYYY"
        Option  "SwapAxes"      "0"
  EndSection

The XXXX and YYYY values must be replaced with the one returned by xinput_calibrator.

Once this file has been created, you need to move in into **/usr/share/X11/xorg.conf.d/90-calib.conf**

Now you can restart the server.