CSR 位字段

RISC-V hgeip CSR 寄存器详解

地址 0xE12特权级 Hypervisor访问 HRO（Hypervisor 只读） / HSXLENHypervisor 与虚拟化 CSR

hgeip 是Hypervisor guest external 中断待定 CSR。

按 bit 字段理解 hgeip

1 个关键字段

HSXLEN-1:1

GUEST_EXTERNAL_INTERRUPT-PENDING_BITS

只读

hgeip 的guest external 中断挂起位。

这个字段控制什么

- hgeip 的guest external 中断挂起位。

常见取值

implemented GEILEN source bit

0未挂起

仅对实现的 hgeip[GEILEN:1] 位：对应 guest external interrupt source 未挂起；未实现或其他位按官方 WPRI/只读零等规则处理。

1挂起

仅对实现的 hgeip[GEILEN:1] 位：对应 guest external interrupt source 挂起；递送还取决于 hgeie、hstatus.VGEIN 和相关虚拟化状态。

↗打开官方手册

官方依据与检索要点

hgeip 是 Hypervisor guest external 中断待定 CSR。它是 HS/M 侧的 Hypervisor 状态，不是 VS supervisor CSR 副本；guest 访问是否允许由 H 扩展和相关 state-enable/AIA/Sstc/Smcsrind 规则决定。

hgeip 的地址、访问类和宽度按官方 CSR 表核对：0xE12，HRO（Hypervisor 只读），HSXLEN。

hgeip 的字段含义按 Hypervisor 扩展对应章节解释；未实现字段不能当作固定可写位。

hgeip 是只读 CSR；读取到的保留位或实现定义值只按官方规范和实现行为解释。

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

读这个 CSR 时先看什么

- hgeip 是 Hypervisor 级 CSR；独立地址按官方表属于 HRO（Hypervisor 只读）访问类。
- guest/VS 软件不能通过 supervisor CSR alias 访问该 H-level CSR；相关访问由 H 扩展和可选扩展规则控制。

写入前的风险检查

- hgeip 是只读 CSR；软件不应写入。

放回真实流程里理解

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

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

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

常见问题

hgeip 能通过 supervisor CSR alias 访问吗？

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