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.
#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.
[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 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 wie dieses Board verdrahtet ist.
ReturnsKonstruktor; kein Rückgabewert.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | uartNum | Zu verwendende Hardware-UART des ESP32. Optional, Standardwert 1. Vermeiden Sie 0, 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. Ü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. |
onSystemStats(SystemStatsCallback cb)returns voidRegistriert die Funktion, die bei jeder Systemstatistikmeldung aufgerufen wird (die #S:-Zeile des Empfängers).
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const SystemStats &s) | cb | Die 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 voidRegistriert die Funktion, die bei jeder ADS-B-Statistikmeldung aufgerufen wird (die #AS:-Zeile des Empfängers).
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
void (*)(const AdsbStats &s) | cb | Die 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 boolVersetzt 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 boolSchaltet 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
| Typ | Name | Beschreibung |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE oder StatsProtocol::CSV. |
setAdsbStatisticsProtocol(StatsProtocol p)returns boolSchaltet 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
| Typ | Name | Beschreibung |
|---|---|---|
StatsProtocol | p | StatsProtocol::NONE oder StatsProtocol::CSV. |
exitConfiguration(uint32_t runBaud)returns boolVersetzt 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
| 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. |
poll()returns voidLiest 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.