首页/指令库/CSR立即数读后置位
CSRRSI

RISC-V CSRRSI 指令详解

指令手册I-type

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

指令语法

csrrsi 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

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

格式: I-type
opcode: 1110011 (0x73)
funct3: 110 (0x6)

指令行为说明

CSRRSI是CSRRS的立即数变体:将CSR当前值零扩展至XLEN位后写入rd,然后以5位无符号立即数(uimm[4:0])作为位掩码,将对应位置1。若uimm=0,则指令不写CSR且不产生写副作用,可用于只读CSR的安全访问。由于立即数仅5位,只能影响CSR的低5位(位0~4)。常用于设置mstatus中的特权模式字段(如MPP、MPIE等位于低位的控制位)。汇编伪指令CSRSI(csr, uimm)编码为CSRRSI x0, csr, uimm(只置位不读旧值)。

快速理解与检索要点

CSRRSI 是 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 异常。

常见使用场景

原子与同步

结合 «csrrsi x5, mstatus, 1 # x5 = old mstatus; set bit 0 in mstatus» 等实际代码理解该场景。

系统与特权

结合 «csrrsi x5, mstatus, 1 # x5 = old mstatus; set bit 0 in mstatus» 等实际代码理解该场景。

使用前检查清单

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

容易混淆 / 常见误区

仅能影响CSR的位0~4,高位的设置需用CSRRS配合寄存器
uimm=0时光读不写是所有CSRRSI中的特例,不可依赖uimm=0来'清零'某位
每次执行都会产生CSR读副作用

常见问题

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

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

rd=x0 有什么影响?

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