xref: /freebsd-src/sys/contrib/device-tree/Bindings/perf/spe-pmu.yaml (revision d5b0e70f7e04d971691517ce1304d86a1e367e2e)
1*d5b0e70fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*d5b0e70fSEmmanuel Vadot%YAML 1.2
3*d5b0e70fSEmmanuel Vadot---
4*d5b0e70fSEmmanuel Vadot$id: http://devicetree.org/schemas/perf/spe-pmu.yaml#
5*d5b0e70fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*d5b0e70fSEmmanuel Vadot
7*d5b0e70fSEmmanuel Vadottitle: ARMv8.2 Statistical Profiling Extension (SPE) Performance Monitor Units (PMU)
8*d5b0e70fSEmmanuel Vadot
9*d5b0e70fSEmmanuel Vadotmaintainers:
10*d5b0e70fSEmmanuel Vadot  - Will Deacon <will@kernel.org>
11*d5b0e70fSEmmanuel Vadot
12*d5b0e70fSEmmanuel Vadotdescription:
13*d5b0e70fSEmmanuel Vadot  ARMv8.2 introduces the optional Statistical Profiling Extension for collecting
14*d5b0e70fSEmmanuel Vadot  performance sample data using an in-memory trace buffer.
15*d5b0e70fSEmmanuel Vadot
16*d5b0e70fSEmmanuel Vadotproperties:
17*d5b0e70fSEmmanuel Vadot  compatible:
18*d5b0e70fSEmmanuel Vadot    const: arm,statistical-profiling-extension-v1
19*d5b0e70fSEmmanuel Vadot
20*d5b0e70fSEmmanuel Vadot  interrupts:
21*d5b0e70fSEmmanuel Vadot    maxItems: 1
22*d5b0e70fSEmmanuel Vadot    description: |
23*d5b0e70fSEmmanuel Vadot      The PPI to signal SPE events. For heterogeneous systems where SPE is only
24*d5b0e70fSEmmanuel Vadot      supported on a subset of the CPUs, please consult the arm,gic-v3 binding
25*d5b0e70fSEmmanuel Vadot      for details on describing a PPI partition.
26*d5b0e70fSEmmanuel Vadot
27*d5b0e70fSEmmanuel VadotadditionalProperties: false
28*d5b0e70fSEmmanuel Vadot
29*d5b0e70fSEmmanuel Vadotrequired:
30*d5b0e70fSEmmanuel Vadot  - compatible
31*d5b0e70fSEmmanuel Vadot  - interrupts
32*d5b0e70fSEmmanuel Vadot
33*d5b0e70fSEmmanuel Vadotexamples:
34*d5b0e70fSEmmanuel Vadot  - |
35*d5b0e70fSEmmanuel Vadot    #include <dt-bindings/interrupt-controller/arm-gic.h>
36*d5b0e70fSEmmanuel Vadot
37*d5b0e70fSEmmanuel Vadot    spe-pmu {
38*d5b0e70fSEmmanuel Vadot        compatible = "arm,statistical-profiling-extension-v1";
39*d5b0e70fSEmmanuel Vadot        interrupts = <GIC_PPI 5 IRQ_TYPE_LEVEL_HIGH>;
40*d5b0e70fSEmmanuel Vadot    };
41