b3e991240e
Define "clock-<freq>" as the preferred node name for fixed-clock and fixed-factor-clock where <freq> is the output frequency of the clock. There isn't much of an existing pattern for names of these nodes. The most frequent patterns are a prefix or suffix of "clk", but there's a bunch that don't follow any sort of pattern. We could use "clock-controller-.*", but these nodes aren't really a controller in any way. So let's at least align with part of that and use 'clock-'. For now this only serves as documentation as the schema still allows anything to avoid lots of additional warnings for something low priority to fix. Once a "no deprecated" mode is added to the tools, warnings can be enabled selectively. Signed-off-by: Rob Herring (Arm) <robh@kernel.org> Link: https://lore.kernel.org/r/20240430180415.657067-1-robh@kernel.org Acked-by: Conor Dooley <conor.dooley@microchip.com> Signed-off-by: Stephen Boyd <sboyd@kernel.org>
54 lines
1.1 KiB
YAML
54 lines
1.1 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/clock/fixed-clock.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Simple fixed-rate clock sources
|
|
|
|
maintainers:
|
|
- Michael Turquette <mturquette@baylibre.com>
|
|
- Stephen Boyd <sboyd@kernel.org>
|
|
|
|
properties:
|
|
$nodename:
|
|
anyOf:
|
|
- description:
|
|
Preferred name is 'clock-<freq>' with <freq> being the output
|
|
frequency as defined in the 'clock-frequency' property.
|
|
pattern: "^clock-([0-9]+|[a-z0-9-]+)$"
|
|
- description: Any name allowed
|
|
deprecated: true
|
|
|
|
compatible:
|
|
const: fixed-clock
|
|
|
|
"#clock-cells":
|
|
const: 0
|
|
|
|
clock-frequency: true
|
|
|
|
clock-accuracy:
|
|
description: accuracy of clock in ppb (parts per billion).
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
clock-output-names:
|
|
maxItems: 1
|
|
|
|
required:
|
|
- compatible
|
|
- "#clock-cells"
|
|
- clock-frequency
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
clock {
|
|
compatible = "fixed-clock";
|
|
#clock-cells = <0>;
|
|
clock-frequency = <1000000000>;
|
|
clock-accuracy = <100>;
|
|
};
|
|
...
|