Kitabı oxu: «Курс создания IOT устройств с помощью esphome»

Şrift:

ГЛАВА 1. ВВЕДЕНИЕ В IoT И ESPHome

1.1. Что такое Internet of Things (IoT)

Internet of Things (Интернет вещей) — это сеть физических объектов, оснащённых

датчиками, исполнительными механизмами, микроконтроллерами и средствами связи.

Эти устройства собирают данные об окружающей среде, обмениваются ими и принимают

решения с минимальным участием человека.

Типичные сферы применения:

• Умный дом: освещение, климат, безопасность, энергомониторинг

• Промышленность: мониторинг оборудования, предиктивное обслуживание

• Сельское хозяйство: влажность почвы, теплицы, полив

• Медицина: носимые датчики, удалённый мониторинг пациентов

• Городская инфраструктура: освещение улиц, парковки, качество воздуха

Ключевые требования к IoT-устройству:

• Надёжность (стабильная работа месяцами без перезагрузки)

• Энергоэффективность (особенно для батарейных узлов)

• Безопасность (защита от несанкционированного доступа)

• Локальный контроль (работа без обязательного облака)

• Простота интеграции в существующую систему автоматизации

1.2. Почему именно ESPHome

ESPHome — open-source система, которая превращает микроконтроллеры ESP8266,

ESP32 (и ряд других платформ) в полноценные умные устройства. Вместо написания

прошивки на C++ вы описываете поведение устройства в YAML-файле. ESPHome

компилирует конфигурацию в оптимизированную прошивку и загружает её на чип.

Преимущества ESPHome:

• Нет необходимости писать C++ для 95% типичных задач

• Нативная интеграция с Home Assistant — сущности появляются автоматически

• Обновление прошивки по воздуху (OTA) без физического доступа

• Сотни готовых компонентов: сенсоры, дисплеи, реле, климат, медиа

• Локальный контроль: устройства работают в вашей сети без облака

• Активное сообщество, регулярные релизы, подробная документация

• Поддержка Arduino и ESP-IDF framework

• Возможность писать lambda (вставки C++) при необходимости

Альтернативы и сравнение:

• Tasmota — тоже YAML/веб-конфиг, силён в готовых прошивках для реле/розеток

• ESPEasy — гибкий, но сложнее в освоении

• Чистый Arduino / ESP-IDF — полный контроль, но больше кода и поддержки

• PlatformIO + свои скетчи — гибко, но интеграция с HA делается вручную

ESPHome особенно удобен, если у вас уже есть (или планируется) Home Assistant.

1.3. Как устроен процесс разработки

Типичный цикл:

1. Создаёте YAML-конфигурацию (через wizard, Device Builder или вручную)

2. ESPHome проверяет синтаксис и собирает прошивку (PlatformIO под капотом)

3. Загружаете прошивку на устройство:

— первый раз по USB (UART)

— далее — по OTA (Wi-Fi)

4. Устройство подключается к Wi-Fi, поднимает Native API

5. Home Assistant обнаруживает устройство и создаёт сущности

6. Настраиваете автоматизации в HA или прямо в ESPHome

Способы работы:

• Home Assistant Add-on (самый простой путь)

• ESPHome Device Builder (веб-UI, можно в Docker)

• Командная строка: esphome run / compile / upload / logs

• CI/CD (проверка конфигураций в git)

1.4. Что вы узнаете в этом курсе

Курс построен от простого к сложному:

• Главы 1–5 — фундамент (железо, установка, YAML, сеть)

• Главы 6–11 — компоненты (сенсоры, актюаторы, шины, дисплеи)

• Главы 12–16 — продвинутые возможности и эксплуатация

• Главы 17–18 — два полноценных проекта

• Главы 19–20 — кастомные компоненты, масштабирование, ресурсы

ГЛАВА 2. АППАРАТНАЯ ПЛАТФОРМА: ESP8266 И ESP32

2.1. Семейство ESP

Микроконтроллеры Espressif Systems стали стандартом DIY IoT благодаря:

• Низкой цене

• Встроенному Wi-Fi (и Bluetooth у большинства ESP32)

• Достаточному количеству GPIO и периферии

• Огромной экосистеме и поддержке сообществом

ESPHome официально поддерживает ESP8266, ESP32 и множество вариантов.

2.2. ESP8266

Характеристики (типичные):

• Одноядерный Tensilica L106, 80/160 МГц

• ~80 КБ RAM, доступной приложению

• Flash: обычно 1–4 МБ

• Wi-Fi 802.11 b/g/n

