Documentation/devicetree/bindings/incomplete-devices.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/incomplete-devices.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/incomplete-devices.yaml
Extension
.yaml
Size
7402 bytes
Lines
286
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
%YAML 1.2
---
$id: http://devicetree.org/schemas/incomplete-devices.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Rejected, Legacy or Incomplete Devices

maintainers:
  - Rob Herring <robh@kernel.org>

description:
  Some devices will not or should not get a proper Devicetree bindings, but
  their compatibles are present in Linux drivers for various reasons.

  Examples are devices using ACPI PRP0001 with non-updatable firmware/ACPI
  tables or old PowerPC platforms without in-tree DTS.

  Following list of devices is an incomplete schema with a goal to pass DT schema
  checks on undocumented compatibles but also reject any DTS file using such
  un-approved compatible.

  Usage of any of following compatibles is not allowed in Devicetree sources,
  even if they come from immutable firmware.

properties:
  compatible:
    oneOf:
      - description:
          Rejected compatibles in Devicetree, but used in ACPI-based devices
          with non-updatable firmware/ACPI tables (via ACPI PRP0001)
        enum:
          - broadcom,bcm5241
          - ltr,ltrf216a

      - description: Legacy compatibles used on Macintosh devices
        enum:
          - AAPL,3500
          - AAPL,7500
          - AAPL,8500
          - AAPL,9500
          - AAPL,accelerometer_1
          - AAPL,e411
          - AAPL,Gossamer
          - AAPL,PowerBook1998
          - AAPL,ShinerESB
          - adm1030
          - amd-0137
          - B5221
          - bmac+
          - burgundy
          - cobalt
          - cy28508
          - daca
          - fcu
          - gatwick
          - gmac
          - heathrow
          - heathrow-ata
          - heathrow-media-bay
          - i2sbus
          - i2s-modem
          - iMac
          - K2-GMAC
          - k2-i2c
          - K2-Keylargo
          - K2-UATA
          - kauai-ata
          - Keylargo
          - keylargo-ata

Annotation

Implementation Notes