Documentation/devicetree/bindings/perf/apm,xgene-pmu.yaml

File Facts

System

Linux kernel

Corpus path

Documentation/devicetree/bindings/perf/apm,xgene-pmu.yaml

Extension

.yaml

Size

3382 bytes

Lines

143

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.

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

Dependency Surface

• No C-style include directives detected by the generator.

Detected Declarations

• No top-level syscall, struct, function, initcall, or export declaration detected by the generator.

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/perf/apm,xgene-pmu.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: APM X-Gene SoC PMU

maintainers:
  - Khuong Dinh <khuong@os.amperecomputing.com>

description: |
  This is APM X-Gene SoC PMU (Performance Monitoring Unit) module.
  The following PMU devices are supported:

    L3C            - L3 cache controller
    IOB            - IO bridge
    MCB            - Memory controller bridge
    MC             - Memory controller

properties:
  compatible:
    enum:
      - apm,xgene-pmu
      - apm,xgene-pmu-v2

  "#address-cells":
    const: 2

  "#size-cells":
    const: 2

  ranges: true

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  regmap-csw:
    $ref: /schemas/types.yaml#/definitions/phandle

  regmap-mcba:
    $ref: /schemas/types.yaml#/definitions/phandle

  regmap-mcbb:
    $ref: /schemas/types.yaml#/definitions/phandle

required:
  - compatible
  - regmap-csw
  - regmap-mcba
  - regmap-mcbb
  - reg
  - interrupts

additionalProperties:
  type: object
  additionalProperties: false

  properties:
    compatible:
      enum:
        - apm,xgene-pmu-l3c
        - apm,xgene-pmu-iob
        - apm,xgene-pmu-mcb
        - apm,xgene-pmu-mc

    reg:

Annotation

• Atlas domain: Support Tooling And Documentation / Documentation.
• Implementation status: atlas-only.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.