• Нет Bluetooth

• Ограниченное число безопасных GPIO

Популярные платы:

• NodeMCU v2 / v3

• Wemos D1 Mini

• ESP-01 / ESP-01S (очень мало пинов)

• Sonoff Basic (готовое реле с ESP8266)

Рекомендация ESPHome: для НОВЫХ проектов лучше брать ESP32-C3

(сопоставимая цена, больше RAM и flash, BLE). ESP8266 продолжают

поддерживаться, существующие устройства работают стабильно.

Особые пины ESP8266 (нельзя использовать свободно):

GPIO0, GPIO2, GPIO15 — влияют на режим загрузки

GPIO1, GPIO3 — UART0 (TX/RX)

GPIO6–11 — подключены к flash

2.3. ESP32 и варианты

Оригинальный ESP32:

• Двухъядерный Xtensa LX6, до 240 МГц

• ~320 КБ RAM, часто 4 МБ flash (+PSRAM на некоторых платах)

• Wi-Fi + Bluetooth Classic/BLE

• Богатая периферия (ADC, DAC, touch, hall, CAN и т.д.)

• Самый зрелый и рекомендуемый вариант для большинства проектов

Варианты:

ESP32-S2

Wi-Fi, без BLE, USB OTG, хорош для устройств с USB

ESP32-S3

Двухъядерный, Wi-Fi + BLE 5, больше AI/ускорителей, часто с PSRAM

ESP32-C3

Одноядерный RISC-V, Wi-Fi + BLE 5, позиционируется как замена ESP8266

Меньше GPIO, ниже потребление, отличный выбор для простых узлов

ESP32-C6

RISC-V, Wi-Fi 6 + BLE + Thread/Zigbee (OpenThread в ESPHome)

Хороший выбор для новых проектов с Mesh/Thread

ESP32-H2

BLE + Thread/Zigbee, без Wi-Fi — для чистых Thread-устройств

ESP32-P4

Высокопроизводительный RISC-V, для сложных задач (видео, UI)

Рекомендации ESPHome (актуальные):

• Лучший общий выбор: ESP32 (классический)

• Бюджетный/простой узел: ESP32-C3

• Новый проект с перспективой Thread: ESP32-C6

• Не рекомендуют для новых проектов: ESP8266

2.4. Выбор конкретной платы

На что смотреть:

• Чип и объём flash/PSRAM

• Наличие USB-UART (CP2102, CH340, встроенный USB у C3/S2/S3)

• Распиновка и удобство макетирования (DevKit vs модуль)

• Ethernet (Olimex ESP32-POE, WT32-ETH01)

• Дисплей на борту (LilyGO T-Display, M5Stack)

• Питание: 5 В USB, 3.3 В, Li-ion

Примеры board ID для ESPHome (PlatformIO):

esp32dev — универсальный ESP32

nodemcuv2 — NodeMCU ESP8266

esp32-c3-devkitm-1

esp32-s3-devkitc-1

mhetesp32devkit

lolin_s2_mini

Если точной платы нет в списке — почти всегда работает generic:

esp32dev / esp01_1m / esp32-c3-devkitm-1

2.5. Питание и надёжность

• Стабильные 3.3 В (не ниже 3.0 В под нагрузкой Wi-Fi)

• Condensators 100 nF + 10–100 µF рядом с модулем

• Для реле и мощных нагрузок — отдельное питание, общая земля

• Избегайте длинных тонких проводов питания

• Brownout detector на ESP32 может перезагружать устройство при просадках

ГЛАВА 3. УСТАНОВКА И НАСТРОЙКА СРЕДЫ РАЗРАБОТКИ

3.1. Способы установки

1) Home Assistant Add-on

Самый простой путь. В HA: Settings → Add-ons → Add-on Store → ESPHome.

После установки открывается веб-интерфейс Dashboard.

2) Docker

docker run -d --name esphome -v /path/to/config:/config \

-v /etc/localtime:/etc/localtime:ro --network host \

ghcr.io/esphome/esphome

3) pip (командная строка)

python3 -m venv esphome-venv

source esphome-venv/bin/activate # Windows: esphome-venv\Scripts\activate

pip install esphome

esphome version

4) ESPHome Device Builder (standalone веб-UI)

Можно запускать локально или в контейнере, удобен без полного HA.

3.2. Первая конфигурация через wizard

esphome wizard my_device.yaml

Мастер спросит:

• Имя устройства (hostname, латиница, без пробелов)

• Платформу (ESP32 / ESP8266)

• Плату (board)

• SSID и пароль Wi-Fi

