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
Aby w pełni zintegrować urządzenie obsługujące Matter z ekosystemem Google Home, deweloper musi mieć:
- 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.
- 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
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) dla urządzenia obsługującego Matter.
- 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:
| 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.
| 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) |
| Test | Brak integracji w regionie Developer Console (nie można uzyskać certyfikatu) | ||
| Test | 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:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
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.