El programa Home para desarrolladores de Google 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 Smart Home Actions con la capacidad de agregar dispositivos compatibles con Matter-enabled para la configuración con la Google Home app (GHA) y controlarlos con Google Assistant, GHA, o pantallas inteligentes como la 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 Matter documentación, ten en cuenta lo siguiente:
- Te recomendamos que la cuenta que se usa para el desarrollo solo tenga un centro compatible con Matter conectado para las pruebas. Si se conectan varios centros compatibles con Matter al mismo tiempo o a la misma estructura durante las pruebas, se podría generar un comportamiento impredecible.Matter
- En todos los procedimientos, se supone que se usa una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir muestras de Matter, que Google probó. Si bien se admiten las máquinas macOS, se recomienda Linux. Las instrucciones específicas para Mac se indican en los procedimientos según sea necesario.
Cómo compilar
Para compilar un dispositivo compatible con Matter que se integre al ecosistema de Google Home, trabajarás con una placa de desarrollo compatible con Matter y el Matter SDK.
La forma más sencilla de comenzar es consultar nuestros codelabs. Te recomendamos que realices al menos uno de los siguientes codelabs:
Después de eso, 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 tareas 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 centro que implementa un router de borde de Threaduso general para dispositivos compatibles con Thread.
- Centro
- Un dispositivo Google Nest compatible, como el Google Nest Hub (2nd gen). Se requiere un centro para controlar dispositivos compatibles con Matter-enabled a través de otras plataformas, como Assistant, GHA y pantallas inteligentes.
- Dispositivo compatible con Matter
- Un dispositivo o una placa de desarrollo que se escribió con una compilación o una app de muestra compatible con Matter
- Dispositivo móvil
- El teléfono de prueba que se usa para ayudar con el vinculación Actualmente, es un Android teléfono.
Requisitos previos
Para integrar por completo un dispositivo compatible con Matter al ecosistema de Google Home, un desarrollador debe tener lo siguiente:
- Un centro de Google con compatibilidad con Thread para que funcione como router de borde para dispositivos compatibles con Thread y como ruta de cumplimiento local para enrutar intents de Smart Home
- 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 posterior)
- Capacidad de BLE
- Un ID del proveedor (VID) y un ID del producto (PID) para el dispositivo compatible con Matter
- Un dispositivo compatible con Matter Este dispositivo debe ser uno de
los tipos de dispositivos Mattercompatibles con el
ecosistema de Google Home y puede ser lo siguiente:
- Tu propio producto con firmware compatible con Matter
- Uno de los siguientes Matter dispositivos para usar en la verificación de extremo a extremo:
| Proveedor | Plataforma | Compatibilidad con 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 | Serie Ameba D | ||
| Silicon Labs | Kit de desarrollo EFR32MG24 | ||
| Kit de inicio de Zigbee y Thread EFR32MG | |||
| Telink | TLSR9528 | Guía para desarrolladores de Matter de Telink | |
| Texas Instruments | Kit de desarrollo CC2652R7 LaunchPad |
ID del proveedor
De forma predeterminada, puedes usar uno de los VIDs asignados por la Alliance para
realizar pruebas. Selecciona una de las siguientes opciones:
0xFFF1, 0xFFF2, 0xFFF3 o 0xFFF4.
Para usar un VID de producción de modo que tu integración se pueda certificar y lanzar, primero Google debe verificarlo para asegurarse de que la Alliance te lo haya emitido.
Este VID debe implementarse en el firmware de tu 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 de consumidor.
- La Connectivity Standards Alliance (Alliance) debe emitir tu VID de producción. Google validará que eres el propietario de ese VID antes de que puedas usarlo en el 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 y una integración con la combinación de VID y PID correspondiente en la Developer Console. El usuario que asigna el dispositivo debe ser miembro del proyecto o estar incluido en la lista de Field Trial usuarios.
- Los usuarios consumidores solo pueden usar tu producto una vez que lo haya certificado el Alliance.
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 lo siguiente:
- Edita la integración con el VID o el PID a un VID o PID diferente.
- Borra la integración con el VID o el PID.
| ¿Qué tipos de usuarios pueden asignar el dispositivo al 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, Field Trial usuarios) |
| Prueba | No hay integración en la Developer Console (no se puede certificar) | ||
| Prueba | La integración existe en la Developer Console (no se puede certificar) | ||
| Producción | No está certificada, la integración no existe en la Developer Console | ||
| Producción | No está certificada, la integración existe en la Developer Console | ||
| Producción | Certificada en la Alliance DCL, la integración no existe en la Developer Console | ||
| Producción | Certificada en la Alliance DCL y la integración existe en la Developer Console | ||
ID del producto
La información sobre el dispositivo se lee del Matter clúster de información básica. El ID del producto codificado en el firmware de tu dispositivo debe coincidir con el ID del producto de la Matter integración en la Consola para desarrolladores.
Características no compatibles
Algunos clústeres Matter aún no se exponen a los usuarios, aunque el sistema puede usarlos. En la mayoría de los casos, esto significa que los atributos expuestos a través de estos clústeres no son visibles para los usuarios finales:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Consulta Interruptores de luz de encendido/apagado para ver cómo afecta esto a los interruptores de luz de encendido/apagado.