arm-software / data

Machine-readable data describing Arm architecture and implementations. Includes JSON descriptions of implemented PMU events.

Machine-readable data

pmu

This repository contains JSON descriptions of hardware performance events for Arm cores.

This repository is currently "beta" quality. Arm encourages use and evaluation but the data, and the data format, are subject to change.

Arm welcomes feedback on this repository via the issue tracker.

PMU data schema

The JSON schema is in pmu/pmu-schema.json. Briefly, each JSON file contains a list of events, each event being described by a JSON object:

        {
            "code": 1,
            "name": "L1I_CACHE_REFILL",
            "architectural": false,
            "type": "UEVT",
            "subtype": "REFILL",
            "component": "L1I",
            "event_bits": 1,
            "event_lsb": 0,
            "trace_lsb": 1,
            "description": "Level 1 instruction cache refill"
        },

The "type" field classfies the event:

type	meaning
INS	Instruction of a certain type executed
UEVT	Microarchitectural event
CYCLE	Counts number of cycles during which a condition is true
EXC	Exception of a certain type

For microarchitectural events the "component" field indicates the core component that the event relates to:

	component
L1I	L1 I-cache
L1D	L1 D-cache
L2	L2 cache
BPU	Branch predictor
L1ITLB	L1 instruction TLB
L1DTLB	L1 data TLB
BUS	Core bus interface

The "subtype" field may be present to classify the event further, e.g. into READ, WRITE, ACCESS and REFILL cache events.

For events exported on the external event bus, and/or to the ETM, the position of the event on the bus is shown.

data's Issues

[TMA] Is there a metrics table about TopDown microarchitecture Analysis in ARM chipset?

If we want to make a TMA tool on one ARM chipset, we need a TMA metrics table like following:
https://download.01.org/perfmon/TMA_Metrics.xlsx

In Linux perf tool, some chipset vendor has given their own TMA metrics, is it suitable for all the other ARM chipsets?
https://github.com/torvalds/linux/blob/master/tools/perf/pmu-events/arch/arm64/hisilicon/hip08/metrics.json

Great Start. Thank you Arm.

This is a good start. I believe quite a few people may be working on parsing the definitions here to integrate with their tools. For us, we would like to derive the definitions in executable code here and also compute derived metrics in a consistent manner. I am wondering if others are having the same need.

schema

Unfortunately the schema used is not consistent with mainline linux perf tool.