diff mbox series

[2/2] dt-bindings: hwmon: pmbus: pli209bc: Add bindings

Message ID 20241015113329.667831-2-naresh.solanki@9elements.com (mailing list archive)
State Changes Requested
Headers show
Series None | expand

Commit Message

Naresh Solanki Oct. 15, 2024, 11:33 a.m. UTC
Add bindings for Vicor pli1209bc.
It a Digital Supervisor with Isolation for use with BCM Bus Converter
Modules.

Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
---
 .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml

Comments

Krzysztof Kozlowski Oct. 15, 2024, 11:48 a.m. UTC | #1
On 15/10/2024 13:33, Naresh Solanki wrote:
> Add bindings for Vicor pli1209bc.
> It a Digital Supervisor with Isolation for use with BCM Bus Converter
> Modules.
> 
> Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
> ---
>  .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++

This has to be squashed with previous patch.

>  1 file changed, 65 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> new file mode 100644
> index 000000000000..3647d14e9111
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> @@ -0,0 +1,65 @@
> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +

Drop blank line

> +$id: http://devicetree.org/schemas/hwmon/pmbus/vicor,pli1209bc.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Vicor PLI1209BC Power Regulator
> +
> +maintainers:
> +  - Marcello Sylvester Bauer <sylv@sylv.io>
> +  - Naresh Solanki <naresh.solanki@9elements.com>
> +
> +description: |

Do not need '|' unless you need to preserve formatting.

> +  The Vicor PLI1209BC is a Digital Supervisor with Isolation for use
> +  with BCM Bus Converter Modules.
> +
> +properties:
> +  compatible:
> +    enum:
> +      - vicor,pli1209bc
> +
> +  reg:
> +    maxItems: 1
> +
> +  regulators:

Drop the node and define vout2 here directly.... unless anything needs
such layout? Then explain this in commit msg.

> +    type: object
> +    description:
> +      List of regulators provided by this controller.
> +
> +    properties:
> +      vout2:
> +        $ref: /schemas/regulator/regulator.yaml#
> +        type: object
> +

Drop blank line.

> +        unevaluatedProperties: false
> +
> +    additionalProperties: false
> +
> +required:
> +  - compatible
> +  - reg
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    #include <dt-bindings/interrupt-controller/irq.h>

Drop, not used.

> +    i2c {
> +        #address-cells = <1>;
> +        #size-cells = <0>;
> +
> +        pli1209bc_p12v_d: regulator@5f {

Drop unused prefix

> +            compatible = "vicor,pli1209bc";
> +            reg = <0x5f>;
> +
> +            regulators {
> +                p12v_d: vout2 {
> +                    regulator-name = "bcm3";
> +                    regulator-boot-on;
> +                };
> +            };
> +        };
> +    };
> +

Best regards,
Krzysztof
Guenter Roeck Oct. 15, 2024, 2:10 p.m. UTC | #2
On 10/15/24 04:48, Krzysztof Kozlowski wrote:
> On 15/10/2024 13:33, Naresh Solanki wrote:
>> Add bindings for Vicor pli1209bc.
>> It a Digital Supervisor with Isolation for use with BCM Bus Converter
>> Modules.
>>
>> Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
>> ---
>>   .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++
> 
> This has to be squashed with previous patch.
> 

Neither me nor the hwmon mailing list was copied on that previous patch
(or on an intro patch if there was one), so I have no idea what this
is about.

Guenter
Krzysztof Kozlowski Oct. 15, 2024, 2:49 p.m. UTC | #3
On 15/10/2024 16:10, Guenter Roeck wrote:
> On 10/15/24 04:48, Krzysztof Kozlowski wrote:
>> On 15/10/2024 13:33, Naresh Solanki wrote:
>>> Add bindings for Vicor pli1209bc.
>>> It a Digital Supervisor with Isolation for use with BCM Bus Converter
>>> Modules.
>>>
>>> Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
>>> ---
>>>   .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++
>>
>> This has to be squashed with previous patch.
>>
> 
> Neither me nor the hwmon mailing list was copied on that previous patch
> (or on an intro patch if there was one), so I have no idea what this
> is about.

Heh... that's even worse because without that visibility you would pick
up this patch only leading to duplicated compatibles warnings.

Naresh, sending such patchsets is really not correct. Be sure you
organize them logically and in fully bisectable way, and then you CC
relevant people.

Best regards,
Krzysztof
Naresh Solanki Oct. 16, 2024, 9:50 a.m. UTC | #4
Hi Krzysztof, Guenter,

On Tue, 15 Oct 2024 at 20:19, Krzysztof Kozlowski <krzk@kernel.org> wrote:
>
> On 15/10/2024 16:10, Guenter Roeck wrote:
> > On 10/15/24 04:48, Krzysztof Kozlowski wrote:
> >> On 15/10/2024 13:33, Naresh Solanki wrote:
> >>> Add bindings for Vicor pli1209bc.
> >>> It a Digital Supervisor with Isolation for use with BCM Bus Converter
> >>> Modules.
> >>>
> >>> Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
> >>> ---
> >>>   .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++
> >>
> >> This has to be squashed with previous patch.
Ack
> >>
> >
> > Neither me nor the hwmon mailing list was copied on that previous patch
> > (or on an intro patch if there was one), so I have no idea what this
> > is about.
>
> Heh... that's even worse because without that visibility you would pick
> up this patch only leading to duplicated compatibles warnings.
>
> Naresh, sending such patchsets is really not correct. Be sure you
> organize them logically and in fully bisectable way, and then you CC
> relevant people.
Yes this definitely causes confusion. I should have organised it better.
Will make sure I handle it properly. Pardon me for the confusion

