El programa para desarrolladores de Google Home permite que los fabricantes de dispositivos conecten sus dispositivos inteligentes para la casa con el ecosistema de Google Home. Estamos expandiendo la ruta de cumplimiento local de las Acciones para la casa inteligente con la capacidad de agregar dispositivos compatibles con Matter para la configuración con Google Home app (GHA) y controlarlos con Google Assistant, GHA o pantallas inteligentes como Google Nest Hub (2nd gen).
En esta documentación, se describe cómo comenzar a compilar e integrar una plataforma compatible con Matter en el ecosistema de Google Home.
Renuncias de responsabilidad
En relación con los procedimientos que se describen en la documentación de Matter, ten en cuenta lo siguiente:
- Te recomendamos que la cuenta que se use para el desarrollo solo tenga un centro habilitado para Matter conectado para las pruebas. Si hay varios concentradores habilitados para Matter conectados al mismo tiempo o a la misma estructura durante las pruebas, se podría producir un comportamiento impredecible.
- Todos los procedimientos suponen el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir muestras de Matter, que Google probó. Si bien las máquinas macOS son compatibles, se recomienda usar Linux. Las instrucciones específicas para Mac se indican en los procedimientos según sea necesario.
Cómo construir
Para crear un dispositivo compatible con Matter que se integre en el ecosistema de Google Home, trabajarás con una placa de desarrollo compatible con Matter y el SDK de Matter.
La forma más sencilla de comenzar es realizar nuestros codelabs. Te recomendamos que realices al menos uno de los siguientes codelabs:
Luego, consulta nuestra lista de dispositivos compatibles para asegurarte de que lo que planeas integrar sea compatible con el ecosistema de Google Home. Luego, lee la Lista de verificación para desarrolladores para comprender todo el flujo de desarrollo, desde la creación del proyecto hasta el lanzamiento.
Dispositivos compatibles Lista de tareas para desarrolladores
Definiciones
En esta documentación, se utilizan los siguientes términos:
- Router de borde
- Un concentrador que implementa un router de borde Thread de uso general para dispositivos compatibles con Thread.
- Concentrador
- Un dispositivo Google Nest compatible, como el Google Nest Hub (2nd gen). Se requiere una unidad central para controlar los dispositivos compatibles con Matter a través de otras plataformas, como Assistant, el GHA y las pantallas inteligentes.
- Dispositivo compatible con Matter
- Un dispositivo o una placa de desarrollo en los que se haya escrito en la memoria flash una compilación o una app de ejemplo habilitadas para Matter.
- Dispositivo móvil
- Teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, este es un teléfono Android.
Requisitos previos
Para integrar por completo un dispositivo compatible con Matter en el ecosistema de Google Home, el desarrollador debe tener lo siguiente:
- Una unidad central de Google compatible con Thread para que funcione como router de borde para dispositivos compatibles con Thread y como ruta de entrega local para enrutar intents de casa inteligente.
- Un dispositivo móvil (teléfono de prueba) que cumpla con los requisitos mínimos:
- Android O (8.1, nivel de API 27 o posterior)
- iOS (v16.5 o versiones posteriores)
- Capacidad de BLE
- Un ID de proveedor (VID) y un ID de producto (PID) para el dispositivo compatible con Matter.
- Un dispositivo compatible con Matter Este dispositivo debe ser uno de los tipos de dispositivos Matter compatibles con el ecosistema de Google Home y puede ser uno de los siguientes:
- Tu propio producto con firmware habilitado para Matter
- Uno de los siguientes dispositivos Matter para usar en la verificación de extremo a extremo:
| Proveedor | Plataforma | Asistencia de Thread | Guía |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Pruebas de OTA | |
| Nordic Semiconductor | nRF52840 DK | Pruebas de OTA | |
| NXP | Kit de desarrollo IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | Kit de desarrollo EFR32MG24 | ||
| Kit de inicio de EFR32MG Zigbee y Thread | |||
| Telink | TLSR9518 | ||
| Texas Instruments | Kit de desarrollo CC2652R7 LaunchPad |
ID del proveedor
De forma predeterminada, puedes usar uno de los VIDs asignados por la CSA para realizar pruebas. Selecciona una de las siguientes opciones:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Para usar un VID de producción y que se pueda certificar y lanzar tu integración, primero debes hacer que Google lo verifique para asegurarse de que la CSA te lo haya emitido.
Este VID se debe implementar en el firmware del dispositivo.
Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en ciertos casos de ID del proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo para consumidores.
- El VID de producción debe ser emitido por Connectivity Standards Alliance (Alliance). Google validará que seas el propietario de ese VID antes de que puedas usarlo en Google Home Developer Console. Una vez que eso suceda, podrás crear integraciones para ese VID.
- Para fines de desarrollo y Field Trial, se debe crear un proyecto en Developer Console y una integración con la combinación de VID y PID correspondiente. El usuario que pone en servicio el dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de Field Trial.
- Los usuarios finales solo pueden usar tu producto una vez que el Alliance lo haya certificado.
El VID y el PID solo se pueden usar una vez para una integración. Si quieres usar el mismo VID o PID en tu integración, debes hacer una de las siguientes acciones:
- Edita la integración con el VID o PID a un VID o PID diferente.
- Borra la integración con el VID o el PID.
| ¿Qué tipos de usuarios pueden poner en funcionamiento el dispositivo en el ecosistema de Google Home? | |||
|---|---|---|---|
| Tipo de VID | Estado de la certificación de VID y la integración de la consola | Producción
(usuarios consumidores) |
Desarrollo
(Desarrolladores, usuarios de Field Trial) |
| Prueba | No hay integración en Developer Console (no se puede certificar) | ||
| Prueba | La integración existe en Developer Console (no se puede certificar) | ||
| Producción | No está certificada y la integración no existe en Developer Console | ||
| Producción | No está certificada, pero existe en Developer Console | ||
| Producción | Certificado en la DCL de Alliance, la integración no existe en Developer Console | ||
| Producción | Certificado en la DCL de Alliance y la integración existe en Developer Console | ||
ID del producto
La información sobre el dispositivo se lee del clúster Matter Basic Information. El ID de producto codificado en el firmware de tu dispositivo debe coincidir con el ID de producto de la integración de Matter en Play Console.
Características no compatibles
Algunos clústeres de Matter aún no se muestran a los usuarios, aunque el sistema los puede usar. En la mayoría de los casos, esto significa que los usuarios finales no pueden ver los atributos expuestos a través de estos clústeres:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Consulta Interruptores de luz de encendido/apagado para saber cómo esto afecta a los interruptores de luz de encendido/apagado.