Установка RBgrid внутри Home Assistant: пошаговая инструкция, включая три способа, которыми это идёт не так

Вы подняли Home Assistant, слышали, что RBgrid можно запустить внутри него как устройство ESPHome, и сделали очевидное: открыли HACS и поискали его.

Ничего не нашлось. Это правильно и ничего не говорит о том, существует ли интеграция.

RBgrid нет в стандартном списке HACS. Пока вы сами его не добавите, поиск ничего не находит, поэтому пустой результат поиска — не доказательство отсутствия, а ожидаемый первый шаг пути, о котором вам никто не сказал. Эта статья и есть этот путь, с местами, где он идёт не так, названными прямо, а не спрятанными.

Что-то уже пошло не так? Все сбои собраны в одной таблице в конце: симптом, причина и что делать.

Что понадобится до начала

⚠️ Версия Home Assistant — не рекомендация, а условие работы. Панель RBgrid опирается на ответы действий (action responses), которых в старых версиях нет. На более старом Home Assistant панель просто не работает, и выглядит это как сломанная интеграция, а не как старая установка. Если панель пустая, сначала проверьте именно это.

1. Прошейте хаб

Скачайте заводской образ для своей платы из релизов rb-amp/rbgrid-esphome. Их два: для ESP32-WROVER и для ESP32-S3. Затем откройте web.esphome.io в Chrome или Edge, нажмите Connect, выберите последовательный порт вашей платы, нажмите Install и выберите скачанный файл.

Home Assistant здесь не запрашивает ключ шифрования API: готовый образ собран без него, поэтому устройство добавляется одним подтверждением. Ключ запрашивается, только если вы собрали свою конфигурацию с ключом.

Настройте Wi-Fi сразу после прошивки, по тому же USB-кабелю, когда установщик это предложит. Тогда хабу вообще не понадобится точка доступа для настройки. Если же вы пойдёте через точку доступа, смените её пароль, как только хаб будет добавлен.

esptool тоже подойдёт: заводской образ записывается по смещению 0x0.

⚠️ Это касается вашей собственной сборки YAML, а не готового образа. Компонент несёт таблицу разделов, в которой приложение находится по смещению 0x20000, тогда как встроенные USB-инструменты ESPHome предполагают стандартное 0x10000. При прошивке по USB инструментами ESPHome — esphome run на последовательный порт или Manual download → Factory format — ваша сборка попадает не по тому адресу, и плата ничего нового не запускает: пустая плата не загружается, а плата со старым образом тихо продолжает работать на старом.

Для первой установки по USB используйте готовый заводской образ со страницы релизов (он уже собран с правильными смещениями и записывается по 0x0) или esptool со смещениями из flasher_args.json вашей сборки. Когда хаб подключится к сети, загружайте свои сборки по воздуху (OTA): esphome run, когда хаб доступен, или Install → Wirelessly. По воздуху передаётся только приложение, и устройство размещает его по своей таблице разделов, так что смещение верно по построению.

Это шаг, который ломается молча. Вы уже внутри инструмента ESPHome, он предлагает загрузку в заводском формате, файл выглядит правильно, прошивка проходит успешно, а плата после этого ничего не делает. Ошибки, которую можно найти в поиске, нет, поэтому её обычно принимают за мёртвое железо.

Или соберите в свою конфигурацию

Если вы уже храните устройства ESPHome как YAML, добавьте компонент как внешний источник вместо прошивки заводского образа:

external_components:
  - source:
      type: git
      url: https://github.com/rb-amp/rbgrid-esphome
      ref: v1.2.0   # the tag of the release you are installing — see the repository's Releases
      path: esphome/components
    components: [rbgrid]

2. Добавьте RBgrid в HACS как пользовательский репозиторий

Именно этот шаг подменял собой результат поиска в начале статьи, и он состоит из трёх действий, а не одного:

1. в HACS добавьте https://github.com/rb-amp/rbgrid-ha как пользовательский репозиторий с категорией Integration;
2. установите RBgrid из него;
3. перезапустите Home Assistant.

Перезапуск не необязателен и не суеверие: только что установленная интеграция загружается при старте.

