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.
#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.
[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 NoneErstellt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. Vermeiden Sie 0, das meist die USB-Konsole ist. |
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. Ü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
| 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. |
onMavlinkAdsbVehicle(MavlinkAdsbVehicleCallback cb)returns voidRegistriert die Funktion, die für jeden ADSB_VEHICLE-Frame (Nachrichten-ID 246) aufgerufen wird, der die Prüfsummenkontrolle besteht.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const MavlinkAdsbVehicle &vehicle) | cb | Die aufzurufende Funktion. Die Felder und Hilfsfunktionen von MavlinkAdsbVehicle finden Sie in der Tabelle unterhalb der Funktionen. |
onMavlinkFrame(MavlinkFrameCallback cb)returns voidRegistriert 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
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const MavlinkFrame &frame) | cb | Die aufzurufende Funktion. Der Frame enthält msgid, sysid, compid, seq, payload, payloadLen und crcValid. |
enterConfiguration()returns boolVersetzt 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 boolWä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
| Typ | Name | Beschreibung |
|---|---|---|
DecodedProtocol | p | DecodedProtocol::NONE, DecodedProtocol::CSV oder DecodedProtocol::MAVLINK. |
exitConfiguration(uint32_t runBaud)returns boolVersetzt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | runBaud | Baudrate für den RUN-Zustand. Optional, Standardwert 115200. Sie muss mit der im Empfänger gespeicherten BAUDRATE-Einstellung übereinstimmen. |
poll()returns voidLiest 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 Funktion | Bedeutung |
|---|---|
icaoAddress | Die 24-Bit-ICAO-Adresse des Flugzeugs. Das Beispiel gibt sie in Hex aus. |
hasValidCallsign() und callsign | Ob 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 horVelocity | Ob die Geschwindigkeit gültig ist, und die horizontale Geschwindigkeit in cm/s. Das Beispiel teilt durch 100, um m/s auszugeben. |
hasValidSquawk() und squawk | Ob die Nachricht einen Squawk-Code enthält, und der Code. |
tslc | Sekunden 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.