Что проверять, когда после перезапуска в Home Assistant появляются дубли устройств OpenRGB: инвентаризация идентификаторов, затронутых автоматизаций и безопасный план очистки.
Заморозьте автоматические изменения
Перед диагностикой временно отключите автоматизации, которые управляют затронутыми световыми устройствами, но не удаляйте их. Сделайте резервную копию Home Assistant штатным способом и снимки страниц устройств и сущностей. Официальное правило качества интеграций подчёркивает, что уникальный идентификатор должен оставаться стабильным и не зависеть от изменяемых свойств. Однако по одному обращению нельзя утверждать, что именно это нарушено в каждой установке.
Составьте физическую инвентаризацию
Для каждого реального RGB-устройства запишите нейтральное описание, производителя и модель, текущее имя в OpenRGB и количество соответствующих записей в Home Assistant. Не публикуйте серийные номера. Затем разделите записи на доступные и недоступные и отметьте их entity_id и device_id локально. Официальная интеграция OpenRGB создаёт сущности на основе обнаруженных устройств, поэтому важна связь с одним физическим экземпляром, а не сходство отображаемых названий.
Постройте карту зависимостей
Проверьте, какие группы, сцены, панели и автоматизации ссылаются на каждую старую и новую сущность. Дубликат может выглядеть безобидно в интерфейсе, но удаление старой записи способно оставить группу без участника. Составьте таблицу из четырёх столбцов: физическое устройство, доступная сущность, недоступная сущность, потребители. Пока хотя бы один потребитель не перенесён или не проверен, очистку реестра следует считать небезопасной.
Проведите один стабильный перезапуск
Не переставляя USB-устройства и не обновляя ядро, штатно перезапустите только хост и сравните состав после полного запуска OpenRGB и Home Assistant. Зафиксируйте, какие записи остались доступными и появились ли новые. Не повторяйте цикл много раз: каждый запуск способен добавить контекст, который усложнит картину. Если набор меняется при неизменном физическом составе, приложите сравнение идентификаторов, но не публикуйте полный реестр с адресами и токенами.
Очистка только после доказательства
Удалять недоступную запись можно лишь после резервной копии, проверки всех зависимостей и подтверждения, что актуальная сущность стабильно управляет тем же физическим устройством. Если после перезапуска возникает ещё одна запись или меняются связи, остановитесь и отправьте разработчикам версии Home Assistant, OpenRGB, Linux и обезличенное сравнение метаданных. Не редактируйте хранилище реестра вручную и не меняйте системные пути: это выходит за рамки обратимой пользовательской диагностики.
Материал подготовлен редакцией VOne с применением ИИ для карты зависимостей; требования к идентификаторам проверены по официальным источникам, а публичный issue отделён от доказательной базы.
Источники и проверка
- Home Assistant: OpenRGB integration проверено 2026-08-13
- Home Assistant: unique ID rule проверено 2026-08-13
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.