Per programmare il microcontrollore delle board arancino.cc ed arancino.cc mignon è necessario utilizzare l’ambiente di sviluppo Arduino IDE, configurandolo secondo la procedura descritta nella pagina “Installazione arancino.cc” della sezione Getting Started.
Ultimata la configurazione delle board, è necessario scegliere a quale dei due tipi di scheda inviare il codice (sketch), come mostrato in fig.1:
Il programma, denominato sketch (dall’inglese schizzo), è un codice scritto in un linguaggio derivato dal C/C++ detto Wiring.
La struttura base di uno sketch, che a differenza di un file scritto in C presenta estensione “.ino”, è principalmente costituita da due funzioni, setup() e loop() (fig.2):
Nella funzione setup() si implementa il codice responsabile del corretto funzionamento del programma, in quanto è la prima funzione ad essere invocata una volta eseguito lo sketch.
Si definiscono ed inizializzano quindi tutte le costanti e le variabili, si implementano le funzioni e si impostano i parametri per i vari tipi di connessione alle board arancino.
La funzione loop() è invocata immediatamente dopo la funzione setup(), e contiene il codice principale dello sketch, che deve essere eseguito ciclicamente.
Qualsiasi sketch scritto per le board arancino deve iniziare con l’istruzione “#include <Arancino.h>”, per poter usufruire di tutte le funzionalità disponibili nelle “Arancino Library“.
Arduino IDE presenta inoltre una sezione Esempi all’interno della voce File, comprendente una serie di sketch pronti per essere eseguiti, come mostrato in fig. 3:
Nel linguaggio Wiring esistono delle parole chiavi non presenti nel linguaggio C, unicamente utilizzate per programmare il microcontrollore delle board come arancino.cc. In particolare distinguiamo:
Costanti:
- HIGH e LOW permettono di gestire le porte della board arancino.cc, ad esempio per attivare (HIGH) o disattivare (LOW) un pin della scheda, assegnandogli rispettivamente il valore logico 1 o 0;
- INPUT e OUTPUT sono utilizzate per definire una porta in modalità di ingresso (INPUT collegato ad un sensore) o uscita (OUTPUT collegato ad un attuatore) .
Funzioni:
Esistono alcune funzioni predefinite necessarie ad interagire con i sensori e gli attuatori connessi alla scheda arancino, o per l’esecuzione di calcoli da parte del microcontrollore. Alcune di esse sono già presenti in Arduino IDE, altre più specifiche per le board arancino.cc sono disponibili nella Arancino Library. Tra le principali funzioni utilizzate possiamo distinguere tra funzioni di Input/Output digitale ed analogico (pinMode, digitalWrite, digitalRead, analogWrite, analogRead), di comunicazione seriale (Serial.begin, Serial.print, Serial.available, Serial.write), per comunicare con il monitor seriale o con i dispositivi connessi alle porte seriali della scheda, e tante altre funzioni consultabili alla pagina reference del sito arduino.cc.