mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-03 17:51:23 +00:00
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>
64 lines
1.2 KiB
YAML
64 lines
1.2 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/clock/fixed-factor-clock.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Simple fixed factor rate clock sources
|
|
|
|
maintainers:
|
|
- Michael Turquette <mturquette@baylibre.com>
|
|
- Stephen Boyd <sboyd@kernel.org>
|
|
|
|
properties:
|
|
$nodename:
|
|
anyOf:
|
|
- description:
|
|
If the frequency is fixed, the preferred name is 'clock-<freq>' with
|
|
<freq> being the output frequency.
|
|
pattern: "^clock-([0-9]+|[0-9a-z-]+)$"
|
|
- description: Any name allowed
|
|
deprecated: true
|
|
|
|
compatible:
|
|
enum:
|
|
- fixed-factor-clock
|
|
|
|
"#clock-cells":
|
|
const: 0
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
clock-div:
|
|
description: Fixed divider
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 1
|
|
|
|
clock-mult:
|
|
description: Fixed multiplier
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
clock-output-names:
|
|
maxItems: 1
|
|
|
|
required:
|
|
- compatible
|
|
- clocks
|
|
- "#clock-cells"
|
|
- clock-div
|
|
- clock-mult
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
clock {
|
|
compatible = "fixed-factor-clock";
|
|
clocks = <&parentclk>;
|
|
#clock-cells = <0>;
|
|
clock-div = <2>;
|
|
clock-mult = <1>;
|
|
};
|
|
...
|