RVOPcode
Back To CSR WorkbenchView In Register Browser
CSR Bit Fields

RISC-V hpmcounter29 CSR Register

Address 0xC1DPrivilege UserAccess RO / XLENUser counters and performance-monitoring CSRs

hpmcounter29 is a Zihpm user-level read-only hardware performance counter for implementation-defined event counts. Zihpm depends on Zicsr.

Related Search Terms
hpmcounter29 CSRhpmcounter29 0xC1DHPM counter 29hardware performance counter 29mcounteren HPM29mhpmevent29
Bit Overview
bit 3 = only bit 3; bits 12..11 = bits 12 down to 11
MSBLSB
VALUE63:0RO
Field Map

Understand hpmcounter29 By Bit Fields

1 key fields
XLEN-1:0

VALUE

RO

Read-only shadow of mhpmcounter29. Machine HPM counters support up to 64 bits; this CSR returns the low XLEN bits on RV32/RV64.

VALUE (bits XLEN-1:0) — Read-only shadow of mhpmcounter29. Machine HPM counters support up to 64 bits; this CSR returns the low XLEN bits on RV32/RV64.

What This Field Controls

  • - Read-only shadow of mhpmcounter29. Machine HPM counters support up to 64 bits; this CSR returns the low XLEN bits on RV32/RV64.

Common Values

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

↗Open Official Manual
Official Basis & Search Notes

hpmcounter29 is a RO CSR in user counters and performance-monitoring csrs at 0xC1D. Check privilege and implemented extensions before interpreting its bit fields.

hpmcounter29 address, lowest access privilege, and access class are checked against the official CSR table: 0xC1D, User, RO.
hpmcounter29 is a read-only shadow of mhpmcounter29; U-mode access requires both mcounteren.HPM29 and scounteren.HPM29 to permit it.
The implementation-defined mhpmevent29 selects the incrementing event; a legal implementation may make both this counter and its selector read-only zero.
RISC-V Privileged Architecture ManualRISC-V Unprivileged ISA Manual

What To Check First When Reading This CSR

  • - Confirm that the current hart implements hpmcounter29; accessing an unimplemented counter may raise an illegal-instruction exception or return a constant value.
  • - Use address 0xC1D and the lowest access privilege (User) to decide whether software may read it directly.
  • - U-mode reads require both mcounteren.HPM29 and scounteren.HPM29 to permit access. With V=1, hcounteren.HPM29=0 and mcounteren.HPM29=1 cause a virtual-instruction exception in VS-mode; VU-mode additionally requires scounteren.HPM29=1.

Risk Checks Before Writing

  • - hpmcounter29 is a read-only CSR; writes raise an illegal-instruction exception.

Put It Back Into A Real Flow

1

Read hpmcounter29 to obtain hardware or runtime state.

2

Interpret the returned value according to the field descriptions and do not attempt to write it back.

3

If reading fails at the current privilege level, handle the illegal-instruction exception path.

FAQ

Can hpmcounter29 be accessed from any privilege level?

Do not decide from the CSR name alone. The official CSR address encoding and tables define the lowest access privilege; this entry records hpmcounter29 as User. Access with insufficient privilege or to an unimplemented CSR raises an illegal-instruction exception.

What is easiest to miss when using hpmcounter29?

hpmcounter29 is a read-only shadow CSR. Check both HPM29 counter-enable bits; the platform defines the event selected by mhpmevent29.