Skip to main content

Statistika

Što ovaj primjer prikazuje​

Čitanje dviju poruka o stanju prijamnika: sistemske statistike (opterećenje CPU-a i vrijeme rada) i ADS-B statistike (broj primljenih okvira u sekundi i kalibracija izmjerena prema signalu jedan impuls u sekundi). Prijamnik na ovoj pločici koristi firmware 2.89.28.0, verziju za koju je napisan njegov tehnički list, i prijavljuje sistemsku statistiku kao isključenu (AT+SYSTEM_STATISTICS=0), a ADS-B statistiku kao CSV (AT+ADSB_STATISTICS=CSV), kako ih navodi tehnički list. Komentar u skici kaže da obje počinju kao onemogućene, što ne odgovara onome što ova pločica prijavljuje. Skica uključuje obje, pa radi u oba slučaja.

Dvije ADS-B vrijednosti na ovoj pločici trebaju dodatno objašnjenje. Ugrađeni prijamnik je osnovna SC1 verzija, koja dekodira samo ADS-B: dekodiranje Mode-A/C pripada verziji SC1-EXT. Statistička poruka prijamnika uvijek sadrži polje s brojem Mode-A/C okvira u sekundi, pa ga skica ispisuje, no SC1 verzija ne dekodira Mode-A/C: tu vrijednost ne treba čitati kao Mode-A/C promet. Vrijednost kalibracije je stvarna frekvencija mikrokontrolera prijamnika izmjerena prema signalu jedan impuls u sekundi GNSS modula, a pločica nema GNSS modul, pa je za smislenu vrijednost potreban vanjski izvor PPS signala.

Kôd primjera​

Ovo je 4_Statistics.ino iz fiksirane verzije biblioteke, bez zaglavnog komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje.

ESP32S3 Dev Module
4_Statistics.ino
#include "ADSB-Receiver-SOLDERED.h"

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

// Called once per second with the module's own CPU load and uptime.
void onSystemStats(const SystemStats &s)
{
Serial.print("[SYSTEM] CPU load=");
Serial.print(s.cpuLoad);
Serial.print("% uptime=");
Serial.print(s.uptime);
Serial.print("s crcValid=");
Serial.println(s.crcValid ? "yes" : "no");
}

// Called once per second with the ADS-B receiver frame counts and PPS calibration.
void onAdsbStats(const AdsbStats &s)
{
Serial.print("[ADS-B] Mode-S fps=");
Serial.print(s.fpss);
Serial.print(" Mode-A/C fps=");
Serial.print(s.fpsac);
Serial.print(" PPS calib=");
Serial.print(s.calib);
Serial.print(" crcValid=");
Serial.println(s.crcValid ? "yes" : "no");
}

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

// Register the callbacks that will receive the stats messages.
adsb.onSystemStats(onSystemStats);
adsb.onAdsbStats(onAdsbStats);

// Both statistics protocols default to disabled, so turn them on here.
if (adsb.enterConfiguration())
{
adsb.setSystemStatisticsProtocol(StatsProtocol::CSV);
adsb.setAdsbStatisticsProtocol(StatsProtocol::CSV);
adsb.exitConfiguration(115200);
}
else
{
Serial.println("Failed to enter CONFIGURATION state.");
}
}

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

Očekivani rezultat​

Otvorite Tools → Serial Monitor, postavite brzinu prijenosa na 115200 i resetirajte pločicu. Skica jednom u sekundi ispisuje jedan redak [SYSTEM] i jedan redak [ADS-B]. Redak [SYSTEM] prikazuje opterećenje CPU-a prijamnika u postocima, njegovo vrijeme rada u sekundama i je li kontrolni zbroj poruke bio ispravan. Redak [ADS-B] prikazuje broj Mode-S okvira primljenih u sekundi i rezultat provjere kontrolnog zbroja, uz polja Mode-A/C i PPS kalibracije opisana gore.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
[SYSTEM] CPU load=21.30% uptime=1s crcValid=yes
[ADS-B] Mode-S fps=23 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=18.70% uptime=2s crcValid=yes
[ADS-B] Mode-S fps=19 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=19.40% uptime=3s crcValid=yes
[ADS-B] Mode-S fps=27 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=22.10% uptime=4s crcValid=yes
[ADS-B] Mode-S fps=31 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=18.20% uptime=5s crcValid=yes
[ADS-B] Mode-S fps=22 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=20.60% uptime=6s crcValid=yes
[ADS-B] Mode-S fps=26 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=19.10% uptime=7s crcValid=yes
[ADS-B] Mode-S fps=24 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes

