Arduino

Moduli XBee

Sfruttiamo due moduli XBee per una comunicazione seriale senza fili

I moduli XBee, prodotti da DIGI, permettono la comunicazione bidirezionale tra due o più moduli attraverso radiofrequenze. La radiofrequenza più comune su questi moduli è 2.4GHz, poiché è quella approvata da tutti i paesi, inoltre la modalità di funzionamento più diffusa prende il nome di Transparent Mode e prevede che due moduli comunichino tra loro in seriale senza fili. Questo ci permette quindi di sostituire un collegamento seriale cablato (UART) con un collegamento radio. Ogni modulo, pertanto, possiede un indirizzo univoco e lavora su un ben preciso canale di comunicazione evitando così possibili interferenze tra più moduli presenti in un’area ristretta. Infine, i moduli XBee presentano periferiche proprie di GPIO , convertitori ADC e output PWM, senza la necessità di utilizzare un microcontrollore per la gestione del modulo stesso.

I moduli XBee funzionano a 3.3V e i loro ingressi non tollerano 5 V: se non si utilizzano shield o adattatori che integrano regolatore e traslatore di livello, per collegarli a un microcontrollore a 5 V (come Arduino UNO o Mega) sarà necessario effettuare un adattamento dei livelli logici. La linea TX del microcontrollore, che va al pin DIN dell’XBee, deve essere abbassata a 3,3 V con un partitore resistivo (ad esempio 1 kΩ in serie e 2 kΩ verso GND, che danno circa 3,3 V) oppure con un traslatore di livello a MOSFET come il BSS138. La linea DOUT dell’XBee, che va al pin RX del microcontrollore, di norma funziona anche senza adattamento, perché 3,3 V vengono riconosciuti come livello alto da un ATmega alimentato a 5 V (vedi le soglie negli input digitali di Arduino). Anche l’alimentazione a 3,3 V deve essere adeguata: i moduli Pro in trasmissione assorbono fino a circa 215 mA, molto più dei 50 mA disponibili sul pin 3,3 V di Arduino UNO R3.

Nota sulla potenza in Europa: nella banda 2,4 GHz la potenza massima ammessa in Europa è di 100 mW (20 dBm) EIRP, cioè potenza del modulo più guadagno dell’antenna. Con i moduli XBee-PRO occorre quindi usare la versione “international” a potenza ridotta prevista da Digi per l’Europa, oppure limitare la potenza con il parametro PL e scegliere l’antenna in modo da restare entro il limite.

In questa guida verranno utilizzati:

  • Moduli XBee S1
  • Scheda ArduinoUNO
  • Scheda ArduinoMega
  • Arduino Xbee Shield
  • Xbee adapter

Protocollo 802.15.4 vs Protocollo ZigBee

Il protocollo standardizzato IEEE 802.15.4 presenta come punti di forza una facile connettività associata ad una discreta velocità di comunicazione alle frequenze prestabilite dall’ISM (Industrial, Scientifical and Medical, le frequenze interessate sono 868-868.6 MHz per l’Europa, 902-928 MHz per gli USA e 2.400-2.4835 GHz ovunque).  Essendo la frequenza 2.4GHz approvata in tutto il mondo è quella più diffusa sui moduli commerciali. Le modalità di comunicazione possono essere:

  • point-to-point: due moduli comunicano unicamente tra di loro in modo bidirezionale
  • point-to-multipoint: un modulo coordinatore (master) crea e gestisce la rete a cui appartengono vari moduli slave (end devices).

Con i moduli XBee 802.15.4 il coordinatore è opzionale (parametro CE): i moduli possono anche comunicare direttamente tra loro, indicando l’indirizzo del destinatario in DH/DL oppure in broadcast (DH = 0, DL = FFFF). In una rete ZigBee, invece, è obbligatorio che un modulo sia configurato come coordinatore.
NB. I moduli XBee S1 sfruttano il protocollo IEEE 802.15.4.

Il protocollo ZigBee, invece, è stato sviluppato dalla ZigBee alliance che include molteplici produttori e sviluppatori. Si basa sul protocollo IEEE 802.15.4 ma porta con sé delle peculiarità molto importanti tra cui la connessione di tipo mesh: ogni modulo può fungere da router per rimbalzare il messaggio tra due unità molto distanti tra loro. I moduli si adattano alla rete creando automaticamente nodi di scambio e se qualche modulo dovesse venire disattivato il sistema lo rileva e i moduli rimanenti si riorganizzano in automatico per mantenere attiva e funzionante la rete.

