Skip to main content

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.

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

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 ADSBReceiver

Stvara 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

TipNazivOpis
machine.UARTuartOtvoreni 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 Nonereset_pinGPIO spojen na pin RESET prijemnika. Neobavezno, zadano None, što isključuje hardwareReset(). Ova pločica koristi 21.
onLine(cb)returns None

Registrira 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

TipNazivOpis
function or NonecbFunkcija koja se poziva, a kao argument dobiva redak kao string. None je uklanja.
enterConfiguration()returns bool

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

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

Vrać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

TipNazivOpis
intrun_baudBrzina 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.