Korištene funkcije​

ADSBReceiver()returns None

Stvara objekt prijamnika. Bez argumenata koristi zadane vrijednosti biblioteke za pločicu: hardverski UART 1, IO17 za TX liniju prijamnika, 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_tuartNumESP32 hardverski UART koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola.
int8_trxPinESP32 GPIO spojen na TX pin modula. Neobavezno, zadano 17.
int8_ttxPinESP32 GPIO spojen na RX pin modula. Neobavezno, zadano 18.
int8_tresetPinESP32 GPIO spojen na RESET pin modula. Neobavezno, zadano 21. Proslijedite -1 ako nije spojen.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

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

ReturnsNišta.

Parametri

TipNazivOpis
uint32_tinitialBaudBrzina prijenosa s kojom se počinje. Neobavezno, zadano 115200. Koristite 115200 osim ako postavka BAUDRATE modula nije ranije promijenjena.
size_trxBufferSizeVeličina UART prijamnog međuspremnika u bajtovima. Neobavezno, zadano 4096.
onSystemStats(SystemStatsCallback cb)returns void

Registrira funkciju koja se poziva za svaku poruku sistemske statistike (redak #S: prijamnika).

ReturnsNišta.

Parametri

TipNazivOpis
void (*)(const SystemStats &s)cbFunkcija koja se poziva. s.cpuLoad je opterećenje CPU-a u postocima, s.uptime je vrijeme rada (primjer ga ispisuje u sekundama), a s.crcValid govori je li kontrolni zbroj bio ispravan.
onAdsbStats(AdsbStatsCallback cb)returns void

Registrira funkciju koja se poziva za svaku poruku ADS-B statistike (redak #AS: prijamnika).

ReturnsNišta.

Parametri

TipNazivOpis
void (*)(const AdsbStats &s)cbFunkcija koja se poziva. s.fpss je broj Mode-S okvira primljenih u sekundi, s.fpsac broj Mode-A/C okvira u sekundi (SC1 verzija na ovoj pločici ne dekodira Mode-A/C), s.calib stvarna frekvencija mikrokontrolera izmjerena prema GNSS signalu jedan impuls u sekundi (pločica nema GNSS modul), a s.crcValid je li kontrolni zbroj bio ispravan.
enterConfiguration()returns bool

Prebacuje prijamnik 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 zapisivati samo u ovom stanju.

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

setSystemStatisticsProtocol(StatsProtocol p)returns bool

Uključuje ili isključuje poruku sistemske statistike (postavka SYSTEM_STATISTICS). Tehnički list prijamnika za firmware v2.89.28 navodi je kao zadano isključenu.

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

Parametri

TipNazivOpis
StatsProtocolpStatsProtocol::NONE ili StatsProtocol::CSV.
setAdsbStatisticsProtocol(StatsProtocol p)returns bool

Uključuje ili isključuje poruku ADS-B statistike (postavka ADSB_STATISTICS). Tehnički list prijamnika navodi CSV kao zadanu vrijednost, a prijamnik na ovoj pločici prijavljuje CSV; komentar u biblioteci kaže da počinje kao onemogućena.

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

Parametri

TipNazivOpis
StatsProtocolpStatsProtocol::NONE ili StatsProtocol::CSV.
exitConfiguration(uint32_t runBaud)returns bool

Vraća prijamnik 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 prijamnik javi da je u stanju RUN, inače false.

Parametri

TipNazivOpis
uint32_trunBaudBrzina prijenosa za stanje RUN. Neobavezno, zadano 115200. Mora odgovarati pohranjenoj postavci BAUDRATE prijamnika.
poll()returns void

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

ReturnsNišta.

Sastavljanje cjeline​

Registrirajte povratne funkcije, uključite obje statističke poruke dok je prijamnik u stanju CONFIGURATION, vratite se u stanje RUN i nastavite pozivati poll(). Svaka poruka tada stiže do svoje povratne funkcije, otprilike jednom u sekundi prema komentarima u samom primjeru.