首页/指令库/CSR立即数读后清零
CSRRCI

RISC-V CSRRCI 指令详解

指令手册I-type

读CSR旧值到rd,以5位立即数为掩码原子地清除CSR中对应位

指令语法

csrrci 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

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

格式: I-type
opcode: 1110011 (0x73)
funct3: 111 (0x7)

指令行为说明

CSRRCI是CSRRC的立即数变体:将CSR当前值零扩展至XLEN位后写入rd,然后以5位无符号立即数(uimm[4:0])作为位掩码,将对应位清零。若uimm=0,指令不写CSR且不产生写副作用,可安全地只读CSR。仅能影响CSR低5位(位0~4)。常用于原子性清除中断挂起位或关闭低位的控制标志。汇编伪指令CSRCI(csr, uimm)编码为CSRRCI x0, csr, uimm(只清位不读旧值)。

快速理解与检索要点

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

CSRRW 在 rd=x0 时不读 CSR;CSRRS/CSRRC 在 rs1=x0 时不写 CSR。
立即数形式使用零扩展的 5 位 uimm;uimm=0 对 CSRRSI/CSRRCI 抑制写操作。
访问不存在、权限不足或只读 CSR 的非法写入会触发 illegal-instruction 异常。

常见使用场景

原子与同步

结合 «csrrci x5, mip, 4 # x5 = old mip; clear bit 2 in mip» 等实际代码理解该场景。

系统与特权

结合 «csrrci x5, mip, 4 # x5 = old mip; clear bit 2 in mip» 等实际代码理解该场景。

使用前检查清单

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

容易混淆 / 常见误区

仅能影响CSR低5位,高位清除需用CSRRC配合寄存器
uimm=0为只读特例,不会清任何位
某些CSR位的读取值与底层值不同,RMW中可能发生意外修改

常见问题

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

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

rd=x0 有什么影响?

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