Zum Hauptinhalt springen

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.

ShellMicroPython
[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 ADSBReceiver

Erstellt 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

TypNameBeschreibung
machine.UARTuartEin 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 Nonereset_pinGPIO, der mit dem RESET-Pin des Empfängers verbunden ist. Optional, Standardwert None, wodurch hardwareReset() deaktiviert wird. Dieses Board verwendet 21.
onSystemStats(cb)returns None

Registriert die Funktion, die für jede Systemstatistik-Meldung aufgerufen wird (die #S:-Zeile des Empfängers).

ReturnsNichts.

Parameter

TypNameBeschreibung
function oder NonecbDie 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 None

Registriert die Funktion, die für jede ADS-B-Statistik-Meldung aufgerufen wird (die #AS:-Zeile des Empfängers).

ReturnsNichts.

Parameter

TypNameBeschreibung
function oder NonecbDie 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 bool

Versetzt 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 bool

Schaltet 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

TypNameBeschreibung
intprotocolSTATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1).
setAdsbStatisticsProtocol(protocol)returns bool

Schaltet 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

TypNameBeschreibung
intprotocolSTATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1).
exitConfiguration(run_baud=115200)returns bool

Versetzt 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

TypNameBeschreibung
intrun_baudDie Baudrate, als die die Einstellung BAUDRATE des Empfängers gespeichert ist, zum Beispiel 115200. Optional, Standardwert 115200.
poll()returns None

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