From 0d19c4ef89dc0e5cc3d9c9f727f633e054af7dea Mon Sep 17 00:00:00 2001
From: ouinouin <julien.bresciani@free.fr>
Date: Thu, 13 Apr 2023 19:21:58 +0200
Subject: [PATCH 1/2] add chapter with GPI0 variants _n _in _id _d
Add extra explanations to select the correct variant of GPIO , to let user decipher what Button_in Switch_d Switch_n ... means.
---
docs/Buttons-and-Switches.md | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/docs/Buttons-and-Switches.md b/docs/Buttons-and-Switches.md
index 0e2a566d22..14ad9c5744 100644
--- a/docs/Buttons-and-Switches.md
+++ b/docs/Buttons-and-Switches.md
@@ -4,6 +4,22 @@ A typical device usually has at least one button (exception being bulbs and some
!!! note
Other than relays/lights, Tasmota does not publish the state of components (switches, buttons, sensors, etc.) in real-time. State of components is transmitted automatically each [TelePeriod](Commands.md#teleperiod) via the `SENSORS` message.
+# Choose GPIO configuration
+All board are not born equal so does your own diy realisations, you might have choosen to put your own pull-up resistors , or had an inverted logic on your button input.
+
+The first thing is to correctly select the Button or Switch variant accordingly in the "Configure module" or "Configure template" menu.
+the variants supported by ESP8266 are following :
+* Button : Button active low, internal pull-up resistor
+* Button_n : Button active low, no internal pull-up resistor (_n like NoPullUp)
+* Button_i : Button inverted, active high with internal pull-up resistor
+* Button_in : Button inverted, active high no internal pull-up resistor (_in like Inverted NoPullUp)
+* Switch : Switch with internal pull-up resistor
+* Switch_n : Switch without pull-up resistor
+
+the ESP32 supports all forementionned variants plus :
+* Button_d : Button with internal pull-down resistor
+* Button_id : Button inverted, active low with internal pull-down resistor
+* Switch_d : Switch with internal pull-down resistor
# Button vs. Switch
A button (also called a push-button) is a momentary or non-latching switch which causes a temporary change in the state of an electrical circuit only while the switch is pressed. An automatic mechanism (i.e. a spring) returns the switch to its default position immediately afterwards, restoring the initial circuit condition.
From ae2b52fdee69c89ae46a39362445444647740a14 Mon Sep 17 00:00:00 2001
From: ouinouin <julien.bresciani@free.fr>
Date: Fri, 14 Apr 2023 08:41:14 +0200
Subject: [PATCH 2/2] active high/low swapped
changed according to @barbudor comments.
---
docs/Buttons-and-Switches.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/Buttons-and-Switches.md b/docs/Buttons-and-Switches.md
index 14ad9c5744..96c9537375 100644
--- a/docs/Buttons-and-Switches.md
+++ b/docs/Buttons-and-Switches.md
@@ -18,7 +18,7 @@ the variants supported by ESP8266 are following :
the ESP32 supports all forementionned variants plus :
* Button_d : Button with internal pull-down resistor
-* Button_id : Button inverted, active low with internal pull-down resistor
+* Button_id : Button inverted, active high with internal pull-down resistor
* Switch_d : Switch with internal pull-down resistor
# Button vs. Switch