Hur man laddar ner MicroPython -kod till XBee 3: 18 steg (med bilder)

2024 Författare: John Day | [email protected]. Senast ändrad: 2024-01-30 12:44

MicroPython är ett programmeringsspråk inspirerat av Python 3.0 som fungerar på mikrokontroller, till exempel XBee 3. MicroPython kan hjälpa till att minska mängden leveranser och övergripande bulk i ditt projekt och göra saker mycket enklare. Men jag fann att när jag använde MicroPython var processen att ladda upp och ladda ner koden till enheten förvirrande. Så denna instruerbara syftar till att förklara den "enkla" processen för hur du laddar ner kod till och från din XBee.

Om du inte har gjort det kan du titta igenom Digi MicroPython Programming Guide. Det är användbart för att få en bred kunskap om hur MicroPython fungerar på XBees, och även för felsökning.

Denna handledning förutsätter inte att du är bekant med XCTU, men om du är det kan du läsa rubrikerna för varje avsnitt för mer grundläggande steg om hur du installerar och avinstallerar MicroPython -kod. Det förutsätter att du redan har skrivit koden och har sparat den som en.py- eller.mpy -fil.

Den XBee jag använder använder 802.15.4 -protokollet, så eventuella skillnader du möter mellan självstudien och din egen version av XCTU kan bero på det.

Några allmänna regler att följa när du använder MicroPython på XBees:

- Håll överföringshastigheten på 115200 eller högre. Detta hjälper till att förhindra förlust av data.

- Få din kod att köra igenom inkommande paket snabbt. När du använder MicroPython kan XBee bara hålla en kö med 4 datapaket-när kön är full slänger den ut nya data som kommer in.

- Se till att din XBee är en XBee3. MicroPython fungerar inte på någon annan modell av XBee.

Tillbehör

• XBee3 (så många du behöver)
• En XBee Explorer eller liknande dongel som låter dig ansluta din XBee till din dator
• En dator med XCTU installerad på den
• En.py- eller.mpy -fil som innehåller koden du vill installera på XBee

Steg 1: Anslut din XBee

Anslut den XBee du vill programmera och öppna XCTU. Klicka på Lägg till enheter (ikonen som ser ut som en XBee med ett + på) i det övre vänstra hörnet och välj rätt COM -port. Se till att överföringshastigheten är korrekt (vi lämnade XBees inställd på 9600) och klicka sedan på Slutför för att ansluta XBee.

XCTU tar lång tid att ladda många saker. När du ser den gröna laddningsfältet, vilket du ofta kommer att ha, är det bara att ha tålamod.

Steg 2: Se till att PS är inställt på 0 och AP är inställt på 4

Klicka på XBees ikon på vänster sida av skärmen för att visa dess inställningar på höger sida. På höger sida av skärmen rullar du ner till avsnittet MicroPython -kommandon och ser till att PS är inaktiverat [0]. Om det inte är det, ändra inställningen och tryck på pennikonen bredvid inställningen längst till höger för att skriva ändringen till XBee. Gör samma sak i avsnittet som heter UART -gränssnitt för AP -parametern och se till att det är inställt på MicroPython REPL [4].

PS -parametern avgör om koden automatiskt körs när XBee slås på, och AP -parametern är i princip det "driftläge" som XBee är i. För att få MicroPython att fungera måste den vara i sitt eget "MicroPython -läge. " Om PS är inställt på Enabled [1] kan det orsaka problem med några av dessa steg, så jag tycker att det är bäst att stänga av det tills jag har uppdaterat koden på XBee.

Steg 3: Öppna File System Manager

Navigera till avsnittet "Verktyg" i fältet högst upp på skärmen och välj Filsystemhanteraren. Det öppnar ett fönster som ser ut som det som visas ovan-filerna på din dator visas till vänster och ett tomt fönster visas till höger.

Steg 4: Konfigurera rätt COM -port

Tryck på Konfigurera. Välj rätt COM -port, se till att överföringshastigheten är korrekt och klicka på OK. Du bör se namnet på den valda COM -porten på den plats där det tidigare stod "Konfigurera porten innan du arbetar med filsystemet."

Steg 5: Öppna anslutningen till XBee

Hit Öppna. Om du får ett fel fungerar det vanligtvis att koppla ur och ansluta XBee igen och sedan slå Open. Du bör nu se filerna laddade på XBee på höger sida av fönstret. Om din XBee är helt ny ser du förmodligen bara två mappar, men om din XBee har använts tidigare kan du se andra filer i katalogen (på min finns det en som heter "main.py").

Steg 6: Ta bort den gamla koden i File System Manager

Om din XBee inte har en gammal kod kan du hoppa över det här steget.

Om du uppdaterar en gammal kodfil på XBee måste du först ta bort den gamla. XBee raderar inte automatiskt gamla versioner av kod, och det har mycket begränsat lagringsutrymme, så du måste radera gamla kodfiler manuellt.

MicroPython -koden på XBee måste finnas i en fil som heter "main.py" för att XBee ska kunna köra koden automatiskt. Du kan ha flera filer laddade till XBee, men den enda som körs vid start är "main.py", så att du kan använda flera moduler så länge du importerar dem till "main.py." Om du använder flera moduler behöver du bara ta bort den du laddar upp igen till XBee.

