Skip to main content

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.

ESP32S3 Dev Module
3_ConfigureProtocolsAndSettings.ino
#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:

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

Stvara 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

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_tinitialBaudBaud brzina od koje se počinje. Neobavezno, zadano 115200. Koristite 115200 osim ako postavka BAUDRATE modula nije ranije promijenjena.
size_trxBufferSizeVeličina prijamnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096.
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?. Postavke se mogu upisivati samo u tom stanju.

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

setAdsbRxProtocolDecoded(DecodedProtocol p)returns bool

Odabire 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

TipNazivOpis
DecodedProtocolpDecodedProtocol::NONE, DecodedProtocol::CSV ili DecodedProtocol::MAVLINK.
setAdsbRxProtocolInc(IncMode m)returns bool

Odabire 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

TipNazivOpis
IncModemIncMode::ALWAYS_ONCE_PER_SECOND (0), IncMode::ONCE_PER_SECOND_IF_UPDATED (1) ili IncMode::IMMEDIATE_ON_POSITION_UPDATE (2).
setAdsbStatisticsProtocol(StatsProtocol p)returns bool

Uključ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

TipNazivOpis
StatsProtocolpStatsProtocol::NONE ili StatsProtocol::CSV.
setSystemLog(bool enable)returns bool

Uključ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

TipNazivOpis
boolenabletrue za uključivanje zapisnika, false za njegovo isključivanje.
setSystemStatisticsProtocol(StatsProtocol p)returns bool

Uključ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

TipNazivOpis
StatsProtocolpStatsProtocol::NONE (0) ili StatsProtocol::CSV (1).
setBaudrate(Baudrate b)returns bool

Postavlja 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

TipNazivOpis
BaudratebBaudrate::BPS_115200 (0), Baudrate::BPS_921600 (1), Baudrate::BPS_3000000 (2) ili Baudrate::BPS_57600 (3).
exitConfiguration(uint32_t runBaud)returns bool

Vrać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

TipNazivOpis
uint32_trunBaudBaud 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.