Dikkat! Yeni Geliştirici Önizleme programları yakında kullanıma sunulacak. Buradan başvurun ve yeni araçları deneyip geri bildirim gönderen ilk kişilerden biri olun.

Matter cihazı eşle

Matter özellikli cihazınızı eşleyin. Bunu yapmak için eşlemede bir QR kodu gerekir. Matter cihazınızın platformuna bağlı olarak bu QR kodunu kendiniz oluşturmanız gerekebilir.

QR kodu alın

Bouffalo Lab'ı

BL602

QR kodu dizesi, cihaz başlatıldığında seri konsolunda yazdırılır. Seri konsolunuza göz atın, aşağıdaki gibi mesajlar göreceksiniz:

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
...

QR kodunu görüntülemek için bağlantıyı bir web tarayıcısında açın.

702 BL

QR kodu dizesi, cihaz başlatıldığında seri konsolunda yazdırılır. Seri konsolunuza göz atın, aşağıdaki gibi mesajlar göreceksiniz:

[         0][-][PROGR] ==================================================
[         0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[         0][-][PROGR] ==================================================
...
[      1636][-][PROGR] Starting OpenThread task
[      1655][DL][PROGR] Device Configuration:
[      1703][DL][PROGR]   Serial Number: TEST_SN
[      1703][DL][PROGR]   Vendor Id: 65521 (0xFFF1)
[      1703][DL][PROGR]   Product Id: 32773 (0x8005)
[      1752][DL][PROGR]   Hardware Version: 0
[      1799][DL][PROGR]   Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[      1846][DL][PROGR]   Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[      1893][DL][PROGR]   Manufacturing Date: (not set)
[      1893][DL][PROGR]   Device Type: 65535 (0xFFFF)
[      1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[      1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[      1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234

      

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

  1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
  2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

QR kodunu görüntülemek için bağlantıyı bir web tarayıcısında açın.

NXP

K32W

QR kodu dizesi, cihaz başlatıldığında seri konsolunda yazdırılır. Seri konsolunuza göz atın, aşağıdaki gibi mesajlar göreceksiniz:

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

QR kodunu görüntülemek için bağlantıyı bir web tarayıcısında açın.

Realtek

Ameb D

QR kodu, Ameba D tahtası başlatıldığında seri konsolunda yazdırılan bir URL olarak kodlanır:

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

QR kodunu görüntülemek için bağlantıyı bir web tarayıcısında açın.

Silikon Laboratuvarları

EFR32MG12

Jamboard başladıktan sonra küçük LCD ekranında bir QR kodu görürsünüz.

TLSR9518

QR kodu dizesi, cihaz başlatıldığında seri konsolunda yazdırılır. Seri konsolu kontrol edin. Tarayıcıda açıldığında QR kodunu gösterecek bir URL göreceksiniz:

*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626  ***
I: Init CHIP stack
I: Starting CHIP task
…
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
…
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

Cihazı eşle

Cihazı eşlemenin iki yolu vardır:

  1. Google Home app (GHA)
  2. Android için Google'ın Home Mobile ve Thread Network SDK'ları (3. taraf uygulamasında kullanılabilir)

Her iki yöntem de aynı Matter ve Thread Network API'lerini kullanır.

Google Home Uygulaması

  1. GHA uygulamasını açın.
  2. Sol üst köşedeki simgesine dokunun.
  3. Cihazı kur'a dokunun.
  4. Yeni cihaz'a dokunun.
  5. Evinizi seçin ve Next'e (Sonraki) dokunun.
  6. GHA, cihazınızı tarayacak. Cihazınızı kurmak isteyip istemediğiniz sorulduğunda Farklı bir cihaz kur'a dokunun.
  7. Herhangi bir cihaz türü için Matter cihaza dokunun.
  8. Kameranızı cihazınızın QR koduna (veya web sitesi tarafından oluşturulan QR koduna) doğru tutun.
  9. Eşleme işlemine GHA akışında belirtildiği gibi devam edin.

Mobil cihazınızda GHA ile eşleme sırasında herhangi bir sorunla karşılaşırsanız:

  1. Mobil cihazınız için Geliştirici seçeneklerini etkinleştirdiğinizden emin olun.
  2. Başarısız eşleme denemesinden hemen sonra bir hata raporu yakalayın.

Android SDK'ları

Android SDK'larımızı uygulayarak Matter cihazlarını eşleyin ve Thread ağlarını uygulamanızda yönetin

Android SDK'ları, üçüncü taraf bir uygulamada test ve eşleme için Play services ürününde kullanıma sunuldu.

Bu SDK'larla Matter özellikli bir cihazın nasıl etkinleştirileceğini, eşleneceğini ve kontrol edileceğini gösteren Google Home Sample App for Matter ile başlamanızı öneririz.

Her iki SDK için de referans belgeleri bu sitede bulabilirsiniz:

Eşleme kısıtlamaları

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

  • Test amaçlı VID, tüketici cihazlarında kullanılamaz.
  • Üretim VID'niz ÖAR tarafından düzenlenmiş olmalıdır. Google Home Developer Console, bu VID'yi kullanabilmeniz için Google önce söz konusu VID'nin sahibi olduğunuzu doğrular. Bu aşamada, söz konusu VID için entegrasyonlar oluşturabilirsiniz.
  • Geliştirme ve saha denemesi yapmak için, bir proje ve ilgili VID ile PID kombinasyonuyla entegrasyon Developer Console ürününde oluşturulmalıdır. Cihazda oturum açan kullanıcı, proje üyesi olmalı veya alan deneme sürümü kullanıcı listesine dahil edilmelidir.
  • Tüketici kullanıcılar, ürününüzü yalnızca CSA sertifikalı olduktan sonra kullanabilir.
Tablo: Tedarikçi firma kimliği (VID) ve cihaz türü eşleme senaryoları
Hangi tür kullanıcılar, cihazı Google Home ekosistemine yaptırabilir?
VID türü VID sertifikasyonu ve konsol entegrasyon durumu Üretim
(Tüketici kullanıcıları)
Geliştirme
(Geliştiriciler, Alan Denemesi kullanıcıları)
Test Developer Console entegrasyonu yok (onaylanamaz)
Test Entegrasyon Developer Console ürününde mevcut (sertifikalı değil)
Prodüksiyon Onaylanmadı, Developer Console içinde entegrasyon yok
Prodüksiyon Onaylanmadı, Developer Console içinde entegrasyon mevcut
Prodüksiyon ÖAR DCL sertifikalı, entegrasyon Developer Console içinde mevcut değil
Prodüksiyon ÖAR DCL'de sertifikalıdır ve Developer Console entegrasyonu mevcuttur

Cihaz bilgileri

Eşlenen cihazla ilgili teknik bilgileri GHA sayfasında görüntüleyebilirsiniz.

  1. GHA cihazında cihazı seçin.
  2. Sağ üstteki simgesine dokunun.
  3. Teknik bilgiler'e dokunun.

Üretici, Model ve Donanım sürümü gibi tanımlayıcılar Developer Console cihazından değil, cihazdaki Matter donanım yazılımından gelir. Örneğin, Matter SDK'sındaki cihaz yapılandırmasındaki CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME ve CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME değerleri.

Bu tanımlayıcılar, özellikle bir test Tedarikçi Firma Kimliği ve Ürün Kimliği (entegrasyonlar arasında yinelenebilir) kullanılırken Test amacıyla hangi cihazın eşlendiğini doğrulamak açısından faydalı olabilir.

Eşlemeyle ilgili sorunları giderme

Bir cihazı test için Tedarikçi Firma Kimliği (VID) ve Ürün Kimliği (PID) ile eşleyip Developer Console cihazındaki cihazı Test Paketi ile test etmeyi denediğinizde görünmüyorsa bu durum, muhtemelen birden fazla entegrasyonda aynı test VID'sinin ve PID kombinasyonunun kullanılmasından kaynaklanır.

Sorunu gidermek için Developer Console içindeki tüm test cihazlarını kaldırın ve tekrar test etmek istediğiniz cihazı eşleyin.

Doğru cihazı eşleştirdiğinizden emin olmak için cihazın Üretici ve Model bilgilerini (CHIP_DEVICE_CONFIG_DEVICE_* değerleri) test donanım yazılımınızda benzersiz değerlere ayarlayabilirsiniz.

Daha fazla bilgi için Cihaz bilgileri bölümüne bakın.