Подключить устройство 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-код.

НХП

К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-код.

Реалтек

Амеба Д

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-код.

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

ЭФР32МГ12

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

Телинк

ТЛСР9518

Строка 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 Google Home Mobile и Thread Network для 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 в Developer Console необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID. Пользователь, вводящий устройство в эксплуатацию, должен либо быть участником проекта, либо быть включен в список пользователей Field Trial .
• Потребители смогут использовать ваш продукт только после того, как он будет сертифицирован Alliance .

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

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

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

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

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

Идентификаторы, такие как Производитель , Модель и Версия оборудования , берутся из прошивки 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_* ) устройства в вашей тестовой прошивке.

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