Skip to main content

Konačni automat i zaključavanje

Što ovaj primjer prikazuje​

Provođenje prijamnika kroz njegova stanja: hardverski reset preko pina RESET, stanje BOOTLOADER u koje ga hardverski reset postavlja, stanje RUN, stanje CONFIGURATION i namjerni povratak u BOOTLOADER pomoću zaključavanja. U svakom koraku skripta pita prijamnik u kojem je stanju i ispisuje odgovor, a zatim otpušta zaključavanje kako bi se prijamnik vratio u stanje RUN.

Primjer koda​

Ovo je Examples/ADSBReceiver-stateMachineAndLock.py iz fiksirane verzije modula, bez zaglavnog komentara datoteke. Tijelo skripte je točno onakvo kakvo se isporučuje. Koristi pin RESET na IO21, koji ova pločica povezuje s prijamnikom, zajedno s UART1 ožičenjem na IO17 i IO18.

import time
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("Hardware-resetting the module (RESET pin)...")
if adsb.hardwareReset():
# BOOTLOADER holds for ~3s at the fixed 115200bps, then the module
# auto-transitions to RUN (unless locked). Wait it out before talking to it.
time.sleep_ms(3200)
else:
print("No reset_pin configured - skipping hardware reset, module keeps running.")

print("RUN -> CONFIGURATION")
if not adsb.enterConfiguration():
print("Failed to enter CONFIGURATION state.")
else:
# Ask the module to confirm which state it is actually in.
ok, state = adsb.getConfigState()
if ok:
print("AT+CONFIG? = {}".format(state))

print("CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1)")
if not adsb.rebootToBootloader():
print("Failed to reboot to BOOTLOADER state.")
else:
# BOOTLOADER state always runs at the fixed 115200bps.
time.sleep_ms(200)

# Confirm the module really is in BOOTLOADER now.
ok, inBootloader = adsb.isBootloader()
if ok:
print("AT+BOOT? = {}".format("1 (BOOTLOADER)" if inBootloader else "0 (CONFIGURATION)"))

# The lock should be set, since rebootToBootloader() sets it automatically.
ok, locked = adsb.getLock()
if ok:
print("AT+LOCK? = {}".format("1 (locked)" if locked else "0 (unlocked)"))

print("Releasing lock: module will fall through to RUN state")
adsb.setLock(False)

# Module leaves BOOTLOADER and enters RUN at its configured run baud (115200 by default).
time.sleep_ms(200)
print("Done. Module should now be broadcasting in RUN state again.")

while True:
adsb.poll()

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 jednom izvrši svoj slijed, što traje nekoliko sekundi zbog čekanja od 3,2 sekunde nakon hardverskog reseta, a zatim nastavlja provjeravati stanje. Retci se pojavljuju ovim redoslijedom: poruka o resetu, RUN -> CONFIGURATION, redak AT+CONFIG? =, CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1), redak AT+BOOT? =, redak AT+LOCK? =, Releasing lock: module will fall through to RUN state i Done. Module should now be broadcasting in RUN state again. Tri retka koja javljaju vrijednost dolaze od samog prijamnika. Opis samog modula za prvi od njih glasi: 1 za CONFIGURATION na 115200 i 2 za CONFIGURATION na postavljenoj brzini prijenosa.

ShellMicroPython
Hardware-resetting the module (RESET pin)...
RUN -> CONFIGURATION
AT+CONFIG? = 1
CONFIGURATION -> BOOTLOADER (this also sets AT+LOCK=1)
AT+BOOT? = 1 (BOOTLOADER)
AT+LOCK? = 1 (locked)
Releasing lock: module will fall through to RUN state
Done. Module should now be broadcasting in RUN state again.

Korištene funkcije​

ADSBReceiver(uart, reset_pin=None)returns ADSBReceiver

Stvara objekt prijamnika na UART-u koji ste već otvorili. Ako zadate reset pin, modul ga postavlja kao ulaz visoke impedancije, tako da se pin pokreće samo tijekom hardwareReset().

ReturnsObjekt prijamnika spreman za ostale funkcije.

