Google'ın Home Developer Programı, cihaz üreticilerinin akıllı ev cihazlarını Google Home ekosistemine bağlamasına olanak tanır. Akıllı Ev İşlemleri yerel karşılama yolunu, Google Home app (GHA) kullanarak 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 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 dokümanlarında açıklanan prosedürlerle ilgili olarak aşağıdakilere dikkat edin:
- Geliştirme için kullanılan hesabın, test için bağlı yalnızca tek bir Matter özellikli hub'ı olmasını öneririz. Test sırasında aynı anda bağlanan veya aynı yapıya bağlanan birden fazla Matter özellikli hub, öngörülemeyen davranışlara neden olabilir.
- Tüm prosedürlerde, Google tarafından test edilen Matter örneklerini derlemek ve yüklemek için Ubuntu 20.04 çalıştıran bir Linux makinesinin kullanıldığı varsayılır. macOS makineler desteklense de 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'sı ile çalışırsınız.
Başlamanın en kolay yolu, codelab'lerimizi incelemektir. Aşağıdaki codelab'lerden en az birini tamamlamanızı öneririz:
Ardından, entegre etmeyi planladığınız cihazın Google Home ekosisteminde desteklendiğinden emin olmak için desteklenen cihazlar listemize göz atın. Ardından, proje oluşturmadan lansmana kadar tüm geliştirme akışını anlamak için Geliştirici Kontrol Listesi'ni okuyun.
Desteklenen Cihazlar Geliştirici Kontrol Listesi
Tanımlar
Bu belgede aşağıdaki terimler kullanılmaktadır:
- Sınır yönlendirici
- Thread özellikli cihazlar için genel amaçlı bir Thread sınır yönlendirici uygulayan 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 yüzeylerden kontrol etmek için bir merkez gerekir.
- Matter özellikli cihaz
- Matter özellikli bir derleme veya örnek uygulama ile flashlanmış 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 özellikli bir cihazı Google Home ekosistemiyle tam olarak entegre etmek için geliştiricinin şunlara sahip olması gerekir:
- 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'ı.
- 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 daha yeni sürüm)
- BLE özelliği
- Matter özellikli cihaz için Tedarikçi Kimliği (VID) ve Ürün Kimliği (PID).
- Matter özellikli bir cihaz. Bu cihaz, Google Home ekosisteminde desteklenen Matter cihaz türünden 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:
| 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 Serisi | ||
| Silicon Labs | EFR32MG24 Dev Kit | ||
| EFR32MG Zigbee and Thread Starter Kit | |||
| Telink | TLSR9528 | Telink Matter Geliştirici Kılavuzu | |
| Texas Instruments | CC2652R7 LaunchPad geliştirme kiti |
Satıcı kimliği
Varsayılan olarak, Alliance tarafından test amacıyla tahsis edilen VID'lerden birini kullanabilirsiniz. Aşağıdakilerden birini seçin:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Entegrasyonunuzun sertifikalandırılması ve kullanıma sunulması için üretim VID'si kullanmak istiyorsanız öncelikle bu VID'nin Alliance tarafından size verildiğini doğrulaması için Google'a göndermeniz gerekir.
Bu VID, cihazınızın donanım yazılımına uygulanmalıdır.
Matter cihazlar, yalnızca belirli tedarikçi kimliği ve cihaz türü senaryolarında Google Home ekosistemiyle 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 içinde kullanabilmeniz için bu VID'nin sahibi olduğunuzu doğrular. Bu işlem tamamlandıktan sonra söz konusu VID için entegrasyonlar oluşturabilirsiniz.
- Geliştirme ve Field Trial amaçları doğrultusunda, ilgili VID ve PID kombinasyonunu içeren bir proje ve entegrasyon Developer Console içinde oluşturulmalıdır. Cihazı devreye alan kullanıcının projenin üyesi olması veya Field Trial kullanıcı listesinde yer alması gerekir.
- Tüketici kullanıcılar, ürününüzü yalnızca Alliance tarafından onaylandıktan sonra kullanabilir.
VID ve PID, bir entegrasyon için yalnızca bir kez kullanılabilir. Entegrasyonunuzda aynı VID veya PID'yi kullanmak istiyorsanız şunlardan birini yapmanız gerekir:
- VID veya PID'yi kullanarak entegrasyonu farklı bir VID veya PID'ye düzenleyin.
- VID veya PID'yi kullanarak entegrasyonu silin.
| Cihazı Google Home ekosistemine hangi kullanıcı türleri ekleyebilir? | |||
|---|---|---|---|
| VID türü | VID sertifikası ve konsol entegrasyonu durumu | Üretim
(Tüketici kullanıcılar) |
Geliştirme
(Geliştiriciler, Field Trial kullanıcı) |
| Test | Developer Console içinde 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 içinde mevcut değil | ||
| Üretim | Alliance DCL'de sertifikalı ve Developer Console entegrasyonu mevcut | ||
Ürün Kimliği
Cihazla ilgili bilgiler Matter Temel Bilgiler Kümesi'nden okunur. Cihazınızın donanım yazılımında kodlanmış ürün kimliği, Geliştirici Konsolu'ndaki Matter entegrasyonunun ürün kimliğiyle eşleşmelidir.
Desteklenmeyen özellikler
Ancak bazı Matter kümeleri henüz kullanıcılara gösterilmemiştir. Bu kümeler 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ülemeyeceği anlamına gelir:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Bu durumun Açma/Kapama Işık Anahtarları'nı nasıl etkilediğini öğrenmek için Açma/Kapama Işık Anahtarları bölümüne bakın.