Skip to main content

Установка ESPHome на Windows 10

Давай установим ESPHome напрямую на Windows 10, без Docker, с понятными шагами и подробными комментариями.

Я покажу самый надёжный способ через Python + pipx — это официальный и рекомендуемый вариант.

🧱 Что в итоге получим

  • ESPHome запускается из командной строки Windows

  • Можно:

    • создавать .yaml прошивки

    • прошивать ESP по USB

    • обновлять ESPHome OTA

  • Работает независимо от Home Assistant
    (но отлично с ним дружит)

0️⃣ Предварительные требования

✅ Что нужно:

  • Windows 10 (у тебя есть)

  • Доступ администратора

  • ESP8266 / ESP32

  • USB-кабель DATA, не только зарядка

1️⃣ Установка Python (если уже есть — всё равно проверь)

🔹 Скачай Python

👉 https://www.python.org/downloads/windows/

Рекомендуемая версия: Python 3.11.x

🔹 ВАЖНО при установке

На первом экране обязательно поставь галочку:

☑ Add Python to PATH

Затем:

  • Install Now

🔹 Проверка установки

Открой CMD или PowerShell и выполни:


python --version

Ожидаемый результат (пример):


Python 3.11.7

2️⃣ Установка pipx (чистый и безопасный способ)

pipx позволяет ставить ESPHome изолированно, без мусора в системе.


python -m pip install --user pipx

Добавляем pipx в PATH:


python -m pipx ensurepath

⚠️ После этого:

  • закрой CMD

  • открой заново

🔹 Проверка pipx


pipx --version

3️⃣ Установка ESPHome


pipx install esphome

⏳ Подождать 1–2 минуты — pipx сам подтянет всё нужное.

🔹 Проверка ESPHome


esphome version

Пример:


ESPHome 2025.2.0

✅ Значит установка прошла успешно

4️⃣ Создание проекта ESPHome

📁 Создаём папку для проектов


mkdir C:\esphome cd C:\esphome

🧠 Создаём конфигурацию устройства


esphome wizard test_esp.yaml

ESPHome задаст вопросы:


Name of the node → test_esp ESP type → ESP32 / ESP8266 WiFi SSID → твой WiFi WiFi Password → пароль

📌 В результате появится файл:


test_esp.yaml

5️⃣ Прошивка ESP по USB (первый раз)

🔌 Подключи ESP к ПК по USB

Если драйверов нет:

  • CH340 — для большинства ESP32

  • CP210x — для ESP32 DevKit

(Windows часто ставит сам)

🚀 Прошивка


esphome run test_esp.yaml

ESPHome:

  • скомпилирует прошивку

  • предложит порт (COM3, COM4 и т.д.)

  • зальёт прошивку

6️⃣ OTA-прошивки (без USB)

После первой прошивки:


esphome run test_esp.yaml

ESPHome сам:

  • найдёт устройство в сети

  • предложит OTA

  • прошьёт по Wi-Fi

7️⃣ Подключение к Home Assistant

В Home Assistant:


Настройки → Устройства и службы → ESPHome → Добавить

ESP появится автоматически, если:

  • в одной сети

  • ESP включён

8️⃣ Полезные команды (шпаргалка)


esphome compile test_esp.yaml :: Только компиляция esphome upload test_esp.yaml :: Загрузка прошивки esphome logs test_esp.yaml :: Логи устройства esphome clean test_esp.yaml :: Очистка кэша

9️⃣ Типичные проблемы и решения

❌ esphome: command not found

➡️ CMD не перезапущен после pipx ensurepath

❌ ESP не определяется

➡️ Проверь:

  • кабель DATA

  • драйвер USB-UART

  • COM-порт в диспетчере устройств

❌ OTA не работает

➡️ Проверь:

  • ESP и ПК в одной сети

  • firewall Windows (разреши Python)

🔧 Что делаем дальше?

Можем:

  • собрать минимальный YAML под твою плату

  • добавить GPIO / реле / датчики

  • прошить ESP без Home Assistant

  • сделать ESP как Wi-Fi реле

👉 Напиши:

  • ESP32 или ESP8266?

  • какая плата (DevKit, NodeMCU, Wemos, ESP32-C3 и т.д.)

  • что ты хочешь к ней подключить

Дальше пойдём уже «по-железу» 🔌💡

Back to top