CSR Bit Fields

RISC-V time CSR Register

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

time is a user-level timer CSR for the value visible through RDTIME.

Field Map

Understand time By Bit Fields

1 key fields
XLEN-1:0

VALUE

RO

Full register value of time; bits not split out here follow the relevant extension or privileged specification, and reserved or WPRI fields should be preserved when writing other fields and ignored on reads.

VALUE (bits XLEN-1:0) — Full register value of time; bits not split out here follow the relevant extension or privileged specification, and reserved or WPRI fields should be preserved when writing other fields and ignored on reads.

What This Field Controls

  • - Full register value of time; bits not split out here follow the relevant extension or privileged specification, and reserved or WPRI fields should be preserved when writing other fields and ignored on reads.

Common Values

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

Official Basis & Search Notes

time is the user-level read-only timer CSR at 0xC01, visible through RDTIME. Lower-privilege visibility can depend on counter-enable CSRs.

time address, lowest access privilege, and access class are checked against the official CSR table: 0xC01, User, RO.
time reads the timer value; do not confuse it with cycle counts or instret retired-instruction counts.
This is a read-only CSR; do not write it. Ignore reserved or WPRI field values on reads, and preserve those fields when writing other writable fields in the same CSR.

What To Check First When Reading This CSR

  • - First confirm that the current hart implements time; unimplemented or insufficiently privileged accesses raise an illegal-instruction exception.
  • - Use address 0xC01 and the lowest access privilege (User) to decide whether software may read it directly.
  • - Do not assume fixed values for reserved, WARL, or WLRL bits; interpret the value according to the specification and implementation.

Risk Checks Before Writing

  • - time is a read-only CSR; writes raise an illegal-instruction exception or are disallowed by the implementation.

Put It Back Into A Real Flow

1

Read time 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 time 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 time as User. Access with insufficient privilege or to an unimplemented CSR raises an illegal-instruction exception.

What is easiest to miss when using time?

time is read-only. Treat it as an observation point, do not try to write it, and do not depend on fixed values for reserved or WPRI fields.