Zum Hauptinhalt springen

Protokolle und Einstellungen konfigurieren

Was dieses Beispiel zeigt​

Die Einstellungen des Empfängers werden aus einem Sketch geschrieben: das dekodierte Ausgabeprotokoll (CSV oder MAVLink), wie oft Flugzeugmeldungen gesendet werden, die beiden Statistikprotokolle, das eigene Systemprotokoll des Empfängers und seine Baudrate im RUN-Zustand. Jeder Schreibvorgang gibt aus, ob der Empfänger ihn akzeptiert hat.

Der Beispielcode​

Dies ist 3_ConfigureProtocolsAndSettings.ino aus der fest eingebundenen Bibliothek, ohne den Kopfkommentar der Datei. Der Sketch-Körper ist genau so, wie er ausgeliefert wird. Er wählt CSV-Ausgabe, ändern Sie daher jeweils nur einen Wert, um zu sehen, was die einzelne Einstellung bewirkt.

ESP32S3 Dev Module
3_ConfigureProtocolsAndSettings.ino
#include "ADSB-Receiver-SOLDERED.h"

// Create an instance of the ADS-B object
ADSBReceiver adsb;

// Small helper to print whether a setting write succeeded.
void printResult(const char *what, bool ok)
{
Serial.print(what);
Serial.println(ok ? " -> AT+OK" : " -> FAILED");
}

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

// Settings can only be written while in CONFIGURATION state.
if (!adsb.enterConfiguration())
{
Serial.println("Failed to enter CONFIGURATION state.");
return;
}

// --- ADS-B decoded output protocol ---
printResult("ADSB_RX_PROTOCOL_DECODED=CSV", adsb.setAdsbRxProtocolDecoded(DecodedProtocol::CSV));

// Reporting cadence for decoded aircraft: update ASAP after any position update.
printResult("ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE",
adsb.setAdsbRxProtocolInc(IncMode::IMMEDIATE_ON_POSITION_UPDATE));

// Per-aircraft ADS-B statistics (frames/s, PPS calibration), see example 4.
printResult("ADSB_STATISTICS=CSV", adsb.setAdsbStatisticsProtocol(StatsProtocol::CSV));

// --- SYSTEM settings ---
printResult("SYSTEM_LOG=0", adsb.setSystemLog(false));
printResult("SYSTEM_STATISTICS=CSV", adsb.setSystemStatisticsProtocol(StatsProtocol::CSV));

// Changing BAUDRATE takes effect on the *next* RUN state entry: exitConfiguration()
// below must be told the new value so the local UART follows the module.
printResult("BAUDRATE=BPS_115200", adsb.setBaudrate(Baudrate::BPS_115200));

Serial.println("Returning to RUN state...");
adsb.exitConfiguration(115200);
}

void loop()
{
}

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 ein und setzen Sie das Board zurück. Wenn der Empfänger jeden Schreibvorgang akzeptiert, gibt der Sketch Folgendes aus:

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
ADSB_RX_PROTOCOL_DECODED=CSV -> AT+OK
ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE -> AT+OK
ADSB_STATISTICS=CSV -> AT+OK
SYSTEM_LOG=0 -> AT+OK
SYSTEM_STATISTICS=CSV -> AT+OK
BAUDRATE=BPS_115200 -> AT+OK
Returning to RUN state...

Ein Schreibvorgang, den der Empfänger ablehnt, gibt anstelle von AT+OK die Meldung FAILED aus. Wenn der Empfänger nicht in den CONFIGURATION-Zustand wechselt, gibt der Sketch Failed to enter CONFIGURATION state. aus und stoppt. Der Sketch läuft einmal durch und loop() bleibt leer.

Verwendete Funktionen​

ADSBReceiver()returns None

Erzeugt das Empfängerobjekt. Ohne Argumente verwendet es die Board-Standardwerte der Bibliothek: Hardware-UART 1, IO17 für die TX-Leitung des Empfängers, IO18 für dessen RX-Leitung und IO21 für dessen RESET-Leitung, so ist dieses Board verdrahtet.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendender ESP32-Hardware-UART. Optional, Standardwert 1. Vermeiden Sie 0, das 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.
begin(uint32_t initialBaud, size_t rxBufferSize)returns void

Öffnet die UART-Verbindung zum Empfänger. Rufen Sie sie einmal in setup() auf.

ReturnsNichts.

Parameter

