So laden Sie MicroPython-Code auf XBee 3 herunter: 18 Schritte (mit Bildern)

2024 Autor: John Day | [email protected]. Zuletzt bearbeitet: 2024-01-30 07:18

MicroPython ist eine von Python 3.0 inspirierte Programmiersprache, die auf Mikrocontrollern wie dem XBee 3 funktioniert. MicroPython kann dazu beitragen, die Menge an Zubehör und die allgemeine Sperrigkeit Ihres Projekts zu verringern und die Dinge viel einfacher zu machen. Ich habe jedoch festgestellt, dass das Hoch- und Herunterladen des Codes auf das Gerät verwirrend war, wenn ich MicroPython verwendet habe. Dieses instructable zielt also darauf ab, den "einfachen" Prozess zum Herunterladen von Code auf und von Ihrem XBee zu erklären.

Wenn Sie es noch nicht getan haben, sehen Sie sich das Digi MicroPython-Programmierhandbuch an. Es ist nützlich, um ein umfassendes Wissen darüber zu erlangen, wie MicroPython auf den XBees funktioniert, und auch für die Fehlerbehebung.

In diesem Tutorial wird nicht davon ausgegangen, dass Sie mit XCTU vertraut sind, aber wenn Sie es sind, können Sie die Überschriften jedes Abschnitts lesen, um grundlegendere Schritte zum Installieren und Deinstallieren von MicroPython-Code zu erhalten. Es wird davon ausgegangen, dass Sie Ihren Code bereits geschrieben und als.py- oder.mpy-Datei gespeichert haben.

Der von mir verwendete XBee verwendet das 802.15.4-Protokoll, daher können alle Unterschiede zwischen dem Tutorial und Ihrer eigenen Version von XCTU darauf zurückzuführen sein.

Einige allgemeine Regeln, die bei der Verwendung von MicroPython auf den XBees zu beachten sind:

- Belassen Sie die Baudrate bei 115200 oder höher. Dies hilft, Datenverluste zu vermeiden.

- Lassen Sie Ihren Code schnell durch eingehende Pakete laufen. Bei der Verwendung von MicroPython kann der XBee nur eine Warteschlange von 4 Datenpaketen halten - sobald die Warteschlange voll ist, wirft er neue Daten aus.

- Stellen Sie sicher, dass Ihr XBee ein XBee3 ist. MicroPython funktioniert auf keinem anderen Modell des XBee.

Lieferungen

• XBee3 (so viele wie Sie benötigen)
• Ein XBee Explorer oder ein ähnlicher Dongle, mit dem Sie Ihren XBee an Ihren Computer anschließen können
• Ein Computer, auf dem XCTU installiert ist
• Eine.py- oder.mpy-Datei mit dem Code, den Sie auf dem XBee installieren möchten

Schritt 1: Verbinden Sie Ihren XBee

Schließen Sie den XBee an, den Sie programmieren möchten, und öffnen Sie XCTU. Klicken Sie auf Geräte hinzufügen (das Symbol, das wie ein XBee mit einem + darauf aussieht) in der oberen linken Ecke und wählen Sie den richtigen COM-Port aus. Stellen Sie sicher, dass die Baudrate korrekt ist (wir haben die XBees auf 9600 eingestellt), und klicken Sie dann auf Fertig stellen, um die XBee zu verbinden.

XCTU braucht lange, um viele Dinge zu laden. Wenn Sie den grünen Ladebalken sehen, den Sie häufig sehen werden, haben Sie einfach etwas Geduld.

Schritt 2: Stellen Sie sicher, dass PS auf 0 und AP auf 4. eingestellt ist

Klicken Sie auf das Symbol des XBee auf der linken Seite des Bildschirms, um seine Einstellungen auf der rechten Seite anzuzeigen. Scrollen Sie auf der rechten Seite des Bildschirms nach unten zum Abschnitt namens MicroPython-Befehle und stellen Sie sicher, dass PS auf Disabled [0] eingestellt ist. Wenn dies nicht der Fall ist, ändern Sie die Einstellung und klicken Sie auf das Bleistiftsymbol neben der Einstellung ganz rechts, um die Änderung in den XBee zu schreiben. Machen Sie dasselbe im Abschnitt namens UART-Schnittstelle für den AP-Parameter und stellen Sie sicher, dass er auf MicroPython REPL [4] eingestellt ist.

Der PS-Parameter bestimmt, ob der Code beim Einschalten des XBee automatisch ausgeführt wird oder nicht, und der AP-Parameter ist im Grunde der "Betriebsmodus", in dem sich der XBee befindet. Damit MicroPython funktioniert, muss es sich im eigenen "MicroPython-Modus" befinden. " Wenn PS auf Enabled [1] gesetzt ist, kann dies bei einigen dieser Schritte zu Problemen führen, daher finde ich es am besten, es auszuschalten, bis ich mit dem Aktualisieren des Codes auf dem XBee fertig bin.

