CasaSmart guide
Локальное подключение через Zigbee2MQTT или ZHA.
CasaSmart
Zigbee — это маломощный радиопротокол с ячеистой (mesh) топологией, созданный для датчиков, ламп, розеток и реле, которым нужна надёжная связь при минимальном энергопотреблении. Вместо зависимости от облака производителя устройства Zigbee можно управлять локально через Home Assistant — открытый сервер автоматизации, работающий у вас дома на мини-ПК, NAS или Raspberry Pi. Выгода ощутима: команды выполняются быстро, работают даже без интернета, а данные не покидают дом. Чтобы «говорить» на Zigbee, Home Assistant нужен координатор — небольшой USB-радиомодуль, например из семейства SMLight или Sonoff, который создаёт и обслуживает собственную mesh-сеть.
Есть два программных пути использования этого координатора. ZHA (Zigbee Home Automation) — интеграция, встроенная прямо в Home Assistant: запускается за несколько минут и не требует дополнительных компонентов. Zigbee2MQTT — отдельный аддон, который переводит сообщения Zigbee в MQTT, поддерживает очень широкий список устройств и имеет собственный веб-интерфейс, но требует брокера MQTT, например Mosquitto. Ни один из них не «лучше» абсолютно; выбор зависит от ваших устройств и желаемой степени контроля. Главное — использовать только один путь на одном донгле, никогда оба одновременно, чтобы избежать конфликтов.
В этом руководстве мы шаг за шагом разберём добавление Zigbee-устройства в Home Assistant — одинаково для ZHA и Zigbee2MQTT. Подготовим координатор, запишем канал и PAN ID для надёжности, переведём устройство в режим сопряжения через сброс к заводским настройкам, откроем окно «permit join», подтвердим и переопросим сущности, затем переименуем устройство и назначим ему комнату. В конце займёмся роутерами, мощностью сигнала и обновлениями прошивки OTA. Процедура одинакова и для первого датчика, и для целого дома. Если вы предпочитаете, чтобы всё настроили и проверили профессионально, команда CasaSmart в Молдове устанавливает и обслуживает такие системы под ключ.
Коротко
Подключите Zigbee-координатор (SMLight или Sonoff) к Home Assistant, выберите ZHA или Zigbee2MQTT, запишите канал и PAN ID, сбросьте устройство к заводским настройкам, откройте «permit join», подтвердите сущности, переименуйте и назначьте комнату, затем постройте mesh из роутеров и обновите прошивку OTA.
Step 1
Координатор Zigbee — это радиомодуль, создающий сеть: USB-донгл вроде моделей семейства SMLight или Sonoff, подключённый к серверу Home Assistant. Если вы используете виртуальную машину или контейнер, убедитесь, что USB-устройство проброшено (passthrough) в Home Assistant, иначе оно не определится. Разместите координатор на USB-удлинителе, подальше от металлического корпуса, жёстких дисков и порта USB 3.0, который создаёт радиопомехи в диапазоне 2,4 ГГц. Проверьте в Settings → System → Hardware или в журнале аддона, что последовательный порт виден (например /dev/ttyUSB0 или /dev/serial/by-id). Решите сейчас, будете ли вы использовать интеграцию ZHA или аддон Zigbee2MQTT; не запускайте оба на одном донгле параллельно.
Step 2
Перед добавлением устройств откройте конфигурацию сети и запишите параметры: радиоканал (channel), идентификатор сети (PAN ID), расширенный PAN ID и сетевой ключ. В ZHA эти данные находятся в Settings → Devices & Services → ZHA → настройки; в Zigbee2MQTT — в файле configuration.yaml и в журнале запуска. Зачем это нужно: если вы когда-нибудь переустановите Home Assistant или перенесёте донгл, ввод тех же значений сохранит сеть без повторного сопряжения десятков устройств. Канал важен и для совместимости с Wi-Fi: Zigbee и Wi-Fi делят диапазон 2,4 ГГц, поэтому выберите канал Zigbee, не перекрывающийся с вашей сетью Wi-Fi. Сохраните эти значения в надёжном месте вне сервера.
Step 3
Каждое устройство Zigbee входит в режим сопряжения через сброс к заводским настройкам. Процедура различается: у многих ламп и розеток нужно удерживать кнопку пять-десять секунд до мигания, у датчиков Aqara — нажать маленькую кнопку сброса, у некоторых модулей MOES или Sonoff — использовать комбинацию нажатий. Всегда сверяйтесь с инструкцией вашей модели. Светодиод, мигающий редко или часто, подтверждает, что устройство ищет сеть. Держите устройство рядом с координатором при первом сопряжении, даже если потом оно будет стоять далеко. Если устройство ранее было привязано к другой сети или собственному хабу, его обязательно нужно сбросить заранее, иначе оно не появится. Готовьте устройство только после открытия окна сопряжения из следующих шагов.
Step 4
В ZHA перейдите в Settings → Devices & Services → ZHA и нажмите Add Device, либо со страницы координатора — «Add devices via this device». Это открывает окно permit join, обычно на шестьдесят секунд, в течение которых вы запускаете сброс устройства. ZHA в реальном времени покажет «интервью» устройства: производитель, модель и обнаруженные кластеры. Если вы хотите, чтобы слабое устройство подключилось через конкретный ретранслятор, запустите сопряжение прямо со страницы этого роутера, а не координатора. Оставьте страницу открытой, пока не появится карточка с созданными сущностями. Если окно истекло без результата, повторите сброс и снова откройте Add Device; перезапускать всю интеграцию не нужно. Устройство, появившееся лишь частично, требует переопроса, описанного ниже.
Step 5
В Zigbee2MQTT откройте веб-интерфейс (Zigbee2MQTT UI) и нажмите «Permit join», при желании выбрав конкретный роутер, через который пройдёт новое устройство. Затем запустите сброс устройства; журнал UI покажет «Interviewing», а потом «Successfully interviewed». В отличие от ZHA, Zigbee2MQTT использует файл базы данных (database.db) и слой MQTT, поэтому убедитесь, что брокер Mosquitto работает и интеграция MQTT в Home Assistant подключена, иначе сущности не появятся. Если модель распознана, вы сразу увидите датчики и переключатели, опубликованные через MQTT discovery. Отключите «Permit join» после завершения, чтобы сеть не оставалась открытой. Для неизвестных устройств Zigbee2MQTT может запросить внешнее описание (external converter), которое вы добавляете в конфигурацию.
Step 6
Иногда устройство сопрягается, но сущности отсутствуют или неполны, потому что первое интервью прервал слабый сигнал. Решение — переопрос (re-interview / reconfigure). В ZHA откройте страницу устройства, меню из трёх точек и выберите «Reconfigure device»; в Zigbee2MQTT нажмите «Reconfigure» на карточке устройства. Сначала разбудите устройства на батарейках нажатием кнопки, ведь они спят ради экономии энергии и не отвечают на запрос во сне. После переопроса проверьте, что появились все ожидаемые сущности: состояние, заряд, температура, действия кнопок. Если устройство остаётся «unavailable», поднесите его ближе к координатору или роутеру и повторите. Не удаляйте и не пересопрягайте сразу; переопрос решает большинство случаев без потери истории.
Step 7
Сразу после сопряжения у устройства техническое имя, например «lumi.sensor_motion» или код модели. Переименуйте его понятно — «Датчик движения прихожая» — и переименуйте сущности, чтобы автоматизации легко читались. В Home Assistant откройте страницу устройства, нажмите значок настроек и впишите имя; затем назначьте комнату (Area), например Кухня или Спальня. Зоны позволяют групповые команды и статистику по комнатам. Установите единое соглашение об именовании с самого начала: тип, расположение, функция. В Zigbee2MQTT можно задать «friendly name» в его интерфейсе, но помните, что его изменение меняет и MQTT-топик, поэтому поправьте автоматизации, которые его используют. Понятные имена избавят от путаницы, когда устройств станет десятки.
Step 8
Устройства с питанием от сети (лампы, розетки, модули вроде Shelly в Zigbee-версиях) работают как роутеры и расширяют mesh; датчики на батарейках — лишь конечные устройства и не ретранслируют. Сначала постройте «костяк» из роутеров, затем добавляйте датчики: так каждый найдёт ближайший ретранслятор. В ZHA и Zigbee2MQTT можно открыть карту сети (network map) и показатель LQI, чтобы выявить слабые узлы. Если устройство часто отваливается, передвиньте роутер ближе или добавьте промежуточный. Проверьте и обновления прошивки OTA: обе платформы предлагают их для совместимых устройств — это полезно для стабильности и новых функций. Не обновляйте всё сразу и не отключайте питание во время процесса. Сохраните итоговую карту, чтобы быстро диагностировать в будущем.
Самые частые ошибки: одновременный запуск ZHA и Zigbee2MQTT на одном донгле, сопряжение устройства без предварительного сброса к заводским настройкам, размещение координатора вплотную к серверу NAS или к порту USB 3.0, заглушающему сигнал, и добавление батарейных датчиков до построения сети роутеров. Многие забывают записать канал и PAN ID, теряя всю сеть при переустановке.
ZHA встроен в Home Assistant, прост в запуске и достаточен для большинства домов в Молдове. Zigbee2MQTT поддерживает больше устройств, даёт тонкий контроль и отдельный интерфейс, но добавляет брокер MQTT. Новичкам стоит начать с ZHA; если экзотическое устройство не распознаётся, Zigbee2MQTT — альтернатива. Команда CasaSmart настроит любой вариант по запросу.
Чаще всего устройство не сброшено к заводским настройкам или ещё привязано к другому хабу. Сбросьте его, поднесите ближе к координатору и снова откройте окно сопряжения. Проверьте, что включён «permit join». Батарейные устройства нужно разбудить нажатием. Если оно всё равно не появляется, сигнал может быть слишком слабым — добавьте промежуточный роутер.
Некоторые мультипротокольные донглы могут одновременно работать с Zigbee и Thread, но конфигурация более хрупкая, и мы не рекомендуем её для основной сети. Для надёжности используйте отдельный координатор Zigbee и отдельный пограничный маршрутизатор Thread для Matter. В Молдове, где важна локальная поддержка, простая раздельная архитектура легче в обслуживании.
Сеть Zigbee теоретически поддерживает сотни устройств, но практический предел зависит от координатора, числа роутеров и качества mesh. Для обычного дома в Молдове десятки устройств работают без проблем при достаточном числе роутеров с питанием. Надёжность определяет не число, а радиопокрытие и стабильная прошивка.
Если вы записали канал, PAN ID, расширенный PAN ID и сетевой ключ, введите их при настройке ZHA или Zigbee2MQTT — и сеть вернётся без пересопряжения устройств. В Zigbee2MQTT сохраните также файл database.db. Поэтому мы советуем регулярные резервные копии конфигурации Home Assistant; CasaSmart может настроить автоматический бэкап при установке.
● CasaSmart · Chișinău
CasaSmart настроит автоматизацию в Home Assistant и проверит её на реальных устройствах.