From e44caef8848790e3515c7c32bd3460e948613092 Mon Sep 17 00:00:00 2001 From: Eduard Bostina Date: Sun, 19 Jul 2026 14:12:36 +0000 Subject: [PATCH] dt-bindings: clock: Convert TI Palmas Clock to DT schema Convert the Texas Instruments Palmas 32KHz clock bindings to DT schema. During the conversion, the node name in the example was updated from 'palmas_clk32k@0' to 'clock-controller'. The old example contained a unit address without a 'reg' property, which causes dtc compilation warnings. Signed-off-by: Eduard Bostina Reviewed-by: Rob Herring (Arm) Signed-off-by: Brian Masney --- .../clock/clk-palmas-clk32kg-clocks.txt | 35 ------------ .../bindings/clock/ti,palmas-clk32kg.yaml | 56 +++++++++++++++++++ 2 files changed, 56 insertions(+), 35 deletions(-) delete mode 100644 Documentation/devicetree/bindings/clock/clk-palmas-clk32kg-clocks.txt create mode 100644 Documentation/devicetree/bindings/clock/ti,palmas-clk32kg.yaml diff --git a/Documentation/devicetree/bindings/clock/clk-palmas-clk32kg-clocks.txt b/Documentation/devicetree/bindings/clock/clk-palmas-clk32kg-clocks.txt deleted file mode 100644 index 4208886d834a..000000000000 --- a/Documentation/devicetree/bindings/clock/clk-palmas-clk32kg-clocks.txt +++ /dev/null @@ -1,35 +0,0 @@ -* Palmas 32KHz clocks * - -Palmas device has two clock output pins for 32KHz, KG and KG_AUDIO. - -This binding uses the common clock binding ./clock-bindings.txt. - -Required properties: -- compatible : "ti,palmas-clk32kg" for clk32kg clock - "ti,palmas-clk32kgaudio" for clk32kgaudio clock -- #clock-cells : shall be set to 0. - -Optional property: -- ti,external-sleep-control: The external enable input pins controlled the - enable/disable of clocks. The external enable input pins ENABLE1, - ENABLE2 and NSLEEP. The valid values for the external pins are: - PALMAS_EXT_CONTROL_PIN_ENABLE1 for ENABLE1 pin - PALMAS_EXT_CONTROL_PIN_ENABLE2 for ENABLE2 pin - PALMAS_EXT_CONTROL_PIN_NSLEEP for NSLEEP pin - Option 0 or missing this property means the clock is enabled/disabled - via register access and these pins do not have any control. - The macros of external control pins for DTS is defined at - dt-bindings/mfd/palmas.h - -Example: - #include - ... - palmas: tps65913@58 { - ... - clk32kg: palmas_clk32k@0 { - compatible = "ti,palmas-clk32kg"; - #clock-cells = <0>; - ti,external-sleep-control = ; - }; - ... - }; diff --git a/Documentation/devicetree/bindings/clock/ti,palmas-clk32kg.yaml b/Documentation/devicetree/bindings/clock/ti,palmas-clk32kg.yaml new file mode 100644 index 000000000000..c2a49be9b95a --- /dev/null +++ b/Documentation/devicetree/bindings/clock/ti,palmas-clk32kg.yaml @@ -0,0 +1,56 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/ti,palmas-clk32kg.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments Palmas 32KHz Clocks + +maintainers: + - Eduard Bostina + +description: + The Palmas device family has two clock output pins for 32KHz, + KG and KG_AUDIO. + +allOf: + - $ref: /schemas/clock/clock.yaml# + +properties: + compatible: + enum: + - ti,palmas-clk32kg + - ti,palmas-clk32kgaudio + + "#clock-cells": + const: 0 + + ti,external-sleep-control: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [ 0, 1, 2, 3 ] + description: | + The external enable input pins control the enable/disable of clocks. + The valid values (defined in dt-bindings/mfd/palmas.h) are: + 1: PALMAS_EXT_CONTROL_PIN_ENABLE1 + 2: PALMAS_EXT_CONTROL_PIN_ENABLE2 + 3: PALMAS_EXT_CONTROL_PIN_NSLEEP + Option 0 or missing this property means the clock is enabled/disabled + via register access and these pins do not have any control. + +required: + - compatible + - "#clock-cells" + +unevaluatedProperties: false + +examples: + - | + #include + + pmic { + clock-controller { + compatible = "ti,palmas-clk32kg"; + #clock-cells = <0>; + ti,external-sleep-control = ; + }; + };