Skip to content

Commit 15f4737

Browse files
committed
fix: update gpiocontrol docs for rpi-lgpio
1 parent 2d4b5b8 commit 15f4737

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

components/gpio_control/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
# GPIO CONTROL
22

3+
> [!IMPORTANT]
4+
> Since v2.9.0 the original `RPi.GPIO` library was replaced with `rpi-lgpio` to support the GPIO access in newer OS versions (>= kernel 6.6).
5+
> This new library is api compliant to the old one, but behaves differently in some aspects (see [rpi-lgpio differences](https://rpi-lgpio.readthedocs.io/en/latest/differences.html)).
6+
> Especially the `Debounce` difference changes the behavior of the `bouncetime` property! The actions are not triggered immediately anymore, but after the signal has been stable for the specified time, causing a delay. This also has impact to the usage of `hold_time` and `antibouncehack`!
7+
38
This service enables the control of different GPIO input & output devices for controlling the Phoniebox.
49
It uses to a configuration file to configure the active devices.
510

@@ -74,7 +79,7 @@ However, a button has more parameters than these. In the following comprehensive
7479

7580
Holding the button even longer than `hold_time` will cause no further action unless you are in the `Repeat` or `SecondFuncRepeat` mode.
7681

77-
* **hold_time**: Reference time for this buttons `hold_mode` feature in seconds. Default is `0.3`. This setting is ignored if `hold_mode` is unset or `None`
82+
* **hold_time**: Reference time for this buttons `hold_mode` feature in seconds. Default is `0.3`. This setting is ignored if `hold_mode` is unset or `None`. Attention: `hold_time` is running **after** the action was triggered, so the total time will add up with `bouncetime`.
7883
* **functionCall2**: Secondary function, default is `None`. This setting is ignored unless `hold_mode` is set to `SecondFunc` or `SecondFuncRepeat`.
7984
* **functionCall2Args**: Arguments for secondary function, default is `None`. Arguments are ignored, if `functionCall2` does not take any.
8085
* **pull_up_down**: Configures the internal Pull up/down resistors. Valid settings:
@@ -85,7 +90,7 @@ However, a button has more parameters than these. In the following comprehensive
8590
* `falling` (Default). Triggers if the GPIO voltage goes down.
8691
* `rising`. Triggers only if the GPIO voltage goes up.
8792
* `both`. Triggers in both cases.
88-
* **bouncetime**: This is a setting of the GPIO library to limit bouncing effects during button usage. Default is `500` ms.
93+
* **bouncetime**: This is a setting of the GPIO library to limit bouncing effects during button usage. The action is only triggered after the signal has been stable for the defined time. Default is `500` ms.
8994
* **antibouncehack**: Despite the integrated bounce reduction of the GPIO library some users may notice false triggers of their buttons (e.g. unrequested / double actions when releasing the button). If you encounter such problems, try setting this to `True` to activate an additional countermeasure.
9095

9196
> [!NOTE]

0 commit comments

Comments
 (0)