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 Home Home, dodając możliwość dodawania Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the Google Nest Hub (2nd gen) .

Ta dokumentacja opisuje, jak zacząć tworzyć i integrować platformę obsługiwaną przez Matter w ekosystemie Google Home.

Wyłączenia odpowiedzialności

Korzystając z procedur opisanych w tej wersji przedpremierowej dla deweloperów aplikacji Matter, pamiętaj 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 testów może skutkować nieprzewidzianym zachowaniem.
  • Wszystkie procedury zakładają użycie komputera z systemem Linux 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ługiwana jest tylko wersja GHA aplikacji na Androida.

Definicje

W tej dokumentacji wykorzystano następujące terminy:

Router graniczny
Centrum wdrażające zwykły cel Thread Border Router for Thread-enabled devices.
Centrum
Obsługiwany obiekt Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
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 Android phone.

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. Urządzenie powinno być jednym z typów Matter obsługiwanych obecnie w ekosystemie Google Home. Może to być:
    • Twój własny produkt z oprogramowaniem układowym z obsługą Matter.
    • Platforma deweloperska obsługującej platformę dostawcy, która może służyć jako urządzenie do kompleksowej weryfikacji z obsługą Matter. 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ć w ekosystemie 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 usłudze 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) Nie dotyczy Nie dotyczy
Test Data rejestracji: Developer Console (brak certyfikatu) Nie dotyczy
Produkcja Nie posiada certyfikatu, nie zarejestrowano Nie dotyczy
Produkcja Nie posiada certyfikatu, jest zarejestrowany w Developer Console
Produkcja Nie posiada certyfikatu DCLA w CSA Nie dotyczy
Produkcja Masz certyfikat w programie DCL CSA 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 klastrów, które nie są widoczne 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 .