Program Google Home dla deweloperów umożliwia producentom urządzeń łączenie ich inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy lokalną ścieżkę realizacji działań w ramach inteligentnych działań domowych o możliwość dodawania urządzeń z obsługą Matter na potrzeby konfiguracji za pomocą Google Home app (GHA) i sterowania nimi za pomocą Google Assistant lub GHA albo inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).
Z tej dokumentacji dowiesz się, jak zacząć tworzyć i integrować platformę obsługiwaną przez Matter z ekosystemem Google Home.
Wyłączenia odpowiedzialności
W związku z procedurami opisanymi w dokumentacji Matter pamiętaj o następujących kwestiach:
- Zalecamy, aby do konta używanego do programowania miało podłączone tylko 1 centrum z włączoną obsługą Matter podłączone na potrzeby testów. Kilka 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 maszyny z systemem Linux z systemem Ubuntu 20.04 do kompilowania i flashowania przykładów Matter, które zostały przetestowane przez Google. Urządzenia z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W razie potrzeby instrukcje dla komputerów Mac są odpowiednio przywoływane w procedurach.
Jak tworzyć
Aby utworzyć urządzenie obsługujące Matter, które integruje się z ekosystemem Google Home, będziesz korzystać z płytki programistycznej zgodnej z Matter i pakietu SDK Matter.
Najłatwiej zacząć od ukończenia naszych ćwiczeń z programowania. Zalecamy wykonanie co najmniej jednego z tych ćwiczeń w Codelabs:
Następnie przejrzyj naszą listę obsługiwanych urządzeń, aby mieć pewność, że urządzenia, które planujesz zintegrować, są obsługiwane w ekosystemie Google Home. Następnie przeczytaj listę kontrolną dla programistów, aby zapoznać się z całym procesem programowania od momentu utworzenia projektu do jego uruchomienia.
Obsługiwane urządzenia Lista kontrolna dla programistów
Definicje
W tej dokumentacji używane są następujące terminy:
- Router graniczny
- Centrum wdrażające uniwersalny router graniczny Thread na urządzeniach z obsługą Thread.
- Regularne
- Obsługiwane urządzenie z systemem Google Nest, np. Google Nest Hub (2nd gen). Do sterowania urządzeniami z funkcją Matter za pomocą centrum konieczne jest korzystanie z innych platform, takich jak Assistant, GHA czy inteligentne ekrany.
- Urządzenie z obsługą Matter
- Urządzenie lub płytę deweloperską z kompilacją lub przykładową aplikacją obsługującą Matter.
- Urządzenie mobilne
- Telefon testowy użyty do sparowania. Obecnie Twój telefon to Android.
Wymagania wstępne
Aby w pełni zintegrować urządzenie, które obsługuje Matter, z ekosystemem Google Home, deweloper musi mieć:
- centrum Google z obsługą Thread, które służy zarówno jako router brzegowy w przypadku urządzeń obsługujących Thread, jak i lokalna ścieżka realizacji do kierowania intencji Smart Home.
- Urządzenie mobilne (telefon testowy), które spełnia 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) urządzenia obsługującego Matter.
- Urządzenie z obsługą Matter. To urządzenie powinno należeć do Matter typów urządzeń obsługiwanych w ekosystemie Google Home. Może to być:
- Twój produkt z oprogramowaniem, które obsługuje Matter.
- Jedno z tych urządzeń Matter do użycia do kompleksowej weryfikacji:
Dostawca | Platforma | Pomoc na poziomie: Thread | Przewodnik |
---|---|---|---|
Laboratorium Bouffalo | BL602 | ||
BL702 | |||
Espressif | ESP32 | Testy OTA | |
Półprzewodniki nordyckie | nRF52840 DK | Testy OTA | |
NXP, | Pakiet dla programistów IOTZTB-DK006 | ||
Realtek | Ameba serii D | ||
Laboratoria Krzemowe | Zestaw deweloperski EFR32MG24 | ||
EFR32MG Zigbee and Thread Starter Kit | |||
Telink | TLSR9518 | ||
Instrumenty teksańskie | Zestaw dla programistów CC2652R7 LaunchPad |
Identyfikator dostawcy
Domyślnie na potrzeby testowania 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 w celu uzyskania certyfikatu i uruchomienia integracji, musisz najpierw zweryfikować go przez Google w celu potwierdzenia, że został Ci wydany przez CSA.
Identyfikator VID powinien być zaimplementowany w oprogramowaniu sprzętowym urządzenia.
Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych sytuacjach dotyczących identyfikatora dostawcy i typu urządzenia.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenckim.
- Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Google sprawdzi, czy jesteś właścicielem danego identyfikatora VID, zanim będzie można go używać w usłudze Google Home Developer Console. Będzie można wtedy utworzyć integracje dla tego identyfikatora VID.
- Do celów programistycznych i do testów funkcjonalnych należy utworzyć w Developer Console projekt oraz integrację z odpowiednią kombinacją identyfikatorów VID i PID. Użytkownik uruchamiający urządzenie musi być członkiem projektu lub znajdować się na liście użytkowników korzystających z testów funkcjonalnych.
- Konsumenci mogą używać Twojego produktu tylko wtedy, gdy uzyska on certyfikat Alliance.
Którzy użytkownicy mogą zlecić urządzenie urządzeniu w ekosystemie Google Home? | |||
---|---|---|---|
Typ VID | Stan certyfikacji VID i integracji konsoli | Produkcyjna
(użytkownicy indywidualni) |
Dla programistów
(deweloperzy, użytkownicy korzystający z testów funkcjonalnych) |
Testowanie | Brak integracji w: Developer Console (nie można uzyskać certyfikatu) | ||
Testowanie | Integracja istnieje w: Developer Console (nie może mieć certyfikatu) | ||
Produkcja | Brak certyfikatu, integracja nie istnieje w: Developer Console | ||
Produkcja | Brak certyfikatu, ale integracja istnieje w: Developer Console | ||
Produkcja | Integracja nie istnieje w Developer Console, jeśli ma certyfikat DCL Alliance | ||
Produkcja | Ma certyfikat 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 odpowiadać identyfikatorowi produktu integracji z Matter w Konsoli Play.
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 ujawniane przez te klastry nie są widoczne dla użytkowników:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Aby dowiedzieć się, jak wpływa to na przełączniki światła, przeczytaj artykuł dotyczący przełączników światła.