esphome-docs/devices/nodemcu_esp32.rst
Otto Winter f4c1d31a1d
Revert "Remove disqus"
This reverts commit 19a22e8b39.
2019-03-06 11:02:03 +01:00

67 lines
2.2 KiB
ReStructuredText

NodeMCU ESP32
=============
.. seo::
:description: Instructions for using NodeMCU ESP32 boards in ESPHome and a description of all their pins and uses.
:image: nodemcu_esp32.jpg
The NodeMCU ESP32 board (in some cases also known as ESP32-DevkitC)
is fully supported by ESPHome. Simply select ``ESP32`` when
the ESPHome wizard asks you for your platform and |nodemcu-32s|_ as the board type.
.. |nodemcu-32s| replace:: ``nodemcu-32s``
.. _nodemcu-32s: http://docs.platformio.org/en/latest/platforms/espressif32.html#nodemcu
.. code-block:: yaml
# Example configuration entry
esphome:
name: livingroom
platform: ESP32
board: nodemcu-32s
The ESP32 boards often use the internal GPIO pin numbering on the board, this means that
you don't have to worry about other kinds of pin numberings, yay!
.. figure:: images/nodemcu_esp32-full.jpg
:align: center
Pins on the NodeMCU ESP32 development board.
Note that in certain conditions you *can* use the pins marked as ``INTERNAL`` in above image.
- ``GPIO0`` is used to determine the boot mode on startup. It should therefore not be pulled LOW
on startup to avoid booting into flash mode. You can, however, still use this as an output pin.
- ``GPIO34``-``GPIO39`` can not be used as outputs (even though GPIO stands for "general purpose input
**output**"...)
- ``GPIO32``-``GPIO39``: These pins can be used with the :doc:`/components/sensor/adc` to measure
voltages.
- ``GPIO2``: This pin is connected to the blue LED on the board as seen in above picture. It also supports
the :doc:`touch pad binary sensor </components/binary_sensor/esp32_touch>` like some other
pins.
- ``5V`` is connected to the 5V rail from the USB bus and can be used to power the board. Note that
the UART chip is directly connected to this rail and you therefore **cannot** supply other voltages
into this pin.
.. code-block:: yaml
# Example configuration entry
esphome:
name: livingroom
platform: ESP32
board: nodemcu-32s
binary_sensor:
- platform: gpio
name: "Pin GPIO23"
pin: GPIO23
See Also
--------
- :doc:`esp32`
- :doc:`nodemcu_esp8266`
- :ghedit:`Edit`
.. disqus::