mirror of
https://github.com/letscontrolit/ESPEasy.git
synced 2026-09-12 09:36:59 +00:00
[GPIO] Add GPIO pin description page
And some other GPIO related updates.
This commit is contained in:
Gijs Noorlander
@@ -9,7 +9,7 @@ Supported hardware: |P000_usedby_GPIO|
|
||||
:widths: 20, 30
|
||||
|
||||
"
|
||||
``GPIO,<gpio>,<state>``
|
||||
``GPIO,<GPIO>,<state>``
|
||||
|
||||
GPIO: 0 ... 16
|
||||
|
||||
@@ -26,6 +26,16 @@ Supported hardware: |P000_usedby_GPIO|
|
||||
that it will be able to detect low level relays (with high impedance, Z).
|
||||
"
|
||||
"
|
||||
``GPIOtoggle,<GPIO>``
|
||||
|
||||
GPIO: 0 ... 16
|
||||
|
||||
","
|
||||
**Toggle on/off.**.
|
||||
Toggle the current (output) state of the given GPIO pin.
|
||||
This will only be executed on pins set to be in output mode.
|
||||
"
|
||||
"
|
||||
``LongPulse,<GPIO>,<state>,<duration>``
|
||||
|
||||
GPIO: 0 ... 16
|
||||
|
||||
@@ -0,0 +1,245 @@
|
||||
GPIO
|
||||
****
|
||||
|
||||
|
||||
|
||||
Best pins to use on ESP8266
|
||||
---------------------------
|
||||
|
||||
Most board do not have made all pins available.
|
||||
The NodeMCU boards have almost all usable pins made available and some which need special attention.
|
||||
|
||||
.. list-table:: Best pins to use (best to worst)
|
||||
:widths: 10 25 25 40
|
||||
:header-rows: 1
|
||||
|
||||
* - GPIO
|
||||
- Input
|
||||
- Output
|
||||
- Remarks
|
||||
* - 5 (D1)
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- Often used for I2C
|
||||
* - 4 (D2)
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- Often used for I2C
|
||||
* - 14 (D5)
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 12 (D6)
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 13 (D7)
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 0 (D3)
|
||||
- :yellow:`pulled up`
|
||||
- :yellow:`OK`
|
||||
- :yellow:`Boot fail if pulled low`
|
||||
* - 2 (D4)
|
||||
- :yellow:`pulled up`
|
||||
- :yellow:`OK`
|
||||
- :yellow:`Boot fail if pulled low`
|
||||
* - 15 (D8)
|
||||
- :red:`pulled to GND`
|
||||
- :yellow:`OK`
|
||||
- :yellow:`Boot fail if pulled high`
|
||||
* - 16 (D0)
|
||||
- :red:`High at boot, pull down to GND`:yellow:`no interrupt`
|
||||
- :yellow:`no PWM / I2C support`
|
||||
- Used to wake up from deep sleep
|
||||
* - 9 (SD2)
|
||||
- :red:`High at boot`
|
||||
-
|
||||
- :yellow:`See notes`
|
||||
* - 10 (SD3)
|
||||
- :red:`High at boot`
|
||||
-
|
||||
- :yellow:`See notes`
|
||||
* - 3 (RX)
|
||||
- :yellow:`High at boot`
|
||||
- :red:`is RX`
|
||||
- :yellow:`Boot fail if pulled low`
|
||||
* - 1 (TX)
|
||||
- :red:`is TX`
|
||||
- :yellow:`debug output at boot`
|
||||
- :yellow:`Boot fail if pulled low`
|
||||
|
||||
|
||||
The labels used in the tabel above are the labels on NodeMCU boards.
|
||||
|
||||
Sources used:
|
||||
|
||||
* `The Hook Up - How To: Pick the right pins on the NodeMCU ESP8266 and ESP32 <https://www.youtube.com/watch?v=7h2bE2vNoaY>`_
|
||||
* `ESP8266 GPIO pin "features" <https://docs.google.com/spreadsheets/d/1pQuBocanzCZJ3KPUpu3VvpOOBzboqXDuwQDVP5UYcXc/edit#gid=0>`_
|
||||
* `Rabbithole - ESP8266 GPIO Behaviour at Boot <http://rabbithole.wwwdotorg.org/2017/03/28/esp8266-gpio.html>`_
|
||||
|
||||
Special notes on GPIO 6 - 11
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Almost any ESP8266 board has a flash chip connected to some or all of GPIO6-GPIO11.
|
||||
|
||||
GPIO 9 & 10 can be used on ESP8285, since that chip has 1 MB flash embedded and is not using those pins.
|
||||
One or both of pins may sometimes also be available on ESP8266 boards, depending on the flash used and the flash operation mode.
|
||||
|
||||
* Quad IO (QIO) uses 4 lines for data (6 pins total)
|
||||
* Dual IO (DIO) uses 2 lines for data (4 pins total)
|
||||
* Standard uses a single line for data (3 pins total)
|
||||
|
||||
It is best not to use any of the GPIO pins 6 - 11.
|
||||
|
||||
|
||||
Special notes on GPIO 16
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
GPIO-16 is a special pin.
|
||||
The RTC will send a short (low) pulse when the sleep timer does send a wake-up signal.
|
||||
|
||||
In order to wake from deep sleep, GPIO-16 has to be connected to the RST pin.
|
||||
If connected, this pin should not be used as GPIO pin, or else the module will reboot.
|
||||
|
||||
Other limitations are:
|
||||
|
||||
* GPIO16 has a built-in pull-down resistor (all others have built-in pull-up)
|
||||
* To enable the pull-down resistor for GPIO16, you have to use ``INPUT_PULLDOWN_16``
|
||||
|
||||
|
||||
Best pins to use on ESP32
|
||||
-------------------------
|
||||
|
||||
There is also a NodeMCU version using the ESP32.
|
||||
Fortunately the designers used the GPIO numbers as labels on the board.
|
||||
|
||||
.. list-table:: Best pins to use (best to worst)
|
||||
:widths: 10 25 25 40
|
||||
:header-rows: 1
|
||||
|
||||
* - GPIO
|
||||
- Input
|
||||
- Output
|
||||
- Remarks
|
||||
* - 36
|
||||
- :green:`OK`
|
||||
-
|
||||
- :yellow:`input only`
|
||||
* - 39
|
||||
- :green:`OK`
|
||||
-
|
||||
- :yellow:`input only`
|
||||
* - 34
|
||||
- :green:`OK`
|
||||
-
|
||||
- :yellow:`input only`
|
||||
* - 35
|
||||
- :green:`OK`
|
||||
-
|
||||
- :yellow:`input only`
|
||||
* - 32
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 33
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 25
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 26
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 27
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 14
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- :yellow:`output PWM signal at boot`
|
||||
* - 23
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 22
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 21
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 19
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 18
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 5
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- :yellow:`output PWM signal at boot`
|
||||
* - 17
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 16
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 4
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
-
|
||||
* - 2
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- Often connected to LED
|
||||
* - 15
|
||||
- :green:`OK`
|
||||
- :green:`OK`
|
||||
- :yellow:`output PWM signal at boot`
|
||||
* - 12
|
||||
-
|
||||
- :green:`OK`
|
||||
- :yellow:`Boot fail if pulled high`
|
||||
* - 0
|
||||
- :yellow:`pulled up`
|
||||
- :yellow:`OK`
|
||||
- :yellow:`Boot fail if pulled low & output PWM signal at boot`
|
||||
* - 3 (RX)
|
||||
- :yellow:`High at boot`
|
||||
- :red:`is RX`
|
||||
- RX channel of serial0
|
||||
* - 1 (TX)
|
||||
- :red:`is TX`
|
||||
- :yellow:`debug output at boot`
|
||||
- TX channel of serial0
|
||||
* - 6, 7, 8
|
||||
-
|
||||
-
|
||||
- :red:`See notes`
|
||||
* - 9, 10, 11
|
||||
- :red:`High at boot`
|
||||
-
|
||||
- :red:`See notes`
|
||||
|
||||
Source used: `The Hook Up - How To: Pick the right pins on the NodeMCU ESP8266 and ESP32 <https://www.youtube.com/watch?v=7h2bE2vNoaY>`_
|
||||
|
||||
Special notes on GPIO 6 - 11
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Almost any ESP32 board has a flash chip connected to some or all of GPIO6-GPIO11.
|
||||
|
||||
It is best not to use any of the GPIO pins 6 - 11.
|
||||
|
||||
GPIO 6, 7 & 8 may output some PWM signals at boot.
|
||||
GPIO 9, 10 & 11 output high at boot and may fail to boot of pulled either high or low.
|
||||
@@ -29,6 +29,7 @@ Welcome to ESP Easy's documentation!
|
||||
|
||||
Participate/Documentation.rst
|
||||
Reference/Command.rst
|
||||
Reference/GPIO.rst
|
||||
Reference/SystemVariable.rst
|
||||
Reference/ChangeLog.rst
|
||||
|
||||
|
||||
Reference in New Issue
Block a user