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

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

Sorumluluk reddi beyanları

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

  • Geliştirme için kullanılan hesabın, test için yalnızca tek bir Matter etkin hub'a bağlı olması önerilir. Test sırasında aynı anda veya aynı yapıya bağlı birden fazla Matter özellikli hub'ın kullanılması, ö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 makinesinin kullanıldığı varsayılır. macOS makineler desteklenirken Linux önerilir. Mac'e özgü talimatlar, gerektiğinde prosedürlerde belirtilir.

Nasıl oluşturulur?

Google Home ekosistemiyle entegre olan Matter özellikli bir cihaz oluşturmak için Matter uyumlu bir geliştirme kartı ve Matter SDK 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 cihazların Google Home ekosisteminde desteklendiğinden emin olmak için desteklenen cihazlar listemizi kontrol edin. Ardından, proje oluşturmadan yayına kadar tüm geliştirme akışını anlamak için Geliştirici Yapılacaklar Listesi'ni okuyun.

Desteklenen Cihazlar Geliştiricinin Yapılacaklar Listesi

Tanımlar

Bu belgede aşağıdaki terimler kullanılmıştır:

Sınır yönlendirici
Thread özellikli cihazlar için genel amaçlı 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 platformlar ü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ın Google Home ekosistemine tam olarak entegre edilebilmesi için geliştiricinin şunlara sahip olması gerekir:

  1. Thread özellikli cihazlar için hem sınır yönlendirici 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 şartları 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 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 şunlardan biri 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 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ıç 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 kullanmak istiyorsanız öncelikle CSA tarafından size verildiğinden emin olmak için Google tarafından doğrulanmasını sağlamanız gerekir.

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

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

  • Test VID'si tüketici cihazlarında kullanılamaz.
  • Üretim VID'niz Connectivity Standards Alliance (Alliance) tarafından verilmiş olmalıdır. Google, Google Home Developer Console'da kullanabilmeniz için önce VID'nin sahibi olduğunuzu doğrular. Bu işlem tamamlandıktan sonra söz konusu satıcı kimliği için entegrasyonlar oluşturabilirsiniz.
  • Geliştirme ve Field Trial amaçları için bir proje ve ilgili VID ile PID kombinasyonuyla entegrasyon Developer Console'da oluşturulmalıdır. Cihazı devreye alan kullanıcı, projeye üye olmalı veya Field Trial kullanıcı listesinde yer almalıdır.
  • Tüketici kullanıcılar, ürününüzü yalnızca Alliance tarafından sertifikalandırıldıktan sonra kullanabilir.

VID ve PID, tek bir entegrasyon için yalnızca 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 (sertifika alınamaz)
Test Developer Console içinde entegrasyon var (sertifika alınamaz)
Ü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ı, Alliance'de entegrasyon yokDeveloper Console
Üretim Alliance DCL'de sertifikalı ve Developer Console'te 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 Matter entegrasyonunun ürün kimliğiyle eşleşmelidir.

Desteklenmeyen özellikler

Bazı Matter kümeler, sistem tarafından kullanılabilmelerine rağmen henüz kullanıcılara sunulmamaktadır. Ç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/Kapama Işık Anahtarları'nı nasıl etkilediğini öğrenmek için ilgili makaleyi inceleyin.