Informacije o uređaju
Što prikazuje ovaj primjer
Pitamo prijemnik tko je: njegov serijski broj, verziju firmwarea i vrstu uređaja, test veze, cijeli popis njegovih postavki s trenutačnim vrijednostima i ugrađeni tekst pomoći. Skripta ispisuje i svaki sirovi redak koji prijemnik pošalje, pa možete vidjeti razmjenu dok se odvija, a zatim vraća prijemnik u stanje RUN.
Primjer koda
Ovo je Examples/ADSBReceiver-deviceInfo.py iz fiksiranog modula, bez zaglavnog komentara datoteke. Tijelo skripte jednako je kao u izvornoj isporuci. Ožičenje UART1 na IO17 i IO18 te reset na IO21 vlastito su ožičenje pločice.
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
Spremite ga u datoteku na računalu, a zatim ga pokrenite na pločici naredbom
mpremote run <file.py>, pri čemu umjesto <file.py> upišite naziv svoje datoteke. Potrebno je
da je modul instaliran kako je prikazano na stranici
MicroPython biblioteka.
Očekivani rezultat
Skripta se izvrši jednom i završi. Ispisuje Entering CONFIGURATION state...,
zatim retke Serial number:, Firmware version: i Device type:, redak
Connection test (AT+TEST):, popis postavki pod --- AT+SETTINGS? ---, tekst pomoći pod --- AT+HELP --- i na kraju Returning to RUN state.... Svaki redak odgovora prijemnika ispisuje se i s prefiksom [module]
zbog funkcije onLine(). Vrijednosti dolaze od samog prijemnika.
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
Ako prijemnik ne uđe u stanje CONFIGURATION, skripta ispisuje Failed to enter CONFIGURATION state. i zaustavlja se.
Korištene funkcije
ADSBReceiver(uart, reset_pin=None)returns ADSBReceiverStvara objekt prijemnika na UART-u koji ste već otvorili. Ako zadate reset pin, modul ga postavlja kao ulaz visoke impedancije, pa se pin pokreće samo tijekom hardwareReset().
ReturnsObjekt prijemnika spreman za ostale funkcije.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
machine.UART | uart | Otvoreni UART povezan s prijemnikom. Veličinu njegova prijamnog međuspremnika odredite pri stvaranju, kao što primjer čini s rxbuf=4096: gust promet može preplaviti zadani međuspremnik i oštetiti retke. |
int or None | reset_pin | GPIO spojen na pin RESET prijemnika. Neobavezno, zadano None, što isključuje hardwareReset(). Ova pločica koristi 21. |
onLine(cb)returns NoneRegistrira funkciju koja se poziva za svaki potpuno primljeni redak, prije nego što se redak obradi. Korisna je za uvid u to što se točno nalazi na liniji tijekom otklanjanja pogrešaka. Do nje stižu i odgovori na AT naredbe.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
function or None | cb | Funkcija koja se poziva, a kao argument dobiva redak kao string. None je uklanja. |
enterConfiguration()returns boolPrebacuje prijemnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje UART na 115200 (fiksna brzina prijemnika u stanju CONFIGURATION) i potvrđuje novo stanje naredbom AT+CONFIG?. Postavke se mogu čitati i pisati samo u tom stanju.
ReturnsTrue ako prijemnik javi da je u stanju CONFIGURATION, inače False.
getSerialNumber()returns tuple(bool, str)Traži od prijemnika njegov serijski broj (AT+SERIAL_NUMBER?).
Returns(True, serijski broj) u slučaju uspjeha, inače (False, prazan string).
getFirmwareVersion()returns tuple(bool, str)Traži od prijemnika verziju instaliranog firmwarea (AT+FIRMWARE_VERSION?).
Returns(True, verzija firmwarea) u slučaju uspjeha, inače (False, prazan string).
getDeviceType()returns tuple(bool, str)Traži od prijemnika string s vrstom uređaja (AT+DEVICE?).
Returns(True, vrsta uređaja) u slučaju uspjeha, inače (False, prazan string).
test()returns boolProvjera veze. Šalje AT+TEST i očekuje da prijemnik odgovori s AT+OK.
ReturnsTrue ako je prijemnik odgovorio s AT+OK, inače False.
getAllSettings()returns tuple(bool, str)Traži od prijemnika popis svih postavki s trenutačnim vrijednostima (AT+SETTINGS?). Odgovor ima više redaka, a funkcija ih prikuplja dok prijemnik nekoliko trenutaka ne utihne.
Returns(True, popis kao jedan string) ako je stigao ijedan redak, inače False.
getFullHelp()returns tuple(bool, str)Traži od prijemnika njegov cijeli ugrađeni tekst pomoći (AT+HELP), prikupljen na isti način kao popis postavki.
Returns(True, tekst pomoći kao jedan string) ako je stigao ijedan redak, inače False.
exitConfiguration(run_baud=115200)returns boolVraća prijemnik iz stanja CONFIGURATION u stanje RUN. Šalje AT+CONFIG=0, prebacuje UART na run_baud i potvrđuje novo stanje naredbom AT+CONFIG?.
ReturnsTrue ako prijemnik javi da je u stanju RUN, inače False.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | run_baud | Brzina prijenosa (baud rate) pod kojom je spremljena postavka BAUDRATE prijemnika, na primjer 115200. Neobavezno, zadano 115200. |
Sastavljanje cjeline
Prvo uđite u stanje CONFIGURATION: upiti o identitetu i postavkama rade samo
u njemu. Svaki upit vraća par, pa provjerite prvu vrijednost prije nego što upotrijebite
drugu. Komentar u zadnjem retku primjera kaže da brzina koju predate funkciji
exitConfiguration() mora odgovarati postavci BAUDRATE u popisu koji je
skripta ispisala.