Ошибки и коды · Инструкция
Matter QR-код не сканируется или устройство не добавляется
Matter QR-код не сканируется или устройство не добавляется чаще всего по причинам, которые легко разделить по этапу.
Короткий ответ
Если Matter QR-код не читается, введите цифровой setup code вручную. Если код распознан, но добавление срывается позже, проверяйте pairing mode, Bluetooth, Matter-хаб, Thread Border Router для Thread-устройства и IPv6 в домашней сети.
Почему Matter-устройство не добавляется после сканирования кода
Matter QR-код не сканируется или устройство не добавляется — это две разные ошибки. В первом случае приложение не может прочитать код, и тогда обычно можно ввести цифровой setup code вручную. Во втором QR-код уже распознан, но commissioning срывается из-за состояния самого устройства, Bluetooth, домашней сети, отсутствующего Matter-хаба или Thread Border Router. Google Home указывает, что для первичного добавления Matter используются Bluetooth Low Energy и локальная сеть, а для Matter-over-Thread нужен Thread Border Router. Поэтому начинать нужно не со случайного сброса роутера, а с определения, на каком этапе останавливается процесс.
Важно: Не публикуйте фото Matter QR-кода или setup code. Это данные для добавления устройства в экосистему, их лучше считать чувствительными.
На каком этапе ошибка и что это меняет
- Симптом | Вероятная зона проблемы | Первый шаг
- Камера не распознаёт QR | Сам код, фокус, освещение | Ввести setup code вручную
- Код принят, устройство не найдено | Pairing mode, Bluetooth, расстояние | Перезапустить режим сопряжения
- Устройство найдено, но сеть не добавляется | Wi‑Fi/Thread, IPv6, hub | Проверить инфраструктуру Matter
- Устройство уже есть в другой экосистеме | Multi-Admin или старое владение | Сгенерировать новый код совместного доступа или сбросить по инструкции
Что проверить по порядку
- Убедитесь, что устройство действительно Matter-сертифицировано, включено и находится в режиме сопряжения. У разных производителей режим длится ограниченное время, поэтому запускайте добавление сразу после его активации.
- Если камера не читает QR-код, протрите объектив телефона, увеличьте освещение, уберите блики и держите код полностью в кадре. В Google Home можно выбрать настройку без QR-кода и ввести setup key вручную.
- Включите Bluetooth на телефоне и держите телефон рядом с устройством. Первичное обнаружение Matter использует BLE, поэтому выключенный Bluetooth или слишком большое расстояние могут сорвать commissioning до подключения к домашней сети.
- Проверьте, что приложение умного дома обновлено, телефон подключён к нужной домашней сети, а у приложения есть необходимые разрешения локальной сети и Bluetooth.
- Для Matter-over-Wi‑Fi убедитесь, что сеть устройства поддерживается конкретной моделью. Для Matter-over-Thread проверьте наличие совместимого Thread Border Router, который уже добавлен в ту же экосистему.
- Если платформа требует Matter-хаб, убедитесь, что он онлайн. В Google Home Matter-хаб нужен для локального управления и удалённого доступа; для Thread-устройств этот хаб должен также выполнять функцию Thread Border Router либо в доме должен быть другой совместимый border router.
- Если процесс доходит до сети, но затем завершается ошибкой, проверьте IPv6 на домашнем роутере. Google прямо указывает IPv6 как требование для корректной работы Matter в своей экосистеме.
- Только после этих проверок выполняйте factory reset устройства по инструкции производителя и запускайте добавление заново. Сброс удалит предыдущую конфигурацию, поэтому не делайте его первым действием.
Совет: Если QR читается, но установка падает позже, камера телефона уже ни при чём. Ищите проблему в pairing mode, Bluetooth, хабе и сети.
Matter over Wi‑Fi и Matter over Thread: почему это важно
Логотип Matter сам по себе не говорит, каким радио устройство подключается к дому. Лампа, розетка или другой аксессуар может использовать Wi‑Fi, Ethernet либо Thread. Для Wi‑Fi-устройства Thread Border Router не требуется, но Matter-контроллер или хаб может быть нужен конкретной платформе. Для Thread-аксессуара border router необходим, чтобы Thread-сеть была связана с обычной IP-сетью дома. Если пользователь пытается добавить Thread-датчик в экосистему, где есть только Wi‑Fi Matter-хаб без Thread, настройка может начаться через Bluetooth, но завершить рабочее сетевое подключение будет некуда. Поэтому до сбросов найдите в спецификации товара строку Connectivity и уточните, используется ли Thread.
Предупреждение: Matter — прикладной стандарт совместимости, а Thread и Wi‑Fi — транспорт. Фраза «поддерживает Matter» не означает «работает по Wi‑Fi».
Если устройство уже добавлялось в другой дом или приложение
- Проверьте, осталось ли устройство в старой Matter-экосистеме.
- Если хотите управлять им из двух платформ, используйте Multi-Admin и код совместного доступа, а не исходный QR-код повторно вслепую.
- Если старый дом или аккаунт недоступен, выполните factory reset именно по инструкции производителя.
- После сброса дождитесь явной индикации нового pairing mode.
- Не используйте скриншот временного sharing code спустя долгое время: такие коды могут иметь ограниченное окно использования.
Что не стоит делать при первой же ошибке
Не меняйте одновременно SSID, пароль Wi‑Fi, настройки IPv6, телефон и приложение: после пяти изменений вы не поймёте, что именно помогло. Не отключайте защиту роутера без конкретной причины и не оставляйте её выключенной после теста. Не удаляйте хаб из умного дома, если остальные Matter-устройства работают: вероятнее проблема локальна для нового аксессуара. Не выполняйте десять factory reset подряд — некоторые устройства после сброса требуют время для загрузки и повторного входа в commissioning mode. Хорошая диагностика меняет один фактор за раз и фиксирует этап ошибки.
Когда проблема уже на стороне совместимости платформы
Matter развивает единый стандарт, но конкретные платформы могут добавлять поддержку категорий устройств в разное время. Google отдельно предупреждает, что сертифицированные платформы обновляются не синхронно и поддержка типов устройств различается. Поэтому ситуация «Matter-логотип есть, но приложение не даёт нужную функцию» не всегда означает неисправность аксессуара. Проверьте список поддерживаемых типов устройств и версию приложения платформы. Если тот же аксессуар успешно добавляется в приложение производителя, но системная платформа его отвергает, соберите модель, версию прошивки, тип подключения Wi‑Fi/Thread и точный текст ошибки — это намного полезнее для поддержки, чем сообщение «QR не работает».
Что учитывать
Matter QR-код не сканируется или устройство не добавляется — это две разные ошибки. В первом случае приложение не может прочитать код, и тогда обычно можно ввести цифровой setup code вручную. Во втором QR-код уже распознан, но commissioning срывается из-за состояния самого устройства, Bluetooth, домашней сети, отсутствующего Matter-хаба или Thread Border Router. Google Home указывает, что для первичного добавления Matter используются Bluetooth Low Energy и локальная сеть, а для…
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Set up, manage and control Matter-enabled devices with Google Home). Пример и формулировки — редакция N1RO на 2026-09-20.