mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to YAML
@ 2024-10-16  5:29 Delphine CC Chiu
  2024-10-16  7:30 ` Krzysztof Kozlowski
  0 siblings, 1 reply; 3+ messages in thread
From: Delphine CC Chiu @ 2024-10-16  5:29 UTC (permalink / raw)
  To: patrick, Pavel Machek, Lee Jones, Rob Herring,
	Krzysztof Kozlowski, Conor Dooley, Nate Case
  Cc: Ricky CX Wu, Delphine CC Chiu, linux-leds, devicetree, linux-kernel

From: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>

Convert the text bindings of pca955x to YAML so it could be used to
validate the DTS.

Signed-off-by: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>
Signed-off-by: Delphine CC Chiu <Delphine_CC_Chiu@wiwynn.com>
---
 .../devicetree/bindings/leds/leds-pca955x.txt |  89 ----------
 .../devicetree/bindings/leds/nxp,pca955x.yaml | 161 ++++++++++++++++++
 2 files changed, 161 insertions(+), 89 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/leds/leds-pca955x.txt
 create mode 100644 Documentation/devicetree/bindings/leds/nxp,pca955x.yaml

diff --git a/Documentation/devicetree/bindings/leds/leds-pca955x.txt b/Documentation/devicetree/bindings/leds/leds-pca955x.txt
deleted file mode 100644
index 817f460f3a72..000000000000
--- a/Documentation/devicetree/bindings/leds/leds-pca955x.txt
+++ /dev/null
@@ -1,89 +0,0 @@
-* NXP - pca955x LED driver
-
-The PCA955x family of chips are I2C LED blinkers whose pins not used
-to control LEDs can be used as general purpose I/Os. The GPIO pins can
-be input or output, and output pins can also be pulse-width controlled.
-
-Required properties:
-- compatible : should be one of :
-	"nxp,pca9550"
-	"nxp,pca9551"
-	"nxp,pca9552"
-	"ibm,pca9552"
-	"nxp,pca9553"
-- #address-cells: must be 1
-- #size-cells: must be 0
-- reg: I2C slave address. depends on the model.
-
-Optional properties:
-- gpio-controller: allows pins to be used as GPIOs.
-- #gpio-cells: must be 2.
-- gpio-line-names: define the names of the GPIO lines
-
-LED sub-node properties:
-- reg : number of LED line.
-		from 0 to  1 for the pca9550
-		from 0 to  7 for the pca9551
-		from 0 to 15 for the pca9552
-		from 0 to  3 for the pca9553
-- type: (optional) either
-	PCA955X_TYPE_NONE
-	PCA955X_TYPE_LED
-	PCA955X_TYPE_GPIO
-	see dt-bindings/leds/leds-pca955x.h (default to LED)
-- label : (optional)
-	see Documentation/devicetree/bindings/leds/common.txt
-- linux,default-trigger : (optional)
-	see Documentation/devicetree/bindings/leds/common.txt
-
-Examples:
-
-pca9552: pca9552@60 {
-	compatible = "nxp,pca9552";
-	#address-cells = <1>;
-        #size-cells = <0>;
-	reg = <0x60>;
-
-	gpio-controller;
-	#gpio-cells = <2>;
-	gpio-line-names = "GPIO12", "GPIO13", "GPIO14", "GPIO15";
-
-	gpio@12 {
-		reg = <12>;
-		type = <PCA955X_TYPE_GPIO>;
-	};
-	gpio@13 {
-		reg = <13>;
-		type = <PCA955X_TYPE_GPIO>;
-	};
-	gpio@14 {
-		reg = <14>;
-		type = <PCA955X_TYPE_GPIO>;
-	};
-	gpio@15 {
-		reg = <15>;
-		type = <PCA955X_TYPE_GPIO>;
-	};
-
-	led@0 {
-		label = "red:power";
-		linux,default-trigger = "default-on";
-		reg = <0>;
-		type = <PCA955X_TYPE_LED>;
-	};
-	led@1 {
-		label = "green:power";
-		reg = <1>;
-		type = <PCA955X_TYPE_LED>;
-	};
-	led@2 {
-		label = "pca9552:yellow";
-		reg = <2>;
-		type = <PCA955X_TYPE_LED>;
-	};
-	led@3 {
-		label = "pca9552:white";
-		reg = <3>;
-		type = <PCA955X_TYPE_LED>;
-	};
-};
diff --git a/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
new file mode 100644
index 000000000000..70f8c1dfa75a
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
@@ -0,0 +1,161 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/nxp,pca955x.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP PCA955X LED controllers
+
+maintainers:
+  - Nate Case <ncase@xes-inc.com>
+
+description: |
+  The PCA955x family of chips are I2C LED blinkers whose pins not used
+  to control LEDs can be used as general purpose I/Os. The GPIO pins can
+  be input or output, and output pins can also be pulse-width controlled.
+
+  For more product information please see the link below:
+  - https://www.nxp.com/docs/en/data-sheet/PCA9552.pdf
+
+properties:
+  compatible:
+    enum:
+      - nxp,pca9550
+      - nxp,pca9551
+      - nxp,pca9552
+      - ibm,pca9552
+      - nxp,pca9553
+
+  reg:
+    maxItems: 1
+
+  "#address-cells":
+    const: 1
+
+  "#size-cells":
+    const: 0
+
+  gpio-controller: true
+
+  gpio-line-names:
+    minItems: 1
+    maxItems: 16
+
+  '#gpio-cells':
+    const: 2
+
+patternProperties:
+  "^led@[0-9a-f]+$":
+    type: object
+    $ref: common.yaml#
+    unevaluatedProperties: false
+
+    properties:
+      reg:
+        minimum: 0
+      type:
+        description: |
+          Output configuration, see include/dt-bindings/leds/leds-pca955x.h
+        $ref: /schemas/types.yaml#/definitions/uint32
+        default: 0
+        minimum: 0
+        maximum: 4
+
+    required:
+      - reg
+
+allOf:
+  - if:
+      properties:
+        compatible:
+          contains:
+            enum:
+              - nxp,pca9550
+    then:
+      patternProperties:
+        "^led@[0-9a-f]+$":
+          properties:
+            reg:
+              maximum: 1
+    else:
+      if:
+        properties:
+          compatible:
+            contains:
+              enum:
+                - nxp,pca9551
+      then:
+        patternProperties:
+          "^led@[0-9a-f]+$":
+            properties:
+              reg:
+                maximum: 7
+      else:
+        if:
+          properties:
+            compatible:
+              contains:
+                enum:
+                  - nxp,pca9552
+                  - ibm,pca9552
+        then:
+          patternProperties:
+            "^led@[0-9a-f]+$":
+              properties:
+                reg:
+                  maximum: 15
+        else:
+          if:
+            properties:
+              compatible:
+                contains:
+                  enum:
+                    - nxp,pca9553
+          then:
+            patternProperties:
+              "^led@[0-9a-f]+$":
+                properties:
+                  reg:
+                    maximum: 3
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/leds/leds-pca955x.h>
+
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        led-controller@60 {
+            compatible = "nxp,pca9552";
+            reg = <0x60>;
+            #address-cells = <1>;
+            #size-cells = <0>;
+
+            led@0 {
+                reg = <0>;
+                label = "red:power";
+                linux,default-trigger = "default-on";
+                type = <PCA955X_TYPE_LED>;
+            };
+            led@1 {
+                reg = <1>;
+                label = "green:power";
+                type = <PCA955X_TYPE_LED>;
+            };
+            led@2 {
+                reg = <2>;
+                label = "pca9552:yellow";
+                type = <PCA955X_TYPE_LED>;
+            };
+            led@3 {
+                reg = <3>;
+                label = "pca9552:white";
+                type = <PCA955X_TYPE_LED>;
+            };
+        };
+    };
+
+...
-- 
2.25.1


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

* Re: [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to YAML
  2024-10-16  5:29 [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to YAML Delphine CC Chiu
@ 2024-10-16  7:30 ` Krzysztof Kozlowski
  2024-10-16  9:38   ` Delphine_CC_Chiu/WYHQ/Wiwynn
  0 siblings, 1 reply; 3+ messages in thread
From: Krzysztof Kozlowski @ 2024-10-16  7:30 UTC (permalink / raw)
  To: Delphine CC Chiu
  Cc: patrick, Pavel Machek, Lee Jones, Rob Herring,
	Krzysztof Kozlowski, Conor Dooley, Nate Case, Ricky CX Wu,
	linux-leds, devicetree, linux-kernel

On Wed, Oct 16, 2024 at 01:29:38PM +0800, Delphine CC Chiu wrote:
> From: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>
> 
> Convert the text bindings of pca955x to YAML so it could be used to
> validate the DTS.
> 
> Signed-off-by: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>
> Signed-off-by: Delphine CC Chiu <Delphine_CC_Chiu@wiwynn.com>
> ---
>  .../devicetree/bindings/leds/leds-pca955x.txt |  89 ----------
>  .../devicetree/bindings/leds/nxp,pca955x.yaml | 161 ++++++++++++++++++
>  2 files changed, 161 insertions(+), 89 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/leds/leds-pca955x.txt
>  create mode 100644 Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> 
> diff --git a/Documentation/devicetree/bindings/leds/leds-pca955x.txt b/Documentation/devicetree/bindings/leds/leds-pca955x.txt
> deleted file mode 100644
> index 817f460f3a72..000000000000
> --- a/Documentation/devicetree/bindings/leds/leds-pca955x.txt
> +++ /dev/null
> @@ -1,89 +0,0 @@
> -* NXP - pca955x LED driver
> -
> -The PCA955x family of chips are I2C LED blinkers whose pins not used
> -to control LEDs can be used as general purpose I/Os. The GPIO pins can
> -be input or output, and output pins can also be pulse-width controlled.
> -
> -Required properties:
> -- compatible : should be one of :
> -	"nxp,pca9550"
> -	"nxp,pca9551"
> -	"nxp,pca9552"
> -	"ibm,pca9552"
> -	"nxp,pca9553"
> -- #address-cells: must be 1
> -- #size-cells: must be 0
> -- reg: I2C slave address. depends on the model.
> -
> -Optional properties:
> -- gpio-controller: allows pins to be used as GPIOs.
> -- #gpio-cells: must be 2.
> -- gpio-line-names: define the names of the GPIO lines
> -
> -LED sub-node properties:
> -- reg : number of LED line.
> -		from 0 to  1 for the pca9550
> -		from 0 to  7 for the pca9551
> -		from 0 to 15 for the pca9552
> -		from 0 to  3 for the pca9553
> -- type: (optional) either
> -	PCA955X_TYPE_NONE
> -	PCA955X_TYPE_LED
> -	PCA955X_TYPE_GPIO
> -	see dt-bindings/leds/leds-pca955x.h (default to LED)
> -- label : (optional)
> -	see Documentation/devicetree/bindings/leds/common.txt
> -- linux,default-trigger : (optional)
> -	see Documentation/devicetree/bindings/leds/common.txt
> -
> -Examples:
> -
> -pca9552: pca9552@60 {
> -	compatible = "nxp,pca9552";
> -	#address-cells = <1>;
> -        #size-cells = <0>;
> -	reg = <0x60>;
> -
> -	gpio-controller;
> -	#gpio-cells = <2>;
> -	gpio-line-names = "GPIO12", "GPIO13", "GPIO14", "GPIO15";
> -
> -	gpio@12 {
> -		reg = <12>;
> -		type = <PCA955X_TYPE_GPIO>;
> -	};
> -	gpio@13 {
> -		reg = <13>;
> -		type = <PCA955X_TYPE_GPIO>;
> -	};
> -	gpio@14 {
> -		reg = <14>;
> -		type = <PCA955X_TYPE_GPIO>;
> -	};
> -	gpio@15 {
> -		reg = <15>;
> -		type = <PCA955X_TYPE_GPIO>;
> -	};
> -
> -	led@0 {
> -		label = "red:power";
> -		linux,default-trigger = "default-on";
> -		reg = <0>;
> -		type = <PCA955X_TYPE_LED>;
> -	};
> -	led@1 {
> -		label = "green:power";
> -		reg = <1>;
> -		type = <PCA955X_TYPE_LED>;
> -	};
> -	led@2 {
> -		label = "pca9552:yellow";
> -		reg = <2>;
> -		type = <PCA955X_TYPE_LED>;
> -	};
> -	led@3 {
> -		label = "pca9552:white";
> -		reg = <3>;
> -		type = <PCA955X_TYPE_LED>;
> -	};
> -};
> diff --git a/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> new file mode 100644
> index 000000000000..70f8c1dfa75a
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> @@ -0,0 +1,161 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/leds/nxp,pca955x.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: NXP PCA955X LED controllers
> +
> +maintainers:
> +  - Nate Case <ncase@xes-inc.com>
> +
> +description: |
> +  The PCA955x family of chips are I2C LED blinkers whose pins not used
> +  to control LEDs can be used as general purpose I/Os. The GPIO pins can
> +  be input or output, and output pins can also be pulse-width controlled.
> +
> +  For more product information please see the link below:
> +  - https://www.nxp.com/docs/en/data-sheet/PCA9552.pdf
> +
> +properties:
> +  compatible:
> +    enum:
> +      - nxp,pca9550
> +      - nxp,pca9551
> +      - nxp,pca9552
> +      - ibm,pca9552
> +      - nxp,pca9553
> +
> +  reg:
> +    maxItems: 1
> +
> +  "#address-cells":
> +    const: 1
> +
> +  "#size-cells":
> +    const: 0
> +
> +  gpio-controller: true
> +
> +  gpio-line-names:
> +    minItems: 1
> +    maxItems: 16
> +
> +  '#gpio-cells':

Keep consistent quotes: " or '

> +    const: 2
> +
> +patternProperties:
> +  "^led@[0-9a-f]+$":

max is 15 leds, so f, thus '+' is not needed. Same in other places.

> +    type: object
> +    $ref: common.yaml#
> +    unevaluatedProperties: false
> +
> +    properties:
> +      reg:
> +        minimum: 0

drop minimum, but instead maxItems: 1


> +      type:
> +        description: |
> +          Output configuration, see include/dt-bindings/leds/leds-pca955x.h
> +        $ref: /schemas/types.yaml#/definitions/uint32
> +        default: 0
> +        minimum: 0
> +        maximum: 4

I see defines up to 2, not 4. Any changes in binding should be explained
in commit msg.


> +
> +    required:
> +      - reg
> +
> +allOf:
> +  - if:
> +      properties:
> +        compatible:
> +          contains:
> +            enum:
> +              - nxp,pca9550
> +    then:
> +      patternProperties:
> +        "^led@[0-9a-f]+$":
> +          properties:
> +            reg:
> +              maximum: 1
> +    else:
> +      if:
> +        properties:
> +          compatible:
> +            contains:
> +              enum:
> +                - nxp,pca9551
> +      then:
> +        patternProperties:
> +          "^led@[0-9a-f]+$":
> +            properties:
> +              reg:
> +                maximum: 7
> +      else:
> +        if:
> +          properties:
> +            compatible:
> +              contains:
> +                enum:
> +                  - nxp,pca9552
> +                  - ibm,pca9552
> +        then:
> +          patternProperties:
> +            "^led@[0-9a-f]+$":
> +              properties:
> +                reg:
> +                  maximum: 15
> +        else:
> +          if:

Do not nest else:if. It's not manageable. See other bindings...

> +            properties:
> +              compatible:
> +                contains:
> +                  enum:
> +                    - nxp,pca9553
> +          then:
> +            patternProperties:
> +              "^led@[0-9a-f]+$":
> +                properties:
> +                  reg:
> +                    maximum: 3
> +
> +additionalProperties: false

Best regards,
Krzysztof


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

* RE: [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to YAML
  2024-10-16  7:30 ` Krzysztof Kozlowski