Будет создан базовый YAML. Дальше редактируете его и запускаете:

esphome run my_device.yaml

Команда скомпилирует, предложит способ загрузки (USB / OTA) и сразу

покажет логи.

3.3. Структура каталога проектов

Рекомендуемая структура:

esphome-configs/

├── secrets.yaml

├── packages/

│ ├── base_wifi.yaml

│ ├── base_api.yaml

│ └── sensors_common.yaml

├── livingroom.yaml

├── bedroom_switch.yaml

└── weather_station.yaml

secrets.yaml (никогда не коммитьте в публичный репозиторий):

wifi_ssid: "MyHomeWiFi"

wifi_password: "supersecret"

api_encryption_key: "сгенерированный_ключ_base64"

ota_password: "ota_secret"

Генерация ключа шифрования API:

openssl rand -base64 32

3.4. Полезные команды CLI

esphome config device.yaml # только проверка конфигурации

esphome compile device.yaml # сборка без загрузки

esphome upload device.yaml # только загрузка

esphome logs device.yaml # логи (USB или API)

esphome run device.yaml # compile + upload + logs

esphome clean device.yaml # очистка сборочного кэша

esphome wizard new.yaml # мастер новой конфигурации

3.5. Первая прошивка по USB

1. Подключите устройство USB-кабелем (data-кабель, не charge-only)

2. На многих ESP32: зажмите BOOT, нажмите RESET, отпустите RESET, затем BOOT

3. Выберите порт в меню esphome run

4. Дождитесь окончания загрузки

5. После успеха устройство само подключится к Wi-Fi

Типичные проблемы первой загрузки:

• Не тот COM-порт / драйвер CH340/CP2102 не установлен

• Кабель только для зарядки

• Устройство не в режиме download (не зажат GPIO0/BOOT)

• Нехватка прав (Linux: пользователь в группе dialout)

ГЛАВА 4. ОСНОВЫ YAML-КОНФИГУРАЦИИ ESPHome

4.1. Минимальная рабочая конфигурация

esphome:

name: livingroom

friendly_name: Гостиная

comment: "Основной контроллер гостиной"

area: Living Room

esp32:

board: esp32dev

framework:

type: arduino # или esp-idf

wifi:

ssid: !secret wifi_ssid

password: !secret wifi_password

logger:

api:

encryption:

key: !secret api_encryption_key

ota:

- platform: esphome

password: !secret ota_password

4.2. Секция esphome

Основные поля:

name — hostname и уникальный ID (латиница, дефисы)

friendly_name — красивое имя в Home Assistant

area — помещение (для HA)

comment — произвольный комментарий

build_path — путь сборки (редко нужно)

platformio_options — тонкая настройка PlatformIO

on_boot / on_shutdown / on_loop — хуки жизненного цикла

Пример on_boot:

esphome:

name: livingroom

on_boot:

priority: 600

then:

- logger.log: "Устройство загрузилось"

- light.turn_on: status_led

4.3. Substitutions (переменные)

substitutions:

device_name: livingroom

upper_name: Livingroom

relay_pin: GPIO5

button_pin: GPIO4

esphome:

name: ${device_name}

friendly_name: ${upper_name}

switch:

- platform: gpio

pin: ${relay_pin}

name: "${upper_name} Relay"

4.4. Packages (переиспользование)

packages/base.yaml:

esphome:

name: ${device_name}

wifi:

ssid: !secret wifi_ssid

password: !secret wifi_password

ap:

ssid: "${device_name}-fallback"

password: !secret fallback_password

logger:

api:

encryption:

key: !secret api_encryption_key

ota:

- platform: esphome

password: !secret ota_password

В устройстве:

substitutions:

device_name: bedroom-switch

packages:

base: !include packages/base.yaml

switch:

- platform: gpio

pin: GPIO5

name: "Bedroom Light"

4.5. !include и !secret

!secret key — значение из secrets.yaml

!include file.yaml — вставить содержимое файла

!include { file: x.yaml, vars: { a: 1 } } — с переменными

4.6. Комментарии и стиль

# однострочный комментарий

# Имена сущностей лучше делать понятными на русском или английском

# id — латиница, используется в автоматизациях ESPHome

# name — то, что видит пользователь в HA

Pulsuz fraqment bitdi.

Yaş həddi:
12+
Litresdə buraxılış tarixi:
30 sentyabr 2026
Yazılma tarixi:
2026
Həcm:
27 səh. 1 illustrasiya
Müəllif hüququ sahibi:
Автор
Yükləmə formatı: