Pierwsze kroki ze standardem Matter

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Program dla deweloperów Google Home umożliwia producentom urządzeń łączenie ich inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy lokalną ścieżkę realizacji za pomocą akcji domowych, umożliwiając dodawanie urządzeń z funkcją Matter do konfiguracji za pomocą Google Home app (GHA) i sterowanie 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 w tym samym czasie lub z tą samą strukturą, może spowodować nieprzewidywalne działanie.
• 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łyty 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ólnego przeznaczenia ThreadBorderRouter dla urządzeń z funkcją Thread.

Centrum

Obsługiwane urządzenie Google Nest, takie jak Google Nest Hub (2nd gen). Aby sterować urządzeniami z wsparciem dla Matter za pomocą innych urządzeń, takich jak Assistant, GHA czy inteligentne ekrany, 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ć:

1. 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.
2. 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
3. Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z funkcją Matter.
4. 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 obsługą Matter.
   • Jedno z tych urządzeń Matter do przeprowadzania kompleksowej weryfikacji:

Tabela: Matter przykłady od dostawców układów

Dostawca	Platforma	Pomoc na poziomie: Thread	Przewodnik
Buffalo 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 Zestaw startowy
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 Field Trial należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który zleca użycie urządzenia, musi być członkiem projektu lub znajdować się na liście użytkowników Field Trial.
• Konsumenci mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu Alliance.

Identyfikatory VID i PID mogą być używane tylko raz w przypadku 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.

Tabela: identyfikator dostawcy (VID) i typ urządzenia w scenariuszach parowania

		Które typy użytkowników mogą włączyć urządzenie do ekosystemu Google Home?
Typ VID	Stan certyfikatu VID i integracji z konsolą	Produkcyjna (użytkownicy indywidualni)	Wersja rozwojowa (Dla deweloperów, użytkownicy Field Trial)
Test	Brak integracji w Developer Console (nie można uzyskać certyfikatu)
Test	Integracja istnieje 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	Certyfikowane w ramach 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 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 przez te klastry nie są widoczne dla użytkowników:

¹ Aby dowiedzieć się, jak to wpływa na przełączniki światła, przeczytaj artykuł Przełączniki światła.