Перейти к содержанию

Главная / Статьи

Zigbee по шагам

Координатор под ваш дом

Выберите место для радио, способ подключения и путь восстановления. Затем проверьте конкретную модель — вместе с прошивкой и нужными вам устройствами.

USB и EthernetZHA и Zigbee2MQTTПлан восстановления

Перед тем как начать

Наш отдельный Zigbee-контур HA пока запланирован. Начнём выбор со способа подключения координатора и поддержки точной модели.

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

Список своих устройств и нужных функций, место для радио и сведения о том, где запущен HA.

Что получите

Составите требования к координатору: совместимость, USB или проводной Ethernet, размещение и восстановление.

Какой опыт нужен

Выбирать можно без покупки. Прошивка, подключение к виртуальной машине и перенос сети требуют инструкции точной модели и плана возврата.

Перейти к подробному разбору →
Четыре шага с проверкой результата
  1. Выпишите нужные функции →

    Например, от кнопки нужны определённые нажатия, от датчика — показания. Сверьте точную модель со страницей выбранного приложения.

    Проверка: Проверена нужная функция, а не только надпись Zigbee на коробке.

  2. Выберите место и соединение →

    USB подходит рядом с сервером; поддерживаемый Ethernet-адаптер позволяет вынести радио по проводной сети. Датчики по-прежнему связываются с ним по Zigbee.

    Проверка: Понятны место радио, питание и путь связи с сервером.

  3. Выберите одно приложение →

    ZHA работает внутри HA; Zigbee2MQTT — отдельный сервис с обменом через MQTT. Один адаптер не открывают обоими одновременно.

    Проверка: Точная модель и прошивка поддержаны выбранным приложением; доступ к адаптеру не занят вторым.

  4. Подготовьте маленькую проверку →

    До массового переноса выясните условия резервной копии и восстановления. Для USB в виртуальной машине отдельно проверьте доступ гостевой системы к радио.

    Проверка: На тестовой группе приходит нужное событие, после перезапуска связь возвращается, путь назад понятен.

Слова, которые понадобятся
Координатор
Радиоадаптер, который создаёт и обслуживает Zigbee-сеть. Подробнее →
ZHA
Интеграция Zigbee внутри Home Assistant; поддержка зависит от адаптера и устройств.
Zigbee2MQTT
Отдельная программа для Zigbee. Передаёт данные через MQTT, для которого нужен брокер.
Прошивка
Программа внутри адаптера. Она должна соответствовать точной модели и роли координатора.
Если не получилось

HA не видит радио. Разделите видимость на сервере и доступ внутри системы, где работает приложение; наличие USB на хосте не доказывает доступ гостя. Открыть проверку →

Датчик добавился, функции нет. Сверьте точную модель и нужные свойства. Успешное сопряжение само по себе не подтверждает всё управление. Открыть проверку →

Основа пояснений: ZHA · Адаптеры Zigbee2MQTT.

Какую задачу решает отдельный координатор

Он нужен, если вы хотите подключить устройства напрямую к своей Zigbee-сети Home Assistant. Это другой путь, чем получать состояния из готовой экосистемы через интеграцию.

Статус нашего дома. Два YNDX-00529 остаются в Zigbee-сети Станции Макс. Отдельный контур HA — план проверки. Этот разбор помогает выбрать архитектуру; он не сообщает о домашнем испытании нового координатора и не обещает устранить наблюдавшийся offline.

Перед покупкой выпишите три вещи: какие устройства и функции нужны, где можно разместить радио, как восстановить систему при отказе. Например, кнопка с несколькими типами нажатия требует проверки этих событий, а не только отметки «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 typeZigbee2MQTT: adapter
Texas Instruments, Z-Stackznpzstack
Silicon Labs, EmberZNetezspember
dresden elektronik, ConBee / RaspBeedeCONZdeconz

Таблица помогает читать инструкции, но не подтверждает поддержку любой платы с таким чипом. Сверяйте полное название, аппаратную ревизию и прошивку в списке ZHA и списке Zigbee2MQTT. У последнего ZiGate отмечен как неподдерживаемый сопровождением, ZBOSS — как экспериментальный.

Для Silicon Labs в актуальном Zigbee2MQTT используется ember; прежний ezsp объявлен устаревшим. Мультипротокольная прошивка там не поддерживается — под отдельный протокол выбирайте отдельное радио. Требования перечислены на странице EmberZNet. Не переносите это название настройки в ZHA автоматически.

USB в Proxmox: две разные проверки

В нашей схеме N100 и Proxmox HA работает в гостевой системе. Для будущего USB-радио сначала нужен проброс устройства в нужную VM, затем выбор порта уже внутри Home Assistant. Путь, видимый только на хосте, не доказывает доступ из гостя.

  1. Сопоставьте физический адаптер с пробросом. Proxmox позволяет выбрать USB по vendor/product ID или по порту хоста. У двух одинаковых адаптеров ID могут совпадать, поэтому проверяйте, какой экземпляр получил гость. Это описано в официальной документации USB passthrough.
  2. Выберите постоянный путь в HA. Если доступен /dev/serial/by-id/…, используйте его вместо меняющегося /dev/ttyUSB0. Найдите фактический путь, а не копируйте чужой идентификатор. Указания — ZHA и Zigbee2MQTT.
  3. Проверьте обычный перезапуск. Сначала убедитесь, что гость снова видит тот же адаптер и приложение открывает его без конфликта. Затем проверьте сообщение от тестового устройства.

Для 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 и оставьте время на возвращение устройств в сеть.

Критерий готовности к переносу. На небольшой тестовой группе приходят нужные события, после перезапуска восстанавливается связь, резервная копия сохранена отдельно и понятен путь назад. Список всех датчиков переносится после этой проверки.

Выбрали подход — проверьте сеть и сценарий

Разместить радио и роутеры →Разобрать конкретный симптом →Проверить полезный сценарий →Отделить доставку MQTT от действия HA →Наш план отдельного контура →