esphome-docs/devices/nodemcu_esp32.rst
thenameiwantedwastaken 075d88444e Proof reading changes (#364)
* Small changes from proofreading.

* Proofreading changes.

* Correction from travis checks

* Update guides/getting_started_command_line.rst

Co-Authored-By: Otto Winter <otto@otto-winter.com>

* More proofreading changes.

* More proofreading changes.

* Minor corrections
2019-10-18 09:22:48 +02:00

65 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 the 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 the picture above. It also supports
the :doc:`touch pad binary sensor </components/binary_sensor/esp32_touch>` as do the other
pins marked ``touch`` in the above image.
- ``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`