Documentation/devicetree/bindings/dpll/dpll-pin.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/dpll/dpll-pin.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/dpll/dpll-pin.yaml
Extension
.yaml
Size
1846 bytes
Lines
59
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 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/dpll/dpll-pin.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: DPLL Pin

maintainers:
  - Ivan Vecera <ivecera@redhat.com>

description: |
  The DPLL pin is either a physical input or output pin that is provided
  by a DPLL( Digital Phase-Locked Loop) device. The pin is identified by
  its physical order number that is stored in reg property and can have
  an additional set of properties like supported (allowed) frequencies,
  label, type and may support embedded sync.

  Note that the pin in this context has nothing to do with pinctrl.

properties:
  reg:
    description: Hardware index of the DPLL pin.
    maxItems: 1

  connection-type:
    description: Connection type of the pin
    $ref: /schemas/types.yaml#/definitions/string
    enum: [ext, gnss, int, mux, synce]

  esync-control:
    description: Indicates whether the pin supports embedded sync functionality.
    type: boolean

  label:
    description: String exposed as the pin board label
    $ref: /schemas/types.yaml#/definitions/string

  ref-sync-sources:
    description: |
      List of phandles to input pins that can serve as the sync source
      in a Reference-Sync pair with this pin acting as the clock source.
      A Ref-Sync pair consists of a clock reference and a low-frequency
      sync signal.  The DPLL locks to the clock reference but
      phase-aligns to the sync reference.
      Only valid for input pins.  Each referenced pin must be a
      different input pin on the same device.
    $ref: /schemas/types.yaml#/definitions/phandle-array
    items:
      maxItems: 1

  supported-frequencies-hz:
    description: List of supported frequencies for this pin, expressed in Hz.

required:
  - reg

additionalProperties: false

Annotation

Implementation Notes