Program dla deweloperów Google Home umożliwia producentom urządzeń łączenie ich inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy ścieżkę lokalnego przetwarzania akcji domów inteligentnych o możliwość dodawania urządzeń z funkcją Matter do konfiguracji za pomocą Google Home app (GHA) oraz sterowania nimi za pomocą Google Assistant, GHA lub inteligentnych wyświetlaczy, takich jak Google Nest Hub (2nd gen).
Ta dokumentacja opisuje, jak rozpocząć tworzenie i integrowanie platformy obsługiwanej przez Matter w ekosystemie Google Home.
Wyłączenia odpowiedzialności
W przypadku procedur opisanych w dokumentacji Matter:
- Zalecamy, aby na koncie używanym do programowania było połączone tylko 1 centrum z włączoną funkcją Matter na potrzeby testowania. Podczas testowania połączenie kilku koncentratorów z włączoną funkcją Matter, które są połączone jednocześnie lub z tą samą strukturą, może spowodować nieprzewidywalne działanie.
- Wszystkie procedury zakładają użycie maszyny z systemem Linux i Ubuntu 20.04 do kompilowania i programowania próbek Matter, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy korzystanie z Linuksa. W razie potrzeby w procedurach znajdują się instrukcje dotyczące Maca.
Jak tworzyć
Aby stworzyć urządzenie z funkcją Matter, które będzie integrować się z ekosystemem Google Home, musisz użyć płyty rozwojowej zgodnej z Matter i pakietu MatterSDK.
Najłatwiej zacząć od naszych ćwiczeń w Codelabs. Zalecamy wykonanie co najmniej jednego z tych laboratoriów programowania:
Następnie sprawdź na liście obsługiwanych urządzeń, czy to, co planujesz zintegrować, jest obsługiwane w ekosystemie Google Home. Następnie zapoznaj się z listą kontrolną dla deweloperów, aby poznać cały proces tworzenia od utworzenia projektu do jego opublikowania.
Obsługiwane urządzenia Lista kontrolna dla programistów
Definicje
W tej dokumentacji używamy tych terminów:
- Router graniczny
- Koncentrator, który implementuje ogólnego przeznaczenia ThreadBorder Router dla urządzeń z Thread.
- Centrum
- Obsługiwane urządzenie Google Nest, takie jak Google Nest Hub (2nd gen). Aby sterować urządzeniami z wsparciem Matter za pomocą innych urządzeń, takich jak Assistant, GHA czy inteligentne ekrany, wymagane jest centrum.
- Urządzenie z włączoną funkcją Matter
- Urządzenie lub płyta rozwojowa z flashowanym obrazem kompilacji z obsługą Matter lub przykładową aplikacją.
- Urządzenie mobilne
- Testowy telefon, który pomaga w sparowaniu. Obecnie jest to telefon Android.
Wymagania wstępne
Aby w pełni zintegrować urządzenie z usługą Matter z ekosystemem Google Home, deweloper musi mieć:
- Centrala Google z obsługą Thread, która będzie pełnić funkcję routera granicznego dla urządzeń obsługujących Thread oraz lokalną ścieżkę realizacji do kierowania intencji inteligentnego domu.
- Urządzenie mobilne (telefon testowy) spełniające minimalne wymagania:
- Android O (8.1, poziom interfejsu API 27 lub nowszy)
- iOS (w wersji 16.5 lub nowszej)
- Obsługa BLE
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z funkcją Matter.
- Urządzenie z obsługą Matter. To urządzenie powinno być jednym z Matter typów urządzeń obsługiwanych w ekosystemie Google Home. Może to być:
- własny produkt z oprogramowaniem Matter.
- Jedno z tych urządzeń Matter do przeprowadzania kompleksowej weryfikacji:
| Dostawca | Platforma | Pomoc na poziomie: Thread | Przewodnik |
|---|---|---|---|
| Buffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Testowanie OTA | |
| Nordic Semiconductor | nRF52840 DK | Testowanie OTA | |
| NXP | Zestaw programistyczny IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | EFR32MG24 Dev Kit | ||
| EFR32MG Zigbee i Thread Zestaw startowy | |||
| Telink | TLSR9518 | ||
| Texas Instruments | CC2652R7 LaunchPad Development Kit |
Identyfikator dostawcy
Domyślnie możesz używać jednego z identyfikatorów VID przydzielonych przez CSA na potrzeby testowania. Wybierz jedną z tych opcji:0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby móc korzystać z VID w wersji produkcyjnej, a tym samym uzyskać certyfikat i wdrożyć integrację, musisz najpierw poprosić Google o jego weryfikację. W ten sposób upewnisz się, że certyfikat został wydany przez CSA.
Ten identyfikator VID powinien być zaimplementowany w oprogramowaniu urządzenia.
Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych scenariuszach identyfikatora dostawcy i typu urządzenia.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
- Twój identyfikator VID musi zostać wydany przez Connectivity Standards Alliance (Alliance). Zanim będzie można użyć VID w Google Home Developer Console, Google musi zweryfikować, czy jesteś właścicielem tego identyfikatora. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji dla tego VID.
- Na potrzeby rozwoju i Field Trial należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który zleca użycie urządzenia, musi być członkiem projektu lub znajdować się na liście użytkowników Field Trial.
- Użytkownicy mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu Alliance.
Identyfikatory VID i PID mogą być używane tylko raz w przypadku jednej integracji. Jeśli chcesz użyć w integracji tego samego identyfikatora VID lub PID, musisz:
- Zmień integrację z użyciem identyfikatora VID lub PID na inny identyfikator VID lub PID.
- Usuń integrację za pomocą identyfikatora VID lub PID.
| Które typy użytkowników mogą włączyć urządzenie do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikatu VID i integracji z konsolą | Produkcyjna
(Klienci indywidualni) |
Wersja rozwojowa
(Dla deweloperów, użytkownicy Field Trial) |
| Test | Brak integracji w Developer Console (nie można uzyskać certyfikatu) | ||
| Test | Integracja jest dostępna w ramach Developer Console (nie można uzyskać certyfikatu) | ||
| Produkcja | Niecertyfikowana, integracja nie istnieje w Developer Console | ||
| Produkcja | Niecertyfikowana integracja dostępna w Developer Console | ||
| Produkcja | Certyfikowane w ramach Alliance DCL, integracja nie istnieje w Developer Console | ||
| Produkcja | Certyfikat w ramach Alliance DCL i istnienie integracji w Developer Console | ||
Identyfikator produktu
Informacje o urządzeniu są odczytywane z Matter klastra informacji podstawowych. Identyfikator produktu zakodowany w oprogramowaniu urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w Konsoli deweloperów.
Nieobsługiwane funkcje
Niektóre klastry Matter nie są jeszcze widoczne dla użytkowników, ale mogą być używane przez system. W większości przypadków oznacza to, że atrybuty udostępnione za pomocą tych klastrów nie są widoczne dla użytkowników:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Aby dowiedzieć się, jak to wpływa na przełączniki światła, przeczytaj artykuł Przełączniki światła.