Соедините ваше устройство с поддержкой Matter . Для этого вам понадобится QR-код для сопряжения. В зависимости от платформы вашего устройства Matter вам может потребоваться создать этот QR-код самостоятельно.
Получить QR-код
Лаборатория Буффало
BL602
Строка 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
- 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.
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-код.
Реалтек
Амеба Д
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-код.
Силиконовые лаборатории
ЭФР32МГ12
Как только плата загрузится, вы должны найти 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
Подключить устройство
Существует два способа сопряжения устройства:
- Google Home app (GHA)
- SDK Google Home Mobile и Thread Network для Android (которые можно использовать в стороннем приложении)
Оба метода используют одни и те же сетевые API Matter и Thread .
Домашнее приложение Google
- Откройте GHA .
- Нажмите на в верхнем левом углу.
- Нажмите «Настроить устройство» .
- Нажмите Новое устройство .
- Выберите свой дом и нажмите «Далее» .
- GHA просканирует ваше устройство. Когда появится запрос о том, хотите ли вы настроить свое устройство, нажмите «Настроить другое устройство» .
- Нажмите на устройство Matter для любого типа устройства.
- Наведите камеру на QR-код вашего устройства (или QR-код, сгенерированный веб-сайтом).
- Продолжайте процесс сопряжения, как указано в потоке GHA .
Если у вас возникли проблемы во время сопряжения с GHA на вашем мобильном устройстве:
- Убедитесь, что на вашем мобильном устройстве включены параметры разработчика .
- Сразу же после неудачной попытки сопряжения сделайте отчет об ошибке .
SDK для Android
Android SDK стали доступны в Play services для тестирования и сопряжения в стороннем приложении.
Мы предлагаем начать с Google Home Sample App for Matter , который иллюстрирует, как вводить в эксплуатацию, связывать и управлять устройством с поддержкой Matter в экосистеме Google Home с помощью этих SDK.
Справочная документация для обоих SDK доступна на этом сайте:
Ограничения сопряжения
Устройство Matter может быть сопряжено в экосистеме Google Home только в определенных сценариях с идентификатором поставщика и типом устройства.
- Тестовый VID нельзя использовать в потребительском устройстве.
- Ваш производственный VID должен быть выдан CSA. Google подтвердит, что вы являетесь владельцем этого VID, прежде чем вы сможете использовать его в Google Home Developer Console . Как только это произойдет, вы сможете создавать интеграции для этого VID.
- Для целей разработки и полевых испытаний необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID в Developer Console . Пользователь, вводящий устройство в эксплуатацию, должен либо быть участником проекта, либо быть включенным в список пользователей, прошедших полевые испытания.
- Пользователи-потребители могут использовать ваш продукт только после того, как он будет сертифицирован CSA.
| Какие типы пользователей могут ввести устройство в экосистему Google Home? | |||
|---|---|---|---|
| Тип VID | Сертификация VID и статус интеграции консоли | Производство (Потребительские пользователи) | Разработка (Разработчики, пользователи полевых испытаний) |
| Тест | Нет интеграции в Developer Console (не подлежит сертификации) | ||
| Тест | Интеграция существует в Developer Console (не может быть сертифицирована) | ||
| Производство | Не сертифицирован, интеграции в Developer Console не существует. | ||
| Производство | Не сертифицировано, интеграция существует в Developer Console | ||
| Производство | Сертифицировано в CSA DCL, интеграция в Developer Console отсутствует. | ||
| Производство | Сертифицировано в CSA DCL и существует интеграция в Developer Console | ||
Информация об устройстве
Техническую информацию по сопряженному устройству можно посмотреть в GHA .
- В GHA выберите устройство.
- Коснитесь значка в правом верхнем углу.
- Коснитесь Техническая информация .
Идентификаторы, такие как Производитель , Модель и Версия оборудования, берутся из прошивки Matter на устройстве, а не из Developer Console . Например, значения CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME и CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME в конфигурации устройства в Matter SDK .
Эти идентификаторы могут быть полезны для проверки того, какое устройство было сопряжено для целей тестирования , особенно при использовании тестового идентификатора поставщика и идентификатора продукта (которые могут дублироваться в разных интеграциях).
Устранение неполадок сопряжения
Если вы связали устройство с тестовым идентификатором поставщика (VID) и идентификатором продукта (PID), но он не отображается при попытке протестировать устройство с помощью Test Suite в Developer Console , это, вероятно, вызвано использованием одного и того же протестируйте комбинацию VID и PID в нескольких интеграциях.
Чтобы устранить неполадки, удалите все тестовые устройства из Developer Console и снова подключите устройство, которое хотите протестировать.
Чтобы убедиться, что вы выполнили сопряжение с правильным устройством, вы можете установить для информации о производителе и модели (значения CHIP_DEVICE_CONFIG_DEVICE_* ) устройства уникальные значения в тестовой прошивке.
Дополнительные сведения см. в разделе Информация об устройстве .