All of lore.kernel.org
 help / color / mirror / Atom feed
* [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-04-28 15:27 ` Rob Herring
  0 siblings, 0 replies; 6+ messages in thread
From: Rob Herring @ 2022-04-28 15:27 UTC (permalink / raw)
  To: devicetree, devicetree-spec; +Cc: Stephen Boyd, Ben Dooks

Add description for assigned-clocks properties from clock-binding.txt in
the Linux kernel.

This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
are the original authors.

Cc: Ben Dooks <ben.dooks@codethink.co.uk>
Signed-off-by: Rob Herring <robh@kernel.org>
---
Please ack the license change.

 dtschema/schemas/clock/clock.yaml | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/dtschema/schemas/clock/clock.yaml b/dtschema/schemas/clock/clock.yaml
index 5299653b80b6..433a858ef31e 100644
--- a/dtschema/schemas/clock/clock.yaml
+++ b/dtschema/schemas/clock/clock.yaml
@@ -94,9 +94,21 @@ properties:
 
   clock-indices:
     $ref: "/schemas/types.yaml#/definitions/uint32-array"
-    description: If the identifying number for the clocks in the node
-      is not linear from zero, then this allows the mapping of identifiers
-      into the clock-output-names array.
+    description: |
+      If the identifying number for the clocks in the node is not linear from
+      zero, then this allows the mapping of identifiers into the
+      clock-output-names array.
+
+      For example, if we have two clocks <&oscillator 1> and <&oscillator 3>:
+
+        oscillator {
+            compatible = "myclocktype";
+            #clock-cells = <1>;
+            clock-indices = <1>, <3>;
+            clock-output-names = "clka", "clkb";
+        }
+
+      This ensures we do not have any empty strings in clock-output-names
 
   # Consumer properties
   clocks:
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-04-28 15:27 ` Rob Herring
  0 siblings, 0 replies; 6+ messages in thread
From: Rob Herring @ 2022-04-28 15:27 UTC (permalink / raw)
  To: devicetree-u79uwXL29TY76Z2rM5mHXA,
	devicetree-spec-u79uwXL29TY76Z2rM5mHXA
  Cc: Stephen Boyd, Ben Dooks

Add description for assigned-clocks properties from clock-binding.txt in
the Linux kernel.

This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
are the original authors.

Cc: Ben Dooks <ben.dooks-4yDnlxn2s6sWdaTGBSpHTA@public.gmane.org>
Signed-off-by: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
---
Please ack the license change.

 dtschema/schemas/clock/clock.yaml | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/dtschema/schemas/clock/clock.yaml b/dtschema/schemas/clock/clock.yaml
index 5299653b80b6..433a858ef31e 100644
--- a/dtschema/schemas/clock/clock.yaml
+++ b/dtschema/schemas/clock/clock.yaml
@@ -94,9 +94,21 @@ properties:
 
   clock-indices:
     $ref: "/schemas/types.yaml#/definitions/uint32-array"
-    description: If the identifying number for the clocks in the node
-      is not linear from zero, then this allows the mapping of identifiers
-      into the clock-output-names array.
+    description: |
+      If the identifying number for the clocks in the node is not linear from
+      zero, then this allows the mapping of identifiers into the
+      clock-output-names array.
+
+      For example, if we have two clocks <&oscillator 1> and <&oscillator 3>:
+
+        oscillator {
+            compatible = "myclocktype";
+            #clock-cells = <1>;
+            clock-indices = <1>, <3>;
+            clock-output-names = "clka", "clkb";
+        }
+
+      This ensures we do not have any empty strings in clock-output-names
 
   # Consumer properties
   clocks:
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* Re: [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-05-19 23:17   ` Stephen Boyd
  0 siblings, 0 replies; 6+ messages in thread
From: Stephen Boyd @ 2022-05-19 23:17 UTC (permalink / raw)
  To: Rob Herring, devicetree-spec, devicetree; +Cc: Stephen Boyd, Ben Dooks

Quoting Rob Herring (2022-04-28 08:27:19)
> Add description for assigned-clocks properties from clock-binding.txt in
> the Linux kernel.
> 
> This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
> are the original authors.
> 
> Cc: Ben Dooks <ben.dooks@codethink.co.uk>
> Signed-off-by: Rob Herring <robh@kernel.org>
> ---

Acked-by: Stephen Boyd <sboyd@kernel.org>

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-05-19 23:17   ` Stephen Boyd
  0 siblings, 0 replies; 6+ messages in thread
From: Stephen Boyd @ 2022-05-19 23:17 UTC (permalink / raw)
  To: Rob Herring, devicetree-spec-u79uwXL29TY76Z2rM5mHXA,
	devicetree-u79uwXL29TY76Z2rM5mHXA
  Cc: Stephen Boyd, Ben Dooks

Quoting Rob Herring (2022-04-28 08:27:19)
> Add description for assigned-clocks properties from clock-binding.txt in
> the Linux kernel.
> 
> This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
> are the original authors.
> 
> Cc: Ben Dooks <ben.dooks-4yDnlxn2s6sWdaTGBSpHTA@public.gmane.org>
> Signed-off-by: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
> ---

Acked-by: Stephen Boyd <sboyd-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-06-06 20:04   ` Rob Herring
  0 siblings, 0 replies; 6+ messages in thread
From: Rob Herring @ 2022-06-06 20:04 UTC (permalink / raw)
  To: Ben Dooks; +Cc: Mailing List, devicetree, Stephen Boyd

On Thu, Apr 28, 2022 at 10:27 AM Rob Herring <robh@kernel.org> wrote:
>
> Add description for assigned-clocks properties from clock-binding.txt in
> the Linux kernel.
>
> This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
> are the original authors.
>
> Cc: Ben Dooks <ben.dooks@codethink.co.uk>
> Signed-off-by: Rob Herring <robh@kernel.org>
> ---
> Please ack the license change.

Ben, need your ack on this please.

>
>  dtschema/schemas/clock/clock.yaml | 18 +++++++++++++++---
>  1 file changed, 15 insertions(+), 3 deletions(-)
>
> diff --git a/dtschema/schemas/clock/clock.yaml b/dtschema/schemas/clock/clock.yaml
> index 5299653b80b6..433a858ef31e 100644
> --- a/dtschema/schemas/clock/clock.yaml
> +++ b/dtschema/schemas/clock/clock.yaml
> @@ -94,9 +94,21 @@ properties:
>
>    clock-indices:
>      $ref: "/schemas/types.yaml#/definitions/uint32-array"
> -    description: If the identifying number for the clocks in the node
> -      is not linear from zero, then this allows the mapping of identifiers
> -      into the clock-output-names array.
> +    description: |
> +      If the identifying number for the clocks in the node is not linear from
> +      zero, then this allows the mapping of identifiers into the
> +      clock-output-names array.
> +
> +      For example, if we have two clocks <&oscillator 1> and <&oscillator 3>:
> +
> +        oscillator {
> +            compatible = "myclocktype";
> +            #clock-cells = <1>;
> +            clock-indices = <1>, <3>;
> +            clock-output-names = "clka", "clkb";
> +        }
> +
> +      This ensures we do not have any empty strings in clock-output-names
>
>    # Consumer properties
>    clocks:
> --
> 2.34.1
>

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [dtschema PATCH] schemas: clock: Add example for 'clock-indices'
@ 2022-06-06 20:04   ` Rob Herring
  0 siblings, 0 replies; 6+ messages in thread
From: Rob Herring @ 2022-06-06 20:04 UTC (permalink / raw)
  To: Ben Dooks; +Cc: Mailing List, devicetree-u79uwXL29TY76Z2rM5mHXA, Stephen Boyd

On Thu, Apr 28, 2022 at 10:27 AM Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> wrote:
>
> Add description for assigned-clocks properties from clock-binding.txt in
> the Linux kernel.
>
> This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
> are the original authors.
>
> Cc: Ben Dooks <ben.dooks-4yDnlxn2s6sWdaTGBSpHTA@public.gmane.org>
> Signed-off-by: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
> ---
> Please ack the license change.

Ben, need your ack on this please.

>
>  dtschema/schemas/clock/clock.yaml | 18 +++++++++++++++---
>  1 file changed, 15 insertions(+), 3 deletions(-)
>
> diff --git a/dtschema/schemas/clock/clock.yaml b/dtschema/schemas/clock/clock.yaml
> index 5299653b80b6..433a858ef31e 100644
> --- a/dtschema/schemas/clock/clock.yaml
> +++ b/dtschema/schemas/clock/clock.yaml
> @@ -94,9 +94,21 @@ properties:
>
>    clock-indices:
>      $ref: "/schemas/types.yaml#/definitions/uint32-array"
> -    description: If the identifying number for the clocks in the node
> -      is not linear from zero, then this allows the mapping of identifiers
> -      into the clock-output-names array.
> +    description: |
> +      If the identifying number for the clocks in the node is not linear from
> +      zero, then this allows the mapping of identifiers into the
> +      clock-output-names array.
> +
> +      For example, if we have two clocks <&oscillator 1> and <&oscillator 3>:
> +
> +        oscillator {
> +            compatible = "myclocktype";
> +            #clock-cells = <1>;
> +            clock-indices = <1>, <3>;
> +            clock-output-names = "clka", "clkb";
> +        }
> +
> +      This ensures we do not have any empty strings in clock-output-names
>
>    # Consumer properties
>    clocks:
> --
> 2.34.1
>

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2022-06-06 20:05 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-04-28 15:27 [dtschema PATCH] schemas: clock: Add example for 'clock-indices' Rob Herring
2022-04-28 15:27 ` Rob Herring
2022-05-19 23:17 ` Stephen Boyd
2022-05-19 23:17   ` Stephen Boyd
2022-06-06 20:04 ` Rob Herring
2022-06-06 20:04   ` Rob Herring

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.