Thanks
Naresh
>
> Best regards,
> Krzysztof
>
Naresh Solanki Oct. 16, 2024, 10:20 a.m. UTC | #5
Hi Krzysztof,

On Tue, 15 Oct 2024 at 17:18, Krzysztof Kozlowski <krzk@kernel.org> wrote:
>
> On 15/10/2024 13:33, Naresh Solanki wrote:
> > Add bindings for Vicor pli1209bc.
> > It a Digital Supervisor with Isolation for use with BCM Bus Converter
> > Modules.
> >
> > Signed-off-by: Naresh Solanki <naresh.solanki@9elements.com>
> > ---
> >  .../bindings/hwmon/pmbus/vicor,pli1209bc.yaml | 65 +++++++++++++++++++
>
> This has to be squashed with previous patch.
>
> >  1 file changed, 65 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> > new file mode 100644
> > index 000000000000..3647d14e9111
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
> > @@ -0,0 +1,65 @@
> > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +
>
> Drop blank line
Ack
>
> > +$id: http://devicetree.org/schemas/hwmon/pmbus/vicor,pli1209bc.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: Vicor PLI1209BC Power Regulator
> > +
> > +maintainers:
> > +  - Marcello Sylvester Bauer <sylv@sylv.io>
> > +  - Naresh Solanki <naresh.solanki@9elements.com>
> > +
> > +description: |
>
> Do not need '|' unless you need to preserve formatting.
Ack
>
> > +  The Vicor PLI1209BC is a Digital Supervisor with Isolation for use
> > +  with BCM Bus Converter Modules.
> > +
> > +properties:
> > +  compatible:
> > +    enum:
> > +      - vicor,pli1209bc
> > +
> > +  reg:
> > +    maxItems: 1
> > +
> > +  regulators:
>
> Drop the node and define vout2 here directly.... unless anything needs
> such layout? Then explain this in commit msg.
This is expected by pmbus regulator driver:
https://github.com/torvalds/linux/blob/master/drivers/hwmon/pmbus/pmbus.h#L512
>
> > +    type: object
> > +    description:
> > +      List of regulators provided by this controller.
> > +
> > +    properties:
> > +      vout2:
> > +        $ref: /schemas/regulator/regulator.yaml#
> > +        type: object
> > +
>
> Drop blank line.
Ack
>
> > +        unevaluatedProperties: false
> > +
> > +    additionalProperties: false
> > +
> > +required:
> > +  - compatible
> > +  - reg
> > +
> > +additionalProperties: false
> > +
> > +examples:
> > +  - |
> > +    #include <dt-bindings/interrupt-controller/irq.h>
>
> Drop, not used.
Ack
>
> > +    i2c {
> > +        #address-cells = <1>;
> > +        #size-cells = <0>;
> > +
> > +        pli1209bc_p12v_d: regulator@5f {
>
> Drop unused prefix
Ack

Regards,
Naresh
>
> > +            compatible = "vicor,pli1209bc";
> > +            reg = <0x5f>;
> > +
> > +            regulators {
> > +                p12v_d: vout2 {
> > +                    regulator-name = "bcm3";
> > +                    regulator-boot-on;
> > +                };
> > +            };
> > +        };
> > +    };
> > +
>
> Best regards,
> Krzysztof
>
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
new file mode 100644
index 000000000000..3647d14e9111
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/pmbus/vicor,pli1209bc.yaml
@@ -0,0 +1,65 @@ 
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+
+$id: http://devicetree.org/schemas/hwmon/pmbus/vicor,pli1209bc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Vicor PLI1209BC Power Regulator
+
+maintainers:
+  - Marcello Sylvester Bauer <sylv@sylv.io>
+  - Naresh Solanki <naresh.solanki@9elements.com>
+
+description: |
+  The Vicor PLI1209BC is a Digital Supervisor with Isolation for use
+  with BCM Bus Converter Modules.
+
+properties:
+  compatible:
+    enum:
+      - vicor,pli1209bc
+
+  reg:
+    maxItems: 1
+
+  regulators:
+    type: object
+    description:
+      List of regulators provided by this controller.
+
+    properties:
+      vout2:
+        $ref: /schemas/regulator/regulator.yaml#
+        type: object
+
+        unevaluatedProperties: false
+
+    additionalProperties: false
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        pli1209bc_p12v_d: regulator@5f {
+            compatible = "vicor,pli1209bc";
+            reg = <0x5f>;
+
+            regulators {
+                p12v_d: vout2 {
+                    regulator-name = "bcm3";
+                    regulator-boot-on;
+                };
+            };
+        };
+    };
+