Wersja dla programistów – wersja testowa
Program Google Home Developer pozwala producentom urządzeń łączyć swoje inteligentne urządzenia domowe z ekosystemem Google Home. Rozszerzamy ścieżkę realizacji lokalnej kampanii inteligentnej w aplikacji Home Home, dodając możliwość dodawania Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA, or smart displays like the Google Nest Hub (2nd gen) .
Ta dokumentacja opisuje, jak zacząć tworzyć i integrować platformę obsługiwaną przez Matter w ekosystemie Google Home.
Wyłączenia odpowiedzialności
Korzystając z procedur opisanych w tej wersji przedpremierowej dla deweloperów aplikacji Matter, pamiętaj o tych kwestiach:
- Konto używane do programowania powinno mieć połączone tylko 1 centrum z włączoną obsługą Matter. Wiele centrów z włączoną obsługą Matter połączonych w tym samym czasie lub połączonych z tą samą strukturą podczas testów może skutkować nieprzewidzianym zachowaniem.
- Wszystkie procedury zakładają użycie komputera z systemem Linux Ubuntu 20.04 do tworzenia i migania próbek Matter, które zostały przetestowane przez Google. Systemy MacOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W razie potrzeby instrukcje są charakterystyczne dla komputerów Mac.
- Obsługiwana jest tylko wersja GHA aplikacji na Androida.
Definicje
W tej dokumentacji wykorzystano następujące terminy:
- Router graniczny
- Centrum wdrażające zwykły cel Thread Border Router for Thread-enabled devices.
- Centrum
- Obsługiwany obiekt Google Nest device, such as the Google Nest Hub (2nd gen). A hub is required to control Matter-enabled devices through other surfaces such as Assistant, the GHA, and smart displays.
- Urządzenie z obsługą Matter
- Urządzenie lub płyta deweloperska, która została zainstalowana jako przykładowa aplikacja z włączoną funkcją Matter.
- Urządzenie mobilne
- Telefon testowy, który ułatwił parowanie. Obecnie to Android phone.
Wymagania wstępne
Aby w pełni zintegrować urządzenie z systemem Matter z ekosystemem Google Home, deweloper musi:
- Węzeł Google z obsługą wątków jako router graniczny na urządzeniach z wątkami oraz jako lokalna ścieżka realizacji dla intencji inteligentnego domu.
- urządzenie mobilne (telefon testowy), które spełnia minimalne wymagania:
- Android O (8.1, poziom API 27) lub nowszy (w przyszłości zostanie dodana obsługa iOS)
- Możliwości BLE
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z włączoną obsługą Matter.
- Urządzenie z obsługą Matter. Urządzenie powinno być jednym z typów Matter obsługiwanych obecnie w ekosystemie Google Home. Może to być:
- Twój własny produkt z oprogramowaniem układowym z obsługą Matter.
- Platforma deweloperska obsługującej platformę dostawcy, która może służyć jako urządzenie do kompleksowej weryfikacji z obsługą Matter. Obsługiwane są te platformy:
| Dostawca | Platforma | Przewodniki | Pomoc na poziomie: Thread |
|---|---|---|---|
| Laboratorium Bouffalo | BL602 | Krótki przewodnik | |
| BL702 | Krótki przewodnik | ||
| Espressif | ESP32 | Szybki start
Testy OTA |
|
| Półwysep nordycki | nRF52840 DK | Szybki start
Testy OTA |
|
| NXP, | Zestaw dla programistów IOTZTB-DK006 | Krótki przewodnik | |
| Realtek | Seria Ameba D | Krótki przewodnik | |
| Laboratorium Silicon | Zestaw startowy EFR32MG Zigbee i Thread | Krótki przewodnik | |
| Zestaw dla programistów EFR32MG24 | Krótki przewodnik | ||
| Telink | TLSR9518 | Krótki przewodnik |
Identyfikator dostawcy
Domyślnie do testowania możesz użyć jednego z identyfikatorów VID przypisanych przez CSA. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby korzystać z identyfikatora produkcyjnego, co umożliwi certyfikację i uruchomienie integracji, Google musi najpierw ją zweryfikować, aby mieć pewność, że została Ci udostępniona przez CSA.
Ten identyfikator VID powinien być wdrożony w oprogramowaniu urządzenia.
Urządzenie Matter można sparować w ekosystemie Google Home tylko w niektórych scenariuszach z identyfikatorem dostawcy i rodzajem urządzenia.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
- Aby można było sparować urządzenie produkcyjne (konsumenckie), musi ono mieć certyfikat DCL w CSA.
- Na potrzeby programowania i testowania urządzeń urządzenie musi być zarejestrowane w usłudze Google Home Developer Console .
| Jakiego typu użytkownicy mogą zlecić urządzeniu korzystanie z ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikacji i rejestracji VID | Produkcyjna (Użytkownicy) |
Rozwój
(Deweloperzy, użytkownicy wersji próbnej) |
| Test | Niezarejestrowany (nie można uzyskać certyfikatu) | Nie dotyczy | Nie dotyczy |
| Test | Data rejestracji: Developer Console (brak certyfikatu) | Nie dotyczy | |
| Produkcja | Nie posiada certyfikatu, nie zarejestrowano | Nie dotyczy | |
| Produkcja | Nie posiada certyfikatu, jest zarejestrowany w Developer Console | ||
| Produkcja | Nie posiada certyfikatu DCLA w CSA | Nie dotyczy | |
| Produkcja | Masz certyfikat w programie DCL CSA i został zarejestrowany w Developer Console | ||
Identyfikator produktu
Informacje o urządzeniu są odczytywane za pomocą klastrów z deskryptorami spraw, a nie identyfikatora produktu. W trakcie tworzenia możesz przypisać dowolny identyfikator produktu zgodnie z systemem numeracyjnym Twojej firmy (o ile jest zgodny z identyfikatorem produktu w ramach integracji Matter, jeśli został podany).
Nieobsługiwane funkcje
Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników, chociaż mogą być używane przez system. W większości przypadków oznacza to, że atrybuty ujawnione w tych klastrach nie będą widoczne dla użytkowników:
| Typ klastra | Klastry |
|---|---|
| Core |
|
| Aplikacja |
|