Модуль 2. Подключение устройств · Урок 3 из 5
Урок 3. Интеграции, Zigbee, MQTT и типовые ошибки
Разбираем, через какой компонент данные попадают в платформу.
Чему вы научитесь
Понимать границы интеграции, протокола и самого устройства.
Интеграции платформы
Home Assistant поддерживает множество интеграций, которые могут обнаруживаться автоматически или настраиваться вручную. Точный способ зависит от протокола и реализации. Появление интеграции в списке не гарантирует поддержку всех возможностей любой модели устройства.
Перед сопряжением посмотрите официальную документацию именно выбранной интеграции и модели. Проверяйте, остаётся ли доступным ручное управление и как восстановить систему после потери связи.
ZHA и Zigbee2MQTT
ZHA и Zigbee2MQTT — разные способы работы с Zigbee-устройствами. Для них требуется совместимый радиокоординатор и выбранная архитектура. Zigbee2MQTT дополнительно использует MQTT-брокер; ZHA работает через соответствующую интеграцию Home Assistant.
Не подключайте одновременно несколько управляющих программ к одному радиоадаптеру без специально поддерживаемой архитектуры. Перед миграцией создайте резервную копию и прочитайте требования для конкретного стека, иначе возможно повторное сопряжение устройств.
Диагностика по слоям
Если показания не появляются, проверьте сам прибор, связь с адаптером, интеграцию, состояние сущности и автоматизацию. Для MQTT добавляется отдельная проверка брокера и публикации сообщений. Журналы полезнее бесконечных перезагрузок.
Не храните пароли MQTT и токены удалённого доступа в открытых учебных примерах.
Практическая работа
Нарисуйте два маршрута: «датчик Zigbee → ZHA → сущность» и «датчик Zigbee → Zigbee2MQTT → MQTT-брокер → Home Assistant».
Для каждого звена укажите один возможный сбой и безопасный способ его обнаружить.
Самопроверка: сформулируйте результат своими словами, а затем пройдите вопросы ниже. Если устройство или программа не доступны, выполните задание на бумаге или в учебном тренажёре.
Практика на основе инженерных ситуаций
Home Assistant: цепочка интеграции и доказательство результата
Доступность сущности, доставка события и физическое выполнение команды — разные факты.
Учебная модель: реальные сети и оборудование не подключаются. Правильный ответ показывает логику проверки, а не удостоверяет совместимость или безопасность конкретного объекта.
Выберите сценарий: на схеме выделится участок для проверки.
Сущность есть, но её значение не обновляется
Исходные наблюдения: Интеграция загрузилась, однако время последнего обновления и доступность устройства не подтверждены.
Обоснование
Созданная сущность может существовать при устаревших данных или потере связи.
Ограничение: Для автоматизаций важна подтверждённая давность и доступность значения.
MQTT-сообщения приходят, сущность не создаётся
Исходные наблюдения: Брокер принимает публикации, но в Home Assistant не появляется ожидаемая сущность discovery.
Обоснование
Доставка MQTT и обработка HA Discovery имеют разные этапы и условия.
Ограничение: Нельзя объявлять устройство совместимым только по наличию произвольного MQTT-topic.
HA вызвал действие, но реальное реле не подтвердилось
Исходные наблюдения: Автоматизация зарегистрировала service call, а исполнитель находится в статусе unavailable.
Обоснование
Журнал действия в HA ещё не доказывает физического срабатывания реле.
Ограничение: Подключённые сети 230 В обследует специалист, не ученик.
Все три решения и контрольные вопросы урока необходимы для нового завершения. Если урок уже был пройден ранее, сохранённая отметка не удаляется.
Проверьте себя
Контрольные вопросы
Ответьте на все вопросы. При ошибке изучите пояснение и попробуйте ещё раз. Все задания бесплатны.
Zigbee2MQTT публикует сообщения через MQTT.
Нужно проверять точную поддержку модели и функции.
Правильных ответов: 0 из 2
Урок завершён?
Повторите ключевые идеи и убедитесь, что выполнили практическое задание.
Чтобы закончить урок, правильно ответьте на контрольный вопрос.