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.
#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.
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 NoneStvara 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
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | uartNum | Hardverski UART ESP32 koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola. |
int8_t | rxPin | GPIO ESP32 spojen na pin TX modula. Neobavezno, zadano 17. |
int8_t | txPin | GPIO ESP32 spojen na pin RX modula. Neobavezno, zadano 18. |
int8_t | resetPin | GPIO ESP32 spojen na pin RESET modula. Neobavezno, zadano 21. Proslijedite -1 ako nije spojen. |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidOtvara UART vezu s prijemnikom. Pozovite je jednom u setup().
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | initialBaud | Brzina prijenosa (baud rate) s kojom se počinje. Neobavezno, zadano 115200. |
size_t | rxBufferSize | Veličina prijemnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096. |
hardwareReset(uint16_t pulseMs, bool activeLow, bool resyncTo115200)returns boolResetira 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
| Tip | Naziv | Opis |
|---|---|---|
uint16_t | pulseMs | Koliko dugo prijemnik ostaje u resetu. Neobavezno, zadano 20. |
bool | activeLow | true ako se prijemnik resetira dok je RESET u niskom stanju. Neobavezno, zadano true. |
bool | resyncTo115200 | Također prebacuje lokalni UART na 115200, brzinu prijenosa koju prijemnik koristi nakon reseta. Neobavezno, zadano true. |
enterConfiguration()returns boolPrebacuje 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 boolNaredbom AT+CONFIG? pita prijemnik u kojem je stanju.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint8_t & | state | Prima 0 za stanje RUN, 1 za CONFIGURATION pri 115200 baud i 2 za CONFIGURATION pri brzini prijenosa koju ste postavili. |
rebootToBootloader()returns boolPonovno 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 boolNaredbom AT+BOOT? pita prijemnik je li u stanju BOOTLOADER.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
bool & | inBootloader | Prima true kada je prijemnik u stanju BOOTLOADER. |
getLock(bool &locked)returns boolNaredbom AT+LOCK? pita prijemnik je li zaključavanje postavljeno.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
bool & | locked | Prima true kada je zaključavanje postavljeno. |
setLock(bool locked)returns boolPostavlja 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
| Tip | Naziv | Opis |
|---|---|---|
bool | locked | true 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).