github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-11-07 06:17:02 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

dt-bindings: clock: Convert TI Palmas Clock to DT schema

Browse Source 
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 <egbostina@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Brian Masney <bmasney@redhat.com>
This commit is contained in:
Eduard Bostina 2026-07-19 14:12:36 +00:00 committed by Brian Masney
parent 4c943ddfc2
commit e44caef884
2 changed files with 56 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
Documentation/devicetree/bindings/clock/clk-palmas-clk32kg-clocks.txt
View File

@ -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 <dt-bindings/mfd/palmas.h>
...
palmas: tps65913@58 {
...
clk32kg: palmas_clk32k@0 {
compatible = "ti,palmas-clk32kg";
#clock-cells = <0>;
ti,external-sleep-control = <PALMAS_EXT_CONTROL_PIN_NSLEEP>;
};
...
};

56
Documentation/devicetree/bindings/clock/ti,palmas-clk32kg.yaml Normal file
View File

@ -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 <egbostina@gmail.com>
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 <dt-bindings/mfd/palmas.h>
pmic {
clock-controller {
compatible = "ti,palmas-clk32kg";
#clock-cells = <0>;
ti,external-sleep-control = <PALMAS_EXT_CONTROL_PIN_NSLEEP>;
};
};