`rp2` --- RP2040 专用功能¶

rp2 模块包含 RP2040 专用的函数和类，可用于 Raspberry Pi Pico。

更多信息请参阅 RP2040 Python 数据手册，示例代码请参阅 pico-micropython-examples。

PIO 相关函数¶

rp2 模块包含用于汇编 PIO 程序的函数。

关于运行 PIO 程序，请参阅 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¶

汇编一个 PIO 程序。

以下参数控制 GPIO 引脚的初始状态，取值为 PIO.IN_LOW、PIO.IN_HIGH、PIO.OUT_LOW 或 PIO.OUT_HIGH 之一。如果程序使用多个引脚，请提供一个元组，例如 out_init=(PIO.OUT_LOW, PIO.OUT_LOW)。

out_init 配置用于 out() 指令的引脚。
set_init 配置用于 set() 指令的引脚。最多可有 5 个。
sideset_init 配置用于 .side() 修饰符的引脚。最多可有 5 个。
side_pindir 设为 True 时，.side() 修饰符用于控制引脚方向，而不是引脚值（默认为 False 时为引脚值）。

以下参数为默认使用，但可在 StateMachine.init() 中覆盖：

in_shiftdir 是 ISR 移位的默认方向，为 PIO.SHIFT_LEFT 或 PIO.SHIFT_RIGHT。
out_shiftdir 是 OSR 移位的默认方向，为 PIO.SHIFT_LEFT 或 PIO.SHIFT_RIGHT。
push_thresh 是触发自动压入或条件性重新压入之前的位数阈值。
pull_thresh 是触发自动拉取或条件性重新拉取之前的位数阈值。

其余参数为：

autopush 配置是否启用自动压入。
autopull 配置是否启用自动拉取。
fifo_join 配置是否将 4 字的 TX 和 RX FIFO 合并为单个 8 字的 FIFO，仅用于一个方向。选项为 PIO.JOIN_NONE、PIO.JOIN_RX 和 PIO.JOIN_TX。

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

汇编单条 PIO 指令。通常你应改用 asm_pio()。

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

rp2.bootsel_button() → int¶

暂时将 QSPI_SS 引脚变为输入并读取其值，低电平返回 1，高电平返回 0。在带有 BOOTSEL 按钮的典型 RP2040 开发板上，返回值为 1 表示按钮被按下。

由于此函数会暂时禁用对外部闪存的访问，因此它也会暂时禁用中断和另一个内核，以防止它们尝试从闪存执行代码。

class rp2.PIOASMError¶: 如果在汇编 PIO 程序时出现错误，则会从 asm_pio() 或 asm_pio_encode() 引发此异常。

PIO 汇编语言指令¶

PIO 状态机使用一种自定义汇编语言进行编程，包含九条核心 PIO 机器指令。在 MicroPython 中，PIO 汇编例程被编写为带有装饰器 @rp2.asm_pio() 的 Python 函数，并使用 Python 语法。这类例程支持标准的 Python 变量和算术运算，以及以下用于编码 PIO 指令和指导汇编器的自定义函数。更多细节请参阅 RP2040 数据手册第 3.4 节。

wrap_target()

指定程序回绕后继续执行的位置。默认情况下这是 PIO 例程的起始处。

wrap()

指定程序结束并回绕的位置。如果未使用此指令，则会自动添加到 PIO 例程的末尾。回绕不消耗任何执行周期。

label(label)

在当前位置定义一个名为 label 的标签。label 可以是字符串或整数。

word(instr, label=None)

在汇编输出中插入一个任意的 16 位字。

instr：16 位的值
label：如果给定，则查找该标签并将标签的值与 instr 进行逻辑或运算

jmp(...)

此指令有两种形式：

jmp(label)

label：无条件跳转到的标签

jmp(cond, label)

cond：要检查的条件，为以下之一：
- not_x、not_y：如果寄存器为零则为真
- x_dec、y_dec：如果寄存器非零则为真，并执行后递减
- x_not_y：如果 X 不等于 Y 则为真
- pin：如果输入引脚被置位则为真
- not_osre：如果 OSR 非空（尚未达到其阈值）则为真
label：如果条件为真则跳转到的标签

wait(polarity, src, index)

阻塞，等待引脚或 IRQ 线上的高/低电平。

polarity：0 或 1，表示等待低电平值还是高电平值
src：以下之一：gpio（绝对引脚）、pin（相对于状态机 in_base 参数的引脚）、irq
index：0-31，src 的索引

in_(src, bit_count)

将数据从 src 移入 ISR。

src：以下之一：pins、x、y、null、isr、osr
bit_count：要移入的位数（1-32）

out(dest, bit_count)

将数据从 OSR 移出到 dest。

dest：以下之一：pins、x、y、pindirs、pc、isr、exec
bit_count：要移出的位数（1-32）

push(...)

将 ISR 压入 RX FIFO，然后将 ISR 清零。此指令有以下形式：

push()
push(block)
push(noblock)
push(iffull)
push(iffull, block)
push(iffull, noblock)

如果使用 block，则当 RX FIFO 已满时指令会停顿。默认为阻塞。如果使用 iffull，则仅当输入移位计数达到其阈值时才压入。

pull(...)

从 TX FIFO 拉取到 OSR。此指令有以下形式：

pull()
pull(block)
pull(noblock)
pull(ifempty)
pull(ifempty, block)
pull(ifempty, noblock)

如果使用 block，则当 TX FIFO 为空时指令会停顿。默认为阻塞。如果使用 ifempty，则仅当输出移位计数达到其阈值时才拉取。

mov(dest, src)

将 src 的值移入 dest。

dest：以下之一：pins、x、y、exec、pc、isr、osr
src：以下之一：pins、x、y、null、status、isr、osr；此参数可选地通过用 invert() 或 reverse() 包裹来修饰（但不能同时使用两者）

irq(...)

设置或清除一个 IRQ 标志。此指令有两种形式：

irq(index)

index：0-7，或 rel(0) 到 rel(7)

irq(mode, index)

mode：以下之一：block、clear
index：0-7，或 rel(0) 到 rel(7)

如果使用 block，则指令会停顿，直到该标志被另一个实体清除。如果使用 clear，则清除该标志而不是置位。相对 IRQ 索引通过模 4 加法将状态机 ID 加到 IRQ 索引上。IRQ 0-3 对处理器可见，4-7 为状态机内部使用。

set(dest, data)

用值 data 设置 dest。

dest：pins、x、y、pindirs
data：值（0-31）

nop()

这是一条伪指令，汇编为 mov(y, y)，且没有副作用。

.side(value)

这是一个可应用于任何指令的修饰符，用于控制 side-set 引脚值。

value：要在 side-set 引脚上输出的值（位）

.delay(value)

这是一个可应用于任何指令的修饰符，指定指令执行后延迟多少个周期。

value：延迟的周期数，0-31（如果使用 side-set 引脚，则最大值会减小）

[value]

这是一个修饰符，等效于 .delay(value)。

rp2 --- RP2040 专用功能¶

PIO 相关函数¶

PIO 汇编语言指令¶

类¶

`rp2` --- RP2040 专用功能¶