ESPHome: прошиваем ESP32 для умного дома без единой строчки кода

YAML-файл вместо скетча, автообновление по воздуху, интеграция с Home Assistant в два клика. ESPHome превращает ESP32 в готовое устройство умного дома — и программировать для этого не нужно.

10 марта 2026 г.9 мин чтения

Зачем ESPHome, если есть Arduino IDE

Допустим, ты хочешь повесить датчик температуры DS18B20 (цифровой термометр) на ESP32 (микроконтроллер с Wi-Fi и Bluetooth) и отправлять показания в Home Assistant (платформа управления умным домом). Через Arduino IDE (среда разработки) путь примерно такой: написать скетч, подключить библиотеку MQTT (протокол обмена сообщениями для IoT), настроить Wi-Fi, настроить MQTT-брокер, разобраться с форматом сообщений, которые понимает Home Assistant, прошить, отладить. Часа два для первого раза — это оптимистично.

А в ESPHome тот же результат:

yamlsensor:
  - platform: dallas_temp
    address: 0x1234567890AB # Адрес датчика
    name: "Температура на балконе"
    update_interval: 60s

Шесть строк. Прошил, устройство появилось в Home Assistant. Показания обновляются каждую минуту. Всё.

ESPHome — это фреймворк (система для создания прошивок), который генерирует C++-код из YAML-конфигурации (формат описания данных, читаемый человеком), компилирует его и заливает на ESP32 или ESP8266 (предыдущее поколение Wi-Fi-микроконтроллеров). Ты описываешь что хочешь, ESPHome разбирается как это сделать.

Что ESPHome умеет из коробки

Список поддерживаемых устройств — огромный. Не всё, но основное:

Датчики: DS18B20, DHT11/DHT22 (температура и влажность), BME280/BMP280 (температура, влажность, давление), AHT10, SHT3x, SGP30 (качество воздуха), PZEM-004T (мониторинг электроэнергии), АЦП (ADC — аналого-цифровой преобразователь), датчики освещённости (BH1750), LD2410/LD2420 (датчики присутствия на миллиметровых волнах), SenseAir S8 (CO₂), счётчики импульсов (pulse counter — для счётчиков воды и газа).

Исполнительные устройства: реле, сервоприводы, ШИМ-выходы (PWM — широтно-импульсная модуляция), RGB-светодиоды и адресные ленты (WS2812B, SK6812), дисплеи (OLED, TFT), ИК-передатчики и приёмники (управление кондиционером), моторы.

Протоколы: Wi-Fi, MQTT, нативный API для Home Assistant, Bluetooth Proxy (ESP32 как мост для BLE-устройств), UART (последовательный порт), I2C (шина для датчиков), SPI (скоростная шина), Modbus, RS-485, 433 МГц (приём сигналов от беспроводных датчиков).

Прочее: OTA-обновления (прошивка по воздуху — Over The Air), веб-интерфейс прямо на устройстве (ESPHome Web Server), кнопки, бинарные сенсоры (GPIO — пины ввода-вывода), таймеры, скрипты автоматизации, глубокий сон (deep sleep для батарейных устройств).

По сути, ESPHome покрывает 80–90% задач домашней автоматизации. Оставшиеся 10–20% — экзотические протоколы и устройства, для которых придётся писать custom component (пользовательский компонент на C++). Но даже это проще, чем писать прошивку с нуля.

Установка ESPHome: три способа

В Home Assistant (рекомендуемый)

Если у тебя уже стоит Home Assistant — это самый простой путь.

Settings → Add-ons → Add-on Store
Ищи ESPHome
Install → Start → Show in Sidebar

Всё. ESPHome Dashboard (панель управления) появится в боковом меню Home Assistant. Оттуда — создание устройств, редактирование конфигов, прошивка.

Установка ESPHome в Home Assistant занимает пару минут. Аддон работает внутри контейнера, обновляется через интерфейс HA.

Docker (для тех, кто без Home Assistant)

ESPHome можно запустить отдельно, в Docker-контейнере (Docker — платформа контейнеризации).

yaml# docker-compose.yml
services:
  esphome:
    image: ghcr.io/esphome/esphome
    container_name: esphome
    volumes:
      - ./config:/config
    network_mode: host
    restart: unless-stopped

bashdocker compose up -d

Дашборд доступен на порту 6052: http://192.168.1.x:6052.

network_mode: host — важно. ESPHome использует mDNS (протокол обнаружения устройств в локальной сети) для поиска ESP-устройств, а mDNS не работает через стандартную сетевую модель Docker. Без host-режима устройства не обнаружатся.

