Re: [PATCH 1/2] dt-bindings: pwm: brcm,bcm7038: Document the 'open-drain' property

From: Rob Herring
Date: Tue Oct 15 2024 - 12:32:18 EST


On Fri, Oct 11, 2024 at 07:56:02PM -0700, Florian Fainelli wrote:
> Document the 'open-drain' property that allows configuring the PWM
> controller outputs in open drain versus totem pole.
>
> Signed-off-by: Florian Fainelli <florian.fainelli@xxxxxxxxxxxx>
> ---
> Documentation/devicetree/bindings/pwm/brcm,bcm7038-pwm.yaml | 6 ++++++
> 1 file changed, 6 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/pwm/brcm,bcm7038-pwm.yaml b/Documentation/devicetree/bindings/pwm/brcm,bcm7038-pwm.yaml
> index 119de3d7f9dd..12851c43a612 100644
> --- a/Documentation/devicetree/bindings/pwm/brcm,bcm7038-pwm.yaml
> +++ b/Documentation/devicetree/bindings/pwm/brcm,bcm7038-pwm.yaml
> @@ -25,6 +25,12 @@ properties:
> clocks:
> maxItems: 1
>
> + open-drain:
> + type: boolean
> + description:
> + Configure the outputs with open-drain structure, if omitted totem pole
> + structure is used.
> +

There's one other PWM with 'open-drain' so move the definition to
pwm.yaml.

Alternatively, 'drive-open-drain' is a much more commonly used
variation.

Another thing to consider is for any PWM controller with more than
1 output, you might want this to be per output and therefore should be
a flag in the cells.

Rob