Ciao setup


To run Ciao you will need:

  • Ciao Core: it can be installed, via package manager or from source, more information are provided below;
  • Ciao Library: it's available in the Arduino IDE since version 1.7.7 and in the Arduino Studio since version 0.0.4. It can also be added manually by importing the library, following more details; 
  • a compatible board: check this link to verify the list of boards compatible with Ciao.


Install Ciao Core

You can install Ciao in two ways or using package manager or via Luci panel.
Note: after installing Ciao Core you have to enable and configure connectors you want to work with.

Via package manager

Ciao is compatible with all version of LininoOS but you will need to install it manually.

In your LininoOS command line run the following commands:

LininoOS command line
# lininoio stop
# opkg update
# opkg install ciao

That will install the latest available version of Ciao Core and default Ciao Connectors.

Note: if you want to update Linino OS to the latest version please follow this istructions or if you want to upgrade your Linino OS with Linino IO follow this guide.

Warning: Be sure that your board is connected to a network, via Ethernet cable or WiFi network. Click here  if you want a guide to configure the board.

Via Luci Panel

Be sure that you have already configured your board.
If you haven't yet configured then follow this guide .
Connect your pc to the same network that you have used to configure your board.
Open a browser and insert the board address or nameboard.local/ , if you don't remember  the board address and you can't access to the board from browser then follow this simple guide .
Insert your password to enter in the Configuration Panel, click on Configure Button.
Enter in the Luci panel clicking on advanced configuration panel(luci).
It will appear the below screen.
Select the System menu and the Software as submenu.
Click on Update lists button.
After select the Available packages menu, click on the C submenu and look the Ciao file.
Click on Install and confirm the installation clicking OK.
Wait that the installation is completed, it will appear this screen:
Now Ciao is installed.

From source

The procedure to install Ciao Core from source is a bit too tricky at the moment, Arduino.org Dev Team is working hard to simplify it. Stay tuned for updates!

Install Ciao Library

Arduino IDE

To import Ciao Library manually first download the latest version from GitHub and unzip it.

Inside Arduino IDE go to "Sketch" > "Import Library" > "Add Library" and select the folder where you unzipped Ciao Library. Finally the library is available by selecting "Sketch" > "Import Library".

Note: if your Arduino IDE is older than the version indicated inside requirements and you prefer to get a newer version instead of installing Ciao Library manually, visit arduino.org/downloads .

Arduino Studio

At the time this article is written, the Arduino Studio version is 0.0.4 and the "Import Library" feature is still a work in progress.

It will be available soon though.

Common issues

Ciao Core or connectors do not start

Ciao Core is handled (started/stopped) by the sketch that runs over MCU, please verify: 

  • on MCU: the Ciao.begin() method is called inside setup block of the sketch you're running;
  • on LininoOS: there is at least one connector enabled inside /usr/lib/python2.7/ciao/conf/.

During communication between MCU and MPU I keep receiving unrequired text from system log

It could happen, if something went wrong while installing ciao package, that some LininoOS values are not updated correctly causing syslog message to flow inside serial communication.

To prevent and fix such issue open a command line and the following steps:

1. open the /etc/sysctl.conf file

LininoOS command line
# vi /etc/sysctl.conf

2. add or updatekernel.printk row as follows

kernel.printk = 3 4 1 7

3. reload sysctl configuration (or simply reboot the board):

# sysctl -p