2022-02-03 15:22:51

by Tony Lindgren

Subject: [PATCH 3/3] dt-bindings: clock: ti: Add clock-output-names for TI composite clocks

For the TI composite clocks, we currently have only the divider clock
list clock-output-names as an optional devicetree property. Let's add
clock-output-names for all the TI composite clock bindings.

This allows us to use clock-output-names for the clockctrl instance name
instead of relying on a custom compatible or non-standard node names.

Cc: Stephen Boyd <[email protected]>
Cc: Tero Kristo <[email protected]>
Signed-off-by: Tony Lindgren <[email protected]>
---
Documentation/devicetree/bindings/clock/ti/clockdomain.txt | 3 +++
Documentation/devicetree/bindings/clock/ti/composite.txt | 3 +++
.../devicetree/bindings/clock/ti/fixed-factor-clock.txt | 1 +
Documentation/devicetree/bindings/clock/ti/gate.txt | 1 +
Documentation/devicetree/bindings/clock/ti/interface.txt | 1 +
Documentation/devicetree/bindings/clock/ti/mux.txt | 1 +
6 files changed, 10 insertions(+)

diff --git a/Documentation/devicetree/bindings/clock/ti/clockdomain.txt b/Documentation/devicetree/bindings/clock/ti/clockdomain.txt
--- a/Documentation/devicetree/bindings/clock/ti/clockdomain.txt
+++ b/Documentation/devicetree/bindings/clock/ti/clockdomain.txt
@@ -17,6 +17,9 @@ Required properties:
- #clock-cells : from common clock binding; shall be set to 0.
- clocks : link phandles of clocks within this domain

+Optional properties:
+- clock-output-names : from common clock binding.
+
Examples:
dss_clkdm: dss_clkdm {
compatible = "ti,clockdomain";
diff --git a/Documentation/devicetree/bindings/clock/ti/composite.txt b/Documentation/devicetree/bindings/clock/ti/composite.txt
--- a/Documentation/devicetree/bindings/clock/ti/composite.txt
+++ b/Documentation/devicetree/bindings/clock/ti/composite.txt
@@ -27,6 +27,9 @@ Required properties:
- clocks : link phandles of component clocks
- #clock-cells : from common clock binding; shall be set to 0.

+Optional properties:
+- clock-output-names : from common clock binding.
+
Examples:

usb_l4_gate_ick: usb_l4_gate_ick {
diff --git a/Documentation/devicetree/bindings/clock/ti/fixed-factor-clock.txt b/Documentation/devicetree/bindings/clock/ti/fixed-factor-clock.txt
--- a/Documentation/devicetree/bindings/clock/ti/fixed-factor-clock.txt
+++ b/Documentation/devicetree/bindings/clock/ti/fixed-factor-clock.txt
@@ -16,6 +16,7 @@ Required properties:
- clocks: parent clock.

Optional properties:
+- clock-output-names : from common clock binding.
- ti,autoidle-shift: bit shift of the autoidle enable bit for the clock,
see [2]
- reg: offset for the autoidle register of this clock, see [2]
diff --git a/Documentation/devicetree/bindings/clock/ti/gate.txt b/Documentation/devicetree/bindings/clock/ti/gate.txt
--- a/Documentation/devicetree/bindings/clock/ti/gate.txt
+++ b/Documentation/devicetree/bindings/clock/ti/gate.txt
@@ -36,6 +36,7 @@ Required properties:
ti,clkdm-gate-clock type

Optional properties:
+- clock-output-names : from common clock binding.
- ti,bit-shift : bit shift for programming the clock gate, invalid for
ti,clkdm-gate-clock type
- ti,set-bit-to-disable : inverts default gate programming. Setting the bit
diff --git a/Documentation/devicetree/bindings/clock/ti/interface.txt b/Documentation/devicetree/bindings/clock/ti/interface.txt
--- a/Documentation/devicetree/bindings/clock/ti/interface.txt
+++ b/Documentation/devicetree/bindings/clock/ti/interface.txt
@@ -28,6 +28,7 @@ Required properties:
- reg : base address for the control register

Optional properties:
+- clock-output-names : from common clock binding.
- ti,bit-shift : bit shift for the bit enabling/disabling the clock (default 0)

Examples:
diff --git a/Documentation/devicetree/bindings/clock/ti/mux.txt b/Documentation/devicetree/bindings/clock/ti/mux.txt
--- a/Documentation/devicetree/bindings/clock/ti/mux.txt
+++ b/Documentation/devicetree/bindings/clock/ti/mux.txt
@@ -42,6 +42,7 @@ Required properties:
- reg : register offset for register controlling adjustable mux

Optional properties:
+- clock-output-names : from common clock binding.
- ti,bit-shift : number of bits to shift the bit-mask, defaults to
0 if not present
- ti,index-starts-at-one : valid input select programming starts at 1, not
--
2.35.1

2022-02-14 09:57:34

by Rob Herring (Arm)

Subject: Re: [PATCH 3/3] dt-bindings: clock: ti: Add clock-output-names for TI composite clocks

On Thu, 03 Feb 2022 13:23:37 +0200, Tony Lindgren wrote:
> For the TI composite clocks, we currently have only the divider clock
> list clock-output-names as an optional devicetree property. Let's add
> clock-output-names for all the TI composite clock bindings.
>
> This allows us to use clock-output-names for the clockctrl instance name
> instead of relying on a custom compatible or non-standard node names.
>
> Cc: Stephen Boyd <[email protected]>
> Cc: Tero Kristo <[email protected]>
> Signed-off-by: Tony Lindgren <[email protected]>
> ---
> Documentation/devicetree/bindings/clock/ti/clockdomain.txt | 3 +++
> Documentation/devicetree/bindings/clock/ti/composite.txt | 3 +++
> .../devicetree/bindings/clock/ti/fixed-factor-clock.txt | 1 +
> Documentation/devicetree/bindings/clock/ti/gate.txt | 1 +
> Documentation/devicetree/bindings/clock/ti/interface.txt | 1 +
> Documentation/devicetree/bindings/clock/ti/mux.txt | 1 +
> 6 files changed, 10 insertions(+)
>

Acked-by: Rob Herring <[email protected]>