Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: clock: ti,cdce925: Convert to DT schema

Convert the TI CDCE925 clock binding to DT schema format.
Including a small fix: Add the missing 'ti' prefix in the example
compatible.

Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
Link: https://lore.kernel.org/r/20221021064757.379558-1-alexander.stein@ew.tq-group.com
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Stephen Boyd <sboyd@kernel.org>

authored by

Alexander Stein and committed by
Stephen Boyd
687daae7 9abf2313

+103 -53
-53
Documentation/devicetree/bindings/clock/ti,cdce925.txt
··· 1 - Binding for TI CDCE913/925/937/949 programmable I2C clock synthesizers. 2 - 3 - Reference 4 - This binding uses the common clock binding[1]. 5 - 6 - [1] Documentation/devicetree/bindings/clock/clock-bindings.txt 7 - [2] https://www.ti.com/product/cdce913 8 - [3] https://www.ti.com/product/cdce925 9 - [4] https://www.ti.com/product/cdce937 10 - [5] https://www.ti.com/product/cdce949 11 - 12 - The driver provides clock sources for each output Y1 through Y5. 13 - 14 - Required properties: 15 - - compatible: Shall be one of the following: 16 - - "ti,cdce913": 1-PLL, 3 Outputs 17 - - "ti,cdce925": 2-PLL, 5 Outputs 18 - - "ti,cdce937": 3-PLL, 7 Outputs 19 - - "ti,cdce949": 4-PLL, 9 Outputs 20 - - reg: I2C device address. 21 - - clocks: Points to a fixed parent clock that provides the input frequency. 22 - - #clock-cells: From common clock bindings: Shall be 1. 23 - 24 - Optional properties: 25 - - xtal-load-pf: Crystal load-capacitor value to fine-tune performance on a 26 - board, or to compensate for external influences. 27 - - vdd-supply: A regulator node for Vdd 28 - - vddout-supply: A regulator node for Vddout 29 - 30 - For all PLL1, PLL2, ... an optional child node can be used to specify spread 31 - spectrum clocking parameters for a board. 32 - - spread-spectrum: SSC mode as defined in the data sheet. 33 - - spread-spectrum-center: Use "centered" mode instead of "max" mode. When 34 - present, the clock runs at the requested frequency on average. Otherwise 35 - the requested frequency is the maximum value of the SCC range. 36 - 37 - 38 - Example: 39 - 40 - clockgen: cdce925pw@64 { 41 - compatible = "cdce925"; 42 - reg = <0x64>; 43 - clocks = <&xtal_27Mhz>; 44 - #clock-cells = <1>; 45 - xtal-load-pf = <5>; 46 - vdd-supply = <&1v8-reg>; 47 - vddout-supply = <&3v3-reg>; 48 - /* PLL options to get SSC 1% centered */ 49 - PLL2 { 50 - spread-spectrum = <4>; 51 - spread-spectrum-center; 52 - }; 53 - };
+103
Documentation/devicetree/bindings/clock/ti,cdce925.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/clock/ti,cdce925.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: TI CDCE913/925/937/949 programmable I2C clock synthesizers 8 + 9 + maintainers: 10 + - Alexander Stein <alexander.stein@ew.tq-group.com> 11 + 12 + description: | 13 + Flexible Low Power LVCMOS Clock Generator with SSC Support for EMI Reduction 14 + 15 + - CDCE(L)913: 1-PLL, 3 Outputs https://www.ti.com/product/cdce913 16 + - CDCE(L)925: 2-PLL, 5 Outputs https://www.ti.com/product/cdce925 17 + - CDCE(L)937: 3-PLL, 7 Outputs https://www.ti.com/product/cdce937 18 + - CDCE(L)949: 4-PLL, 9 Outputs https://www.ti.com/product/cdce949 19 + 20 + properties: 21 + compatible: 22 + enum: 23 + - ti,cdce913 24 + - ti,cdce925 25 + - ti,cdce937 26 + - ti,cdce949 27 + 28 + reg: 29 + maxItems: 1 30 + 31 + clocks: 32 + items: 33 + - description: fixed parent clock 34 + 35 + "#clock-cells": 36 + const: 1 37 + 38 + vdd-supply: 39 + description: Regulator that provides 1.8V Vdd power supply 40 + 41 + vddout-supply: 42 + description: | 43 + Regulator that provides Vddout power supply. 44 + non-L variant: 2.5V or 3.3V for 45 + L variant: 1.8V for 46 + 47 + xtal-load-pf: 48 + $ref: /schemas/types.yaml#/definitions/uint32 49 + description: | 50 + Crystal load-capacitor value to fine-tune performance on a 51 + board, or to compensate for external influences. 52 + 53 + patternProperties: 54 + "^PLL[1-4]$": 55 + type: object 56 + description: | 57 + optional child node can be used to specify spread 58 + spectrum clocking parameters for a board 59 + 60 + additionalProperties: false 61 + 62 + properties: 63 + spread-spectrum: 64 + $ref: /schemas/types.yaml#/definitions/uint32 65 + description: SSC mode as defined in the data sheet 66 + 67 + spread-spectrum-center: 68 + type: boolean 69 + description: | 70 + Use "centered" mode instead of "max" mode. When 71 + present, the clock runs at the requested frequency on average. 72 + Otherwise the requested frequency is the maximum value of the 73 + SCC range. 74 + 75 + required: 76 + - compatible 77 + - reg 78 + - clocks 79 + - "#clock-cells" 80 + 81 + additionalProperties: false 82 + 83 + examples: 84 + - | 85 + i2c { 86 + #address-cells = <1>; 87 + #size-cells = <0>; 88 + 89 + cdce925: clock-controller@64 { 90 + compatible = "ti,cdce925"; 91 + reg = <0x64>; 92 + clocks = <&xtal_27Mhz>; 93 + #clock-cells = <1>; 94 + xtal-load-pf = <5>; 95 + vdd-supply = <&reg_1v8>; 96 + vddout-supply = <&reg_3v3>; 97 + /* PLL options to get SSC 1% centered */ 98 + PLL2 { 99 + spread-spectrum = <4>; 100 + spread-spectrum-center; 101 + }; 102 + }; 103 + };