rp2 — funkcionalnost specifična za RP2040

Modul rp2 sadrži funkcije i klase specifične za RP2040, kakav se koristi u Raspberry Pi Pico.

Više informacija potražite u dokumentu RP2040 Python datasheet, a primjere koda u pico-micropython-examples.

Funkcije vezane uz PIO

Modul rp2 uključuje funkcije za asembliranje PIO programa.

Za pokretanje PIO programa pogledajte rp2.StateMachine.

rp2.asm_pio(*, out_init: 'int | tuple[int, ...] | None' = None, set_init: 'int | tuple[int, ...] | None' = None, sideset_init: 'int | tuple[int, ...] | None' = None, side_pindir: bool = False, in_shiftdir: int = PIO.SHIFT_LEFT, out_shiftdir: int = PIO.SHIFT_LEFT, autopush: bool = False, autopull: bool = False, push_thresh: int = 32, pull_thresh: int = 32, fifo_join: int = PIO.JOIN_NONE) → Callable

Asemblira PIO program.

Sljedeći parametri upravljaju početnim stanjem GPIO pinova, kao jedan od PIO.IN_LOW, PIO.IN_HIGH, PIO.OUT_LOW ili PIO.OUT_HIGH. Ako program koristi više od jednog pina, navedite n-torku, npr. out_init=(PIO.OUT_LOW, PIO.OUT_LOW).

• out_init konfigurira pinove koji se koriste za out() instrukcije.

• set_init konfigurira pinove koji se koriste za set() instrukcije. Može ih biti najviše 5.

• sideset_init konfigurira pinove koji se koriste za .side() modifikatore. Može ih biti najviše 5.

• side_pindir kada je postavljen na True konfigurira .side() modifikatore tako da se koriste za smjerove pinova, umjesto za vrijednosti pinova (zadano, kada je False).

Sljedeći parametri koriste se prema zadanim postavkama, ali se mogu nadjačati u StateMachine.init():

• in_shiftdir je zadani smjer u kojem će ISR posmicati, ili PIO.SHIFT_LEFT ili PIO.SHIFT_RIGHT.

• out_shiftdir je zadani smjer u kojem će OSR posmicati, ili PIO.SHIFT_LEFT ili PIO.SHIFT_RIGHT.

• push_thresh je prag u bitovima prije nego se aktivira automatsko guranje (auto-push) ili uvjetno ponovno guranje.

• pull_thresh je prag u bitovima prije nego se aktivira automatsko povlačenje (auto-pull) ili uvjetno ponovno povlačenje.

Preostali parametri su:

• autopush konfigurira je li automatsko guranje (auto-push) omogućeno.

• autopull konfigurira je li automatsko povlačenje (auto-pull) omogućeno.

• fifo_join konfigurira trebaju li se 4-riječni TX i RX FIFO-ovi spojiti u jedan 8-riječni FIFO samo za jedan smjer. Opcije su PIO.JOIN_NONE, PIO.JOIN_RX i PIO.JOIN_TX.

rp2.asm_pio_encode(instr: str, sideset_count: int, sideset_opt: bool = False) → int

Asemblira jednu PIO instrukciju. Obično je umjesto toga bolje koristiti asm_pio().

>>> rp2.asm_pio_encode("set(0, 1)", 0)
57345

rp2.bootsel_button() → int

Privremeno pretvara QSPI_SS pin u ulaz i čita njegovu vrijednost, vraćajući 1 za nisku i 0 za visoku razinu. Na tipičnoj RP2040 ploči s BOOTSEL gumbom, povratna vrijednost 1 označava da je gumb pritisnut.

Budući da ova funkcija privremeno onemogućuje pristup vanjskoj flash memoriji, također privremeno onemogućuje prekide i drugu jezgru kako bi ih spriječila da pokušaju izvršavati kod iz flash memorije.

class rp2.PIOASMError

Ova se iznimka podiže iz asm_pio() ili asm_pio_encode() ako dođe do pogreške pri asembliranju PIO programa.

Instrukcije PIO asemblerskog jezika

PIO stroja stanja programiraju se prilagođenim asemblerskim jezikom s devet osnovnih PIO instrukcija. U MicroPythonu, PIO asemblerske rutine pišu se kao Python funkcija s dekoratorom @rp2.asm_pio() i koriste Python sintaksu. Takve rutine podržavaju standardne Python varijable i aritmetiku, kao i sljedeće prilagođene funkcije koje kodiraju PIO instrukcije i upravljaju asemblerom. Za dodatne pojedinosti pogledajte odjeljak 3.4 RP2040 datasheeta.

wrap_target()

Određuje lokaciju na kojoj se izvršavanje nastavlja nakon omatanja programa. Prema zadanim postavkama to je početak PIO rutine.

wrap()

Određuje lokaciju na kojoj program završava i omata se. Ako se ova direktiva ne koristi, automatski se dodaje na kraju PIO rutine. Omatanje ne troši nijedan ciklus izvršavanja.

