Какую задачу решает отдельный координатор
Он нужен, если вы хотите подключить устройства напрямую к своей Zigbee-сети Home Assistant. Это другой путь, чем получать состояния из готовой экосистемы через интеграцию.
Перед покупкой выпишите три вещи: какие устройства и функции нужны, где можно разместить радио, как восстановить систему при отказе. Например, кнопка с несколькими типами нажатия требует проверки этих событий, а не только отметки «Zigbee 3.0» на коробке.
USB или проводной Ethernet
| Условия | Подход | Что проверить |
|---|---|---|
| Сервер рядом с подходящей точкой для радио | USB с удлинителем | Расположение вдали от корпуса, USB 3.x и Wi-Fi-точки; доступ к адаптеру после перезапуска. |
| Сервер в стойке, радио нужно в другой комнате | Поддерживаемый Ethernet-координатор | Проводная LAN, постоянный адрес, порт, питание и восстановление TCP-соединения. |
| До выбранной точки есть только Wi-Fi | Пересмотреть размещение или провести кабель | Удобство беспроводного моста не устраняет задержки и потери связи с последовательным интерфейсом. |
| Home Assistant живёт в виртуальной машине | USB с пробросом или Ethernet | Для USB — доступ гостя к устройству; для Ethernet — доступ гостя к нужному адресу и порту. |
У сетевого координатора по LAN передаётся доступ к радио, а датчики связываются с ним по Zigbee. Ethernet сам по себе не переносит mesh через кабель в другой дом. Ограничение объяснено в FAQ Zigbee2MQTT.
Для удалённого подключения Zigbee2MQTT рекомендует проводной Ethernet вместо Wi-Fi: последовательный протокол плохо переносит потери пакетов и задержки. Поддержка сетевого режима зависит от конкретного адаптера — смотрите замечания к адаптерам. PoE добавляет удобный способ питания, но в проверку после сбоя включайте и коммутатор.
Сначала совместимость, затем ZHA или Zigbee2MQTT
ZHA
Интеграция внутри Home Assistant. Сопоставьте свои устройства и нужные функции с возможностями ZHA. Поддержка нестандартного устройства может требовать специального обработчика; само сопряжение ещё не гарантирует все функции.
Zigbee2MQTT
Отдельный сервис, которому нужен MQTT-брокер. Проверьте страницу каждой модели и список доступных свойств. В план сопровождения добавьте запуск сервиса, соединение с брокером и доставку состояния в HA.
Радио отдаётся одному приложению: ZHA и Zigbee2MQTT не должны одновременно открывать один адаптер. Датчик также состоит в одной Zigbee-сети. В обычном переносе из другой сети потребуются сброс по инструкции устройства и новое сопряжение; сначала сохраните связь сущностей со сценариями. Ограничения — в ZHA и Zigbee2MQTT.
| Семейство | ZHA: radio type | Zigbee2MQTT: adapter |
|---|---|---|
| Texas Instruments, Z-Stack | znp | zstack |
| Silicon Labs, EmberZNet | ezsp | ember |
| dresden elektronik, ConBee / RaspBee | deCONZ | deconz |
Таблица помогает читать инструкции, но не подтверждает поддержку любой платы с таким чипом. Сверяйте полное название, аппаратную ревизию и прошивку в списке ZHA и списке Zigbee2MQTT. У последнего ZiGate отмечен как неподдерживаемый сопровождением, ZBOSS — как экспериментальный.
Для Silicon Labs в актуальном Zigbee2MQTT используется ember; прежний ezsp объявлен устаревшим. Мультипротокольная прошивка там не поддерживается — под отдельный протокол выбирайте отдельное радио. Требования перечислены на странице EmberZNet. Не переносите это название настройки в ZHA автоматически.
USB в Proxmox: две разные проверки
В нашей схеме N100 и Proxmox HA работает в гостевой системе. Для будущего USB-радио сначала нужен проброс устройства в нужную VM, затем выбор порта уже внутри Home Assistant. Путь, видимый только на хосте, не доказывает доступ из гостя.
- Сопоставьте физический адаптер с пробросом. Proxmox позволяет выбрать USB по vendor/product ID или по порту хоста. У двух одинаковых адаптеров ID могут совпадать, поэтому проверяйте, какой экземпляр получил гость. Это описано в официальной документации USB passthrough.
- Выберите постоянный путь в HA. Если доступен
/dev/serial/by-id/…, используйте его вместо меняющегося/dev/ttyUSB0. Найдите фактический путь, а не копируйте чужой идентификатор. Указания — ZHA и Zigbee2MQTT. - Проверьте обычный перезапуск. Сначала убедитесь, что гость снова видит тот же адаптер и приложение открывает его без конфликта. Затем проверьте сообщение от тестового устройства.
Для Ethernet проброс USB не нужен. Вместо него фиксируйте адрес координатора, проверяйте доступ гостя к порту и требуемый режим работы адаптера. Форматы socket:// в ZHA и tcp:// в Zigbee2MQTT относятся к разным настройкам; копируйте вариант из инструкции выбранной комбинации.
Прошивка и резервная копия — до массового переноса
Прошивка должна соответствовать точной модели, её ревизии и роли координатора. Файл для другого устройства на похожем чипе или прошивка роутера не заменяют подходящую coordinator firmware. Ссылки для своего железа ищите на страницах Z-Stack, EmberZNet или deCONZ.
Резервная копия VM и backup Zigbee-сети решают разные задачи. До замены выясните, что сохраняется в радио, что — в файлах приложения, и поддерживает ли выбранная пара восстановление. В Zigbee2MQTT backup координатора доступен для zstack и ember; перенос между ними без перепривязки официально не гарантирован. Подробности — FAQ миграции.
ZHA описывает миграцию между Silicon Labs, Texas Instruments и ConBee/RaspBee при backup, сделанном внутри ZHA, с условиями для прошивки. Это не обещание перенести любую сеть из Яндекса или другого приложения. Используйте свой поддерживаемый путь ZHA и оставьте время на возвращение устройств в сеть.
