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.
#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:
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 NoneErzeugt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendender ESP32-Hardware-UART. Optional, Standardwert 1. Vermeiden Sie 0, das 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. |
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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | initialBaud | Baudrate, mit der begonnen wird. Optional, Standardwert 115200. Verwenden Sie 115200, sofern die BAUDRATE-Einstellung des Moduls nicht zuvor geändert wurde. |
size_t | rxBufferSize | Größe des UART-Empfangspuffers in Byte. Optional, Standardwert 4096. |
enterConfiguration()returns boolVersetzt 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 boolLegt 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
| Typ | Name | Beschreibung |
|---|---|---|
DecodedProtocol | p | DecodedProtocol::NONE, DecodedProtocol::CSV oder DecodedProtocol::MAVLINK. |
setAdsbRxProtocolInc(IncMode m)returns boolLegt 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
| Typ | Name | Beschreibung |
|---|---|---|
IncMode | m | IncMode::ALWAYS_ONCE_PER_SECOND (0), IncMode::ONCE_PER_SECOND_IF_UPDATED (1) oder IncMode::IMMEDIATE_ON_POSITION_UPDATE (2). |
setAdsbStatisticsProtocol(StatsProtocol p)returns boolSchaltet 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
| Typ | Name | Beschreibung |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE oder StatsProtocol::CSV. |
setSystemLog(bool enable)returns boolSchaltet 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
| Typ | Name | Beschreibung |
|---|---|---|
bool | enable | true, um das Protokoll zu aktivieren, false, um es zu deaktivieren. |
setSystemStatisticsProtocol(StatsProtocol p)returns boolSchaltet 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
| Typ | Name | Beschreibung |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE (0) oder StatsProtocol::CSV (1). |
setBaudrate(Baudrate b)returns boolLegt 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
| Typ | Name | Beschreibung |
|---|---|---|
Baudrate | b | Baudrate::BPS_115200 (0), Baudrate::BPS_921600 (1), Baudrate::BPS_3000000 (2) oder Baudrate::BPS_57600 (3). |
exitConfiguration(uint32_t runBaud)returns boolVersetzt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | runBaud | Baudrate 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.