Не додається Matter-пристрій у Home Assistant: покрокова перевірка

Спершу перевірте піктограми Matter на коробці або в інструкції: пристрій може працювати через Wi‑Fi, Ethernet або Thread. Matter — це протокол керування, а не окрема радіомережа. Для Thread потрібен Thread border router, який з’єднує Thread mesh із домашньою IP-мережею; для Wi‑Fi-пристрою потрібне стабільне підключення до бездротової локальної мережі.

Якщо в Home Assistant налаштовано Thread, відкрийте Settings → Devices & services → Thread та перевірте, що вибрано потрібну Thread-мережу і її border router доступний через домашню LAN. Для обміну Thread-обліковими даними чи роботи стороннього border router телефон під час налаштування має бути під’єднаний до тієї самої домашньої Wi‑Fi мережі, що й Home Assistant. Саме наявність логотипа Matter не означає, що Thread-радіо вже є в сервері.

Додавання нового Matter-пристрою запускайте у Home Assistant Companion на телефоні або планшеті. Майстер у браузерному інтерфейсі не може завершити commissioning нового пристрою. Оновіть Companion, дозвольте йому доступ, потрібний для локальної мережі та Bluetooth під час налаштування, і тримайте телефон у тій самій домашній Wi‑Fi мережі.

Підготуйте пристрій за інструкцією виробника та відскануйте QR-код Matter. Якщо код не читається, введіть commissioning code вручну. Тримайте телефон поруч із пристроєм під час первинного підключення, а для Thread перевірте, що border router увімкнений і має доступ до мережі. Якщо пристрій уже налаштований в іншій екосистемі, шукайте опцію Matter sharing або multi-admin у тому застосунку, а не починайте з фабричного скидання.

Matter спілкується через IPv6 у локальній мережі, а пошук пристроїв значною мірою покладається на mDNS multicast. Якщо телефон, Home Assistant, Wi‑Fi Matter-пристрій або Thread border router рознесені по VLAN, гостьовій мережі чи ізольованих точках доступу, пакети виявлення можуть не проходити. Для діагностики тимчасово під’єднайте потрібні пристрої до однієї простої домашньої мережі без клієнтської ізоляції.

Перевірте в роутері підтримку IPv6 у локальній мережі й вимкніть для тесту функції, що блокують або надмірно оптимізують multicast. Якщо після цього сполучення працює, поверніть поділ мережі поступово та налаштуйте коректний multicast forwarding між потрібними сегментами. Не відкривайте Matter-порти в інтернет: під час commissioning пристрої мають бути досяжні локально.

Matter дозволяє контролерам ділити пристрій між різними fabric через multi-admin. Якщо датчик чи лампа вже працює в Apple Home або Google Home, відкрийте налаштування цього пристрою там і згенеруйте код для додавання ще одного контролера. У Home Assistant виберіть додавання наявного Matter-пристрою та введіть новий код. Після успішного поширення обидві системи зможуть керувати ним.

Якщо додавання проходить, але пристрій потім стає недоступним, перевірте живлення, рівень сигналу Wi‑Fi або Thread і доступність border router. У Home Assistant відкрийте Matter network map, якщо вона вже має дані про топологію; карта може підказати слабкий зв’язок або offline вузол. Для точнішої діагностики завантажте device diagnostics у сторінці інтеграції Matter. Збирайте їх перед зміною мережі або скиданням пристрою — так простіше зрозуміти, який крок усунув проблему.