Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
101 lines (77 sloc) 4.03 KB

Micro-architectural Event Tracking

Version 1.9.1 of the RISC-V Privileged Architecture adds support for Hardware Performance Monitor (HPM) counters. [1] The HPM support allows a nearly infinite number of micro-architectural events (called Hardware Performance Events (HPEs)) to be multiplexed onto up to multiple physical counters (called Hardware Performance Counters (HPCs)).

Setup HPM events to track

The available HPE's are split into event sets and events. Event sets are groupings of similar microarchitectural events (branch prediction events, memory events, etc). To access an HPE you must choose the correct event set and event bit and write to the proper HPE register for that event. An example of event set numbers and the event bit for a particular event is given below.

Event Set # Event Bit Description
1 1 I$ Blocked
1 2 NOP
1 4 Control Flow Target Mispredict

To access an HPC, you must first set up the privilege access level of the particular HPC using mcounteren and scounteren. Afterwards, you write to the particular HPE register to setup which event(s) you want to track. The value to write to the HPE register is in bits [7:0] the event set and in bits [?:8] the event bitmask. Note that the bitmask can be a singular event or multiple events.

Reading HPM counters in software

The Code Example :numref:`read-csr` demonstrates how to read the value of any HPC from software. Note that HPCs need to be "zero'd" out by first reading the value at the beginning of the program, then reading the counter again the end, and then subtracting the initial value from the second read. However, this only applies to the HPC's not cycle, instret, and time.

Adding your own HPE

To add your own HPE, you modify the event set and particular event in src/main/scala/exu/core.scala. Note that the 1st item in the Seq corresponds to the first bit in the event set.

External Resources

Information in this section was adapted from which details more about HPE/C's from RocketChip's perspective.

[1]Future efforts may add some counters into a memory-mapped access region. This will open up the ability to track events that, for example, may not be tied to any particular core (like last-level cache misses).