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


SSH Console

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

Establishing connection with SSH



Calaos-OS use 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


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

Replace the interface name using the one listed by the first command.


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="">
    <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" />

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.

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:

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"

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.