Matter

Matter-устройства ходят по Wi-Fi поверх обычного IP и не делят эфир с Zigbee-координатором. В Home Assistant они становятся обычными лампами, розетками и датчиками: встают на план, входят в группы и пресеты. Новое здесь только добавление.

Где это

	Где
Приложение	Настройки → Устройства → Matter-устройства → «Добавить Matter» или «+» в шапке плана → Matter
Веб	Страница «Дом» → блок «Matter» (только владельцу)

Что нужно дому

• Сервер Matter. В Home Assistant OS это дополнение «Matter Server». В обычном Docker дополнений нет — сервер поднимают отдельным контейнером (ghcr.io/home-assistant-libs/python-matter-server).
• Интеграция «Matter» в Home Assistant — она спросит адрес сервера.
• Ключ администратора HA. Сопряжение требует прав администратора. Без них экран скажет: «добавлять устройства этим токеном нельзя».
• Bluetooth у дома — только чтобы заводить устройство из коробки без телефона: свой BLE-адаптер у сервера Matter или ESPHome-прокси в той же комнате.

Три пути

Путь	Когда годится
Оно уже в сети	Мосты Matter (SwitchBot, Hue, Aqara), устройства, которыми поделилась другая экосистема. Дом ищет устройство по IP. Лампу из коробки так не завести
Искать по Bluetooth	Устройство из коробки, если у дома есть Bluetooth. Дом сам находит его по радио и передаёт ему Wi-Fi
Через телефон и Google	Любое устройство из коробки: Bluetooth даёт телефон в руках. Только в приложении и только на устройстве с сервисами Google. Владельцем всё равно станет Home Assistant, не Google

Код с устройства

Код сопряжения — с наклейки на устройстве или на коробке:

• 11 цифр (ручной код),
• 21 цифра,
• строка MT:… из QR-кода.

В приложении QR можно отсканировать камерой («Сканировать QR») или ввести код руками. Последняя цифра ручного кода — контрольная: опечатку приложение увидит до отправки.

Приложение разбирает код и подсказывает, какой путь сработает. У вещи из коробки в коде записан только Bluetooth — «Оно уже в сети» для неё обречено заранее.

Поиск по Bluetooth

1. Введите код.
2. Выберите сеть Wi-Fi, куда устройству переезжать, и пароль. В приложении сеть выбирается списком; у каждой подписан диапазон.
3. «Искать по Bluetooth» (в вебе — галка «Устройство ещё не в сети — пусть дом ищет его по Bluetooth», затем «Добавить»).

Пароль уходит в Matter-сервер вашего дома и больше никуда.

Только 2,4 ГГц

Устройства Matter по Wi-Fi работают лишь на 2,4 ГГц. Сеть только на 5 ГГц приложение пометит как негодную.

Если Home Assistant уже отвечал, что у Matter-сервера нет радиоадаптера, путь по Bluetooth для этого дома закрыт. Появился BLE-прокси — нажмите «Всё равно попробовать по Bluetooth».

Для списка сетей Android нужна включённая геолокация и доступ к местоположению. Без них имя сети можно вписать руками.

Довести по PIN и адресу

Только в вебе: «Довести сопряжение по PIN и адресу…» — PIN из 8 цифр и, по желанию, IP устройства.

Сопряжение идёт до трёх минут. При пути через Google поднесите телефон к устройству и не уходите из приложения, пока оно идёт.

После добавления

Устройство появляется в списке «Устройства Matter в доме» само, как только Home Assistant его опросит. Одна строка — одна физическая вещь, даже если сущностей у неё много.

Нажмите «разместить» и выберите комнату — дальше как в Как устройство попадает на план.

Поделиться

Отдать устройство ещё в одну экосистему, не забирая его у дома.

Только в вебе: у строки устройства «Поделиться». Дом откроет окно сопряжения и покажет ручной код и QR. Код живёт несколько минут — введите его в приложении другой экосистемы.

Убрать

В приложении — «убрать» у строки, в вебе — «✕». Устройство и все его сущности исчезнут из Home Assistant, дом отзовёт у него свои ключи. После этого оно снова принимает код сопряжения. Если устройство обесточено, это займёт до минуты.

Чего нет

• Thread — нужен бордер-роутер, в доме его нет.
• Matter на карте связи — у Matter нет аналога LQI-карты Zigbee.