2020-03-17 12:33:38

by Oleksandr Suvorov

[permalink] [raw]
Subject: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

PWM can have a normal polarity and a reverted one. The reverted polarity
value is defined.
Define the PWM_POLARITY_NORMAL to be used further.

Signed-off-by: Oleksandr Suvorov <[email protected]>
---

include/dt-bindings/pwm/pwm.h | 1 +
1 file changed, 1 insertion(+)

diff --git a/include/dt-bindings/pwm/pwm.h b/include/dt-bindings/pwm/pwm.h
index ab9a077e3c7d..6b58caa6385e 100644
--- a/include/dt-bindings/pwm/pwm.h
+++ b/include/dt-bindings/pwm/pwm.h
@@ -10,6 +10,7 @@
#ifndef _DT_BINDINGS_PWM_PWM_H
#define _DT_BINDINGS_PWM_PWM_H

+#define PWM_POLARITY_NORMAL 0
#define PWM_POLARITY_INVERTED (1 << 0)

#endif
--
2.24.1


2020-03-17 13:37:23

by Paul Barker

[permalink] [raw]
Subject: Re: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

On Tue, 17 Mar 2020 14:32:27 +0200
Oleksandr Suvorov <[email protected]> wrote:

> PWM can have a normal polarity and a reverted one. The reverted polarity
> value is defined.
> Define the PWM_POLARITY_NORMAL to be used further.
>
> Signed-off-by: Oleksandr Suvorov <[email protected]>

s/reverted/inverted/

--
Paul Barker
Konsulko Group

2020-03-17 14:09:47

by Oleksandr Suvorov

[permalink] [raw]
Subject: Re: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

On Tue, Mar 17, 2020 at 3:37 PM Paul Barker <[email protected]> wrote:
>
> On Tue, 17 Mar 2020 14:32:27 +0200
> Oleksandr Suvorov <[email protected]> wrote:
>
> > PWM can have a normal polarity and a reverted one. The reverted polarity
> > value is defined.
> > Define the PWM_POLARITY_NORMAL to be used further.
> >
> > Signed-off-by: Oleksandr Suvorov <[email protected]>
>
> s/reverted/inverted/

Thank you, Paul, for so fast review! I'll fix it in the next version
of the patchset.

>
> --
> Paul Barker
> Konsulko Group

--
Best regards
Oleksandr Suvorov

Toradex AG
Ebenaustrasse 10 | 6048 Horw | Switzerland | T: +41 41 500 48 00

2020-03-17 21:39:13

by Uwe Kleine-König

[permalink] [raw]
Subject: Re: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

On Tue, Mar 17, 2020 at 02:32:27PM +0200, Oleksandr Suvorov wrote:
> PWM can have a normal polarity and a reverted one. The reverted polarity
> value is defined.
> Define the PWM_POLARITY_NORMAL to be used further.
>
> Signed-off-by: Oleksandr Suvorov <[email protected]>
> ---
>
> include/dt-bindings/pwm/pwm.h | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/include/dt-bindings/pwm/pwm.h b/include/dt-bindings/pwm/pwm.h
> index ab9a077e3c7d..6b58caa6385e 100644
> --- a/include/dt-bindings/pwm/pwm.h
> +++ b/include/dt-bindings/pwm/pwm.h
> @@ -10,6 +10,7 @@
> #ifndef _DT_BINDINGS_PWM_PWM_H
> #define _DT_BINDINGS_PWM_PWM_H
>
> +#define PWM_POLARITY_NORMAL 0
> #define PWM_POLARITY_INVERTED (1 << 0)

Maybe define PWM_POLARITY_NORMAL as (0 << 0) to make it more obvious
that it is the inverse of PWM_POLARITY_INVERTED?

But even when kept as is I like hafing PWM_POLARITY_NORMAL in the
binding definitions.

Acked-by: Uwe Kleine-K?nig <[email protected]>

Best regards
Uwe

--
Pengutronix e.K. | Uwe Kleine-K?nig |
Industrial Linux Solutions | https://www.pengutronix.de/ |

2020-03-17 22:58:00

by Laurent Pinchart

[permalink] [raw]
Subject: Re: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

Hi Oleksandr,

Thank you for the patch.

On Tue, Mar 17, 2020 at 02:32:27PM +0200, Oleksandr Suvorov wrote:
> PWM can have a normal polarity and a reverted one. The reverted polarity
> value is defined.

As mentioned by Paul, I'd use "inverted" instead of "reverted". Your
patch series is trying to standardized on "inverted", let's not add
another term :-)

I would squash this patch with 2/7, apart from that it looks fine.
However, I also agree with Thierry that the PWM cell that contains this
value is a bitmask, so once we get more flags it may get a bit awkward.
Will we have one macro for each flag that will evaluate to 0 to report
that the flag isn't set ? Or should we define a single PWM_FLAG_NONE (or
similarly named) macro ? In retrospect, maybe PWM_POLARITY_INVERTED
should have been named PWM_FLAG_POLARITY_INVERTED.

> Define the PWM_POLARITY_NORMAL to be used further.
>
> Signed-off-by: Oleksandr Suvorov <[email protected]>
> ---
>
> include/dt-bindings/pwm/pwm.h | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/include/dt-bindings/pwm/pwm.h b/include/dt-bindings/pwm/pwm.h
> index ab9a077e3c7d..6b58caa6385e 100644
> --- a/include/dt-bindings/pwm/pwm.h
> +++ b/include/dt-bindings/pwm/pwm.h
> @@ -10,6 +10,7 @@
> #ifndef _DT_BINDINGS_PWM_PWM_H
> #define _DT_BINDINGS_PWM_PWM_H
>
> +#define PWM_POLARITY_NORMAL 0
> #define PWM_POLARITY_INVERTED (1 << 0)
>
> #endif

--
Regards,

Laurent Pinchart

2020-03-18 09:22:25

by Uwe Kleine-König

[permalink] [raw]
Subject: Re: [RFC PATCH 3/7] dt-bindings: pwm: add normal PWM polarity flag

Hello Laurent,

On Wed, Mar 18, 2020 at 12:56:56AM +0200, Laurent Pinchart wrote:
> On Tue, Mar 17, 2020 at 02:32:27PM +0200, Oleksandr Suvorov wrote:
> > PWM can have a normal polarity and a reverted one. The reverted polarity
> > value is defined.
>
> I would squash this patch with 2/7, apart from that it looks fine.
> However, I also agree with Thierry that the PWM cell that contains this
> value is a bitmask, so once we get more flags it may get a bit awkward.

For me the usefulness of PWM_POLARITY_NORMAL increases with more bits
used. That's because if there are 5 things that can be set there and the
patch author mentions only the two that are non-zero, I as a reviewer
don't know if the author actually know and thought about the other
three. If however they spell out PWM_POLARITY_NORMAL it's quite sure
they want normal polarity.

> Will we have one macro for each flag that will evaluate to 0 to report
> that the flag isn't set ?

Yes. Given the above mentioned advantage this is cheap enough in my
eyes.

> Or should we define a single PWM_FLAG_NONE (or
> similarly named) macro ?

I like one macro for each bit field better for the above mentioned
reason.

> In retrospect, maybe PWM_POLARITY_INVERTED
> should have been named PWM_FLAG_POLARITY_INVERTED.

Seems to be subjective. I don't see much added semantic that justifies
the longer name.

Best regards
Uwe

--
Pengutronix e.K. | Uwe Kleine-K?nig |
Industrial Linux Solutions | https://www.pengutronix.de/ |