Comienza a usar Matter

El programa para desarrolladores de Google Home permite que los fabricantes de dispositivos se conecten sus dispositivos de casa inteligente con el ecosistema de Google Home. Ampliamos el Ruta de entrega local de Acciones de casa inteligente con la capacidad de agregar Dispositivos habilitados para Matter 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 crear e integrar un Plataforma compatible con Matter en el ecosistema de Google Home.

Renuncias de responsabilidad

Con respecto a los procedimientos que se describen en el Matter de la documentación, ten en cuenta lo siguiente:

  • Recomendamos que la cuenta utilizada para el desarrollo solo tenga un Un concentrador habilitado para Matter conectado para realizar pruebas. Múltiples con Matter concentradores habilitados conectados a la mismo tiempo o se conectan a la misma estructura durante las pruebas podría generar un comportamiento impredecible.
  • Todos los procedimientos suponen el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir en la memoria flash muestras de Matter, que se que Google probó. Si bien las máquinas con macOS son compatibles, se recomienda Linux. Específico para Mac se mencionen las instrucciones 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 Matter SDK.

La forma más fácil de comenzar es revisando nuestros codelabs. Mié se recomienda realizar al menos uno de los siguientes codelabs:

Luego, consulta nuestra lista de dispositivos compatibles para asegurarte de que lo que integrar en el ecosistema de Google Home. Luego, lee la lista de tareas para desarrolladores para comprender toda de desarrollo, desde la creación del proyecto hasta el lanzamiento.

Dispositivos compatibles Lista de tareas para desarrolladores

Definiciones

Los siguientes términos se usan en toda esta documentación:

Router de borde
Un concentrador que implementa un borde Thread de uso general Router para dispositivos compatibles con Thread.
Hub
Un dispositivo Google Nest compatible, como el Google Nest Hub (2nd gen) Se requiere una unidad central para controlar los dispositivos compatibles con Matter mediante otras plataformas, como Assistant, el GHA y pantallas inteligentes.
Dispositivo compatible con Matter
Un dispositivo o una placa de desarrollo al que se le haya escrito una copia de seguridad en la memoria flash App de ejemplo o compilación habilitada para Matter
Dispositivo móvil
El teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, esta es una Android teléfono.

Requisitos previos

Extensiones de IDE recomendadas para Matter y desarrollo

Para integrar por completo un dispositivo compatible con Matter con ecosistema de Google Home, el desarrollador debe contar con lo siguiente:

  1. Una unidad central de Google compatible con Thread para funcionar como router de borde para dispositivos compatibles con Thread y como router ruta de entrega para enrutar intents de casa inteligente.
  2. 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)
    • Función BLE
  3. Un ID de proveedor (VID) y un ID del producto (PID) para el dispositivo compatible con Matter.
  4. Un dispositivo compatible con Matter Este dispositivo debe ser uno de los Matter tipos de dispositivos admitidos en la ecosistema de Google Home y podría ser:
    • Tu propio producto con firmware compatible con Matter.
    • Uno de los siguientes Matter dispositivos para usar Verificación de extremo a extremo:
Tabla: Matter ejemplos de proveedores de silicio
Proveedor Plataforma Asistencia de Thread Guía
Laboratorio Bouffalo BL602
BL702
Espressif ESP32 Pruebas OTA
Semiconductor nórdico nRF52840 DK Pruebas OTA
NXP Desarrollo de IOTZTB-DK006 kit
Realtek Ameba Serie D
Silicon Labs Kit para desarrolladores EFR32MG24
EFR32MG Zigbee y Thread Kit inicial
Telink TLSR9518
Instrumentos de Texas Desarrollo de CC2652R7 LaunchPad kit

ID del proveedor

De forma predeterminada, puedes usar uno de los VID asignados por CSA para realizar pruebas comerciales. Selecciona una de las siguientes opciones: 0xFFF1, 0xFFF2, 0xFFF3 y 0xFFF4.

Para usar un VID de producción y que tu integración pueda certificarse y lanzarse, primero debes que Google lo verifique para asegurarse de que lo haya emitido para usted la CSA.

Este VID debe implementarse en el firmware de tu dispositivo.

Un dispositivo Matter solo se puede vincular con Google Home en algunos casos de ID de proveedor y tipo de dispositivo.

  • No se puede usar un VID de prueba en un dispositivo de consumidores.
  • Tu VID de producción debe emitirlo el Connectivity Standards Alliance (Alliance). Google debes 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 prueba de campo, se crea un proyecto y una integración con el La combinación de VID y PID correspondiente debe crearse en el Developer Console. El usuario encargado El dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de pruebas de campo.
  • Los usuarios consumidores solo pueden utilizar su producto una vez que esté certificado por el Alliance
Tabla: ID del proveedor (VID) y tipo de dispositivo situaciones de vinculación
¿Qué tipos de usuarios pueden encargar en el 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 pruebas de campo)
Prueba No hay integración en Developer Console (no se puede certificar)
Prueba La integración existe en el Developer Console (no se puede certificado)
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 Certificado en la DCL Alliance; la integración no existen en Developer Console
Producción Certificado en la DCL Alliance y existe integración por la Developer Console

ID del producto

La información sobre el dispositivo se lee en la Clúster de Información básica de Matter. El ID del producto codificado en tu el firmware del dispositivo debe coincidir con el ID del producto de la integración de Matter en Play Console.

Características no compatibles

Sin embargo, algunos clústeres de Matter aún no están expuestos a los usuarios. el sistema podría 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:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

1 Consulta Interruptores de luz de encendido/apagado cómo afecta esto a los interruptores de luz de encendido/apagado.