Zum Hauptinhalt springen

Zustandsautomat und Sperre

Was dieses Beispiel zeigt​

Der Empfänger wird durch alle seine Zustände geführt: ein Hardware-Reset in den BOOTLOADER, der automatische Wechsel in RUN, ein Wechsel in CONFIGURATION, eine gezielte Rückkehr in den BOOTLOADER, die den Empfänger dort sperrt, und schließlich das Aufheben der Sperre, sodass er wieder in RUN übergeht. Der Sketch fragt bei jedem Schritt den Empfänger, in welchem Zustand er sich befindet.

Der Beispielcode​

Dies ist 5_StateMachineAndLock.ino aus der fest eingebundenen Bibliothek, ohne den Kopfkommentar der Datei. Der Sketch-Körper entspricht genau der ausgelieferten Fassung. Er verwendet den RESET-Pin an IO21, den dieses Board mit dem Empfänger verbindet.

ESP32S3 Dev Module
5_StateMachineAndLock.ino
#include "ADSB-Receiver-SOLDERED.h"

// Create an instance of the ADS-B object
ADSBReceiver adsb;

void setup()
{
Serial.begin(115200);
adsb.begin(115200);

Serial.println("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.
delay(3200);
}
else
{
Serial.println("No resetPin configured - skipping hardware reset, module keeps running.");
}

Serial.println("RUN -> CONFIGURATION");
if (!adsb.enterConfiguration())
{
Serial.println("Failed to enter CONFIGURATION state.");
return;
}

// Ask the module to confirm which state it is actually in.
uint8_t state;
if (adsb.getConfigState(state))
{
Serial.print("AT+CONFIG? = ");
Serial.println(state);
}

Serial.println("CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1)");
if (!adsb.rebootToBootloader())
{
Serial.println("Failed to reboot to BOOTLOADER state.");
return;
}

// BOOTLOADER state always runs at the fixed 115200bps.
delay(200);

// Confirm the module really is in BOOTLOADER now.
bool inBootloader = false;
if (adsb.isBootloader(inBootloader))
{
Serial.print("AT+BOOT? = ");
Serial.println(inBootloader ? "1 (BOOTLOADER)" : "0 (CONFIGURATION)");
}

// The lock should be set, since rebootToBootloader() sets it automatically.
bool locked = false;
if (adsb.getLock(locked))
{
Serial.print("AT+LOCK? = ");
Serial.println(locked ? "1 (locked)" : "0 (unlocked)");
}

Serial.println("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).
delay(200);
Serial.println("Done. Module should now be broadcasting in RUN state again.");
}

void loop()
{
adsb.poll();
}

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 ein und setzen Sie das Board zurück. Der Sketch führt seine Abfolge einmal in setup() aus, was wegen der Wartezeit von 3,2 Sekunden nach dem Hardware-Reset einige Sekunden dauert. Die Zeilen erscheinen in dieser Reihenfolge: die Reset-Meldung, RUN -> CONFIGURATION, die AT+CONFIG? =-Zeile, CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1), die AT+BOOT? =-Zeile, die AT+LOCK? =-Zeile, 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 Empfänger selbst, und laut Bibliothek steht beim ersten Wert 1 für CONFIGURATION bei 115200 und 2 für CONFIGURATION bei der eingestellten Baudrate.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
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()returns None

Erstellt das Empfängerobjekt. Ohne Argumente verwendet es die Board-Standardwerte der Bibliothek: Hardware-UART 1, IO17 für die TX-Leitung des Empfängers, IO18 für dessen RX-Leitung und IO21 für dessen RESET-Leitung, so wie dieses Board verdrahtet ist.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. Vermeiden Sie 0, der meist die USB-Konsole ist.
int8_trxPinESP32-GPIO, der mit dem TX-Pin des Moduls verbunden ist. Optional, Standardwert 17.
int8_ttxPinESP32-GPIO, der mit dem RX-Pin des Moduls verbunden ist. Optional, Standardwert 18.
int8_tresetPinESP32-GPIO, der mit dem RESET-Pin des Moduls verbunden ist. Optional, Standardwert 21. Übergeben Sie -1, wenn er nicht angeschlossen ist.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Öffnet die UART-Verbindung zum Empfänger. Rufen Sie sie einmal in setup() auf.

ReturnsNichts.

Parameter

