Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml

File Facts

System: Linux kernel
Corpus path: Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml
Extension: .yaml
Size: 1742 bytes
Lines: 81
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/bus/fsl,spba-bus.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Shared Peripherals Bus Interface

maintainers:
  - Shawn Guo <shawnguo@kernel.org>

description: |
  A simple bus enabling access to shared peripherals.

  The "spba-bus" follows the "simple-bus" set of properties, as
  specified in the Devicetree Specification.  It is an extension of
  "simple-bus" because the SDMA controller uses this compatible flag to
  determine which peripherals are available to it and the range over which
  the SDMA can access.  There are no special clocks for the bus, because
  the SDMA controller itself has its interrupt and clock assignments.

  EMI (External Memory Interface) for legacy i.MX35.

select:
  properties:
    compatible:
      contains:
        enum:
          - fsl,aipi-bus
          - fsl,aips
          - fsl,emi
          - fsl,emi-bus
          - fsl,spba-bus
  required:
    - compatible

properties:
  $nodename:
    pattern: "^((spba|emi)-bus|bus)(@[0-9a-f]+)?$"

  compatible:
    items:
      - enum:
          - fsl,aipi-bus
          - fsl,aips
          - fsl,emi
          - fsl,emi-bus
          - fsl,spba-bus
      - const: simple-bus

  '#address-cells':
    enum: [ 1, 2 ]

  '#size-cells':
    enum: [ 1, 2 ]

  reg:
    maxItems: 1

  ranges: true

required:
  - compatible
  - '#address-cells'
  - '#size-cells'
  - reg
  - ranges

additionalProperties:
  type: object

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.