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.
#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 NoneErstellt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendender ESP32-Hardware-UART. Optional, Standardwert 1. Vermeiden Sie 0, der 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; 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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | initialBaud | Baudrate, mit der gestartet wird. Optional, Standardwert 115200. |
size_t | rxBufferSize | Größe des UART-Empfangspuffers in Byte. Optional, Standardwert 4096. |
onAircraft(AircraftCallback cb)returns voidRegistriert die Funktion, die für jede dekodierte Flugzeugmeldung aufgerufen wird, die der Empfänger im CSV-Format sendet.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const AdsbAircraft &ac) | cb | Die 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 voidLiest 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.