Skip to main content

Automat stanja i zaključavanje

Što ovaj primjer prikazuje​

Provođenje prijemnika kroz sva njegova stanja: hardverski reset u stanje BOOTLOADER, automatski prelazak u RUN, prebacivanje u CONFIGURATION, namjeran povratak u BOOTLOADER koji prijemnik tamo zaključava i, na kraju, otpuštanje zaključavanja tako da prijemnik ponovno prijeđe u RUN. Skica u svakom koraku pita prijemnik u kojem je stanju.

Kôd primjera​

Ovo je 5_StateMachineAndLock.ino iz fiksirane biblioteke, bez uvodnog komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje. Koristi pin RESET na IO21, koji ova pločica spaja na prijemnik.

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();
}

Očekivani rezultat​

Otvorite Tools → Serial Monitor, postavite brzinu prijenosa (baud rate) na 115200 i resetirajte pločicu. Skica jednom izvodi svoj slijed u setup(), što traje nekoliko sekundi zbog čekanja od 3,2 sekunde nakon hardverskog reseta. Retci se pojavljuju ovim redoslijedom: poruka o resetu, RUN -> CONFIGURATION, redak AT+CONFIG? =, CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1), redak AT+BOOT? =, redak AT+LOCK? =, Releasing lock: module will fall through to RUN state i Done. Module should now be broadcasting in RUN state again. Tri retka koja javljaju vrijednost dolaze od samog prijemnika, a biblioteka prvu opisuje kao 1 za CONFIGURATION pri 115200 i 2 za CONFIGURATION pri postavljenoj brzini prijenosa.

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.

Korištene funkcije​

ADSBReceiver()returns None

Stvara objekt prijemnika. Bez argumenata koristi zadane vrijednosti biblioteke za pločicu: hardverski UART 1, IO17 za TX liniju prijemnika, IO18 za njegovu RX liniju i IO21 za njegovu RESET liniju, što odgovara načinu na koji je ova pločica spojena.

ReturnsKonstruktor; nema povratne vrijednosti.

Parametri

TipNazivOpis
uint8_tuartNumHardverski UART ESP32 koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola.
int8_trxPinGPIO ESP32 spojen na pin TX modula. Neobavezno, zadano 17.
int8_ttxPinGPIO ESP32 spojen na pin RX modula. Neobavezno, zadano 18.
int8_tresetPinGPIO ESP32 spojen na pin RESET modula. Neobavezno, zadano 21. Proslijedite -1 ako nije spojen.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Otvara UART vezu s prijemnikom. Pozovite je jednom u setup().

ReturnsNišta.

Parametri

TipNazivOpis
uint32_tinitialBaudBrzina prijenosa (baud rate) s kojom se počinje. Neobavezno, zadano 115200.
size_trxBufferSizeVeličina prijemnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096.
hardwareReset(uint16_t pulseMs, bool activeLow, bool resyncTo115200)returns bool

Resetira prijemnik povlačenjem pina RESET u nisko stanje na pulseMs milisekundi i zatim ga otpušta, pa vam ne treba tipkalo ni jumper. Prijemnik se ponovno pokreće u stanju BOOTLOADER na fiksnih 115200 baud otprilike 3 sekunde, a zatim prelazi u RUN, osim ako je zaključan. Bajtovi preostali od prije reseta odbacuju se.

Returnsfalse ako konstruktoru nije zadan pin za reset, i u tom se slučaju ništa ne događa; inače true.

Parametri

TipNazivOpis
uint16_tpulseMsKoliko dugo prijemnik ostaje u resetu. Neobavezno, zadano 20.
boolactiveLowtrue ako se prijemnik resetira dok je RESET u niskom stanju. Neobavezno, zadano true.
boolresyncTo115200Također prebacuje lokalni UART na 115200, brzinu prijenosa koju prijemnik koristi nakon reseta. Neobavezno, zadano true.
enterConfiguration()returns bool

Prebacuje prijemnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje lokalni UART na 115200 i potvrđuje novo stanje naredbom AT+CONFIG?.

Returnstrue ako prijemnik javi da je u stanju CONFIGURATION, inače false.

getConfigState(uint8_t &state)returns bool

Naredbom AT+CONFIG? pita prijemnik u kojem je stanju.

Returnstrue ako je prijemnik odgovorio, inače false.

Parametri

TipNazivOpis
uint8_t &statePrima 0 za stanje RUN, 1 za CONFIGURATION pri 115200 baud i 2 za CONFIGURATION pri brzini prijenosa koju ste postavili.
rebootToBootloader()returns bool

Ponovno pokreće prijemnik u stanje BOOTLOADER naredbom AT+REBOOT_BOOTLOADER. Također postavlja zaključavanje, pa prijemnik ostaje u stanju BOOTLOADER dok ga ne otpustite.

Returnstrue ako je prijemnik odgovorio AT+OK ili objavio BOOTLOADER, inače false.

isBootloader(bool &inBootloader)returns bool

Naredbom AT+BOOT? pita prijemnik je li u stanju BOOTLOADER.

Returnstrue ako je prijemnik odgovorio, inače false.

Parametri

TipNazivOpis
bool &inBootloaderPrima true kada je prijemnik u stanju BOOTLOADER.
getLock(bool &locked)returns bool

Naredbom AT+LOCK? pita prijemnik je li zaključavanje postavljeno.

Returnstrue ako je prijemnik odgovorio, inače false.

Parametri

TipNazivOpis
bool &lockedPrima true kada je zaključavanje postavljeno.
setLock(bool locked)returns bool

Postavlja ili otpušta zaključavanje naredbom AT+LOCK=1 ili AT+LOCK=0. Dok je zaključavanje postavljeno, prijemnik ostaje u stanju BOOTLOADER; njegovim otpuštanjem prijemnik može prijeći u RUN.

Returnstrue ako je prijemnik odgovorio AT+OK, inače false.

Parametri

TipNazivOpis
boollockedtrue za postavljanje zaključavanja, false za njegovo otpuštanje.
poll()returns void

Čita sve pristigle bajtove, parsira potpune retke i poziva registrirane povratne funkcije (callbackove). Ne blokira, pa je pozovite u svakom prolazu loop().

ReturnsNišta.

Sve zajedno​

Prijemnik ima tri stanja s kojima radite: RUN (dekodiranje i prijavljivanje zrakoplova), CONFIGURATION (čitanje i zapisivanje postavki) i BOOTLOADER (koji radi na fiksnih 115200 baud). Hardverski reset uvijek počinje u stanju BOOTLOADER i nakon otprilike 3 sekunde prelazi u RUN. Zaključavanje je ono što zaustavlja taj prelazak: postavlja ga rebootToBootloader(), a otpušta setLock(false), pa prijemnik nastavlja u RUN.

Ne ostavljajte zaključavanje postavljenim. Zaključani prijemnik ostaje u stanju BOOTLOADER i ne prijavljuje zrakoplove dok ga ne otpustite pomoću setLock(false).