Что такое код сопряжения Matter?

Каждое устройство умного дома Matter поставляется с кодом сопряжения, с помощью которого приложение на телефоне или хаб добавляет его в ваш дом. Код напечатан дважды: в виде QR-кода, текст которого начинается с MT:, и в виде кода сопряжения для ручного ввода из 11 или 21 цифры, который вводят, когда камера не может прочитать QR-код. Оба содержат код настройки — секрет, знание которого приложение подтверждает при подключении, — и дискриминатор — число, отличающее устройство от других устройств поблизости, которые тоже ожидают настройки.

Как пользоваться

Введите или вставьте текст QR-кода или код сопряжения для ручного ввода. Пробелы, дефисы и строчные буквы допускаются, а код декодируется по мере ввода. Чтобы считать код с фотографии этикетки, воспользуйтесь инструментом «Сканер кода сопряжения Matter».

Что вы увидите

  • Тип кода: текст QR-кода или код сопряжения для ручного ввода из 11 или 21 цифры.
  • Идентификатор производителя и Идентификатор продукта в десятичном и шестнадцатеричном виде. Идентификаторы производителя от 0xFFF1 до 0xFFF4 — тестовые, их используют наборы для разработки и примеры из Matter SDK. 11-значный код не содержит ни того, ни другого ID.
  • Дискриминатор: полное 12-битное значение из QR-кода. Код для ручного ввода содержит только его 4 старших бита.
  • Код настройки в виде восьми цифр, как принято в спецификации Matter.
  • Процесс ввода в эксплуатацию: «Стандартный» (устройство готово к сопряжению сразу после включения), «Требуется действие пользователя» (сначала нажмите кнопку или выполните указания из инструкции) или «Пользовательский» (шаги описаны в записи производителя в Distributed Compliance Ledger — базе данных сертификации Matter). 11-значный код всегда означает стандартный процесс.
  • Код сопряжения для ручного ввода: цифры, напечатанные рядом с QR-кодом, вычисленные по тексту QR-кода. На устройствах со стандартным процессом печатается 11 цифр; для других процессов нужен 21-значный код с идентификаторами производителя и продукта.
  • Способы обнаружения: как можно найти устройство, пока оно ожидает настройки: Bluetooth LE, уже в IP-сети, Wi-Fi Public Action Frame, NFC, Thread или Wi-Fi Soft-AP на старых устройствах. Эти способы указываются только в QR-кодах.
  • Дополнительные данные: серийный номер, тайм-аут ввода в эксплуатацию и другие необязательные поля, которые есть в некоторых QR-кодах.

Один QR-код может содержать коды нескольких устройств, продающихся вместе; выберите нужное в списке Устройство.

Если код недействителен

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

Конфиденциальность

Декодирование выполняется в вашем браузере, поэтому код никуда не отправляется. Код сопряжения позволяет любому, кто находится рядом, добавить устройство, пока оно ожидает настройки, поэтому не публикуйте настоящие коды на снимках экрана и в постах.