Zum Hauptinhalt springen

Geräteinformationen

Was dieses Beispiel zeigt​

Hier fragen wir den integrierten TT-SC1-Empfänger, wer er ist. Der Sketch versetzt den Empfänger in den Zustand CONFIGURATION, gibt seine Seriennummer, Firmware-Version und seinen Gerätetyp aus, führt einen Verbindungstest durch, gibt alle Einstellungen sowie den eingebauten Hilfetext des Empfängers aus und schaltet den Empfänger anschließend wieder in die normale Flugzeugverfolgung zurück.

Der Beispielcode​

Dies ist 2_DeviceInfo.ino aus der fixierten Bibliothek, ohne den Kopfkommentar der Datei. Der Sketch-Rumpf ist genau so, wie er ausgeliefert wird. Die Standardverdrahtung der Bibliothek (UART1 an IO17 und IO18, Reset an IO21) passt zu diesem Board, daher braucht der Konstruktor keine Argumente.

ESP32S3 Dev Module
2_DeviceInfo.ino
#include "ADSB-Receiver-SOLDERED.h"

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

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

// Print every raw line the module sends, useful to see what is really happening.
adsb.onLine([](const String &line) {
Serial.print("[module] ");
Serial.println(line);
});

// Only in CONFIGURATION state can settings be read or written.
Serial.println("Entering CONFIGURATION state...");
if (!adsb.enterConfiguration())
{
Serial.println("Failed to enter CONFIGURATION state.");
return;
}

String value;

// Read the module's serial number.
if (adsb.getSerialNumber(value))
{
Serial.print("Serial number: ");
Serial.println(value);
}

// Read the currently installed firmware version.
if (adsb.getFirmwareVersion(value))
{
Serial.print("Firmware version: ");
Serial.println(value);
}

// Read the device type string reported by the module.
if (adsb.getDeviceType(value))
{
Serial.print("Device type: ");
Serial.println(value);
}

// Simple connectivity check, the module should always answer AT+OK.
Serial.print("Connection test (AT+TEST): ");
Serial.println(adsb.test() ? "OK" : "FAILED");

// Ask the module to list every setting and its current value.
Serial.println();
Serial.println("--- AT+SETTINGS? ---");
String settings;
if (adsb.getAllSettings(settings))
Serial.println(settings);

// Ask the module for its full built-in help text.
Serial.println();
Serial.println("--- AT+HELP ---");
String help;
if (adsb.getFullHelp(help))
Serial.println(help);

// Leave CONFIGURATION and resume normal aircraft tracking.
Serial.println();
Serial.println("Returning to RUN state...");
adsb.exitConfiguration(115200); // must match the BAUDRATE setting printed above
}

void loop()
{
}

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 ein und setzen Sie das Board zurück. Der Sketch läuft einmal in setup() durch und loop() bleibt leer, sodass die Ausgabe einmal erscheint und dann endet.

Die Zeilen erscheinen in dieser Reihenfolge: Entering CONFIGURATION state..., dann die Zeilen mit Seriennummer, Firmware-Version und Gerätetyp, danach die Zeile des Verbindungstests (OK oder FAILED), der Block --- AT+SETTINGS? ---, der Block --- AT+HELP --- und schließlich Returning to RUN state.... Jede Antwort, die das Modul sendet, während der Sketch mit ihm kommuniziert, wird ebenfalls ausgegeben, beginnend mit [module] , weil onLine() vor dem ersten Befehl registriert wird. Die Antwort des Verbindungstests steht in derselben Zeile wie ihre Beschriftung Connection test (AT+TEST): , weil der Sketch die Beschriftung ausgibt, bevor er den Befehl sendet.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Entering CONFIGURATION state...
[module] AT+OK
[module] AT+CONFIG=1
[module] AT+SERIAL_NUMBER=33-0004127
Serial number: 33-0004127
[module] AT+FIRMWARE_VERSION=2.89.28.0
Firmware version: 2.89.28.0
[module] AT+DEVICE=TT-SC1
Device type: TT-SC1
Connection test (AT+TEST): [module] AT+OK
OK

--- AT+SETTINGS? ---
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV

--- AT+HELP ---
[module] SETTINGS:
[module] SYSTEM:
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] ADSB:
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
[module] COMMANDS:
[module] AT+HELP
[module] AT+REBOOT
[module] AT+REBOOT_BOOTLOADER
[module] AT+SETTINGS_DEFAULT
[module] AT+TEST
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV
AT+HELP
AT+REBOOT
AT+REBOOT_BOOTLOADER
AT+SETTINGS_DEFAULT
AT+TEST

Returning to RUN state...
[module] AT+OK
[module] AT+CONFIG=0

Verwendete Funktionen​

ADSBReceiver()returns None

