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)'i kullanarak kurulum için Matter özellikli cihazlar ekleme ve bunları Google Assistant, GHA veya Google Nest Hub (2nd gen) gibi akıllı ekranlar üzerinden kontrol etme özelliğiyle Akıllı Ev İşlemleri yerel yerine getirme yolunu genişletiyoruz.

Bu dokümanda, Google Home ekosisteminde Matter destekli bir platform oluşturma ve entegre etme hakkında bilgi verilmektedir.

Sorumluluk reddi beyanları

Matter dokümanlarında açıklanan prosedürlerle ilgili olarak aşağıdakileri göz önünde bulundurun:

  • Geliştirme için kullanılan hesapta, test için yalnızca tek bir Matter özellikli hub'ın bağlı olmasını öneririz. Aynı anda bağlı olan veya test sırasında aynı yapıya bağlı olan birden fazla Matter özellikli hub, beklenmedik davranışlara neden olabilir.
  • Tüm prosedürlerde, Google tarafından test edilmiş Matter örneklerini derlemek ve flaşlamak için Ubuntu 20.04 çalıştıran bir Linux makinesinin kullanıldığı varsayılır. macOS makineler desteklenir ancak Linux önerilir. Mac'e özgü talimatlar, gerektiğinde prosedürlerde belirtilir.

Derleme

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

Başlamanın en kolay yolu, kod laboratuvarlarımızı incelemektir. Aşağıdaki kod laboratuvarlarından en az birini tamamlamanızı öneririz:

Ardından, entegre etmeyi planladığınız cihazın Google Home ekosisteminde desteklenip desteklenmediğini öğrenmek için desteklenen cihazlar listemizi inceleyin. Ardından, proje oluşturmadan lansmana kadar geliştirme akışının tamamını anlamak için Geliştirici Yapılacaklar Listesi'ni okuyun.

Desteklenen Cihazlar Geliştirici Kontrol Listesi

Tanımlar

Bu dokümanda aşağıdaki terimler kullanılmıştır:

Sınır yönlendirici
Thread özellikli cihazlar için genel amaçlı bir Thread sınır yönlendiricisi uygulayan bir merkez.
Hub
Google Nest Hub (2nd gen) gibi desteklenen bir Google Nest cihaz Matter özellikli cihazları Assistant, GHA ve akıllı ekranlar gibi diğer platformlardan kontrol etmek için bir merkez gerekir.
Matter özellikli cihaz
Matter Etkinleştirilmiş bir derleme veya örnek uygulamayla flaşının atıldığı bir cihaz ya da geliştirme kartı.
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ştiricilerin şunları yapması gerekir:

  1. Hem Thread özellikli cihazlar için sınır yönlendirici hem de akıllı ev intent'lerini yönlendirmek için yerel bir karşılama yolu olarak hizmet veren 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)
    • iOS (16.5 veya daha yeni sürümler)
    • BDE özelliği
  3. Matter özellikli cihazın Tedarikçi Firma Kimliği (VID) ve Ürün Kimliği (PID).
  4. Matter özellikli bir cihaz. Bu cihaz, Google Home ekosisteminde desteklenen Matter cihaz türlerinden biri olmalıdır ve şunlar olabilir:
    • Matter özellikli donanım yazılımına sahip kendi ürününüz.
    • Uçtan uca doğrulama için kullanılacak aşağıdaki Matter cihazlardan biri:
Tablo: Matter silikon tedarikçilerinden örnekler
Satıcı Platform Thread Destek Ekibi 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 Serisi
Silicon Labs EFR32MG24 Dev Kiti
EFR32MG Zigbee ve Thread Başlangıç Seti
Telink TLSR9518
Texas Instruments CC2652R7 LaunchPad geliştirme kiti

Satıcı kimliği

Varsayılan olarak, CSA tarafından test amacıyla 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 kullanmanız gerekir. Bunun için öncelikle VID'nin CSA tarafından size verildiğini doğrulamak üzere VID'yi Google tarafından doğrulamanız gerekir.

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

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

  • Test VID'si tüketici cihazlarında kullanılamaz.
  • Üretim VID'niz Connectivity Standards Alliance (Alliance) tarafından düzenlenmelidir. Google, Google Home Developer Console'te kullanabilmeniz için bu VID'nin sahibi olduğunuzu doğrular. Bu işlem tamamlandıktan sonra, ilgili VID için entegrasyon oluşturabilirsiniz.
  • Geliştirme ve saha denemesi amacıyla, ilgili VID ve PID kombinasyonuyla bir proje ve entegrasyon Developer Console'te oluşturulmalıdır. Cihazı devreye alan kullanıcı, projenin bir üyesi veya saha deneme kullanıcıları listesine dahil edilmiş olmalıdır.
  • Tüketici kullanıcılar, ürününüzü yalnızca Alliance tarafından onaylanmışsa kullanabilir.

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

  • VID veya PID'yi kullanarak entegrasyonu farklı bir VID veya PID ile düzenleyin.
  • VID veya PID'yi kullanarak entegrasyonu silin.
Tablo: Tedarikçi firma kimliği (VID) ve cihaz türü eşleme
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, Alan Deneme kullanıcıları)
Test Developer Console'te entegrasyon yok (sertifikalandırılamaz)
Test Developer Console'te entegrasyon mevcut (sertifikalandırılamaz)
Üretim Sertifikasız, entegrasyon Developer Console'te mevcut değil
Üretim Sertifikasız, entegrasyon Developer Console'te mevcut
Üretim Alliance DCL'de sertifikalandırılmış, Developer Console'te entegrasyon bulunmuyor
Üretim Alliance DCL sertifikalı ve Developer Console'da 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ına kodlanan ürün kimliği, Developer Console'daki Matter entegrasyonunun ürün kimliğiyle eşleşmelidir.

Desteklenmeyen özellikler

Bazı Matter kümeleri henüz kullanıcılara gösterilmese de sistem tarafından kullanılabilir. Çoğu durumda bu, bu kümeler aracılığıyla sunulan özelliklerin son kullanıcılar tarafından görülemediğ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 düğmeli ışık anahtarlarını nasıl etkilediği hakkında bilgi edinmek için Açma/kapatma düğmeli ışık anahtarları başlıklı makaleyi inceleyin.