MAVLink ADSB_VEHICLE
Was dieses Beispiel zeigt
Der Empfänger wird von der CSV- auf die MAVLink-Ausgabe umgestellt, und die
ADSB_VEHICLE-Nachricht, die er für jedes verfolgte Flugzeug sendet, wird dekodiert. Das Skript registriert außerdem einen
generischen 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 Examples/ADSBReceiver-mavlinkAdsbVehicle.py aus dem fest eingebundenen Modul,
ohne den Kopfkommentar der Datei. Der Skriptinhalt ist genau so, wie er ausgeliefert wird. Die
Verdrahtung von UART1 an IO17 und IO18 sowie des Resets an IO21 ist die eigene Verdrahtung des Boards.
from machine import UART
from ADSBReceiver import ADSBReceiver, DECODED_PROTOCOL_MAVLINK
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Called once per decoded ADSB_VEHICLE message, one per tracked aircraft.
def onAdsbVehicle(v):
line = "ICAO {:X}".format(v.icaoAddress)
if v.hasValidCallsign():
line += " call={}".format(v.callsign)
if v.hasValidCoords():
line += " lat={:.5f} lon={:.5f}".format(v.latDegrees(), v.lonDegrees())
if v.hasValidAltitude():
line += " alt={}m".format(v.altitudeMeters())
if v.hasValidVelocity():
line += " vel={}m/s".format(v.horVelocity / 100.0)
if v.hasValidSquawk():
line += " squawk={}".format(v.squawk)
line += " tslc={}s".format(v.tslc)
print(line)
# Called for every MAVLink frame received, whatever its message id.
def onFrame(f):
payload_hex = "".join("{:02X}".format(b) for b in f.payload)
print(
"[mavlink] msgid={} sysid={} crcValid={} payload={}".format(
f.msgid, f.sysid, "yes" if f.crcValid else "no", payload_hex
)
)
# 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(DECODED_PROTOCOL_MAVLINK)
adsb.exitConfiguration(115200)
while True:
adsb.poll()
Speichern Sie es in einer Datei auf Ihrem Computer und führen Sie es dann mit
mpremote run <file.py> auf dem Board aus, wobei Sie den Namen Ihrer Datei anstelle von <file.py> einsetzen. Dazu
muss das Modul installiert sein, wie auf der Seite
MicroPython-Bibliothek beschrieben.
Erwartetes Ergebnis
Sobald sich der Empfänger im MAVLink-Modus befindet, gibt das Skript zwei Arten von Zeilen aus. Eine
Zeile, die mit ICAO und der Hex-Adresse des Flugzeugs beginnt, stammt aus der
ADSB_VEHICLE-Nachricht. Es folgen nur die Felder, die die Nachricht als gültig kennzeichnet:
Rufzeichen, Breiten- und Längengrad, Höhe in Metern, Geschwindigkeit in Metern pro Sekunde
und Squawk-Code, und immer tslc, die Sekunden seit dem letzten Empfang
von diesem Flugzeug. Eine Zeile, die mit [mavlink] beginnt, zeigt die Nachrichten-ID, die
System-ID, ob die Prüfsumme gültig war, und die Nutzdaten als Hex-Bytes. Laut dem
Kommentar des Moduls sendet der Empfänger außerdem einmal pro Sekunde eine Heartbeat-Nachricht (ID 0)
neben den Flugzeugnachrichten, und der Frame-Callback erhält auch diese.
[mavlink] msgid=0 sysid=1 crcValid=yes payload=000000001B08000403
[mavlink] msgid=246 sysid=1 crcValid=yes payload=8C1F47000AFD261BEFBC190B2015AC00983A075A0000BF01B50A00575A5A33353237000003
ICAO 471F8C call=WZZ3527 lat=45.55400 lon=18.62361 alt=11277.6m vel=230.47m/s squawk=2741 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=D2A94C0068E9621B7327C60A6062B5000032DA5E0000BF012A1400525952364C4600000003
ICAO 4CA9D2 call=RYR6LF lat=45.94671 lon=18.07584 alt=11887.2m vel=242.82m/s squawk=5162 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=67AA4B0027A5171BEEDD610BC0BBB0002477AA610000BF01631800544859314A4B00000003
ICAO 4BAA67 call=THY1JK lat=45.45345 lon=19.09632 alt=11582.4m vel=250.02m/s squawk=6243 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=2D0C44008A12F91A1552840B806EA7001437A45C0000BF011F100041554136373500000003
ICAO 440C2D call=AUA675 lat=45.25308 lon=19.32211 alt=10972.8m vel=237.16m/s squawk=4127 tslc=0s
[mavlink] msgid=246 sysid=1 crcValid=yes payload=15024C003B9AB31A3178BF0B1C2267006C39944F6EFCBF0105120041534C3131330000000301
ICAO 4C0215 call=ASL113 lat=44.79781 lon=19.70975 alt=6758.94m vel=203.72m/s squawk=4613 tslc=1s
[mavlink] msgid=0 sysid=1 crcValid=yes payload=000000001B08000403
Verwendete Funktionen
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverErstellt das Empfängerobjekt auf einer UART-Schnittstelle, die Sie bereits geöffnet haben. Wenn Sie einen Reset-Pin angeben, schaltet das Modul ihn als hochohmigen Eingang, sodass der Pin nur während hardwareReset() angesteuert wird.
ReturnsEin Empfängerobjekt, bereit für die anderen Funktionen.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
machine.UART | uart | Eine geöffnete UART-Schnittstelle, die mit dem Empfänger verbunden ist. Legen Sie die Größe des Empfangspuffers beim Erstellen fest, wie das Beispiel es mit rxbuf=4096 tut: Bei dichtem Datenverkehr kann der Standardpuffer überlaufen und Zeilen beschädigen. |
int oder None | reset_pin | GPIO, der mit dem RESET-Pin des Empfängers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird. Dieses Board verwendet 21. |
onMavlinkAdsbVehicle(cb)returns NoneRegistriert die Funktion, die für jede MAVLink-ADSB_VEHICLE-Nachricht (Nachrichten-ID 246) mit gültiger Prüfsumme aufgerufen wird.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
function oder None | cb | Die aufzurufende Funktion, der ein MavlinkAdsbVehicle-Objekt übergeben wird. |
Das MavlinkAdsbVehicle-Objekt, das das Beispiel liest, hat diese Attribute und
Funktionen:
| Name | Beschreibung |
|---|---|
icaoAddress | Die ICAO-Adresse des Flugzeugs als Ganzzahl. |
callsign | Das Rufzeichen als String. |
latDegrees(), lonDegrees() | Breiten- und Längengrad in Grad. Die Nachricht enthält sie als Grad mal 10 Millionen. |
altitudeMeters() | Die Höhe in Metern. Die Nachricht enthält sie in Millimetern. |
horVelocity | Horizontale Geschwindigkeit in Zentimetern pro Sekunde, weshalb das Beispiel sie durch 100 teilt. |
squawk | Der Squawk-Code als Ganzzahl. |
tslc | Sekunden seit dem letzten Kontakt mit diesem Flugzeug. |
hasValidCallsign(), hasValidCoords(), hasValidAltitude(), hasValidVelocity(), hasValidSquawk() | True, wenn die Flags der Nachricht dieses Feld als gültig kennzeichnen. Prüfen Sie sie, bevor Sie das Feld verwenden. |
onMavlinkFrame(cb)returns NoneRegistriert die Funktion, die für jeden vollständig empfangenen MAVLink-Frame aufgerufen wird, unabhängig von seiner Nachrichten-ID. Das crcValid eines Frames ist nur für Nachrichten-IDs aussagekräftig, die das Modul prüfen kann, derzeit der Heartbeat (ID 0) und ADSB_VEHICLE (ID 246).
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
function oder None | cb | Die aufzurufende Funktion, der ein MavlinkFrame-Objekt übergeben wird, dessen Attribute unter anderem msgid, sysid, crcValid und payload (Bytes) sind. |
enterConfiguration()returns boolVersetzt den Empfänger vom Zustand RUN in den Zustand CONFIGURATION. Sie sendet AT+CONFIG=1, schaltet die UART-Schnittstelle auf 115200 (die feste Baudrate des Empfängers im Zustand CONFIGURATION) und bestätigt den neuen Zustand mit AT+CONFIG?. Einstellungen können nur in diesem Zustand geschrieben werden.
ReturnsTrue, wenn der Empfänger meldet, dass er sich im Zustand CONFIGURATION befindet, andernfalls False.
setAdsbRxProtocolDecoded(protocol)returns boolLegt das Format der dekodierten Flugzeugdaten fest, die der Empfänger sendet. Der Empfänger nimmt diese Einstellung als Namen entgegen, daher sendet das Modul CSV, Mavlink oder None.
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | Eines von DECODED_PROTOCOL_NONE (0), DECODED_PROTOCOL_CSV (1) oder DECODED_PROTOCOL_MAVLINK (2). |
exitConfiguration(run_baud=115200)returns boolVersetzt den Empfänger vom Zustand CONFIGURATION zurück in den Zustand RUN. Sie sendet AT+CONFIG=0, schaltet die UART-Schnittstelle auf run_baud 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 |
|---|---|---|
int | run_baud | Die Baudrate, als die die Einstellung BAUDRATE des Empfängers gespeichert ist, zum Beispiel 115200. Optional, Standardwert 115200. |
poll()returns NoneLiest alle eingegangenen Bytes, parst die vollständigen Zeilen und MAVLink-Frames (es unterscheidet sie Byte für Byte) und ruft die registrierten Funktionen auf. Sie blockiert nicht, rufen Sie sie daher bei jedem Durchlauf Ihrer Schleife auf.
ReturnsNichts.
Alles zusammenfügen
Registrieren Sie beide Callbacks, stellen Sie das dekodierte Protokoll auf MAVLink um, während sich der Empfänger
im Zustand CONFIGURATION befindet, kehren Sie in den Zustand RUN zurück und rufen Sie weiter poll() auf. Der
Frame-Callback sieht jeden Frame zuerst, und der Flugzeug-Callback folgt für jeden
ADSB_VEHICLE-Frame, der seine Prüfsumme bestanden hat.