Konfiguriranje protokola i postavki
Što prikazuje ovaj primjer
Upisivanje postavki prijemnika iz skice: protokol dekodiranog izlaza (CSV ili MAVLink), koliko se često šalju izvješća o zrakoplovima, dva statistička protokola, vlastiti sistemski zapisnik prijemnika i njegova baud brzina u stanju RUN. Svaki upis ispisuje je li ga prijemnik prihvatio.
Programski kod primjera
Ovo je 3_ConfigureProtocolsAndSettings.ino iz fiksirane verzije biblioteke, bez
uvodnog komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje. Skica odabire CSV
izlaz, zato mijenjajte jednu vrijednost po jednu kako biste vidjeli što koja postavka radi.
#include "ADSB-Receiver-SOLDERED.h"
// Create an instance of the ADS-B object
ADSBReceiver adsb;
// Small helper to print whether a setting write succeeded.
void printResult(const char *what, bool ok)
{
Serial.print(what);
Serial.println(ok ? " -> AT+OK" : " -> FAILED");
}
void setup()
{
Serial.begin(115200);
adsb.begin(115200);
// Settings can only be written while in CONFIGURATION state.
if (!adsb.enterConfiguration())
{
Serial.println("Failed to enter CONFIGURATION state.");
return;
}
// --- ADS-B decoded output protocol ---
printResult("ADSB_RX_PROTOCOL_DECODED=CSV", adsb.setAdsbRxProtocolDecoded(DecodedProtocol::CSV));
// Reporting cadence for decoded aircraft: update ASAP after any position update.
printResult("ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE",
adsb.setAdsbRxProtocolInc(IncMode::IMMEDIATE_ON_POSITION_UPDATE));
// Per-aircraft ADS-B statistics (frames/s, PPS calibration), see example 4.
printResult("ADSB_STATISTICS=CSV", adsb.setAdsbStatisticsProtocol(StatsProtocol::CSV));
// --- SYSTEM settings ---
printResult("SYSTEM_LOG=0", adsb.setSystemLog(false));
printResult("SYSTEM_STATISTICS=CSV", adsb.setSystemStatisticsProtocol(StatsProtocol::CSV));
// Changing BAUDRATE takes effect on the *next* RUN state entry: exitConfiguration()
// below must be told the new value so the local UART follows the module.
printResult("BAUDRATE=BPS_115200", adsb.setBaudrate(Baudrate::BPS_115200));
Serial.println("Returning to RUN state...");
adsb.exitConfiguration(115200);
}
void loop()
{
}
Očekivani rezultat
Otvorite Tools → Serial Monitor, postavite baud brzinu na 115200 i resetirajte pločicu. Kada prijemnik prihvati svaki upis, skica ispisuje:
ADSB_RX_PROTOCOL_DECODED=CSV -> AT+OK
ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE -> AT+OK
ADSB_STATISTICS=CSV -> AT+OK
SYSTEM_LOG=0 -> AT+OK
SYSTEM_STATISTICS=CSV -> AT+OK
BAUDRATE=BPS_115200 -> AT+OK
Returning to RUN state...
Upis koji prijemnik odbije ispisuje FAILED umjesto AT+OK. Ako prijemnik
ne uđe u stanje CONFIGURATION, skica ispisuje Failed to enter CONFIGURATION state. i zaustavlja se. Skica se izvodi jednom, a loop() ostaje prazan.
Korištene funkcije
ADSBReceiver()returns NoneStvara objekt prijemnika. Bez argumenata koristi zadane vrijednosti biblioteke za ovu 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 | Baud brzina od koje se počinje. Neobavezno, zadano 115200. Koristite 115200 osim ako postavka BAUDRATE modula nije ranije promijenjena. |
size_t | rxBufferSize | Veličina prijamnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096. |
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?. Postavke se mogu upisivati samo u tom stanju.
Returnstrue ako prijemnik javi da je u stanju CONFIGURATION, inače false.
setAdsbRxProtocolDecoded(DecodedProtocol p)returns boolOdabire format dekodiranih podataka o zrakoplovima koje prijemnik šalje. Prijemnik ovu postavku prima kao naziv, pa biblioteka šalje CSV, Mavlink ili None.
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
DecodedProtocol | p | DecodedProtocol::NONE, DecodedProtocol::CSV ili DecodedProtocol::MAVLINK. |
setAdsbRxProtocolInc(IncMode m)returns boolOdabire koliko se često šalju izvješća o zrakoplovima (postavka ADSB_RX_PROTOCOL_INC).
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
IncMode | m | IncMode::ALWAYS_ONCE_PER_SECOND (0), IncMode::ONCE_PER_SECOND_IF_UPDATED (1) ili IncMode::IMMEDIATE_ON_POSITION_UPDATE (2). |
setAdsbStatisticsProtocol(StatsProtocol p)returns boolUključuje ili isključuje ADS-B statističku poruku za pojedini zrakoplov (postavka ADSB_STATISTICS). Prijemnik ovu postavku prima kao naziv, pa biblioteka šalje CSV ili None.
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE ili StatsProtocol::CSV. |
setSystemLog(bool enable)returns boolUključuje ili isključuje vlastiti sistemski zapisnik prijemnika (postavka SYSTEM_LOG, upisuje se kao 1 ili 0).
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
bool | enable | true za uključivanje zapisnika, false za njegovo isključivanje. |
setSystemStatisticsProtocol(StatsProtocol p)returns boolUključuje ili isključuje poruku sa sistemskom statistikom (opterećenje procesora i vrijeme rada prijemnika) (postavka SYSTEM_STATISTICS, upisuje se kao broj).
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE (0) ili StatsProtocol::CSV (1). |
setBaudrate(Baudrate b)returns boolPostavlja baud brzinu prijemnika za stanje RUN (postavka BAUDRATE). Stupa na snagu sljedeći put kada prijemnik uđe u stanje RUN, zato istu vrijednost proslijedite funkciji exitConfiguration().
Returnstrue ako je prijemnik odgovorio s AT+OK, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
Baudrate | b | Baudrate::BPS_115200 (0), Baudrate::BPS_921600 (1), Baudrate::BPS_3000000 (2) ili Baudrate::BPS_57600 (3). |
exitConfiguration(uint32_t runBaud)returns boolVraća prijemnik iz stanja CONFIGURATION u stanje RUN. Šalje AT+CONFIG=0, prebacuje lokalni UART na runBaud i potvrđuje novo stanje naredbom AT+CONFIG?.
Returnstrue ako prijemnik javi da je u stanju RUN, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | runBaud | Baud brzina za stanje RUN. Neobavezno, zadano 115200. Mora se podudarati sa spremljenom postavkom BAUDRATE prijemnika. |
Sastavljanje cjeline
Svaki upis nalazi se između enterConfiguration() i exitConfiguration(). Tipizirane
funkcije primaju enumeracije biblioteke, pa nikada ne morate sami pisati sirovi
tekst postavke. Primjer mijenja samo vrijednosti koje navodi, a
BPS_115200 je tvornički zadana baud brzina u stanju RUN koja se koristi svugdje drugdje u ovoj
dokumentaciji.
Ako upišete drukčiju baud brzinu, proslijedite istu brzinu funkciji
exitConfiguration() i funkciji begin() u svakoj skici koja
nakon toga komunicira s prijemnikom. Neusklađenost uzrokuje da vaša skica i prijemnik rade
različitim brzinama te ne stižu nikakvi podaci o zrakoplovima.