Zum Hauptinhalt springen

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:

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

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

Legt 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

TypNameBeschreibung
intprotocolEines von DECODED_PROTOCOL_NONE (0), DECODED_PROTOCOL_CSV (1) oder DECODED_PROTOCOL_MAVLINK (2).
setAdsbRxProtocolInc(mode)returns bool

Legt fest, wie oft Flugzeugmeldungen gesendet werden (die Einstellung ADSB_RX_PROTOCOL_INC).

ReturnsTrue bei Erfolg, andernfalls False.

Parameter

TypNameBeschreibung
intmodeEines 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 bool

Schaltet 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

TypNameBeschreibung
intprotocolSTATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1).
setSystemLog(enable)returns bool

Schaltet das eigene Systemprotokoll des Empfängers ein oder aus (die Einstellung SYSTEM_LOG, geschrieben als 1 oder 0).

ReturnsTrue bei Erfolg, andernfalls False.

Parameter

TypNameBeschreibung
boolenableTrue, um das Protokoll zu aktivieren, False, um es zu deaktivieren.
setSystemStatisticsProtocol(protocol)returns bool

Schaltet 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

TypNameBeschreibung
intprotocolSTATS_PROTOCOL_NONE (0) oder STATS_PROTOCOL_CSV (1).
setBaudrate(baudrate)returns bool

Legt 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

TypNameBeschreibung
intbaudrateEines von BAUDRATE_115200 (0), BAUDRATE_921600 (1), BAUDRATE_3000000 (2) oder BAUDRATE_57600 (3). Dies sind Einstellungswerte, keine Baudraten.
exitConfiguration(run_baud=115200)returns bool

Versetzt 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

TypNameBeschreibung
intrun_baudDie 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.