Statistika
Što prikazuje ovaj primjer
Čitanje dviju poruka o stanju prijamnika: statistike sustava (opterećenje CPU-a i vrijeme rada) i ADS-B statistike (broj okvira primljenih u sekundi i kalibracija izmjerena prema signalu pulsa u sekundi). Prijamnik na ovoj pločici koristi firmware 2.89.28.0, verziju za koju je napisan njegov tehnički list, te prijavljuje statistiku sustava 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 skripti kaže da su obje na početku onemogućene, što ne odgovara onome što ova pločica prijavljuje. Skripta 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 skripta ispisuje, ali SC1 verzija ne dekodira Mode-A/C: ne tumačite tu vrijednost kao Mode-A/C promet. Vrijednost kalibracije je stvarna frekvencija mikrokontrolera prijamnika izmjerena prema signalu pulsa u sekundi GNSS modula, a pločica nema GNSS modul, pa je za smislenu vrijednost potreban vanjski PPS izvor.
Kod primjera
Ovo je Examples/ADSBReceiver-statistics.py iz fiksirane verzije modula, bez uvodnog komentara datoteke. Tijelo skripte je točno onakvo kako se isporučuje. Povezivanje UART1 na IO17 i IO18 te reset na IO21 vlastita su povezivanja pločice.
from machine import UART
from ADSBReceiver import ADSBReceiver, STATS_PROTOCOL_CSV
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Called once per second with the module's own CPU load and uptime.
def onSystemStats(s):
print(
"[SYSTEM] CPU load={}% uptime={}s crcValid={}".format(
s.cpuLoad, s.uptime, "yes" if s.crcValid else "no"
)
)
# Called once per second with the ADS-B receiver frame counts and PPS calibration.
def onAdsbStats(s):
print(
"[ADS-B] Mode-S fps={} Mode-A/C fps={} PPS calib={} crcValid={}".format(
s.fpss, s.fpsac, s.calib, "yes" if s.crcValid else "no"
)
)
# 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(STATS_PROTOCOL_CSV)
adsb.setAdsbStatisticsProtocol(STATS_PROTOCOL_CSV)
adsb.exitConfiguration(115200)
else:
print("Failed to enter CONFIGURATION state.")
while True:
adsb.poll()
Spremite ga u datoteku na računalu, a zatim ga pokrenite na pločici naredbom mpremote run <file.py>, uz zamjenu <file.py> imenom svoje datoteke. Potrebno je da je modul instaliran kako je prikazano na stranici MicroPython biblioteka.
Očekivani rezultat
Skripta 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 kontrolnog zbroja, uz polja Mode-A/C i PPS kalibracije opisana gore. Ako prijamnik ne uđe u stanje CONFIGURATION, skripta
ispisuje Failed to enter CONFIGURATION state. i nastavlja s ispitivanjem.
[SYSTEM] CPU load=20.8% uptime=1s crcValid=yes
[ADS-B] Mode-S fps=25 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=19.6% uptime=2s crcValid=yes
[ADS-B] Mode-S fps=21 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=18.4% uptime=3s crcValid=yes
[ADS-B] Mode-S fps=18 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=21.7% uptime=4s crcValid=yes
[ADS-B] Mode-S fps=29 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=20.2% uptime=5s crcValid=yes
[ADS-B] Mode-S fps=26 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=18.9% uptime=6s crcValid=yes
[ADS-B] Mode-S fps=23 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=19.7% uptime=7s crcValid=yes
[ADS-B] Mode-S fps=20 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
Korištene funkcije
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverStvara objekt prijamnika na UART-u koji ste već otvorili. Ako zadate reset pin, modul ga postavlja kao ulaz visoke impedancije, pa se pin pobuđuje samo tijekom hardwareReset().
ReturnsObjekt prijamnika spreman za ostale funkcije.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
machine.UART | uart | Otvoreni UART spojen na prijamnik. Veličinu njegova prijamnog međuspremnika odredite pri stvaranju, kao što to radi primjer s rxbuf=4096: gust promet može prepuniti zadani međuspremnik i oštetiti retke. |
int ili None | reset_pin | GPIO spojen na RESET pin prijamnika. Neobavezno, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21. |
onSystemStats(cb)returns NoneRegistrira funkciju koja se poziva za svaku poruku statistike sustava (redak #S: prijamnika).
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
function ili None | cb | Funkcija koja se poziva, a prima objekt SystemStats. s.cpuLoad je opterećenje CPU-a u postocima, s.uptime je vrijeme rada (primjer ga ispisuje u sekundama), a s.crcValid pokazuje je li se kontrolni zbroj podudarao. |
onAdsbStats(cb)returns NoneRegistrira funkciju koja se poziva za svaku poruku ADS-B statistike (redak #AS: prijamnika).
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
function ili None | cb | Funkcija koja se poziva, a prima objekt AdsbStats. 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 pulsa u sekundi (pločica nema GNSS modul), a s.crcValid je li se kontrolni zbroj podudarao. |
enterConfiguration()returns boolPrebacuje prijamnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje UART na 115200 (fiksna brzina prijenosa prijamnika u stanju CONFIGURATION) i potvrđuje novo stanje naredbom AT+CONFIG?. Postavke se mogu upisivati samo u tom stanju.
ReturnsTrue ako prijamnik prijavi da je u stanju CONFIGURATION, inače False.
setSystemStatisticsProtocol(protocol)returns boolUključuje ili isključuje poruku statistike sustava (opterećenje CPU-a i vrijeme rada prijamnika) (postavka SYSTEM_STATISTICS, upisuje se kao broj). Tehnički list prijamnika za firmware v2.89.28 navodi da je prema zadanim postavkama isključena.
ReturnsTrue ako je uspjelo, inače False.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1). |
setAdsbStatisticsProtocol(protocol)returns boolUključuje ili isključuje poruku ADS-B statistike (postavka ADSB_STATISTICS). Prijamnik ovu postavku prima kao naziv, pa modul šalje CSV ili None. Tehnički list prijamnika navodi CSV kao zadanu vrijednost, a prijamnik na ovoj pločici prijavljuje CSV; komentar u modulu kaže da je na početku onemogućena.
ReturnsTrue ako je uspjelo, inače False.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1). |
exitConfiguration(run_baud=115200)returns boolVraća prijamnik iz stanja CONFIGURATION natrag u stanje RUN. Šalje AT+CONFIG=0, prebacuje UART na run_baud i potvrđuje novo stanje naredbom AT+CONFIG?.
ReturnsTrue ako prijamnik prijavi da je u stanju RUN, inače False.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | run_baud | Brzina prijenosa (baud rate) na koju je spremljena postavka BAUDRATE prijamnika, na primjer 115200. Neobavezno, zadano 115200. |
poll()returns NoneČita sve pristigle bajtove, obrađuje potpune retke i poziva registrirane funkcije. Ne blokira izvođenje, zato ga pozovite u svakom prolazu petlje.
ReturnsNišta.
Sve zajedno
Registrirajte dva povratna poziva, 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 svojeg povratnog poziva, otprilike jednom u sekundi prema
komentarima iz samog primjera.