PIO 汇编语法
以下与 PIO/C 编译器问号帮助的「PIO 语法」使用同一份内容。示例采用 Pico SDK pioasm 语法;除完整程序外,片段需放在 .program 中并配置状态机。
先认识 PIO
PIO 是独立执行的小型状态机。基础指令只有 JMP、WAIT、IN、OUT、PUSH、PULL、MOV、IRQ、SET;NOP 是伪指令。每个 PIO 模块的 4 个状态机共享 32 条指令空间。RP2350 有 3 个 PIO 模块。
| 资源 | 作用 |
|---|---|
| X / Y | 两个 32 位临时寄存器,常用作循环计数 |
| ISR | 32 位输入移位寄存器,收集输入数据 |
| OSR | 32 位输出移位寄存器,保存待输出数据 |
| PC | 程序计数器,指向指令地址 |
| TX / RX FIFO | 通常每方向 4 × 32 位;FIFO join 可调整用途 |
数据流
CPU / DMA → TX FIFO → PULL → OSR → OUT → GPIO
GPIO → IN → ISR → PUSH → RX FIFO → CPU / DMA- 本文使用 Pico SDK pioasm 语法,不是 MicroPython 的 Python 写法。除完整程序外,片段需放入 .program 并补充状态机配置。
- 指令通常执行 1 个状态机周期;延时、阻塞以及动态执行的指令会增加实际耗时。
SET · 立即数赋值
把 0~31 的立即数写入 X、Y、pins 或 pindirs。pins 改变输出电平;pindirs 的 1 表示输出,0 表示输入。
示例
set x, 7
set y, 31
set pins, 1
set pins, 0
set pindirs, 1
set pindirs, 0开漏输出思路
set pins, 0
set pindirs, 1 ; drive low
set pindirs, 0 ; release to external pull-up- SET pins/pindirs 使用 SET 引脚映射,由 sm_config_set_set_pins 配置,最多直接控制 5 根引脚;它与 OUT 引脚映射不同。
- 立即数只有 5 位,set x, 100 不合法。大数可先从 FIFO 读到 OSR,再 MOV/OUT 给 X。
- 改变电平不等于改变方向;引脚还需选择正确的 PIO 功能。开漏释放需要外部上拉。
JMP · 跳转与循环
跳转到标签,或根据 X、Y、引脚与 OSR 移位计数决定是否跳转。
| 条件 | 跳转条件 |
|---|---|
| jmp label | 无条件 |
| !x / !y | X / Y 为零 |
| x-- / y-- | 递减前的 X / Y 非零 |
| x!=y | X 与 Y 不相等 |
| pin | JMP 引脚为高 |
| !osre | 输出移位计数小于阈值 |
循环体执行 8 次
set x, 7
loop:
nop
jmp x--, loop- x-- / y-- 先按原值判断跳转,再递减;即使不跳转也会递减。0 会回绕为 0xffffffff,后续复用前应重新初始化。
- jmp pin 检查 sm_config_set_jmp_pin 指定的一根引脚,不等同于 IN_BASE。
- !osre 检查输出移位计数是否尚未达到 pull 阈值,不检查 OSR 的数据是否为零。
- 动态跳转和手工编码的地址需考虑程序实际加载偏移。
WAIT · 等待电平或 IRQ
等待条件满足;若条件原本已满足则立即通过。没有内置超时。
等待一次上升沿
wait 0 pin 0
wait 1 pin 0不同等待源,按需选用
wait 1 gpio 8
wait 1 irq 0
wait 0 irq 0- pin 0 相对于 IN_BASE;常见 GPIO base=0 配置下 gpio 8 直接检查 GPIO8。RP2350 调整 GPIO base 时需考虑该映射。
- 只写 wait 1 pin 0 不能保证等到新上升沿;先等低,再等高。
- wait 1 irq 0 满足时自动清除 IRQ0;wait 0 irq 0 只等待标志已清零。
- 默认 GPIO 输入同步器会增加延迟;绕过同步器降低延迟,但存在亚稳态风险。
IN · 移入 ISR
语法:in 来源, 位数。把来源的 1~32 位移入 ISR,并增加输入移位计数。常见来源为 pins、x、y、null、isr、osr。
一次采样 8 根并行输入
mov isr, null
in pins, 8
push block一根线上采样 8 次
set x, 7
sample:
in pins, 1
jmp x--, sample- in pins, 8 是同时采样 8 根引脚,不是在一根线上采样 8 次。引脚从 IN_BASE 开始映射。
- 移位方向由 sm_config_set_in_shift 配置。向右移位并只收 8 位时,PUSH 后通常需要将 FIFO 字右移 24 位。
- 启用 autopush 后,达到阈值自动 PUSH;RX FIFO 满时会阻塞,连续采样可能漏数据。
- IN 不会移出来源寄存器中的位。ISR 数据与输入移位计数是独立状态。
OUT · 从 OSR 移出
语法:out 目标, 位数。移出 OSR 中的 1~32 位。目标可为 pins、x、y、null、pindirs、isr、pc、exec。
示例
pull block
out pins, 8
out null, 8解析命令:计数、方向、入口
pull block
out x, 8
out pindirs, 1
out pc, 5- 上面的命令解析假设 OSR 向右移位:先取低 8 位,再取 bit8,然后取 bit9~13。out pc 会跳转,片段必须配合有效命令格式。
- out x, 8 覆盖 X,不是向 X 追加 8 位。out null 丢弃相应位。
- OUT 引脚由 sm_config_set_out_pins 配置,移位方向由 sm_config_set_out_shift 配置。
- autopull 缺数据时会阻塞。out exec, 16 把数据作为指令执行,不能输入任意普通数据。
PULL · TX FIFO → OSR
从 TX FIFO 取一个 32 位字装入 OSR。CPU / DMA 向 TX FIFO 供数。
示例
pull block
out pins, 8其他形式,按需选用
pull noblock
pull ifempty block- pull block 在 TX FIFO 空时等待;pull noblock 空时使用 X 的值装入 OSR,并非保持 OSR 不变。
- ifempty 判断输出移位计数是否达到阈值,不检查 OSR 数据值是否为零。
- CPU 的 pio_sm_put_blocking 返回仅表示已把数据放入 FIFO,不表示引脚已经发送完成。
- 阻塞时后续指令不执行,side-set 输出仍需考虑;时钟敏感协议应安排在允许的电平等待。
PUSH · ISR → RX FIFO
把 ISR 内容送入 RX FIFO;随后清空 ISR 并重置输入移位计数。
示例
mov isr, null
in pins, 8
push block其他形式,按需选用
push noblock
push iffull block- push block 在 RX FIFO 满时等待;push noblock 满时不等待,可能丢失本次数据。
- iffull 判断输入移位计数达到阈值,不是判断 RX FIFO 已满。
- 外部信号在阻塞期间继续变化,因此阻塞不等于无损采集。高速连续采集需 DMA 及时搬走数据,并处理缓冲耗尽。
MOV · 搬运、取反、位反转
在寄存器、引脚或特殊目标之间搬运数据,不像 IN/OUT 那样从来源移出指定数量的位。
示例
mov x, osr
mov y, isr
mov isr, null
mov osr, x
mov x, ~x
mov osr, ::osr高级用法,按需选用
mov pc, x
mov exec, x
mov x, status- ~ 是逐位取反;:: 反转整个 32 位的位序,不是只反转低 8 位。
- 写 ISR / OSR 还会重置对应移位计数。MOV 不是算术指令,不支持 mov x, x+1。
- mov x, status 的含义取决于状态机配置,不是直接返回 FIFO 长度。
- mov pc 需要有效地址;mov exec 使用低 16 位作为指令执行。
IRQ · 同步与通知
设置或清除 PIO 的 IRQ 标志,也可设置后等待别人清除。CPU 中断仍需另行配置。
三种形式,按需选用
irq set 0
irq clear 0
irq wait 0两个状态机握手
; SM A
irq wait 0
; SM B (a separate state machine)
wait 1 irq 0- irq wait 设置标志后阻塞,直到其他状态机或 CPU 清除;无人清除会一直等待。
- wait 1 irq 会消费并清除对应标志;CPU 与状态机不能无协调地竞争同一个标志。
- irq set 0 rel 按状态机编号调整标志编号的低两位,采用模 4 加法。
- 双方都等对方先通知会死锁。设置 IRQ 标志不表示 CPU 的中断源与处理函数已经启用。
NOP · 空操作伪指令
NOP 等价于 mov y, y,常用来填充时序或配合 side-set 改变时钟。
示例
nop
nop [3]- nop [3] 占 1 + 3 = 4 个状态机周期;没有独立的 NOP 指令编码。
延时与 side-set
side-set 与主指令同时控制额外引脚;[n] 表示额外延时 n 个周期。两者共享指令中的 5 位空间。
| 配置 | 最大额外延时 |
|---|---|
| 无 side-set | [31] |
| .side_set 1 | [15] |
| .side_set 1 opt | [7] |
示例
.program timing_demo
.side_set 1
.wrap_target
out pins, 1 side 0 [1]
nop side 1 [1]
.wrap缺数据时保持低电平
pull block side 0- .side_set 1 要求每条指令指定 side;.side_set 1 opt 允许省略,省略时不主动改变 side-set 输出。
- side-set 引脚通过 sm_config_set_sideset_pins 设置,与 SET、OUT 映射独立。
- 指令阻塞时,side-set 仍可先改变引脚。例如 pull block side 1 缺数据时可能长时间保持时钟高电平。
- 延时在指令完成后计入;WAIT/FIFO 阻塞会额外增加耗时。
程序指示与引脚映射
.program、标签、.wrap_target 与 .wrap 是汇编期/配置指示,不是普通执行指令。硬件 wrap 不增加 JMP 周期。
| 用途 | 配置接口 |
|---|---|
| IN / WAIT pin | sm_config_set_in_pins |
| OUT pins / pindirs | sm_config_set_out_pins |
| SET pins / pindirs | sm_config_set_set_pins |
| side-set | sm_config_set_sideset_pins |
| JMP pin | sm_config_set_jmp_pin |
完整方波程序:10 个周期一周期
.program square
.wrap_target
set pins, 1 [4]
set pins, 0 [4]
.wrap- 上例高、低各 5 个周期;状态机 10 MHz 时输出 1 MHz。还需配置 SET 引脚并设为输出。
- fSM = 系统时钟 / 分频值。小数分频可能让单个周期以系统时钟为单位变化;测量时还要考虑逻辑分析仪采样量化。
完整示例 · SPI 单字节
Mode 0、低位先发,关闭 autopull / autopush。OUT=MOSI、IN=MISO、side-set=CLK;示例不包含 CS 控制。
PIO 程序
.program spi_byte
.side_set 1
.wrap_target
pull block side 0
set x, 7 side 0
bitloop:
out pins, 1 side 0
nop side 1
in pins, 1 side 1
jmp x--, bitloop side 0
push block side 0
.wrap标准 SDK 端收发示意
pio_sm_put_blocking(pio, sm, 0xA5);
uint8_t rx = pio_sm_get_blocking(pio, sm) >> 24;- MOSI、CLK 配置为输出,MISO 为输入;OSR、ISR 均向右移位。初始化引脚映射、分频及状态机后才能运行。
- 字节内每位占 4 个周期,所以 SCK = fSM / 4。字节间还有 PULL、SET、PUSH 开销与可能的等待,整体吞吐率更低。
- 标准 SDK 的 C 写法不可直接原样粘贴到本页 C 子集编辑器。请先汇编 PIO,让页面生成板端 C 框架,再按“C 函数”Tab 的封装接口配置。
项目示例 · SWD 时钟
项目的写位循环使用两个各占 2 周期的指令,循环内低、高电平各为 2 个状态机周期。
示例
write_bitloop:
out pins, 1 [1] side 0
jmp x-- write_bitloop [1] side 1- 循环尾部还会执行命令解析或 FIFO 操作;计算某段电平宽度,要一直数到下一条实际改变 CLK 的指令。
- 看到宽度不同,先检查路径指令数、PULL/PUSH 阻塞、小数分频和采样分辨率,不宜仅凭一段截图判定 PIO 有缺陷。
RP2350 · PIO v1 扩展
RP2350 增加 wait jmppin、跨 PIO 的 IRQ、部分 MOV / RX FIFO 访问等功能。基础九条指令的主要用法仍通用。
示例
.program v1_example
.pio_version 1
wait 1 jmppin
irq next 0- 示例需 PIO v1 汇编器与硬件;不能直接用于 RP2040。浏览器汇编器与板端生成代码也必须支持对应扩展,若提示不支持请勿按 v0 编码替代。
- RX FIFO 直接访问需要匹配专用 FIFO 配置,不等同于普通 PUSH/PULL。完整约束请查 RP2350 数据手册。