CSR 位字段

RISC-V hcontext CSR 寄存器详解

地址 0x6A8特权级 Hypervisor访问 HRW(Hypervisor 读写) / HSXLENHypervisor 与虚拟化 CSR

hcontext 是Hypervisor context CSR。

字段映射

按 bit 字段理解 hcontext

1 个关键字段
HSXLEN-1:0

HYPERVISOR_CONTEXT_VALUE_FOR_DEBUG/TRACE

读写

hcontext 的调试/跟踪使用的 hypervisor context 值。

这个字段控制什么

  • - hcontext 的调试/跟踪使用的 hypervisor context 值。

常见取值

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

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

hcontext 是 Hypervisor context CSR。它是 HS/M 侧的 Hypervisor 状态,不是 VS supervisor CSR 副本;guest 访问是否允许由 H 扩展和相关 state-enable/AIA/Sstc/Smcsrind 规则决定。

hcontext 的地址、访问类和宽度按官方 CSR 表核对:0x6A8,HRW(Hypervisor 读写),HSXLEN。
hcontext 的字段含义按 Hypervisor 扩展对应章节解释;未实现字段不能当作固定可写位。
写入时只修改官方定义字段;WARL/WLRL/WPRI 和保留字段按官方规范与实现行为处理。

读这个 CSR 时先看什么

  • - hcontext 是 Hypervisor 级 CSR;独立地址按官方表属于 HRW(Hypervisor 读写) 访问类。
  • - guest/VS 软件不能通过 supervisor CSR alias 访问该 H-level CSR;相关访问由 H 扩展和可选扩展规则控制。

写入前的风险检查

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

放回真实流程里理解

1

确认当前软件运行在可访问 Hypervisor CSR 的 M/HS 上下文。

2

确认定义该 CSR 的 H/AIA/Sstc/Smstateen/Smcsrind 等扩展已经实现。

3

按官方字段读写;guest 相关访问是否通过或 trap 由对应扩展规则和 state-enable 控制。

常见问题

hcontext 能通过 supervisor CSR alias 访问吗?

不能把 hcontext 当作 VS CSR 副本。它是 H-level CSR;guest/VS 访问相关功能时是否 trap 由 H 扩展和对应可选扩展规则决定。