Представление сущностей Home Assistant как устройств Matter

О проекте Matter Bridge

Это руководство основано на Matter Bridge , проекте, который позволяет вам делиться всеми вашими устройствами Matter с другими контроллерами Matter без повторного сопряжения и совместного использования их. Matter Bridge основан на matter.js , реализации TypeScript/JavaScript полного протокола Matter.

Вы можете настроить и развернуть Matter Bridge как LXC, docker-контейнер или просто установить его в Windows. Его функциональность может быть расширена путем установки одного из поддерживаемых плагинов . Он поставляется с веб-интерфейсом, который очень прост в использовании и навигации, позволяя вам изменять настройки и проверять состояние Matter Bridge.

В этом руководстве я развертываю надстройку Matter Bridge непосредственно в Home Assistant, разработанную для того, чтобы без усилий выставлять сущности как устройства Matter. Это, безусловно, самый простой способ добиться этого, но он требует установленной и работающей ОС Home Assistant.
Респект тем замечательным людям, которые сделали это возможным. Liligu | t0bst4r

Для кого это?

С тех пор, как я установил Matter Bridge, я думал о вариантах использования этого дополнения. Хотя это в первую очередь экспериментальный инструмент, он приносит некоторые практические преимущества и позволяет использовать определенные варианты использования. Лучше всего это объяснить на примерах.

Допустим, у вас есть устройство Zigbee, которое не получит поддержку Matter. Оно работает с Home Assistant либо через ZHA, либо через Zigbee2MQTT, но его нельзя совместно использовать между контроллерами Matter. Даже использование фирменного хаба не позволит вам совместно использовать его как устройство Matter, поскольку компания решила не включать вашу конкретную модель в поддерживаемые Matter устройства.

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

В качестве другого примера предположим, что у вас есть устройство Zigbee, которое можно подключить к Matter, но для этого требуется использовать хаб компании. Устройство уже работает с Home Assistant через Z2M или ZHA, но вы хотите поделиться им через Matter с другими контроллерами. Таким образом, развертывание надстройки Matterbridge позволит сделать именно это и избежать необходимости использовать фирменный хаб бренда.

Но, пожалуй, самым интересным вариантом использования из всех является возможность преодоления разрыва с Matter для ваших DIY-устройств . Например, устройства ESPHome могут быть представлены как устройства Matter через дополнение и совместно использоваться такими контроллерами, как Яндекс Станция, Google Home, Apple HomeKit или Amazon Alexa.

Вероятно, есть и другие варианты использования, которые я сейчас упускаю из виду, но, надеюсь, я донес свою мысль: ваши устройства/сущности Home Assistant преобразуются в устройства Matter с помощью дополнения Matterbridge.

Установка надстройки Matter Bridge HA

Чтобы установить надстройку Matter Bridge , вам нужно сначала добавить пользовательский репозиторий в Home Assistant. Перейдите в Настройки > Дополнения > Магазин дополнений > Три точки в углу > Репозитории и добавьте следующий репозиторий:

https://github.com/t0bst4r/matterbridge-home-assistant-addon

Обновите страницу, и вы увидите, что внизу появится надстройка Matter Bridge. Установите ее и выберите вкладку Configuration . Здесь вы можете настроить, какие домены сущностей или BLOB-объекты вы хотите отображать как устройства Matter. Если поле оставить пустым, все будет включено по умолчанию.

Вернитесь на вкладку «Информация» и запустите дополнение, одновременно переключая дескрипторы «Запуск при загрузке» и «Watchdog» . Нажмите «Запуск». Я бы не советовал включать переключатель «Автоматическое обновление», так как это проект Beta и возможны ошибки. Как и во всем, что касается Home Assistant, всегда проверяйте журнал изменений, когда выходит новый релиз.

Доступ к веб-интерфейсу Matter Bridge

Доступ к дополнению можно получить с помощью кнопки Open Web UI в Home Assistant или введя IP-адрес Home Assistant с портом 8283 (например, 192.168.1.30:8283) в веб-браузере. Для бета-проекта Matterbridge имеет очень чистый и удобный интерфейс. Вы заметите, что плагин matterbridge-home-assistant уже установлен и работает, это делается автоматически при установке и настройке дополнения.

