dt-bindings: clock: ti: convert to yaml
Subsystems (2)
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
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
@@ -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
Re: [PATCH v3 1/2] dt-bindings: clock: ti: Convert interface.txt to json-schema
Quoting Andreas Kemnade (2024-10-18 01:53:46)
Quoted 6 lines
Convert the OMAP interface clock device tree binding to json-schema. Specify the creator of the original binding as a maintainer.
Signed-off-by Andreas Kemnade <[email protected]>Reviewed-by Rob Herring (Arm) <[email protected]>---
Applied to clk-next
PATCH v3 2/2 dt-bindings: clock: ti: Convert divider.txt to json-schema
In reply to Andreas KemnadeConvert 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
@@ -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
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.
Signed-off-by Andreas Kemnade <[email protected]>--- .../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
Re: [PATCH v3 2/2] dt-bindings: clock: ti: Convert divider.txt to json-schema
In reply to Andreas KemnadeQuoting 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.
Signed-off-by Andreas Kemnade <[email protected]>---
Applied to clk-next