Skip to main content

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.

ShellMicroPython
[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 ADSBReceiver

Stvara 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

TipNazivOpis
machine.UARTuartOtvoreni 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 Nonereset_pinGPIO spojen na RESET pin prijamnika. Neobavezno, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21.
onSystemStats(cb)returns None

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

ReturnsNišta.

Parametri

TipNazivOpis
function ili NonecbFunkcija 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 None

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

ReturnsNišta.

Parametri

TipNazivOpis
function ili NonecbFunkcija 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 bool

Prebacuje 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 bool

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

TipNazivOpis
intprotocolSTATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1).
setAdsbStatisticsProtocol(protocol)returns bool

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

TipNazivOpis
intprotocolSTATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1).
exitConfiguration(run_baud=115200)returns bool

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

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