Pierwsze kroki ze standardem Matter

Program Google Home dla deweloperów umożliwia producentom urządzeń na swoich inteligentnych urządzeniach domowych z ekosystemem Google Home. Rozszerzamy Lokalna ścieżka realizacji akcji Smart Home Actions z możliwością dodania Urządzenia, na których można włączyć Matter, do konfiguracji za pomocą Google Home app (GHA) i kontroluj je za pomocą Google Assistant, GHA lub inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).

W tej dokumentacji opisano, jak rozpocząć tworzenie i integrowanie platforma obsługiwana przez Matter w ekosystemie Google Home.

Wyłączenia odpowiedzialności

Dotyczy procedur opisanych w dokumencie Matter dokumentacji, pamiętaj o tych kwestiach:

  • Zalecamy, aby konto używane do programowania miało tylko jeden Podłączono centrum z włączoną obsługą Matter na potrzeby testów. Wiele koncentratory z włączoną obsługą Matter połączone lub jest podłączony do tego samego obiektu podczas testowania, nieprzewidywalne zachowanie.
  • Wszystkie procedury zakładają użycie komputera z systemem Linux z systemem Ubuntu 20.04 tworzy i migam Matter przykładów, które zostały testowanych przez Google. Urządzenia z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. Typowe dla komputerów Mac są wymienione w procedurach.

Jak tworzyć

Aby utworzyć urządzenie z obsługą interfejsu Matter, które integruje się z ekosystemu Google Home, będziesz pracować z płytką deweloperską zgodną z Matter oraz z platformą Matter SDK.

Najłatwiej zacząć od ukończenia naszych ćwiczeń z programowania. Śr zalecamy wykonanie co najmniej jednego z tych ćwiczeń w Codelabs:

Następnie przejrzyj naszą listę obsługiwanych urządzeń, aby upewnić się, że plan integracji jest obsługiwany w ekosystemie Google Home. Następnie przeczytaj listę kontrolną dla programistów, aby poznać wszystkie potrzebne informacje. procesu programowania od momentu utworzenia projektu do jego uruchomienia.

Obsługiwane urządzenia Lista kontrolna dla programistów

Definicje

W tej dokumentacji używane są następujące terminy:

Router graniczny
Centrum stosujące uniwersalne obramowanie Thread Router dla urządzeń, które obsługują Thread.
Centrum
Obsługiwane urządzenie z systemem Google Nest, takie jak Google Nest Hub (2nd gen) Do sterowania urządzeniami z funkcją Matter wymagane jest centrum na innych platformach, takich jak Assistant, GHA i inteligentnych ekranów.
Urządzenie z obsługą Matter
Urządzenie lub płytę deweloperską z zainstalowaną aplikacją Kompilacja lub przykładowa aplikacja z obsługą Matter.
Urządzenie mobilne
Telefon testowy użyty do sparowania. Obecnie jest to Telefon Android.

Wymagania wstępne

Zalecane rozszerzenia IDE dla Matter (programowanie)

Aby w pełni zintegrować urządzenie z obsługą Matter ekosystemu Google Home, deweloper musi mieć:

  1. Centrum Google z obsługą Thread jako router graniczny w przypadku urządzeń obsługujących Thread, a także jako router lokalny ścieżka realizacji na potrzeby kierowania intencji inteligentnego domu.
  2. Urządzenie mobilne (telefon testowy), które spełnia minimalne wymagania:
    • Android O (8.1, poziom API 27 lub nowszy)
    • iOS (wersja 16.5 lub nowsza)
    • Obsługa BLE
  3. identyfikator dostawcy (VID) i identyfikator produktu (PID) dla Urządzenie z obsługą Matter.
  4. Urządzenie z obsługą Matter. Na tym urządzeniu powinno być: Matter typów urządzeń obsługiwanych ekosystemu Google Home, czyli:
      .
    • Twój produkt z oprogramowaniem, które obsługuje Matter.
    • Jedno z tych Matter urządzeń do użycia w: kompleksowa weryfikacja:
Tabela: Matter przykłady od dostawców krzemu
Dostawca Platforma Pomoc na poziomie: Thread Przewodnik
Laboratorium Bouffalo BL602
BL702
Espressif ESP32 Testy OTA
Półprzewodniki nordyckie nRF52840 DK Testy OTA
NXP Opracowywanie przy użyciu IOTZTB-DK006 pakiet
Realtek Ameba serii D
Laboratoria Krzemowe Zestaw deweloperski EFR32MG24
EFR32MG Zigbee and Thread Zestaw startowy
Telink TLSR9518
Instrumenty teksańskie Opracowanie rozwiązania CC2652R7 LaunchPad pakiet

Identyfikator dostawcy

Domyślnie do testowania możesz używać jednego z identyfikatorów VID przydzielonych przez CSA w celach informacyjnych. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Aby użyć produkcyjnego identyfikatora VID w celu uzyskania certyfikatu i wprowadzenia integracji, musisz najpierw zostały zweryfikowane przez Google w celu potwierdzenia, że zostały Ci wydane przez CSA.

Identyfikator VID powinien być zaimplementowany w oprogramowaniu sprzętowym urządzenia.

Urządzenie Matter można sparować tylko z Google Home w określonych scenariuszach związanych z identyfikatorem dostawcy i typem urządzenia.

  • Testowego identyfikatora VID nie można używać na urządzeniu konsumenckim.
  • Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Google zanim użyjesz tego identyfikatora VID w usłudze Google Home Developer Console, potwierdź, że jesteś jego właścicielem. Gdy to zrobisz, będziesz mieć możliwość tworzenia dla danego identyfikatora VID.
  • Do celów programistycznych i do testów funkcjonalnych projekt oraz integracja odpowiednią kombinację VID i PID należy utworzyć w Developer Console. Uruchamiam usługę dla użytkownika urządzenie musi być członkiem projektu lub znajdować się na liście użytkowników w ramach testów funkcjonalnych.
  • Użytkownicy mogą korzystać z Twojego produktu dopiero wtedy, gdy uzyska on certyfikat Alliance
Tabela: identyfikator dostawcy (VID) i typ urządzenia scenariusze parowania
Jakie typy użytkowników mogą zlecić z ekosystemem Google Home?
Typ VID Stan certyfikacji VID i integracji konsoli Produkcyjna
(użytkownicy indywidualni)
Dla programistów
(programiści, użytkownicy korzystający z testów funkcjonalnych)
Test Brak integracji w: Developer Console (nie można uzyskać certyfikatu)
Test Integracja istnieje w: Developer Console (nie można )
Produkcja Brak certyfikatu, integracja nie istnieje w: Developer Console
Produkcja Brak certyfikatu, ale integracja istnieje w: Developer Console
Produkcja Ma certyfikat DCL w Alliance. Integracja nie istnieją w Developer Console
Produkcja Ma certyfikat DCL w Alliance, istnieje możliwość integracji Developer Console

Identyfikator produktu

Informacje o urządzeniu są odczytywane z Matter – klaster podstawowych informacji. Identyfikator produktu zakodowany w Oprogramowanie urządzenia musi być zgodne z identyfikatorem produktu w ramach integracji z Matter w Konsoli programisty.

Nieobsługiwane funkcje

Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników których może używać system. W większości przypadków oznacza to, że atrybuty widoczne w tych klastrach nie są widoczne dla użytkowników:

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 Patrz Włączniki światła do włączania i wyłączania światła aby dowiedzieć się, jak wpływa to na przełączniki światła.