Statistik
Was dieses Beispiel zeigt
Es liest die beiden Zustandsmeldungen des Empfängers: die Systemstatistik (CPU-Auslastung 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 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 Skript besagt, dass beide zu Beginn deaktiviert sind. Das entspricht nicht dem, was dieses Board meldet. Das Skript schaltet beide ein, daher funktioniert es in jedem Fall.
Zwei der ADS-B-Werte brauchen auf diesem Board eine Einordnung. Der hier verbaute Empfänger ist die einfache SC1-Version, die nur ADS-B dekodiert: Die Mode-A/C-Dekodierung gehört zur SC1-EXT-Version. Die Statistikmeldung des Empfängers enthält immer ein Feld für Mode-A/C-Frames pro Sekunde, deshalb gibt das Skript einen Wert dafür aus, aber die SC1-Version dekodiert kein Mode-A/C: Lesen 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. Das Board hat kein GNSS-Modul, daher braucht der Wert eine externe PPS-Quelle, um aussagekräftig zu sein.
Der Beispielcode
Dies ist Examples/ADSBReceiver-statistics.py aus dem angegebenen Modul, ohne den Kopfkommentar der Datei. Der Skriptkörper ist genau so, wie er ausgeliefert wird. Die UART1-Verdrahtung an IO17 und IO18 sowie der Reset an IO21 sind die eigene Verdrahtung des Boards.
from machine import UART
from ADSBReceiver import ADSBReceiver, STATS_PROTOCOL_CSV
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Called once per second with the module's own CPU load and uptime.
def onSystemStats(s):
print(
"[SYSTEM] CPU load={}% uptime={}s crcValid={}".format(
s.cpuLoad, s.uptime, "yes" if s.crcValid else "no"
)
)
# Called once per second with the ADS-B receiver frame counts and PPS calibration.
def onAdsbStats(s):
print(
"[ADS-B] Mode-S fps={} Mode-A/C fps={} PPS calib={} crcValid={}".format(
s.fpss, s.fpsac, s.calib, "yes" if s.crcValid else "no"
)
)
# 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(STATS_PROTOCOL_CSV)
adsb.setAdsbStatisticsProtocol(STATS_PROTOCOL_CSV)
adsb.exitConfiguration(115200)
else:
print("Failed to enter CONFIGURATION state.")
while True:
adsb.poll()
Speichern Sie es in einer Datei auf Ihrem Computer und führen Sie es dann mit
mpremote run <file.py> auf dem Board aus, wobei Sie anstelle von <file.py> den Namen Ihrer Datei einsetzen. Das Modul muss installiert sein, wie auf der Seite
MicroPython-Bibliothek beschrieben.
Erwartetes Ergebnis
Einmal pro Sekunde gibt das Skript eine [SYSTEM]-Zeile und eine [ADS-B]-Zeile aus. Eine [SYSTEM]-Zeile zeigt die CPU-Auslastung 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 PPS-Kalibrierung. Wenn der Empfänger nicht in den Zustand CONFIGURATION wechselt, gibt das Skript
Failed to enter CONFIGURATION state. aus und fragt danach weiter ab.
[SYSTEM] CPU load=20.8% uptime=1s crcValid=yes
[ADS-B] Mode-S fps=25 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=19.6% uptime=2s crcValid=yes
[ADS-B] Mode-S fps=21 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=18.4% uptime=3s crcValid=yes
[ADS-B] Mode-S fps=18 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=21.7% uptime=4s crcValid=yes
[ADS-B] Mode-S fps=29 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=20.2% uptime=5s crcValid=yes
[ADS-B] Mode-S fps=26 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=18.9% uptime=6s crcValid=yes
[ADS-B] Mode-S fps=23 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
[SYSTEM] CPU load=19.7% uptime=7s crcValid=yes
[ADS-B] Mode-S fps=20 Mode-A/C fps=0 PPS calib=0.0 crcValid=yes
Verwendete Funktionen
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverErstellt das Empfängerobjekt auf einem UART, den Sie bereits geöffnet haben. Wenn Sie einen Reset-Pin angeben, schaltet das Modul ihn als hochohmigen Eingang, sodass der Pin nur während hardwareReset() angesteuert wird.
ReturnsEin Empfängerobjekt, bereit für die anderen Funktionen.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
machine.UART | uart | Ein geöffneter UART, der mit dem Empfänger verbunden ist. Legen Sie seinen Empfangspuffer beim Erstellen fest, wie es das Beispiel mit rxbuf=4096 tut: Bei dichtem Datenverkehr kann der Standardpuffer überlaufen und Zeilen beschädigen. |
int oder None | reset_pin | GPIO, der mit dem RESET-Pin des Empfängers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird. Dieses Board verwendet 21. |
onSystemStats(cb)returns NoneRegistriert die Funktion, die für jede Systemstatistik-Meldung aufgerufen wird (die #S:-Zeile des Empfängers).
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
function oder None | cb | Die aufzurufende Funktion, der ein SystemStats-Objekt übergeben wird. s.cpuLoad ist die CPU-Auslastung 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(cb)returns NoneRegistriert die Funktion, die für jede ADS-B-Statistik-Meldung aufgerufen wird (die #AS:-Zeile des Empfängers).
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
function oder None | cb | Die aufzurufende Funktion, der ein AdsbStats-Objekt übergeben wird. s.fpss ist die Anzahl der pro Sekunde empfangenen Mode-S-Frames, s.fpsac die Mode-A/C-Frames pro Sekunde (die SC1-Version auf diesem Board dekodiert kein Mode-A/C), s.calib die tatsächliche Mikrocontroller-Frequenz, gemessen am 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 Zustand RUN in den Zustand CONFIGURATION. Sie sendet AT+CONFIG=1, stellt den UART auf 115200 um (die feste Baudrate des Empfängers im Zustand CONFIGURATION) und bestätigt den neuen Zustand mit AT+CONFIG?. Einstellungen lassen sich nur in diesem Zustand schreiben.
ReturnsTrue, wenn der Empfänger meldet, dass er sich im Zustand CONFIGURATION befindet, sonst False.
setSystemStatisticsProtocol(protocol)returns boolSchaltet die Systemstatistik-Meldung (CPU-Auslastung und Betriebszeit des Empfängers) ein oder aus (die Einstellung SYSTEM_STATISTICS, als Zahl geschrieben). Das Datenblatt des Empfängers für die Firmware v2.89.28 gibt sie standardmäßig als ausgeschaltet an.
ReturnsTrue bei Erfolg, sonst False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1). |
setAdsbStatisticsProtocol(protocol)returns boolSchaltet die ADS-B-Statistik-Meldung ein oder aus (die Einstellung ADSB_STATISTICS). Der Empfänger nimmt diese Einstellung als Namen entgegen, daher sendet das Modul CSV oder None. Das Datenblatt des Empfängers gibt CSV als Standardwert an, und der Empfänger auf diesem Board meldet CSV; der Kommentar des Moduls besagt, dass sie zu Beginn deaktiviert ist.
ReturnsTrue bei Erfolg, sonst False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1). |
exitConfiguration(run_baud=115200)returns boolVersetzt den Empfänger vom Zustand CONFIGURATION zurück in den Zustand RUN. Sie sendet AT+CONFIG=0, stellt den UART auf run_baud um und bestätigt den neuen Zustand mit AT+CONFIG?.
ReturnsTrue, wenn der Empfänger meldet, dass er sich im Zustand RUN befindet, sonst False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | run_baud | Die Baudrate, als die die Einstellung BAUDRATE des Empfängers gespeichert ist, zum Beispiel 115200. Optional, Standardwert 115200. |
poll()returns NoneLiest jedes eingegangene Byte, parst die vollständigen Zeilen und ruft die registrierten Funktionen auf. Sie blockiert nicht, rufen Sie sie daher bei jedem Durchlauf Ihrer Schleife auf.
ReturnsNichts.
Alles zusammenfügen
Registrieren Sie die beiden Callbacks, schalten Sie beide Statistikmeldungen ein, während sich der Empfänger
im Zustand CONFIGURATION befindet, wechseln Sie zurück in den Zustand RUN und rufen Sie weiter poll() auf. Jede
Meldung erreicht dann ihren Callback, laut den eigenen Kommentaren des Beispiels etwa einmal pro Sekunde.