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.
#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.
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 NoneErstellt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendender Hardware-UART des ESP32. Optional, Standardwert 1. 0 vermeiden, das meist die USB-Konsole ist. |
int8_t | rxPin | GPIO des ESP32, der mit dem TX-Pin des Moduls verbunden ist. Optional, Standardwert 17. |
int8_t | txPin | GPIO des ESP32, der mit dem RX-Pin des Moduls verbunden ist. Optional, Standardwert 18. |
int8_t | resetPin | GPIO 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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | initialBaud | Baudrate, mit der begonnen wird. Optional, Standardwert 115200. 115200 verwenden, es sei denn, die Einstellung BAUDRATE des Moduls wurde zuvor geändert. |
size_t | rxBufferSize | Größ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 voidRegistriert 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
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const String &line) | cb | Die aufzurufende Funktion; sie erhält die Zeile ohne Zeilenende. Eine Lambda-Funktion ohne Captures, wie im Beispiel, funktioniert. |
enterConfiguration()returns boolVersetzt 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 boolLiest die Seriennummer des Empfängers mit AT+SERIAL_NUMBER? aus.
Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
String & | out | Erhält die Seriennummer. |
getFirmwareVersion(String &out)returns boolLiest die Firmware-Version des Empfängers mit AT+FIRMWARE_VERSION? aus.
Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
String & | out | Erhält die Firmware-Version. |
getDeviceType(String &out)returns boolLiest den vom Empfänger gemeldeten Gerätetyp-String mit AT+DEVICE? aus.
Returnstrue, wenn der Empfänger geantwortet hat, andernfalls false.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
String & | out | Erhält den Gerätetyp. |
test()returns boolSendet 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 boolFragt 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
| Typ | Name | Beschreibung |
|---|---|---|
String & | out | Erhält die Antwortzeilen, durch Zeilenumbrüche verbunden. |
getFullHelp(String &out)returns boolFragt 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
| Typ | Name | Beschreibung |
|---|---|---|
String & | out | Erhält den Hilfetext, durch Zeilenumbrüche verbunden. |
exitConfiguration(uint32_t runBaud)returns boolVersetzt 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
| Typ | Name | Beschreibung |
|---|---|---|
uint32_t | runBaud | Baudrate 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.