Подключите устройство с поддержкой Matter . Для этого вам понадобится QR-код для сопряжения. В зависимости от платформы вашего устройства Matter вам может потребоваться сгенерировать этот QR-код самостоятельно.
Получить QR-код
Строка 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-код.
Строка 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
Getting the QR code differs for each type of ESP32-based kit:
- 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 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - 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.
When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.
The device shows the QR code immediately after booting.
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-код.
Строка 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:
Откройте ссылку в веб-браузере, чтобы отобразить QR-код.
Как только плата загрузится, вы должны найти QR-код на ее небольшом ЖК-дисплее.
Строка 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
Сопряжение устройства
Существует два способа сопряжения устройства:
- Google Home app (GHA)
- SDK Google Home Mobile и Thread Network для Android (которые можно использовать в стороннем приложении)
Оба метода используют одни и те же API-интерфейсы Matter и Thread Network.
Приложение Google Home
- Откройте GHA .
- Нажмите на в левом верхнем углу.
- Нажмите «Настроить устройство» .
- Нажмите «Новое устройство» .
- Выберите свой дом и нажмите «Далее» .
- GHA просканирует ваше устройство. Когда появится запрос о том, хотите ли вы настроить свое устройство, нажмите «Настроить другое устройство» .
- Нажмите на устройство Matter для любого типа устройства.
- Наведите камеру на QR-код вашего устройства (или QR-код, созданный на веб-сайте).
- Продолжайте процесс сопряжения, как указано в потоке GHA .
Если у вас возникнут какие-либо проблемы во время сопряжения с GHA на вашем мобильном устройстве:
- Убедитесь, что на вашем мобильном устройстве включены параметры разработчика .
- Сразу после неудачной попытки сопряжения составьте отчет об ошибке .
Android SDK
Android SDK доступны в Play services для тестирования и сопряжения со сторонним приложением.
Мы предлагаем начать с Google Home Sample App for Matter , в котором показано, как вводить в эксплуатацию, подключать и управлять устройством с поддержкой Matter в экосистеме Google Home с помощью этих SDK.
Справочная документация для обоих SDK доступна на этом сайте:
Ограничения на сопряжение
Устройство 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.
| Какие типы пользователей могут подключить устройство к экосистеме Google Home? | |||
|---|---|---|---|
| Тип VID | Сертификация VID и статус интеграции с консолью | Производство (Пользователи-потребители) | Разработка (Разработчики, пользователи Field Trial ) |
| Тест | Нет интеграции с Developer Console (не подлежит сертификации) | ||
| Тест | Интеграция существует в Developer Console (не подлежит сертификации) | ||
| Производство | Не сертифицировано, интеграция не существует в Developer Console | ||
| Производство | Не сертифицировано, существует интеграция в Developer Console | ||
| Производство | Сертифицировано в Alliance DCL, интеграция с Developer Console невозможна. | ||
| Производство | Сертифицировано в Alliance DCL, имеется интеграция с Developer Console | ||
Информация об устройстве
Техническую информацию по сопряженному устройству можно посмотреть в GHA .
- В GHA выберите устройство.
- Нажмите значок в правом верхнем углу.
- Нажмите Техническая информация .
Идентификаторы, такие как Производитель , Модель и Версия оборудования , берутся из прошивки 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_* ) устройства в вашей тестовой прошивке.
Дополнительную информацию см. в разделе Информация об устройстве .