В Home Assistant пропала сущность (entity) лампы или другого устройства Zigbee, подключенного через Zigbee2MQTT: после удаления устройства и повторного сопряжения она не возвращается, хотя в самом Zigbee2MQTT устройство видно и работает. Пользователям форума помогало удалить устройство из Zigbee2MQTT и спарить его заново либо переименовать устройство с обновлением entity ID в Home Assistant, но не во всех ветках. Если это не сработало, в одной ветке форума вернула сущность чистая установка свежего HAOS с восстановлением резервной копии конфигурации.
Как выглядит проблема
Устройство работает в Zigbee2MQTT, но в Home Assistant его сущности нет: либо она была удалена и не создается заново, либо устройство вообще не появляется в списке.
Варианты симптома из веток форума:
- Сущность on/off состояния лампы Zigbee удалена и не возвращается после повторного добавления устройства.
- Удаленное Zigbee-устройство не появляется в Home Assistant после повторного discovery (автоматического обнаружения), при этом в Zigbee2MQTT оно по-прежнему видно.
- Две новые лампы IKEA работают в Zigbee2MQTT, но не отображаются ни в интеграции MQTT, ни как устройства в Home Assistant.
В ветках речь шла об устройствах Gledopto и IKEA, в том числе о розетке IKEA с измерением мощности. Отдельного текста ошибки у проблемы нет: устройство просто отсутствует в списке. Если не появляются именно новые устройства, а не удаленные, посмотрите разбор случая, когда устройства Zigbee2MQTT не видны в Home Assistant.
Причины
В одной ветке уверенно названа причина: старые имена сущностей от прежнего сопряжения устройства сохранились в реестре устройств Home Assistant. Второе объяснение - предположение участников другой ветки. Документацией ни одно из них не подтверждено.
| Причина | Как проверить | Что сделать |
|---|---|---|
| Старые имена сущностей от прежнего сопряжения хранятся в реестре устройств Home Assistant | Найти устройство по его идентификатору (device ID) в реестре устройств и посмотреть, какие имена сущностей за ним закреплены | Переименовать старые сущности, чтобы пересоздать entity ID (recreate your entity IDs); в одной ветке это дало лишь частичный результат |
| Предположение: Home Assistant не добавляет сущность повторно, когда устройство удалили и добавили снова | В ветке отдельной проверки не названо: устройство видно в Zigbee2MQTT, а сущности в Home Assistant нет | В ветке с этим объяснением вернула сущность чистая установка свежего HAOS с восстановлением резервной копии |
Решения
Повторное сопряжение и переименование устройства помогали пользователям, но не всем. Все решения ниже - опыт пользователей форума, документацией они не подтверждены.
Повторное сопряжение устройства
Удалите устройство из Zigbee2MQTT, при необходимости принудительно (force remove), при необходимости перезапустите и спарьте устройство заново. Помогло в 1 ветке форума из 3, где это пробовали; в двух других сущность так и не вернулась. Подробнее о Zigbee2MQTT - в гайде по установке и настройке.
Переименование устройства в Zigbee2MQTT
Переименуйте устройство в Zigbee2MQTT и отметьте галочку Update the Home Assistant entity ID. Помогло в 1 ветке из 2, где пробовали; в другой ветке не сработало.
Чистая установка HAOS
Установите свежий HAOS (Home Assistant Operating System) с нуля и восстановите конфигурацию из резервной копии. В одной ветке форума это вернуло пропавшую сущность. Это самый радикальный путь из описанных.
Если не помогло
Пользователи пробовали и другие пути, но в ветках форума они сущность не вернули:
- включить скрытую сущность через
+1 entity not shownв карточке устройства; - удалить устройство из
deleted_devicesв файле.storage/core.device_registryи перезапустить Home Assistant; - удалить и заново добавить интеграцию MQTT;
- отключить и снова включить галочку Home Assistant MQTT, затем перезапустить систему;
- включить устройство в Home Assistant, если оно показано как отключенное (disabled).
Есть и неподтвержденный вариант: найти в реестре устройств Home Assistant старые имена сущностей по идентификатору устройства и переименовать их с пересозданием entity ID (recreate your entity IDs). В одной ветке это дало лишь частичный результат, подтверждений нет.
Частые вопросы
Почему устройство видно в Zigbee2MQTT, но не появляется в Home Assistant?
Судя по веткам форума, Home Assistant не всегда создает сущность повторно после повторного обнаружения устройства (discovery). Причину связывают со старыми именами сущностей, которые остались в реестре устройств от прежнего сопряжения. Переименование устройства в Zigbee2MQTT с галочкой Update the Home Assistant entity ID помогло в 1 ветке из 2, удаление устройства из Zigbee2MQTT с новым сопряжением - в 1 ветке из 3.
Нужно ли удалять интеграцию MQTT?
В ветках это не помогло. В одной ветке форума удаление и повторное добавление интеграции MQTT не вернуло устройство, как и отключение с последующим включением галочки Home Assistant MQTT с перезапуском системы. Сущность возвращали другими путями: переименованием устройства в Zigbee2MQTT с обновлением entity ID или удалением устройства из Zigbee2MQTT с новым сопряжением, но и они помогали не везде.
Что делать, если устройство показано как отключенное?
Включить устройство можно, но в одной ветке форума включение отключенного (disabled) устройства не вернуло пропавшую сущность. После включения проверьте список сущностей устройства. Если сущности по-прежнему нет, можно удалить устройство из Zigbee2MQTT и спарить его заново: этот путь помог в 1 ветке из 3, где его пробовали.
Безопасно ли править .storage вручную?
Оценки безопасности такой правки в ветках нет. В одной ветке форума удаление устройства из deleted_devices в файле .storage/core.device_registry с перезапуском Home Assistant не вернуло сущность. Сначала попробуйте переименовать устройство в Zigbee2MQTT с галочкой Update the Home Assistant entity ID: этот способ помог в одной ветке и не сработал в другой.
Поможет ли чистая установка HAOS?
В одной ветке форума помогла: пользователь сделал чистую установку свежего HAOS и восстановил конфигурацию из резервной копии, после чего сущность вернулась. Это единственный отчет об успехе у этого способа. Повторное сопряжение и переименование устройства проще, но помогали не везде. Установка Home Assistant описана в гайде.
