RISC-V hgeie CSR Register

Address 0x607Privilege HypervisorAccess HRW / HSXLENHypervisor and virtualization CSRs

hgeie is a Hypervisor guest external interrupt-enable CSR.

Related Search Terms

hgeie CSR hgeie 0x607 guest external interrupt-enable bits Hypervisor

Bit Overview

Hover for details · Click to jump↗Open Official Manual

bit 3 = only bit 3; bits 12..11 = bits 12 down to 11

MSBLSB

GUEST_EXTERNAL_INTERRUPT-ENABLE_BITS63:1RWReserved0

Field Map

Understand hgeie By Bit Fields

1 key fields

GEILEN:1

GUEST_EXTERNAL_INTERRUPT-ENABLE_BITS

GEILEN is an unspecified implemented-bit count and may be zero. If GEILEN is nonzero, bits GEILEN:1 are writable; bit 0 and every other position in hgeie are read-only zero.

GUEST_EXTERNAL_INTERRUPT-ENABLE_BITS (bits GEILEN:1) — GEILEN is an unspecified implemented-bit count and may be zero. If GEILEN is nonzero, bits GEILEN:1 are writable; bit 0 and every other position in hgeie are read-only zero.

What This Field Controls

- GEILEN is an unspecified implemented-bit count and may be zero. If GEILEN is nonzero, bits GEILEN:1 are writable; bit 0 and every other position in hgeie are read-only zero.

Common Values

0Disabled

Only for implemented hgeie[GEILEN:1] bits: that bit does not participate in causing an HS-level guest external interrupt; GEILEN may be zero, and bit 0 and all other positions are read-only zero.

1Enabled

Only for implemented hgeie[GEILEN:1] bits: when the same hgeip bit is pending, it participates in setting hip.SGEIP; it does not affect the VS-level external interrupt signal selected by hstatus.VGEIN.

↗Open Official Manual

Official Basis & Search Notes

hgeie is a Hypervisor guest external interrupt-enable CSR. It is HS/M-side hypervisor state, not a VS supervisor CSR copy; guest access is governed by the H extension and relevant state-enable, AIA, Sstc, or Smcsrind rules.

hgeie address, access class, and width are checked against the official CSR tables: 0x607, HRW, HSXLEN.

hgeie fields are interpreted by the corresponding Hypervisor extension section; unimplemented fields must not be treated as fixed writable bits.

When writing, modify only officially defined fields; handle WARL, WLRL, WPRI, and reserved fields according to the official specification and implementation behavior.

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

What To Check First When Reading This CSR

- hgeie is a Hypervisor-level CSR; its separate address is in the official HRW access class.
- Guest/VS software does not reach this H-level CSR through a supervisor CSR alias; access is controlled by the H extension and relevant optional-extension rules.

Risk Checks Before Writing

- GEILEN may be zero; write only implemented GEILEN:1 bits, because bit 0 and all other positions are read-only zero.

Put It Back Into A Real Flow

Confirm the current software is in an M/HS context that may access Hypervisor CSRs.

Confirm that the H, AIA, Sstc, Smstateen, Smcsrind, or other defining extension is implemented.

Read or write only official fields; whether guest-related access succeeds or traps is controlled by the corresponding extension rules and state-enable state.

FAQ

Can hgeie be accessed through a supervisor CSR alias?

Do not treat hgeie as a VS CSR copy. It is an H-level CSR; whether guest/VS access to related functionality traps is defined by the H extension and the relevant optional extension.