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:
# lininoio stop # opkg update # opkg install ciao
That will install the latest available version of Ciao Core and default Ciao Connectors.
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.
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
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".
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.
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
# 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