К основному содержимому
Полезный сервис

Конструктор ESPHome для ESP32 — генератор YAML и проверка GPIO

Соберите готовый YAML ESPHome для ESP32: выберите плату, BME280, DHT22, DS18B20, реле или SSD1306, назначьте GPIO и проверьте конфликты перед подключением к Home Assistant.

Соберите конфигурацию ESPHome для ESP32

Выберите семейство ESP32, добавьте датчики и исполнительные устройства, назначьте GPIO и получите готовый YAML для ESPHome и Home Assistant.

Генератор проверяет повторное использование GPIO, известные ограничения классического ESP32 и совместное использование I²C-шины.
1

Плата и имя устройства

Латиница, цифры и дефисы. Например: garage-sensor.
2

Добавьте компоненты

BME280
I²C
Температура, влажность и давление.
DHT22
GPIO
Температура и влажность по одной линии DATA.
DS18B20
1-Wire
Цифровой датчик температуры, один или несколько на общей шине.
Реле
GPIO OUT
GPIO switch для управления релейным модулем.
OLED SSD1306 128×64
I²C
Дисплей по I²C, адрес по умолчанию 0x3C.
BME280 и SSD1306 могут использовать одну I²C-шину и одни GPIO SDA/SCL. Это нормальный сценарий, если I²C-адреса устройств не конфликтуют.
3

GPIO и параметры

Сначала добавьте хотя бы один компонент.
4

Проверка проекта

Готовый YAML ESPHome

Как пользоваться генератором ESPHome

Выберите семейство ESP32, затем добавьте нужные датчики, реле или дисплей. Сервис предложит стартовые GPIO, но перед сборкой обязательно сверяйте распиновку именно вашей платы: разные DevKit и компактные модули на одном и том же чипе могут выводить наружу разный набор контактов.

После выбора компонентов генератор собирает единый YAML с Wi-Fi через !secret, Native API для Home Assistant, OTA-обновлением и конфигурацией выбранных компонентов. Пароли и SSID в сервис вводить не нужно.

Почему GPIO нужно проверять

У ESP32 не каждый контакт одинаково подходит для любой задачи. Например, у классического ESP32 GPIO34–GPIO39 нельзя использовать как выходы, а GPIO0 влияет на режим загрузки. Генератор предупреждает о таких случаях и отдельно отслеживает попытку назначить один GPIO двум несовместимым функциям.

ESPHome и Home Assistant

ESPHome позволяет описывать устройство декларативно в YAML. После прошивки ESP32 подключается к сети, а Home Assistant может обнаружить устройство через ESPHome Native API. Для Wi-Fi в генерируемом конфиге используются ссылки на secrets.yaml, чтобы пароль не приходилось хранить прямо в основном YAML.

Что уже поддерживает конструктор

Первая версия рассчитана на популярные проекты: BME280, DHT22, DS18B20, GPIO-реле и OLED SSD1306 по I²C. Каталог можно расширять без изменения общей логики сервиса: добавлять BMP280, BH1750, AHT20, PIR, кнопки, адресные ленты, UART-датчики и другие компоненты ESPHome.

Важно: генератор помогает подготовить конфигурацию, но не заменяет документацию конкретной платы. Перед подключением питания проверьте допустимое напряжение модуля, распиновку и электрическую совместимость входов/выходов.