Zum Hauptinhalt springen

Statistics

Was dieses Beispiel zeigt​

Es liest die beiden Zustandsmeldungen des Empfängers aus: die Systemstatistik (CPU-Last und Betriebszeit) und die ADS-B-Statistik (pro Sekunde empfangene Frames und die Kalibrierung, gemessen am Pulse-per-Second-Signal). Der Empfänger auf diesem Board läuft mit der Firmware 2.89.28.0, der Version, für die sein Datenblatt geschrieben ist. Er meldet die Systemstatistik als ausgeschaltet (AT+SYSTEM_STATISTICS=0) und die ADS-B-Statistik als CSV (AT+ADSB_STATISTICS=CSV), so wie es das Datenblatt angibt. Der Kommentar im Sketch besagt, beide seien anfangs deaktiviert, was nicht dem entspricht, was dieses Board meldet. Der Sketch schaltet beide ein, sodass er in beiden Fällen funktioniert.

Zwei der ADS-B-Werte brauchen auf diesem Board eine Erläuterung. Der hier verbaute Empfänger ist die Basisversion SC1, die nur ADS-B dekodiert: Die Mode-A/C-Dekodierung gehört zur Version SC1-EXT. Die Statistikmeldung des Empfängers enthält immer ein Feld für Mode-A/C-Frames pro Sekunde, daher gibt der Sketch eines aus, doch die Version SC1 dekodiert kein Mode-A/C: Verstehen Sie diesen Wert nicht als Mode-A/C-Verkehr. Der Kalibrierwert ist die tatsächliche Mikrocontroller-Frequenz des Empfängers, gemessen am Pulse-per-Second-Signal eines GNSS-Moduls. Da das Board kein GNSS-Modul hat, braucht der Wert eine externe PPS-Quelle, um aussagekräftig zu sein.

Der Beispielcode​

Dies ist 4_Statistics.ino aus der fest eingebundenen Bibliothek, ohne den Header-Kommentar der Datei. Der Sketch-Körper ist genau so, wie er ausgeliefert wird.

ESP32S3 Dev Module
4_Statistics.ino
#include "ADSB-Receiver-SOLDERED.h"

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

// Called once per second with the module's own CPU load and uptime.
void onSystemStats(const SystemStats &s)
{
Serial.print("[SYSTEM] CPU load=");
Serial.print(s.cpuLoad);
Serial.print("% uptime=");
Serial.print(s.uptime);
Serial.print("s crcValid=");
Serial.println(s.crcValid ? "yes" : "no");
}

// Called once per second with the ADS-B receiver frame counts and PPS calibration.
void onAdsbStats(const AdsbStats &s)
{
Serial.print("[ADS-B] Mode-S fps=");
Serial.print(s.fpss);
Serial.print(" Mode-A/C fps=");
Serial.print(s.fpsac);
Serial.print(" PPS calib=");
Serial.print(s.calib);
Serial.print(" crcValid=");
Serial.println(s.crcValid ? "yes" : "no");
}

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

// Register the callbacks that will receive the stats messages.
adsb.onSystemStats(onSystemStats);
adsb.onAdsbStats(onAdsbStats);

// Both statistics protocols default to disabled, so turn them on here.
if (adsb.enterConfiguration())
{
adsb.setSystemStatisticsProtocol(StatsProtocol::CSV);
adsb.setAdsbStatisticsProtocol(StatsProtocol::CSV);
adsb.exitConfiguration(115200);
}
else
{
Serial.println("Failed to enter CONFIGURATION state.");
}
}

void loop()
{
adsb.poll();
}

Erwartetes Ergebnis​

