首页/指令库/CSR读后置位
CSRRS

RISC-V CSRRS 指令详解

指令手册I-type

读CSR旧值到rd,以rs1为掩码原子地置位CSR中对应位,支持只读不写模式

指令语法

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

指令编码

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

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

格式: I-type
opcode: 1110011 (0x73)
funct3: 010 (0x2)

指令行为说明

CSRRS指令以原子读-改-写方式操作CSR:将CSR当前值零扩展至XLEN位后写入rd,再以rs1的值作为位掩码,将rs1中为1的位在CSR中对应置位(若该位可写)。若rs1=x0,则指令完全不写CSR,不产生任何写副作用,也不会触发只读CSR的非法指令异常——此时CSRRS退化为纯读操作。汇编伪指令CSRR(rd, csr)即编码为CSRRS rd, csr, x0。典型用途是原子性地设置中断使能位等独立控制域。

快速理解与检索要点

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

常见使用场景

原子与同步

结合 «csrrs x5, mstatus, x6 # x5 = old mstatus; set bits in mstatus per x6» 等实际代码理解该场景。

系统与特权

结合 «csrrs x5, mstatus, x6 # x5 = old mstatus; set bits in mstatus per x6» 等实际代码理解该场景。

使用前检查清单

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

容易混淆 / 常见误区

rs1=x0时仅读取但不修改CSR,但CSR的字段读副作用仍然触发
即使rs1中为0的位,其对应的CSR位在RMW中可能被隐式修改(如读回值与底层值不一致的位)
伪指令CSRS csr, rs1等价于CSRRS x0, csr, rs1(只设位不读旧值)

常见问题

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

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

rd=x0 有什么影响?

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