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:
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 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 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 None | reset_pin | GPIO spojen na pin RESET prijemnika. Neobavezno, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21. |
enterConfiguration()returns boolPrebacuje 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 boolOdabire 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
| Tip | Naziv | Opis |
|---|---|---|
int | protocol | Jedna od vrijednosti DECODED_PROTOCOL_NONE (0), DECODED_PROTOCOL_CSV (1) ili DECODED_PROTOCOL_MAVLINK (2). |
setAdsbRxProtocolInc(mode)returns boolOdabire koliko se često šalju izvješća o zrakoplovima (postavka ADSB_RX_PROTOCOL_INC).
ReturnsTrue ako je uspjelo, inače False.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | mode | Jedna 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 boolUključ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
| Tip | Naziv | Opis |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1). |
setSystemLog(enable)returns boolUključ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
| Tip | Naziv | Opis |
|---|---|---|
bool | enable | True za uključivanje zapisnika, False za njegovo isključivanje. |
setSystemStatisticsProtocol(protocol)returns boolUključ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
| Tip | Naziv | Opis |
|---|---|---|
int | protocol | STATS_PROTOCOL_NONE (0) ili STATS_PROTOCOL_CSV (1). |
setBaudrate(baudrate)returns boolPostavlja 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
| Tip | Naziv | Opis |
|---|---|---|
int | baudrate | Jedna 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 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 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.