I sistemi ZigBee sono implementati nei moduli XBee S2 e prevedono la gestione del protocollo lato software su due fronti: ZNET 2.5 (ormai obsoleto) e ZB (ZigBee 2007).

Configurazione di un modulo

Il software per la gestione di questi moduli è X-CTU, oggi disponibile per macOS, GNU/Linux e Microsoft Windows. Essendo un software multipiattaforma l’interfaccia grafica è uguale su tutti i sistemi operativi.

Download X-CTU: https://www.digi.com/

Una volta in possesso del software abbiamo bisogno di connettere il modulo XBee al nostro computer. In questa guida noi utilizzeremo un semplice XBee adapter, il quale ha un costo di pochi euro e permette di collegare direttamente il modulo XBee S1 / S2 PRO al computer mediante cavo usb. Sulla scheda dell’adattatore troviamo un sistema di riduzione della tensione da 5V a 3.3V e l’adattamento di tensione per le linee di comunicazione TX e RX.

Una volta in possesso di questi due strumenti possiamo procedere con la configurazione. Per prima cosa connettiamo il modulo XBee al computer, dopodiché apriamo il software X-CTU il quale si mostrerà come segue:

Schermata iniziale del software XCTU

Andiamo quindi a premere la seconda icona in alto a sinistra (dove c’è rappresentato il modulo XBee con la lente d’ingrandimento) e avviamo la ricerca sulla porta usb interessata. Se il modulo è vergine e non è mai stato configurato verrà individuato senza problemi con i parametri di ricerca predefiniti.

Ricerca dei moduli XBee collegati in XCTU

Se il dispositivo è stato rilevato otterremo una schermata simile alla seguente dove verrà mostrato il nome del dispositivo (configurabile a proprio piacimento) e l’indirizzo MAC univoco:

Modulo XBee rilevato da XCTU con nome e indirizzo MAC

Selezioniamo il modulo e premiamo “Add selected devices“. Una volta aggiunto tra i dispositivi rilevati, premendo nuovamente sul nome del modulo, potremo accedere alla sua configurazione.

Pagina di configurazione del modulo XBee in XCTUL’interfaccia grafica è ben curata e semplifica notevolmente le operazioni rispetto alle versioni (ormai obsolete) di XCTU. Il menu è formato da 5 icone principali: Read, Write, Default, Update e Profile.

Read: permette di leggere la configurazione presente sul modulo.
Write: scrive la nuova configurazione sul modulo, sovrascrivendo quella vecchia.
Default: ripristina i valori di fabbrica del modulo e del firmware.
Update: permette di aggiornare il modulo per quanto riguarda modalità di funzionamento e firmware.
Profile: permette il caricamento o la creazione di profili personalizzati.

Nella parte sottostante troviamo moltissime impostazioni. Quelle minime necessarie per un primo approccio sono le seguenti:

  • CH Channel: canale di comunicazione, di default C ma possiamo cambiarlo (due moduli, per comunicare tra loro, devono trovarsi sullo stesso canale).
  • ID Pan ID: Personal Area Network, entrambe i moduli devono lavorare con lo stesso ID.
  • SH Serial Number High: codice univoco del modulo che stiamo configurando, è stampato dietro al modulo stesso. Viene rilevato in automatico.
  • SL Serial Number Low: codice univoco del modulo che stiamo configurando, è stampato dietro al modulo stesso. Viene rilevato in automatico.
  • DH Destination Address High: codice univoco del modulo con il quale vogliamo comunicare, è stampato dietro al modulo stesso e corrisponde al SH di quel modulo.
  • DL Destination Address Low: codice univoco del modulo con il quale vogliamo comunicare, è stampato dietro al modulo stesso e corrisponde al SL di quel modulo.
  • AP API Enable: stabilisce il metodo di funzionamento del modulo Xbee.

Se vogliamo utilizzare il modulo XBee come semplice comunicazione seriale wireless ci basterà impostare l’ultimo parametro (AP) a 0, ovvero disabilitato. Con AP = 1 il modulo lavora invece in modalità API: i dati non passano più come semplice flusso seriale, ma in frame strutturati (con indirizzo di destinazione, tipo di comando e checksum), adatti a un microcontrollore o a un PC che deve dialogare con più moduli o leggerne lo stato; AP = 2 è la stessa modalità API con l’uso di caratteri di escape. L’uso degli I/O del modulo senza microcontrollore (lettura di ingressi digitali e analogici, comando di uscite) è una funzione distinta e indipendente da AP: si configura con i parametri D0–D8 (funzione di ciascun pin) e IR (intervallo di campionamento) e, per il line passing (replica degli ingressi di un modulo sulle uscite di un altro), con i parametri IA e IU.

