[PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[Jeremy Dean Clifton]

Convert the NXP PCA9685 PWM controller binding to DT schema format.

Changes from the text binding:

Document the 'reg' property and make it required. It was missing
from the text binding, although the example used it and the device
cannot work without the I2C address.

Rename the example node to the generic 'pwm', as required by
pwm.yaml.

Describe both cells of the PWM specifier, and state that 'invert'
and 'open-drain' apply to all outputs, as per the datasheet (INVRT
and OUTDRV bits in MODE2).

Assisted-by: LLM
Signed-off-by: Jeremy Dean Clifton <deaner92@yahoo.com>
---
Changes in v3:
- Full name in From, Signed-off-by and maintainers. (Jeremy Dean 
  Clifton)
v2:
https://lore.kernel.org/all/0aabb9f2-a144-4267-b67e-a0972d228f2a@yahoo.com/
though the storage width was widened.
- Use the same name in 'maintainers' as in the Signed-off-by. 

v1:
https://lore.kernel.org/all/20261006033518.34332-1-deaner92@yahoo.com/

The schema and commit message were drafted with AI assistant.
I verified each property against the driver source, the
PCA9685 datasheet and the binding. Passes make dt_binding_check.

 .../bindings/pwm/nxp,pca9685-pwm.txt          | 27 --------
 .../bindings/pwm/nxp,pca9685-pwm.yaml         | 62 +++++++++++++++++++
 2 files changed, 62 insertions(+), 27 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.txt
 create mode 100644 Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.yaml

diff --git a/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.txt b/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.txt
deleted file mode 100644
index f21b55c95738..000000000000
--- a/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-NXP PCA9685 16-channel 12-bit PWM LED controller
-================================================
-
-Required properties:
-  - compatible: "nxp,pca9685-pwm"
-  - #pwm-cells: Should be 2. See pwm.yaml in this directory for a description of
-    the cells format.
-    The index 16 is the ALLCALL channel, that sets all PWM channels at the same
-    time.
-
-Optional properties:
-  - invert (bool): boolean to enable inverted logic
-  - open-drain (bool): boolean to configure outputs with open-drain structure;
-		       if omitted use totem-pole structure
-
-Example:
-
-For LEDs that are directly connected to the PCA, the following setting is
-applicable:
-
-pca: pca@41 {
-	compatible = "nxp,pca9685-pwm";
-	#pwm-cells = <2>;
-	reg = <0x41>;
-	invert;
-	open-drain;
-};
diff --git a/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.yaml b/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.yaml
new file mode 100644
index 000000000000..04d2ddd8f108
--- /dev/null
+++ b/Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.yaml
@@ -0,0 +1,62 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pwm/nxp,pca9685-pwm.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP PCA9685 16-channel 12-bit PWM LED controller
+
+maintainers:
+  - Jeremy Dean Clifton <deaner92@yahoo.com>
+
+allOf:
+  - $ref: pwm.yaml#
+
+properties:
+  compatible:
+    const: nxp,pca9685-pwm
+
+  reg:
+    maxItems: 1
+
+  "#pwm-cells":
+    const: 2
+    description:
+      The first cell is the PWM channel index, from 0 to 15, or 16 for the
+      ALLCALL channel, which sets all PWM channels at the same time. The
+      second cell is the PWM period in nanoseconds.
+
+  invert:
+    type: boolean
+    description:
+      Invert the logic state of all outputs (INVRT bit in the MODE2
+      register). The setting applies to the whole chip, not to individual
+      channels, and is typically used when the outputs drive an external
+      driver stage.
+
+  open-drain:
+    type: boolean
+    description:
+      Configure all outputs with an open-drain structure (OUTDRV bit in the
+      MODE2 register). If omitted, the outputs use a totem-pole structure.
+
+required:
+  - compatible
+  - reg
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        pwm@41 {
+            compatible = "nxp,pca9685-pwm";
+            reg = <0x41>;
+            #pwm-cells = <2>;
+            invert;
+            open-drain;
+        };
+    };

base-commit: aac26bee2287c88af5be5a5ff96d783b19a28790
-- 
2.43.0

