Pierwsze kroki z Sprawą

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wersja dla programistów – wersja testowa

Program Google Home Developer pozwala producentom urządzeń łączyć swoje inteligentne urządzenia domowe z ekosystemem Google Home. Rozszerzamy ścieżkę realizacji lokalnej kampanii inteligentnej w aplikacji Smart Home. Dodamy do niej możliwość dodawania urządzeń z obsługą Matter za pomocą Google Home app (GHA) na urządzeniach z Androidem i sterowania nimi za pomocą Google Assistant, GHA lub inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).

Ta dokumentacja opisuje, jak rozpocząć tworzenie i integrowanie platformy Matter w ekosystemie Google Home.

Wyłączenia odpowiedzialności

W odniesieniu do procedur opisanych w tej wersji przedpremierowej dla programistów Matter należy pamiętać o tych kwestiach:

  • Konto używane do programowania powinno mieć połączone tylko 1 centrum z włączoną obsługą Matter. Wiele centrów z włączoną obsługą Matter połączonych w tym samym czasie lub połączonych z tą samą strukturą podczas testowania może skutkować nieprzewidzianym zachowaniem.
  • Wszystkie procedury zakładają użycie komputera z systemem Linux z systemem Ubuntu 20.04 do tworzenia i migania próbek Matter, które zostały przetestowane przez Google. Systemy MacOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W razie potrzeby instrukcje są charakterystyczne dla komputerów Mac.
  • Obsługiwane są tylko wersje GHA systemu Android.

Definicje

W tej dokumentacji wykorzystano następujące terminy:

Router graniczny
Centrum, które implementuje zwykły trasy graniczne Thread dla urządzeń z włączoną obsługą Thread.
Centrum
Obsługiwane urządzenie Google Nest, na przykład Google Nest Hub (2nd gen). Centrum musi być używane do sterowania urządzeniami obsługującymi Matter za pomocą innych platform, takich jak Assistant, GHA i inteligentnych ekranów.
Urządzenie z obsługą Matter
Urządzenie lub płyta deweloperska, która została zainstalowana jako przykładowa aplikacja z włączoną funkcją Matter.
Urządzenie mobilne
Telefon testowy, który ułatwił parowanie. Obecnie to telefon w systemie Android.

Wymagania wstępne

Zalecane rozszerzenia IDE do programowania w zakresie Matter

Aby w pełni zintegrować urządzenie z systemem Matter z ekosystemem Google Home, deweloper musi:

  1. Węzeł Google z obsługą wątków jako router graniczny na urządzeniach z wątkami oraz jako lokalna ścieżka realizacji dla intencji inteligentnego domu.
  2. urządzenie mobilne (telefon testowy), które spełnia minimalne wymagania:
    • Android O (8.1, poziom API 27) lub nowszy (w przyszłości zostanie dodana obsługa iOS)
    • Możliwości BLE
  3. Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z włączoną obsługą Matter.
  4. Urządzenie z obsługą Matter. To urządzenie należy do typów urządzeń Matter obsługiwanych obecnie w ekosystemie Google Home. Może to być:
    • Twój własny produkt z oprogramowaniem układowym obsługującym Matter.
    • Tablica deweloperska obsługiwanej platformy dostawcy, która może służyć jako urządzenie z Matter do kompleksowej weryfikacji. Obsługiwane są te platformy:
Tabela: Matter przykłady od dostawców Silicon
Dostawca Platforma Przewodniki Pomoc na poziomie: Thread
Laboratorium Bouffalo BL602 Krótki przewodnik
BL702 Krótki przewodnik
Espressif ESP32 Szybki start
Testy OTA
Półwysep nordycki nRF52840 DK Szybki start
Testy OTA
NXP, Zestaw dla programistów IOTZTB-DK006 Krótki przewodnik
Realtek Seria Ameba D Krótki przewodnik
Laboratorium Silicon Zestaw startowy EFR32MG Zigbee i Thread Krótki przewodnik
Zestaw dla programistów EFR32MG24 Krótki przewodnik
Telink TLSR9518 Krótki przewodnik

Identyfikator dostawcy

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

Aby korzystać z identyfikatora produkcyjnego, co umożliwi certyfikację i uruchomienie integracji, Google musi najpierw ją zweryfikować, aby mieć pewność, że została Ci udostępniona przez CSA.

Ten identyfikator VID powinien być wdrożony w oprogramowaniu urządzenia.

Urządzenie Matter można sparować z ekosystemem Google Home tylko w niektórych scenariuszach z identyfikatorem dostawcy i rodzajem urządzenia.

  • Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
  • Aby można było sparować urządzenie produkcyjne (konsumenckie), musi ono mieć certyfikat DCL w CSA.
  • Na potrzeby programowania i testowania urządzeń urządzenie musi być zarejestrowane w systemie Google Home Developer Console.
Tabela: scenariusze identyfikatorów dostawców (VID) i typów urządzeń
Jakiego typu użytkownicy mogą zlecić urządzeniu korzystanie z ekosystemu Google Home?
Typ VID Stan certyfikacji i rejestracji VID Produkcyjna
(Użytkownicy)
Rozwój
(Deweloperzy, użytkownicy wersji próbnej)
Test Niezarejestrowany (nie można uzyskać certyfikatu)
Test Reklamodawca zarejestrowany w: Developer Console (nie można uzyskać certyfikatu)
Produkcja Nie posiada certyfikatu, nie zarejestrowano
Produkcja Brak certyfikatu, zarejestrowany w Developer Console
Produkcja Nie posiada certyfikatu DCLA w CSA
Produkcja Masz certyfikat w programie DCLA i został zarejestrowany w: Developer Console

Identyfikator produktu

Informacje o urządzeniu są odczytywane za pomocą klastrów z deskryptorami spraw, a nie identyfikatora produktu. W trakcie tworzenia możesz przypisać dowolny identyfikator produktu zgodnie z systemem numeracyjnym Twojej firmy (o ile jest zgodny z identyfikatorem produktu w ramach integracji Matter, jeśli został podany).

Nieobsługiwane funkcje

Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników, chociaż mogą być używane przez system. W większości przypadków oznacza to, że atrybuty ujawnione w tych klastrach nie będą widoczne dla użytkowników:

Tabela: Matter klastry, które nie są dostępne dla użytkowników w ekosystemie Google Home
Typ klastra Klastry
Core
  • Powiązanie
  • Etykieta
  • Stała etykieta
  • Etykieta użytkownika
  • Działania
  • Klucz grupy
  • Konfiguracja lokalizacji
  • Lokalizacja formatu czasu
  • Lokalizacja jednostki
  • Konfiguracja źródła zasilania
  • Źródło zasilania
  • Klastry diagnostyczne (Dzienniki diagnostyczne, Diagnostyka ogólna, Oprogramowanie, Diagnostyka sieci, Diagnostyka sieci, Diagnostyka sieci Wi-Fi, Diagnostyka sieci Ethernet)
  • Synchronizacja czasu
  • Wybór trybu
Aplikacja
  • Grupy i sceny nie są obsługiwane bezpośrednio. Odpowiednie funkcje są dostępne w ramach.
  • Wszystkie klastry multimediów. Równoważne funkcje są dostępne w Google Cast.