Flugzeugmeldungen lesen
Was dieses Beispiel zeigt
Das Beispiel liest die dekodierten Flugzeugmeldungen, die der Receiver im Standardformat CSV 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 Receiver sie hatte, danach, ob sich das Flugzeug am Boden befindet und ob die Prüfsumme der Meldung gültig war.
Der Beispielcode
Dies ist Examples/ADSBReceiver-readAircraftCSV.py aus dem festgelegten Modul,
ohne den Kopfkommentar der Datei. Der Skriptkörper 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
# Open the UART link to the module at its factory-default RUN baud.
# Board default wiring: IO17 = module TX in, IO18 = module RX out, IO21 = RESET.
# Using a different board? See example ADSBReceiver-customBoardWiring.
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Called once per decoded aircraft update, with whichever fields the module had data for.
def onAircraft(ac):
line = "ICAO {}".format(ac.icao)
if ac.callsign:
line += " call={}".format(ac.callsign)
if ac.hasPosition:
line += " lat={:.5f} lon={:.5f}".format(ac.lat, ac.lon)
if ac.hasAltBaro:
line += " altBaro={}ft".format(ac.altBaro)
if ac.hasVelH:
line += " vel={}kt".format(ac.velH)
if ac.squawk:
line += " squawk={}".format(ac.squawk)
line += " onGround={}".format("yes" if ac.onGround() else "no")
line += " crcValid={}".format("yes" if ac.crcValid else "no")
print(line)
# Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft)
print("Waiting for ADS-B traffic...")
while True:
# Reads incoming bytes and fires the registered callbacks. Must run every loop.
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 anstelle von <file.py> den Namen Ihrer Datei einsetzen. Dafür muss
das Modul installiert sein, wie auf der Seite
MicroPython-Bibliothek beschrieben.
Erwartetes Ergebnis
Das Skript gibt einmal Waiting for ADS-B traffic... aus, dann eine Zeile für jede
dekodierte Flugzeugaktualisierung. Der Receiver 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 Receiver sie hatte, und endet mit onGround= und crcValid=. Ein Feld, zu dem der
Receiver noch keine Daten hat, wird in der Zeile weggelassen.
Waiting for ADS-B traffic...
ICAO 471F8C call=WZZ3527 lat=45.82343 lon=18.39996 altBaro=37000ft vel=448.0kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.14798 lon=17.70346 altBaro=39000ft vel=472.0kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.26007 lon=19.48813 altBaro=38000ft vel=486.0kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.50202 lon=19.03399 altBaro=36000ft vel=461.0kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.37443 lon=17.59458 altBaro=32775ft vel=412.0kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.02775 lon=19.49813 altBaro=26650ft vel=397.0kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 altBaro=40000ft squawk=3521 onGround=no crcValid=yes
ICAO 471F8C call=WZZ3527 lat=45.82163 lon=18.40145 altBaro=37000ft vel=449.0kt squawk=2741 onGround=no crcValid=yes
ICAO 4CA9D2 call=RYR6LF lat=46.14663 lon=17.70594 altBaro=39000ft vel=471.0kt squawk=5162 onGround=no crcValid=yes
ICAO 4BAA67 call=THY1JK lat=45.26136 lon=19.48551 altBaro=38000ft vel=485.0kt squawk=6243 onGround=no crcValid=yes
ICAO 440C2D call=AUA675 lat=45.50036 lon=19.03591 altBaro=36000ft vel=462.0kt squawk=4127 onGround=no crcValid=yes
ICAO 50108A call=CTN472 lat=45.37384 lon=17.59717 altBaro=32800ft vel=413.0kt squawk=2307 onGround=no crcValid=yes
ICAO 4C0215 call=ASL113 lat=45.02621 lon=19.49954 altBaro=26625ft vel=396.0kt squawk=4613 onGround=no crcValid=yes
ICAO 48AE21 call=LOT145 altBaro=40000ft vel=488.0kt squawk=3521 onGround=no crcValid=yes
Die Adressen und Werte hängen davon ab, welche Flugzeuge sich in Reichweite des Receivers befinden. Das Skript läuft endlos in einer Schleife.
Verwendete Funktionen
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverErstellt das Receiver-Objekt auf einem UART, den Sie bereits geöffnet haben. Wenn Sie einen Reset-Pin angeben, setzt das Modul ihn auf einen hochohmigen Eingang, sodass der Pin nur während hardwareReset() aktiv getrieben wird.
ReturnsEin Receiver-Objekt, bereit für die anderen Funktionen.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
machine.UART | uart | Ein geöffneter UART, der mit dem Receiver verbunden ist. Legen Sie die Größe seines Empfangspuffers beim Erstellen fest, wie das Beispiel es mit rxbuf=4096 tut: Bei dichtem Verkehr kann der Standardpuffer überlaufen und Zeilen beschädigen. |
int oder None | reset_pin | GPIO, der mit dem RESET-Pin des Receivers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird. Dieses Board verwendet 21. |
onAircraft(cb)returns NoneRegistriert die Funktion, die für jede dekodierte Flugzeugmeldung aufgerufen wird, die der Receiver im CSV-Format sendet.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
function | cb | Die aufzurufende Funktion, der ein AdsbAircraft-Objekt übergeben wird. Felder, zu denen der Receiver keine Daten hatte, behalten ihre Standardwerte, wobei das zugehörige Attribut has... False ist. |
Das AdsbAircraft-Objekt, das das Beispiel liest, hat diese Attribute:
| Attribut | 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, sowie die Höhe in Fuß. |
hasVelH, velH | Ob die Meldung die horizontale Geschwindigkeit enthält, sowie die Geschwindigkeit in Knoten. |
squawk | Der Squawk-Code als String, leer, wenn unbekannt. |
crcValid | True, wenn das abschließende CRC-Feld der Meldung mit dem Inhalt der Zeile übereinstimmte. |
onGround()returns boolWird auf dem Flugzeugobjekt 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 NoneLiest alle eingegangenen Bytes, parst die vollständigen Zeilen und ruft die registrierten Funktionen auf. Die Funktion blockiert nicht, rufen Sie sie daher bei jedem Durchlauf Ihrer Schleife auf.
ReturnsNichts.
Alles zusammenfügen
Öffnen Sie den UART mit 115200 Baud, erstellen Sie den Receiver darauf, registrieren Sie onAircraft()
und rufen Sie poll() in einer Schleife auf. Der Receiver sendet standardmäßig CSV, daher
braucht dieses Skript keinen Konfigurationsschritt: Der Receiver 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. Wenn keine Flugzeugzeilen erscheinen, wählen Sie CSV aus, wie es das Beispiel
Protokolle und Einstellungen konfigurieren
zeigt.