Esempio di comunicazione seriale

Schema di comunicazione seriale wireless tra Arduino e PC con due moduli XBee

Prendiamo due moduli XBee (che chiameremo Modulo A e Modulo B) e configuriamoli seguendo in modo scrupoloso quanto riportato sopra. Per avere una banale comunicazione seriale tra i due moduli sarà necessario configurare su entrambe la modalità di funzionamento AP 0 (API disabled):

Impostazione del parametro AP 0 (API disabled) in XCTU

Riepilogo di una configurazione di esempio per la comunicazione punto-punto:

Parametro Modulo A Modulo B
CH C (default) C (uguale ad A)
ID 3332 (default) 3332 (uguale ad A)
DH SH del Modulo B SH del Modulo A
DL SL del Modulo B SL del Modulo A
AP 0 0
BD 3 (9600 baud) 3 (9600 baud)

Ora i due moduli sono pronti a scambiarsi reciprocamente pacchetti dati via seriale TXRX wireless.

Il modulo A lo andremo a collegare ad una scheda ArduinoMEGA con l’apposito shield Arduino XBee. Sulla scheda è stato caricato il seguente sketch che provvede a scrivere sulla seriale una stringa ogni secondo.

void setup() {
Serial.begin(9600); //deve coincidere con la velocità impostata su XBee
}

void loop() {
Serial.println("Visita www.mst-tutorial.it");
delay(1000);
}

Nota: lo shield XBee usa i pin 0 e 1 (seriale hardware), gli stessi impiegati per caricare lo sketch via USB: durante il caricamento rimuovi lo shield oppure, se presente, porta il suo selettore in posizione USB e riportalo su XBEE al termine.

Modulo A: ArduinoMEGA + XBee Shield + XBee S1

Modulo A: Arduino Mega con XBee Shield e modulo XBee S1

Ora spostiamoci a lavorare sul modulo B, il quale deve trovarsi connesso al computer tramite l’adattatore XBee utilizzato in precedenza per configurarlo.

Modulo B: XBee Adapter USB + XBee S1
Modulo B: adattatore USB con modulo XBee S1

Apriamo X-CTU e, dalla finestra Tools, attiviamo la Serial Console. Premendo sull’icona della connessione Open apriremo un terminale seriale del nostro modulo. Se abbiamo fatto tutto correttamente ogni secondo verrà stampata la stringa ricevuta.

Serial Console di XCTU con la stringa ricevuta ogni secondo

Se volessimo invece far comunicare via wireless due schede Arduino possiamo realizzare facilmente il seguente schema e dobbiamo prevedere uno sketch che permetta la lettura delle informazioni che transitano sulla seriale.

Un esempio di sketch ricevitore per Arduino UNO usa la libreria SoftwareSerial, così la seriale hardware resta libera per il monitor seriale: il pin DOUT dell’XBee va al pin 2 di Arduino, mentre il pin 3 va al DIN dell’XBee attraverso l’adattamento di livello descritto all’inizio. Su Arduino Mega si può usare direttamente Serial1 (pin 19 RX1 e 18 TX1) al posto di SoftwareSerial.

#include <SoftwareSerial.h>

SoftwareSerial xbee(2, 3); // RX, TX

void setup() {
  Serial.begin(9600);  // monitor seriale
  xbee.begin(9600);    // deve coincidere con la velocità impostata su XBee
}

void loop() {
  while (xbee.available()) {
    Serial.write(xbee.read()); // inoltra al monitor seriale i caratteri ricevuti via radio
  }
}

Schema di comunicazione wireless tra due schede Arduino con moduli XBee

Moduli attuali: XBee 3

I moduli XBee S1 e XBee S2 (ZNET 2.5) usati in questa guida sono fuori produzione. Il loro successore è la famiglia XBee 3, con lo stesso formato e la stessa piedinatura, sulla quale si può caricare tramite XCTU il firmware desiderato: 802.15.4 (equivalente alle S1), Zigbee 3.0 o DigiMesh. I parametri di base visti sopra (CH, ID, DH, DL, AP) restano validi. Per altri sistemi di comunicazione vedi anche Arduino Ethernet Shield e Protocollo CAN Bus.

Admin | MST-Tutorial

Appassionato di elettronica, elettrotecnica e programmazione. Fondatore di MST-Tutorial, condivido con entusiasmo conoscenze, esperienze e progetti legati all’innovazione tecnologica, con l’obiettivo di rendere accessibili concetti tecnici complessi attraverso tutorial chiari e pratici.

Articoli Correlati

Pulsante per tornare all'inizio