CSR Bit Fields

RISC-V mhpmcounter25 CSR Register

Address 0xB19Privilege MachineAccess RW / up to 64-bit precisionMachine counters and performance-monitoring CSRs

mhpmcounter25 at 0xB19 is machine hardware performance-monitor counter 25, a WARL counter with up to 64 bits of precision for the platform-defined event selected by mhpmevent25.

Field Map

Understand mhpmcounter25 By Bit Fields

1 key fields
63:0

COUNT

RW

Machine HPM count for the platform-defined event selected by mhpmevent25. COUNT is a WARL field with up to 64 bits of precision on RV32 and RV64; a legal implementation may make both this counter and mhpmevent25 read-only zero.

COUNT (bits 63:0) — Machine HPM count for the platform-defined event selected by mhpmevent25. COUNT is a WARL field with up to 64 bits of precision on RV32 and RV64; a legal implementation may make both this counter and mhpmevent25 read-only zero.

What This Field Controls

  • - Machine HPM count for the platform-defined event selected by mhpmevent25. COUNT is a WARL field with up to 64 bits of precision on RV32 and RV64; a legal implementation may make both this counter and mhpmevent25 read-only zero.

Common Values

This field is better understood together with surrounding context than as a fixed memorized enumeration.

Official Basis & Search Notes

mhpmcounter25 is machine HPM counter 25. It does not define event meaning by itself; it counts the platform-defined event currently selected by mhpmevent25 with up to 64 bits of precision.

The official Machine HPM mechanism defines mhpmcounter25 as a WARL counter with up to 64 bits of precision.
mhpmevent25 selects the event; event numbers are platform-defined.
On RV32, mhpmcounter25h provides access to the upper 32 bits.

What To Check First When Reading This CSR

  • - The event source for mhpmcounter25 is determined by mhpmevent25; check the event-selector configuration first.
  • - S/U-mode reads of the read-only hpmcounter25 shadow are controlled by mcounteren.HPM25; U-mode additionally requires scounteren.HPM25.
  • - On RV32, mhpmcounter25h accesses bits 63:32 of mhpmcounter25.

Risk Checks Before Writing

  • - A write to mhpmcounter25 takes effect after the writing instruction has otherwise completed and changes the current count.
  • - When mcountinhibit.HPM25 is set, the counter does not increment; that bit controls incrementing, not accessibility.

Put It Back Into A Real Flow

1

Configure mhpmevent25 to select the platform-defined event to count.

2

Use mcountinhibit.HPM25 when needed to control the counting window.

3

Read mhpmcounter25 and, on RV32, mhpmcounter25h to obtain the event count with up to 64 bits of precision.

FAQ

Can mhpmcounter25 be accessed from any privilege level?

No. The CSR table lists mhpmcounter25 as a machine read/write CSR. Lower-privilege access is to the corresponding read-only hpmcounter25 view: S/U-mode reads are controlled by mcounteren.HPM25, and U-mode reads are additionally controlled by scounteren.HPM25. A disallowed read raises an illegal-instruction exception.

How is mhpmcounter25 related to hpmcounter25?

mhpmcounter25 is the machine read/write counter; hpmcounter25 is its corresponding lower-privilege read-only shadow. S/U-mode reads are controlled by mcounteren.HPM25, and U-mode reads are additionally controlled by scounteren.HPM25.