Zum Hauptinhalt springen

MAVLink ADSB_VEHICLE

Was dieses Beispiel zeigt​

Es schaltet den Empfänger von CSV- auf MAVLink-Ausgabe um und dekodiert die ADSB_VEHICLE-Nachricht, die er für jedes verfolgte Flugzeug sendet. Der Sketch registriert außerdem einen allgemeinen Frame-Callback, der die rohen Nutzdaten-Bytes jeder MAVLink-Nachricht ausgibt, die der Empfänger sendet. CSV ist laut Datenblatt die Standardausgabe des Empfängers, und 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 das Datenblatt geschrieben ist.

Der Beispielcode​

Dies ist 6_MavlinkAdsbVehicle.ino aus der fest eingebundenen Bibliothek, ohne den Kopfkommentar der Datei. Der Sketch-Rumpf ist genau so, wie er ausgeliefert wird.

ESP32S3 Dev Module
6_MavlinkAdsbVehicle.ino
#include "ADSB-Receiver-SOLDERED.h"

// Create an instance of the ADS-B object
ADSBReceiver adsb;

// Called once per decoded ADSB_VEHICLE message, one per tracked aircraft.
void onAdsbVehicle(const MavlinkAdsbVehicle &v)
{
Serial.print("ICAO ");
Serial.print(v.icaoAddress, HEX);

if (v.hasValidCallsign())
{
Serial.print(" call=");
Serial.print(v.callsign);
}
if (v.hasValidCoords())
{
Serial.print(" lat=");
Serial.print(v.latDegrees(), 5);
Serial.print(" lon=");
Serial.print(v.lonDegrees(), 5);
}
if (v.hasValidAltitude())
{
Serial.print(" alt=");
Serial.print(v.altitudeMeters());
Serial.print("m");
}
if (v.hasValidVelocity())
{
Serial.print(" vel=");
Serial.print(v.horVelocity / 100.0);
Serial.print("m/s");
}
if (v.hasValidSquawk())
{
Serial.print(" squawk=");
Serial.print(v.squawk);
}
Serial.print(" tslc=");
Serial.print(v.tslc);
Serial.println("s");
}

// Called for every MAVLink frame received, whatever its message id.
void onFrame(const MavlinkFrame &f)
{
Serial.print("[mavlink] msgid=");
Serial.print(f.msgid);
Serial.print(" sysid=");
Serial.print(f.sysid);
Serial.print(" crcValid=");
Serial.print(f.crcValid ? "yes" : "no");
Serial.print(" payload=");
for (uint8_t i = 0; i < f.payloadLen; i++)
{
if (f.payload[i] < 0x10)
Serial.print('0');
Serial.print(f.payload[i], HEX);
}
Serial.println();
}

void setup()
{
Serial.begin(115200);
adsb.begin(115200);

// Register the callbacks that will receive the decoded and raw MAVLink data.
adsb.onMavlinkAdsbVehicle(onAdsbVehicle);
adsb.onMavlinkFrame(onFrame);

// The module defaults to CSV output, so switch it to MAVLink here.
if (adsb.enterConfiguration())
{
adsb.setAdsbRxProtocolDecoded(DecodedProtocol::MAVLINK);
adsb.exitConfiguration(115200);
}
}

