mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-28 18:10:32 +00:00
0afcee10dd
Add a common DT schema for DPLL device and its associated pins. The DPLL (device phase-locked loop) is a device used for precise clock synchronization in networking and telecom hardware. The device includes one or more DPLLs (channels) and one or more physical input/output pins. Each DPLL channel is used either to provide a pulse-per-clock signal or to drive an Ethernet equipment clock. The input and output pins have the following properties: * label: specifies board label * connection type: specifies its usage depending on wiring * list of supported or allowed frequencies: depending on how the pin is connected and where) * embedded sync capability: indicates whether the pin supports this Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Signed-off-by: Ivan Vecera <ivecera@redhat.com> Reviewed-by: Jiri Pirko <jiri@nvidia.com> Link: https://patch.msgid.link/20250704182202.1641943-2-ivecera@redhat.com Signed-off-by: Jakub Kicinski <kuba@kernel.org>
46 lines
1.3 KiB
YAML
46 lines
1.3 KiB
YAML
# 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
|
|
|
|
supported-frequencies-hz:
|
|
description: List of supported frequencies for this pin, expressed in Hz.
|
|
|
|
required:
|
|
- reg
|
|
|
|
additionalProperties: false
|