首页/指令库/CSR立即数读写
CSRRWI

RISC-V CSRRWI 指令详解

指令手册I-type

原子地将CSR旧值读入rd,并把5位无符号立即数零扩展后写入该CSR

指令语法

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

指令编码

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

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

格式: I-type
opcode: 1110011 (0x73)
funct3: 101 (0x5)

指令行为说明

CSRRWI 是 CSRRW 的立即数变体:将 CSR 旧值零扩展至 XLEN 位后写入 rd,然后将 5 位无符号立即数 uimm[4:0] 零扩展至 XLEN 位后写入该 CSR。若 rd=x0,则指令不读取 CSR,也不触发 CSR 读副作用。立即数范围仅能表示 0..31;写更大值需使用 CSRRW 与整数寄存器。汇编伪指令 CSRWI(csr, uimm) 编码为 CSRRWI x0, csr, uimm。

快速理解与检索要点

CSRRWI 是 Zicsr 的原子 CSR 读-改-写指令。CSR 地址为 12 位,读写副作用是否发生取决于 rd、rs1 或 uimm 是否为 x0/0。

CSRRWI 在 rd=x0 时不读 CSR;但无论 uimm 是否为 0,写操作语义仍按 CSRRW 立即数形式执行。
uimm 是 5 位无符号立即数,零扩展到 XLEN 后写入 CSR。

常见使用场景

原子与同步

结合 «csrrwi x5, fflags, 3 # x5 = old fflags; fflags = 3» 等实际代码理解该场景。

系统与特权

结合 «csrrwi x5, fflags, 3 # x5 = old fflags; fflags = 3» 等实际代码理解该场景。

使用前检查清单

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

容易混淆 / 常见误区

立即数只有5位(0~31),无法写入大于31的值——需改用CSRRW配合寄存器
rd=x0时不读取CSR,但写操作仍执行
立即数为0时写入CSR全零值,与CSRRSI/CSRRCI中uimm=0的'不写'行为不同

常见问题

CSR 指令是普通内存原子操作吗?

不是。这里的 atomic 指 CSR 读-改-写在单条指令内完成,不是对内存地址的 AMO。

rd=x0 有什么影响?

对 CSRRW 会抑制 CSR 读取和读副作用;对 CSRRS/CSRRC 仍会读取 CSR。