Come scaricare il codice MicroPython su XBee 3: 18 passaggi (con immagini)

2024 Autore: John Day | [email protected]. Ultima modifica: 2024-01-30 10:02

MicroPython è un linguaggio di programmazione ispirato a Python 3.0 che funziona su microcontrollori, come XBee 3. MicroPython può aiutare a ridurre la quantità di materiali di consumo e l'ingombro complessivo del progetto e rendere le cose molto più semplici. Tuttavia, ho scoperto che quando stavo usando MicroPython, il processo di caricamento e scaricamento del codice sul dispositivo era confuso. Quindi questo tutorial mira a spiegare il processo "semplice" di come scaricare il codice dentro e fuori dal tuo XBee.

Se non l'hai ancora fatto, consulta la Guida alla programmazione di Digi MicroPython. È utile per ottenere un'ampia conoscenza del funzionamento di MicroPython sugli XBees e anche per la risoluzione dei problemi.

Questo tutorial non presuppone che tu abbia familiarità con XCTU, ma se lo sei, puoi leggere i titoli di ogni sezione per i passaggi più basilari su come installare e disinstallare il codice MicroPython. Presuppone che tu abbia già scritto il tuo codice e averlo salvato come file.py o.mpy.

L'XBee che uso utilizza il protocollo 802.15.4, quindi qualsiasi differenza che incontri tra il tutorial e la tua versione di XCTU potrebbe essere dovuta a questo.

Alcune regole generali da rispettare quando si utilizza MicroPython su XBees:

- Mantenere il baud rate a 115200 o superiore. Questo aiuta a prevenire la perdita di dati.

- Fai in modo che il tuo codice venga eseguito rapidamente attraverso i pacchetti in arrivo. Quando si utilizza MicroPython, l'XBee può contenere solo una coda di 4 pacchetti di dati: una volta che la coda è piena, emette nuovi dati in arrivo.

- Assicurati che il tuo XBee sia un XBee3. MicroPython non funziona su nessun altro modello di XBee.

Forniture

• XBee3 (quanti ne hai bisogno)
• Un XBee Explorer o un dongle simile che ti permetta di collegare il tuo XBee al tuo computer
• Un computer con XCTU installato su di esso
• Un file.py o.mpy contenente il codice che vuoi installare su XBee

Passaggio 1: collega il tuo XBee

Collega l'XBee che desideri programmare e apri XCTU. Fai clic su Aggiungi dispositivi (l'icona che assomiglia a un XBee con un +) nell'angolo in alto a sinistra e seleziona la porta COM corretta. Assicurati che il Baud Rate sia corretto (abbiamo lasciato l'XBees impostato su 9600), quindi fai clic su Fine per connettere l'XBee.

XCTU impiega molto tempo per caricare molte cose. Quando vedi la barra di caricamento verde, che farai spesso, sii paziente.

Passaggio 2: assicurati che PS sia impostato su 0 e AP sia impostato su 4

Fare clic sull'icona di XBee sul lato sinistro dello schermo per visualizzare le sue impostazioni sul lato destro. Sul lato destro dello schermo, scorri verso il basso fino alla sezione chiamata Comandi MicroPython e assicurati che PS sia impostato su Disabilitato [0]. In caso contrario, modifica l'impostazione e premi l'icona a forma di matita accanto all'impostazione all'estrema destra per scrivere la modifica su XBee. Fai lo stesso nella sezione chiamata Interfaccia UART per il parametro AP e assicurati che sia impostato su MicroPython REPL [4].

Il parametro PS determina se il codice viene eseguito automaticamente o meno all'accensione di XBee e il parametro AP è fondamentalmente la "modalità operativa" in cui si trova XBee. Per far funzionare MicroPython, deve essere nella propria "modalità MicroPython. " Se PS è impostato su Abilitato [1], può causare problemi con alcuni di questi passaggi, quindi trovo meglio disattivarlo fino a quando non ho finito di aggiornare il codice su XBee.

