Zum Hauptinhalt springen

Eigene Board-Verdrahtung

Was dieses Beispiel zeigt​

Verwendung des Moduls, wenn der Receiver nicht so verdrahtet ist wie auf diesem Board: ein anderer UART, andere GPIO-Pins oder gar keine RESET-Leitung. Sie bauen den UART selbst auf und übergeben ihn an das Modul, sodass Sie nur das überschreiben, was abweicht.

Auf diesem Board brauchen Sie das nicht. Der Receiver ist mit UART1 an IO17, IO18 und IO21 verdrahtet, wie in Flugzeugmeldungen lesen. Verwenden Sie diese Seite, wenn Sie ein Receiver-Modul von Soldered in Ihr eigenes ESP32-Design einbauen.

Der Beispielcode​

Dies ist Examples/ADSBReceiver-customBoardWiring.py aus dem festgelegten Modul, ohne den Kopfkommentar der Datei. Der Hauptteil des Skripts entspricht genau der ausgelieferten Fassung. Die Beispielverdrahtung ist UART2 an IO4 und IO5 ohne RESET-Pin.

from machine import UART
from ADSBReceiver import ADSBReceiver

# Example: module on UART2, using IO4/IO5, with no RESET pin wired at all.
uart = UART(2, baudrate=115200, rx=4, tx=5, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=None)


# Called once per decoded aircraft update.
def onAircraft(ac):
print("ICAO {}".format(ac.icao))


# Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft)

while True:
adsb.poll()

Auf diesem Board ist der Receiver an IO17 und IO18 verdrahtet, daher lauscht das Skript in der ausgelieferten Fassung (IO4 und IO5) an Pins, die der Receiver nicht verwendet, und gibt nichts aus. Ändern Sie die UART-Zeile passend zu Ihrer Verdrahtung, oder verwenden Sie für dieses Board die Verdrahtung aus Flugzeugmeldungen lesen.

Erwartetes Ergebnis​

Ist der Receiver mit den Pins verbunden, die Sie dem UART zugewiesen haben, und befindet sich ein Flugzeug in Reichweite, gibt das Skript für jede dekodierte Flugzeugaktualisierung eine Zeile aus: ICAO gefolgt von der 24-Bit-Adresse des Flugzeugs in Hexadezimalschreibweise. Die Adressen hängen davon ab, welche Flugzeuge in Reichweite sind. Das Skript läuft endlos in einer Schleife.

Verwendete Funktionen​

ADSBReceiver(uart, reset_pin=None)returns ADSBReceiver

Erstellt das Receiver-Objekt auf einem UART, den 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 Receiver-Objekt, bereit für die anderen Funktionen.

Parameter

TypNameBeschreibung
machine.UARTuartEin geöffneter UART, der mit dem Receiver verbunden ist. Legen Sie die Größe seines Empfangspuffers beim Erstellen fest, wie im Beispiel mit rxbuf=4096: Bei dichtem Verkehr kann der Standardpuffer überlaufen und Zeilen beschädigen.
int oder Nonereset_pinGPIO, der mit dem RESET-Pin des Receivers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird.
onAircraft(cb)returns None

Registriert die Funktion, die für jede dekodierte Flugzeugmeldung aufgerufen wird, die der Receiver im CSV-Format sendet.

ReturnsNichts.

Parameter

TypNameBeschreibung
functioncbDie aufzurufende Funktion, der ein AdsbAircraft-Objekt übergeben wird. ac.icao ist die ICAO-Adresse des Flugzeugs als Hex-String. Felder, zu denen der Receiver keine Daten hatte, behalten ihre Standardwerte, wobei das zugehörige has...-Attribut False ist.
poll()returns None

Liest jedes eingetroffene Byte, verarbeitet 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 zusammengefügt​

Nur die UART(...)-Zeile und das Argument reset_pin ändern sich, wenn Ihre Verdrahtung abweicht. Alles danach, onAircraft() und poll(), funktioniert genauso wie auf diesem Board. Der Receiver muss weiterhin für die CSV-Ausgabe eingerichtet sein, die laut Datenblatt des Receivers für die Receiver-Firmware v2.89.28 die Standardeinstellung ist. Die Firmware Ihres Receivers wurde nicht dagegen geprüft.