Sådan downloades MicroPython -kode til XBee 3: 18 trin (med billeder)

2024 Forfatter: John Day | [email protected]. Sidst ændret: 2024-01-30 08:27

MicroPython er et programmeringssprog, der er inspireret af Python 3.0, der fungerer på mikrokontrollere, f.eks. XBee 3. MicroPython kan hjælpe med at reducere mængden af forsyninger og den samlede bulk i dit projekt og gøre tingene meget lettere. Jeg fandt imidlertid ud af, at da jeg brugte MicroPython, var processen med at uploade og downloade koden til enheden forvirrende. Så denne instruktive har til formål at forklare den "enkle" proces med, hvordan du downloader kode til og fra din XBee.

Hvis du ikke har gjort det endnu, kan du kigge over Digi MicroPython Programmeringsguide. Det er nyttigt til at få en bred viden om, hvordan MicroPython fungerer på XBees, og også til fejlfinding.

Denne vejledning antager ikke, at du er fortrolig med XCTU, men hvis du er det, kan du læse overskrifterne i hvert afsnit for mere grundlæggende trin om, hvordan du installerer og afinstallerer MicroPython -kode. Det går ud fra, at du allerede har skrevet din kode og har gemt den som en.py- eller.mpy -fil.

Den XBee, jeg bruger, bruger 802.15.4 -protokollen, så eventuelle forskelle, du støder på mellem selvstudiet og din egen version af XCTU, kan skyldes det.

Nogle generelle regler at overholde, når du bruger MicroPython på XBees:

- Hold baudhastigheden på 115200 eller højere. Dette hjælper med at forhindre tab af data.

- Få din kode til at køre hurtigt gennem indgående pakker. Når du bruger MicroPython, kan XBee kun holde en kø på 4 datapakker-når køen er fuld, smider den nye data ind.

- Sørg for, at din XBee er en XBee3. MicroPython fungerer ikke på nogen anden model af XBee.

Forbrugsvarer

• XBee3 (så mange som du har brug for)
• En XBee Explorer eller lignende dongle, der lader dig tilslutte din XBee til din computer
• En computer med XCTU installeret på den
• En.py- eller.mpy -fil, der indeholder den kode, du vil installere på XBee

Trin 1: Tilslut din XBee

Tilslut den XBee, du vil programmere, og åbn XCTU. Klik på Tilføj enheder (ikonet, der ligner en XBee med et + på) i øverste venstre hjørne, og vælg den korrekte COM -port. Sørg for, at baudhastigheden er korrekt (vi forlod XBees indstillet til 9600), og klik derefter på Udfør for at forbinde XBee.

XCTU tager lang tid at indlæse mange ting. Når du ser den grønne lastelinje, som du ofte vil have, skal du bare være tålmodig.

Trin 2: Sørg for, at PS er indstillet til 0 og AP er indstillet til 4

Klik på XBee -ikonet i venstre side af skærmen for at få vist dens indstillinger i højre side. I højre side af skærmen skal du rulle ned til afsnittet kaldet MicroPython -kommandoer og sikre, at PS er indstillet til Deaktiveret [0]. Hvis det ikke er tilfældet, skal du ændre indstillingen og trykke på blyantikonet ved siden af indstillingen yderst til højre for at skrive ændringen til XBee. Gør det samme i afsnittet kaldet UART -grænseflade for AP -parameteren, og sørg for, at det er indstillet til MicroPython REPL [4].

PS -parameteren bestemmer, om koden automatisk kører, når XBee tændes, og AP -parameteren er dybest set den "driftstilstand", XBee er i. For at få MicroPython til at fungere, skal den være i sin egen "MicroPython -tilstand. " Hvis PS er indstillet til Aktiveret [1], kan det forårsage problemer med nogle af disse trin, så jeg finder det bedst at slukke det, indtil jeg er færdig med at opdatere koden på XBee.

Trin 3: Åbn File System Manager

Naviger til afsnittet "Værktøjer" i linjen øverst på skærmen, og vælg Filsystemhåndtering. Det åbner et vindue, der ligner det viste ovenfor-filerne på din computer vises til venstre, og et tomt vindue vises til højre.

Trin 4: Konfigurer den korrekte COM -port

Hit Konfigurer. Vælg den korrekte COM -port, kontroller, at baudhastigheden er korrekt, og klik på OK. Du skulle se navnet på den valgte COM -port på det sted, hvor der tidligere stod "Konfigurer porten, før du arbejder med filsystemet."

Trin 5: Åbn forbindelsen til XBee

Hit Åbn. Hvis du får en fejl, virker det normalt at tage stikket og tilslutte XBee igen og derefter trykke på Åben. Du skulle nu se filerne indlæst på XBee i højre side af vinduet. Hvis din XBee er helt ny, vil du sandsynligvis kun se to mapper, men hvis din XBee har været brugt før, kan du se andre filer i biblioteket (på min, er der en, der hedder "main.py").

Trin 6: Slet den gamle kode i File System Manager

Hvis din XBee ikke har en gammel kode på den, kan du springe dette trin over.

Hvis du opdaterer en gammel kodefil på XBee, skal du først slette den gamle. XBee sletter ikke automatisk gamle versioner af kode, og den har meget begrænset lagerplads, så du skal manuelt slette gamle kodefiler.

MicroPython -kode på XBee skal være i en fil med navnet "main.py" for at XBee automatisk kan køre koden. Du kan have flere filer indlæst på XBee, men den eneste, den vil køre ved opstart, er "main.py", så du kan bruge flere moduler, så længe du importerer dem til "main.py." Hvis du bruger flere moduler, behøver du kun at slette den, du uploader til XBee igen.