Passaggio 3: aprire il File System Manager

Vai alla sezione "Strumenti" nella barra nella parte superiore dello schermo e seleziona File System Manager. Si apre una finestra che assomiglia a quella mostrata sopra: i file sul tuo computer sono mostrati a sinistra e una finestra vuota è mostrata a destra.

Passaggio 4: configurare la porta COM corretta

Premi Configura. Selezionare la porta COM corretta, assicurarsi che il Baud Rate sia corretto e fare clic su OK. Dovresti vedere il nome della porta COM selezionata nel punto in cui in precedenza era detto "Configura la porta prima di lavorare con il file system".

Passaggio 5: aprire la connessione a XBee

Premi Apri. Se ricevi un errore, scollegare e ricollegare di nuovo l'XBee e poi premere Apri di solito funziona. Ora dovresti vedere i file caricati su XBee sul lato destro della finestra. Se il tuo XBee è nuovo di zecca, probabilmente vedrai solo due cartelle, ma se il tuo XBee è stato utilizzato in precedenza, potresti vedere altri file nella directory (sul mio, ce n'è uno chiamato "main.py").

Passaggio 6: eliminare il vecchio codice nel File System Manager

Se il tuo XBee non ha un vecchio codice, puoi saltare questo passaggio.

Se stai aggiornando un vecchio file di codice su XBee, devi prima eliminare quello vecchio. L'XBee non elimina automaticamente le vecchie versioni del codice e dispone di uno spazio di archiviazione molto limitato, quindi è necessario eliminare manualmente i vecchi file di codice.

Il codice MicroPython su XBee deve trovarsi in un file denominato "main.py" affinché XBee esegua automaticamente il codice. Puoi caricare più file su XBee, ma l'unico che verrà eseguito all'avvio è "main.py", quindi puoi utilizzare più moduli purché li importi in "main.py". Se stai utilizzando più moduli, devi solo eliminare quello che stai ricaricando su XBee.

Innanzitutto, fai clic con il pulsante destro del mouse sul file che desideri eliminare e seleziona Elimina. Dopo alcuni istanti, scomparirà dal File System Manager. Il file è ora eliminato dalla memoria principale dell'XBee. Tuttavia, l'XBee ha anche una memoria di lavoro, dove memorizza l'ultimo codice che è stato indicato per l'esecuzione, e anche questo deve essere cancellato. Premi Chiudi nell'angolo in basso a destra per uscire da File System Manager.

Passaggio 7: cambia AP in 1

Nelle impostazioni di XBee sul lato destro dello schermo, scorri fino alla sezione che dice Interfaccia UART. Modificare il parametro AP in Modalità API senza escape [1] e fare clic sull'icona a forma di matita per scriverlo sull'XBee. Questo ci permette di inviare comandi AT all'XBee, cosa che dovremo fare per cancellare la memoria di lavoro dell'XBee. Se stai usando il tuo XBee da nuovo, probabilmente non devi eseguire questo passaggio la prima volta che scarichi il codice su di esso, ma non può far male confermare che la memoria di lavoro è stata cancellata.

Passaggio 8: passare alla modalità di lavoro della console e aprire la connessione

Passa alla modalità di lavoro della console premendo Alt-C o premendo il pulsante in alto a destra che sembra un monitor TV e premi Apri per aprire la linea di comunicazione con il tuo XBee. Usiamo questa modalità per parlare con i nostri XBees.

Passaggio 9: aprire il generatore di cornici

Verso il lato destro dello schermo, sotto la voce Invia un singolo pacchetto, fai clic sull'icona +, quindi fai clic su Crea cornice utilizzando lo strumento "Generatore di frame" nella finestra pop-up. Questo apre il Generatore di cornici, mostrato sopra. Lo usiamo per generare il messaggio che invieremo all'XBee.

