CSR 位字段

RISC-V vscause CSR 寄存器详解

地址 0x242特权级 Hypervisor 直接访问 / VS 别名访问访问 HRW（Hypervisor 读写） / VSXLENHypervisor 与虚拟化 CSR

vscause 保存guest trap 中断标志和原因码，是对应 supervisor CSR 的 VS 副本。

按 bit 字段理解 vscause

2 个关键字段

VSXLEN-1

Interrupt

读写

指示 vscause 低位原因码表示中断还是同步异常。

这个字段控制什么

- 指示 vscause 低位原因码表示中断还是同步异常。

常见取值

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

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

↗打开官方手册

VSXLEN-2:0

Exception Code

读写

VS trap 原因码；同步异常与中断用 Interrupt 位区分。ECALL 原因码按官方 Supervisor/Hypervisor trap cause 表区分：9 是 S/HS-mode，10 是 VS-mode。这里不把 HS trap-specific 或 G-stage 专用原因当作普通 VS scause substitute 原因列入。

这个字段控制什么

- VS trap 原因码；同步异常与中断用 Interrupt 位区分。ECALL 原因码按官方 Supervisor/Hypervisor trap cause 表区分：9 是 S/HS-mode，10 是 VS-mode。这里不把 HS trap-specific 或 G-stage 专用原因当作普通 VS scause substitute 原因列入。

常见取值

同步异常

0指令地址未对齐

同步异常原因码 0。

1指令访问错误

同步异常原因码 1。

2非法指令

同步异常原因码 2。

3断点

同步异常原因码 3。

4Load 地址未对齐

同步异常原因码 4。

5Load 访问错误

同步异常原因码 5。

6Store/AMO 地址未对齐

同步异常原因码 6。

7Store/AMO 访问错误

同步异常原因码 7。

8VU 模式环境调用

同步异常原因码 8。

9S/HS 模式环境调用

同步异常原因码 9。启用 Hypervisor 扩展时，官方表将 VS-mode 环境调用分配为原因码 10，因此 9 不能解释为 VS-mode ECALL。

10VS 模式环境调用

同步异常原因码 10；这是启用 Hypervisor 扩展时官方定义的 VS-mode 环境调用原因码。

12指令页错误

同步异常原因码 12。

13Load 页错误

同步异常原因码 13。

15Store/AMO 页错误

同步异常原因码 15。

18软件检查

同步异常原因码 18。

19硬件错误

同步异常原因码 19。

中断

1VS 软件中断

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

5VS 定时器中断

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

9VS 外部中断

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

13计数器溢出中断

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

↗打开官方手册

官方依据与检索要点

vscause 是 VS supervisor 状态/Trap CSR。独立 CSR 地址用于 M/HS 侧管理；当 V=1 时，guest 对相应 supervisor CSR 的访问会替代到 VS 状态，除非官方扩展另有规定。

vscause 的地址、访问类和宽度按官方 CSR 表核对：0x242，HRW（Hypervisor 读写），VSXLEN。

H 扩展规定 V=1 时相应 supervisor CSR 访问替代到 VS CSR。

写入时只修改官方定义字段；WARL/WLRL/WPRI 和保留字段按官方规范与实现行为处理。

RISC-V Privileged Architecture Manual - CSR table RISC-V Privileged Architecture Manual - Hypervisor extension

读这个 CSR 时先看什么

- vscause 的独立 CSR 地址按官方表属于 HRW（Hypervisor 读写）访问类；VS/VU guest 通常通过对应 supervisor CSR 别名访问 VS 状态。
- 读取前确认 H/AIA/Sstc/Smstateen/Smcsrind 等定义该 CSR 的扩展已经实现。

写入前的风险检查

- 写 vscause 时只修改官方定义的目标字段，并保留 WPRI、保留位和未修改字段。

放回真实流程里理解

M/HS 软件可通过独立 CSR 地址访问 vscause 的 VS 副本。

当 V=1 时，guest 访问 scause 类 supervisor CSR 会替代到对应 VS 状态；直接访问独立 VS CSR 地址会触发 virtual-instruction exception。

按官方字段更新，不把 VS 状态混同为普通 HS supervisor 状态。

常见问题

vscause 的独立地址能由 VS-mode 直接访问吗？

不能。H 扩展规定 V=1 时 guest 通过对应 supervisor CSR 别名访问 VS 状态；直接读写独立 VS CSR 地址会触发 virtual-instruction exception。

vscause 主要保存什么？

vscause 保存 guest trap 中断标志和原因码，供 hypervisor 管理 guest supervisor 的 trap、状态或执行上下文。