Skip to main content

Čitanje izvješća o zrakoplovima

Što prikazuje ovaj primjer​

Čitanje dekodiranih izvješća o zrakoplovima koja prijamnik š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 prijamnik imao, zatim je li zrakoplov na tlu i je li kontrolni zbroj izvješća bio ispravan.

Kod primjera​

Ovo je 1_ReadAircraftCSV.ino iz fiksirane (pinned) verzije biblioteke, bez zaglavnog komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje. Zadano ožičenje biblioteke, UART1 na IO17 i IO18 s resetom na IO21, jest ožičenje ove pločice, pa konstruktor ne treba argumente.

ESP32S3 Dev Module
1_ReadAircraftCSV.ino
#include "ADSB-Receiver-SOLDERED.h"

// Create an instance of the ADS-B object
// Using a different board? See example 7_CustomBoardWiring.
ADSBReceiver adsb;

// Called once per decoded aircraft update, with whichever fields the module had data for.
void onAircraft(const AdsbAircraft &ac)
{
Serial.print("ICAO ");
Serial.print(ac.icao);

if (ac.callsign.length())
{
Serial.print(" call=");
Serial.print(ac.callsign);
}
if (ac.hasPosition)
{
Serial.print(" lat=");
Serial.print(ac.lat, 5);
Serial.print(" lon=");
Serial.print(ac.lon, 5);
}
if (ac.hasAltBaro)
{
Serial.print(" altBaro=");
Serial.print(ac.altBaro);
Serial.print("ft");
}
if (ac.hasVelH)
{
Serial.print(" vel=");
Serial.print(ac.velH);
Serial.print("kt");
}
if (ac.squawk.length())
{
Serial.print(" squawk=");
Serial.print(ac.squawk);
}
Serial.print(" onGround=");
Serial.print(ac.onGround() ? "yes" : "no");
Serial.print(" crcValid=");
Serial.println(ac.crcValid ? "yes" : "no");
}

void setup()
{
// Start the USB serial monitor.
Serial.begin(115200);

// Open the UART link to the module at its factory-default RUN baud.
adsb.begin(115200);
// Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft);

Serial.println("Waiting for ADS-B traffic...");
}

void loop()
{
// Reads incoming bytes and fires the registered callbacks. Must run every loop.
adsb.poll();
}

Instalirajte biblioteku kako je prikazano na stranici Arduino biblioteka , spojite priloženu antenu na IPEX konektor prijamnika i učitajte skicu.

Očekivani rezultat​

Otvorite Tools → Serial Monitor, postavite brzinu prijenosa (baud rate) na 115200 i resetirajte pločicu. Skica jednom ispisuje Waiting for ADS-B traffic..., a zatim jedan redak za svako dekodirano ažuriranje zrakoplova. Prijamnik šalje 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= ako ih je prijamnik imao, a završava s onGround= i crcValid=. Polje za koje prijamnik još nema podataka izostavlja se iz retka.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Waiting for ADS-B traffic...
ICAO 471F8C call=WZZ3527 lat=45.93120 lon=18.31050 altBaro=37000ft vel=448.00kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.22853 lon=17.55442 altBaro=39000ft vel=472.00kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.18264 lon=19.64502 altBaro=38000ft vel=486.00kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.60175 lon=18.91855 altBaro=36000ft vel=461.00kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.40979 lon=17.43954 altBaro=31275ft vel=412.00kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.12000 lon=19.41322 altBaro=28450ft vel=397.00kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 altBaro=40000ft squawk=3521 onGround=no crcValid=yes
ICAO 471F8C call=WZZ3527 lat=45.92940 lon=18.31199 altBaro=37000ft vel=449.00kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.22718 lon=17.55691 altBaro=39000ft vel=471.00kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.18393 lon=19.64241 altBaro=38000ft vel=485.00kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.60009 lon=18.92047 altBaro=36000ft vel=462.00kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.40920 lon=17.44213 altBaro=31300ft vel=413.00kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.11846 lon=19.41463 altBaro=28425ft vel=396.00kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 call=LOT145 altBaro=40000ft vel=488.00kt squawk=3521 onGround=no crcValid=yes

Korištene funkcije​

ADSBReceiver(uint8_t uartNum, int8_t rxPin, int8_t txPin, int8_t resetPin)returns None

Izrađuje objekt prijamnika i određuje koji UART i pinove koristi. Svi su parametri neobavezni, a zadane vrijednosti odgovaraju ožičenju ove pločice, pa ih primjer ne navodi.

ReturnsKonstruktor; nema povratne vrijednosti.

Parametri

TipNazivOpis
uint8_tuartNumESP32 sklopovski UART koji se koristi. Neobavezno, zadano 1.
int8_trxPinESP32 GPIO spojen na TX pin modula. Neobavezno, zadano 17.
int8_ttxPinESP32 GPIO spojen na RX pin modula. Neobavezno, zadano 18.
int8_tresetPinESP32 GPIO spojen na RESET pin modula. Neobavezno, zadano 21.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Otvara UART vezu s prijamnikom. Pozovite ga jednom u setup(). Primjer koristi 115200, tvornički zadanu brzinu prijenosa prijamnika u njegovu stanju RUN.

ReturnsNišta.

Parametri

TipNazivOpis
uint32_tinitialBaudBrzina prijenosa (baud rate) s kojom se počinje. Neobavezno, zadano 115200.
size_trxBufferSizeVeličina UART prijamnog međuspremnika u bajtovima. Neobavezno, zadano 4096.
onAircraft(AircraftCallback cb)returns void

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

ReturnsNišta.

Parametri

TipNazivOpis
void (*)(const AdsbAircraft &ac)cbFunkcija koja se poziva, a prima AdsbAircraft. Polja za koja prijamnik nije imao podataka ostaju na zadanim vrijednostima, a odgovarajuća has... zastavica je false.

AdsbAircraft koji primjer čita ima ova polja:

PoljeOpis
icao24-bitna ICAO adresa zrakoplova, kao heksadecimalni niz znakova.
callsignPozivni znak, prazan niz znakova 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 znakova, prazan kada je nepoznat.
crcValidTrue kada je CRC retka bio ispravan.
onGround()returns bool

Poziva se na zrakoplovu koji callback primi. Govori vam označava li izvješće da je zrakoplov na tlu.

Returnstrue ako je zrakoplov na tlu.

poll()returns void

Čita sve bajtove koji su stigli, parsira potpune retke i pokreće registrirane callback funkcije. Ne blokira, zato ga pozivajte u svakom prolazu kroz loop().

ReturnsNišta.

Sastavljanje cjeline​

Izradite prijamnik bez argumenata, otvorite vezu s begin(), registrirajte onAircraft() i pozivajte poll() u loop(). Prijamnik zadano šalje CSV, pa ova skica ne treba korak konfiguracije: prijamnik na ovoj pločici javlja AT+ADSB_RX_PROTOCOL_DECODED=CSV s firmwareom 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 .