Documentation/devicetree/bindings/serial/8250.yaml

File Facts

System

Linux kernel

Corpus path

Documentation/devicetree/bindings/serial/8250.yaml

Extension

.yaml

Size

9026 bytes

Lines

355

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

• dt-bindings/gpio/gpio.h
• dt-bindings/clock/aspeed-clock.h
• dt-bindings/interrupt-controller/irq.h

Detected Declarations

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

Annotated Snippet

# Copyright 2020 Lubomir Rintel <lkundrak@v3.sk>
%YAML 1.2
---
$id: http://devicetree.org/schemas/serial/8250.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: UART (Universal Asynchronous Receiver/Transmitter)

maintainers:
  - devicetree@vger.kernel.org

allOf:
  - $ref: serial.yaml#
  - $ref: /schemas/memory-controllers/mc-peripheral-props.yaml#
  - if:
      anyOf:
        - required:
            - aspeed,lpc-io-reg
        - required:
            - aspeed,lpc-interrupts
        - required:
            - aspeed,sirq-polarity-sense
    then:
      properties:
        compatible:
          const: aspeed,ast2500-vuart
  - if:
      properties:
        compatible:
          const: mrvl,mmp-uart
    then:
      properties:
        reg-shift:
          const: 2
      required:
        - reg-shift
  - if:
      not:
        properties:
          compatible:
            items:
              - enum:
                  - ns8250
                  - ns16450
                  - ns16550
                  - ns16550a
    then:
      oneOf:
        - required: [ clock-frequency ]
        - required: [ clocks ]
  - if:
      properties:
        compatible:
          contains:
            const: nxp,lpc1850-uart
    then:
      properties:
        clock-names:
          items:
            - const: uartclk
            - const: reg
  - if:
      properties:
        compatible:
          contains:
            enum:
              - spacemit,k1-uart
              - spacemit,k3-uart
    then:
      properties:

Annotation

• Immediate include surface: `dt-bindings/gpio/gpio.h`, `dt-bindings/clock/aspeed-clock.h`, `dt-bindings/interrupt-controller/irq.h`.
• 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.