Parametri

TipNazivOpis
machine.UARTuartOtvoren UART povezan s prijamnikom. Veličinu njegova prijamnog međuspremnika odredite pri stvaranju, kao što to radi primjer s rxbuf=4096: gust promet može preplaviti zadani međuspremnik i oštetiti retke.
int or Nonereset_pinGPIO spojen na pin RESET prijamnika. Neobavezan, zadano None, čime se onemogućuje hardwareReset(). Ova pločica koristi 21.
hardwareReset(pulse_ms=20, active_low=True, resync_to_baud=115200)returns bool

Resetira prijamnik tako da nakratko povuče pin RESET na nisku razinu, a zatim ga otpusti natrag u ulaz visoke impedancije. Prijamnik se ponovno pokreće u stanju BOOTLOADER na fiksnih 115200 baud oko 3 sekunde, a zatim prelazi u stanje RUN ako nije zaključan. Bajtovi preostali od prije reseta odbacuju se.

ReturnsFalse ako konstruktoru niste zadali reset_pin, a tada se ništa ne događa. Inače True.

Parametri

TipNazivOpis
intpulse_msKoliko dugo prijamnik treba držati u resetu, u milisekundama. Neobavezan, zadano 20.
boolactive_lowTrue ako se prijamnik resetira dok je RESET povučen na nisku razinu. Neobavezan, zadano True.
int or Noneresync_to_baudTakođer prebacuje UART na ovu brzinu prijenosa, kako sljedeća naredba ne bi bila poslana zastarjelom brzinom. Neobavezan, zadano 115200. None ostavlja UART kakav jest.
enterConfiguration()returns bool

Prebacuje prijamnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje UART na 115200 (fiksna brzina prijenosa prijamnika u stanju CONFIGURATION) i potvrđuje novo stanje naredbom AT+CONFIG?.

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

getConfigState()returns tuple(bool, int)

Pita prijamnik u kojem je stanju (AT+CONFIG?).

Returns(True, state) u slučaju uspjeha, gdje je state 0 za RUN, 1 za CONFIGURATION na 115200 i 2 za CONFIGURATION na postavljenoj brzini prijenosa. Inače (False, 0).

rebootToBootloader()returns bool

Ponovno pokreće prijamnik u stanje BOOTLOADER (AT+REBOOT_BOOTLOADER). Također postavlja zaključavanje, pa prijamnik nakon toga ostaje u stanju BOOTLOADER.

ReturnsTrue u slučaju uspjeha, inače False.

isBootloader()returns tuple(bool, bool)

Pita prijamnik je li u stanju BOOTLOADER (AT+BOOT?).

Returns(True, in_bootloader) u slučaju uspjeha, inače (False, False).

getLock()returns tuple(bool, bool)

Pita prijamnik je li zaključavanje postavljeno (AT+LOCK?). Dok je postavljeno, prijamnik ostaje u stanju BOOTLOADER.

Returns(True, locked) u slučaju uspjeha, inače (False, False).

setLock(locked)returns bool

Postavlja ili uklanja zaključavanje (AT+LOCK=1 ili AT+LOCK=0). Njegovim uklanjanjem prijamnik može iz stanja BOOTLOADER prijeći u stanje RUN.

ReturnsTrue u slučaju uspjeha, inače False.

Parametri

TipNazivOpis
boollockedTrue za postavljanje zaključavanja, False za njegovo uklanjanje.
poll()returns None

Čita sve pristigle bajtove, obrađuje potpune retke i poziva registrirane funkcije. Ne blokira, stoga ga pozovite u svakom prolazu petlje.

ReturnsNišta.

Sve zajedno​

Postavke se mogu zapisivati samo u stanju CONFIGURATION, pa skripta ulazi u to stanje prije nego što zatraži stanje, zaključavanje i oznaku bootloadera. rebootToBootloader() umjesto vas postavlja zaključavanje, zbog čega skripta zaključavanje zatim pročita i uklanja ga pomoću setLock(False): bez toga bi prijamnik ostao u stanju BOOTLOADER i ne bi slao podatke o zrakoplovima.