Skip to content

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 位临时寄存器,常用作循环计数
ISR32 位输入移位寄存器,收集输入数据
OSR32 位输出移位寄存器,保存待输出数据
PC程序计数器,指向指令地址
TX / RX FIFO通常每方向 4 × 32 位;FIFO join 可调整用途

数据流 ​

asm
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 表示输入。

示例 ​

asm
set x, 7
set y, 31
set pins, 1
set pins, 0
set pindirs, 1
set pindirs, 0

开漏输出思路 ​

asm
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 / !yX / Y 为零
x-- / y--递减前的 X / Y 非零
x!=yX 与 Y 不相等
pinJMP 引脚为高
!osre输出移位计数小于阈值

循环体执行 8 次 ​

asm
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 ​

等待条件满足;若条件原本已满足则立即通过。没有内置超时。

等待一次上升沿 ​

asm
wait 0 pin 0
wait 1 pin 0

不同等待源,按需选用 ​

asm
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 根并行输入 ​

asm
mov isr, null
in pins, 8
push block

一根线上采样 8 次 ​

asm
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。

示例 ​

asm
pull block
out pins, 8
out null, 8

解析命令:计数、方向、入口 ​

asm
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 供数。

示例 ​

asm
pull block
out pins, 8

其他形式,按需选用 ​

asm
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 并重置输入移位计数。

示例 ​

asm
mov isr, null
in pins, 8
push block

其他形式,按需选用 ​

asm
push noblock
push iffull block
  • push block 在 RX FIFO 满时等待;push noblock 满时不等待,可能丢失本次数据。
  • iffull 判断输入移位计数达到阈值,不是判断 RX FIFO 已满。
  • 外部信号在阻塞期间继续变化,因此阻塞不等于无损采集。高速连续采集需 DMA 及时搬走数据,并处理缓冲耗尽。

MOV · 搬运、取反、位反转 ​

在寄存器、引脚或特殊目标之间搬运数据,不像 IN/OUT 那样从来源移出指定数量的位。

示例 ​

asm
mov x, osr
mov y, isr
mov isr, null
mov osr, x
mov x, ~x
mov osr, ::osr

高级用法,按需选用 ​

asm
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 中断仍需另行配置。

三种形式,按需选用 ​

asm
irq set 0
irq clear 0
irq wait 0

两个状态机握手 ​

asm
; 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 改变时钟。

示例 ​

asm
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]

示例 ​

asm
.program timing_demo
.side_set 1
.wrap_target
    out pins, 1 side 0 [1]
    nop         side 1 [1]
.wrap

缺数据时保持低电平 ​

asm
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 pinsm_config_set_in_pins
OUT pins / pindirssm_config_set_out_pins
SET pins / pindirssm_config_set_set_pins
side-setsm_config_set_sideset_pins
JMP pinsm_config_set_jmp_pin

完整方波程序:10 个周期一周期 ​

asm
.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 程序 ​

asm
.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 端收发示意 ​

asm
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 个状态机周期。

示例 ​

asm
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 访问等功能。基础九条指令的主要用法仍通用。

示例 ​

asm
.program v1_example
.pio_version 1
wait 1 jmppin
irq next 0
  • 示例需 PIO v1 汇编器与硬件;不能直接用于 RP2040。浏览器汇编器与板端生成代码也必须支持对应扩展,若提示不支持请勿按 v0 编码替代。
  • RX FIFO 直接访问需要匹配专用 FIFO 配置,不等同于普通 PUSH/PULL。完整约束请查 RP2350 数据手册。