Hvordan laste ned MicroPython -kode til XBee 3: 18 trinn (med bilder)

2024 Forfatter: John Day | [email protected]. Sist endret: 2024-01-30 11:22

MicroPython er et programmeringsspråk inspirert av Python 3.0 som fungerer på mikrokontrollere, for eksempel XBee 3. MicroPython kan bidra til å redusere mengden forsyninger og den generelle omfanget av prosjektet, og gjøre ting mye enklere. Imidlertid fant jeg ut at da jeg brukte MicroPython, var prosessen med å laste opp og laste ned koden til enheten forvirrende. Så denne instruerbare har som mål å forklare den "enkle" prosessen med hvordan du laster ned kode til og fra XBee.

Hvis du ikke har gjort det ennå, kan du se over Digi MicroPython Programming Guide. Det er nyttig for å få en bred kunnskap om hvordan MicroPython fungerer på XBees, og også for feilsøking.

Denne opplæringen antar ikke at du er kjent med XCTU, men hvis du er det, kan du lese overskriftene til hver seksjon for mer grunnleggende trinn om hvordan du installerer og avinstallerer MicroPython -kode. Det forutsetter at du allerede har skrevet koden din og har den lagret som en.py- eller.mpy -fil.

XBee jeg bruker bruker 802.15.4 -protokollen, så eventuelle forskjeller du støter på mellom opplæringen og din egen versjon av XCTU kan skyldes det.

Noen generelle regler å overholde når du bruker MicroPython på XBees:

- Hold overføringshastigheten på 115200 eller høyere. Dette forhindrer tap av data.

- Få koden til å kjøre gjennom innkommende pakker raskt. Når du bruker MicroPython, kan XBee bare inneholde en kø med 4 datapakker-når køen er full, kaster den ut nye data som kommer inn.

- Sørg for at XBee er en XBee3. MicroPython fungerer ikke på noen andre modeller av XBee.

Rekvisita

• XBee3 (så mange du trenger)
• En XBee Explorer eller lignende dongle som lar deg koble XBee til datamaskinen
• En datamaskin med XCTU installert på den
• En.py- eller.mpy -fil som inneholder koden du vil installere på XBee

Trinn 1: Koble til XBee

Koble til XBee du vil programmere, og åpne XCTU. Klikk på Legg til enheter (ikonet som ser ut som en XBee med et + på) i øvre venstre hjørne og velg riktig COM -port. Kontroller at overføringshastigheten er korrekt (vi la XBees satt til 9600), og klikk deretter Fullfør for å koble XBee.

XCTU tar lang tid å laste inn mange ting. Bare vær tålmodig når du ser den grønne lastelinjen, som du ofte vil gjøre.

Trinn 2: Sørg for at PS er satt til 0 og AP er satt til 4

Klikk på XBee -ikonet på venstre side av skjermen for å vise innstillingene på høyre side. På høyre side av skjermen ruller du ned til delen MicroPython -kommandoer og kontrollerer at PS er satt til Deaktivert [0]. Hvis det ikke er det, endrer du innstillingen og trykker på blyantikonet ved siden av innstillingen helt til høyre for å skrive endringen til XBee. Gjør det samme i delen UART -grensesnitt for AP -parameteren, og sørg for at den er satt til MicroPython REPL [4].

PS -parameteren bestemmer om koden automatisk kjøres når XBee slås på, og AP -parameteren er i utgangspunktet "driftsmodusen" XBee er i. For å få MicroPython til å fungere må den være i sin egen "MicroPython -modus. " Hvis PS er satt til Aktivert [1], kan det forårsake problemer med noen av disse trinnene, så jeg finner det best å slå den av til jeg er ferdig med å oppdatere koden på XBee.

Trinn 3: Åpne File System Manager

Naviger til delen "Verktøy" i linjen øverst på skjermen, og velg Filsystembehandling. Det åpner et vindu som ser ut som det som er vist ovenfor-filene på datamaskinen din vises til venstre, og et tomt vindu vises til høyre.

Trinn 4: Konfigurer riktig COM -port

Trykk på Konfigurer. Velg riktig COM -port, kontroller at Baud Rate er riktig, og klikk OK. Du bør se navnet på den valgte COM -porten på stedet der det tidligere sto "Konfigurer porten før du arbeider med filsystemet."

Trinn 5: Åpne tilkoblingen til XBee

Trykk på Åpne. Hvis du får en feil, fungerer det vanligvis å koble fra og koble XBee til igjen og deretter trykke på Åpne. Du bør nå se filene lastet inn på XBee på høyre side av vinduet. Hvis din XBee er helt ny, vil du sannsynligvis bare se to mapper, men hvis din XBee har blitt brukt før, kan du se andre filer i katalogen (på min er det en som heter "main.py").

Trinn 6: Slett den gamle koden i File System Manager

Hvis XBee ikke har gammel kode på den, kan du hoppe over dette trinnet.

Hvis du oppdaterer en gammel kodefil på XBee, må du først slette den gamle. XBee sletter ikke automatisk gamle versjoner av kode, og den har svært begrenset lagringsplass, så du må slette gamle kodefiler manuelt.

MicroPython -koden på XBee må være i en fil som heter "main.py" for at XBee automatisk skal kunne kjøre koden. Du kan ha flere filer lastet inn på XBee, men den eneste den vil kjøre ved oppstart er "main.py", så du kan bruke flere moduler så lenge du importerer dem til "main.py." Hvis du bruker flere moduler, trenger du bare å slette den du laster opp på nytt til XBee.

