esphome-docs/devices/esp32.rst

59 lines
1.7 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.svg
2021-08-25 03:37:12 +02:00
:keywords: ESP32
2018-11-14 22:12:27 +01:00
2021-08-25 03:37:12 +02:00
All devices based on the original ESP32 are supported by ESPHome. Simply select ``ESP32`` when
2019-02-16 23:25:23 +01:00
the ESPHome wizard asks you for your platform and choose a board type
from `this link <https://registry.platformio.org/platforms/platformio/espressif32/boards>`__ when the wizard
2018-06-01 18:10:00 +02:00
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
2021-08-25 03:37:12 +02:00
.. note::
Support for the ESP32-S2 and ESP32-C3 is currently in development.
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`