Skip to main content

Č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.

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

Stvara 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

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

Registrira funkciju koja se poziva za svako dekodirano izvješće o zrakoplovu koje prijemnik šalje u CSV formatu.

ReturnsNišta.

Parametri

TipNazivOpis
functioncbFunkcija 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:

AtributOpis
icao24-bitna ICAO adresa zrakoplova, kao heksadecimalni niz.
callsignPozivni znak, prazan niz kada je nepoznat.
hasPosition, lat, lonSadrži li izvješće položaj te zemljopisna širina i dužina.
hasAltBaro, altBaroSadrži li izvješće barometarsku visinu te visina u stopama.
hasVelH, velHSadrži li izvješće horizontalnu brzinu te brzina u čvorovima.
squawkSquawk kod kao niz, prazan kada je nepoznat.
crcValidTrue kada se završno CRC polje izvješća podudaralo sa sadržajem retka.
onGround()returns bool

Poziva 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.