mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-26 17:27:47 +01:00
e947978cdc
It could destroy the board if users just try and power it using 12V. There are boards that don't support 12V but only up to 5V.
76 lines
2.8 KiB
ReStructuredText
76 lines
2.8 KiB
ReStructuredText
NodeMCU ESP8266
|
|
===============
|
|
|
|
.. seo::
|
|
:description: Instructions for using nodemcu ESP8266 boards in ESPHome together with a description of their pins and uses.
|
|
:image: nodemcu_esp8266.jpg
|
|
:keywords: NodeMCU, ESP8266
|
|
|
|
The NodeMCU board is fully supported by ESPHome. Simply select ``ESP8266`` when
|
|
the ESPHome wizard asks you for your platform and |nodemcuv2|_ as the board type.
|
|
|
|
.. note::
|
|
|
|
Most NodeMCU that can be purchased now are version 2 or upwards. If you're using an
|
|
original v1 board, set the board type to |nodemcu|_.
|
|
|
|
.. |nodemcuv2| replace:: ``nodemcuv2``
|
|
.. _nodemcuv2: http://docs.platformio.org/en/latest/platforms/espressif8266.html#nodemcu
|
|
.. |nodemcu| replace:: ``nodemcu``
|
|
.. _nodemcu: http://docs.platformio.org/en/latest/platforms/espressif8266.html#nodemcu
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
esphome:
|
|
name: livingroom
|
|
platform: ESP8266
|
|
board: nodemcuv2
|
|
|
|
The NodeMCU's pin numbering as seen on the board (the ``D0`` etc pins) is different from
|
|
the internal pin numbering. For example, the ``D8`` pin number maps to the internal
|
|
``GPIO0`` pin. Fortunately ESPHome knows the mapping from the on-board pin numbers
|
|
to the internal pin numbering, but you need to prefix the pin numbers with ``D`` as in
|
|
the image below in order for this automatic mapping to occur.
|
|
|
|
In general, it is best to just use the ``D0``, ``D1``, ... pin numbering to avoid confusion
|
|
|
|
.. figure:: images/nodemcu_esp8266-full.jpg
|
|
:align: center
|
|
|
|
Pins on the NodeMCU ESP8266 development board.
|
|
|
|
Note that in certain conditions you *can* use the pins marked as ``INTERNAL`` in above image.
|
|
|
|
- ``D0`` also can be used to wake the device up from :doc:`deep sleep </components/deep_sleep>` if
|
|
the pin is connected to the ``RESET`` pin. ``D0`` is additionally connected to the LED
|
|
next to the UART chip, but in an inverted mode.
|
|
- ``D3``, ``D4`` and ``D8`` are used on startup to determine the boot mode, therefore these pins should
|
|
not be pulled low on startup. You can, however, still use them as output pins.
|
|
- ``A0``: This pin can be used as a normal GPIO pin (like ``D1`` etc) but additionally can measure
|
|
voltages from 0 to 1.0V using the :doc:`/components/sensor/adc`.
|
|
- ``VIN``: This board can be powered by an external power supply by using this pin. Supply a voltage depends on the board you use. Some boards support up to 12V, some up to 5V.
|
|
- ``ENABLE``/``RESET``: When these pins are triggered, the board resets. The difference between the pins
|
|
is how they can handle voltages above 3.3V.
|
|
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
esphome:
|
|
name: livingroom
|
|
platform: ESP8266
|
|
board: nodemcuv2
|
|
|
|
binary_sensor:
|
|
- platform: gpio
|
|
name: "Pin D0"
|
|
pin: D0
|
|
|
|
See Also
|
|
--------
|
|
|
|
- :doc:`esp8266`
|
|
- :doc:`nodemcu_esp32`
|
|
- :ghedit:`Edit`
|