Högerklicka först på filen du vill ta bort och välj Ta bort. Efter några ögonblick försvinner den från File System Manager. Filen raderas nu från huvudlagringen för XBee. XBee har dock också ett arbetsminne, där den lagrar den senaste koden som den dirigerades att köra, och den måste också raderas. Slå Stäng i nedre högra hörnet för att lämna File System Manager.

Steg 7: Ändra AP till 1

I XBees inställningar på höger sida av skärmen, bläddra till avsnittet som säger UART -gränssnitt. Ändra AP -parametern till API Mode Without Escapes [1] och klicka på pennikonen för att skriva den till XBee. Detta gör att vi kan skicka AT -kommandon till XBee, vilket vi måste göra för att radera XBee: s arbetsminne. Om du använder din XBee från ny, behöver du förmodligen inte göra detta steg första gången du laddar ner koden till den, men det kan inte skada att bekräfta att arbetsminnet raderas.

Steg 8: Byt till konsolernas arbetsläge och öppna anslutningen

Byt till konsolernas arbetsläge genom att trycka på Alt-C eller genom att trycka på knappen längst upp till höger som ser ut som en TV-skärm och tryck på Öppna för att öppna kommunikationslinjen till din XBee. Vi använder det här läget för att prata med våra XBees.

Steg 9: Öppna Frames Generator

Mot höger sida av skärmen, där det står Skicka ett enda paket, klicka på + -ikonen och klicka sedan på Skapa ram med verktyget "Ramgenerator" i popup-fönstret. Detta öppnar Frames Generator, som visas ovan. Vi använder detta för att generera meddelandet vi skickar till XBee.

Steg 10: Konfigurera Frames Generator för att generera ett AT -kommando

Där det står Ramtyp, klicka på rutan för att öppna en rullgardinsmeny och välj 0x08 - AT Command. Skärmen ändras till det format som visas ovan.

Steg 11: Ange AT -kommandot för att radera arbetsminnet

I den rödmarkerade rutan märkt AT-kommando skriver du PY. Detta är den första delen av AT -kommandot, som i huvudsak säger till XBee att vi vill göra något med MicroPython. I rutan med parametervärde skriver du E. Detta är det specifika MicroPython -kommando som vi vill att XBee ska utföra, vilket raderar arbetsminnet för XBee (jag försöker komma ihåg "E för radering"). När du skriver visas siffror i rutan längst ned på skärmen.

Steg 12: Lägg till ramen

Tryck OK. Nu är du tillbaka vid fönstret du var i innan du gick in i Frames Generator. Ramnamnet spelar ingen roll för våra syften, så ignorera det. Du bör se siffrorna från det sista fönstret i rutan i det här fönstret. Välj i så fall Lägg till ram.

Steg 13: Skicka AT -kommandot

Den nya”frame_0” -ramen visas i rutan Skicka ramar. Nu kan vi skicka AT -kommandot till XBee. Se till att ramen som vi just gjort är markerad och klicka sedan på knappen med den gröna pilen som säger Skicka vald ram. Blå och röd text visas i ramarloggen ovan.

Steg 14: Tolka svaret

Den blå texten är kommandot du just skickade, och den röda texten är XBees svar. Klicka på den röda texten för att läsa den. Du kan se en rad hexadecimal som liknar det vi skickade till XBee i det högra fönstret. Du kan kopiera och klistra in detta i ramtolkningsverktyget (nås genom att klicka på pilen bredvid verktygsikonen ovan), men om det näst sista paret med siffror är en dubbel nolla betyder det att det lyckades radera arbetsminnet.

Steg 15: Ändra AP till 4

Klicka på Stäng i det övre vänstra hörnet för att avsluta kommunikationen med XBee.

Klicka på kugghjulsikonen för att gå tillbaka till XBees inställningar och rulla tillbaka till UART -gränssnittet och ändra AP -parametern tillbaka till MicroPython REPL [4]. Skriv den nya inställningen till XBee genom att klicka på pennikonen.

Steg 16: Dra din kod till filsystemhanteraren

Gå tillbaka till Verktyg> Filsystemhanteraren, konfigurera till rätt port och klicka på Öppna. På vänster sida av fönstret (din dators filer) navigerar du till koden du vill ladda upp till XBee och klickar och drar den till höger (XBee -filerna). Du bör se filen visas på höger sida. Den nya koden laddas nu ner till XBee.

Steg 17: Öppna MicroPython -terminalen

Hit Stäng. Det är dags att se till att koden fungerar. Navigera till Verktyg> MicroPython Terminal. Välj Konfigurera, välj rätt COM -port och tryck sedan på Öppna. Det ska finnas en svart, blinkande markör i fönstret. Tryck på enter så ser du MicroPython -prompten: >>>

Steg 18: Testa din kod

Tryck på Ctrl-R, så kommer koden i "main.py" -filen att köras. Om allt fungerar korrekt är du klar! Om du vill att koden ska köras automatiskt när XBee slås på stänger du MicroPython -terminalen och i XBees inställningar rullar du ner till MicroPython -kommandon och ändrar PS -parametern till Aktiverad [1] och trycker på pennikonen för att skriva det till XBee.