Matter özellikli cihazınızı eşleyin. Bunun için eşleme amacıyla bir QR koduna ihtiyacınız olacak. Matter cihazınızın platformuna bağlı olarak bu QR kodunu kendiniz oluşturmanız gerekebilir.
QR kodu al
Bouffalo Lab
BL602
QR kodu dizesi, cihaz başlatıldığında seri konsolda yazdırılır. Seri konsolunuzu kontrol ettiğinizde aşağıdaki gibi mesajlar görürsünüz:
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 başlatıldığında seri konsolda yazdırılır. Seri konsolunuzu kontrol edin. Aşağıdakine benzer mesajlar görürsünüz:
[ 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
- 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 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - 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 konsolda yazdırılır. Seri konsolunuzu kontrol ettiğinizde aşağıdaki gibi mesajlar görürsünüz:
[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ı başlatıldığında seri konsolda 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:
QR kodunu görüntülemek için bağlantıyı bir web tarayıcısında açın.
Silicon Labs
EFR32MG12
Kart başlatıldığında küçük LCD ekranında bir QR kodu görürsünüz.
Telink
TLSR9518
QR kodu dizesi, cihaz başlatıldığında seri konsolda yazdırılır. Seri konsolu kontrol edin. Bir tarayıcıda açıldığında QR kodunu gösterecek bir URL görürsünüz:
*** 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şleme
Cihazı eşlemenin iki yolu vardır:
- Google Home app (GHA)
- Google'ın Android için Home Mobile ve Thread Network SDK'ları (üçüncü taraf uygulamalarında kullanılabilir)
Her iki yöntem de aynı Matter ve Thread Network API'lerini kullanır.
Google Home uygulaması
- GHA uygulamasını açın.
- Sol üst köşedeki simgesine dokunun.
- Cihazı kur'a dokunun.
- Yeni cihaz'a dokunun.
- Evinizi seçip Sonraki'ye dokunun.
- GHA, cihazınızı tarar. Cihazınızı kurmak isteyip istemediğinizi soran bir istem gösterildiğinde Farklı bir cihaz kur'a dokunun.
- Herhangi bir cihaz türü için Matter cihaz'a dokunun. .
- Kameranızı cihazınızın QR koduna (veya web sitesi tarafından oluşturulan QR koduna) doğru tutun.
- Eşleme işlemine GHA akışında belirtildiği şekilde devam edin.
Mobil cihazınızda GHA ile eşleme sırasında herhangi bir sorunla karşılaşırsanız:
- Mobil cihazınızda Geliştirici seçenekleri'nin etkinleştirildiğinden emin olun.
- Başarısız eşleme denemesinden hemen sonra hata raporu oluşturun.
Android SDK'ları
Android SDK'ları, üçüncü taraf uygulamalarında test ve eşleme için Play services uygulamasında kullanıma sunuldu.
Bu SDK'ları kullanarak Google Home ekosisteminde Matter özellikli bir cihazı nasıl devreye alacağınızı, eşleyeceğinizi ve kontrol edeceğinizi gösteren Google Home Sample App for Matter ile başlamanızı öneririz.
Her iki SDK için referans dokümanları bu sitede mevcuttur:
Eşleme kısıtlamaları
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 | ||
Cihaz bilgileri
Eşlenen cihazla ilgili teknik bilgiler GHA bölümünde görüntülenebilir.
- GHA bölümünde cihazı seçin.
- Sağ üstteki simgesine dokunun.
- Teknik bilgiler'e dokunun.
Üretici, Model ve Donanım sürümü gibi tanımlayıcılar Developer Console'dan değil, cihazdaki Matter donanım yazılımından gelir. Ö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, özellikle test amaçlı bir tedarikçi kimliği ve ürün kimliği (entegrasyonlar arasında kopyalanabilir) kullanırken hangi cihazın test amacıyla eşlendiğini doğrulamak için yararlı olabilir.
Eşleme sorunlarını giderme
Bir cihazı test Tedarikçi Kimliği (VID) ve Ürün Kimliği (PID) ile eşlediyseniz ancak Developer Console uygulamasında cihazı Test Paketi ile test etmeye çalıştığınızda görünmüyorsa bunun nedeni muhtemelen birden fazla entegrasyonda aynı test VID ve PID kombinasyonunun kullanılmasıdır.
Sorunu gidermek için tüm test cihazlarını Developer Console uygulamasından kaldırın ve test etmek istediğiniz cihazı tekrar eşleyin.
Doğru cihazı eşlediğinizi doğrulamak için cihazın Üretici ve Model bilgilerini (CHIP_DEVICE_CONFIG_DEVICE_* değerleri) test donanım yazılımınızdaki benzersiz değerlere ayarlayabilirsiniz.
Daha fazla bilgi için Cihaz bilgileri bölümüne bakın.