Højreklik først på den fil, du vil slette, og vælg Slet. Efter et øjeblik forsvinder det fra File System Manager. Filen er nu slettet fra hovedlageret i XBee. XBee har imidlertid også en arbejdshukommelse, hvor den gemmer den sidste kode, den blev henvist til at køre, og denne skal også slettes. Hit Luk i nederste højre hjørne for at afslutte File System Manager.

Trin 7: Skift AP til 1

I XBees indstillinger på højre side af skærmen skal du rulle til afsnittet, der siger UART -grænseflade. Skift AP -parameteren til API Mode Without Escapes [1], og klik på blyantikonet for at skrive den til XBee. Dette giver os mulighed for at sende AT -kommandoer til XBee, som vi skal gøre for at slette XBee's arbejdshukommelse. Hvis du bruger din XBee fra ny, behøver du sandsynligvis ikke at gøre dette trin første gang du downloader kode på den, men det kan ikke skade at bekræfte, at arbejdshukommelsen slettes.

Trin 8: Skift til konsolens arbejdstilstand, og åbn forbindelsen

Skift til konsolens arbejdstilstand ved at trykke på Alt-C eller ved at trykke på knappen øverst til højre, der ligner en tv-skærm, og tryk på Åbn for at åbne kommunikationslinjen til din XBee. Vi bruger denne tilstand til at tale med vores XBees.

Trin 9: Åbn Frames Generator

Mod højre side af skærmen, hvor der står Send en enkelt pakke, skal du klikke på ikonet +, og derefter klikke på Opret ramme ved hjælp af værktøjet ‘Frames Generator’ i pop-up-vinduet. Dette åbner Frames Generator, som er vist ovenfor. Vi bruger dette til at generere den besked, vi sender til XBee.

Trin 10: Konfigurer Frames Generator til at generere en AT -kommando

Hvor der står Rammetype, skal du klikke på boksen for at åbne en rullemenu og vælge 0x08 - AT Command. Skærmen skifter til det ovenfor viste format.

Trin 11: Indtast AT -kommandoen for at slette arbejdshukommelsen

I den rød-markerede boks mærket AT-kommando, skriver du PY. Dette er den første del af AT -kommandoen, der hovedsageligt fortæller XBee, at vi vil gøre noget med MicroPython. I feltet "Parameter value" skal du skrive E. Dette er den specifikke MicroPython -kommando, vi vil have XBee til at udføre, hvilket sletter XBee's arbejdshukommelse (jeg prøver at huske "E for Erase"). Når du skriver, vises tal i feltet nederst på skærmen.

Trin 12: Tilføj rammen

Hit OK. Nu er du tilbage ved vinduet, du var i, før du gik ind i Frames Generator. Rammens navn er ikke særlig vigtigt for vores formål, så ignorer det. Du skulle se tallene fra det sidste vindue i feltet i dette vindue. Vælg i så fald Tilføj ramme.

Trin 13: Send AT -kommandoen

Den nye ramme "frame_0" vises i feltet Send frames. Nu kan vi sende AT -kommandoen til XBee. Sørg for, at den ramme, vi lige har lavet, er fremhævet, og klik derefter på knappen med den grønne pil, der siger Send valgt ramme. Blå og rød tekst vises i rammerne ovenfor.

Trin 14: Fortolk svaret

Den blå tekst er den kommando, du lige har sendt, og den røde tekst er XBees svar. Klik på den røde tekst for at læse den. Du kan se en linje med hexadecimal, der ligner det, vi sendte til XBee i vinduet til højre. Du kan kopiere og indsætte dette i værktøjet Frames Interpreter (åbnes ved at klikke på pilen ved siden af værktøjsikonet ovenfor), men hvis det næstsidste par cifre er et dobbelt nul, betyder det, at det lykkedes at slette arbejdshukommelsen.

Trin 15: Skift AP til 4

Klik på Luk i øverste venstre hjørne for at afslutte kommunikationen med XBee.

Klik på tandhjulsikonet for at gå tilbage til XBees indstillinger, og rul tilbage ned til UART -grænsefladen og ændre AP -parameteren tilbage til MicroPython REPL [4]. Skriv den nye indstilling til XBee ved at klikke på blyantikonet.

Trin 16: Træk din kode ind i File System Manager

Gå tilbage til Værktøjer> Filsystemhåndtering, konfigurer til den korrekte port, og klik på Åbn. I venstre side af vinduet (din computers filer) skal du navigere til den kode, du vil uploade til XBee, og klikke og trække den til højre side (XBee -filerne). Du skal se filen vises på højre side. Den nye kode er nu downloadet til XBee.

Trin 17: Åbn MicroPython -terminalen

Hit Luk. Det er tid til at sikre, at koden fungerer. Naviger til Værktøjer> MicroPython Terminal. Vælg Konfigurer, vælg den rigtige COM -port, og tryk derefter på Åbn. Der skal være en sort, blinkende markør i vinduet. Tryk på enter, og du får vist MicroPython -prompten: >>>

Trin 18: Test din kode

Tryk på Ctrl-R, og koden i filen "main.py" kører. Hvis alt fungerer korrekt, er du færdig! Hvis du vil have, at koden automatisk kører, når XBee er tændt, skal du lukke MicroPython -terminalen, og i XBees indstillinger skal du rulle ned til MicroPython -kommandoer og ændre PS -parameteren til Aktiveret [1], og trykke på blyantikonet for at skrive det til XBee.