RVOPcode
Back To CSR WorkbenchView In Register Browser
CSR Bit Fields

RISC-V mhpmcounter17 CSR Register

Address 0xB11Privilege MachineAccess RW / 64Machine counters and performance-monitoring CSRs

mhpmcounter17 at 0xB11 is machine hardware performance-monitor counter 17, a 64-bit counter for the event selected by mhpmevent17.

Related Search Terms
mhpmcounter17 CSRmhpmcounter17 0xB11HPM counter 17mhpmevent17 eventmachine performance counter64-bit count
Bit Overview
bit 3 = only bit 3; bits 12..11 = bits 12 down to 11
MSBLSB
COUNT63:0RW
Field Map

Understand mhpmcounter17 By Bit Fields

1 key fields
63:0

COUNT

RW

64-bit machine HPM count for the event selected by mhpmevent17; an unimplemented counter may read as zero.

COUNT (bits 63:0) — 64-bit machine HPM count for the event selected by mhpmevent17; an unimplemented counter may read as zero.

What This Field Controls

  • - 64-bit machine HPM count for the event selected by mhpmevent17; an unimplemented counter may read as zero.

Common Values

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

Official Basis & Search Notes

mhpmcounter17 is machine HPM counter 17. It does not define event meaning by itself; it counts the platform-defined event currently selected by mhpmevent17.

The official Machine HPM mechanism provides mhpmcounter17 as a writable machine counter.
mhpmevent17 selects the event; event numbers are platform-defined.
On RV32, mhpmcounter17h provides access to the upper 32 bits.
RISC-V Privileged Architecture Manual: CSR ListingRISC-V Privileged Architecture Manual: Machine-Level ISA

What To Check First When Reading This CSR

  • - The event source for mhpmcounter17 is determined by mhpmevent17; check the event-selector configuration first.
  • - Accessibility of the lower-privilege shadow hpmcounter17 is controlled by mcounteren/scounteren or relevant delegation mechanisms.
  • - On RV32, mhpmcounter17h accesses bits 63:32 of mhpmcounter17.

Risk Checks Before Writing

  • - Writing mhpmcounter17 changes the current counter value and should usually be done only during initialization, sample reset, or overflow handling.
  • - Use mcountinhibit.HPM17 or event/mode-filtering controls to stop counting rather than writing unknown event encodings.
  • - Multi-hart or platform sharing details must come from target implementation documentation.

Put It Back Into A Real Flow

1

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

2

Use mcountinhibit.HPM17 or xINH bits when needed to control the counting window.

3

Read mhpmcounter17 and, on RV32, mhpmcounter17h to obtain the 64-bit event count.

FAQ

Can mhpmcounter17 be accessed from any privilege level?

No. The official CSR table lists mhpmcounter17 as a Machine mode CSR. Lower-privilege software may access the corresponding state only when a relevant standard extension provides an explicit delegation or permission mechanism. Direct CSR access with insufficient privilege, or to an unimplemented CSR, raises an illegal-instruction exception.

How is mhpmcounter17 related to hpmcounter17?

mhpmcounter17 is the machine readable/writable view; hpmcounter17 is the corresponding lower-privilege counter view, and its readability is controlled by counteren or delegation mechanisms.