Безопасная диагностика занятого serial port в ZHA после обновления: видимость USB, стабильный путь by-id, доступ Home Assistant и возможный второй владелец — без удаления сети Zigbee.
Начните с аппаратной видимости
Официальная инструкция ZHA рекомендует путь из /dev/serial/by-id и указывает, что доступные пути видны в Settings → System → Hardware → All Hardware. Сначала откройте этот список и подтвердите наличие координатора, не вынимая его. Запишите только производителя, модель и факт появления стабильного by-id; серийный номер замаскируйте. Если устройство отсутствует на аппаратном уровне, сообщение ZHA не доказывает занятость другим приложением. В Home Assistant OS дополнительным read-only контролем служит ha hardware info, описанный в официальных common tasks. Не меняйте USB-порт до сохранения исходного состояния.
Сравните настроенный и обнаруженный пути
На странице конфигурации ZHA сопоставьте сохранённый serial device path с текущим by-id из All Hardware. Путь вида ttyUSB0 может меняться между подключениями, поэтому документация предпочитает by-id. Не редактируйте путь, если строки совпадают: это уже отсекает одну гипотезу. Если они различаются, сохраните оба в приватной заметке, скрыв серийную часть, и сначала проверьте, что новый путь действительно относится к тому же координатору. Ошибка доступа также возможна, когда Home Assistant не видит USB-устройство; сам текст про lock не устанавливает владельца порта.
Ищите второго владельца без остановки всей системы
Составьте список интеграций и приложений, которые настроены на тот же координатор, например другой Zigbee-стек, но не запускайте новые сервисы для проверки. Зафиксируйте время перезапуска Core и приложений и момент первой ошибки ZHA. Если второй сервис явно использует тот же by-id, остановка только этого добровольно установленного компонента может быть отдельным обратимым тестом; на управляемой системе следуйте её процедуре изменений. Не перезапускайте host, Supervisor и все приложения одновременно: такой опыт скрывает владельца. Не публикуйте полные process lists и конфигурации с сетевыми адресами.
Стоп-линия сохраняет Zigbee-сеть
Не удаляйте ZHA config entry, не формируйте новую сеть и не переводите устройства в pairing mode. Эти действия не нужны, чтобы проверить видимость и владение serial port, но могут создать отдельную миграцию. Пакет для issue: версия Core и установки, тип координатора, совпадает ли by-id, виден ли он в All Hardware, есть ли другой настроенный стек и короткая временная линия журналов. Из журналов удалите серийный номер, домашние пути и адреса. Если аппаратное устройство исчезает целиком, сначала исследуйте USB и питание; если оно стабильно видно, но порт занят, эскалируйте границу владельца.
Материал подготовлен редакцией VOne с применением ИИ для безопасного дерева USB и serial; пути, аппаратная инвентаризация и стоп-линия проверены по документации Home Assistant.
Источники и проверка
- Home Assistant — Zigbee Home Automation проверено 2026-08-10
- Home Assistant — common tasks for Home Assistant OS проверено 2026-08-10
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.