RVOPcode
返回 CSR 工作台在寄存器总览中查看
CSR 位字段

RISC-V mcause CSR 寄存器详解

地址 0x342特权级 M模式访问 读写 / XLENMachine 状态、trap 与中断 CSR

机器陷阱原因寄存器，记录触发陷阱的事件类型和原因码。

相关检索词
mcause CSRmcause 0x342Machine trap 原因mcause exception codemcause interrupt bitRISC-V mcause
位作用速览
bit 3 = 只有第 3 位；bits 12..11 = 第 12 到第 11 位
高位 MSB低位 LSB
Interrupt63写合法读合法Exception Code62:0写合法读合法
字段映射

按 bit 字段理解 mcause

2 个关键字段
XLEN-1

Interrupt

写合法读合法

1=中断，0=异常；作为 cause 值的一部分按合法值语义处理。

这个字段控制什么

  • - 1=中断，0=异常；作为 cause 值的一部分按合法值语义处理。

常见取值

00

这是同步异常，低位字段按异常原因码解释。

11

这是中断，低位字段按中断原因码解释。

XLEN-2:0

Exception Code

写合法读合法

原因码；软件不能假定任意写入的原因码都会保持，必须按官方和实现支持的合法值解释。

这个字段控制什么

  • - 原因码；软件不能假定任意写入的原因码都会保持，必须按官方和实现支持的合法值解释。

常见取值

同步异常
0指令地址未对齐

同步异常原因码 0。

1指令访问错误

同步异常原因码 1。

2非法指令

同步异常原因码 2。

3断点

同步异常原因码 3。

4Load 地址未对齐

同步异常原因码 4。

5Load 访问错误

同步异常原因码 5。

6Store/AMO 地址未对齐

同步异常原因码 6。

7Store/AMO 访问错误

同步异常原因码 7。

8U 模式环境调用

同步异常原因码 8。

9S 模式环境调用

同步异常原因码 9。

11M 模式环境调用

同步异常原因码 11。

12指令页错误

同步异常原因码 12。

13Load 页错误

同步异常原因码 13。

15Store/AMO 页错误

同步异常原因码 15。

16双重陷阱

同步异常原因码 16，由 Smdbltrp 扩展定义。

18软件检查

同步异常原因码 18。

19硬件错误

同步异常原因码 19。

中断
1Supervisor 软件中断

当 Interrupt 位为 1 时，低位原因码 1 表示 Supervisor 软件中断。

3Machine 软件中断

当 Interrupt 位为 1 时，低位原因码 3 表示 Machine 软件中断。

5Supervisor 定时器中断

当 Interrupt 位为 1 时，低位原因码 5 表示 Supervisor 定时器中断。

7Machine 定时器中断

当 Interrupt 位为 1 时，低位原因码 7 表示 Machine 定时器中断。

9Supervisor 外部中断

当 Interrupt 位为 1 时，低位原因码 9 表示 Supervisor 外部中断。

11Machine 外部中断

当 Interrupt 位为 1 时，低位原因码 11 表示 Machine 外部中断。

13计数器溢出中断

当 Interrupt 位为 1 时，低位原因码 13 表示计数器溢出中断。

官方依据与检索要点

mcause 是 Machine 状态、trap 与中断 CSR 中的 读写 CSR，地址为 0x342。先确认当前特权级和扩展实现情况，再根据位字段判断该 CSR 影响的架构状态。

mcause 的地址、最低访问特权级和读写属性按官方 CSR 表核对：0x342，M模式，读写。
先按 Machine 状态、trap 与中断 CSR 理解它影响的架构状态，再看页面中的位字段说明。
写入前只修改目标字段并保留未修改位；WPRI/保留字段应按官方规范和实现返回值解释。
RISC-V Privileged Architecture ManualRISC-V Unprivileged ISA Manual

读这个 CSR 时先看什么

  • - 先确认当前 hart 是否实现 mcause，未实现或权限不足的访问会触发非法指令异常。
  • - 结合地址 0x342 和最低访问特权级（Machine）判断软件是否可以直接读取。
  • - 读取保留位或 WARL/WLRL 位时不要假设固定值，应按规范和实现返回值解释。

写入前的风险检查

  • - 写入前保留未修改的位，避免把保留位或实现定义位写成非规范值。
  • - 优先使用 CSRRS/CSRRC 做局部置位或清位，避免 CSRRW 覆盖并发更新的状态位。

放回真实流程里理解

1

初始化或进入相关特权流程时，软件先读取 mcause 了解当前状态。

2

根据字段定义只修改目标位，保留其余位的原值。

3

修改后再次读取或通过后续 trap/中断/上下文切换行为验证配置是否生效。

常见问题

mcause 可以在任意特权级访问吗？

不能只看 CSR 名称判断。官方 CSR 地址编码和表格给出最低访问特权级；mcause 当前记录为 M模式，权限不足或未实现时访问会触发非法指令异常。

写 mcause 时最容易忽略什么？

不要把整个 CSR 当普通整数覆盖。应只修改目标字段，保留未修改位，并按规范处理 WARL、WLRL、WPRI 或保留字段。