esphome-docs/devices/nodemcu_esp32.rst

67 lines
2.2 KiB
ReStructuredText
Raw Normal View History

2018-06-01 18:10:00 +02:00
NodeMCU ESP32
=============
2018-11-14 22:12:27 +01:00
.. seo::
2019-02-16 23:25:23 +01:00
:description: Instructions for using NodeMCU ESP32 boards in ESPHome and a description of all their pins and uses.
2018-11-14 22:12:27 +01:00
:image: nodemcu_esp32.jpg
2018-06-01 18:10:00 +02:00
The NodeMCU ESP32 board (in some cases also known as ESP32-DevkitC)
2019-02-16 23:25:23 +01:00
is fully supported by ESPHome. Simply select ``ESP32`` when
the ESPHome wizard asks you for your platform and |nodemcu-32s|_ as the board type.
2018-06-01 18:10:00 +02:00
.. |nodemcu-32s| replace:: ``nodemcu-32s``
.. _nodemcu-32s: http://docs.platformio.org/en/latest/platforms/espressif32.html#nodemcu
.. code-block:: yaml
2018-06-01 18:10:00 +02:00
# Example configuration entry
2019-02-16 23:25:23 +01:00
esphome:
2022-02-10 23:10:43 +01:00
name: livingroom
esp32:
board: nodemcu-32s
2018-06-01 18:10:00 +02:00
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.
2018-06-01 18:10:00 +02:00
- ``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
2018-06-01 18:10:00 +02:00
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.
2018-06-01 18:10:00 +02:00
- ``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
2018-06-01 18:10:00 +02:00
# Example configuration entry
2019-02-16 23:25:23 +01:00
esphome:
2018-06-01 18:10:00 +02:00
name: livingroom
2022-02-10 23:10:43 +01:00
esp32:
2018-06-01 18:10:00 +02:00
board: nodemcu-32s
binary_sensor:
- platform: gpio
name: "Pin GPIO23"
pin: GPIO23
See Also
2018-08-24 22:44:01 +02:00
--------
2018-06-01 18:10:00 +02:00
- :doc:`/components/esp32`
2018-06-01 18:10:00 +02:00
- :doc:`nodemcu_esp8266`
- :ghedit:`Edit`