| Message ID | 20240128163630.104725-2-wahrenst@gmx.net |
|---|---|
| State | Superseded |
| Headers | show |
| Series | pwm: Add GPIO PWM driver | expand |
On Sun, Jan 28, 2024 at 05:36:29PM +0100, Stefan Wahren wrote: > From: Nicola Di Lieto <nicola.dilieto@gmail.com> > > Add bindings for the pwm-gpio driver. drop "driver" from here and instead explain in terms of what the hardware is doing. I think that's just as simple as saying that it is a binding for a gpio used as a pwm. > > Signed-off-by: Nicola Di Lieto <nicola.dilieto@gmail.com> > Co-developed-by: Stefan Wahren <wahrenst@gmx.net> > Signed-off-by: Stefan Wahren <wahrenst@gmx.net> > --- > .../devicetree/bindings/pwm/pwm-gpio.yaml | 42 +++++++++++++++++++ > 1 file changed, 42 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pwm/pwm-gpio.yaml > > diff --git a/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml b/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml > new file mode 100644 > index 000000000000..4932484563f9 > --- /dev/null > +++ b/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml > @@ -0,0 +1,42 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/pwm/pwm-gpio.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Generic software PWM for modulating GPIOs > + > +maintainers: > + - Stefan Wahren <wahrenst@gmx.net> > + > +properties: > + "#pwm-cells": > + description: | > + It should be 3. See pwm.yaml in this directory for a > + description of the cells format. Instead of this description (which I know isn't unique to this binding) I think you should have a ref: to pwm.yaml. > + const: 3 > + > + compatible: > + const: pwm-gpio > + > + gpios: > + description: > + GPIO to be modulated > + maxItems: 1 > + > +required: > + - "#pwm-cells" > + - compatible > + - gpios > + > +additionalProperties: false > + > +examples: > + - | > + #include <dt-bindings/gpio/gpio.h> > + > + pwm0 { Which may then lead to a complaint about the formatting of your node name. Cheers, Conor. > + #pwm-cells = <3>; > + compatible = "pwm-gpio"; > + gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; > + }; > -- > 2.34.1 >
diff --git a/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml b/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml new file mode 100644 index 000000000000..4932484563f9 --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/pwm-gpio.yaml @@ -0,0 +1,42 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pwm/pwm-gpio.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Generic software PWM for modulating GPIOs + +maintainers: + - Stefan Wahren <wahrenst@gmx.net> + +properties: + "#pwm-cells": + description: | + It should be 3. See pwm.yaml in this directory for a + description of the cells format. + const: 3 + + compatible: + const: pwm-gpio + + gpios: + description: + GPIO to be modulated + maxItems: 1 + +required: + - "#pwm-cells" + - compatible + - gpios + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + + pwm0 { + #pwm-cells = <3>; + compatible = "pwm-gpio"; + gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; + };