esphome-docs/devices/esp32.rst

54 lines
1.6 KiB
ReStructuredText
Raw Normal View History

2018-06-01 18:10:00 +02:00
Generic ESP32
=============
2018-11-14 22:12:27 +01:00
.. seo::
2019-02-16 23:25:23 +01:00
:description: Information about how to use generic ESP32 boards in ESPHome.
:image: esp32.png
2018-11-14 22:12:27 +01:00
2019-02-16 23:25:23 +01:00
All ESP32-based devices are supported by ESPHome. Simply select ``ESP32`` when
the ESPHome wizard asks you for your platform and choose a board type
2018-06-01 18:10:00 +02:00
from `this link <http://docs.platformio.org/en/latest/platforms/espressif32.html>`__ when the wizard
asks you for the board type.
.. code-block:: yaml
2018-06-01 18:10:00 +02:00
# Example configuration entry
2019-02-16 23:25:23 +01:00
esphome:
name: livingroom
platform: ESP32
board: <BOARD_TYPE>
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!
Some notes about the pins on the ESP32:
- ``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. It also supports
the :doc:`touch pad binary sensor </components/binary_sensor/esp32_touch>` like some other
2018-06-01 18:10:00 +02:00
pins.
.. 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
platform: ESP32
board: <BOARD_TYPE>
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:`nodemcu_esp32`
- :ghedit:`Edit`