首页/指令库/等待中断
WFI

RISC-V WFI 指令详解

指令手册I-type

等待中断提示:实现可暂停 hart,直到可能需要处理中断;合法实现也可将其视为 NOP。

指令语法

wfi
操作数说明
目标寄存器 rd:存放运算结果的通用寄存器。
源寄存器 rs1:第一个操作数所在的寄存器。
立即数 imm:12 位有符号立即数,符号扩展后与 rs1 进行运算。
Privileged系统与特权

指令编码

31..20
imm[11:0]
19..15
rs1
14..12
funct3
11..7
rd
6..0
opcode

WFI 使用 opcode 1110011(0x73)、funct3 000、funct12 000100000101。rs1 字段选择源寄存器,12 位立即数提供第二操作数,rd 选择目标寄存器。

格式: I-type
opcode: 1110011 (0x73)
funct3: 000 (0x0)
funct12: 000100000101 (0x105)

指令行为说明

WFI 通知实现当前 hart 可暂停直到可能需要处理中断。若可服务的本地中断已挂起或之后变为挂起,陷阱会在后续指令处发生;实现也允许因任何原因恢复执行,因此软件必须能处理 WFI 像 NOP 一样返回。WFI 可在所有特权模式使用,U-mode 是否可用以及 TW=1 时的陷阱行为由特权规范约束。

快速理解与检索要点

WFI 是特权架构定义的系统级指令,页面说明只覆盖官方规定的架构语义,不推断平台固件策略。

执行权限、trap 类型和状态恢复由特权级、相关 CSR 位和扩展存在性决定。
在不支持的特权级或未实现扩展中执行会产生相应异常。

常见使用场景

空闲循环节能

结合 «wfi # Wait for interrupt» 等实际代码理解该场景。

低功耗等待

结合 «wfi # Wait for interrupt» 等实际代码理解该场景。

使用前检查清单

语法检查
  • 确认当前指令格式为 I-type。
  • 确认操作数排列顺序与示例一致。
语义检查
  • 确认目标寄存器用途和调用约定兼容。
  • 确认该指令不是伪指令展开后的底层形式。

容易混淆 / 常见误区

WFI 是提示;实现可以不阻塞并按 NOP 返回。
即使全局中断使能位关闭,WFI 也可因本地使能的挂起中断而恢复。
若恢复事件未导致陷阱,执行从 WFI 后的指令继续,软件通常需要重新检查条件并循环。

常见问题

它是用户态普通指令吗?

不是。该类指令受特权级和扩展支持约束,用户态是否可执行必须看官方特权规则。

它是否替代普通内存 fence?

不能简单替代。地址转换、指令获取和数据内存排序分别有不同的 fence/失效指令。