ESP-helper

Обновлено 2026-09-22

Emporia Vue 2

Emporia, модель Vue 2. 4/5 · пайка. Модуль Wi-Fi говорит со вторым микроконтроллером.

1. Название и модель

emporia-vue-local/esphome заменяет облако Emporia локальным компонентом emporia_vue. Актуальная инструкция уехала на сайт проекта. Пины ниже взяты из старого README, на который новый файл всё ещё ссылается.

На плате I2C: SDA 21, SCL 22, 400 кГц. В примере variant: vue2. Фаза A в этом файле повешена на провод BLACK, фаза B на RED, стартовая калибровка напряжения 0.022. Автор пишет, что цвет и фазу надо сверить со щитом, а 0.022 только точка старта.

Клеммы токовых клещей в том же файле идут парами A и B, дальше по номерам 1, 2, 3… У вводов в оригинале нет name, только id: в Home Assistant их выводят отдельными копиями. Короткий пример на сайте имена ставит, иначе два ввода не появятся.

Сеть 230 В на время прошивки отключают. Автор пишет, что питать Vue от щита в этот момент смертельно и всё равно не получится прошить. Корпус закрывают до того, как вернут питание щита.

Зуммер в том файле сидит на GPIO12 и земле GPIO27, светодиод статуса на пине 23.

2. Что даёт перепрошивка

  • Мощность по клещам обновляется локально, в новом README интервал около пяти секунд
  • Облако Emporia для этих данных больше не нужно

3. Что теряется

  • Штатное приложение после замены прошивки эти данные не ведёт
  • Калибровку 0.022 почти наверняка придётся поправить по формуле из файла
  • Разводка фаз в примере американская, двухплечевая. Её переносят на свой щит, а не копируют вслепую

4. Что понадобится

  • Vue 2, не Gen 3: для третьего поколения в файле другое значение variant: vue3
  • USB-UART и пайка гребёнки на отладочный разъём
  • Копия флеша до первой записи

5. Разборка и пины

Программатор USB–UART подключают к модулю, который прошивают, крест-накрест:

  • Земля переходника (GND) — на землю платы. Этот провод обязателен.
  • TX переходника — на RX модуля. На плате площадка часто подписана RX, RXD или RXD0.
  • RX переходника — на TX модуля. На плате это TX, TXD или TXD0.
  • Питание логики — 3,3 В. Пять вольт на эти площадки не подают. Если плату уже кормит её блок, линию 3,3 В с переходника не подключают вторым источником.
  • Для входа в загрузчик ESP8266 и ESP32 площадку GPIO0 (IO0, BOOT) замыкают на землю и в этот момент подают питание. После старта записи землю с GPIO0 снимают.

Если у этой модели в тексте ниже другие имена площадок, прямой порядок TX–TX или прошивка по USB, делайте как написано там. Общая схема выше — для обычного модульного UART.

Корпус снимают при снятом питании щита. На разъём паяют штыри. В старом README: RX программатора на RX платы, TX на TX, земля на землю. Пять вольт в этот момент ещё не подают.

6. Прошивка

Готового файла «прошивка именно этой модели» на этом сайте нет. Её собирает ESPHome из текстового конфига YAML: туда входят Wi-Fi, пины и команды второго чипа. Чужой .bin из интернета почти наверняка собран с чужим паролем сети.

Какую программу ставить

  • ESPHome Dashboard — дополнение в Home Assistant или программа на компьютере. В ней пишут YAML, нажимают Install, и она сама собирает прошивку. Установка: дополнение для Home Assistant или команда pip install esphome.
  • ESPHome Web, сайт web.esphome.io, — загрузчик в браузере Chrome или Edge. Им записывают уже собранный .bin на ESP8266 и ESP32 через USB–UART. На BK72xx он не рассчитан.
  • esptool — программа Espressif, чтобы снять заводскую копию флеша и записать .bin, если браузер порт не видит. Репозиторий: espressif/esptool.
  • ltchiptool — то же самое для чипов Beken BK72xx (модули WB3S, WBR3, CB3S и похожие). ESPHome для них собирается через LibreTiny. Программа: libretiny-eu/ltchiptool, описание платы: компонент bk72xx.

Как собрать конфиг

  1. В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
  2. Пароль Wi-Fi уберите в файл secrets.yaml рядом с конфигом. В YAML оставьте ssid: !secret wifi_ssid и password: !secret wifi_password.
  3. Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
  4. Строки api: и ota: оставьте. Без api: Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.

Как залить первый раз

  1. Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
  2. Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
  3. В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните .bin и откройте его на web.esphome.io. Из терминала то же самое делает esphome run имя-устройства.yaml.
  4. Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.

Дальше — только то, чем эта модель отличается от общей схемы.

Провод с IO0 прижимают к экрану ESP32. Затем 5 В программатора сажают на VCC_5V0. Если у адаптера есть DTR и RTS, IO0 идёт на DTR, EN на RTS, руками прижимать не нужно.

Сначала снимают дамп: esptool.py -b 921600 read_flash 0 0x800000 flash_contents.bin. Если не вышло, автор предлагает 115200. Без этого файла завод не вернуть.

Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.

i2c:
  sda: 21
  scl: 22
  scan: false
  frequency: 400kHz
  timeout: 1ms
  id: i2c_a

sensor:
  - platform: emporia_vue
    variant: vue2
    i2c_id: i2c_a
    phases:
      - id: phase_a
        input: BLACK
        calibration: 0.022
        voltage:
          name: Напряжение A
      - id: phase_b
        input: RED
        calibration: 0.022
        voltage:
          name: Напряжение B
    ct_clamps:
      - phase_id: phase_a
        input: "A"
        power:
          name: Ввод A
      - phase_id: phase_b
        input: "B"
        power:
          name: Ввод B

7. Настройка в Home Assistant

Сенсоры мощности и дневная энергия собираются уже в Home Assistant из id клещей. Время для суточных счётчиков в файле берётся из Home Assistant.

8. Известные баги и как их обойти

  • Прошивали, не отключив щит
  • RX программатора посажен на TX платы, хотя в этом README написано RX к RX и TX к TX
  • Фаза BLACK оставлена на плече, куда приходит другой цвет
  • Нет дампа флеша, откатить нечем

9. Источники