Message ID | f9178204ea3925b454ecbe58df4c297fec346a4f.1572606437.git.matti.vaittinen@fi.rohmeurope.com (mailing list archive) |
---|---|
State | Not Applicable, archived |
Headers | show |
Series | Support ROHM BD71828 PMIC | expand |
Matti On 11/1/19 6:32 AM, Matti Vaittinen wrote: > Document ROHM BD71828 PMIC LED driver device tree bindings. > > Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> > --- > > Changes from v2 - new patch > > .../bindings/leds/rohm,leds-bd71828.yaml | 46 +++++++++++++++++++ > 1 file changed, 46 insertions(+) > create mode 100644 Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > diff --git a/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > new file mode 100644 > index 000000000000..d8aeac9911ef > --- /dev/null > +++ b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > @@ -0,0 +1,46 @@ > +# SPDX-License-Identifier: GPL-2.0 > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/leds/rohm,leds-bd71828.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: ROHM BD71828 Power Management Integrated Circuit LED driver > + > +maintainers: > + - Jacek Anaszewski <jacek.anaszewski@gmail.com> > + - Pavel Machek <pavel@ucw.cz> > + - Dan Murphy <dmurphy@ti.com> > + - Rob Herring <robh+dt@kernel.org> > + - Mark Rutland <mark.rutland@arm.com> I believe you are the maintainer of this driver not the maintainers > + > +description: | > + This module is part of the ROHM BD71828 MFD device. For more details > + see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml. > + > + The LED controller is represented as a sub-node of the PMIC node on the device > + tree. > + > + The device has two LED outputs referred as GRNLED and AMBLED in data-sheet. > + > +properties: > + compatible: > + const: rohm,bd71828-led > + > +patternProperties: > + "^led-[1-2]$": > + type: object > + description: > + Properties for a single LED. Nodes must be named as led-1 and led-2. Why is this required? Can't we use the reg as the number and then we can use standard node labels like led@<reg value>. Then we can check in the code to make sure that the output is not out of bounds. > + properties: > + #$ref: "common.yaml#" > + function: > + description: > + Purpose of LED as defined in dt-bindings/leds/common.h > + $ref: "/schemas/types.yaml#/definitions/string" > + color: > + description: > + LED colour as defined in dt-bindings/leds/common.h s/colour/color But again I believe it is indicated above that the LEDs are either going to be green or amber. Unless they can be any color. Are there plans to make sure that the color is either green or amber in the code? I don't see a patch for the code in this series > + $ref: "/schemas/types.yaml#/definitions/uint32" > + > +required: > + - compatible Is there an example of the node and properties? Dan
On Fri, Nov 01, 2019 at 01:32:33PM +0200, Matti Vaittinen wrote: > Document ROHM BD71828 PMIC LED driver device tree bindings. > > Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> > --- > > Changes from v2 - new patch > > .../bindings/leds/rohm,leds-bd71828.yaml | 46 +++++++++++++++++++ > 1 file changed, 46 insertions(+) > create mode 100644 Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > diff --git a/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > new file mode 100644 > index 000000000000..d8aeac9911ef > --- /dev/null > +++ b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > @@ -0,0 +1,46 @@ > +# SPDX-License-Identifier: GPL-2.0 > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/leds/rohm,leds-bd71828.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: ROHM BD71828 Power Management Integrated Circuit LED driver > + > +maintainers: > + - Jacek Anaszewski <jacek.anaszewski@gmail.com> > + - Pavel Machek <pavel@ucw.cz> > + - Dan Murphy <dmurphy@ti.com> > + - Rob Herring <robh+dt@kernel.org> > + - Mark Rutland <mark.rutland@arm.com> > + > +description: | > + This module is part of the ROHM BD71828 MFD device. For more details > + see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml. > + > + The LED controller is represented as a sub-node of the PMIC node on the device > + tree. > + > + The device has two LED outputs referred as GRNLED and AMBLED in data-sheet. > + > +properties: > + compatible: > + const: rohm,bd71828-led > + > +patternProperties: > + "^led-[1-2]$": > + type: object > + description: > + Properties for a single LED. Nodes must be named as led-1 and led-2. > + properties: > + #$ref: "common.yaml#" > + function: > + description: > + Purpose of LED as defined in dt-bindings/leds/common.h > + $ref: "/schemas/types.yaml#/definitions/string" > + color: > + description: > + LED colour as defined in dt-bindings/leds/common.h > + $ref: "/schemas/types.yaml#/definitions/uint32" You can assume that we will have a common schema for these. So the only thing needed is whether you use the properties ("true" is enough for that), any additional constraints (not likely here), and whether required or not. > + > +required: > + - compatible > -- > 2.21.0 > > > -- > Matti Vaittinen, Linux device drivers > ROHM Semiconductors, Finland SWDC > Kiviharjunlenkki 1E > 90220 OULU > FINLAND > > ~~~ "I don't think so," said Rene Descartes. Just then he vanished ~~~ > Simon says - in Latin please. > ~~~ "non cogito me" dixit Rene Descarte, deinde evanescavit ~~~ > Thanks to Simon Glass for the translation =]
On Tue, Nov 05, 2019 at 01:14:33PM -0600, Dan Murphy wrote: > Matti > > On 11/1/19 6:32 AM, Matti Vaittinen wrote: > > Document ROHM BD71828 PMIC LED driver device tree bindings. > > > > Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> > > --- > > > > Changes from v2 - new patch > > > > .../bindings/leds/rohm,leds-bd71828.yaml | 46 +++++++++++++++++++ > > 1 file changed, 46 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > > > diff --git a/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > new file mode 100644 > > index 000000000000..d8aeac9911ef > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > @@ -0,0 +1,46 @@ > > +# SPDX-License-Identifier: GPL-2.0 > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/leds/rohm,leds-bd71828.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: ROHM BD71828 Power Management Integrated Circuit LED driver > > + > > +maintainers: > > + - Jacek Anaszewski <jacek.anaszewski@gmail.com> > > + - Pavel Machek <pavel@ucw.cz> > > + - Dan Murphy <dmurphy@ti.com> > > + - Rob Herring <robh+dt@kernel.org> > > + - Mark Rutland <mark.rutland@arm.com> > I believe you are the maintainer of this driver not the maintainers Right, should have been clearer in my other response. Put owner/maintainer of the device binding, not subsystem. > > + > > +description: | > > + This module is part of the ROHM BD71828 MFD device. For more details > > + see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml. > > + > > + The LED controller is represented as a sub-node of the PMIC node on the device > > + tree. > > + > > + The device has two LED outputs referred as GRNLED and AMBLED in data-sheet. > > + > > +properties: > > + compatible: > > + const: rohm,bd71828-led > > + > > +patternProperties: > > + "^led-[1-2]$": > > + type: object > > + description: > > + Properties for a single LED. Nodes must be named as led-1 and led-2. > > Why is this required? Can't we use the reg as the number and then we can > use standard node labels > > like led@<reg value>. Then we can check in the code to make sure that the > output is not out of bounds. > > > + properties: > > + #$ref: "common.yaml#" > > + function: > > + description: > > + Purpose of LED as defined in dt-bindings/leds/common.h > > + $ref: "/schemas/types.yaml#/definitions/string" > > + color: > > + description: > > + LED colour as defined in dt-bindings/leds/common.h > > s/colour/color > > But again I believe it is indicated above that the LEDs are either going to > be green or amber. Unless they can be any color. > > Are there plans to make sure that the color is either green or amber in the > code? I don't see a patch for the code in this series > > > + $ref: "/schemas/types.yaml#/definitions/uint32" > > + > > +required: > > + - compatible > > Is there an example of the node and properties? For MFDs, I prefer a complete example in the MFD binding doc. We need it complete to validate the example. Rob
Hello Dan, Thanks for the check once again! On Tue, 2019-11-05 at 13:14 -0600, Dan Murphy wrote: > Matti > > On 11/1/19 6:32 AM, Matti Vaittinen wrote: > > Document ROHM BD71828 PMIC LED driver device tree bindings. > > > > Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> > > --- > > > > Changes from v2 - new patch > > > > .../bindings/leds/rohm,leds-bd71828.yaml | 46 > > +++++++++++++++++++ > > 1 file changed, 46 insertions(+) > > create mode 100644 > > Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > > > diff --git a/Documentation/devicetree/bindings/leds/rohm,leds- > > bd71828.yaml b/Documentation/devicetree/bindings/leds/rohm,leds- > > bd71828.yaml > > new file mode 100644 > > index 000000000000..d8aeac9911ef > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml > > @@ -0,0 +1,46 @@ > > +# SPDX-License-Identifier: GPL-2.0 > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/leds/rohm,leds-bd71828.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: ROHM BD71828 Power Management Integrated Circuit LED driver > > + > > +maintainers: > > + - Jacek Anaszewski <jacek.anaszewski@gmail.com> > > + - Pavel Machek <pavel@ucw.cz> > > + - Dan Murphy <dmurphy@ti.com> > > + - Rob Herring <robh+dt@kernel.org> > > + - Mark Rutland <mark.rutland@arm.com> > I believe you are the maintainer of this driver not the maintainers Right. Thanks for pointing that out. > > + > > +description: | > > + This module is part of the ROHM BD71828 MFD device. For more > > details > > + see Documentation/devicetree/bindings/mfd/rohm,bd71828- > > pmic.yaml. > > + > > + The LED controller is represented as a sub-node of the PMIC node > > on the device > > + tree. > > + > > + The device has two LED outputs referred as GRNLED and AMBLED in > > data-sheet. > > + > > +properties: > > + compatible: > > + const: rohm,bd71828-led > > + > > +patternProperties: > > + "^led-[1-2]$": > > + type: object > > + description: > > + Properties for a single LED. Nodes must be named as led-1 > > and led-2. > > Why is this required? Can't we use the reg as the number and then > we > can use standard node labels This was related to my idea of using the node-names as unique keys. Please see: https://lore.kernel.org/lkml/cover.1572351774.git.matti.vaittinen@fi.rohmeurope.com/ What would you expect the reg = <>; to describe from HW? > like led@<reg value>. Then we can check in the code to make sure > that > the output is not out of bounds. > > > + properties: > > + #$ref: "common.yaml#" > > + function: > > + description: > > + Purpose of LED as defined in dt-bindings/leds/common.h > > + $ref: "/schemas/types.yaml#/definitions/string" > > + color: > > + description: > > + LED colour as defined in dt-bindings/leds/common.h > > s/colour/color That depends on your location :) > But again I believe it is indicated above that the LEDs are either > going > to be green or amber. Unless they can be any color. This was my original reason for omitting the DT for BD71828 LEDs altogether. LEDs are expected to be green and amber - but it is true that PMIC can not ensure there will be no other colours. > Are there plans to make sure that the color is either green or amber > in > the code? I don't see a patch for the code in this series Yes. As I wrote in cover-letter, the LED driver is pending until I see how the RFC for adding LED node finding and some more common property parsing to LED core is received by others. (Although I do understand if you didn't read the cover-letter. It's quite a bunch of text and reading it over and over again is no fun). > > > + $ref: "/schemas/types.yaml#/definitions/uint32" > > + > > +required: > > + - compatible > > Is there an example of the node and properties? Yes, in MFD doc. Br, Matti Vaittinen
diff --git a/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml new file mode 100644 index 000000000000..d8aeac9911ef --- /dev/null +++ b/Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/leds/rohm,leds-bd71828.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ROHM BD71828 Power Management Integrated Circuit LED driver + +maintainers: + - Jacek Anaszewski <jacek.anaszewski@gmail.com> + - Pavel Machek <pavel@ucw.cz> + - Dan Murphy <dmurphy@ti.com> + - Rob Herring <robh+dt@kernel.org> + - Mark Rutland <mark.rutland@arm.com> + +description: | + This module is part of the ROHM BD71828 MFD device. For more details + see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml. + + The LED controller is represented as a sub-node of the PMIC node on the device + tree. + + The device has two LED outputs referred as GRNLED and AMBLED in data-sheet. + +properties: + compatible: + const: rohm,bd71828-led + +patternProperties: + "^led-[1-2]$": + type: object + description: + Properties for a single LED. Nodes must be named as led-1 and led-2. + properties: + #$ref: "common.yaml#" + function: + description: + Purpose of LED as defined in dt-bindings/leds/common.h + $ref: "/schemas/types.yaml#/definitions/string" + color: + description: + LED colour as defined in dt-bindings/leds/common.h + $ref: "/schemas/types.yaml#/definitions/uint32" + +required: + - compatible
Document ROHM BD71828 PMIC LED driver device tree bindings. Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> --- Changes from v2 - new patch .../bindings/leds/rohm,leds-bd71828.yaml | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/rohm,leds-bd71828.yaml