Čitanje izvješća o zrakoplovima
Što ovaj primjer prikazuje
Čitanje dekodiranih izvješća o zrakoplovima koja prijemnik šalje u svojem zadanom CSV formatu i ispis jednog retka za svako ažuriranje: ICAO adresa zrakoplova, zatim pozivni znak, položaj, barometarska visina, brzina i squawk kod, ako ih je prijemnik imao, zatim nalazi li se zrakoplov na tlu i je li kontrolni zbroj izvješća bio valjan.
Kod primjera
Ovo je Examples/ADSBReceiver-readAircraftCSV.py iz fiksirane verzije modula, bez uvodnog komentara datoteke. Tijelo skripte je točno onakvo kakvo se isporučuje. Povezivanje UART1 na IO17 i IO18 te reset na IO21 vlastito su povezivanje pločice.
from machine import UART
from ADSBReceiver import ADSBReceiver
# Open the UART link to the module at its factory-default RUN baud.
# Board default wiring: IO17 = module TX in, IO18 = module RX out, IO21 = RESET.
# Using a different board? See example ADSBReceiver-customBoardWiring.
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Called once per decoded aircraft update, with whichever fields the module had data for.
def onAircraft(ac):
line = "ICAO {}".format(ac.icao)
if ac.callsign:
line += " call={}".format(ac.callsign)
if ac.hasPosition:
line += " lat={:.5f} lon={:.5f}".format(ac.lat, ac.lon)
if ac.hasAltBaro:
line += " altBaro={}ft".format(ac.altBaro)
if ac.hasVelH:
line += " vel={}kt".format(ac.velH)
if ac.squawk:
line += " squawk={}".format(ac.squawk)
line += " onGround={}".format("yes" if ac.onGround() else "no")
line += " crcValid={}".format("yes" if ac.crcValid else "no")
print(line)
# Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft)
print("Waiting for ADS-B traffic...")
while True:
# Reads incoming bytes and fires the registered callbacks. Must run every loop.
adsb.poll()
Spremite ga u datoteku na svojem računalu, a zatim ga pokrenite na pločici naredbom
mpremote run <file.py>, pri čemu umjesto <file.py> upišite naziv svoje datoteke. Potrebno je
da je modul instaliran kako je prikazano na stranici
MicroPython biblioteka.
Očekivani rezultat
Skripta jednom ispisuje Waiting for ADS-B traffic..., a zatim jedan redak za svako dekodirano ažuriranje zrakoplova. Prijemnik šalje svoju poruku o zrakoplovu jednom u sekundi
za svaki zrakoplov koji prati. Svaki redak počinje s ICAO i adresom, dodaje
call=, lat= i lon=, altBaro= (stope), vel= (čvorovi) i squawk= kada
ih je prijemnik imao, a završava s onGround= i crcValid=. Polje za koje
prijemnik još nema podataka izostavlja se iz retka.
Waiting for ADS-B traffic...
ICAO 471F8C call=WZZ3527 lat=45.82343 lon=18.39996 altBaro=37000ft vel=448.0kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.14798 lon=17.70346 altBaro=39000ft vel=472.0kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.26007 lon=19.48813 altBaro=38000ft vel=486.0kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.50202 lon=19.03399 altBaro=36000ft vel=461.0kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.37443 lon=17.59458 altBaro=32775ft vel=412.0kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.02775 lon=19.49813 altBaro=26650ft vel=397.0kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 altBaro=40000ft squawk=3521 onGround=no crcValid=yes
ICAO 471F8C call=WZZ3527 lat=45.82163 lon=18.40145 altBaro=37000ft vel=449.0kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.14663 lon=17.70594 altBaro=39000ft vel=471.0kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.26136 lon=19.48551 altBaro=38000ft vel=485.0kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.50036 lon=19.03591 altBaro=36000ft vel=462.0kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.37384 lon=17.59717 altBaro=32800ft vel=413.0kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.02621 lon=19.49954 altBaro=26625ft vel=396.0kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 call=LOT145 altBaro=40000ft vel=488.0kt squawk=3521 onGround=no crcValid=yes
Adrese i vrijednosti ovise o tome koji se zrakoplovi nalaze unutar dometa prijemnika. Skripta se izvršava u beskonačnoj petlji.
Korištene funkcije
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverStvara objekt prijemnika na UART-u koji ste već otvorili. Ako navedete reset pin, modul ga postavlja kao ulaz visoke impedancije, pa se pin pokreće samo tijekom hardwareReset().
ReturnsObjekt prijemnika spreman za ostale funkcije.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
machine.UART | uart | Otvoreni UART povezan s prijemnikom. Veličinu njegova prijemnog međuspremnika odredite pri stvaranju, kao što to radi primjer s rxbuf=4096: gust promet može preplaviti zadani međuspremnik i oštetiti retke. |
int or None | reset_pin | GPIO spojen na pin RESET prijemnika. Neobavezan, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21. |
onAircraft(cb)returns NoneRegistrira funkciju koja se poziva za svako dekodirano izvješće o zrakoplovu koje prijemnik šalje u CSV formatu.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
function | cb | Funkcija koja se poziva, a prima objekt AdsbAircraft. Polja za koja prijemnik nije imao podataka zadržavaju zadane vrijednosti, a odgovarajući atribut has... je False. |
Objekt AdsbAircraft koji primjer čita ima sljedeće atribute:
| Atribut | Opis |
|---|---|
icao | 24-bitna ICAO adresa zrakoplova, kao heksadecimalni niz. |
callsign | Pozivni znak, prazan niz kada je nepoznat. |
hasPosition, lat, lon | Sadrži li izvješće položaj te zemljopisna širina i dužina. |
hasAltBaro, altBaro | Sadrži li izvješće barometarsku visinu te visina u stopama. |
hasVelH, velH | Sadrži li izvješće horizontalnu brzinu te brzina u čvorovima. |
squawk | Squawk kod kao niz, prazan kada je nepoznat. |
crcValid | True kada se završno CRC polje izvješća podudaralo sa sadržajem retka. |
onGround()returns boolPoziva se na objektu zrakoplova koji callback prima. Govori označava li izvješće da je zrakoplov na tlu.
ReturnsTrue ako je zrakoplov na tlu.
poll()returns NoneČita svaki pristigli bajt, parsira potpune retke i poziva registrirane funkcije. Ne blokira, zato ga pozivajte u svakom prolazu petlje.
ReturnsNišta.
Sve zajedno
Otvorite UART na 115200 baud, stvorite prijemnik na njemu, registrirajte onAircraft()
i pozivajte poll() u petlji. Prijemnik prema zadanim postavkama šalje CSV, pa ova skripta
ne treba korak konfiguracije: prijemnik na ovoj pločici javlja
AT+ADSB_RX_PROTOCOL_DECODED=CSV s firmverom 2.89.28.0, verzijom za koju je napisan njegov
tehnički list. Ako se ne pojavi nijedan redak o zrakoplovima, odaberite CSV kao što to radi primjer
Konfiguriranje protokola i postavki.