ESPHome: прошиваем ESP32 для умного дома без единой строчки кода

10 марта 2026 г.9 мин чтения

Зачем ESPHome, если есть Arduino IDE

А в ESPHome тот же результат:

yamlsensor:
  - platform: dallas_temp
    address: 0x1234567890AB # Адрес датчика
    name: "Температура на балконе"
    update_interval: 60s

Шесть строк. Прошил, устройство появилось в Home Assistant. Показания обновляются каждую минуту. Всё.

Что ESPHome умеет из коробки

Список поддерживаемых устройств — огромный. Не всё, но основное:

По сути, ESPHome покрывает 80–90% задач домашней автоматизации. Оставшиеся 10–20% — экзотические протоколы и устройства, для которых придётся писать custom component (пользовательский компонент на C++). Но даже это проще, чем писать прошивку с нуля.

Установка ESPHome: три способа

В Home Assistant (рекомендуемый)

Если у тебя уже стоит Home Assistant — это самый простой путь.

Settings → Add-ons → Add-on Store
Ищи ESPHome
Install → Start → Show in Sidebar

Docker (для тех, кто без Home Assistant)

ESPHome можно запустить отдельно, в Docker-контейнере (Docker — платформа контейнеризации).

yaml# docker-compose.yml
services:
  esphome:
    image: ghcr.io/esphome/esphome
    container_name: esphome
    volumes:
      - ./config:/config
    network_mode: host
    restart: unless-stopped

bashdocker compose up -d

Дашборд доступен на порту 6052: http://192.168.1.x:6052.

Установка ESPHome в Docker — хороший вариант, если Home Assistant у тебя нет или он стоит на другой машине.

bashpip install esphome

Команда esphome станет доступна в терминале. Можно работать без веб-интерфейса — из CLI:

bashesphome run my_device.yaml

Это скомпилирует прошивку и зальёт на устройство. Вариант для тех, кто живёт в терминале.

Открываем ESPHome Dashboard. Жмём New Device, задаём имя (например, balcony-sensor), выбираем тип платы (ESP32).

yamlesphome:
  name: balcony-sensor
  friendly_name: "Датчик на балконе"

esp32:
  board: esp32dev # Для ESP32 DevKit / WROOM-32
  framework:
    type: arduino # Или esp-idf — об этом ниже

wifi:
  ssid: "YOUR_WIFI_SSID"
  password: "YOUR_WIFI_PASSWORD"

  # Резервная точка доступа — если не может подключиться к Wi-Fi
  ap:
    ssid: "Balcony-Sensor Fallback"
    password: "fallback_password"

# Позволяет управлять устройством через Home Assistant
api:
  encryption:
    key: "сгенерированный_ключ"

# OTA-обновления
ota:
  platform: esphome
  password: "ota_password"

logger:

Это — скелет. Устройство подключится к Wi-Fi, поднимет API для Home Assistant, включит OTA и логирование. Уже можно прошивать — но пока оно ничего полезного не делает.

DS18B20 — самый популярный датчик для ESPHome. Одна шина, несколько датчиков, водонепроницаемый корпус.

Подключение: VCC → 3.3V, GND → GND, Data → GPIO 4 (через подтягивающий резистор 4.7 кОм к 3.3V).

yaml# Шина OneWire на GPIO 4
one_wire:
  - platform: gpio
    pin: GPIO4

sensor:
  - platform: dallas_temp
    address: 0x1234567890ABCDEF # ⚠️ Адрес конкретного датчика
    name: "Температура балкон"
    update_interval: 30s
    filters:
      - sliding_window_moving_average:
          window_size: 5
          send_every: 3

Адрес датчика: при первой прошивке ESPHome сам покажет адреса всех обнаруженных DS18B20 в логах. Скопируй и вставь.

Фильтр sliding_window_moving_average — сглаживание. Датчик иногда шумит на ±0.5°C, скользящее среднее убирает выбросы. ESPHome поддерживает кучу фильтров: медиана, экспоненциальное среднее, калибровка, порог — настраивается под задачу.

yamli2c:
  sda: GPIO21
  scl: GPIO22

sensor:
  - platform: bme280_i2c
    temperature:
      name: "Температура комната"
    pressure:
      name: "Давление"
    humidity:
      name: "Влажность комната"
    update_interval: 60s
    address: 0x76 # Или 0x77 — зависит от модуля

Три сенсора из одного чипа, все автоматически появятся в Home Assistant как отдельные сущности.

yamlswitch:
  - platform: gpio
    pin: GPIO5
    name: "Реле полива"
    id: relay_watering

