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. Ampliaremos 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
En relación con 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 un solo concentrador habilitado para Matter conectado a fin de realizar pruebas. Varios concentradores habilitados para Matter conectados al mismo tiempo o conectados 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 ejecute 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. Las instrucciones específicas de Mac se mencionan en los procedimientos según sea necesario.
Cómo compilar
Para compilar un dispositivo compatible con Matter que se integre con el 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 revisando 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 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
- 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 instaló una compilación o app de ejemplo compatibles con Matter.
- En dispositivos móviles
- Teléfono de prueba que se utiliza 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 contar con lo siguiente:
- Un unidad central de Google compatible con Thread que funciona como router de borde para dispositivos habilitados para 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 (versión 16.5 o posterior)
- Capacidad de 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 dispositivo Matter que se admiten actualmente en el ecosistema de Google Home y podría ser uno de los siguientes:
- Tu propio producto con firmware compatible con Matter.
- Una placa de desarrollo de una plataforma de proveedor compatible que puede servir como un dispositivo habilitado para Matter para la verificación de extremo a extremo. Se admiten las siguientes plataformas:
Proveedor | Plataforma | Guías | Asistencia de Thread |
---|---|---|---|
Bouffalo Lab | BL602 | Inicio rápido | |
BL702 | Inicio rápido | ||
Espressif | ESP32 | Inicio rápido
Pruebas inalámbricas |
|
Semiconductor nórdico | nRF52840 DK | Inicio rápido
Pruebas inalámbricas |
|
NXP | Kit de desarrollo IOTZTB-DK006 | Inicio rápido | |
Realtek | Ameba D Series | Inicio rápido | |
Silicon Labs | Kit para desarrolladores EFR32MG24 | Inicio rápido | |
Kit básico de Zigbee y Thread EFR32MG | Inicio rápido | ||
Telink | TLSR9518 | Inicio rápido | |
Instrumentos de Texas | Kit de desarrollo CC2652R7 LaunchPad | Inicio rápido |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID asignados por la CSA para realizar pruebas. Selecciona una de las siguientes opciones: 0xFFF1
, 0xFFF2
, 0xFFF3
o 0xFFF4
.
Si quieres usar un VID de producción para poder certificar y lanzar tu integración, primero debes verificarlo por parte de Google a fin de asegurarte de que te lo emitió CSA.
Este VID debe implementarse en el firmware de tu dispositivo.
Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en determinadas situaciones con ID de proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo de consumidor.
- 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. Luego, 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 correspondientes 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 la Alliance.
¿Qué tipos de usuarios pueden asignar el dispositivo al ecosistema de Google Home? | |||
---|---|---|---|
Tipo de VID | Certificación de VID y estado de integración de la consola | Producción
(usuarios consumidores) |
Desarrollo
(Desarrolladores, usuarios de la prueba de campo) |
Prueba | Sin integración en Developer Console (no se puede certificar) | ||
Prueba | 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 | Está 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 desde el clúster de información básica 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.
Funciones no admitidas
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 serán visibles para los usuarios finales:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Consulta la sección Interruptores de luz de encendido y apagado para conocer cómo esto afecta a los interruptores de luz de encendido y apagado.