Pierwsze kroki ze standardem Matter

Program Google Home dla deweloperów umożliwia producentom urządzeń połączenie swoich inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy lokalną ścieżkę realizacji działań inteligentnych w domu o możliwość dodawania urządzeń obsługujących Matter na potrzeby konfiguracji za pomocą Google Home app (GHA) i sterowania nimi za pomocą Google Assistant lub GHA bądź inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).

Z tej dokumentacji dowiesz się, jak 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 przesłania próbek kodu Matter, które zostały przetestowane przez Google. Mimo że komputery z systemem macOS są obsługiwane, zalecamy korzystanie z systemu Linux. W razie potrzeby instrukcje dla komputerów Mac są wymienione w odpowiednich procedurach.

Jak tworzyć

Aby zbudować Matterurządzenie zgodne z ekosystemem Google Home, będziemy skorzystać z Matter zgodnej płyty programistycznej i Matter pakietu SDK.

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

Potem sprawdź listę obsługiwanych urządzeń, aby mieć pewność, że elementy, które chcesz zintegrować, są obsługiwane w ekosystemie Google Home. Następnie zapoznaj się z listą kontrolną dla programistów, aby zrozumieć cały proces programowania od jego utworzenia do uruchomienia.

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

Definicje

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

Router graniczny
Centrum, które implementuje ogólny router graniczny Thread dla urządzeń obsługujących platformę Thread.
Regularne
Obsługiwane urządzenie 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 włączoną obsługą Matter
Urządzenie lub tablica programistyczna z zainstalowaną do nich kompilacją lub przykładową aplikacją z włączoną obsługą Matter.
Urządzenie mobilne
Telefon testowy, którego użyto do sparowania. Obecnie ten telefon to Android.

Wymagania wstępne

Zalecane rozszerzenia IDE na potrzeby 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 pełniące rolę routera granicznego w przypadku urządzeń obsługujących Thread oraz lokalnej ścieżki realizacji do 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, które obsługuje Matter. Należy ono do Matter typów urządzeń obsługiwanych w ekosystemie Google Home i może:
    • Twój produkt z oprogramowaniem z obsługą Matter.
    • Jedno z tych urządzeń z systemem Matter, które służy do pełnej weryfikacji:
Tabela: Matter przykłady od dostawców krzemu
Dostawca Platforma Pomoc na poziomie: Thread Przewodnik
Laboratorium Bouffalo BL602
BL702
Espressif ESP32 Testy OTA
Skandynawskie półprzewodniki nRF52840 DK Testy OTA
NXP Pakiet deweloperski IOTZTB-DK006
Realtek Seria Amemba D
Silicon Labs Zestaw dla programistów EFR32MG24
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9518
Instrumenty teksańskie Pakiet deweloperski CC2652R7 LaunchPad

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, aby uzyskać certyfikat i uruchomić integrację, musisz najpierw zweryfikować go przez Google w celu sprawdzenia, czy został Ci on przyznany przez CSA.

Identyfikator VID powinien być wdrożony w oprogramowaniu układowym urządzenia.

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

  • Testowego identyfikatora VID nie można używać w urządzeniu konsumenckim.
  • Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Zanim użyjesz tego identyfikatora VID w Google Home Developer Console, Google sprawdzi, czy jesteś jego właścicielem. Następnie możesz utworzyć integracje dla tego identyfikatora VID.
  • Na potrzeby programowania i testów funkcjonalnych należy utworzyć projekt i integrację z odpowiednią kombinacją identyfikatorów VID i PID w Developer Console. Użytkownik, który oddaje urządzenie, musi być uczestnikiem projektu lub znajdować się na liście użytkowników biorących udział w testach funkcjonalnych.
  • Klienci indywidualni mogą korzystać z Twojej usługi dopiero wtedy, gdy uzyska ona certyfikat Alliance.
Tabela: scenariusze parowania dostawcy (VID) i typu urządzenia
Którzy użytkownicy mogą zlecić urządzenie w ekosystemie Google Home?
Typ VID Stan certyfikacji VID i integracji z konsolą Produkcyjna
(Użytkownicy indywidualni)
Dla programistów
(deweloperzy, użytkownicy testów funkcjonalnych)
testowanie, Brak integracji w regionie Developer Console (nie można uzyskać certyfikatu)
testowanie, Integracja znajduje się w: Developer Console (nie można uzyskać certyfikatu)
Produkcyjny Brak certyfikatu, integracja nie występuje w: Developer Console
Produkcyjny Brak certyfikatu, integracja istnieje w: Developer Console
Produkcyjny Potwierdzono na DCL Alliance, integracja nie istnieje 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 informacji podstawowych Matter. Identyfikator produktu zakodowany w oprogramowaniu układowym urządzenia musi być zgodny z identyfikatorem produktu w 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 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 Zobacz przełączniki światła do włączania i wyłączania światła, aby dowiedzieć się, jak ta funkcja wpływa na przełączniki światła.