Matter'ı kullanmaya başlama

Google'ın Home Developer Programı, cihaz üreticilerinin akıllı ev cihazlarını Google Home ekosistemine bağlamasına olanak tanır. Google Home app (GHA) kullanılarak kurulumu yapılan Matter özellikli cihazların eklenmesine ve Google Assistant, GHA veya Google Nest Hub (2nd gen) gibi akıllı ekranlar kullanılarak kontrol edilmesine olanak tanıyan Akıllı Ev İşlemleri yerel karşılama yolunu genişletiyoruz.

Bu dokümanda, Google Home ekosisteminde Matter destekli bir platform oluşturmaya ve entegre etmeye nasıl başlayacağınız açıklanmaktadır.

Sorumluluk reddi beyanları

Matter Belgelerde açıklanan prosedürlerle ilgili olarak aşağıdakilere dikkat edin:

  • Geliştirme için kullanılan hesabın, test amacıyla yalnızca tek bir Matter özellikli hub'a bağlı olması önerilir. Aynı anda veya test sırasında aynı yapıya bağlı birden fazla Matter özellikli hub, öngörülemeyen davranışlara neden olabilir.
  • Tüm prosedürlerde, Google tarafından test edilmiş Matter örneklerinin oluşturulması ve yüklenmesi için Ubuntu 20.04 çalıştıran bir Linux makinenin kullanıldığı varsayılır. macOS makineler desteklenir ancak Linux önerilir. Mac'e özgü talimatlar, gerektiğinde prosedürlerde belirtilir.

Nasıl oluşturulur?

Google Home ekosistemine entegre olan Matter özellikli bir cihaz oluşturmak için Matter uyumlu bir geliştirme kartı ve Matter SDK'sı ile çalışmanız gerekir.

Başlamanın en kolay yolu codelab'lerimizi incelemektir. Aşağıdaki codelab'lerden en az birini yapmanızı öneririz:

Ardından, entegre etmeyi planladığınız öğelerin Google Home ekosisteminde desteklendiğinden emin olmak için desteklenen cihazlar listemizi kontrol edin. Ardından, proje oluşturmadan yayına almaya kadar tüm geliştirme akışını anlamak için Geliştirici Yapılacaklar Listesi'ni okuyun.

Desteklenen Cihazlar Geliştirici Kontrol Listesi

Tanımlar

Bu belgede aşağıdaki terimler kullanılır:

Sınır yönlendirici
Thread özellikli cihazlar için genel amaçlı bir Thread sınır yönlendirici uygulayan bir hub.
Hub
Desteklenen bir Google Nest cihaz (ör. Google Nest Hub (2nd gen)). Matter özellikli cihazları Assistant, GHA ve akıllı ekranlar gibi diğer yüzeyler üzerinden kontrol etmek için merkez gerekir.
Matter özellikli cihaz
Bir cihaz veya geliştirme kartı, Matter özellikli bir derleme ya da örnek uygulama ile flashlanmış olmalıdır.
Mobil cihaz
Eşlemeye yardımcı olmak için kullanılan test telefonu. Şu anda bu bir Android telefon.

Ön koşullar

Matter geliştirme için önerilen IDE uzantıları

Matter özellikli bir cihazı Google Home ekosistemine tam olarak entegre etmek için geliştiricinin şunlara sahip olması gerekir:

  1. Hem Thread özellikli cihazlar için border router hem de Akıllı Ev intent'lerini yönlendirmek için yerel bir intent karşılama yolu olarak kullanılacak Thread destekli bir Google hub'ı.
  2. Minimum gereksinimleri karşılayan bir mobil cihaz (test telefonu):
    • Android O (8.1, API düzeyi 27 veya daha yeni sürümler)
    • iOS (16.5 veya sonraki sürümler)
    • BLE özelliği
  3. Matter özellikli cihaz için Tedarikçi Kimliği (VID) ve Ürün Kimliği (PID).
  4. Matter özellikli bir cihaz. Bu cihaz, Matter Google Home ekosisteminde desteklenen cihaz türlerinden biri olmalıdır ve aşağıdakilerden biri olabilir:
    • Matter özellikli donanım yazılımına sahip kendi ürününüz.
    • Uçtan uca doğrulama için kullanılabilecek aşağıdaki Matter cihazlardan biri:
Tablo: Matter silikon tedarikçilerinden örnekler
Satıcı Platform Thread Desteği Kılavuz
Bouffalo Lab BL602
BL702
Espressif ESP32 OTA Testi
Nordic Semiconductor nRF52840 DK OTA Testi
NXP IOTZTB-DK006 geliştirme kiti
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee ve Thread Başlangıç Kiti
Telink TLSR9528 Telink Matter Geliştirici Kılavuzu
Texas Instruments CC2652R7 LaunchPad geliştirme kiti

Satıcı kimliği

Varsayılan olarak, test amacıyla Alliance tarafından ayrılan VID'lerden birini kullanabilirsiniz. Aşağıdakilerden birini seçin: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Entegrasyonunuzun sertifikalandırılıp kullanıma sunulabilmesi için üretim VID'si kullanmak istiyorsanız öncelikle bu VID'nin Alliance tarafından size verildiğinden emin olmak için Google tarafından doğrulanması gerekir.

Bu VID, cihazınızın donanım yazılımına uygulanmalıdır.

Matter cihazı, yalnızca belirli tedarikçi kimliği ve cihaz türü senaryolarında Google Home ekosisteminde eşlenebilir.

VID ve PID yalnızca bir entegrasyon için bir kez kullanılabilir. Entegrasyonunuzda aynı VID veya PID'yi kullanmak istiyorsanız şunlardan birini yapmanız gerekir:

  • Entegrasyonu, VID veya PID'yi farklı bir VID veya PID ile değiştirecek şekilde düzenleyin.
  • VID veya PID'yi kullanarak entegrasyonu silin.
Tablo: Tedarikçi kimliği (VID) ve cihaz türü eşleştirme senaryoları
Hangi kullanıcı türleri cihazı Google Home ekosistemine dahil edebilir?
VID türü VID sertifikası ve konsol entegrasyonu durumu Üretim
(Tüketici kullanıcılar)
Geliştirme
(Geliştiriciler, Field Trial kullanıcılar)
Test Developer Console'da entegrasyon yok (sertifikalandırılamaz)
Test Entegrasyon Developer Console içinde mevcut (sertifikalandırılamaz)
Üretim Sertifikalı değil, entegrasyon Developer Console içinde mevcut değil
Üretim Sertifikalı değil, entegrasyon Developer Console içinde mevcut
Üretim Alliance DCL'de sertifikalı, entegrasyon Developer Console'de yok
Üretim Alliance DCL'de sertifikalı ve Developer Console'de entegrasyon mevcut

Ürün Kimliği

Cihazla ilgili bilgiler, Matter Temel Bilgi Kümesi'nden okunur. Cihazınızın donanım yazılımında kodlanan ürün kimliği, Developer Console'daki Matterentegrasyonun ürün kimliğiyle eşleşmelidir.

Desteklenmeyen özellikler

Bazı Matter kümeler henüz kullanıcılara sunulmamıştır ancak sistem tarafından kullanılabilir. Çoğu durumda bu, bu kümeler aracılığıyla kullanıma sunulan özelliklerin son kullanıcılara görünmediği anlamına gelir:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ Bu durumun açma/kapatma ışık anahtarlarını nasıl etkilediğini öğrenmek için Açma/Kapatma Işık Anahtarları başlıklı makaleyi inceleyin.