El programa para desarrolladores de Google Home permite a los fabricantes de dispositivos conectar sus dispositivos de casa inteligente con el ecosistema de Google Home. Ampliamos la ruta de entrega local de Acciones de casa inteligente con la capacidad de agregar dispositivos habilitados para Matter para su configuración mediante 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
Con respecto a los procedimientos descritos en la documentación de Matter, ten en cuenta lo siguiente:
- Recomendamos que la cuenta que se usa para el desarrollo tenga solo un único concentrador habilitado para Matter conectado a fin de realizar pruebas. Varios concentradores habilitados para Matter conectados al mismo tiempo o a la misma estructura durante las pruebas podrían generar un comportamiento impredecible.
- En todos los procedimientos, se supone el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir en la memoria flash muestras de Matter que Google probó. Si bien las máquinas macOS son compatibles, se recomienda Linux. En los procedimientos, se mencionan las instrucciones específicas de Mac según sea necesario.
Cómo crear
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 SDK de Matter.
La forma más fácil de comenzar es a través de nuestros codelabs. Te recomendamos realizar al menos uno de los siguientes codelabs:
Luego, consulta nuestra lista de dispositivos compatibles para asegurarte de que lo que tienes pensado integrar sea compatible con el ecosistema de Google Home. Luego, lee la lista de tareas para desarrolladores a fin de 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 usan los siguientes términos:
- Router de borde
- Es un concentrador que implementa un router de borde Thread de uso general para dispositivos compatibles con Thread.
- Concentrador
- Un dispositivo Google Nest compatible, como 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, GHA y pantallas inteligentes.
- Dispositivo compatible con Matter
- Un dispositivo o una placa de desarrollo en la que se haya escrito una compilación o app de ejemplo habilitadas para Matter.
- En dispositivos móviles
- El teléfono de prueba que se usa para asistir 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, un desarrollador debe contar con lo siguiente:
- Una unidad central de Google compatible con Thread que funciona 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 versiones posteriores)
- iOS (v16.5 o versiones posteriores)
- Capacidad BLE
- Un ID de proveedor (VID) y un ID del producto (PID) para el dispositivo habilitado para 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 de los siguientes tipos:
- Tu propio producto con firmware compatible con 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 OTA | |
Semiconductor nórdico | nRF52840 DK | Pruebas OTA | |
NXP | Kit de desarrollo de IoTTZTB-DK006 | ||
Realtek | Ameba D Series | ||
Silicon Labs | Kit para desarrolladores EFR32MG24 | ||
Kit básico de Zigbee y Thread para EFR32MG | |||
Telink | TLSR9518 | ||
Instrumentos de Texas | Kit de desarrollo CC2652R7 LaunchPad |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID que asigna CSA con fines de
pruebas. Selecciona una de las siguientes opciones: 0xFFF1
, 0xFFF2
, 0xFFF3
o 0xFFF4
.
Si quieres usar un VID de producción para que se pueda certificar y lanzar tu integración, primero Google debe verificarlo para asegurarte de que te lo emitió la CSA.
Debes implementar este VID en el firmware de tu dispositivo.
Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en determinadas situaciones de ID de proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo de consumidores.
- 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 Google Home Developer Console. Una vez que eso suceda, podrás crear integraciones para ese VID.
- Para fines de desarrollo y prueba de campo, se debe crear un proyecto y una integración con la combinación de VID y PID correspondiente en Developer Console. El usuario que encarga el dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de la prueba de campo.
- Los usuarios consumidores solo pueden usar tu producto una vez que esté certificado por Alliance.
¿Qué tipos de usuarios pueden enviar el dispositivo al ecosistema de Google Home? | |||
---|---|---|---|
Tipo de VID | Estado de la integración de la consola y la certificación de VID | Producción
(usuarios consumidores) |
Desarrollo
(Desarrolladores y usuarios de la prueba de campo) |
Probarla | No hay integración en Developer Console (no se puede certificar) | ||
Probarla | La integración existe en Developer Console (no se puede certificar) | ||
Producción | Sin certificación, la integración no existe en Developer Console | ||
Producción | Sin certificación, la integración existe en Developer Console | ||
Producción | Está certificada en la DCL de Alliance; la integración no existe en Developer Console | ||
Producción | Tienen la certificación en el DCL de Alliance y la integración existe en Developer Console. |
ID del producto
La información sobre el dispositivo se lee desde el clúster de información básica de Matter. El ID del producto codificado en el firmware de tu dispositivo debe coincidir con el ID del producto de la integración de Matter en Play Console.
Características no compatibles
Algunos clústeres Matter aún no están expuestos 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 |
|
1 Consulta Interruptores de luz de encendido y apagado para descubrir cómo esto afecta a los interruptores de luz de encendido y apagado.