Parear um dispositivo de caso

Pareie seu dispositivo compatível com Matter. Para isso, você precisará de um código QR para pareamento. Dependendo da plataforma do seu dispositivo Matter, talvez seja necessário gerar esse código QR por conta própria.

Receber um código QR

Laboratório de bouffalo

BL602

A string do código QR é impressa no console serial quando o dispositivo é inicializado. Confira seu console serial. Você deve ver mensagens como esta:

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 é impressa no console serial quando o dispositivo é inicializado. Confira seu console serial. Você deve ver mensagens como esta:

[         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

Abra o link em um navegador da Web para exibir o código QR.

Nxp

K32W

A string do código QR é impressa no console serial quando o dispositivo é inicializado. Confira seu console serial. Você deve ver mensagens como esta:

[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:

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

Abra o link em um navegador da Web para exibir o código QR.

Laboratórios de silicone

EFR32MG12

Quando a placa for inicializada, você verá um código QR na pequena tela LCD.

TLSR9518

A string do código QR é impressa no console serial quando o dispositivo é inicializado. Confira o console serial. Você verá um URL que exibirá 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:

  1. Google Home app (GHA)
  2. SDKs de rede móvel e Thread do Google para Android, que podem ser usados em um app de terceiros.

Os dois métodos usam as mesmas APIs de rede Matter e Thread.

App Google Home

  1. Abra o arquivo GHA.
  2. Toque na no canto superior esquerdo.
  3. Toque em Configurar dispositivo.
  4. Toque em Novo dispositivo.
  5. Selecione sua casa e toque em Próxima.
  6. O GHA vai procurar seu dispositivo. Quando a mensagem informar se você quer configurar o dispositivo, toque em Configurar um dispositivo diferente.
  7. Toque em Matter dispositivo para qualquer tipo de dispositivo.
  8. Aponte a câmera para o código QR do dispositivo ou para o código gerado pelo site.
  9. Continue o processo de pareamento conforme indicado no fluxo GHA.

Se você encontrar algum problema durante o pareamento com o GHA no dispositivo móvel, faça o seguinte:

  1. Confira se as Opções do desenvolvedor estão ativadas no seu dispositivo móvel.
  2. Imediatamente após a tentativa de pareamento malsucedida, capture um relatório do bug.

SDKs do Android

Implementar nossos SDKs do Android para parear dispositivos Matter e gerenciar redes Thread no seu app

Os SDKs do Android foram disponibilizados em Play services para testes 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 com Matter no ecossistema do Google Home usando esses SDKs.

A documentação de referência para ambos os SDKs está disponível neste site:

Restrições de pareamento

Um dispositivo Matter só pode ser pareado no ecossistema Google Home em alguns cenários com ID do fornecedor e tipo de dispositivo.

  • Não é possível usar um VID de teste em um dispositivo de consumidor.
  • Seu VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google validará que você é o proprietário desse VID antes de usá-lo no Google Home Developer Console. Quando isso acontecer, será possível criar integrações para o VID.
  • Para fins de desenvolvimento e teste de campo, é necessário criar no Developer Console um projeto e a integração com a combinação de VID e PID correspondente. O usuário que comissionou o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários dos testes de campo.
  • Os usuários pessoais só poderão usar seu produto depois que ele for certificado pelo Alliance.
Tabela: cenários de pareamento do ID do fornecedor (VID, na sigla em inglês) e do tipo de dispositivo
Que tipos de usuários podem comissionar o dispositivo no ecossistema do Google Home?
Tipo de VID Certificação de VID e status de integração do console Produção
(Usuários de consumo)
Desenvolvimento
(Desenvolvedores, usuários de testes de campo)
Teste Nenhuma integração no Developer Console (não pode ser certificado)
Teste A integração existe no Developer Console (não pode ser certificada)
Produção Não certificado, a integração não existe no Developer Console
Produção Não certificado, a integração existe no Developer Console
Produção Certificada pela DCL Alliance, a integração não existe no Developer Console
Produção Certificada na DCL Alliance, e a integração existe no Developer Console

Informações do dispositivo

As informações técnicas do dispositivo pareado podem ser consultadas no GHA.

  1. No GHA, selecione o dispositivo.
  2. Toque no ícone no canto superior direito.
  3. Toque em Informações técnicas.

Identificadores como Fabricante, Modelo e Versão do hardware 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 ID do produto de teste, que podem ser duplicados em integrações.

Solução de problemas de pareamento

Se você pareou um dispositivo com um ID do 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, é provável que isso seja causado ao usar a mesma combinação de VID e PID de teste em várias integrações.

Para resolver problemas, remova todos os dispositivos de teste do Developer Console e pareie o dispositivo que você quer testar novamente.

Para validar o pareamento do dispositivo correto, defina as informações do fabricante e do modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) do dispositivo para valores exclusivos no firmware de teste.

Consulte Informações do dispositivo para mais informações.