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.
#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.
[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 NoneStvara 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
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | uartNum | ESP32 hardverski UART koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola. |
int8_t | rxPin | ESP32 GPIO spojen na TX pin modula. Neobavezno, zadano 17. |
int8_t | txPin | ESP32 GPIO spojen na RX pin modula. Neobavezno, zadano 18. |
int8_t | resetPin | ESP32 GPIO spojen na RESET pin modula. Neobavezno, zadano 21. Proslijedite -1 ako nije spojen. |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidOtvara UART vezu s prijamnikom. Pozovite je jednom u setup().
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | initialBaud | Brzina prijenosa s kojom se počinje. Neobavezno, zadano 115200. Koristite 115200 osim ako postavka BAUDRATE modula nije ranije promijenjena. |
size_t | rxBufferSize | Veličina UART prijamnog međuspremnika u bajtovima. Neobavezno, zadano 4096. |
onSystemStats(SystemStatsCallback cb)returns voidRegistrira funkciju koja se poziva za svaku poruku sistemske statistike (redak #S: prijamnika).
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
void (*)(const SystemStats &s) | cb | Funkcija 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 voidRegistrira funkciju koja se poziva za svaku poruku ADS-B statistike (redak #AS: prijamnika).
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
void (*)(const AdsbStats &s) | cb | Funkcija 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 boolPrebacuje 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 boolUključ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
| Tip | Naziv | Opis |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE ili StatsProtocol::CSV. |
setAdsbStatisticsProtocol(StatsProtocol p)returns boolUključ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
| Tip | Naziv | Opis |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE ili StatsProtocol::CSV. |
exitConfiguration(uint32_t runBaud)returns boolVrać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
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | runBaud | Brzina 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.