Если вы нажмете на три точки под карточкой «Добавить/удалить плагин» , вы увидите, что уже доступно несколько плагинов: zigbee2mqtt, shelly, somfy-tahoma, eve и некоторые другие. Их можно использовать для соединения с Matter для этого конкретного программного обеспечения, но поскольку это дополнение является форком, созданным для работы только с Home Assistant, вы не сможете установить ни один из них. И в этом нет необходимости, поскольку дополнение отображает все, что вы подключили к Home Assistant  как устройство Matter, включая Zigbee2MQTT.

Если вы хотите настроить Matterbridge только для Zigbee2MQTT, вы можете развернуть его как контейнер docker или LXC и просто установить требуемый плагин. Репозиторий Matterbridge Github отлично объясняет этот процесс.

Если вы нажмете на вкладку «Устройства» в верхнем левом углу, вы увидите список устройств, уже добавленных в качестве устройств Matter. Помните, что вы можете настроить, какие устройства/домены вы хотите включить в качестве устройств Matter, на вкладке «Конфигурация» дополнения.

Добавление Matter Bridge в Яндекс

С помощью QR-кода, который генерирует Matterbridge , вы можете подключить его к любой интеллектуальной экосистеме, как и стандартное устройство Matter. Это включает Умный дом Яндекс, Google Home, Apple HomeKit, Amazon Alexa и все остальное, что работает как контроллер Matter. Яндекс относительно недавно внедряет поддержку Маттер в свои устройства. Вот какие Я.Станции сейчас поддерживают данную технологию (на момент написания статьи — начало октября 2024 года):

5. Если в Вашей сети несколько устройств Яндекс поддерживают протокол Маттер, то Вам будет предложено выбрать устройство для привязки

6. Далее порядок подключения может отличаться для различных устройств. Следуйте инструкции на экране

Добавление устройств Matter в Яндекс — 4

Добавление Matter Bridge в Google Home

Теперь посмотрим, как выглядит подключение с приложением Google Home:

Процесс сопряжения остается таким же, как и с любым другим устройством Matter. Во время настройки подключения вы получите предупреждение о несертифицированном устройстве , с которым вам нужно согласиться (Шаг 4). После сопряжения Google Home отобразит каждую сущность, которую вы выбрали для отображения в качестве устройства Matter, включая автоматизацию, которая отображается в виде индикаторов.

Ограничения и ошибки

Поскольку все это все еще экспериментально, вы можете столкнуться с некоторыми ошибками и ограничениями Matter Bridge. Вот несколько вещей, с которыми я столкнулся лично, и некоторые, о которых я узнал от других пользователей на форумах сообщества:

• Alexa не подключается, если у вас более 100 устройств (в отличие от Яндекс, Apple и Google).
• Не все типы устройств и сущностей поддерживаются (ограничение Matter)
• Возможно, некоторые устройства будут отображаться как неправильный тип устройства в сторонних контроллерах Matter.
• Если у вас возникли проблемы во время первоначального сопряжения, первый сгенерированный Matter Bridge QR-код больше не будет работать. Вы можете перейти в «Настройки» и нажать «Сбросить код Matterbridge», чтобы сгенерировать новый.
• Поддерживаемые типы сущностей
  • Автоматизация ( automation.) сопоставлена ​​с переключателями и в настоящее время поддерживает только управление включением-выключением.
  • Двоичные сущности датчиков ( binary_sensor.) предоставляют свое состояние (например, включено / выключено)
  • Устройства Cover Devices ( cover.) в настоящее время все сопоставлены с «Window Covering»
  • Устройства-вентиляторы ( fan.) в настоящее время сопоставлены с подключаемыми модулями с регулировкой яркости, поскольку большинство контроллеров Matter не поддерживают вентиляторы.
  • Ввод-Булевы сущности ( input_boolean.), включая управление включением-выключением
  • Световые объекты ( light.), включая включение-выключение, яркость, оттенок и контроль насыщенности
  • Устройства блокировки ( lock.), включая блокировку и разблокировку. Некоторые контроллеры Matter (например, Alexa) не позволяют разблокировать замки по умолчанию. Эту функцию необходимо включить в приложении Alexa для каждого замка.
  • Медиаплееры ( media_player.) привязаны к коммутаторам и в настоящее время поддерживают только управление включением-выключением.
  • Сцены ( scene.) сопоставлены с переключателями и в настоящее время поддерживают только управление включением-выключением.
  • Скрипты ( script.) сопоставлены с переключателями и в настоящее время поддерживают только управление включением-выключением.
  • Переключатели ( switch.), включая управление включением-выключением