Re: [PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[Rob Herring (Arm)]

On Mon, 12 Oct 2026 14:03:46 +0000, Jeremy Dean Clifton wrote:
> Convert the NXP PCA9685 PWM controller binding to DT schema format.
> 
> Changes from the text binding:
> 
> Document the 'reg' property and make it required. It was missing
> from the text binding, although the example used it and the device
> cannot work without the I2C address.
> 
> Rename the example node to the generic 'pwm', as required by
> pwm.yaml.
> 
> Describe both cells of the PWM specifier, and state that 'invert'
> and 'open-drain' apply to all outputs, as per the datasheet (INVRT
> and OUTDRV bits in MODE2).
> 
> Assisted-by: LLM
> Signed-off-by: Jeremy Dean Clifton <deaner92@yahoo.com>
> ---
> Changes in v3:
> - Full name in From, Signed-off-by and maintainers. (Jeremy Dean
>   Clifton)
> v2:
> https://lore.kernel.org/all/0aabb9f2-a144-4267-b67e-a0972d228f2a@yahoo.com/
> though the storage width was widened.
> - Use the same name in 'maintainers' as in the Signed-off-by.
> 
> v1:
> https://lore.kernel.org/all/20261006033518.34332-1-deaner92@yahoo.com/
> 
> The schema and commit message were drafted with AI assistant.
> I verified each property against the driver source, the
> PCA9685 datasheet and the binding. Passes make dt_binding_check.
> 
>  .../bindings/pwm/nxp,pca9685-pwm.txt          | 27 --------
>  .../bindings/pwm/nxp,pca9685-pwm.yaml         | 62 +++++++++++++++++++
>  2 files changed, 62 insertions(+), 27 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.txt
>  create mode 100644 Documentation/devicetree/bindings/pwm/nxp,pca9685-pwm.yaml
> 

Reviewed-by: Rob Herring (Arm) <robh@kernel.org>

Re: [PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[Uwe Kleine-König]

[-- Attachment #1: Type: text/plain, Size: 255 bytes --]

Hello Jeremy,

On Mon, Oct 12, 2026 at 02:03:46PM +0000, Jeremy Dean Clifton wrote:
> +maintainers:
> +  - Jeremy Dean Clifton <deaner92@yahoo.com>

What kind of commitment do you plan for this maintainer role? Do you
have the hardware?

Best regards
Uwe

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]

Re: [PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[Jeremy Clifton]

On 10/16/26 4:33 AM, Uwe Kleine-König wrote:
> Hello Jeremy,
> 
> On Mon, Oct 12, 2026 at 02:03:46PM +0000, Jeremy Dean Clifton wrote:
>> +maintainers:
>> +  - Jeremy Dean Clifton <deaner92@yahoo.com>
> 
> What kind of commitment do you plan for this maintainer role? Do you
> have the hardware?
> 

I don't have the hardware, but I'm willing to get it and test on
it if it comes to that. I'm glad to answer questions about the binding
and to review future changes to it, also.

If you'd rather have someone closer to the driver listed as maintainer
instead, that's fine with me too. I'm happy with either possibility.

Jeremy

> Best regards
> Uwe

Re: [PATCH v3] dt-bindings: pwm: Convert NXP PCA9685 PWM controller to DT schema

[Uwe Kleine-König]

[-- Attachment #1: Type: text/plain, Size: 971 bytes --]

Hello,

On Tue, Oct 20, 2026 at 09:13:26AM -0600, Jeremy Clifton wrote:
> On 10/16/26 4:33 AM, Uwe Kleine-König wrote:
> > On Mon, Oct 12, 2026 at 02:03:46PM +0000, Jeremy Dean Clifton wrote:
> > > +maintainers:
> > > +  - Jeremy Dean Clifton <deaner92@yahoo.com>
> > 
> > What kind of commitment do you plan for this maintainer role? Do you
> > have the hardware?
> 
> I don't have the hardware, but I'm willing to get it and test on
> it if it comes to that. I'm glad to answer questions about the binding
> and to review future changes to it, also.
> 
> If you'd rather have someone closer to the driver listed as maintainer
> instead, that's fine with me too. I'm happy with either possibility.

I want that role combinded with the driver maintenance, so for now let's
put me. If you want to take a responsibility here, please start working
on it. With a track record you can take maintainership at a later point
in time.

Best regards
Uwe


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]