@ 2024-10-16  9:38   ` Delphine_CC_Chiu/WYHQ/Wiwynn
  0 siblings, 0 replies; 3+ messages in thread
From: Delphine_CC_Chiu/WYHQ/Wiwynn @ 2024-10-16  9:38 UTC (permalink / raw)
  To: Krzysztof Kozlowski, Delphine_CC_Chiu/WYHQ/Wiwynn
  Cc: patrick, Pavel Machek, Lee Jones, Rob Herring,
	Krzysztof Kozlowski, Conor Dooley, Nate Case, Ricky CX Wu,
	linux-leds, devicetree, linux-kernel



> -----Original Message-----
> From: Krzysztof Kozlowski <krzk@kernel.org>
> Sent: Wednesday, October 16, 2024 3:31 PM
> To: Delphine_CC_Chiu/WYHQ/Wiwynn <Delphine_CC_Chiu@wiwynn.com>
> Cc: patrick@stwcx.xyz; Pavel Machek <pavel@ucw.cz>; Lee Jones
> <lee@kernel.org>; Rob Herring <robh@kernel.org>; Krzysztof Kozlowski
> <krzk+dt@kernel.org>; Conor Dooley <conor+dt@kernel.org>; Nate Case
> <ncase@xes-inc.com>; Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>;
> linux-leds@vger.kernel.org; devicetree@vger.kernel.org;
> linux-kernel@vger.kernel.org
> Subject: Re: [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to
> YAML
> 
>  [External Sender]
> 
>  [External Sender]
> 
> On Wed, Oct 16, 2024 at 01:29:38PM +0800, Delphine CC Chiu wrote:
> > From: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>
> >
> > Convert the text bindings of pca955x to YAML so it could be used to
> > validate the DTS.
> >
> > Signed-off-by: Ricky CX Wu <ricky.cx.wu.wiwynn@gmail.com>
> > Signed-off-by: Delphine CC Chiu <Delphine_CC_Chiu@wiwynn.com>
> > ---
> >  .../devicetree/bindings/leds/leds-pca955x.txt |  89 ----------
> > .../devicetree/bindings/leds/nxp,pca955x.yaml | 161 ++++++++++++++++++
> >  2 files changed, 161 insertions(+), 89 deletions(-)  delete mode
> > 100644 Documentation/devicetree/bindings/leds/leds-pca955x.txt
> >  create mode 100644
> > Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/leds/leds-pca955x.txt
> > b/Documentation/devicetree/bindings/leds/leds-pca955x.txt
> > deleted file mode 100644
> > index 817f460f3a72..000000000000
> > --- a/Documentation/devicetree/bindings/leds/leds-pca955x.txt
> > +++ /dev/null
> > @@ -1,89 +0,0 @@
> > -* NXP - pca955x LED driver
> > -
> > -The PCA955x family of chips are I2C LED blinkers whose pins not used
> > -to control LEDs can be used as general purpose I/Os. The GPIO pins
> > can -be input or output, and output pins can also be pulse-width controlled.
> > -
> > -Required properties:
> > -- compatible : should be one of :
> > -     "nxp,pca9550"
> > -     "nxp,pca9551"
> > -     "nxp,pca9552"
> > -     "ibm,pca9552"
> > -     "nxp,pca9553"
> > -- #address-cells: must be 1
> > -- #size-cells: must be 0
> > -- reg: I2C slave address. depends on the model.
> > -
> > -Optional properties:
> > -- gpio-controller: allows pins to be used as GPIOs.
> > -- #gpio-cells: must be 2.
> > -- gpio-line-names: define the names of the GPIO lines
> > -
> > -LED sub-node properties:
> > -- reg : number of LED line.
> > -             from 0 to  1 for the pca9550
> > -             from 0 to  7 for the pca9551
> > -             from 0 to 15 for the pca9552
> > -             from 0 to  3 for the pca9553
> > -- type: (optional) either
> > -     PCA955X_TYPE_NONE
> > -     PCA955X_TYPE_LED
> > -     PCA955X_TYPE_GPIO
> > -     see dt-bindings/leds/leds-pca955x.h (default to LED)
> > -- label : (optional)
> > -     see Documentation/devicetree/bindings/leds/common.txt
> > -- linux,default-trigger : (optional)
> > -     see Documentation/devicetree/bindings/leds/common.txt
> > -
> > -Examples:
> > -
> > -pca9552: pca9552@60 {
> > -     compatible = "nxp,pca9552";
> > -     #address-cells = <1>;
> > -        #size-cells = <0>;
> > -     reg = <0x60>;
> > -
> > -     gpio-controller;
> > -     #gpio-cells = <2>;
> > -     gpio-line-names = "GPIO12", "GPIO13", "GPIO14", "GPIO15";
> > -
> > -     gpio@12 {
> > -             reg = <12>;
> > -             type = <PCA955X_TYPE_GPIO>;
> > -     };
> > -     gpio@13 {
> > -             reg = <13>;
> > -             type = <PCA955X_TYPE_GPIO>;
> > -     };
> > -     gpio@14 {
> > -             reg = <14>;
> > -             type = <PCA955X_TYPE_GPIO>;
> > -     };
> > -     gpio@15 {
> > -             reg = <15>;
> > -             type = <PCA955X_TYPE_GPIO>;
> > -     };
> > -
> > -     led@0 {
> > -             label = "red:power";
> > -             linux,default-trigger = "default-on";
> > -             reg = <0>;
> > -             type = <PCA955X_TYPE_LED>;
> > -     };
> > -     led@1 {
> > -             label = "green:power";
> > -             reg = <1>;
> > -             type = <PCA955X_TYPE_LED>;
> > -     };
> > -     led@2 {
> > -             label = "pca9552:yellow";
> > -             reg = <2>;
> > -             type = <PCA955X_TYPE_LED>;
> > -     };
> > -     led@3 {
> > -             label = "pca9552:white";
> > -             reg = <3>;
> > -             type = <PCA955X_TYPE_LED>;
> > -     };
> > -};
> > diff --git a/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> > b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> > new file mode 100644
> > index 000000000000..70f8c1dfa75a
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/leds/nxp,pca955x.yaml
> > @@ -0,0 +1,161 @@
> > +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause %YAML 1.2
> > +---
> > +$id:
> > +https://urldefense.com/v3/__http://devicetree.org/schemas/leds/nxp,pc
> >
> +a955x.yaml*__;Iw!!J63qqgXj!PIbrsq8E67aNk4sJHGvfkCqhXd5PNeLXGzE4uXNe
> V5
> > +8pCETmSSk3Dxy1prR7fHmTRgTTAKMXAxas54MARw$
> > +$schema:
> > +https://urldefense.com/v3/__http://devicetree.org/meta-schemas/core.y
> >
> +aml*__;Iw!!J63qqgXj!PIbrsq8E67aNk4sJHGvfkCqhXd5PNeLXGzE4uXNeV58pCE
> TmS
> > +Sk3Dxy1prR7fHmTRgTTAKMXAxagMegPKw$
> > +
> > +title: NXP PCA955X LED controllers
> > +
> > +maintainers:
> > +  - Nate Case <ncase@xes-inc.com>
> > +
> > +description: |
> > +  The PCA955x family of chips are I2C LED blinkers whose pins not
> > +used
> > +  to control LEDs can be used as general purpose I/Os. The GPIO pins
> > +can
> > +  be input or output, and output pins can also be pulse-width controlled.
> > +
> > +  For more product information please see the link below:
> > +  -
> > + https://urldefense.com/v3/__https://www.nxp.com/docs/en/data-sheet/P
> > +
> CA9552.pdf__;!!J63qqgXj!PIbrsq8E67aNk4sJHGvfkCqhXd5PNeLXGzE4uXNeV58p
> > + CETmSSk3Dxy1prR7fHmTRgTTAKMXAxbzCK6mRw$
> > +
> > +properties:
> > +  compatible:
> > +    enum:
> > +      - nxp,pca9550
> > +      - nxp,pca9551
> > +      - nxp,pca9552
> > +      - ibm,pca9552
> > +      - nxp,pca9553
> > +
> > +  reg:
> > +    maxItems: 1
> > +
> > +  "#address-cells":
> > +    const: 1
> > +
> > +  "#size-cells":
> > +    const: 0
> > +
> > +  gpio-controller: true
> > +
> > +  gpio-line-names:
> > +    minItems: 1
> > +    maxItems: 16
> > +
> > +  '#gpio-cells':
> 
> Keep consistent quotes: " or '
> 
Updated in v2.
> > +    const: 2
> > +
> > +patternProperties:
> > +  "^led@[0-9a-f]+$":
> 
> max is 15 leds, so f, thus '+' is not needed. Same in other places.
> 
Updated in v2.
> > +    type: object
> > +    $ref: common.yaml#
> > +    unevaluatedProperties: false
> > +
> > +    properties:
> > +      reg:
> > +        minimum: 0
> 
> drop minimum, but instead maxItems: 1
> 
Updated in v2.
> 
> > +      type:
> > +        description: |
> > +          Output configuration, see
> include/dt-bindings/leds/leds-pca955x.h
> > +        $ref: /schemas/types.yaml#/definitions/uint32
> > +        default: 0
> > +        minimum: 0
> > +        maximum: 4
> 
> I see defines up to 2, not 4. Any changes in binding should be explained in
> commit msg.
Checked the leds-pca955x.h and set it to 2 in v2.
> 
> 
> > +
> > +    required:
> > +      - reg
> > +
> > +allOf:
> > +  - if:
> > +      properties:
> > +        compatible:
> > +          contains:
> > +            enum:
> > +              - nxp,pca9550
> > +    then:
> > +      patternProperties:
> > +        "^led@[0-9a-f]+$":
> > +          properties:
> > +            reg:
> > +              maximum: 1
> > +    else:
> > +      if:
> > +        properties:
> > +          compatible:
> > +            contains:
> > +              enum:
> > +                - nxp,pca9551
> > +      then:
> > +        patternProperties:
> > +          "^led@[0-9a-f]+$":
> > +            properties:
> > +              reg:
> > +                maximum: 7
> > +      else:
> > +        if:
> > +          properties:
> > +            compatible:
> > +              contains:
> > +                enum:
> > +                  - nxp,pca9552
> > +                  - ibm,pca9552
> > +        then:
> > +          patternProperties:
> > +            "^led@[0-9a-f]+$":
> > +              properties:
> > +                reg:
> > +                  maximum: 15
> > +        else:
> > +          if:
> 
> Do not nest else:if. It's not manageable. See other bindings...
> 
Updated in v2, Thanks.
> > +            properties:
> > +              compatible:
> > +                contains:
> > +                  enum:
> > +                    - nxp,pca9553
> > +          then:
> > +            patternProperties:
> > +              "^led@[0-9a-f]+$":
> > +                properties:
> > +                  reg:
> > +                    maximum: 3
> > +
> > +additionalProperties: false
> 
> Best regards,
> Krzysztof


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

end of thread, other threads:[~2024-10-16  9:38 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-10-16  5:29 [PATCH v1] dt-bindings: leds: pca955x: Convert text bindings to YAML Delphine CC Chiu
2024-10-16  7:30 ` Krzysztof Kozlowski
2024-10-16  9:38   ` Delphine_CC_Chiu/WYHQ/Wiwynn

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®