3. Сначала настройте ESPHome, потом RBgrid

После перезапуска в Settings → Devices & services должны появиться две карточки: ESPHome (само устройство) и RBgrid (эта интеграция).

Сначала настройте карточку ESPHome. Карточка RBgrid ждёт её, потому что RBgrid работает с устройством, которое Home Assistant уже знает. Если настроить в другом порядке, подключаться будет не к чему.

Затем нажмите Configure на карточке RBgrid. По ходу ESPHome предложит свой диалог Name and assign со списком хаба и его слотов. Нажмите Skip: имена берутся из самих точек.

На последнем шаге есть два флажка, которые стоит прочитать, а не проскочить:

• Configure the Energy dashboard with this hub: включён по умолчанию, если ваш Energy dashboard пуст. Именно это помещает сущности хаба на Energy dashboard.
• Set the hub's tariff plan to Home Assistant's currency: оставьте включённым. Хаб и Home Assistant должны считать в одной валюте, потому что ничего между ними не конвертируется: Energy dashboard просто подписывает числа хаба своей валютой. Если они когда-нибудь разойдутся, вкладка «Тариф» на панели RBgrid скажет об этом и предложит исправление в один клик.

Когда всё закончится, в боковой панели появится панель RBgrid Hub (также по адресу /rbgrid), импорт статистики начнётся в течение минуты, а хаб появится на Energy dashboard после ближайшего полного часа, потому что эта статистика записывается через пару минут после каждого часа.

⚠️ Нет карточки RBgrid вообще? mDNS не доходит до Home Assistant в некоторых сетях, чаще всего в сети Docker bridge. Используйте Add integration → RBgrid: там перечислены хабы, которые уже есть в интеграции ESPHome. То же касается случая после удаления хаба: Home Assistant сам его заново не обнаружит, поэтому либо перезапустите его, либо используйте Add integration.

4. Что вы видите после подключения и почему это выглядит скудно

Точка — это одно именованное измерение: цепь, которую вы задаёте на панели RBgrid и привязываете к клещам на канале модуля. Слот — место, которое точка занимает в Home Assistant. Хаб открывает двенадцать слотов измерений — те же двенадцать, для которых хаб ведёт историю. Имя каждого слота есть с самого начала; остальные сущности слота появляются, когда к нему привязана точка, что вы делаете на вкладке «Точки» панели.

Поэтому после подключения вы видите двенадцать имён, а не двенадцать устройств с пустыми датчиками. Это третье, что люди принимают за ошибку: интеграция «добавила почти ничего». Она добавила структуру; сущности появятся по мере того, как вы дадите слотам работу.

Два следствия, которые стоит знать до того, как вы начнёте что-то переставлять:

• Если вы освободите слот и отдадите его другой точке, накопительные итоги слота продолжатся с того места, где остановились, — поэтому статистика Home Assistant может показать ступеньку в момент переназначения. Чище всего это видно на отдельной серии каждой точки, которую импортирует интеграция.
• Одна валюта во всём. В какой бы валюте ни был ваш тариф, в такой же валюте будут все денежные сущности.

Сущности энергии попадают прямо на Energy dashboard: они накопительного типа, которого он ждёт, поэтому никакой шаблонный датчик или utility_meter между ними не нужен.

Четыре сбоя в одном месте

Чего это не делает

• Оно не делает хаб зависимым от Home Assistant. Это один из двух способов запустить то же ядро учёта; другой — собственное приложение хаба. Переключиться между ними потом означает перепрошивку и начало истории с нуля, поэтому выбирайте осознанно.
• Оно ничего не включает и не выключает. Хаб измеряет и считает стоимость; решают автоматизации.
• Оно не даёт Home Assistant 15-минутную детализацию. Периоды — это периоды хаба; в статистику Home Assistant попадают почасовые значения.

Где читать дальше

• Запуск внутри Home Assistant: справочник по этому пути, включая то, что делает панель.
• Два способа запустить RBgrid и как выбрать: если вы ещё не уверены, что это ваш путь.
• Quick start: первое включение, точка доступа и её пароль.
• Рыночные цены: суточные цены работают и на этом пути.