Č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.
#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.
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 NoneIzrađ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
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | uartNum | ESP32 sklopovski UART koji se koristi. Neobavezno, zadano 1. |
int8_t | rxPin | ESP32 GPIO spojen na TX pin modula. Neobavezno, zadano 17. |
int8_t | txPin | ESP32 GPIO spojen na RX pin modula. Neobavezno, zadano 18. |
int8_t | resetPin | ESP32 GPIO spojen na RESET pin modula. Neobavezno, zadano 21. |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidOtvara 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
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | initialBaud | Brzina prijenosa (baud rate) s kojom se počinje. Neobavezno, zadano 115200. |
size_t | rxBufferSize | Veličina UART prijamnog međuspremnika u bajtovima. Neobavezno, zadano 4096. |
onAircraft(AircraftCallback cb)returns voidRegistrira funkciju koja se poziva za svako dekodirano izvješće o zrakoplovu koje prijamnik pošalje u CSV formatu.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
void (*)(const AdsbAircraft &ac) | cb | Funkcija 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:
| Polje | Opis |
|---|---|
icao | 24-bitna ICAO adresa zrakoplova, kao heksadecimalni niz znakova. |
callsign | Pozivni znak, prazan niz znakova 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 znakova, prazan kada je nepoznat. |
crcValid | True kada je CRC retka bio ispravan. |
onGround()returns boolPoziva 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
.