void loop()
{
adsb.poll();
}

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 und setzen Sie das Board zurück. Es erscheinen zwei Arten von Zeilen. Eine ICAO-Zeile stammt aus der dekodierten ADSB_VEHICLE-Nachricht: die Adresse des Flugzeugs in Hex, dann Rufzeichen, Position, Höhe in Metern, Geschwindigkeit in Metern pro Sekunde und Squawk, soweit die Nachricht sie als gültig kennzeichnet, und schließlich tslc, die Sekunden seit dem letzten Kontakt mit diesem Flugzeug. Eine [mavlink]-Zeile stammt von jedem Frame, den der Empfänger sendet, mit Nachrichten-ID, System-ID, der Angabe, ob die Prüfsumme gültig war, und den Nutzdaten als Hex-Bytes. Laut Bibliothek sendet der Empfänger neben den Flugzeugdaten auch einmal pro Sekunde eine HEARTBEAT-Nachricht (ID 0), erwarten Sie also auch [mavlink] msgid=0-Zeilen.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
[mavlink] msgid=0 sysid=1 crcValid=yes payload=000000001B08000403
[mavlink] msgid=246 sysid=1 crcValid=yes payload=8C1F4700E36E371B5B160C0B2015AC00983A075A0000BF01B50A00575A5A33353237000003
ICAO 471F8C call=WZZ3527 lat=45.66177 lon=18.53415 alt=11277.60m vel=230.47m/s squawk=2741 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=D2A94C00DB336F1BDB69AF0A6062B5000032DA5E0000BF012A1400525952364C4600000003
ICAO 4CA9D2 call=RYR6LF lat=46.02726 lon=17.92681 alt=11887.20m vel=242.82m/s squawk=5162 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=67AA4B006FD40B1B81CE790BC0BBB0002477AA610000BF01631800544859314A4B00000003
ICAO 4BAA67 call=THY1JK lat=45.37601 lon=19.25321 alt=11582.40m vel=250.02m/s squawk=6243 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=2D0C4400634A081BDEB4720B806EA7001437A45C0000BF011F100041554136373500000003
ICAO 440C2D call=AUA675 lat=45.35282 lon=19.20668 alt=10972.80m vel=237.16m/s squawk=4127 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=15024C00E5ADC11A9283B20B3C816F006C39944F6EFCBF0105120041534C3131330000000301
ICAO 4C0215 call=ASL113 lat=44.89006 lon=19.62485 alt=7307.58m vel=203.72m/s squawk=4613 tslc=1s
[mavlink] msgid=0 sysid=1 crcValid=yes payload=000000001B08000403

Verwendete Funktionen​

ADSBReceiver()returns None

Erstellt das Empfängerobjekt. Ohne Argumente verwendet es die Board-Standardwerte der Bibliothek: Hardware-UART 1, IO17 für die TX-Leitung des Empfängers, IO18 für dessen RX-Leitung und IO21 für dessen RESET-Leitung, so ist dieses Board verdrahtet.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. Vermeiden Sie 0, das meist die USB-Konsole ist.
int8_trxPinESP32-GPIO, der mit dem TX-Pin des Moduls verbunden ist. Optional, Standardwert 17.
int8_ttxPinESP32-GPIO, der mit dem RX-Pin des Moduls verbunden ist. Optional, Standardwert 18.
int8_tresetPinESP32-GPIO, der mit dem RESET-Pin des Moduls verbunden ist. Optional, Standardwert 21. Übergeben Sie -1, wenn er nicht angeschlossen ist.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Öffnet die UART-Verbindung zum Empfänger. Rufen Sie sie einmal in setup() auf.

ReturnsNichts.

Parameter

TypNameBeschreibung
uint32_tinitialBaudBaudrate, mit der begonnen wird. Optional, Standardwert 115200.
size_trxBufferSizeGröße des UART-Empfangspuffers in Bytes. Optional, Standardwert 4096.
onMavlinkAdsbVehicle(MavlinkAdsbVehicleCallback cb)returns void

Registriert die Funktion, die für jeden ADSB_VEHICLE-Frame (Nachrichten-ID 246) aufgerufen wird, der die Prüfsummenkontrolle besteht.

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const MavlinkAdsbVehicle &vehicle)cbDie aufzurufende Funktion. Die Felder und Hilfsfunktionen von MavlinkAdsbVehicle finden Sie in der Tabelle unterhalb der Funktionen.
onMavlinkFrame(MavlinkFrameCallback cb)returns void

Registriert die Funktion, die für jeden vollständigen MAVLink-Frame aufgerufen wird, unabhängig von seiner Nachrichten-ID. Das Feld crcValid des Frames ist nur für Nachrichten-IDs true, die die Bibliothek prüfen kann (HEARTBEAT, ID 0, und ADSB_VEHICLE, ID 246); bei jeder anderen Nachricht bleibt es false, auch wenn der Frame in Ordnung ist.

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const MavlinkFrame &frame)cbDie aufzurufende Funktion. Der Frame enthält msgid, sysid, compid, seq, payload, payloadLen und crcValid.
enterConfiguration()returns bool

