Flugzeugmeldungen lesen
Was dieses Beispiel zeigt
Das Beispiel liest die dekodierten Flugzeugmeldungen, die der Empfänger in seinem standardmäßigen CSV-Format sendet, und gibt für jede Aktualisierung eine Zeile aus: die ICAO-Adresse des Flugzeugs, dann Rufzeichen, Position, barometrische Höhe, Geschwindigkeit und Squawk-Code, sofern der Empfänger sie hatte, danach, ob sich das Flugzeug am Boden befindet und ob die Prüfsumme der Meldung gültig war.
Der Beispielcode
Dies ist 1_ReadAircraftCSV.ino aus der festgelegten Version der Bibliothek, ohne den Kopfkommentar der Datei. Der Hauptteil des Sketches entspricht exakt der ausgelieferten Fassung. Die Standardverdrahtung der Bibliothek, UART1 an IO17 und IO18 mit dem Reset an IO21, ist die eigene Verdrahtung dieses Boards, daher braucht der Konstruktor keine 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();
}
Installieren Sie die Bibliothek, wie auf der Seite Arduino-Bibliothek gezeigt, schließen Sie die mitgelieferte Antenne an den IPEX-Connector des Empfängers an und laden Sie den Sketch hoch.
Erwartetes Ergebnis
Öffnen Sie Tools → Serieller Monitor, stellen Sie die Baudrate auf 115200 ein und setzen Sie das Board zurück. Der Sketch gibt einmal Waiting for ADS-B traffic... aus, danach eine Zeile für jede dekodierte Flugzeugaktualisierung. Der Empfänger sendet seine Flugzeugmeldung einmal pro Sekunde für jedes Flugzeug, das er verfolgt. Jede Zeile beginnt mit ICAO und der Adresse, ergänzt call=, lat= und lon=, altBaro= (Fuß), vel= (Knoten) und squawk=, sofern der Empfänger sie hatte, und endet mit onGround= und crcValid=. Ein Feld, zu dem der Empfänger noch keine Daten hat, wird in der Zeile weggelassen.
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
Verwendete Funktionen
ADSBReceiver(uint8_t uartNum, int8_t rxPin, int8_t txPin, int8_t resetPin)returns NoneErstellt das Empfängerobjekt und legt fest, welchen UART und welche Pins es verwendet. Alle Parameter sind optional, und die Standardwerte entsprechen der Verdrahtung dieses Boards, daher übergibt das Beispiel keine.
ReturnsKonstruktor; kein Rückgabewert.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. |
int8_t | rxPin | ESP32-GPIO, der mit dem TX-Pin des Moduls verbunden ist. Optional, Standardwert 17. |
int8_t | txPin | ESP32-GPIO, der mit dem RX-Pin des Moduls verbunden ist. Optional, Standardwert 18. |
int8_t | resetPin | ESP32-GPIO, der mit dem RESET-Pin des Moduls verbunden ist. Optional, Standardwert 21. |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidÖffnet die UART-Verbindung zum Empfänger. Rufen Sie sie einmal in setup() auf. Das Beispiel verwendet 115200, die werkseitig voreingestellte Baudrate des Empfängers in seinem RUN-Zustand.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | initialBaud | Baudrate, mit der begonnen wird. Optional, Standardwert 115200. |
size_t | rxBufferSize | Größe des UART-Empfangspuffers in Bytes. Optional, Standardwert 4096. |
onAircraft(AircraftCallback cb)returns voidRegistriert die Funktion, die für jede dekodierte Flugzeugmeldung aufgerufen wird, die der Empfänger im CSV-Format sendet.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const AdsbAircraft &ac) | cb | Die aufzurufende Funktion, der ein AdsbAircraft übergeben wird. Felder, zu denen der Empfänger keine Daten hatte, behalten ihre Standardwerte, das zugehörige has...-Flag ist false. |
Das AdsbAircraft, das das Beispiel liest, hat diese Felder:
| Feld | Beschreibung |
|---|---|
icao | Die 24-Bit-ICAO-Adresse des Flugzeugs als Hex-String. |
callsign | Das Rufzeichen, ein leerer String, wenn es unbekannt ist. |
hasPosition, lat, lon | Ob die Meldung eine Position enthält, sowie Breiten- und Längengrad. |
hasAltBaro, altBaro | Ob die Meldung die barometrische Höhe enthält, und die Höhe in Fuß. |
hasVelH, velH | Ob die Meldung die horizontale Geschwindigkeit enthält, und die Geschwindigkeit in Knoten. |
squawk | Der Squawk-Code als String, leer, wenn er unbekannt ist. |
crcValid | True, wenn die CRC der Zeile korrekt war. |
onGround()returns boolWird auf dem Flugzeug aufgerufen, das der Callback erhält. Gibt an, ob die Meldung das Flugzeug als am Boden befindlich kennzeichnet.
Returnstrue, wenn sich das Flugzeug am Boden befindet.
poll()returns voidLiest jedes eingetroffene Byte, parst die vollständigen Zeilen und löst die registrierten Callbacks aus. Die Funktion blockiert nicht, rufen Sie sie daher bei jedem Durchlauf von loop() auf.
ReturnsNichts.
Alles zusammengesetzt
Erstellen Sie den Empfänger ohne Argumente, öffnen Sie die Verbindung mit begin(), registrieren Sie onAircraft() und rufen Sie poll() in loop() auf. Der Empfänger sendet standardmäßig CSV, daher braucht dieser Sketch keinen Konfigurationsschritt: Der Empfänger auf diesem Board meldet AT+ADSB_RX_PROTOCOL_DECODED=CSV mit der Firmware 2.89.28.0, der Version, für die sein Datenblatt geschrieben ist. Falls keine Flugzeugzeilen erscheinen, wählen Sie CSV aus, wie es das Beispiel
Protokolle und Einstellungen konfigurieren
zeigt.