Documentation/devicetree/bindings/arm/arm,trace-buffer-extension.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/arm/arm,trace-buffer-extension.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/arm/arm,trace-buffer-extension.yaml
Extension
.yaml
Size
1241 bytes
Lines
51
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
# Copyright 2021, Arm Ltd
%YAML 1.2
---
$id: http://devicetree.org/schemas/arm/arm,trace-buffer-extension.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: ARM Trace Buffer Extensions

maintainers:
  - Anshuman Khandual <anshuman.khandual@arm.com>

description: |
  Arm Trace Buffer Extension (TRBE) is a per CPU component
  for storing trace generated on the CPU to memory. It is
  accessed via CPU system registers. The software can verify
  if it is permitted to use the component by checking the
  TRBIDR register.

properties:
  $nodename:
    const: trbe

  compatible:
    items:
      - const: arm,trace-buffer-extension

  interrupts:
    description: |
       Exactly 1 PPI must be listed. For heterogeneous systems where
       TRBE is only supported on a subset of the CPUs, please consult
       the arm,gic-v3 binding for details on describing a PPI partition.
    maxItems: 1

required:
  - compatible
  - interrupts

additionalProperties: false

examples:

  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    trbe {
        compatible = "arm,trace-buffer-extension";
        interrupts = <GIC_PPI 15 IRQ_TYPE_LEVEL_HIGH>;
    };
...

Annotation

Implementation Notes