Versetzt den Empfänger vom Zustand RUN in den Zustand CONFIGURATION. Sie sendet AT+CONFIG=1, stellt den lokalen UART auf 115200 um und bestätigt den neuen Zustand mit AT+CONFIG?.

Returnstrue, wenn der Empfänger meldet, dass er sich im Zustand CONFIGURATION befindet, andernfalls false.

setAdsbRxProtocolDecoded(DecodedProtocol p)returns bool

Wählt das Format der dekodierten Flugzeugdaten. Das Beispiel wählt MAVLink; die Bibliothek sendet den Namen Mavlink an den Empfänger.

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
DecodedProtocolpDecodedProtocol::NONE, DecodedProtocol::CSV oder DecodedProtocol::MAVLINK.
exitConfiguration(uint32_t runBaud)returns bool

Versetzt den Empfänger vom Zustand CONFIGURATION zurück in den Zustand RUN. Sie sendet AT+CONFIG=0, stellt den lokalen UART auf runBaud um und bestätigt den neuen Zustand mit AT+CONFIG?.

Returnstrue, wenn der Empfänger meldet, dass er sich im Zustand RUN befindet, andernfalls false.

Parameter

TypNameBeschreibung
uint32_trunBaudBaudrate für den RUN-Zustand. Optional, Standardwert 115200. Sie muss mit der im Empfänger gespeicherten BAUDRATE-Einstellung übereinstimmen.
poll()returns void

Liest jedes eingetroffene Byte und löst die registrierten Callbacks aus. Sie unterscheidet CSV-Zeilen und MAVLink-Frames Byte für Byte, sodass derselbe Aufruf beide Formate bedient. Sie blockiert nicht, rufen Sie sie also bei jedem Durchlauf von loop() auf.

ReturnsNichts.

Was der Callback erhält​

Das MavlinkAdsbVehicle-Objekt enthält die rohen MAVLink-Einheiten, und seine Hilfsfunktionen rechnen sie um und zeigen an, welche Felder der Empfänger befüllt hat.

Feld oder FunktionBedeutung
icaoAddressDie 24-Bit-ICAO-Adresse des Flugzeugs. Das Beispiel gibt sie in Hex aus.
hasValidCallsign() und callsignOb die Nachricht ein Rufzeichen enthält, und der Text des Rufzeichens.
hasValidCoords(), latDegrees() und lonDegrees()Ob die Position gültig ist, sowie Breiten- und Längengrad in Grad. Die rohen Werte lat und lon sind Grad mal 10^7.
hasValidAltitude() und altitudeMeters()Ob die Höhe gültig ist, und die Höhe in Metern. Der rohe Wert altitude ist in Millimetern.
hasValidVelocity() und horVelocityOb die Geschwindigkeit gültig ist, und die horizontale Geschwindigkeit in cm/s. Das Beispiel teilt durch 100, um m/s auszugeben.
hasValidSquawk() und squawkOb die Nachricht einen Squawk-Code enthält, und der Code.
tslcSekunden seit dem letzten Kontakt mit diesem Flugzeug.

Alles zusammenfügen​

Registrieren Sie zuerst beide Callbacks, schalten Sie den Empfänger dann auf MAVLink-Ausgabe um, während er sich im Zustand CONFIGURATION befindet, und rufen Sie weiterhin poll() auf. Der dekodierte Callback liefert übersichtliche Flugzeugdaten, und der Frame-Callback ist die richtige Stelle, wenn Sie alles sehen möchten, was der Empfänger sendet.

Der Sketch ändert das Ausgabeprotokoll des Empfängers. Um die CSV-Ausgabe für den Sketch „Read aircraft reports“ zurückzubekommen, führen Sie den Sketch auf der Seite Protokolle und Einstellungen konfigurieren aus, der CSV auswählt.