Vincula un dispositivo Matter

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Sincroniza tu 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.

Obtener un código QR

Bouffalo Lab

BL602

La string de código QR se imprime en la consola en serie cuando se inicia el dispositivo. Verifica la consola en serie y deberías ver mensajes como este:

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
...

Abre el vínculo en un navegador web para mostrar el código QR.

BL702

La string de código QR se imprime en la consola en serie cuando se inicia el dispositivo. Revisa tu consola en serie y deberías ver mensajes como este:

[         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

Abre el vínculo en un navegador web para mostrar el código QR.

NXP,

K32W

La string de código QR se imprime en la consola en serie cuando se inicia el dispositivo. Verifica la consola en serie y deberías ver mensajes como este:

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

Abre el vínculo en un navegador web para mostrar el código QR.

Realtek

Ameba D

El código QR se codifica en una URL, que se imprime en la consola en serie cuando se inicia la placa 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

Abre el vínculo en un navegador web para mostrar el código QR.

Silicon Labs

EFR32MG12

Una vez que se inicie la placa, deberías encontrar un código QR en su pequeña pantalla LCD.

TLS 9518

La string de código QR se imprime en la consola en serie cuando se inicia el dispositivo. Revisa la consola en serie. Deberías ver una URL que mostrará el código QR cuando se abra en un 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

Sincronizar el dispositivo

Hay dos maneras de sincronizar el dispositivo:

  1. Google Home app (GHA)
  2. Google Home para dispositivos móviles y Thread Network SDKs for Android (which can be used in a 3rd party app)

Ambos métodos usan las mismas API de red Matter y Thread.

App de Google Home

  1. Abre GHA.
  2. Presiona la en la esquina superior izquierda.
  3. Presiona Configurar dispositivo.
  4. Presiona Dispositivo nuevo.
  5. Selecciona tu casa y presiona Siguiente.
  6. GHA buscará tu dispositivo. Una vez que se te pregunte si deseas configurar tu dispositivo, presiona Configurar un dispositivo diferente.
  7. Presiona Dispositivo Matter para cualquier tipo de dispositivo.
  8. Apunta la cámara al código QR del dispositivo (o al código QR generado por el sitio web).
  9. Continúa el proceso de vinculación como se indica en el flujo GHA.

Si tienes algún problema durante la sincronización con GHA en tu dispositivo móvil, haz lo siguiente:

  1. Asegúrate de tener habilitadas las Opciones para desarrolladores en tu dispositivo móvil.
  2. Inmediatamente después del intento de vinculación fallido, captura un informe de errores.

SDK de Android

Implementa nuestros SDK de Android para vincular dispositivos Matter y administrar redes Thread en tu app

Se pusieron a disposición los SDK de Android en Play services para hacer pruebas y vincularlos en una app de terceros.

Te sugerimos que comiences con Google Home Sample App for Matter , que ilustra cómo asignar, vincular y controlar un dispositivo habilitado para Matter en el ecosistema de Google Home con estos SDK.

La documentación de referencia para ambos SDK está disponible en este sitio:

Restricciones de sincronización

Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en situaciones específicas de tipo de dispositivo y ID del proveedor.

  • No se puede usar un VID de prueba en un dispositivo de consumidor.
  • Para que un dispositivo de producción (consumidor) sea emparejado, debe estar certificado en el DCL de CSA.
  • Para fines de desarrollo y prueba de campo, un dispositivo debe estar registrado en Google Home Developer Console .
Tabla: ID de proveedores (VID) y situaciones de vinculación del tipo de dispositivo
¿Qué tipos de usuarios pueden poner el dispositivo en el ecosistema de Google Home?
Tipo de VID Certificación de VID y estado de registro Producción
(usuarios consumidores)
Desarrollo
(Desarrolladores, usuarios de pruebas de campo)
Probar No registrado (no se puede certificar) N/A N/A
Probar Registrado en Developer Console (no se puede certificar) N/A
Producción Sin certificación ni registro N/A
Producción Sin certificación, registrado en el Developer Console
Producción Certificado por la CSA DCL, no registrado N/A
Producción Certificado por el CSA DCL y registrado en el Developer Console

Información del dispositivo

Puedes ver la información técnica del dispositivo sincronizado en GHA.

  1. En el GHA, selecciona el dispositivo.
  2. Presiona el ícono en la parte superior derecha.
  3. Presiona Información técnica.

Identificadores como Manufacturer, Modelo y Versión de hardware provienen del firmware Matter en el dispositivo, no de Developer Console. Por ejemplo, los valores CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME y CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME en la configuración del dispositivo en el SDK de Matter.

Estos identificadores pueden ser útiles para validar qué dispositivo se sincronizó con fines de prueba, en especial cuando se usan un ID de proveedor y de producto del prueba (que se puede duplicar en las integraciones).

Solución de problemas de sincronización

Si sincronizaste un dispositivo con un ID de proveedor (VID) y un ID de producto (PID) de prueba, pero no aparece cuando intentas probar el dispositivo con el conjunto de pruebas en Developer Console, es probable que esto se deba a la combinación del mismo VID y PID de prueba en varias integraciones.

Para solucionar el problema, quita todos los dispositivos de prueba de Developer Console y vincula el dispositivo que quieras probar de nuevo.

Para validar que sincronizaste el correcto, puedes establecer la información del fabricante y del modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo en valores únicos en tu firmware de prueba.

Consulta Información del dispositivo para obtener más información.