Matter cihazı eşle

Matter özellikli cihazınızı eşleyin. Bunun için şunlara ihtiyacınız olacak: eşlemek için bir QR kodu. Matter Cihazınızın platformuna bağlı olarak bu QR kodunu kendiniz oluşturmanız gerekebilir.

QR kodu al

Bouffalo Laboratuvarı

BL602

Cihaz başlatıldığında QR kodu dizesi seri konsolda yazdırılır. Seri konsolunuza göz atın. Şuna benzer 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.

BL702

QR kodu dizesi, cihaz açıldığında seri konsola yazdırılır. Seri konsolunuza göz atın ve şuna benzer mesajlar görürsünüz: bu:

[         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

Cihaz başlatıldığında QR kodu dizesi seri konsolda yazdırılır. Seri konsolunuza göz atın. Şuna benzer 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

Ameba D

QR kodu, Ameba D kartı açıldığında seri konsola yazdırılan bir URL'de 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

Kart açıldı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 konsolda yazdırılır. Seri konsolu kontrol edin. Tarayıcıda açıldığında QR kodunu görüntüleyecek 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. Şunun için Google Home Mobil ve Thread Ağı SDK'ları: Android (üçüncü 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çip Sonraki'ye 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'ye) doğru tutun. ) sağlar.
  9. Eşleme işlemine GHA içinde belirtildiği şekilde devam edin akışı sağlar.

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

  1. E-postanızda Geliştirici seçenekleri mobil cihazınız için etkinleştirin.
  2. Başarısız eşleme denemesinin hemen ardından bir hata yakalayın raporu ekleyin.

Android SDK'ları

Matter'ı eşlemek için Android SDK'larımızı uygulayın cihazlar ve uygulamanızda Thread ağlarını yönetme

Android SDK şurada kullanıma sunuldu: Üçüncü taraf uygulamasında test ve eşleme için Play services.

Şununla başlamanızı öneririz: Google Home Sample App for Matter, bu metrik de Matter özellikli bir cihazı sipariş etmek, eşlemek ve kontrol etmek için Google Home ekosisteminde daha fazla kullanıcıya ulaşıyor.

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

Eşleme kısıtlamaları

Matter cihazları yalnızca Google Home'da eşlenebilir ekosistemindeki belirli tedarikçi firma kimliği ve cihaz türü senaryolarında

  • Test VID'leri, 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 kullanmadan önce söz konusu VID'nin sahibi olduğunuzu doğrulayın. Bu işlem tamamlandıktan sonra, ilgili VID için entegrasyon oluşturabilirsiniz.
  • Geliştirme ve saha denemesi amacıyla, bir proje ve ilgili VID ve PID kombinasyonu Developer Console içinde oluşturulmalıdır. Kullanıcı tarafından devreye alınması cihaz projenin bir üyesi olmalı veya listede yer almalıdır elde etti.
  • Tüketici kullanıcılar, ürününüzü yalnızca Alliance tarafından onaylanmışsa kullanabilir.
Tablo: Tedarikçi firma kimliği (VID) ve cihaz türü eşleme senaryoları
Ne tür kullanıcılar komisyon ekosisteme dahil etmemi sağlıyor mu?
VID türü VID sertifikası ve konsol entegrasyon durumu Üretim
(Tüketici kullanıcılar)
Geliştirme
(Geliştiriciler, Alan Denemesi kullanıcıları)
Test Developer Console'te entegrasyon yok (sertifikalandırılamaz)
Test Entegrasyon Developer Console'te mevcut (sertifikalandırılamaz)
Üretim Sertifikalı değil, Developer Console içinde entegrasyon mevcut değil
Üretim Sertifikalı değil, entegrasyon Developer Console içinde mevcut
Üretim Alliance DCL'de sertifikalıdır, entegrasyon Developer Console içinde yer alır
Üretim Alliance DCL sertifikalı ve Developer Console'te entegrasyon mevcut

Cihaz bilgileri

Eşlenen cihazla ilgili teknik bilgileri şurada görüntüleyebilirsiniz: GHA

  1. GHA içinde cihazı seçin.
  2. Üstteki simgesine dokunun sağ.
  3. Teknik bilgiler'e dokunun.

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

Bu tanımlayıcılar hangi cihazın eşlendiğini doğrulamaya yardımcı olabilir Test etme amacıyla, özellikle de test Tedarikçi Kimliği ve Ürün kimliği (entegrasyonlar arasında kopyalanabilir).

Eşlemeyle ilgili sorunları giderme

Bir cihazı test amaçlı bir tedarikçi kimliği (VID) ve ürün kimliği (PID) ile eşlediniz ancak Developer Console'de cihazı Test Paketi ile test etmeye çalıştığınızda cihaz görünmüyorsa bunun nedeni muhtemelen birden fazla entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.

Sorun gidermek için tüm test cihazlarını Developer Console adlı kuruluştan kaldırıp eşleyin tekrar test etmek istediğiniz cihazı seçin.

Doğru öğeyi eşlediğinizi doğrulamak için Üreticiyi ve Cihazın model bilgileri (CHIP_DEVICE_CONFIG_DEVICE_* değer) benzersiz değerlere sahip olduğundan emin olun.

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