mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-26 17:27:47 +01:00
641fd161a3
``VIN``: This pin can be used to use an external power supply with the board. Supply a voltage from 3.3V to 12V to this pin and the linear voltage regulator on the board will power the board. changed for more clarity to: ``VIN``: This board can be powered by an external power supply by using this pin. Supply a voltage between 3.3V to 12V to this pin and the linear voltage regulator on the board will power the board.
77 lines
2.8 KiB
ReStructuredText
77 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 between
|
|
3.3V to 12V to this pin and the linear voltage regulator on the board will power the board.
|
|
- ``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`
|