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 inteligentnego domu o możliwość dodawania urządzeń z funkcją Matter do konfiguracji za pomocą Google Home app (GHA) i 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 węzłów z włączoną funkcją Matter, które są połączone jednocześnie lub z tą samą strukturą, może skutkować nieprzewidywalnym działaniem.
- 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łytki 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 naszej 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 stworzenia projektu do jego opublikowania.
Obsługiwane urządzenia Lista kontrolna dla programistów
Definicje
W tej dokumentacji używamy tych terminów:
- Router graniczny
- Hub, który implementuje ogólny Thread BorderRouter dla urządzeń z Thread.
- Centrum
- Obsługiwane urządzenie Google Nest, np. Google Nest Hub (2nd gen). Aby sterować urządzeniami z wsparciem dla Matter za pomocą innych urządzeń, takich jak Assistant, GHA czy inteligentne wyświetlacze, wymagane jest centrum.
- Urządzenie obsługujące Matter
- Urządzenie lub płytka 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 z włączoną funkcją Matter.
- Jedno z tych urządzeń Matter do przeprowadzania kompleksowej weryfikacji:
| Dostawca | Platforma | Pomoc na poziomie: Thread | Przewodnik |
|---|---|---|---|
| Bouffalo 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 Starter Kit | |||
| 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 zweryfikuje, czy jesteś właścicielem tego identyfikatora. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji z tym VID.
- Na potrzeby rozwoju i testów w warunkach rzeczywistych należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który zleca wykonanie urządzenia, musi być członkiem projektu lub być uwzględniony na liście użytkowników testów terenowych.
- Konsumenci mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu Alliance.
Identyfikatory VID i PID można użyć tylko raz w ramach jednej integracji. Jeśli chcesz użyć w integracji tego samego identyfikatora VID lub PID, musisz:
- Zmień integrację z użyciem VID lub PID na inny VID lub PID.
- Usuń integrację, korzystając z identyfikatora VID lub PID.
| Które typy użytkowników mogą włączyć urządzenie do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikacji VID i integracji z konsolą | Produkcyjna
(Klienci indywidualni) |
Wersja rozwojowa
(Dla deweloperów i użytkowników testów polowych) |
| 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 | Certyfikat w 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 włączniki światła, przeczytaj artykuł Włączniki światła.