Protokolle und Einstellungen konfigurieren
Was dieses Beispiel zeigt
Schreiben der Einstellungen des Empfängers aus einem Skript: das Protokoll der decodierten Ausgabe (CSV oder MAVLink), wie oft Flugzeugmeldungen gesendet werden, die beiden Statistikprotokolle, das eigene Systemprotokoll des Empfängers und seine Baudrate im RUN-Zustand. Jeder Schreibvorgang gibt aus, ob der Empfänger ihn akzeptiert hat.
Der Beispielcode
Dies ist Examples/ADSBReceiver-configureProtocolsAndSettings.py aus dem fixierten
Modul, ohne den Kopfkommentar der Datei. Der Skriptinhalt entspricht genau der ausgelieferten Fassung. 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,
DECODED_PROTOCOL_CSV,
INC_MODE_IMMEDIATE_ON_POSITION_UPDATE,
STATS_PROTOCOL_CSV,
BAUDRATE_115200,
)
uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)
# Small helper to print whether a setting write succeeded.
def printResult(what, ok):
print("{} -> {}".format(what, "AT+OK" if ok else "FAILED"))
# Settings can only be written while in CONFIGURATION state.
if not adsb.enterConfiguration():
print("Failed to enter CONFIGURATION state.")
else:
# --- ADS-B decoded output protocol ---
printResult("ADSB_RX_PROTOCOL_DECODED=CSV", adsb.setAdsbRxProtocolDecoded(DECODED_PROTOCOL_CSV))
# Reporting cadence for decoded aircraft: update ASAP after any position update.
printResult(
"ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE",
adsb.setAdsbRxProtocolInc(INC_MODE_IMMEDIATE_ON_POSITION_UPDATE),
)
# Per-aircraft ADS-B statistics (frames/s, PPS calibration), see the statistics example.
printResult("ADSB_STATISTICS=CSV", adsb.setAdsbStatisticsProtocol(STATS_PROTOCOL_CSV))
# --- SYSTEM settings ---
printResult("SYSTEM_LOG=0", adsb.setSystemLog(False))
printResult("SYSTEM_STATISTICS=CSV", adsb.setSystemStatisticsProtocol(STATS_PROTOCOL_CSV))
# Changing BAUDRATE takes effect on the *next* RUN state entry: exitConfiguration()
# below must be told the new value so the local UART follows the module.
printResult("BAUDRATE=BPS_115200", adsb.setBaudrate(BAUDRATE_115200))
print("Returning to RUN state...")
adsb.exitConfiguration(115200)
Speichern Sie es in einer Datei auf Ihrem Computer und führen Sie es dann mit
mpremote run <file.py> auf dem Board aus. Setzen Sie dabei den Namen Ihrer Datei anstelle von <file.py> ein. Das
Modul muss installiert sein, wie auf der Seite
MicroPython-Bibliothek beschrieben.
Erwartetes Ergebnis
Wenn der Empfänger jeden Schreibvorgang akzeptiert, gibt das Skript Folgendes aus:
ADSB_RX_PROTOCOL_DECODED=CSV -> AT+OK
ADSB_RX_PROTOCOL_INC=IMMEDIATE_ON_POSITION_UPDATE -> AT+OK
ADSB_STATISTICS=CSV -> AT+OK
SYSTEM_LOG=0 -> AT+OK
SYSTEM_STATISTICS=CSV -> AT+OK
BAUDRATE=BPS_115200 -> AT+OK
Returning to RUN state...
Ein Schreibvorgang, den der Empfänger ablehnt, gibt FAILED anstelle von AT+OK aus. Wenn der Empfänger
nicht in den CONFIGURATION-Zustand wechselt, gibt das Skript Failed to enter CONFIGURATION state. aus und stoppt. Das Skript läuft einmal und beendet sich.
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. Dimensionieren Sie seinen Empfangspuffer beim Erstellen, wie im Beispiel mit rxbuf=4096: 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. |
enterConfiguration()returns boolVersetzt den Empfänger vom RUN- in den CONFIGURATION-Zustand. Sie sendet AT+CONFIG=1, schaltet den UART auf 115200 um (die feste Baudrate des Empfängers im CONFIGURATION-Zustand) 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.
setAdsbRxProtocolDecoded(protocol)returns boolLegt das Format der decodierten Flugzeugdaten fest, die der Empfänger sendet. Der Empfänger erwartet diese Einstellung als Namen, daher sendet das Modul CSV, Mavlink oder None.
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | Eines von DECODED_PROTOCOL_NONE (0), DECODED_PROTOCOL_CSV (1) oder DECODED_PROTOCOL_MAVLINK (2). |
setAdsbRxProtocolInc(mode)returns boolLegt fest, wie oft Flugzeugmeldungen gesendet werden (die Einstellung ADSB_RX_PROTOCOL_INC).
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | mode | Eines von INC_MODE_ALWAYS_ONCE_PER_SECOND (0), INC_MODE_ONCE_PER_SECOND_IF_UPDATED (1) oder INC_MODE_IMMEDIATE_ON_POSITION_UPDATE (2). |
setAdsbStatisticsProtocol(protocol)returns boolSchaltet die ADS-B-Statistikmeldung pro Flugzeug ein oder aus (die Einstellung ADSB_STATISTICS). Der Empfänger erwartet diese Einstellung als Namen, daher sendet das Modul CSV oder None.
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1). |
setSystemLog(enable)returns boolSchaltet das eigene Systemprotokoll des Empfängers ein oder aus (die Einstellung SYSTEM_LOG, geschrieben als 1 oder 0).
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
bool | enable | True, um das Protokoll zu aktivieren, False, um es zu deaktivieren. |
setSystemStatisticsProtocol(protocol)returns boolSchaltet die Systemstatistikmeldung (CPU-Last und Betriebszeit des Empfängers) ein oder aus (die Einstellung SYSTEM_STATISTICS, geschrieben als Zahl).
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1). |
setBaudrate(baudrate)returns boolLegt die Baudrate des Empfängers für den RUN-Zustand fest (die Einstellung BAUDRATE). Sie wird wirksam, sobald der Empfänger das nächste Mal in den RUN-Zustand wechselt. Geben Sie daher dieselbe Rate an exitConfiguration() weiter.
ReturnsTrue bei Erfolg, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | baudrate | Eines von BAUDRATE_115200 (0), BAUDRATE_921600 (1), BAUDRATE_3000000 (2) oder BAUDRATE_57600 (3). Dies sind Einstellungswerte, keine Baudraten. |
exitConfiguration(run_baud=115200)returns boolVersetzt den Empfänger vom CONFIGURATION- zurück in den RUN-Zustand. Sie sendet AT+CONFIG=0, schaltet 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 RUN-Zustand befindet, andernfalls False.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
int | run_baud | Die Baudrate, als die die BAUDRATE-Einstellung des Empfängers gespeichert wird, zum Beispiel 115200. Optional, Standardwert 115200. Hier ist es eine echte Baudrate, anders als bei setBaudrate(). |
Zusammenfassung
Jeder Schreibvorgang steht zwischen enterConfiguration() und exitConfiguration(). Die
Einstellungsfunktionen verwenden die Konstanten des Moduls, sodass Sie den rohen
Einstellungstext nie selbst schreiben müssen.
Wenn Sie eine andere Baudrate schreiben, übergeben Sie die passende echte Baudrate an
exitConfiguration() und erstellen Sie den UART in jedem Skript, das danach
mit dem Empfänger kommuniziert, mit dieser Rate. Ein Unterschied führt dazu, dass Ihr Skript und der
Empfänger mit unterschiedlichen Geschwindigkeiten arbeiten, und es kommen keine Flugzeugdaten an.