Подключить устройство Matter

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

Получить QR-код

Лаборатория Буффало

БЛ602

Строка QR-кода печатается в последовательной консоли при загрузке устройства. Проверьте свою последовательную консоль, и вы должны увидеть сообщения вроде этого:

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
...

Откройте ссылку в веб-браузере, чтобы отобразить QR-код.

BL702

Строка QR-кода печатается в последовательной консоли при загрузке устройства. Проверьте свою последовательную консоль, и вы должны увидеть сообщения вроде этого:

[         0][-][PROGR] ==================================================
[         0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[         0][-][PROGR] ==================================================
...
[      1636][-][PROGR] Starting OpenThread task
[      1655][DL][PROGR] Device Configuration:
[      1703][DL][PROGR]   Serial Number: TEST_SN
[      1703][DL][PROGR]   Vendor Id: 65521 (0xFFF1)
[      1703][DL][PROGR]   Product Id: 32773 (0x8005)
[      1752][DL][PROGR]   Hardware Version: 0
[      1799][DL][PROGR]   Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[      1846][DL][PROGR]   Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[      1893][DL][PROGR]   Manufacturing Date: (not set)
[      1893][DL][PROGR]   Device Type: 65535 (0xFFFF)
[      1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[      1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[      1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234

      

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.
   

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

Откройте ссылку в веб-браузере, чтобы отобразить QR-код.

NXP

К32В

Строка QR-кода печатается в последовательной консоли при загрузке устройства. Проверьте свою последовательную консоль, и вы должны увидеть сообщения вроде этого:

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

Откройте ссылку в веб-браузере, чтобы отобразить QR-код.

Реалтек

Амеба D

QR-код закодирован в URL-адресе, который выводится на последовательную консоль при загрузке платы Ameba D:

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Откройте ссылку в веб-браузере, чтобы отобразить QR-код.

Кремниевые Лаборатории

EFR32MG12

После загрузки платы на ее небольшом ЖК-дисплее вы увидите QR-код.

Телинк

TLSR9518

Строка QR-кода печатается в последовательной консоли при загрузке устройства. Проверьте последовательную консоль, и вы должны увидеть URL, который отобразит QR-код при открытии в браузере:

*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626  ***
I: Init CHIP stack
I: Starting CHIP task
…
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
…
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Подключите устройство

Существует два способа сопряжения устройства:

1. Google Home app (GHA)
2. Пакеты SDK Home Mobile и Thread Network от Google для Android (которые можно использовать в сторонних приложениях)

Оба метода используют одни и те же API-интерфейсы Matter и Thread Network.

Приложение Google Home

1. Откройте GHA .
2. Нажмите на ссылку « add в левом верхнем углу.
3. Нажмите «Настроить устройство» .
4. Нажмите «Новое устройство» .
5. Выберите свой дом и нажмите «Далее» .
6. GHA выполнит сканирование вашего устройства. После того, как появится запрос на настройку устройства, нажмите «Настроить другое устройство» .
7. Нажмите на устройство Matter для любого типа устройства.
8. Наведите камеру на QR-код вашего устройства (или QR-код, сгенерированный веб-сайтом).
9. Продолжайте процесс сопряжения, как указано в потоке GHA .

Если у вас возникли проблемы при сопряжении с GHA на вашем мобильном устройстве:

1. Убедитесь, что на вашем мобильном устройстве включены параметры разработчика .
2. Сразу после неудачной попытки сопряжения составьте отчет об ошибке .

Android SDK

Android SDK стали доступны в Play services для тестирования и сопряжения со сторонним приложением.

Мы предлагаем начать с Google Home Sample App for Matter , который иллюстрирует, как вводить в эксплуатацию, подключать и управлять устройством с поддержкой Matter в экосистеме Google Home с помощью этих SDK.

Справочная документация по обоим SDK доступна на этом сайте:

• Справочник Google Home Mobile SDK
• Справочник по SDK Thread Network

Ограничения на сопряжение

Устройство Matter может быть сопряжено с экосистемой Google Home только в определенных сценариях идентификатора поставщика и типа устройства.

• Тестовый VID нельзя использовать в потребительском устройстве.
• Ваш производственный VID должен быть выдан Connectivity Standards Alliance (Alliance) . Google проверит, являетесь ли вы владельцем этого VID, прежде чем вы сможете использовать его в Google Home Developer Console . Как только это произойдет, вы сможете создавать интеграции для этого VID.
• Для целей разработки и Field Trial необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID в Developer Console . Пользователь, вводящий устройство в эксплуатацию, должен быть либо участником проекта, либо быть включенным в список пользователей Field Trial .
• Потребители смогут использовать ваш продукт только после его сертификации Alliance .

VID и PID можно использовать только один раз для одной интеграции. Если вы хотите использовать один и тот же VID или PID в своей интеграции, вам нужно либо:

• Отредактируйте интеграцию, используя VID или PID, на другой VID или PID.
• Удалите интеграцию, используя VID или PID.

Информация об устройстве

Техническую информацию о сопряженном устройстве можно посмотреть в GHA .

1. В GHA выберите устройство.
2. Нажмите значок settings в правом верхнем углу.
3. Нажмите Техническая информация .

Такие идентификаторы, как Manufacturer , Model и Hardware version берутся из прошивки Matter на устройстве, а не из Developer Console . Например, значения CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME и CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME в конфигурации устройства в Matter SDK .

Эти идентификаторы могут быть полезны для проверки того, какое устройство было сопряжено для целей тестирования , особенно при использовании тестового идентификатора поставщика и идентификатора продукта (которые могут дублироваться между интеграциями).

Устранение неполадок сопряжения

Если вы связали устройство с тестовым идентификатором поставщика (VID) и идентификатором продукта (PID), но оно не отображается при попытке протестировать устройство с помощью тестового набора в Developer Console , это, скорее всего, вызвано использованием одной и той же комбинации тестовых VID и PID в нескольких интеграциях.

Для устранения неполадок удалите все тестовые устройства из Developer Console и снова подключите устройство, которое вы хотите протестировать.

Чтобы убедиться, что вы подключили правильное устройство, вы можете задать уникальные значения для информации о производителе и модели (значения CHIP_DEVICE_CONFIG_DEVICE_* ) устройства в вашей тестовой прошивке.

Более подробную информацию см. в разделе «Информация об устройстве» .