* [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
@ 2025-03-12 12:27 Purva Yeshi
2025-03-12 17:59 ` Vladimir Zapolskiy
` (2 more replies)
0 siblings, 3 replies; 12+ messages in thread
From: Purva Yeshi @ 2025-03-12 12:27 UTC (permalink / raw)
To: ukleinek, robh, krzk+dt, conor+dt, vz, piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel,
Purva Yeshi
Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
YAML schema (`nxp,lpc3220-pwm.yaml`).
Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
---
V1 - https://lore.kernel.org/all/20250311125756.24064-1-purvayeshi550@gmail.com/
V2 - Correct filename to match the compatible string, remove unnecessary
quotes in maintainers, and refine commit message.
.../devicetree/bindings/pwm/lpc32xx-pwm.txt | 17 ---------
.../bindings/pwm/nxp,lpc3220-pwm.yaml | 38 +++++++++++++++++++
2 files changed, 38 insertions(+), 17 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
create mode 100644 Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
diff --git a/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt b/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
deleted file mode 100644
index 74b5bc5dd..000000000
--- a/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-LPC32XX PWM controller
-
-Required properties:
-- compatible: should be "nxp,lpc3220-pwm"
-- reg: physical base address and length of the controller's registers
-
-Examples:
-
-pwm@4005c000 {
- compatible = "nxp,lpc3220-pwm";
- reg = <0x4005c000 0x4>;
-};
-
-pwm@4005c004 {
- compatible = "nxp,lpc3220-pwm";
- reg = <0x4005c004 0x4>;
-};
diff --git a/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
new file mode 100644
index 000000000..432a5e9d4
--- /dev/null
+++ b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
@@ -0,0 +1,38 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pwm/nxp,lpc3220-pwm.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: LPC32XX PWM controller
+
+maintainers:
+ - Vladimir Zapolskiy <vz@mleia.com>
+ - Piotr Wojtaszczyk <piotr.wojtaszczyk@timesys.com>
+
+allOf:
+ - $ref: pwm.yaml#
+
+properties:
+ compatible:
+ const: nxp,lpc3220-pwm
+
+ reg:
+ maxItems: 1
+
+ "#pwm-cells":
+ const: 3
+
+required:
+ - compatible
+ - reg
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ pwm@4005c000 {
+ compatible = "nxp,lpc3220-pwm";
+ reg = <0x4005c000 0x4>;
+ #pwm-cells = <3>;
+ };
--
2.34.1
^ permalink raw reply related [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-12 12:27 [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML Purva Yeshi
@ 2025-03-12 17:59 ` Vladimir Zapolskiy
2025-03-12 22:56 ` Uwe Kleine-König
2025-03-13 11:04 ` Krzysztof Kozlowski
2025-04-03 10:41 ` Uwe Kleine-König
2 siblings, 1 reply; 12+ messages in thread
From: Vladimir Zapolskiy @ 2025-03-12 17:59 UTC (permalink / raw)
To: Purva Yeshi, ukleinek, robh, krzk+dt, conor+dt, piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
Hello Purva.
Thank you for your contribution.
On 3/12/25 14:27, Purva Yeshi wrote:
> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
> YAML schema (`nxp,lpc3220-pwm.yaml`).
>
> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
Actually it shall be set to 1.
>
> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
> ---
> V1 - https://lore.kernel.org/all/20250311125756.24064-1-purvayeshi550@gmail.com/
> V2 - Correct filename to match the compatible string, remove unnecessary
> quotes in maintainers, and refine commit message.
>
> .../devicetree/bindings/pwm/lpc32xx-pwm.txt | 17 ---------
> .../bindings/pwm/nxp,lpc3220-pwm.yaml | 38 +++++++++++++++++++
> 2 files changed, 38 insertions(+), 17 deletions(-)
> delete mode 100644 Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
> create mode 100644 Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
>
> diff --git a/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt b/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
> deleted file mode 100644
> index 74b5bc5dd..000000000
> --- a/Documentation/devicetree/bindings/pwm/lpc32xx-pwm.txt
> +++ /dev/null
> @@ -1,17 +0,0 @@
> -LPC32XX PWM controller
> -
> -Required properties:
> -- compatible: should be "nxp,lpc3220-pwm"
> -- reg: physical base address and length of the controller's registers
> -
> -Examples:
> -
> -pwm@4005c000 {
> - compatible = "nxp,lpc3220-pwm";
> - reg = <0x4005c000 0x4>;
> -};
> -
> -pwm@4005c004 {
> - compatible = "nxp,lpc3220-pwm";
> - reg = <0x4005c004 0x4>;
> -};
> diff --git a/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
> new file mode 100644
> index 000000000..432a5e9d4
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
> @@ -0,0 +1,38 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/pwm/nxp,lpc3220-pwm.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: LPC32XX PWM controller
> +
> +maintainers:
> + - Vladimir Zapolskiy <vz@mleia.com>
> + - Piotr Wojtaszczyk <piotr.wojtaszczyk@timesys.com>
> +
> +allOf:
> + - $ref: pwm.yaml#
> +
> +properties:
> + compatible:
> + const: nxp,lpc3220-pwm
> +
> + reg:
> + maxItems: 1
> +
> + "#pwm-cells":
> + const: 3
It shall be 1.
> +
> +required:
> + - compatible
> + - reg
> +
There is an error in the original lpc32xx-pwm.txt file, one more property
"clocks" is strictly required, please add it along with the conversion.
Thank you!
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + pwm@4005c000 {
> + compatible = "nxp,lpc3220-pwm";
> + reg = <0x4005c000 0x4>;
> + #pwm-cells = <3>;
> + };
--
Best wishes,
Vladimir
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-12 17:59 ` Vladimir Zapolskiy
@ 2025-03-12 22:56 ` Uwe Kleine-König
2025-03-13 3:37 ` Vladimir Zapolskiy
0 siblings, 1 reply; 12+ messages in thread
From: Uwe Kleine-König @ 2025-03-12 22:56 UTC (permalink / raw)
To: Vladimir Zapolskiy
Cc: Purva Yeshi, robh, krzk+dt, conor+dt, piotr.wojtaszczyk,
linux-pwm, devicetree, linux-arm-kernel, linux-kernel
[-- Attachment #1: Type: text/plain, Size: 193 bytes --]
Hello,
On Wed, Mar 12, 2025 at 07:59:21PM +0200, Vladimir Zapolskiy wrote:
> > + "#pwm-cells":
> > + const: 3
>
> It shall be 1.
No, 3 is the right choice.
Best regards
Uwe
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-12 22:56 ` Uwe Kleine-König
@ 2025-03-13 3:37 ` Vladimir Zapolskiy
2025-03-13 7:22 ` Uwe Kleine-König
0 siblings, 1 reply; 12+ messages in thread
From: Vladimir Zapolskiy @ 2025-03-13 3:37 UTC (permalink / raw)
To: Uwe Kleine-König
Cc: Purva Yeshi, robh, krzk+dt, conor+dt, piotr.wojtaszczyk,
linux-pwm, devicetree, linux-arm-kernel, linux-kernel
Hi Uwe,
On 3/13/25 00:56, Uwe Kleine-König wrote:
> Hello,
>
> On Wed, Mar 12, 2025 at 07:59:21PM +0200, Vladimir Zapolskiy wrote:
>>> + "#pwm-cells":
>>> + const: 3
>>
>> It shall be 1.
>
> No, 3 is the right choice.
>
could you please elaborate?
I find that here the only configurable parameter is PWM period, so it
should be sufficient to have one cell only like in marvell,pxa-pwm.yaml
or google,cros-ec-pwm.yaml.
--
Best wishes,
Vladimir
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-13 3:37 ` Vladimir Zapolskiy
@ 2025-03-13 7:22 ` Uwe Kleine-König
0 siblings, 0 replies; 12+ messages in thread
From: Uwe Kleine-König @ 2025-03-13 7:22 UTC (permalink / raw)
To: Vladimir Zapolskiy
Cc: Purva Yeshi, robh, krzk+dt, conor+dt, piotr.wojtaszczyk,
linux-pwm, devicetree, linux-arm-kernel, linux-kernel
[-- Attachment #1: Type: text/plain, Size: 1281 bytes --]
Hello Vladimir,
On Thu, Mar 13, 2025 at 05:37:44AM +0200, Vladimir Zapolskiy wrote:
> On 3/13/25 00:56, Uwe Kleine-König wrote:
> > Hello,
> >
> > On Wed, Mar 12, 2025 at 07:59:21PM +0200, Vladimir Zapolskiy wrote:
> > > > + "#pwm-cells":
> > > > + const: 3
> > >
> > > It shall be 1.
> >
> > No, 3 is the right choice.
> >
>
> could you please elaborate?
>
> I find that here the only configurable parameter is PWM period, so it
> should be sufficient to have one cell only like in marvell,pxa-pwm.yaml
> or google,cros-ec-pwm.yaml.
These two bindings are special snow-flakes and the only drivers that
have #pwm-cells = <1>. Most other bindings use 3 and since commit
895fe4537cc8 ("pwm: Add upgrade path to #pwm-cells = <3> for users of
of_pwm_single_xlate()") (which was created for the pxa driver) the pxa
driver also supports 3 cells. The cros-ec driver even has comment about
that being ugly.
I intend to convert all bindings to use 3 soon.
While that isn't necessary for each individual piece of hardware to
provide 3 values, having a uniform binding for PWMs provides a nice user
experience and also simplifies matters with nexus nodes (see
e71e46a6f19c ("pwm: Add support for pwm nexus dt bindings")).
Best regards
Uwe
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-12 12:27 [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML Purva Yeshi
2025-03-12 17:59 ` Vladimir Zapolskiy
@ 2025-03-13 11:04 ` Krzysztof Kozlowski
2025-03-13 14:25 ` Purva Yeshi
2025-04-01 17:32 ` Purva Yeshi
2025-04-03 10:41 ` Uwe Kleine-König
2 siblings, 2 replies; 12+ messages in thread
From: Krzysztof Kozlowski @ 2025-03-13 11:04 UTC (permalink / raw)
To: Purva Yeshi, ukleinek, robh, krzk+dt, conor+dt, vz,
piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
On 12/03/2025 13:27, Purva Yeshi wrote:
> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
> YAML schema (`nxp,lpc3220-pwm.yaml`).
>
> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>
> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
> ---
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
<form letter>
This is an automated instruction, just in case, because many review tags
are being ignored. If you know the process, you can skip it (please do
not feel offended by me posting it here - no bad intentions intended).
If you do not know the process, here is a short explanation:
Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions
of patchset, under or above your Signed-off-by tag, unless patch changed
significantly (e.g. new properties added to the DT bindings). Tag is
"received", when provided in a message replied to you on the mailing
list. Tools like b4 can help here. However, there's no need to repost
patches *only* to add the tags. The upstream maintainer will do that for
tags received on the version they apply.
Full context and explanation:
https://elixir.bootlin.com/linux/v6.12-rc3/source/Documentation/process/submitting-patches.rst#L577
</form letter>
Best regards,
Krzysztof
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-13 11:04 ` Krzysztof Kozlowski
@ 2025-03-13 14:25 ` Purva Yeshi
2025-04-01 17:32 ` Purva Yeshi
1 sibling, 0 replies; 12+ messages in thread
From: Purva Yeshi @ 2025-03-13 14:25 UTC (permalink / raw)
To: Krzysztof Kozlowski, ukleinek, robh, krzk+dt, conor+dt, vz,
piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
On 13/03/25 16:34, Krzysztof Kozlowski wrote:
> On 12/03/2025 13:27, Purva Yeshi wrote:
>> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
>> YAML schema (`nxp,lpc3220-pwm.yaml`).
>>
>> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>>
>> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
>> ---
>
> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>
>
> ---
>
> <form letter>
> This is an automated instruction, just in case, because many review tags
> are being ignored. If you know the process, you can skip it (please do
> not feel offended by me posting it here - no bad intentions intended).
> If you do not know the process, here is a short explanation:
>
> Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions
> of patchset, under or above your Signed-off-by tag, unless patch changed
> significantly (e.g. new properties added to the DT bindings). Tag is
> "received", when provided in a message replied to you on the mailing
> list. Tools like b4 can help here. However, there's no need to repost
> patches *only* to add the tags. The upstream maintainer will do that for
> tags received on the version they apply.
>
> Full context and explanation:
> https://elixir.bootlin.com/linux/v6.12-rc3/source/Documentation/process/submitting-patches.rst#L577
> </form letter>
>
> Best regards,
> Krzysztof
Hi Krzysztof,
Thank you for your review! I will include your Reviewed-by tag in the
next version if no significant changes are made.
Best regards,
Purva Yeshi
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-13 11:04 ` Krzysztof Kozlowski
2025-03-13 14:25 ` Purva Yeshi
@ 2025-04-01 17:32 ` Purva Yeshi
2025-04-02 6:33 ` Krzysztof Kozlowski
1 sibling, 1 reply; 12+ messages in thread
From: Purva Yeshi @ 2025-04-01 17:32 UTC (permalink / raw)
To: Krzysztof Kozlowski, ukleinek, robh, krzk+dt, conor+dt, vz,
piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
On 13/03/25 16:34, Krzysztof Kozlowski wrote:
> On 12/03/2025 13:27, Purva Yeshi wrote:
>> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
>> YAML schema (`nxp,lpc3220-pwm.yaml`).
>>
>> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>>
>> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
>> ---
>
> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>
>
> ---
>
> <form letter>
> This is an automated instruction, just in case, because many review tags
> are being ignored. If you know the process, you can skip it (please do
> not feel offended by me posting it here - no bad intentions intended).
> If you do not know the process, here is a short explanation:
>
> Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions
> of patchset, under or above your Signed-off-by tag, unless patch changed
> significantly (e.g. new properties added to the DT bindings). Tag is
> "received", when provided in a message replied to you on the mailing
> list. Tools like b4 can help here. However, there's no need to repost
> patches *only* to add the tags. The upstream maintainer will do that for
> tags received on the version they apply.
>
> Full context and explanation:
> https://elixir.bootlin.com/linux/v6.12-rc3/source/Documentation/process/submitting-patches.rst#L577
> </form letter>
>
> Best regards,
> Krzysztof
Hello!
I wanted to follow up on the patch I submitted. I was wondering if you
had a chance to review it and if there are any comments or feedback.
Thank you for your time and consideration. I look forward to your response.
Best regards,
Purva Yeshi
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-04-01 17:32 ` Purva Yeshi
@ 2025-04-02 6:33 ` Krzysztof Kozlowski
2025-04-04 19:38 ` Purva Yeshi
0 siblings, 1 reply; 12+ messages in thread
From: Krzysztof Kozlowski @ 2025-04-02 6:33 UTC (permalink / raw)
To: Purva Yeshi, ukleinek, robh, krzk+dt, conor+dt, vz,
piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
On 01/04/2025 19:32, Purva Yeshi wrote:
> On 13/03/25 16:34, Krzysztof Kozlowski wrote:
>> On 12/03/2025 13:27, Purva Yeshi wrote:
>>> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
>>> YAML schema (`nxp,lpc3220-pwm.yaml`).
>>>
>>> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>>>
>>> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
>>> ---
>>
>> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>>
>>
>> ---
>>
>> <form letter>
>> This is an automated instruction, just in case, because many review tags
>> are being ignored. If you know the process, you can skip it (please do
>> not feel offended by me posting it here - no bad intentions intended).
>> If you do not know the process, here is a short explanation:
>>
>> Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions
>> of patchset, under or above your Signed-off-by tag, unless patch changed
>> significantly (e.g. new properties added to the DT bindings). Tag is
>> "received", when provided in a message replied to you on the mailing
>> list. Tools like b4 can help here. However, there's no need to repost
>> patches *only* to add the tags. The upstream maintainer will do that for
>> tags received on the version they apply.
>>
>> Full context and explanation:
>> https://elixir.bootlin.com/linux/v6.12-rc3/source/Documentation/process/submitting-patches.rst#L577
>> </form letter>
>>
>> Best regards,
>> Krzysztof
>
> Hello!
>
> I wanted to follow up on the patch I submitted. I was wondering if you
> had a chance to review it and if there are any comments or feedback.
And what did you quote? What's there? Did you read it before replying?
Please avoid pinging during the merge window.
Best regards,
Krzysztof
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-03-12 12:27 [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML Purva Yeshi
2025-03-12 17:59 ` Vladimir Zapolskiy
2025-03-13 11:04 ` Krzysztof Kozlowski
@ 2025-04-03 10:41 ` Uwe Kleine-König
2025-04-04 19:42 ` Purva Yeshi
2 siblings, 1 reply; 12+ messages in thread
From: Uwe Kleine-König @ 2025-04-03 10:41 UTC (permalink / raw)
To: Purva Yeshi
Cc: robh, krzk+dt, conor+dt, vz, piotr.wojtaszczyk, linux-pwm,
devicetree, linux-arm-kernel, linux-kernel
[-- Attachment #1: Type: text/plain, Size: 1986 bytes --]
Hello,
On Wed, Mar 12, 2025 at 05:57:50PM +0530, Purva Yeshi wrote:
> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
> YAML schema (`nxp,lpc3220-pwm.yaml`).
>
> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>
> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
I suggest the following commit log:
dt-bindings: pwm: Convert lpc32xx-pwm.txt to yaml format
Convert the existing plain text binding documentation for
nxp,lpc3220-pwm devices to a YAML schema.
The value #pwm-cells wasn't specified before, set it to 3 to match the
usual value for PWMs.
> diff --git a/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
> new file mode 100644
> index 000000000..432a5e9d4
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
> @@ -0,0 +1,38 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/pwm/nxp,lpc3220-pwm.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: LPC32XX PWM controller
> +
> +maintainers:
> + - Vladimir Zapolskiy <vz@mleia.com>
> + - Piotr Wojtaszczyk <piotr.wojtaszczyk@timesys.com>
> +
> +allOf:
> + - $ref: pwm.yaml#
> +
> +properties:
> + compatible:
> + const: nxp,lpc3220-pwm
> +
> + reg:
> + maxItems: 1
> +
> + "#pwm-cells":
> + const: 3
The PWMs defined in arch/arm/boot/dts/nxp/lpc/lpc32xx.dtsi also have a
clocks property and in the driver it's not optional. Can you please add
it (here, in the list of required properties and the commit log)?
> +required:
> + - compatible
> + - reg
> +
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + pwm@4005c000 {
> + compatible = "nxp,lpc3220-pwm";
> + reg = <0x4005c000 0x4>;
> + #pwm-cells = <3>;
> + };
Best regards
Uwe
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-04-02 6:33 ` Krzysztof Kozlowski
@ 2025-04-04 19:38 ` Purva Yeshi
0 siblings, 0 replies; 12+ messages in thread
From: Purva Yeshi @ 2025-04-04 19:38 UTC (permalink / raw)
To: Krzysztof Kozlowski, ukleinek, robh, krzk+dt, conor+dt, vz,
piotr.wojtaszczyk
Cc: linux-pwm, devicetree, linux-arm-kernel, linux-kernel
On 02/04/25 12:03, Krzysztof Kozlowski wrote:
> On 01/04/2025 19:32, Purva Yeshi wrote:
>> On 13/03/25 16:34, Krzysztof Kozlowski wrote:
>>> On 12/03/2025 13:27, Purva Yeshi wrote:
>>>> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
>>>> YAML schema (`nxp,lpc3220-pwm.yaml`).
>>>>
>>>> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>>>>
>>>> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
>>>> ---
>>>
>>> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>>>
>>>
>>> ---
>>>
>>> <form letter>
>>> This is an automated instruction, just in case, because many review tags
>>> are being ignored. If you know the process, you can skip it (please do
>>> not feel offended by me posting it here - no bad intentions intended).
>>> If you do not know the process, here is a short explanation:
>>>
>>> Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions
>>> of patchset, under or above your Signed-off-by tag, unless patch changed
>>> significantly (e.g. new properties added to the DT bindings). Tag is
>>> "received", when provided in a message replied to you on the mailing
>>> list. Tools like b4 can help here. However, there's no need to repost
>>> patches *only* to add the tags. The upstream maintainer will do that for
>>> tags received on the version they apply.
>>>
>>> Full context and explanation:
>>> https://elixir.bootlin.com/linux/v6.12-rc3/source/Documentation/process/submitting-patches.rst#L577
>>> </form letter>
>>>
>>> Best regards,
>>> Krzysztof
>>
>> Hello!
>>
>> I wanted to follow up on the patch I submitted. I was wondering if you
>> had a chance to review it and if there are any comments or feedback.
>
> And what did you quote? What's there? Did you read it before replying?
>
> Please avoid pinging during the merge window.
>
>
> Best regards,
> Krzysztof
Hello Krzysztof,
Apologies for the unnecessary follow-up. I’ll avoid pinging during the
merge window.
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML
2025-04-03 10:41 ` Uwe Kleine-König
@ 2025-04-04 19:42 ` Purva Yeshi
0 siblings, 0 replies; 12+ messages in thread
From: Purva Yeshi @ 2025-04-04 19:42 UTC (permalink / raw)
To: Uwe Kleine-König
Cc: robh, krzk+dt, conor+dt, vz, piotr.wojtaszczyk, linux-pwm,
devicetree, linux-arm-kernel, linux-kernel
On 03/04/25 16:11, Uwe Kleine-König wrote:
> Hello,
>
> On Wed, Mar 12, 2025 at 05:57:50PM +0530, Purva Yeshi wrote:
>> Convert the existing `lpc32xx-pwm.txt` bindings documentation into a
>> YAML schema (`nxp,lpc3220-pwm.yaml`).
>>
>> Set `"#pwm-cells"` to `const: 3` for expected PWM cell properties.
>>
>> Signed-off-by: Purva Yeshi <purvayeshi550@gmail.com>
>
> I suggest the following commit log:
>
> dt-bindings: pwm: Convert lpc32xx-pwm.txt to yaml format
>
> Convert the existing plain text binding documentation for
> nxp,lpc3220-pwm devices to a YAML schema.
>
> The value #pwm-cells wasn't specified before, set it to 3 to match the
> usual value for PWMs.
>
Hello,
Thank you for the suggestion. I'll update the commit log accordingly in
the next revision.
>> diff --git a/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
>> new file mode 100644
>> index 000000000..432a5e9d4
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/pwm/nxp,lpc3220-pwm.yaml
>> @@ -0,0 +1,38 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +%YAML 1.2
>> +---
>> +$id: http://devicetree.org/schemas/pwm/nxp,lpc3220-pwm.yaml#
>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>> +
>> +title: LPC32XX PWM controller
>> +
>> +maintainers:
>> + - Vladimir Zapolskiy <vz@mleia.com>
>> + - Piotr Wojtaszczyk <piotr.wojtaszczyk@timesys.com>
>> +
>> +allOf:
>> + - $ref: pwm.yaml#
>> +
>> +properties:
>> + compatible:
>> + const: nxp,lpc3220-pwm
>> +
>> + reg:
>> + maxItems: 1
>> +
>> + "#pwm-cells":
>> + const: 3
>
> The PWMs defined in arch/arm/boot/dts/nxp/lpc/lpc32xx.dtsi also have a
> clocks property and in the driver it's not optional. Can you please add
> it (here, in the list of required properties and the commit log)?
Thank you for the review. I’ll add the clocks property, update the list
of required properties, and adjust the commit log accordingly in the
next revision.
>
>> +required:
>> + - compatible
>> + - reg
>> +
>> +unevaluatedProperties: false
>> +
>> +examples:
>> + - |
>> + pwm@4005c000 {
>> + compatible = "nxp,lpc3220-pwm";
>> + reg = <0x4005c000 0x4>;
>> + #pwm-cells = <3>;
>> + };
>
> Best regards
> Uwe
Best regards,
Purva Yeshi
^ permalink raw reply [flat|nested] 12+ messages in thread
end of thread, other threads:[~2025-04-04 19:43 UTC | newest]
Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-03-12 12:27 [PATCH v2] dt-bindings: pwm: Convert lpc32xx-pwm.txt to YAML Purva Yeshi
2025-03-12 17:59 ` Vladimir Zapolskiy
2025-03-12 22:56 ` Uwe Kleine-König
2025-03-13 3:37 ` Vladimir Zapolskiy
2025-03-13 7:22 ` Uwe Kleine-König
2025-03-13 11:04 ` Krzysztof Kozlowski
2025-03-13 14:25 ` Purva Yeshi
2025-04-01 17:32 ` Purva Yeshi
2025-04-02 6:33 ` Krzysztof Kozlowski
2025-04-04 19:38 ` Purva Yeshi
2025-04-03 10:41 ` Uwe Kleine-König
2025-04-04 19:42 ` Purva Yeshi
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).