TypNameBeschreibung
uint32_tinitialBaudBaudrate, mit der begonnen wird. Optional, Standardwert 115200.
size_trxBufferSizeGröße des UART-Empfangspuffers in Bytes. Optional, Standardwert 4096.
hardwareReset(uint16_t pulseMs, bool activeLow, bool resyncTo115200)returns bool

Setzt den Empfänger zurück, indem der RESET-Pin für pulseMs Millisekunden auf Low gezogen und dann wieder freigegeben wird, sodass Sie weder einen Taster noch eine Drahtbrücke brauchen. Der Empfänger startet für etwa 3 Sekunden im Zustand BOOTLOADER mit den fest eingestellten 115200 Baud neu und wechselt dann in RUN, sofern er nicht gesperrt ist. Bytes, die vor dem Reset übrig geblieben sind, werden verworfen.

Returnsfalse, wenn dem Konstruktor kein Reset-Pin übergeben wurde; in diesem Fall passiert nichts. Andernfalls true.

Parameter

TypNameBeschreibung
uint16_tpulseMsWie lange der Empfänger im Reset gehalten wird. Optional, Standardwert 20.
boolactiveLowtrue, wenn der Empfänger zurückgesetzt wird, solange RESET auf Low liegt. Optional, Standardwert true.
boolresyncTo115200Stellt auch den lokalen UART auf 115200 um, die Baudrate, die der Empfänger nach einem Reset verwendet. Optional, Standardwert true.
enterConfiguration()returns bool

Versetzt den Empfänger aus RUN in den Zustand CONFIGURATION. Sie sendet AT+CONFIG=1, stellt den lokalen UART auf 115200 um und bestätigt den neuen Zustand mit AT+CONFIG?.

Returnstrue, wenn der Empfänger meldet, dass er sich im Zustand CONFIGURATION befindet, andernfalls false.

getConfigState(uint8_t &state)returns bool

Fragt den Empfänger mit AT+CONFIG?, in welchem Zustand er sich befindet.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
uint8_t &stateErhält 0 für den Zustand RUN, 1 für CONFIGURATION bei 115200 Baud und 2 für CONFIGURATION bei der von Ihnen eingestellten Baudrate.
rebootToBootloader()returns bool

Startet den Empfänger mit AT+REBOOT_BOOTLOADER im Zustand BOOTLOADER neu. Sie setzt außerdem die Sperre, sodass der Empfänger im BOOTLOADER bleibt, bis Sie sie aufheben.

Returnstrue, wenn der Empfänger mit AT+OK geantwortet oder den BOOTLOADER gemeldet hat, andernfalls false.

isBootloader(bool &inBootloader)returns bool

Fragt den Empfänger mit AT+BOOT?, ob er sich im Zustand BOOTLOADER befindet.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
bool &inBootloaderErhält true, wenn sich der Empfänger im Zustand BOOTLOADER befindet.
getLock(bool &locked)returns bool

Fragt den Empfänger mit AT+LOCK?, ob die Sperre gesetzt ist.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
bool &lockedErhält true, wenn die Sperre gesetzt ist.
setLock(bool locked)returns bool

Setzt oder hebt die Sperre mit AT+LOCK=1 oder AT+LOCK=0 auf. Solange die Sperre gesetzt ist, bleibt der Empfänger im Zustand BOOTLOADER; wird sie aufgehoben, kann der Empfänger in RUN übergehen.

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
boollockedtrue, um die Sperre zu setzen, false, um sie aufzuheben.
poll()returns void

Liest alle eingetroffenen Bytes, wertet die vollständigen Zeilen aus und löst die registrierten Callbacks aus. Sie blockiert nicht, rufen Sie sie daher bei jedem Durchlauf von loop() auf.

ReturnsNichts.

Zusammenspiel​

Der Empfänger hat drei Zustände, mit denen Sie arbeiten: RUN (Flugzeuge dekodieren und melden), CONFIGURATION (Einstellungen lesen und schreiben) und BOOTLOADER (läuft mit fest eingestellten 115200 Baud). Ein Hardware-Reset beginnt immer im BOOTLOADER und wechselt nach etwa 3 Sekunden in RUN. Die Sperre verhindert diesen Wechsel: rebootToBootloader() setzt sie, und setLock(false) hebt sie auf, sodass der Empfänger in RUN weiterläuft.

Lassen Sie die Sperre nicht gesetzt. Ein gesperrter Empfänger bleibt im BOOTLOADER und meldet keine Flugzeuge, bis Sie die Sperre mit setLock(false) aufheben.