Ciao Setup

Requirements

To run Ciao you will need:

  • Ciao: 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. 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.
  • an Internet connection for you board, via WiFi or Ethernet. Click here if you want a guide to configure the board.

Install Ciao

You have more than one way to install Ciao. Anyway after installing Ciao Core you have to enable and configure connectors you want to work with.
Ciao is compatible with all version of LininoOS but you will need to install it manually.

Via Package Manager

Login by means of SSH into the board and at the shell prompt :

   Owners of Arduino Yun, Yun-Mini, Chiwawa and Linino ONE :
  • If your main control panel is the red coloured one (the old version) please run from shell the following commands :
$ opkg update
$ opkg upgrade luci-webpanel-linino python python-mini
$ opkg install ciao
$ reboot
  • If your control panel is arduinoos, the jade green coloured one, please run from shell the following commands :
$ opkg update
$ opkg upgrade arduinoos python python-mini
$ opkg install ciao
$ reboot

please take in consideration that luci-webpanel-linino and arduinoos can’t coexist together, so please be careful if you ever decide to switch to one or the other.

   Owners of Arduino Tian :
please run from shell the following commands :

$ opkg update
$ rm /etc/udev/udev.conf
$ opkg upgrade arduinoos udev python-base python-light
$ opkg install ciao
$ reboot

Upgrading from a previous installed version

If by any chance you have already installed Ciao on your system please follow these steps to upgrade it to the latest version. Login by means of SSH into the board and at the shell prompt :

   Owners of Arduino Yun, Yun-Mini, Chiwawa and Linino ONE :

  • If your main control panel is the red coloured one (the old version) please run from shell the following commands :
$ opkg update
$ opkg upgrade ciao luci-webpanel-linino python python-mini
4 reboot

  • If your control panel is arduinoos, the jade green coloured one, please run from shell the following commands :
$ opkg update
$ opkg upgrade ciao arduinoos python python-mini
$ reboot

please take in consideration that luci-webpanel-linino and arduinoos can’t coexist together, so please be careful if you ever decide to switch to one or the other.

   Owners of Arduino Tian :

please run from shell the following commands :

$ opkg update
$ rm /etc/udev/udev.conf
$ opkg upgrade ciao arduinoos udev python-light python-base
$ reboot

should something not working properly, please get in touch with us and report the issue.

Via Luci Web 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.

Linino Web panel: Log in   

Insert your password to enter in the Configuration Panel, click on Configure Button.

Linino web panel: configuration panel   

Enter in the Luci panel clicking on advanced configuration panel (luci).
It will appear the below screen.

Luci panel  

Select the System menu and the Software as submenu.

Software menu  

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.

Ciao installation     

Wait that the installation is completed, it will appear this screen:

Ciao installed  

Now Ciao is installed.

Via Arduino OS

If you have an Arduino OS installed on your board, you can use Arduino Package Manager to install Arduino Ciao.
Access in Arduino OS, open a browser and enter the board ip address or the boardname.local/.


Arduino OS: Log in
Enter your password and press LogIn button to enter in Arduino OS.

Arduino OS: Home
To install Ciao via Arduino OS are two ways: using the Luci Panel or via Package Manager,  both the applications attainable from  Application>Arduino menu.
The first way is already been described previously then below it is shown how to install Ciao via Package Manager.
The operations to follow are simple.
Select the Arduino Package Manager from Applications>Arduino menu, as shown in the image.

Arduino OS: package manager
Click on and it will appear the Arduino Package Manager Panel.
Select the Ciao package and press the Install button to start the Ciao installation.

Arduino OS: Ciao installation
Wait until the operation is completed.

Arduino OS: Ciao installation package
Now Ciao is been correctly 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.

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