Menyambungkan perangkat Masalah

Sambungkan perangkat yang mendukung Matter. Untuk melakukan ini, Anda perlu kode QR untuk penyambungan. Tergantung pada platform Matter perangkat, Anda mungkin perlu membuat kode QR ini diri Anda sendiri.

Mendapatkan kode QR

Lab Bouffalo

BL602

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Lihat konsol serial Anda dan Anda akan melihat pesan seperti ini:

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
...

Buka link di browser web untuk menampilkan kode QR.

BL702

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Lihat konsol serial Anda dan Anda akan melihat pesan seperti ini:

[         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

Buka link di browser web untuk menampilkan kode QR.

NXP

K32W

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Periksa konsol serial Anda dan Anda seharusnya melihat pesan seperti ini:

[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
...

Buka link di browser web untuk menampilkan kode QR.

Realtek

Ameba D

Kode QR dienkode ke URL, yang dicetak dalam seri konsol saat board Ameba D melakukan booting:

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

Buka link di browser web untuk menampilkan kode QR.

Lab Silicon

EFR32MG12

Setelah papan booting, Anda akan menemukan kode QR di LCD kecilnya tampilan.

TLSR9518

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Periksa konsol serial dan Anda akan melihat URL yang akan menampilkan kode QR saat dibuka di browser:

*** 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

Menyambungkan perangkat

Ada dua cara untuk menyambungkan perangkat:

  1. Google Home app (GHA)
  2. Google Home Mobile dan Thread Network SDK untuk Android (yang dapat digunakan di aplikasi pihak ketiga)

Kedua metode menggunakan Matter dan API Jaringan Thread.

Aplikasi Google Home

  1. Buka GHA.
  2. Ketuk di pojok kiri atas.
  3. Ketuk Siapkan perangkat.
  4. Ketuk Perangkat baru.
  5. Pilih rumah Anda, lalu ketuk Berikutnya.
  6. GHA akan memindai perangkat Anda. Setelah diminta untuk menyiapkan perangkat, ketuk Siapkan perangkat lain.
  7. Ketuk Matter perangkat untuk semua jenis perangkat.
  8. Arahkan kamera ke kode QR perangkat (atau QR yang dibuat situs web) pada kode).
  9. Lanjutkan proses penyambungan seperti yang ditunjukkan dalam alur GHA.

Jika Anda mengalami masalah saat menyambungkan dengan GHA di perangkat seluler:

  1. Pastikan Anda memiliki Developer opsi diaktifkan untuk perangkat seluler Anda.
  2. Segera setelah upaya penyambungan yang gagal, ambil bug laporan.

Android SDK

Mengimplementasikan Android SDK kami untuk menyambungkan perangkat Matter dan mengelola jaringan Thread di aplikasi Anda

Android SDK telah tersedia di Play services untuk pengujian dan penyambungan di aplikasi pihak ketiga.

Sebaiknya mulai dengan Google Home Sample App for Matter, yang menggambarkan bagaimana untuk melakukan commissioning, menyambungkan, dan mengontrol perangkat berkemampuan Matter di ekosistem Google Home dengan SDK ini.

Dokumentasi referensi untuk kedua SDK tersedia di situs ini:

Batasan pemasangan

Perangkat Matter hanya bisa disambungkan di Google Home ekosistem dalam skenario ID Vendor dan jenis perangkat tertentu.

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • VID produksi Anda harus diterbitkan oleh Connectivity Standards Alliance (Alliance). Google akan memvalidasi bahwa Anda adalah pemilik VID tersebut sebelum dapat menggunakannya di Google Home Developer Console. Setelah itu terjadi, Anda akan dapat membuat integrasi untuk VID tersebut.
  • Untuk tujuan pengembangan dan uji coba lapangan, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. commissioning pengguna perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah disertifikasi oleh Alliance.
Tabel: ID Vendor (VID) dan jenis perangkat skenario penyambungan
Jenis pengguna mana yang dapat melakukan komisi perangkat Anda ke ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)
Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Tes Tidak ada integrasi di Developer Console (tidak dapat disertifikasi)
Tes Integrasi ada di Developer Console (tidak boleh tersertifikasi)
Produksi Tidak tersertifikasi, integrasi tidak ada di Developer Console
Produksi Tidak tersertifikasi, integrasi ada di Developer Console
Produksi Tersertifikasi dalam DCL Alliance, integrasi tidak ada dalam Developer Console
Produksi Disertifikasi di DCL Alliance dan integrasi ada di Developer Console

Informasi perangkat

Informasi teknis untuk perangkat yang disambungkan dapat dilihat di GHA.

  1. Di GHA, pilih perangkat.
  2. Ketuk ikon di bagian atas ke kanan.
  3. Ketuk Informasi teknis.

ID seperti Manufacturer, Model, dan Hardware version memiliki dari firmware Matter pada perangkat, bukan dari Developer Console. Misalnya, CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME dan CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME nilai dalam konfigurasi perangkat di Matter SDK.

Pengenal ini dapat berguna untuk memvalidasi perangkat mana yang telah dipasangkan Test, terutama saat menggunakan ID Vendor pengujian dan ID produk (yang dapat diduplikasi di berbagai integrasi).

Memecahkan masalah penyambungan

Jika Anda telah menyambungkan perangkat dengan ID Vendor (VID) dan ID Produk (PID) pengujian, tetapi keterangan tidak muncul saat Anda mencoba menguji perangkat dengan Suite di Developer Console, hal ini mungkin disebabkan oleh menggunakan kombo VID dan PID pengujian yang sama di beberapa integrasi.

Untuk memecahkan masalah, hapus semua perangkat pengujian dari Developer Console dan sambungkan perangkat yang ingin Anda uji lagi.

Untuk memvalidasi bahwa Anda telah memasangkan produk yang benar, Anda dapat menyetel Produsen dan Informasi model (nilai CHIP_DEVICE_CONFIG_DEVICE_*) untuk perangkat nilai unik dalam firmware pengujian Anda.

Lihat Informasi perangkat untuk mengetahui informasi selengkapnya tidak akurat atau tidak sesuai.