В Home Assistant появится переключатель. Щёлкнул — реле включилось. Щёлкнул ещё раз — выключилось. Можно добавить в автоматизации: «включать полив каждый день в 7 утра на 15 минут».

Первая прошивка ESP32 через ESPHome — только через USB. Устройство ещё не в сети, OTA не работает.

Нажми на устройство → три точки → Install → Plug into this computer. Dashboard скомпилирует прошивку и зальёт через браузер (используется Web Serial API — работает в Chrome и Edge).

Если браузер не видит устройство — нужен драйвер USB-UART. CP2102 или CH340 — зависит от платы. Детали — в документации конкретной платы.

bashesphome run balcony-sensor.yaml

После первой прошивки устройство в сети. В Dashboard рядом с именем появится зелёный кружок (онлайн). Теперь прошивка — по воздуху:

bashesphome run balcony-sensor.yaml
# Выбираешь OTA вместо USB

Изменил конфиг, нажал Install — новая прошивка полетела по Wi-Fi. Не нужно снимать устройство с потолка, выковыривать из корпуса, искать кабель. Это, пожалуй, главное преимущество ESPHome перед ручной прошивкой через Arduino IDE.

Если ESPHome устройство и Home Assistant в одной сети — HA обнаружит его автоматически.

Settings → Devices & Services → появится уведомление «Discovered: balcony-sensor». Жмёшь Configure, вводишь ключ шифрования API (тот, что в YAML) — и устройство добавлено. Все сенсоры, переключатели, кнопки — сразу в интерфейсе HA.

Настройка ESPHome в Home Assistant — по сути, одно нажатие. Дальше показания появляются в дашбордах, доступны в автоматизациях, пишутся в историю.

Если Home Assistant нет — ESPHome всё равно полезен. Встроенный веб-сервер позволяет управлять устройством через браузер:

yamlweb_server:
  port: 80

Открываешь IP устройства — видишь все сенсоры и переключатели. Без HA, без облака, без приложений.

ESP32 как мост для BLE-устройств (Bluetooth Low Energy — энергоэффективный Bluetooth). Xiaomi-термометры, трекеры, BLE-маяки — всё, что Home Assistant не видит напрямую (потому что Bluetooth-радиус маленький), ESP32 подхватит и передаст по Wi-Fi.

yamlesp32_ble_tracker:
  scan_parameters:
    active: true

bluetooth_proxy:
  active: true

Четыре строки — и ESP32 стал Bluetooth-прокси. Разбросай пару штук по дому — и Home Assistant видит BLE-устройства в каждой комнате.

ESPHome поддерживает ИК-передатчики и протоколы десятков производителей кондиционеров.

yamlremote_transmitter:
  pin: GPIO14
  carrier_duty_percent: 50%

climate:
  - platform: midea # Или daikin, lg, samsung, gree...
    name: "Кондиционер спальня"
    transmitter_id: remote_transmitter

В Home Assistant появится полноценный термостат: режим, температура, скорость вентилятора. ESPHome управляет кондиционером через ИК — как обычный пульт, только умный.

Импульсный выход водосчётчика (геркон или датчик Холла) подключается к GPIO:

yamlsensor:
  - platform: pulse_counter
    pin: GPIO12
    name: "Расход воды"
    unit_of_measurement: "л"
    filters:
      - multiply: 0.1 # 10 импульсов = 1 литр (зависит от счётчика)
    total:
      name: "Всего воды"
      unit_of_measurement: "м³"
      filters:
        - multiply: 0.001

ESPHome считает импульсы, пересчитывает в литры, отправляет в Home Assistant. Там — графики, уведомления о расходе, обнаружение протечек.

LD2410 (микроволновый датчик присутствия) — модная штука для умного дома. Определяет наличие человека, даже если он сидит неподвижно (в отличие от PIR-датчиков).

yamluart:
  tx_pin: GPIO17
  rx_pin: GPIO16
  baud_rate: 256000

ld2410:

binary_sensor:
  - platform: ld2410
    has_target:
      name: "Присутствие"
    has_moving_target:
      name: "Движение"
    has_still_target:
      name: "Неподвижный объект"

yamlesp32:
  board: esp32-c3-devkitm-1
  framework:
    type: esp-idf # Для C3 рекомендуется esp-idf, не arduino

ESP32-C3 в ESPHome — хороший выбор для компактных датчиков. Super Mini помещается в любой корпус.

yamlesp8266:
  board: nodemcuv2

ESPHome поддерживает ESP8266 полноценно. Для простых датчиков (температура, влажность, реле) — хватает. Ограничения: нет Bluetooth, меньше GPIO, меньше памяти.

