Skip to main content

Konfiguriranje protokola i postavki

Što prikazuje ovaj primjer​

Zapisivanje postavki prijemnika iz skripte: izlazni protokol dekodiranih podataka (CSV ili MAVLink), koliko se često šalju izvješća o zrakoplovima, dva statistička protokola, vlastiti sistemski zapisnik prijemnika i njegova brzina prijenosa u stanju RUN. Svaki zapis ispisuje je li ga prijemnik prihvatio.

Primjer koda​

Ovo je Examples/ADSBReceiver-configureProtocolsAndSettings.py iz fiksirane verzije modula, bez uvodnog komentara datoteke. Tijelo skripte je točno onakvo kakvo se isporučuje. 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,
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)

Spremite ga u datoteku na računalu, zatim ga pokrenite na pločici naredbom mpremote run <file.py>, pri čemu umjesto <file.py> upišete naziv svoje datoteke. Potrebno je da je modul instaliran kako je prikazano na stranici MicroPython biblioteka.

Očekivani rezultat​

Kada prijemnik prihvati svaki zapis, skripta ispisuje:

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

Zapis koji prijemnik odbije ispisuje FAILED umjesto AT+OK. Ako prijemnik ne uđe u stanje CONFIGURATION, skripta ispisuje Failed to enter CONFIGURATION state. i zaustavlja se. Skripta se izvrši jednom i završi.

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 spojen na prijemnik. Veličinu njegova prijemnog međuspremnika odredite pri stvaranju, kao što primjer radi s rxbuf=4096: gust promet može preplaviti zadani međuspremnik i oštetiti retke.
int ili Nonereset_pinGPIO spojen na pin RESET prijemnika. Neobavezno, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21.
enterConfiguration()returns bool

Prebacuje prijemnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje UART na 115200 (fiksnu brzinu prijenosa prijemnika u stanju CONFIGURATION) i potvrđuje novo stanje naredbom AT+CONFIG?. Postavke se mogu zapisivati samo u tom stanju.

ReturnsTrue ako prijemnik javi da je u stanju CONFIGURATION, inače False.

setAdsbRxProtocolDecoded(protocol)returns bool

Odabire format dekodiranih podataka o zrakoplovima koje prijemnik šalje. Prijemnik ovu postavku prima kao naziv, pa modul šalje CSV, Mavlink ili None.

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
intprotocolJedna od vrijednosti DECODED_PROTOCOL_NONE (0), DECODED_PROTOCOL_CSV (1) ili DECODED_PROTOCOL_MAVLINK (2).
setAdsbRxProtocolInc(mode)returns bool

Odabire koliko se često šalju izvješća o zrakoplovima (postavka ADSB_RX_PROTOCOL_INC).

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
intmodeJedna od vrijednosti INC_MODE_ALWAYS_ONCE_PER_SECOND (0), INC_MODE_ONCE_PER_SECOND_IF_UPDATED (1) ili INC_MODE_IMMEDIATE_ON_POSITION_UPDATE (2).
setAdsbStatisticsProtocol(protocol)returns bool

Uključuje ili isključuje ADS-B statističku poruku po zrakoplovu (postavka ADSB_STATISTICS). Prijemnik ovu postavku prima kao naziv, pa modul šalje CSV ili None.

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
intprotocolSTATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1).
setSystemLog(enable)returns bool

Uključuje ili isključuje vlastiti sistemski zapisnik prijemnika (postavka SYSTEM_LOG, zapisuje se kao 1 ili 0).

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
boolenableTrue za uključivanje zapisnika, False za njegovo isključivanje.
setSystemStatisticsProtocol(protocol)returns bool

Uključuje ili isključuje poruku sa sistemskom statistikom (opterećenje procesora i vrijeme rada prijemnika) (postavka SYSTEM_STATISTICS, zapisuje se kao broj).

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
intprotocolSTATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1).
setBaudrate(baudrate)returns bool

Postavlja brzinu prijenosa prijemnika za stanje RUN (postavka BAUDRATE). Stupa na snagu sljedeći put kad prijemnik uđe u stanje RUN, zato funkciji exitConfiguration() zadajte istu brzinu.

ReturnsTrue ako je uspjelo, inače False.

Parametri

TipNazivOpis
intbaudrateJedna od vrijednosti BAUDRATE_115200 (0), BAUDRATE_921600 (1), BAUDRATE_3000000 (2) ili BAUDRATE_57600 (3). To su vrijednosti postavke, a ne brzine prijenosa.
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 kao koja se pohranjuje postavka BAUDRATE prijemnika, na primjer 115200. Neobavezno, zadano 115200. Ovdje je to stvarna brzina prijenosa, za razliku od setBaudrate().

Sastavljanje cjeline​

Svaki zapis nalazi se između enterConfiguration() i exitConfiguration(). Funkcije za postavke primaju konstante modula, pa nikada ne morate sami pisati sirovi tekst postavke.

Ako zapišete drukčiju brzinu prijenosa, proslijedite odgovarajuću stvarnu brzinu prijenosa funkciji exitConfiguration() i u svakoj skripti koja nakon toga komunicira s prijemnikom stvorite UART s tom brzinom. Nepodudaranje ostavlja vašu skriptu i prijemnik na različitim brzinama, pa podaci o zrakoplovima ne stižu.