Program dla deweloperów Google Home umożliwia producentom urządzeń łączenie inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy lokalną ścieżkę realizacji działań inteligentnego domu o możliwość dodawania Matter-enabled devices, które można skonfigurować za pomocą Google Home app (GHA) i sterować nimi za pomocą Google Assistant, GHA, lub inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).
Z tej dokumentacji dowiesz się, jak zacząć tworzyć i integrować platformę obsługującą standard Matter- w ekosystemie Google Home.
Wyłączenia odpowiedzialności
W przypadku procedur opisanych w Matter dokumentacji pamiętaj o tych kwestiach:
- Zalecamy, aby na potrzeby testowania do konta używanego do tworzenia oprogramowania było podłączone tylko 1 centrum obsługujące standard Matter. Podłączenie kilku centrów obsługujących standard Matter jednocześnie lub podłączenie ich do tej samej struktury podczas testowania może spowodować nieprzewidywalne działanie.Matter
- Wszystkie procedury zakładają użycie komputera z systemem Linux i Ubuntu 20.04 do tworzenia i flashowania Matter próbek, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W razie potrzeby w procedurach podajemy instrukcje dotyczące komputerów Mac.
Sposób tworzenia
Aby utworzyć urządzenie obsługujące standard Matter, które integruje się z ekosystemem Google Home, musisz użyć płytki deweloperskiej zgodnej ze standardem Matter i pakietu Matter SDK.
Najłatwiej jest zacząć od zapoznania się z naszymi ćwiczeniami z programowania. Zalecamy wykonanie co najmniej 1 z tych ćwiczeń:
Następnie sprawdź listę obsługiwanych urządzeń , aby upewnić się, że to, co chcesz zintegrować, jest obsługiwane w ekosystemie Google Home. Potem zapoznaj się z listą kontrolną dla deweloperów , aby poznać cały proces tworzenia oprogramowania od utworzenia projektu do jego uruchomienia.
Obsługiwane urządzenia Lista kontrolna dla deweloperów
Definicje
W tej dokumentacji używamy tych terminów:
- Router graniczny
- Centrum, które implementuje router graniczny Thread Border do zwykłych obciążeń dla urządzeń obsługujących standard Thread.
- Centrum
- Obsługiwane urządzenie Google Nest, takie jak Google Nest Hub (2nd gen). Centrum jest wymagane do sterowania Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
- Urządzenie obsługujące standard Matter
- Urządzenie lub płytka deweloperska, na której zainstalowano kompilację lub przykładową aplikację obsługującą standard Matter lub przykładową aplikację.
- Urządzenie mobilne
- Telefon testowy używany do parowania. Obecnie jest to telefon z Android.
Wymagania wstępne
Aby w pełni zintegrować urządzenie obsługujące standard Matter z ekosystemem Google Home, deweloper musi mieć:
- Centrum Google z obsługą standardu Thread które będzie pełnić funkcję routera granicznego dla urządzeń obsługujących standard 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 27 interfejsu API lub nowszy)
- iOS (wersja 16.5 lub nowsza)
- obsługa BLE.
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia obsługującego standard Matter Matter.
- Urządzenie obsługujące standard Matter. To urządzenie powinno być jednym z
typów urządzeń Matterobsługujących standard Matter w
ekosystemie Google Home. Może to być:
- Twój własny produkt z Matter-enabled firmware.
- Jedno z tych urządzeń Matter, które można użyć do weryfikacji kompleksowej:
| Dostawca | Platforma | Thread Obsługa | Przewodnik |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Testowanie OTA | |
| Nordic Semiconductor | nRF52840 DK | Testowanie OTA | |
| NXP | Zestaw deweloperski IOTZTB-DK006 kit | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | Zestaw deweloperski EFR32MG24 | ||
| Zestaw startowy EFR32MG Zigbee i Thread | |||
| Telink | TLSR9528 | Przewodnik dla deweloperów Telink Matter | |
| Texas Instruments | Zestaw deweloperski CC2652R7 LaunchPad kit |
Identyfikator dostawcy
Domyślnie możesz użyć jednego z identyfikatorów VID przydzielonych przez Alliance na potrzeby
testowania. Wybierz jeden z tych identyfikatorów:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby użyć identyfikatora VID w wersji produkcyjnej, aby można było uzyskać certyfikat i uruchomić integrację, musisz najpierw zweryfikować go w Google, aby upewnić się, że został wydany przez Alliance.
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 dotyczących identyfikatora dostawcy i typu urządzenia.
- Identyfikatora VID w wersji testowej nie można używać w urządzeniu konsumenckim.
- Identyfikator VID w wersji produkcyjnej musi zostać wydany przez Connectivity Standards Alliance (Alliance). Zanim będzie można użyć go w Google Home Developer Console, Google sprawdzi, czy jesteś jego właścicielem. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji dla tego identyfikatora VID.
- Na potrzeby tworzenia oprogramowania i Field Trial w konsoli dla deweloperów trzeba utworzyć projekt i integrację z odpowiednią kombinacją identyfikatora VID i PID. Developer Console Użytkownik, który uruchamia urządzenie, 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 przez Alliance.
Identyfikatorów VID i PID można użyć tylko raz w przypadku 1 integracji. Jeśli chcesz użyć tego samego identyfikatora VID lub PID w integracji, musisz:
- edytować integrację, zmieniając identyfikator VID lub PID na inny identyfikator VID lub PID;
- usunąć integrację, używając identyfikatora VID lub PID.
| Którzy użytkownicy mogą uruchomić urządzenie w ekosystemie Google Home? | |||
|---|---|---|---|
| Typ identyfikatora VID | Certyfikat identyfikatora VID i stan integracji z konsolą | Wersja produkcyjna
(użytkownicy) |
Wersja deweloperska
(deweloperzy, Field Trial użytkownicy) |
| Test | Brak integracji w Developer Console (nie można uzyskać certyfikatu) | ||
| Test | Integracja istnieje w Developer Console (nie można uzyskać certyfikatu) | ||
| Wersja produkcyjna | Brak certyfikatu, integracja nie istnieje w konsoli dla deweloperów Developer Console | ||
| Wersja produkcyjna | Brak certyfikatu, integracja istnieje w Developer Console | ||
| Wersja produkcyjna | Certyfikat w Alliance DCL, integracja nie istnieje w Developer Console | ||
| Wersja produkcyjna | Certyfikat w Alliance DCL, integracja istnieje w Developer Console | ||
Identyfikator produktu
Informacje o urządzeniu są odczytywane z Matter klastra podstawowych informacji. Identyfikator produktu zakodowany w oprogramowaniu urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w konsoli dla deweloperów.
Nieobsługiwane funkcje
Niektóre Matter klastry nie są jeszcze udostępniane użytkownikom, chociaż mogą być używane przez system. W większości przypadków oznacza to, że atrybuty udostępniane przez te klastry nie są widoczne dla użytkowników:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Informacje o tym, jak wpływa to na włączniki światła, znajdziesz w artykule Włączniki światła.