Re: [PATCH] ARM: dts: allwinner: minimize irq debounce filter per default

From: pelzi
Date: Sat Feb 11 2023 - 07:51:30 EST


Am 10.02.23 um 11:18 schrieb Andre Przywara:
On Fri, 10 Feb 2023 11:06:20 +0100
Maxime Ripard <maxime@xxxxxxxxxx> wrote:

On Fri, Feb 10, 2023 at 09:44:25AM +0000, Andre Przywara wrote:
On Fri, 10 Feb 2023 09:29:36 +0100
Maxime Ripard <maxime@xxxxxxxxxx> wrote:

Hi Maxime,

thanks for the reply!
On Thu, Feb 09, 2023 at 08:29:52PM +0000, Andre Przywara wrote:
&pio {
+ /* 1�s debounce filter on both IRQ banks */
Is that supposed to be <micro> in UTF-8? It seems to have got lost in
translation, or is that just me?
O yes, the Greek character slipped into the comment.
+ input-debounce = <1 1>;
As mentioned above, I am not so sure this is generic enough to put it
here for PA. And what is the significance of "1 us", in particular? Is
that just the smallest value?
Yes indeed it's a bit more complicated than I feel it needs to be. The
configuration is taken as microseconds and translated into the best
matching clock and divider by the driver. However, 0 is not translated
to the lowest divider of the high speed clock as would be logical if
you ask for zero microseconds, but to "leave at default". The default
of the board is 0 in the register, translating to lowest divider on the
_low_ speed clock.
I'd say the "if (!debounce) continue;" code is just to defend against
the division by zero, which would be the next statement to execute.

We might want to change that to interpret 0 as "lowest possible", which
would be 24MHz/1. Please feel free to send a patch in this regard, and
CC: Maxime, to get some input on that idea.
I never had any complaint on that part either, so the default looks sane
to me.

If some board needs a higher debouncing rate, then we should obviously
set it up in the device tree of that board, but changing it for every
user also introduces the risk of breaking other boards that actually
require a lower debouncing frequency.
Yeah, we definitely should keep the default at 32KHz/1, as this is also
the hardware reset value.

Not sure if you were actually arguing this, but the change I sketched
above (interpreting 0 as 24MHz/1) is separate though, as the current
default is "no DT property", and not 0. There is no input-debounce
property user in the kernel tree at the moment, so we wouldn't break
anyone. The only thing that would change is if a downstream user was
relying on "0" being interpreted as "skip the setup", which isn't
really documented and could be argued to be an implementation detail.

So I'd suggest to implement 0 as "lowest possible", and documenting that
and the 32KHz/1 default if no property is given.
Ah, my bad.

There's another thing to consider: there's already a generic per-pin
input-debounce property in pinctrl.

Since we can't control it per pin but per bank, we moved it to the
controller back then, but there's always been this (implicit)
expectation that it was behaving the same way.

And the generic, per-pin, input-debounce documentation says:

Takes the debounce time in usec as argument or 0 to disable debouncing
I agree that silently ignoring it is not great, but interpreting 0 as
the lowest possible is breaking that behaviour which, I believe, is a
worse outcome.
Is it really? If I understand the hardware manuals correctly, we cannot
really turn that feature off, so isn't the lowest possible time period (24
MHz/1 at the moment) the closest we can get to "turn it off"? So
implementing this would bring us actually closer to the documented
behaviour? Or did I get the meaning of this time period wrong?
At least that's my understanding of how it fixed Andreas' problem: 1µs
is still not "off", but much better than the 31µs of the default. The new
0 would then be 0.041µs.
I would fully agree. There seems to be no way to turn off the debouncing
filter, and in terms of that filter, the lowest possible time is closest to "off".
The SoC default is equivalent to 31 us, far, far away from "off", the currently
configurable minimum is 1us.

I did a patch that enables to set "0" in the device tree configuration and it
takes care not to do a #div0, but to determine the lowest possible time. As
the patch is done in the driver for a device that cannot switch off debouncing,
I'd say, the driver patched in that way does its best to come as close to the
intended outcome as is possible.

I tested this setting on the Banana M2 Zero board, and it is working (does
the right thing setting the relevant registers to value 0x0001, and the board
works in general, w/o producing smoke. (I have no idea how to test if
the debouncing filter is actually faster with setting "0" than with setting "1",
I can only confirm it is not significantly slower).

If we can agree on a concrete way to go I'm happy to try to produce a new
patch version. My suggestion from the discussion:

- Change drivers/pinctrl/sunxi/pinctrl-sunxi.c to set the minimum
   possible filter time when input-debounce is configured to "0"
   (corresponding to 1 on the affected hardware register).
   What I don't like is the huge gap between configuration 1 and 0, but
   I have no idea what to do about it without breaking all compatibility.

- in arch/arm/boot/dts/sunxi-h3-h5.dtsi, set input-debounce <31 31>
   corresponding to the default "0" in both affected hardware registers.
   Note that the clocks hosc and losc that make this 31 map to 0 are
   configured exactly here.

- in arch/arm/boot/dts/sun8i-h2-plus-bananapi-m2-zero.dts, set
   input-debounce <31 0> as this board has electronic devices
   attached to bank G and only exposes bank A to its users.
   I'd like to advertise on that one: this board does not require
   debouncing on bank G. Plus it feels the board got more stable
   by this setting: my BananaPi is connected via WiFi (only) and in the
   past it went apparently dead every other day or so. Nothing like
   this happened after switching off input debounce. Anectdotal
   evidence, I know...

- (in my devicetree overlay, I set input-debounce <0 0> to make IRQ
   based drivers like drivers/iio/humidity/dht11.c work on bank A) -
   not part of the patch.

Would that appear right?

Best regards,

Andreas.

PS: Perhaps someone can point me to further reading regarding
drivers for electronic devices attached to GPIO. Assuming I want
to attach a device to a GPIO that is not accidentally covered by
hardware support of the pinctrl subsystem, what options do I
have _apart_ from registering edge IRQs to react on a digital
signal from that device? Isn't it called bit-banging and the
usual technique?