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.
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 ADSBReceiverStvara 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
| Tip | Naziv | Opis |
|---|---|---|
machine.UART | uart | Otvoren 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 None | reset_pin | GPIO 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 boolResetira 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
| Tip | Naziv | Opis |
|---|---|---|
int | pulse_ms | Koliko dugo prijamnik treba držati u resetu, u milisekundama. Neobavezan, zadano 20. |
bool | active_low | True ako se prijamnik resetira dok je RESET povučen na nisku razinu. Neobavezan, zadano True. |
int or None | resync_to_baud | Takođ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 boolPrebacuje 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 boolPonovno 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 boolPostavlja 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
| Tip | Naziv | Opis |
|---|---|---|
bool | locked | True 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.