TypNameBeschreibung
uint32_tinitialBaudBaudrate, mit der begonnen wird. Optional, Standardwert 115200. Verwenden Sie 115200, sofern die BAUDRATE-Einstellung des Moduls nicht zuvor geändert wurde.
size_trxBufferSizeGröße des UART-Empfangspuffers in Byte. Optional, Standardwert 4096.
enterConfiguration()returns bool

Versetzt den Empfänger vom RUN- in den CONFIGURATION-Zustand. Sie sendet AT+CONFIG=1, schaltet den lokalen UART auf 115200 um 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 CONFIGURATION-Zustand befindet, andernfalls false.

setAdsbRxProtocolDecoded(DecodedProtocol p)returns bool

Legt das Format der dekodierten Flugzeugdaten fest, die der Empfänger sendet. Der Empfänger erhält diese Einstellung als Namen, daher sendet die Bibliothek CSV, Mavlink oder None.

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
DecodedProtocolpDecodedProtocol::NONE, DecodedProtocol::CSV oder DecodedProtocol::MAVLINK.
setAdsbRxProtocolInc(IncMode m)returns bool

Legt fest, wie oft Flugzeugmeldungen gesendet werden (die Einstellung ADSB_RX_PROTOCOL_INC).

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
IncModemIncMode::ALWAYS_ONCE_PER_SECOND (0), IncMode::ONCE_PER_SECOND_IF_UPDATED (1) oder IncMode::IMMEDIATE_ON_POSITION_UPDATE (2).
setAdsbStatisticsProtocol(StatsProtocol p)returns bool

Schaltet die ADS-B-Statistikmeldung pro Flugzeug ein oder aus (die Einstellung ADSB_STATISTICS). Der Empfänger erhält diese Einstellung als Namen, daher sendet die Bibliothek CSV oder None.

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
StatsProtocolpStatsProtocol::NONE oder StatsProtocol::CSV.
setSystemLog(bool enable)returns bool

Schaltet das eigene Systemprotokoll des Empfängers ein oder aus (die Einstellung SYSTEM_LOG, geschrieben als 1 oder 0).

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
boolenabletrue, um das Protokoll zu aktivieren, false, um es zu deaktivieren.
setSystemStatisticsProtocol(StatsProtocol p)returns bool

Schaltet die Systemstatistikmeldung (CPU-Auslastung und Betriebszeit des Empfängers) ein oder aus (die Einstellung SYSTEM_STATISTICS, geschrieben als Zahl).

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
StatsProtocolpStatsProtocol::NONE (0) oder StatsProtocol::CSV (1).
setBaudrate(Baudrate b)returns bool

Legt die Baudrate des Empfängers für den RUN-Zustand fest (die Einstellung BAUDRATE). Sie wird wirksam, sobald der Empfänger das nächste Mal in den RUN-Zustand wechselt, übergeben Sie daher denselben Wert an exitConfiguration().

Returnstrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
BaudratebBaudrate::BPS_115200 (0), Baudrate::BPS_921600 (1), Baudrate::BPS_3000000 (2) oder Baudrate::BPS_57600 (3).
exitConfiguration(uint32_t runBaud)returns bool

Versetzt den Empfänger aus dem CONFIGURATION- zurück in den RUN-Zustand. Sie sendet AT+CONFIG=0, schaltet den lokalen UART auf runBaud um und bestätigt den neuen Zustand mit AT+CONFIG?.

Returnstrue, wenn der Empfänger meldet, dass er sich im RUN-Zustand befindet, andernfalls false.

Parameter

TypNameBeschreibung
uint32_trunBaudBaudrate für den RUN-Zustand. Optional, Standardwert 115200. Sie muss mit der gespeicherten BAUDRATE-Einstellung des Empfängers übereinstimmen.

Zusammenspiel​

Jeder Schreibvorgang steht zwischen enterConfiguration() und exitConfiguration(). Die typisierten Funktionen übernehmen die Aufzählungstypen der Bibliothek, sodass Sie den rohen Einstellungstext nie selbst schreiben. Das Beispiel ändert nur die Werte, die es nennt, und BPS_115200 ist die werkseitige Standard-Baudrate im RUN-Zustand, die überall sonst in dieser Dokumentation verwendet wird.

Wenn Sie eine andere Baudrate schreiben, übergeben Sie dieselbe Rate an exitConfiguration() und an begin() in jedem Sketch, der danach mit dem Empfänger kommuniziert. Eine Abweichung führt dazu, dass Ihr Sketch und der Empfänger mit unterschiedlicher Geschwindigkeit arbeiten, und es treffen keine Flugzeugdaten ein.