Öffnen Sie Tools → Serial Monitor, stellen Sie die Baudrate auf 115200 und setzen Sie das Board zurück. Einmal pro Sekunde gibt der Sketch eine [SYSTEM]-Zeile und eine [ADS-B]-Zeile aus. Eine [SYSTEM]-Zeile zeigt die CPU-Last des Empfängers in Prozent, seine Betriebszeit in Sekunden und ob die Prüfsumme der Meldung gültig war. Eine [ADS-B]-Zeile zeigt die pro Sekunde empfangenen Mode-S-Frames und das Prüfsummenergebnis, daneben die oben beschriebenen Felder für Mode-A/C und die PPS-Kalibrierung.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
[SYSTEM] CPU load=21.30% uptime=1s crcValid=yes
[ADS-B] Mode-S fps=23 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=18.70% uptime=2s crcValid=yes
[ADS-B] Mode-S fps=19 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=19.40% uptime=3s crcValid=yes
[ADS-B] Mode-S fps=27 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=22.10% uptime=4s crcValid=yes
[ADS-B] Mode-S fps=31 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=18.20% uptime=5s crcValid=yes
[ADS-B] Mode-S fps=22 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=20.60% uptime=6s crcValid=yes
[ADS-B] Mode-S fps=26 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes
[SYSTEM] CPU load=19.10% uptime=7s crcValid=yes
[ADS-B] Mode-S fps=24 Mode-A/C fps=0 PPS calib=0.00 crcValid=yes

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

ReturnsKonstruktor; kein Rückgabewert.

Parameter

TypNameBeschreibung
uint8_tuartNumZu verwendende Hardware-UART des ESP32. Optional, Standardwert 1. Vermeiden Sie 0, 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. Ü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.
onSystemStats(SystemStatsCallback cb)returns void

Registriert die Funktion, die bei jeder Systemstatistikmeldung aufgerufen wird (die #S:-Zeile des Empfängers).

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const SystemStats &s)cbDie aufzurufende Funktion. s.cpuLoad ist die CPU-Last in Prozent, s.uptime ist die Betriebszeit (das Beispiel gibt sie in Sekunden aus), und s.crcValid zeigt an, ob die Prüfsumme übereinstimmte.
onAdsbStats(AdsbStatsCallback cb)returns void

Registriert die Funktion, die bei jeder ADS-B-Statistikmeldung aufgerufen wird (die #AS:-Zeile des Empfängers).

ReturnsNichts.

Parameter

TypNameBeschreibung
void (*)(const AdsbStats &s)cbDie aufzurufende Funktion. s.fpss ist die Anzahl der pro Sekunde empfangenen Mode-S-Frames, s.fpsac die Mode-A/C-Frames pro Sekunde (die Version SC1 auf diesem Board dekodiert kein Mode-A/C), s.calib die tatsächliche Mikrocontroller-Frequenz, gemessen an einem GNSS-Pulse-per-Second-Signal (das Board hat kein GNSS-Modul), und s.crcValid, ob die Prüfsumme übereinstimmte.
enterConfiguration()returns bool

Versetzt den Empfänger vom RUN- in den CONFIGURATION-Zustand. Sie sendet AT+CONFIG=1, schaltet die lokale 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.

setSystemStatisticsProtocol(StatsProtocol p)returns bool

Schaltet die Systemstatistikmeldung ein oder aus (die Einstellung SYSTEM_STATISTICS). Laut Datenblatt des Empfängers für die Firmware v2.89.28 ist sie standardmäßig aus.

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

Parameter

TypNameBeschreibung
StatsProtocolpStatsProtocol::NONE oder StatsProtocol::CSV.
setAdsbStatisticsProtocol(StatsProtocol p)returns bool

Schaltet die ADS-B-Statistikmeldung ein oder aus (die Einstellung ADSB_STATISTICS). Laut Datenblatt des Empfängers ist CSV der Standardwert, und der Empfänger auf diesem Board meldet CSV; der Kommentar der Bibliothek besagt, sie sei anfangs deaktiviert.

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

Parameter

TypNameBeschreibung
StatsProtocolpStatsProtocol::NONE oder StatsProtocol::CSV.
exitConfiguration(uint32_t runBaud)returns bool

Versetzt den Empfänger vom CONFIGURATION- zurück in den RUN-Zustand. Sie sendet AT+CONFIG=0, schaltet die lokale 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.
poll()returns void

Liest alle eingegangenen 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.

Alles zusammengefügt​

Registrieren Sie die Callbacks, schalten Sie beide Statistikmeldungen ein, solange sich der Empfänger im CONFIGURATION-Zustand befindet, kehren Sie in den RUN-Zustand zurück und rufen Sie weiter poll() auf. Jede Meldung erreicht dann ihren Callback, laut den Kommentaren des Beispiels etwa einmal pro Sekunde.