Skip to contentSkip to conversation

dt-bindings: clock: ti: convert to yaml

PATCH Applied Andreas Kemnade 3 participants 6 messages Oct 18, 2024 – Oct 19, 2024

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

v3 cover dt-bindings: clock: ti: convert to yaml

Convert some clock schemas to yaml. These are one of the most used non-yaml compatibles.

All can appear under a ti,clksel or without a ti,clksel.

I plan to convert the clock things from time to time. So enforcing certain compatibles below ti,clksel is not there yet.

Open question: I set license to GPL-2 only because the .txt bindings the yaml binding was derived from were
GPL-2. I personally have no problem with dual-licensing the binding. No idea about the legal side wether that is possible or who must agree.

Changes in v3:
- adding more constraints and types
- strip labels from example
- fix references to divider.txt

Changes in v2:
- added conversion of divider
- require reg now, makes sense after
https://lore.kernel.org/linux-omap/[email protected]/
- clean up of examples
- improvement of documentation

v1 is at https://lore.kernel.org/linux-omap/[email protected]/

Andreas Kemnade (2):
dt-bindings: clock: ti: Convert interface.txt to json-schema
dt-bindings: clock: ti: Convert divider.txt to json-schema

 .../bindings/clock/ti/composite.txt           |   2 +-
 .../devicetree/bindings/clock/ti/divider.txt  | 115 -----------
 .../bindings/clock/ti/interface.txt           |  55 -----
 .../bindings/clock/ti/ti,divider-clock.yaml   | 193 ++++++++++++++++++
 .../bindings/clock/ti/ti,interface-clock.yaml |  71 +++++++
 5 files changed, 265 insertions(+), 171 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/clock/ti/divider.txt
 delete mode 100644 Documentation/devicetree/bindings/clock/ti/interface.txt
 create mode 100644 Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml
 create mode 100644 Documentation/devicetree/bindings/clock/ti/ti,interface-clock.yaml
Signature · 1 line
2.39.5
#1 lore raw

PATCH v3 1/2 dt-bindings: clock: ti: Convert interface.txt to json-schema

Convert the OMAP interface clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer.

---
 .../bindings/clock/ti/interface.txt           | 55 --------------
 .../bindings/clock/ti/ti,interface-clock.yaml | 71 +++++++++++++++++++
 2 files changed, 71 insertions(+), 55 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/clock/ti/interface.txt
 create mode 100644 Documentation/devicetree/bindings/clock/ti/ti,interface-clock.yaml
Documentation/devicetree/bindings/clock/ti/interface.txt deleted +0 -55
deleted file mode 100644
index 85fb1f2d2d28..000000000000
@@ -1,55 +0,0 @@
-Binding for Texas Instruments interface clock.
-
-This binding uses the common clock binding[1]. This clock is
-quite much similar to the basic gate-clock [2], however,
-it supports a number of additional features, including
-companion clock finding (match corresponding functional gate
-clock) and hardware autoidle enable / disable.
-
-[1] Documentation/devicetree/bindings/clock/clock-bindings.txt
-[2] Documentation/devicetree/bindings/clock/gpio-gate-clock.yaml
-
-Required properties:
-- compatible : shall be one of:
-  "ti,omap3-interface-clock" - basic OMAP3 interface clock
-  "ti,omap3-no-wait-interface-clock" - interface clock which has no hardware
-				       capability for waiting clock to be ready
-  "ti,omap3-hsotgusb-interface-clock" - interface clock with USB specific HW
-					handling
-  "ti,omap3-dss-interface-clock" - interface clock with DSS specific HW handling
-  "ti,omap3-ssi-interface-clock" - interface clock with SSI specific HW handling
-  "ti,am35xx-interface-clock" - interface clock with AM35xx specific HW handling
-  "ti,omap2430-interface-clock" - interface clock with OMAP2430 specific HW
-				  handling
-- #clock-cells : from common clock binding; shall be set to 0
-- clocks : link to phandle of parent clock
-- 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:
-	aes1_ick: aes1_ick@48004a14 {
-		#clock-cells = <0>;
-		compatible = "ti,omap3-interface-clock";
-		clocks = <&security_l4_ick2>;
-		reg = <0x48004a14 0x4>;
-		ti,bit-shift = <3>;
-	};
-
-	cam_ick: cam_ick@48004f10 {
-		#clock-cells = <0>;
-		compatible = "ti,omap3-no-wait-interface-clock";
-		clocks = <&l4_ick>;
-		reg = <0x48004f10 0x4>;
-		ti,bit-shift = <0>;
-	};
-
-	ssi_ick_3430es2: ssi_ick_3430es2@48004a10 {
-		#clock-cells = <0>;
-		compatible = "ti,omap3-ssi-interface-clock";
-		clocks = <&ssi_l4_ick>;
-		reg = <0x48004a10 0x4>;
-		ti,bit-shift = <0>;
-	};
Documentation/devicetree/bindings/clock/ti/ti,interface-clock.yaml new file +71 -0

71 lines not on this page · raw message

Signature · 1 line
2.39.5
#3 lore raw

PATCH v3 2/2 dt-bindings: clock: ti: Convert divider.txt to json-schema

In reply to Andreas Kemnade

Convert the OMAP divider clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer.

---
 .../bindings/clock/ti/composite.txt           |   2 +-
 .../devicetree/bindings/clock/ti/divider.txt  | 115 -----------
 .../bindings/clock/ti/ti,divider-clock.yaml   | 193 ++++++++++++++++++
 3 files changed, 194 insertions(+), 116 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/clock/ti/divider.txt
 create mode 100644 Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml
Documentation/devicetree/bindings/clock/ti/composite.txt +1 -1
index 6f7e1331b546..b02f22490dcb 100644
@@ -17,7 +17,7 @@ merged to this clock. The component clocks shall be of one of the
 
 [1] Documentation/devicetree/bindings/clock/clock-bindings.txt
 [2] Documentation/devicetree/bindings/clock/ti/mux.txt
-[3] Documentation/devicetree/bindings/clock/ti/divider.txt
+[3] Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml
 [4] Documentation/devicetree/bindings/clock/ti/gate.txt
 
 Required properties:
Documentation/devicetree/bindings/clock/ti/divider.txt deleted +0 -115

115 lines not on this page · raw message

Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml new file +193 -0

193 lines not on this page · raw message

Signature · 1 line
2.39.5
maintainer Reviewed-by on v3 2/2
#4 lore raw

Re: [PATCH v3 2/2] dt-bindings: clock: ti: Convert divider.txt to json-schema

Quoted 12 lines · Andreas Kemnade

Convert the OMAP divider clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer.

---
 .../bindings/clock/ti/composite.txt           |   2 +-
 .../devicetree/bindings/clock/ti/divider.txt  | 115 -----------
 .../bindings/clock/ti/ti,divider-clock.yaml   | 193 ++++++++++++++++++
 3 files changed, 194 insertions(+), 116 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/clock/ti/divider.txt
 create mode 100644 Documentation/devicetree/bindings/clock/ti/ti,divider-clock.yaml
maintainer Applied
#5 lore raw

Re: [PATCH v3 2/2] dt-bindings: clock: ti: Convert divider.txt to json-schema

In reply to Andreas Kemnade

Quoting Andreas Kemnade (2024-10-18 01:53:47)

Quoted 5 lines

Convert the OMAP divider clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer.

---

Applied to clk-next