| Message ID | 20230816081728.2812458-3-like@awinic.com |
|---|---|
| State | Superseded, archived |
| Headers | show |
| Series | regulator: aw37503: add regulator driver for Awinic AW37503 | expand |
| Context | Check | Description |
|---|---|---|
| robh/checkpatch | success | |
| robh/patch-applied | success | |
| robh/dtbs-check | warning | build log |
| robh/dt-meta-schema | success |
On 16/08/2023 10:17, like@awinic.com wrote: > From: Alec Li <like@awinic.com> > > Add aw37503 regulator device-tree binding documentation. > > Signed-off-by: Alec Li <like@awinic.com> > --- > .../bindings/regulator/awinic,aw37503.yaml | 80 +++++++++++++++++++ > 1 file changed, 80 insertions(+) > create mode 100644 Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml > > diff --git a/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml b/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml > new file mode 100644 > index 000000000000..65a891505808 > --- /dev/null > +++ b/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml > @@ -0,0 +1,80 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/regulator/awinic,aw37503.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Awinic AW37503 Voltage Regulator > + > +maintainers: > + - Alec Li <like@awinic.com> > + > +description: | Do not need '|' unless you need to preserve formatting. > + The AW37503 are dual voltage regulator, designed to support positive/negative > + supply for driving TFT-LCD panels. It support software-configurable output > + switching and monitoring. The output voltages can be programmed via an I2C > + compatible interface. > + > +properties: > + compatible: > + const: awinic,aw37503 > + > + reg: > + maxItems: 1 > + > +patternProperties: > + "^out[pn]$": > + type: object > + $ref: regulator.yaml# > + unevaluatedProperties: false > + description: | Do not need '|' unless you need to preserve formatting. > + Properties for single regulator. > + > + properties: > + regulator-name: true > + regulator-always-on: true > + regulator-boot-on: true Drop all three above. They are not needed, because you use unevaluatedProperties:false. > + enable-gpio: I believe the name *everywhere* is enable-gpios. Best regards, Krzysztof
diff --git a/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml b/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml new file mode 100644 index 000000000000..65a891505808 --- /dev/null +++ b/Documentation/devicetree/bindings/regulator/awinic,aw37503.yaml @@ -0,0 +1,80 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/regulator/awinic,aw37503.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Awinic AW37503 Voltage Regulator + +maintainers: + - Alec Li <like@awinic.com> + +description: | + The AW37503 are dual voltage regulator, designed to support positive/negative + supply for driving TFT-LCD panels. It support software-configurable output + switching and monitoring. The output voltages can be programmed via an I2C + compatible interface. + +properties: + compatible: + const: awinic,aw37503 + + reg: + maxItems: 1 + +patternProperties: + "^out[pn]$": + type: object + $ref: regulator.yaml# + unevaluatedProperties: false + description: | + Properties for single regulator. + + properties: + regulator-name: true + regulator-always-on: true + regulator-boot-on: true + enable-gpio: + maxItems: 1 + description: | + GPIO specifier to enable the GPIO control (on/off) for regulator. + + required: + - regulator-name + +required: + - compatible + - reg + - outp + - outn + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + regulator@3e { + compatible = "awinic,aw37503"; + reg = <0x3e>; + + outp { + regulator-name = "outp"; + regulator-boot-on; + regulator-always-on; + enable-gpio = <&gpio 17 GPIO_ACTIVE_LOW>; + }; + + outn { + regulator-name = "outn"; + regulator-boot-on; + regulator-always-on; + enable-gpio = <&gpio 27 GPIO_ACTIVE_LOW>; + }; + }; + }; +...