Høyreklikk først på filen du vil slette, og velg Slett. Etter noen få minutter forsvinner den fra Filsystembehandling. Filen er nå slettet fra hovedlagringen til XBee. XBee har imidlertid også et arbeidsminne, der den lagrer den siste koden den ble rettet for å kjøre, og denne må også slettes. Trykk på Lukk i nedre høyre hjørne for å avslutte File System Manager.

Trinn 7: Endre AP til 1

I XBee -innstillingene på høyre side av skjermen blar du til delen som sier UART -grensesnitt. Endre AP -parameteren til API Mode Without Escapes [1], og klikk på blyantikonet for å skrive den til XBee. Dette lar oss sende AT -kommandoer til XBee, som vi må gjøre for å slette XBee -arbeidsminnet. Hvis du bruker XBee fra ny, trenger du sannsynligvis ikke å gjøre dette trinnet første gangen du laster ned kode til den, men det kan ikke skade å bekrefte at arbeidsminnet er slettet.

Trinn 8: Bytt til konsollens arbeidsmodus og åpne tilkoblingen

Bytt til konsollens arbeidsmodus ved å trykke på Alt-C eller ved å trykke på knappen øverst til høyre som ser ut som en TV-skjerm, og trykk på Åpne for å åpne kommunikasjonslinjen til XBee. Vi bruker denne modusen til å snakke med våre XBees.

Trinn 9: Åpne Frames Generator

Mot høyre side av skjermen, der det står Send en enkelt pakke, klikker du på + -ikonet, og klikker deretter på Lag ramme ved hjelp av "Frames Generator" -verktøyet i popup-vinduet. Dette åpner Frames Generator, som er vist ovenfor. Vi bruker dette til å generere meldingen vi sender til XBee.

Trinn 10: Konfigurer Frames Generator til å generere en AT -kommando

Der det står Rammetype, klikker du på boksen for å åpne en rullegardinmeny og velger 0x08 - AT Command. Skjermen endres til formatet vist ovenfor.

Trinn 11: Skriv inn AT -kommandoen for å slette arbeidsminnet

I boksen som er markert med rødt, merket AT-kommando, skriver du PY. Dette er den første delen av AT -kommandoen, som i hovedsak forteller XBee at vi vil gjøre noe med MicroPython. I boksen Parameter value skriver du E. Dette er den spesifikke MicroPython -kommandoen vi vil at XBee skal utføre, som sletter arbeidsminnet til XBee (jeg prøver å huske "E for Erase"). Når du skriver, vil tall vises i boksen nederst på skjermen.

Trinn 12: Legg til rammen

Trykk OK. Nå er du tilbake ved vinduet du var i før du gikk inn i Frames Generator. Rammens navn spiller ingen rolle for våre formål, så ignorer det. Du bør se tallene fra det siste vinduet i boksen i dette vinduet. Velg i så fall Legg til ramme.

Trinn 13: Send AT -kommandoen

Den nye rammen “frame_0” vises i boksen Send frames. Nå kan vi sende AT -kommandoen til XBee. Sørg for at rammen vi nettopp har laget er uthevet, og klikk deretter på knappen med den grønne pilen som sier Send valgt ramme. Blå og rød tekst vil vises i Frames -loggen ovenfor.

Trinn 14: Tolk svaret

Den blå teksten er kommandoen du nettopp sendte, og den røde teksten er svaret til XBee. Klikk på den røde teksten for å lese den. Du kan se en linje med heksadesimal som ligner på det vi sendte til XBee i vinduet til høyre. Du kan kopiere og lime inn dette i Frames Tolker -verktøyet (åpnes ved å klikke på pilen ved siden av verktøyikonet ovenfor), men hvis det nest siste paret siffer er et dobbelt null, betyr det at det lyktes i å slette arbeidsminnet.

Trinn 15: Endre AP til 4

Klikk på Lukk øverst til venstre for å avslutte kommunikasjonen med XBee.

Klikk på tannhjulikonet for å gå tilbake til XBee -innstillingene, og bla tilbake til UART -grensesnittet og endre AP -parameteren tilbake til MicroPython REPL [4]. Skriv den nye innstillingen til XBee ved å klikke på blyantikonet.

Trinn 16: Dra koden inn i Filsystembehandling

Gå tilbake til Verktøy> Filsystembehandling, konfigurer til riktig port, og klikk på Åpne. På venstre side av vinduet (datamaskinens filer), naviger til koden du vil laste opp til XBee, og klikk og dra den til høyre (XBee -filene). Du bør se filen vises på høyre side. Den nye koden er nå lastet ned til XBee.

Trinn 17: Åpne MicroPython -terminalen

Trykk på Lukk. Det er på tide å kontrollere at koden fungerer. Naviger til Verktøy> MicroPython Terminal. Velg Konfigurer, velg riktig COM -port, og klikk deretter på Åpne. Det skal være en svart, blinkende markør i vinduet. Trykk enter, og du vil se MicroPython -ledeteksten: >>>

Trinn 18: Test koden din

Trykk Ctrl-R, og koden i “main.py” -filen vil kjøres. Hvis alt fungerer som det skal, er du ferdig! Hvis du vil at koden skal kjøres automatisk når XBee slås på, lukker du MicroPython -terminalen, og i XBees innstillinger blar du ned til MicroPython -kommandoer og endrer PS -parameteren til Aktivert [1], og trykker på blyantikonet for å skrive det til XBee.