label(label)

Definira oznaku pod imenom label na trenutnoj lokaciji. label može biti string ili cijeli broj.

word(instr, label=None)

Umeće proizvoljnu 16-bitnu riječ u asemblirani izlaz.

• instr: 16-bitna vrijednost

• label: ako je navedeno, traži oznaku i logički-ili (OR) vrijednost oznake s instr

jmp(…)

Ova instrukcija ima dva oblika:

jmp(label)

• label: oznaka na koju se bezuvjetno skače

jmp(cond, label)

• cond: uvjet za provjeru, jedan od:

  • not_x, not_y: istinito ako je registar nula

  • x_dec, y_dec: istinito ako je registar različit od nule, te izvodi naknadno dekrementiranje

  • x_not_y: istinito ako X nije jednak Y

  • pin: istinito ako je ulazni pin postavljen

  • not_osre: istinito ako OSR nije prazan (nije dosegnuo svoj prag)

• label: oznaka na koju se skače ako je uvjet istinit

wait(polarity, src, index)

Blokira, čekajući visoku/nisku razinu na pinu ili IRQ liniji.

• polarity: 0 ili 1, treba li čekati nisku ili visoku vrijednost

• src: jedan od: gpio (apsolutni pin), pin (pin relativan na in_base argument StateMachinea), irq

• index: 0-31, indeks za src

in_(src, bit_count)

Posmiče podatke iz src u ISR.

• src: jedan od: pins, x, y, null, isr, osr

• bit_count: broj bitova za posmicanje unutra (1-32)

out(dest, bit_count)

Posmiče podatke iz OSR u dest.

• dest: jedan od: pins, x, y, pindirs, pc, isr, exec

• bit_count: broj bitova za posmicanje van (1-32)

push(…)

Gura ISR u RX FIFO, zatim postavlja ISR na nulu. Ova instrukcija ima sljedeće oblike:

• push()

• push(block)

• push(noblock)

• push(iffull)

• push(iffull, block)

• push(iffull, noblock)

Ako se koristi block, instrukcija zastaje ako je RX FIFO pun. Zadano je blokiranje. Ako se koristi iffull, gura samo ako je broj posmaknutih ulaznih bitova dosegnuo svoj prag.

pull(…)

Povlači iz TX FIFO-a u OSR. Ova instrukcija ima sljedeće oblike:

• pull()

• pull(block)

• pull(noblock)

• pull(ifempty)

• pull(ifempty, block)

• pull(ifempty, noblock)

Ako se koristi block, instrukcija zastaje ako je TX FIFO prazan. Zadano je blokiranje. Ako se koristi ifempty, povlači samo ako je broj posmaknutih izlaznih bitova dosegnuo svoj prag.

mov(dest, src)

Premješta u dest vrijednost iz src.

• dest: jedan od: pins, x, y, exec, pc, isr, osr

• src: jedan od: pins, x, y, null, status, isr, osr; ovaj argument se može opcionalno modificirati omatanjem u invert() ili reverse() (ali ne oboje zajedno)

irq(…)

Postavlja ili briše IRQ zastavicu. Ova instrukcija ima dva oblika:

irq(index)

• index: 0-7, ili rel(0) do rel(7)

irq(mode, index)

• mode: jedan od: block, clear

• index: 0-7, ili rel(0) do rel(7)

Ako se koristi block, instrukcija zastaje sve dok drugi entitet ne obriše zastavicu. Ako se koristi clear, zastavica se briše umjesto da se postavlja. Relativni IRQ indeksi dodaju ID stroja stanja IRQ indeksu pomoću zbrajanja modulo-4. IRQ-ovi 0-3 vidljivi su procesoru, dok su 4-7 interni za strojeve stanja.

set(dest, data)

Postavlja dest na vrijednost data.

• dest: pins, x, y, pindirs

• data: vrijednost (0-31)

nop()

Ovo je pseudoinstrukcija koja se asemblira u mov(y, y) i nema nuspojava.

.side(value)

Ovo je modifikator koji se može primijeniti na bilo koju instrukciju, a koristi se za upravljanje vrijednostima side-set pinova.

• value: vrijednost (bitovi) za izlaz na side-set pinovima

.delay(value)

Ovo je modifikator koji se može primijeniti na bilo koju instrukciju, a određuje koliko ciklusa treba odgoditi nakon izvršavanja instrukcije.

• value: ciklusi za odgodu, 0-31 (maksimalna vrijednost se smanjuje ako se koriste side-set pinovi)

[value]

Ovo je modifikator i ekvivalentan je .delay(value).

Klase

• klasa DMA – pristup RP2040-ovom DMA kontroleru
• klasa Flash – pristup ugrađenoj flash memoriji
• klasa PIO – napredno korištenje PIO-a
• klasa StateMachine – pristup programabilnom ulazno/izlaznom sučelju RP2040