Schritt 3: Öffnen Sie den Dateisystem-Manager

Navigieren Sie zum Abschnitt „Extras“in der Leiste am oberen Bildschirmrand und wählen Sie Dateisystem-Manager. Es öffnet sich ein Fenster, das wie das oben gezeigte aussieht - die Dateien auf Ihrem Computer werden links angezeigt und ein leeres Fenster rechts.

Schritt 4: Konfigurieren Sie den richtigen COM-Port

Klicken Sie auf Konfigurieren. Wählen Sie den richtigen COM-Port aus, stellen Sie sicher, dass die Baudrate korrekt ist, und klicken Sie auf OK. Sie sollten den Namen des ausgewählten COM-Ports an der Stelle sehen, an der zuvor "Konfigurieren Sie den Port vor der Arbeit mit dem Dateisystem" stand.

Schritt 5: Öffnen Sie die Verbindung zum XBee

Klicken Sie auf Öffnen. Wenn Sie einen Fehler erhalten, funktioniert normalerweise das Trennen und erneute Anschließen des XBee und das Drücken von Öffnen. Sie sollten nun die auf den XBee geladenen Dateien auf der rechten Seite des Fensters sehen. Wenn Ihr XBee brandneu ist, sehen Sie wahrscheinlich nur zwei Ordner, aber wenn Ihr XBee schon einmal verwendet wurde, sehen Sie möglicherweise andere Dateien im Verzeichnis (bei mir gibt es einen namens "main.py").

Schritt 6: Löschen Sie den alten Code im Dateisystem-Manager

Wenn Ihr XBee keinen alten Code enthält, können Sie diesen Schritt überspringen.

Wenn Sie eine alte Codedatei auf dem XBee aktualisieren, müssen Sie zuerst die alte löschen. Der XBee löscht alte Codeversionen nicht automatisch und hat einen sehr begrenzten Speicherplatz, sodass Sie alte Codedateien manuell löschen müssen.

MicroPython-Code auf dem XBee muss sich in einer Datei namens „main.py“befinden, damit der XBee den Code automatisch ausführen kann. Sie können mehrere Dateien auf den XBee laden, aber die einzige, die beim Start ausgeführt wird, ist „main.py“, sodass Sie mehrere Module verwenden können, solange Sie sie in „main.py“importieren. Wenn Sie mehrere Module verwenden, müssen Sie nur das Modul löschen, das Sie erneut auf XBee hochladen.

Klicken Sie zuerst mit der rechten Maustaste auf die Datei, die Sie löschen möchten, und wählen Sie Löschen. Nach einigen Augenblicken wird es aus dem Dateisystem-Manager verschwinden. Die Datei wird nun aus dem Hauptspeicher des XBee gelöscht. Der XBee hat jedoch auch einen Arbeitsspeicher, in dem er den letzten Code speichert, zu dem er angewiesen wurde, und dieser muss ebenfalls gelöscht werden. Klicken Sie unten rechts auf Schließen, um den Dateisystem-Manager zu beenden.

Schritt 7: Ändere AP auf 1

Scrollen Sie in den Einstellungen des XBee auf der rechten Seite des Bildschirms zu dem Abschnitt mit der Bezeichnung UART-Schnittstelle. Ändern Sie den AP-Parameter in den API-Modus ohne Escapes [1] und klicken Sie auf das Stiftsymbol, um ihn in den XBee zu schreiben. Dadurch können wir AT-Befehle an den XBee senden, was wir tun müssen, um den Arbeitsspeicher des XBee zu löschen. Wenn Sie Ihren XBee neu verwenden, müssen Sie diesen Schritt wahrscheinlich nicht ausführen, wenn Sie zum ersten Mal Code darauf herunterladen, aber es kann nicht schaden, zu bestätigen, dass der Arbeitsspeicher gelöscht ist.

Schritt 8: Wechseln Sie in den Konsolen-Arbeitsmodus und öffnen Sie die Verbindung

Wechseln Sie in den Konsolen-Arbeitsmodus, indem Sie Alt-C drücken oder die Schaltfläche oben rechts drücken, die wie ein Fernsehmonitor aussieht, und drücken Sie Öffnen, um die Kommunikationsverbindung zu Ihrem XBee zu öffnen. Wir verwenden diesen Modus, um mit unseren XBees zu sprechen.

Schritt 9: Öffnen Sie den Frame-Generator

Klicken Sie auf der rechten Seite des Bildschirms unter "Ein einzelnes Paket senden" auf das Symbol + und dann im Popup-Fenster mit dem Tool "Frames Generator" auf Frame erstellen. Dies öffnet den oben gezeigten Frames Generator. Wir verwenden dies, um die Nachricht zu generieren, die wir an den XBee senden.

Schritt 10: Konfigurieren Sie den Frames Generator zum Generieren eines AT-Befehls

