CSR 位字段

RISC-V vsscratch CSR 寄存器详解

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

vsscratch 保存guest trap 处理程序 scratch 值,是对应 supervisor CSR 的 VS 副本。

字段映射

按 bit 字段理解 vsscratch

1 个关键字段
VSXLEN-1:0

SCRATCH

读写

vsscratch 的 guest trap 处理程序 scratch 值;具体字段沿用对应 supervisor CSR 的 VS 副本语义。

这个字段控制什么

  • - vsscratch 的 guest trap 处理程序 scratch 值;具体字段沿用对应 supervisor CSR 的 VS 副本语义。

常见取值

这个字段更适合结合上下文字段解释,不用按固定枚举背诵。

打开官方手册
官方依据与检索要点

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

vsscratch 的地址、访问类和宽度按官方 CSR 表核对:0x240,HRW(Hypervisor 读写),VSXLEN。
H 扩展规定 V=1 时相应 supervisor CSR 访问替代到 VS CSR。
写入时只修改官方定义字段;WARL/WLRL/WPRI 和保留字段按官方规范与实现行为处理。

读这个 CSR 时先看什么

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

写入前的风险检查

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

放回真实流程里理解

1

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

2

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

3

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

常见问题

vsscratch 的独立地址能由 VS-mode 直接访问吗?

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

vsscratch 主要保存什么?

vsscratch 保存 guest trap 处理程序 scratch 值,供 hypervisor 管理 guest supervisor 的 trap、状态或执行上下文。