Zustandsautomat und Sperre
Was dieses Beispiel zeigt
Der Receiver wird durch seine Zustände geführt: ein Hardware-Reset über den Pin RESET, der BOOTLOADER-Zustand, in den ihn ein Hardware-Reset versetzt, der RUN-Zustand, der CONFIGURATION-Zustand und dann gezielt zurück in den BOOTLOADER-Zustand mithilfe der Sperre. Bei jedem Schritt fragt das Skript den Receiver, in welchem Zustand er sich befindet, gibt die Antwort aus und hebt dann die Sperre auf, damit der Receiver in den RUN-Zustand zurückkehrt.
Der Beispielcode
Dies ist Examples/ADSBReceiver-stateMachineAndLock.py aus dem festgelegten Modul,
ohne den Kopfkommentar der Datei. Der Skriptinhalt entspricht genau der ausgelieferten Fassung. Es
verwendet den Pin RESET an IO21, den dieses Board mit dem Receiver verbindet, zusammen
mit der UART1-Verdrahtung an IO17 und IO18.
import time
from machine import UART
from ADSBReceiver import ADSBReceiver
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
print("Hardware-resetting the module (RESET pin)...")
if adsb.hardwareReset():
# BOOTLOADER holds for ~3s at the fixed 115200bps, then the module
# auto-transitions to RUN (unless locked). Wait it out before talking to it.
time.sleep_ms(3200)
else:
print("No reset_pin configured - skipping hardware reset, module keeps running.")
print("RUN -> CONFIGURATION")
if not adsb.enterConfiguration():
print("Failed to enter CONFIGURATION state.")
else:
# Ask the module to confirm which state it is actually in.
ok, state = adsb.getConfigState()
if ok:
print("AT+CONFIG? = {}".format(state))
print("CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1)")
if not adsb.rebootToBootloader():
print("Failed to reboot to BOOTLOADER state.")
else:
# BOOTLOADER state always runs at the fixed 115200bps.
time.sleep_ms(200)
# Confirm the module really is in BOOTLOADER now.
ok, inBootloader = adsb.isBootloader()
if ok:
print("AT+BOOT? = {}".format("1 (BOOTLOADER)" if inBootloader else "0 (CONFIGURATION)"))
# The lock should be set, since rebootToBootloader() sets it automatically.
ok, locked = adsb.getLock()
if ok:
print("AT+LOCK? = {}".format("1 (locked)" if locked else "0 (unlocked)"))
print("Releasing lock: module will fall through to RUN state")
adsb.setLock(False)
# Module leaves BOOTLOADER and enters RUN at its configured run baud (115200 by default).
time.sleep_ms(200)
print("Done. Module should now be broadcasting in RUN state again.")
while True:
adsb.poll()
Speichern Sie es in einer Datei auf Ihrem Computer und führen Sie es dann mit
mpremote run <file.py> auf dem Board aus, wobei Sie anstelle von <file.py> den Namen Ihrer Datei einsetzen. Es
setzt voraus, dass das Modul wie auf der Seite
MicroPython-Bibliothek beschrieben installiert ist.
Erwartetes Ergebnis
Das Skript durchläuft seine Abfolge einmal, was wegen der Wartezeit von 3,2
Sekunden nach dem Hardware-Reset einige Sekunden dauert, und fragt danach weiter ab. Die Zeilen erscheinen in
dieser Reihenfolge: die Reset-Meldung, RUN -> CONFIGURATION, die Zeile AT+CONFIG? =,
CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1), die Zeile AT+BOOT? =,
die Zeile AT+LOCK? =, Releasing lock: module will fall through to RUN state
und Done. Module should now be broadcasting in RUN state again. Die drei Zeilen,
die einen Wert melden, stammen vom Receiver selbst. Die Beschreibung des Moduls
für die erste Zeile lautet: 1 für CONFIGURATION bei 115200 und 2 für CONFIGURATION bei der eingestellten
Baudrate.
Hardware-resetting the module (RESET pin)...
RUN -> CONFIGURATION
AT+CONFIG? = 1
CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1)
AT+BOOT? = 1 (BOOTLOADER)
AT+LOCK? = 1 (locked)
Releasing lock: module will fall through to RUN state
Done. Module should now be broadcasting in RUN state again.
Verwendete Funktionen
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverErstellt das Receiver-Objekt auf einem UART, den Sie bereits geöffnet haben. Wenn Sie einen Reset-Pin angeben, schaltet das Modul ihn auf einen hochohmigen Eingang, sodass der Pin nur während hardwareReset() angesteuert wird.
ReturnsEin Receiver-Objekt, bereit für die anderen Funktionen.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
machine.UART | uart | Ein geöffneter UART, der mit dem Receiver verbunden ist. Legen Sie die Größe seines Empfangspuffers beim Erstellen fest, wie das Beispiel es mit rxbuf=4096 tut: Bei dichtem Datenverkehr kann der Standardpuffer überlaufen und Zeilen beschädigen. |
int oder None | reset_pin | GPIO, der mit dem Pin RESET des Receivers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird. Dieses Board verwendet 21. |
hardwareReset(pulse_ms=20, active_low=True, resync_to_baud=115200)returns boolSetzt den Receiver zurück, indem der Pin RESET kurz auf Low gezogen und dann wieder als hochohmiger Eingang freigegeben wird. Der Receiver startet etwa 3 Sekunden lang im BOOTLOADER-Zustand mit fester Baudrate von 115200 neu und wechselt dann in den RUN-Zustand, sofern er nicht gesperrt ist. Bytes, die vor dem Reset übrig geblieben sind, werden verworfen.
ReturnsFalse, wenn Sie dem Konstruktor keinen reset_pin übergeben haben; dann passiert nichts. Andernfalls True.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | pulse_ms | Wie lange der Receiver im Reset gehalten wird, in Millisekunden. Optional, Standardwert 20. |
bool | active_low | True, wenn der Receiver zurückgesetzt wird, während RESET auf Low gelegt ist. Optional, Standardwert True. |
int oder None | resync_to_baud | Stellt außerdem den UART auf diese Baudrate um, damit der nächste Befehl nicht mit einer veralteten Rate gesendet wird. Optional, Standardwert 115200. None lässt den UART unverändert. |
enterConfiguration()returns boolVersetzt den Receiver vom RUN- in den CONFIGURATION-Zustand. Er sendet AT+CONFIG=1, stellt den UART auf 115200 um (die feste Baudrate des Receivers im CONFIGURATION-Zustand) und bestätigt den neuen Zustand mit AT+CONFIG?.
ReturnsTrue, wenn der Receiver meldet, dass er sich im CONFIGURATION-Zustand befindet, andernfalls False.
getConfigState()returns tuple(bool, int)Fragt den Receiver, in welchem Zustand er sich befindet (AT+CONFIG?).
Returns(True, state) bei Erfolg, wobei state 0 für RUN, 1 für CONFIGURATION bei 115200 und 2 für CONFIGURATION bei der eingestellten Baudrate ist. Andernfalls (False, 0).
rebootToBootloader()returns boolStartet den Receiver im BOOTLOADER-Zustand neu (AT+REBOOT_BOOTLOADER). Dabei wird auch die Sperre gesetzt, sodass der Receiver danach im BOOTLOADER bleibt.
ReturnsTrue bei Erfolg, andernfalls False.
isBootloader()returns tuple(bool, bool)Fragt den Receiver, ob er sich im BOOTLOADER-Zustand befindet (AT+BOOT?).
Returns(True, in_bootloader) bei Erfolg, andernfalls (False, False).
getLock()returns tuple(bool, bool)Fragt den Receiver, ob die Sperre gesetzt ist (AT+LOCK?). Solange sie gesetzt ist, bleibt der Receiver im BOOTLOADER-Zustand.
Returns(True, locked) bei Erfolg, andernfalls (False, False).
setLock(locked)returns boolSetzt oder hebt die Sperre auf (AT+LOCK=1 oder AT+LOCK=0). Wird sie aufgehoben, kann der Receiver den BOOTLOADER-Zustand verlassen und in den RUN-Zustand wechseln.
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
bool | locked | True, um die Sperre zu setzen, False, um sie aufzuheben. |
poll()returns NoneLiest jedes eingetroffene Byte, wertet die vollständigen Zeilen aus und ruft die registrierten Funktionen auf. Die Funktion blockiert nicht, rufen Sie sie daher bei jedem Durchlauf Ihrer Schleife auf.
ReturnsNichts.
Alles zusammen
Einstellungen können nur im CONFIGURATION-Zustand geschrieben werden, daher wechselt das Skript in diesen Zustand, bevor es nach Zustand, Sperre und Bootloader-Flag fragt.
rebootToBootloader() setzt die Sperre für Sie, weshalb das Skript die
Sperre zurückliest und sie dann mit setLock(False) aufhebt: Andernfalls
bliebe der Receiver im BOOTLOADER-Zustand und würde keine Flugzeugdaten senden.