Klicken Sie dort, wo Frametyp steht, auf das Kästchen, um ein Dropdown-Menü zu öffnen, und wählen Sie 0x08 - AT-Befehl. Der Bildschirm ändert sich in das oben gezeigte Format.

Schritt 11: Geben Sie den AT-Befehl ein, um den Arbeitsspeicher zu löschen

Geben Sie in das rot markierte Feld mit der Bezeichnung AT-Befehl PY ein. Dies ist der erste Teil des AT-Befehls, der dem XBee im Wesentlichen mitteilt, dass wir etwas mit MicroPython machen wollen. Geben Sie in das Feld mit der Bezeichnung Parameterwert E ein. Dies ist der spezifische MicroPython-Befehl, den der XBee ausführen soll, der den Arbeitsspeicher des XBee löscht (ich versuche, mich an „E für Erase“zu erinnern). Während der Eingabe erscheinen Zahlen im Feld am unteren Bildschirmrand.

Schritt 12: Fügen Sie den Rahmen hinzu

Klicken Sie auf OK. Jetzt befinden Sie sich wieder in dem Fenster, in dem Sie sich befanden, bevor Sie in den Frames Generator gegangen sind. Der Rahmenname ist für unsere Zwecke nicht besonders wichtig, also ignorieren Sie ihn. Sie sollten die Zahlen aus dem letzten Fenster in der Box dieses Fensters sehen. Wählen Sie in diesem Fall Rahmen hinzufügen.

Schritt 13: Senden Sie den AT-Befehl

Der neue Frame „frame_0“erscheint in der Box mit der Bezeichnung Frames senden. Jetzt können wir den AT-Befehl an den XBee senden. Stellen Sie sicher, dass der soeben erstellte Rahmen markiert ist, und klicken Sie dann auf die Schaltfläche mit dem grünen Pfeil, die mit der Aufschrift Ausgewählten Rahmen senden heißt. Im obigen Frames-Protokoll wird blauer und roter Text angezeigt.

Schritt 14: Interpretieren Sie die Antwort

Der blaue Text ist der gerade gesendete Befehl und der rote Text ist die Antwort des XBee. Klicken Sie auf den roten Text, um ihn zu lesen. Im rechten Fenster sehen Sie eine hexadezimale Zeile ähnlich der, die wir an den XBee gesendet haben. Sie können dies kopieren und in das Frames Interpreter-Tool einfügen (Zugriff durch Klicken auf den Pfeil neben dem Tool-Symbol oben), aber wenn das vorletzte Ziffernpaar eine Doppelnull ist, bedeutet dies, dass der Arbeitsspeicher gelöscht wurde.

Schritt 15: AP auf 4. ändern

Klicken Sie oben links auf Schließen, um die Kommunikation mit dem XBee zu beenden.

Klicken Sie auf das Zahnradsymbol, um zu den Einstellungen des XBee zurückzukehren, scrollen Sie zurück zur UART-Schnittstelle und ändern Sie den AP-Parameter wieder in MicroPython REPL [4]. Schreiben Sie die neue Einstellung in den XBee, indem Sie auf das Stiftsymbol klicken.

Schritt 16: Ziehen Sie Ihren Code in den Dateisystem-Manager

Gehen Sie zurück zu Tools > File System Manager, konfigurieren Sie den richtigen Port und klicken Sie auf Open. Navigieren Sie auf der linken Seite des Fensters (Dateien Ihres Computers) zu dem Code, den Sie auf den XBee hochladen möchten, und klicken Sie darauf und ziehen Sie ihn auf die rechte Seite (die Dateien des XBee). Sie sollten die Datei auf der rechten Seite sehen. Der neue Code wird nun auf den XBee heruntergeladen.

Schritt 17: Öffnen Sie das MicroPython-Terminal

Klicken Sie auf Schließen. Es ist an der Zeit, sicherzustellen, dass der Code funktioniert. Navigieren Sie zu Extras > MicroPython-Terminal. Wählen Sie Konfigurieren, wählen Sie den richtigen COM-Port und klicken Sie dann auf Öffnen. Im Fenster sollte ein schwarzer, blinkender Cursor erscheinen. Drücken Sie die Eingabetaste und Sie sehen die MicroPython-Eingabeaufforderung: >>>

Schritt 18: Testen Sie Ihren Code

Drücken Sie Strg-R und der Code in der Datei „main.py“wird ausgeführt. Wenn alles richtig funktioniert, sind Sie fertig! Wenn Sie möchten, dass der Code beim Einschalten des XBee automatisch ausgeführt wird, schließen Sie das MicroPython-Terminal und scrollen Sie in den XBee-Einstellungen nach unten zu MicroPython-Befehle und ändern Sie den PS-Parameter auf Aktiviert [1] und drücken Sie das Bleistiftsymbol, um zu schreiben es zum XBee.