Zum Hauptinhalt springen

Individuelle Board-Verdrahtung

Was dieses Beispiel zeigt​

Verwendung der Bibliothek, wenn der Empfänger nicht so verdrahtet ist wie auf diesem Board: mit einem anderen Hardware-UART, anderen GPIO-Pins oder ganz ohne RESET-Leitung. Alle vier Konstruktorparameter sind optional und voneinander unabhängig, Sie überschreiben also nur die Werte, die von Ihrer Verdrahtung abweichen.

Auf diesem Board brauchen Sie das nicht. Der Empfänger ist mit UART1 sowie IO17, IO18 und IO21 verdrahtet, und das sind die Standardwerte der Bibliothek, daher genügt ADSBReceiver adsb;, wie in Flugzeugmeldungen lesen. Verwenden Sie diese Seite, wenn Sie ein Soldered-Empfängermodul in Ihr eigenes ESP32-Design einbauen.

Der Beispielcode​

Dies ist 7_CustomBoardWiring.ino aus der fixierten Bibliotheksversion, ohne den Kopfkommentar der Datei. Der Sketch-Körper entspricht exakt der ausgelieferten Fassung. Die Beispielverdrahtung nutzt UART2 an IO4 und IO5 ohne RESET-Pin.

ESP32S3 Dev Module
7_CustomBoardWiring.ino
#include "ADSB-Receiver-SOLDERED.h"

// Constructor parameters, in order:
// uartNum - which ESP32 hardware UART peripheral to use (avoid 0, that's usually the USB/console UART)
// rxPin - ESP32 GPIO wired to the module's TX pin
// txPin - ESP32 GPIO wired to the module's RX pin
// resetPin - ESP32 GPIO wired to the module's RESET pin, or -1 if not connected
//
// Example: module on UART2, using IO4/IO5, with no RESET pin wired at all.
ADSBReceiver adsb(2, 4, 5, -1);

// Called once per decoded aircraft update.
void onAircraft(const AdsbAircraft &ac)
{
Serial.print("ICAO ");
Serial.println(ac.icao);
}

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

// Open the UART link using the pins given to the constructor above.
adsb.begin(115200);
// Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft);
}

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

Auf diesem Board ist der Empfänger an IO17 und IO18 angeschlossen, daher lauscht der Sketch in der ausgelieferten Fassung (IO4 und IO5) auf Pins, die der Empfänger nicht verwendet, und gibt nichts aus. Passen Sie den Konstruktor an Ihre Verdrahtung an, oder verwenden Sie ADSBReceiver adsb; für dieses Board.

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 und setzen Sie das Board zurück. Wenn der Empfänger an den Pins angeschlossen ist, die Sie dem Konstruktor übergeben haben, und sich ein Flugzeug in Reichweite befindet, gibt der Sketch für jede dekodierte Flugzeugaktualisierung eine Zeile aus: ICAO, gefolgt von der 24-Bit-Adresse des Flugzeugs in Hex. Die Adressen hängen davon ab, welche Flugzeuge in Reichweite sind.

Verwendete Funktionen​

ADSBReceiver(uint8_t uartNum, int8_t rxPin, int8_t txPin, int8_t resetPin)returns None

Erstellt das Empfängerobjekt und legt fest, welchen UART und welche Pins es verwendet. Alle Parameter sind optional; die Standardwerte entsprechen der Verdrahtung dieses Boards. Die Bibliothek lässt sich nur für die ESP32-Familie bauen, da sie einen der Hardware-UARTs des Chips direkt ansteuert.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendender ESP32-Hardware-UART. Optional, Standardwert 1. Vermeiden Sie 0, der 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; dadurch wird auch hardwareReset() deaktiviert.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Öffnet die UART-Verbindung an den Pins, die dem Konstruktor übergeben wurden. Rufen Sie sie einmal in setup() auf.

ReturnsNichts.

Parameter

TypNameBeschreibung
uint32_tinitialBaudBaudrate, mit der gestartet wird. Optional, Standardwert 115200.
size_trxBufferSizeGröße des UART-Empfangspuffers in Byte. Optional, Standardwert 4096.
onAircraft(AircraftCallback cb)returns void

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

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const AdsbAircraft &ac)cbDie aufzurufende Funktion. ac.icao ist die ICAO-Adresse des Flugzeugs als Hex-String. Felder, zu denen der Empfänger keine Daten hatte, behalten ihre Standardwerte, wobei das zugehörige has...-Flag false bleibt.
poll()returns void

Liest alle eingetroffenen Bytes, parst die vollständigen Zeilen und löst die registrierten Callbacks aus. Sie blockiert nicht, rufen Sie sie daher bei jedem Durchlauf von loop() auf.

ReturnsNichts.

Zusammenfassung​

Nur die Konstruktorzeile ändert sich, wenn Ihre Verdrahtung abweicht. Alles danach, begin(), onAircraft() und poll(), funktioniert genauso wie auf diesem Board. Der Empfänger muss weiterhin für die CSV-Ausgabe eingerichtet sein; das ist laut dem Datenblatt des Empfängers für die Empfänger-Firmware v2.89.28 seine Standardeinstellung. Die Firmware auf Ihrem Empfänger wurde nicht dagegen geprüft.