Локальная интеграция реле Shelly в Home Assistant по CoAP для Алисы

Интеграция умных реле Shelly в систему домашней автоматизации Home Assistant открывает широкие возможности для локального управления освещением и электроприборами. В отличие от многих китайских аналогов, устройства Shelly изначально разрабатывались с акцентом на локальную работу без обязательной привязки к китайским или европейским облачным серверам. Однако стандартное подключение через HTTP-запросы или облачный сервис Shelly Cloud имеет ряд ограничений: задержки выполнения команд могут достигать 1-2 секунд, а стабильность работы напрямую зависит от качества интернет-соединения.

Для обеспечения мгновенного отклика и высокой надежности используется специализированный протокол CoAP (Constrained Application Protocol), оптимизированный для работы в сетях с низкой пропускной способностью и ограниченными ресурсами оконечных устройств. В этой статье мы подробно разберем, как перевести реле Shelly на локальное вещание по CoAP, настроить мультикаст-маршрутизацию на роутере и пробросить готовые сущности в Умный Дом Яндекса для мгновенного голосового управления через Алису.

Физический смысл и архитектура CoAP в умном доме

Протокол CoAP представляет собой легковесную альтернативу HTTP, работающую поверх UDP. Вместо постоянного удержания TCP-соединения или периодического опроса (polling), устройства обмениваются короткими пакетами данных. В стандартной конфигурации Shelly использует расширение CoIoT (CoAP для интернета вещей), которое транслирует состояние приборов с помощью мультикаст-пакетов (IP-адрес 224.0.1.187, порт 5683).

Когда вы нажимаете физический выключатель, реле мгновенно отправляет в локальную сеть UDP-пакет со своим новым статусом. Сервер Home Assistant, прослушивающий мультикаст-трафик, фиксирует это изменение в течение 10-20 мс. Это позволяет создавать сложные локальные сценарии, которые срабатывают практически без ощутимой задержки.

Шаг 1. Подготовка сети и настройка роутера

Перед началом настройки Shelly необходимо убедиться, что ваша локальная сеть готова к передаче мультикаст-трафика:

1. Войдите в панель администратора вашего Wi-Fi роутера.
2. Перейдите в раздел настроек локальной сети (обычно это вкладка LAN или IPTV).
3. Найдите параметр IGMP Snooping и переведите его в состояние “Включено” (Enabled). Если роутер поддерживает выбор версии, установите IGMP v2 или IGMP v3.
4. Убедитесь, что функция блокировки мультикаста (Multicast Storm Control или Wireless Multicast Forwarding) отключена, так как она может принять легитимный CoAP-трафик за сетевую атаку и заблокировать его.
5. Назначьте вашему серверу Home Assistant статический IP-адрес (например, 192.168.1.15).

Шаг 2. Конфигурация CoIoT в веб-интерфейсе Shelly

Для перевода реле в локальный режим необходимо выполнить настройку его встроенной прошивки:

1. Подключитесь к веб-интерфейсу реле Shelly, введя его локальный IP-адрес в строке браузера. Если прибор новый, сначала подключитесь к его собственной Wi-Fi точке доступа и выполните первичную привязку к домашней сети.
2. В боковом меню перейдите в раздел Internet & Security -> Advanced - Developer Settings.
3. Установите галочку напротив пункта Enable CoIoT.
4. В поле CoIoT peer введите IP-адрес вашего сервера Home Assistant и порт 5683. Например, вместо значения mcast укажите 192.168.1.15:5683. Это переведет вещание из режима общего мультикаста в режим направленного уникаста (unicast), что гарантирует доставку пакетов даже при проблемах с IGMP на роутере.
5. Нажмите кнопку Save для сохранения конфигурации.
6. Перейдите в раздел Device Information и перезагрузите устройство, чтобы новые параметры CoAP вступили в силу.

Шаг 3. Интеграция Shelly в Home Assistant

Благодаря поддержке протокола автоматического обнаружения (Zero-configuration networking), Home Assistant самостоятельно определит новое устройство в сети:

1. Откройте панель управления Home Assistant.
2. Перейдите в раздел Настройки -> Устройства и службы.
3. В верхней части экрана вы увидите карточку обнаруженного реле Shelly. Нажмите кнопку Настроить.
4. Если автообнаружение не сработало, нажмите Добавить интеграцию, выберите Shelly из списка и введите IP-адрес прибора вручную.
5. Укажите комнату размещения и подтвердите добавление. В системе появится новая сущность переключателя, например switch.shelly1_living_room.

Шаг 4. Вывод сущностей в Алису через Yandex Smart Home

Чтобы получить возможность управлять локальным реле голосом, пробросим его в Яндекс. Этот процесс концептуально похож на то, как настраивается локальная интеграция Tuya в Home Assistant.

1. Откройте ваш конфигурационный файл configuration.yaml.
2. Добавьте или отредактируйте блок интеграции yandex_smart_home:

yandex_smart_home:
  filter:
    include_entities:
      - switch.shelly1_living_room
  entity_config:
    switch.shelly1_living_room:
      name: "Свет в гостиной"
      room: "Гостиная"
      type: devices.types.light

3. Проверьте конфигурацию на ошибки через меню управления сервером и выполните быструю перезагрузку Home Assistant.
4. Откройте мобильное приложение «Дом с Алисой», перейдите в настройки и обновите список подключенных устройств умного дома. Теперь ваше реле готово принимать голосовые команды. Задержка при локальной обработке составляет менее 0.1 секунды.