Sonoff и готовые устройства: многие Wi-Fi-реле и выключатели (Sonoff Basic R2, Sonoff TH, CB3S-модули) перепрошиваются на ESPHome. После перепрошивки — никакого облака, локальное управление через Home Assistant.

Кстати, ESPHome с версии 2023.x начал поддерживать чипы BK7231N (Beken) — те самые, на которые Tuya (платформа для IoT-устройств) массово перешла с ESP8266. Если твоё «тупое» Wi-Fi-реле внезапно оказалось на BK7231N, а не на ESP — теперь и его можно перевести на ESPHome.

В конфиге ESP32 есть параметр framework: type. Два варианта:

arduino — используется Arduino Core для ESP32. Максимум совместимости с библиотеками Arduino. Дефолт для большинства устройств
esp-idf — нативный фреймворк Espressif (ESP-IDF). Больше возможностей (Bluetooth, продвинутая работа с памятью), но некоторые компоненты ESPHome ещё не полностью поддержаны

Для ESP32-C3 и ESP32-S3 ESPHome рекомендует esp-idf. Для классического ESP32 — arduino по умолчанию, esp-idf если нужен Bluetooth Proxy.

После первой прошивки по USB устройство должно подключиться к Wi-Fi и появиться онлайн. Если не появляется:

Проверь SSID и пароль в YAML (опечатки — классика)
ESP32 работает только на 2.4 ГГц. Если роутер раздаёт объединённую сеть 2.4+5 — попробуй разделить
Посмотри логи: ESPHome Dashboard → Logs (если USB ещё подключён) или Serial Monitor

Ошибка при компиляции: Linking .pio/build/.../firmware.elf ... region 'iram0_0_seg' overflowed. Слишком много компонентов для доступной памяти.

Решения: уменьшить количество компонентов, использовать esp-idf вместо arduino (экономнее по памяти), выбрать плату с бо́льшим Flash (8 или 16 МБ).

Частая проблема, особенно на ESP8266. Причины: слабый сигнал, перегруженный канал Wi-Fi, нехватка памяти.

yamlwifi:
  power_save_mode: none # Отключить энергосбережение Wi-Fi
  fast_connect: true # Не сканировать все каналы, подключаться к известному

ESPHome — инструмент, который закрывает потребности домашней автоматизации без написания кода. Датчики, реле, дисплеи, кондиционеры, счётчики — всё описывается в YAML и прошивается одной кнопкой.

ESPHome + Алиса — через Home Assistant и интеграцию Yandex Smart Home. ESPHome-устройства становятся доступны голосом: «Алиса, включи полив»
Автономный термостат — ESPHome умеет управлять отоплением самостоятельно, без Home Assistant. Компонент climate + thermostat = PID-регулятор прямо на ESP32
Дисплей — OLED 0.96" или TFT, подключённый к ESP32, показывает температуру, время, статус устройств. Конфигурируется в том же YAML

Но главное — начни с одного датчика. Когда увидишь, как он появляется в Home Assistant через 30 секунд после прошивки — захочется ещё.

Блог о домашней инфраструктуре: умный дом, серверы, сети. Только реальный опыт и честные рекомендации.

ESPHome: прошиваем ESP32 для умного дома без единой строчки кода

Зачем ESPHome, если есть Arduino IDE

Что ESPHome умеет из коробки

Установка ESPHome: три способа

В Home Assistant (рекомендуемый)

Docker (для тех, кто без Home Assistant)

ESPHome: прошиваем ESP32 для умного дома без единой строчки кода

Зачем ESPHome, если есть Arduino IDE

Что ESPHome умеет из коробки

Установка ESPHome: три способа

В Home Assistant (рекомендуемый)

Docker (для тех, кто без Home Assistant)

pip (для разработчиков)

Первое устройство: от конфига до прошивки

Добавляем датчик температуры

Добавляем BME280 (температура + влажность + давление)

Добавляем реле

Прошивка: первый раз — по кабелю, дальше — по воздуху

Из ESPHome Dashboard

Из CLI

Все последующие разы — OTA

Интеграция с Home Assistant

Проекты посложнее

Bluetooth Proxy

Управление кондиционером через ИК

Счётчик воды

Датчик присутствия LD2410

ESP32-C3, ESP8266 и другие платформы

Framework: Arduino или ESP-IDF?

Типичные грабли

Устройство не появляется в Dashboard

Не хватает Flash-памяти

Устройство периодически отваливается от Wi-Fi

Что дальше

Разделы

Рекомендуем

Популярное