Passaggio 10: configurare il generatore di frame per generare un comando AT

Dove dice Tipo di frame, fai clic sulla casella per aprire un menu a discesa e seleziona 0x08 - Comando AT. La schermata cambierà nel formato mostrato sopra.

Passaggio 11: immettere il comando AT per cancellare la memoria di lavoro

Nella casella evidenziata in rosso etichettata comando AT, digitare PY. Questa è la prima parte del comando AT, che essenzialmente dice all'XBee che vogliamo fare qualcosa con MicroPython. Nella casella denominata Valore parametro, digita E. Questo è il comando specifico MicroPython che vogliamo che l'XBee esegua, che sta cancellando la memoria di lavoro dell'XBee (cerco di ricordare "E per Erase"). Durante la digitazione, i numeri verranno visualizzati nella casella nella parte inferiore dello schermo.

Passaggio 12: aggiungi la cornice

Premi OK. Ora sei tornato alla finestra in cui eri prima di entrare nel Generatore di cornici. Il nome del frame non è particolarmente importante per i nostri scopi, quindi ignoralo. Dovresti vedere i numeri dell'ultima finestra nella casella di questa finestra. In tal caso, seleziona Aggiungi cornice.

Passaggio 13: inviare il comando AT

Il nuovo frame "frame_0" viene visualizzato nella casella denominata Send frames. Ora possiamo inviare il comando AT all'XBee. Assicurati che il fotogramma che abbiamo appena creato sia evidenziato, quindi fai clic sul pulsante con la freccia verde che dice Invia fotogramma selezionato. Il testo blu e rosso apparirà nel registro dei frame sopra.

Passaggio 14: interpretare la risposta

Il testo blu è il comando che hai appena inviato e il testo rosso è la risposta di XBee. Fare clic sul testo rosso per leggerlo. Puoi vedere una riga esadecimale simile a quella che abbiamo inviato a XBee nella finestra di destra. Puoi copiarlo e incollarlo nello strumento Frames Interpreter (accessibile facendo clic sulla freccia accanto all'icona dello strumento sopra), ma se la penultima coppia di cifre è un doppio zero, significa che è riuscito a cancellare la memoria di lavoro.

Passaggio 15: cambia AP in 4

Fare clic su Chiudi nell'angolo in alto a sinistra per uscire dalla comunicazione con XBee.

Fare clic sull'icona a forma di ingranaggio per tornare alle impostazioni di XBee e scorrere fino all'interfaccia UART e modificare il parametro AP nuovamente su MicroPython REPL [4]. Scrivi la nuova impostazione su XBee facendo clic sull'icona a forma di matita.

Passaggio 16: trascina il codice nel File System Manager

Torna in Strumenti > File System Manager, configura la porta corretta e fai clic su Apri. Sul lato sinistro della finestra (i file del tuo computer), vai al codice che desideri caricare su XBee, fai clic e trascinalo sul lato destro (i file di XBee). Dovresti vedere il file apparire sul lato destro. Il nuovo codice è ora scaricato su XBee.

Passaggio 17: aprire il terminale MicroPython

Premi Chiudi. È ora di assicurarsi che il codice funzioni. Passa a Strumenti > Terminale MicroPython. Seleziona Configura, scegli la porta COM corretta, quindi premi Apri. Dovrebbe esserci un cursore nero lampeggiante nella finestra. Premi invio e vedrai il prompt di MicroPython: >>>

Passaggio 18: prova il tuo codice

Premi Ctrl-R e verrà eseguito il codice nel file "main.py". Se tutto funziona correttamente, hai finito! Se vuoi che il codice venga eseguito automaticamente all'accensione di XBee, chiudi il terminale MicroPython e, nelle impostazioni di XBee, scorri verso il basso fino a MicroPython Commands e modifica il parametro PS in Enabled [1] e premi l'icona a forma di matita per scrivere lo all'XBee.