Zum Hauptinhalt springen

Geräteinformationen

Was dieses Beispiel zeigt​

Hier fragen Sie den Empfänger, wer er ist: seine Seriennummer, die Firmware-Version und den Gerätetyp, dazu ein Verbindungstest, die vollständige Liste seiner Einstellungen mit ihren aktuellen Werten und sein eingebauter Hilfetext. Das Skript gibt außerdem jede Rohzeile aus, die der Empfänger sendet, sodass Sie den Austausch live verfolgen können, und versetzt den Empfänger anschließend wieder in den RUN-Zustand.

Der Beispielcode​

Dies ist Examples/ADSBReceiver-deviceInfo.py aus dem festgelegten Modul, ohne den Kopfkommentar der Datei. Der Skriptkörper ist genau so, wie er ausgeliefert wird. Die Verdrahtung von UART1 an IO17 und IO18 sowie des Resets an IO21 ist die eigene Verdrahtung des Boards.

from machine import UART
from ADSBReceiver import ADSBReceiver

uart = UART(1, baudrate=115200, rx=17, tx=18, rxbuf=4096)
adsb = ADSBReceiver(uart, reset_pin=21)

# Print every raw line the module sends, useful to see what is really happening.
adsb.onLine(lambda line: print("[module] " + line))

# Only in CONFIGURATION state can settings be read or written.
print("Entering CONFIGURATION state...")
if not adsb.enterConfiguration():
print("Failed to enter CONFIGURATION state.")
else:
# Read the module's serial number.
ok, value = adsb.getSerialNumber()
if ok:
print("Serial number: {}".format(value))

# Read the currently installed firmware version.
ok, value = adsb.getFirmwareVersion()
if ok:
print("Firmware version: {}".format(value))

# Read the device type string reported by the module.
ok, value = adsb.getDeviceType()
if ok:
print("Device type: {}".format(value))

# Simple connectivity check, the module should always answer AT+OK.
print("Connection test (AT+TEST): {}".format("OK" if adsb.test() else "FAILED"))

# Ask the module to list every setting and its current value.
print()
print("--- AT+SETTINGS? ---")
ok, settings = adsb.getAllSettings()
if ok:
print(settings)

# Ask the module for its full built-in help text.
print()
print("--- AT+HELP ---")
ok, help_text = adsb.getFullHelp()
if ok:
print(help_text)

# Leave CONFIGURATION and resume normal aircraft tracking.
print()
print("Returning to RUN state...")
adsb.exitConfiguration(115200) # must match the BAUDRATE setting printed above

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. Dafür muss das Modul installiert sein, wie auf der Seite MicroPython-Bibliothek beschrieben.

Erwartetes Ergebnis​

Das Skript läuft einmal und beendet sich. Es gibt Entering CONFIGURATION state... aus, danach die Zeilen Serial number:, Firmware version: und Device type:, die Zeile Connection test (AT+TEST):, die Einstellungsliste unter --- AT+SETTINGS? ---, den Hilfetext unter --- AT+HELP --- und schließlich Returning to RUN state.... Jede Antwortzeile des Empfängers wird wegen der Funktion onLine() zusätzlich mit dem Präfix [module] ausgegeben. Die Werte stammen vom Empfänger selbst.

ShellMicroPython
Entering CONFIGURATION state...
[module] AT+OK
[module] AT+CONFIG=1
[module] AT+SERIAL_NUMBER=33-0004127
Serial number: 33-0004127
[module] AT+FIRMWARE_VERSION=2.89.28.0
Firmware version: 2.89.28.0
[module] AT+DEVICE=TT-SC1
Device type: TT-SC1
[module] AT+OK
Connection test (AT+TEST): OK

--- AT+SETTINGS? ---
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV

--- AT+HELP ---
[module] SETTINGS:
[module] SYSTEM:
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] ADSB:
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
[module] COMMANDS:
[module] AT+HELP
[module] AT+REBOOT
[module] AT+REBOOT_BOOTLOADER
[module] AT+SETTINGS_DEFAULT
[module] AT+TEST
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV
AT+HELP
AT+REBOOT
AT+REBOOT_BOOTLOADER
AT+SETTINGS_DEFAULT
AT+TEST

Returning to RUN state...
[module] AT+OK
[module] AT+CONFIG=0

Wenn der Empfänger nicht in den CONFIGURATION-Zustand wechselt, gibt das Skript Failed to enter CONFIGURATION state. aus und stoppt.

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 im Beispiel mit rxbuf=4096: Bei hohem Datenaufkommen 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 ist. Dieses Board verwendet 21.
onLine(cb)returns None

Registriert eine Funktion, die für jede vollständig empfangene Zeile aufgerufen wird, bevor die Zeile verarbeitet wird. Das ist praktisch, um beim Debuggen genau zu sehen, was auf der Leitung liegt. Auch Antworten auf AT-Befehle erreichen sie.

ReturnsNichts.

Parameter

TypNameBeschreibung
function oder NonecbDie aufzurufende Funktion, der die Zeile als String übergeben wird. None entfernt sie.
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 lassen sich nur in diesem Zustand lesen und schreiben.

ReturnsTrue, wenn der Empfänger meldet, dass er im CONFIGURATION-Zustand ist, andernfalls False.

getSerialNumber()returns tuple(bool, str)

Fragt den Empfänger nach seiner Seriennummer (AT+SERIAL_NUMBER?).

Returns(True, Seriennummer) bei Erfolg, andernfalls (False, leerer String).

getFirmwareVersion()returns tuple(bool, str)

Fragt den Empfänger nach seiner installierten Firmware-Version (AT+FIRMWARE_VERSION?).

Returns(True, Firmware-Version) bei Erfolg, andernfalls (False, leerer String).

getDeviceType()returns tuple(bool, str)

Fragt den Empfänger nach seinem Gerätetyp-String (AT+DEVICE?).

Returns(True, Gerätetyp) bei Erfolg, andernfalls (False, leerer String).

test()returns bool

Eine Verbindungsprüfung. Sie sendet AT+TEST und erwartet, dass der Empfänger mit AT+OK antwortet.

ReturnsTrue, wenn der Empfänger mit AT+OK geantwortet hat, andernfalls False.

getAllSettings()returns tuple(bool, str)

Fordert den Empfänger auf, jede Einstellung mit ihrem aktuellen Wert aufzulisten (AT+SETTINGS?). Die Antwort besteht aus mehreren Zeilen, und die Funktion sammelt sie, bis der Empfänger einen Moment lang still war.

Returns(True, die Liste als ein String), wenn mindestens eine Zeile eingetroffen ist, andernfalls False.

getFullHelp()returns tuple(bool, str)

Fragt den Empfänger nach seinem vollständigen eingebauten Hilfetext (AT+HELP), der auf dieselbe Weise gesammelt wird wie die Einstellungsliste.

Returns(True, der Hilfetext als ein String), wenn mindestens eine Zeile eingetroffen ist, andernfalls False.

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 im RUN-Zustand ist, andernfalls False.

Parameter

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

Zusammenfügen​

Wechseln Sie zuerst in den CONFIGURATION-Zustand: Die Abfragen von Identität und Einstellungen funktionieren nur dort. Jede Abfrage liefert ein Paar, prüfen Sie daher den ersten Wert, bevor Sie den zweiten verwenden. Der Kommentar in der letzten Zeile des Beispiels besagt, dass die Rate, die Sie an exitConfiguration() übergeben, mit der Einstellung BAUDRATE in der vom Skript ausgegebenen Liste übereinstimmen muss.