Parear o Matter-enabled device. To do this, you'll need a QR code for pairing. Depending on the platform of your Matter device, you may need to generate this QR code yourself.
Receber um código QR
Laboratório Bouffalo
BL602
A string do código QR é mostrada no console serial quando o dispositivo é inicializado. Confira o console serial e você verá mensagens como estas:
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 ...
Abra o link em um navegador da Web para exibir o código QR.
BL702
A string do código QR é mostrada no console serial quando o dispositivo é inicializado. Confira o console serial e você verá mensagens como estas:
[ 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
Abra o link em um navegador da Web para exibir o código QR.
NXP;
K32W
A string do código QR é mostrada no console serial quando o dispositivo é inicializado. Confira o console serial e você verá mensagens como estas:
[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 ...
Abra o link em um navegador da Web para exibir o código QR.
Realtek
Ameba D
O código QR é codificado em um URL, que é impresso no console serial quando a placa Ameba D é inicializada:
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:
Abra o link em um navegador da Web para exibir o código QR.
Silicon Labs
EFR32MG12
Depois que a placa for inicializada, você verá um código QR na pequena tela LCD.
Telink
TLSR 9.518
A string do código QR é mostrada no console serial quando o dispositivo é inicializado. Verifique o console serial para ver um URL que mostra o código QR quando aberto em um navegador:
*** 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
Parear o dispositivo
Há duas maneiras de parear o dispositivo:
- Google Home app (GHA)
- Google Home para dispositivos móveis e Thread Network SDKs for Android (which can be used in a 3rd party app)
Os dois métodos usam as mesmas APIs de rede Matter e Thread.
App Google Home
- Abra o arquivo GHA.
- Toque no no canto superior esquerdo.
- Toque em Configurar dispositivo.
- Toque em Novo dispositivo.
- Selecione sua casa e toque em Próxima.
- O GHA procurará seu dispositivo. Depois de receber a solicitação para configurar o dispositivo, toque em Configurar um dispositivo diferente.
- Toque em Matter dispositivo para qualquer tipo de dispositivo.
- Aponte a câmera para o código QR do dispositivo ou para o gerado pelo site.
- Continue o processo de pareamento conforme indicado no fluxo GHA.
Se você encontrar problemas durante o pareamento com GHA no seu dispositivo móvel:
- Confira se as Opções do desenvolvedor estão ativadas no dispositivo móvel.
- Imediatamente após a tentativa de pareamento com falha, capture um relatório de bug.
SDKs do Android
Android SDKs foram disponibilizados em Play services para teste e pareamento em um app de terceiros.
Sugerimos começar com Google Home Sample App for Matter, que ilustra como comissionar, parear e controlar um dispositivo compatível com Matter no ecossistema do Google Home com esses SDKs.
A documentação de referência de ambos os SDKs está disponível neste site:
Restrições de pareamento
Um dispositivo Matter só pode ser pareado com o ecossistema do Google Home em determinados cenários de ID do fornecedor e tipo de dispositivo.
- Um VID de teste não pode ser usado em um dispositivo de consumo.
- Para que um dispositivo de produção (consumidor) seja pareado, ele precisa ser certificado na DCL de CSA.
- Para fins de desenvolvimento e teste em campo, um dispositivo precisa ser registrado no Google Home Developer Console.
| Que tipos de usuários podem colocar o dispositivo no ecossistema do Google Home? | |||
|---|---|---|---|
| Tipo de VID | Status de registro e certificação da VID | Produção
(usuários consumidores) |
Desenvolvimento
(desenvolvedores, usuários de teste de campo) |
| Teste | Não registrado (não pode ser certificado) | POLÍTICA SOBRE SAÚDE E MEDICAMENTOS | POLÍTICA SOBRE SAÚDE E MEDICAMENTOS |
| Teste | Registrado no Developer Console (não pode ser certificado) | POLÍTICA SOBRE SAÚDE E MEDICAMENTOS | |
| Produção | Não certificado, não registrado | POLÍTICA SOBRE SAÚDE E MEDICAMENTOS | |
| Produção | Não certificado, registrado no Developer Console | ||
| Produção | Certificado na DCL de CSA, não registrado | POLÍTICA SOBRE SAÚDE E MEDICAMENTOS | |
| Produção | Tem a certificação DCL CSA e está registrada no Developer Console | ||
Informações do dispositivo
As informações técnicas do dispositivo pareado podem ser visualizadas em GHA.
- Em GHA, selecione o dispositivo.
- Toque no ícone no canto superior direito.
- Toque em Informações técnicas.
Identificadores como Manufacturer, Model e Hardware version vêm
do firmware Matter no dispositivo, não do
Developer Console. Por exemplo, os
valores CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME e
CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME na configuração do dispositivo
no SDK do Matter.
Esses identificadores podem ser úteis para validar qual dispositivo foi pareado para fins de teste, especialmente ao usar um ID de fornecedor e um de produto de teste (que podem ser duplicados em todas as integrações).
Solução de problemas de pareamento
Se você pareou um dispositivo com um ID de fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) de teste, mas ele não aparece quando você tenta testar o dispositivo com o pacote de testes no Developer Console, isso provavelmente é causado pelo uso do mesmo conjunto de VID e PID de teste em várias integrações.
Para resolver problemas, remova todos os dispositivos de teste da Developer Console e faça o pareamento do dispositivo que você quer testar novamente.
Para validar se você pareou o dispositivo correto, defina as informações de
Fabricante e Modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) para o dispositivo como
valores exclusivos no firmware de teste.
Consulte Informações do dispositivo para mais informações.