Erstellt 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 wie dieses Board verdrahtet ist.

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. 0 vermeiden, das meist die USB-Konsole ist.
int8_trxPinGPIO des ESP32, der mit dem TX-Pin des Moduls verbunden ist. Optional, Standardwert 17.
int8_ttxPinGPIO des ESP32, der mit dem RX-Pin des Moduls verbunden ist. Optional, Standardwert 18.
int8_tresetPinGPIO des ESP32, der mit dem RESET-Pin des Moduls verbunden ist. Optional, Standardwert 21. -1 übergeben, 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. Sie schaltet außerdem den RESET-Pin als hochohmigen Eingang, sodass der Pin nur während hardwareReset() angesteuert wird.

ReturnsNichts.

Parameter

TypNameBeschreibung
uint32_tinitialBaudBaudrate, mit der begonnen wird. Optional, Standardwert 115200. 115200 verwenden, es sei denn, die Einstellung BAUDRATE des Moduls wurde zuvor geändert.
size_trxBufferSizeGröße des UART-Empfangspuffers in Bytes. Optional, Standardwert 4096, größer als die 256 Bytes des ESP32-Cores, damit bei viel Datenverkehr nichts abgeschnitten wird.
onLine(LineCallback cb)returns void

Registriert eine Funktion, die für jede vollständige vom Empfänger gesendete Zeile aufgerufen wird, bevor die Zeile geparst wird, einschließlich der AT-Antworten auf die von Ihnen gesendeten Befehle. Das Beispiel nutzt sie, um jede Zeile mit dem Präfix [module] auszugeben.

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const String &line)cbDie aufzurufende Funktion; sie erhält die Zeile ohne Zeilenende. Eine Lambda-Funktion ohne Captures, wie im Beispiel, funktioniert.
enterConfiguration()returns bool

Versetzt den Empfänger vom Zustand RUN in den Zustand CONFIGURATION. Sie sendet AT+CONFIG=1, stellt den lokalen UART auf 115200 um (die feste Baudrate des Empfängers im Zustand CONFIGURATION) und bestätigt den neuen Zustand anschließend mit AT+CONFIG?. Einstellungen lassen sich nur in diesem Zustand lesen und schreiben.

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

getSerialNumber(String &out)returns bool

Liest die Seriennummer des Empfängers mit AT+SERIAL_NUMBER? aus.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
String &outErhält die Seriennummer.
getFirmwareVersion(String &out)returns bool

Liest die Firmware-Version des Empfängers mit AT+FIRMWARE_VERSION? aus.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
String &outErhält die Firmware-Version.
getDeviceType(String &out)returns bool

Liest den vom Empfänger gemeldeten Gerätetyp-String mit AT+DEVICE? aus.

Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.

Parameter

TypNameBeschreibung
String &outErhält den Gerätetyp.
test()returns bool

Sendet AT+TEST, eine einfache Verbindungsprüfung. Ein funktionierender Empfänger antwortet mit AT+OK.

Returnstrue, wenn die Antwort AT+OK enthält, andernfalls false.

getAllSettings(String &out)returns bool

Fragt beim Empfänger mit AT+SETTINGS? alle Einstellungen und ihren aktuellen Wert ab. Die Antwort besteht aus mehreren Zeilen, daher liest die Funktion weiter, bis der Empfänger 150 ms lang still war, höchstens jedoch 1500 ms.

Returnstrue, wenn mindestens eine Zeile zurückkam, andernfalls false.

Parameter

TypNameBeschreibung
String &outErhält die Antwortzeilen, durch Zeilenumbrüche verbunden.
getFullHelp(String &out)returns bool

Fragt beim Empfänger mit AT+HELP nach seinem eingebauten Hilfetext. Die mehrzeilige Antwort wird auf dieselbe Weise gelesen wie bei getAllSettings().

Returnstrue, wenn mindestens eine Zeile zurückkam, andernfalls false.

Parameter

TypNameBeschreibung
String &outErhält den Hilfetext, durch Zeilenumbrüche verbunden.
exitConfiguration(uint32_t runBaud)returns bool

Versetzt den Empfänger vom Zustand CONFIGURATION zurück in den Zustand RUN. Sie sendet AT+CONFIG=0, stellt 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 Zustand RUN befindet, andernfalls false.

Parameter

TypNameBeschreibung
uint32_trunBaudBaudrate für den Zustand RUN. Optional, Standardwert 115200. Sie muss mit der gespeicherten Einstellung BAUDRATE des Empfängers übereinstimmen, weshalb der Kommentar im Beispiel auf die Ausgabe der Einstellungen verweist.

Zusammenfassung​

Der Empfänger muss sich für die Getter und die Einstellungsaufrufe im Zustand CONFIGURATION befinden, daher kommt zuerst enterConfiguration() und exitConfiguration() beendet ihn. Jeder Getter füllt den übergebenen String und gibt true zurück, wenn der Empfänger geantwortet hat, sodass das Beispiel nur für erhaltene Antworten eine Zeile ausgibt.

Der Sketch ruft poll() nie auf und dekodiert daher keine Flugzeugmeldungen. Er ist eine einmalige Funktionsprüfung, kein Tracker. Für die Ausgabe von Flugzeugdaten verwenden Sie den Sketch Flugzeugmeldungen lesen.