Pierwsze kroki z Sprawą

Program Google Home dla deweloperów pozwala producentom urządzeń połączyć swoje inteligentne urządzenia domowe z ekosystemem Google Home. Rozwijamy lokalną ścieżkę realizacji akcji dotyczących inteligentnych akcji w domu o możliwość dodawania urządzeń obsługujących Matter do konfiguracji za pomocą Google Home app (GHA) i sterowania nimi za pomocą Google Assistant lub GHA albo inteligentnych ekranów takich jak Google Nest Hub (2nd gen).

Z tej dokumentacji dowiesz się, jak zacząć tworzyć i integrować platformę zgodną z Matter w ekosystemie Google Home.

Wyłączenia odpowiedzialności

W przypadku procedur opisanych w dokumentacji Matter pamiętaj o tych kwestiach:

  • Zalecamy, aby konto używane do programowania ma połączone tylko 1 centrum z włączoną obsługą Matter. Wiele centrów z włączoną obsługą Matter połączonych jednocześnie lub połączonych z tą samą strukturą podczas testowania może powodować nieprzewidywalne zachowanie.
  • Wszystkie procedury zakładają użycie komputera z systemem Linux z systemem Ubuntu 20.04 do skompilowania i przeskanowania przykładów Matter, które zostały przetestowane przez Google. Mimo że komputery z systemem macOS są obsługiwane, zalecamy korzystanie z Linuksa. W razie potrzeby instrukcje dla komputerów Mac są opisane w odpowiednich procedurach.

Jak tworzyć

Aby utworzyć urządzenie obsługujące Matter, które integruje się z ekosystemem Google Home, musisz wykorzystać płytę programistyczną zgodną z Matter i pakiet SDK Matter.

Najłatwiej rozpocząć od wykonania naszych ćwiczeń z programowania. Zalecamy wykonanie co najmniej jednego z tych ćwiczeń z programowania:

Następnie przejrzyj listę obsługiwanych urządzeń, aby mieć pewność, że wszystko, co chcesz zintegrować, jest obsługiwane w ekosystemie Google Home. Następnie przeczytaj listę kontrolną dla programistów, aby zrozumieć cały proces programowania od jego utworzenia po uruchomienie.

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

Definicje

W tej dokumentacji używamy tych terminów:

Router graniczny
Centrum, które implementuje ogólny router graniczny Thread dla urządzeń obsługujących Thread.
Centrum
Obsługiwane urządzenie z systemem Google Nest, takie jak Google Nest Hub (2nd gen). Centrum jest wymagane do sterowania urządzeniami obsługującymi Matter za pomocą innych platform, takich jak Assistant, GHA i inteligentne ekrany.
Urządzenie z obsługą Matter
urządzenie lub płytka programistyczna z zainstalowaną kompilacją lub przykładową aplikacją z włączoną obsługą Matter.
Urządzenie mobilne
Telefon testowy używany do sparowania. Obecnie jest to telefon Android.

Wymagania wstępne

Zalecane rozszerzenia IDE do programowania Matter

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

  1. Centrum Google z obsługą Thread, które będzie pełnić zarówno funkcję routera granicznego dla urządzeń obsługujących Thread, jak i lokalną ścieżkę realizacji kierowania intencji inteligentnego domu.
  2. Urządzenie mobilne (telefon testowy) spełniające 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ądzenia obsługującego Matter.
  4. Urządzenie obsługujące usługę Matter. Urządzenie powinno należeć do Matter typów urządzeń obsługiwanych obecnie w ekosystemie Google Home. Może to być:
    • Twój produkt z oprogramowaniem z obsługą Matter.
    • Płytka deweloperska obsługiwanej platformy dostawcy, która może służyć jako urządzenie obsługujące Matter na potrzeby kompleksowej weryfikacji. Obsługiwane są te platformy:
Tabela: Matter przykłady od dostawców silikonu
Dostawca Platforma Przewodniki Pomoc na poziomie: Thread
Laboratorium Bouffalo BL602 Krótkie wprowadzenie
BL702 Krótkie wprowadzenie
Espressif ESP32 Krótki przewodnik
Testy OTA
Półprzewodniki skandynawskie nRF52840 DK Krótki przewodnik
Testy OTA
NXP Pakiet deweloperski IOTZTB-DK006 Krótkie wprowadzenie
Realtek Seria Ameba D Krótkie wprowadzenie
Silicon Labs Zestaw dla programistów EFR32MG24 Krótkie wprowadzenie
EFR32MG Zigbee i Thread Starter Kit Krótkie wprowadzenie
Telink, TLSR9518 Krótkie wprowadzenie
Instrumenty teksańskie Zestaw CC2652R7 LaunchPad Krótkie wprowadzenie

Identyfikator dostawcy

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

Aby użyć produkcyjnego identyfikatora VID w celu uzyskania certyfikatu i uruchomienia integracji, musisz najpierw zweryfikować go przez Google, aby mieć pewność, że został Ci on przyznany przez CSA.

Identyfikator VID powinien być zaimplementowany w oprogramowaniu układowym urządzenia.

Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych przypadkach identyfikatora dostawcy i typów urządzeń.

  • Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
  • Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Google sprawdzi, czy jesteś właścicielem tego identyfikatora VID, zanim będzie można go użyć w Google Home Developer Console. Następnie możesz utworzyć integracje dla tego identyfikatora VID.
  • Na potrzeby programowania i testów funkcjonalnych należy utworzyć w Developer Console projekt i integrację z odpowiednią kombinacją identyfikatorów VID i PID. Użytkownik, który zleca korzystanie z urządzenia, musi być uczestnikiem projektu lub wpisać się na listę użytkowników korzystających z testów praktycznych.
  • Klienci indywidualni mogą używać Twojego produktu tylko wtedy, gdy uzyskał on certyfikat Alliance.
Tabela: scenariusze parowania dostawcy (VID) i typu urządzenia
Którzy użytkownicy mogą zamawiać urządzenia do ekosystemu Google Home?
Typ VID Stan certyfikacji VID i integracji z konsolą Produkcyjna
(Użytkownicy indywidualni)
Dla programistów
(deweloperzy i użytkownicy testów funkcjonalnych)
Test Brak integracji w: Developer Console (nie można uzyskać certyfikatu)
Test Integracja znajduje się w regionie Developer Console (nie można uzyskać certyfikatu)
Produkcyjny Brak certyfikatu, brak integracji w: Developer Console
Produkcyjny Brak certyfikatu, integracja istnieje w: Developer Console
Produkcyjny Certyfikowana na liście DCL Alliance, integracja nie występuje w: Developer Console
Produkcyjny Certyfikat na liście DCL Alliance, a integracja znajduje się w: Developer Console

Identyfikator produktu

Informacje o urządzeniu są odczytywane z klastra podstawowych informacji Matter. Identyfikator produktu zakodowany w oprogramowaniu układowym urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w Konsoli programisty.

Nieobsługiwane funkcje

Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników, ale mogą być używane przez system. W większości przypadków oznacza to, że atrybuty udostępniane przez te klastry nie będą 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. Informacje o tym, jak ta funkcja wpływa na przełączniki światła do włączania i wyłączania światła, znajdziesz w artykule na temat przełączników światła do włączania i wyłączania.