Menyambungkan perangkat Masalah

Sambungkan perangkat yang mendukung Matter. Untuk melakukannya, Anda memerlukan kode QR untuk penyambungan. Bergantung pada platform perangkat Matter, Anda mungkin perlu membuat kode QR ini sendiri.

Dapatkan kode QR

Lab Bouffalo

BL602

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Lihat konsol serial 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 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.

CameraX

K32W

String kode QR dicetak di konsol serial saat perangkat melakukan booting. Lihat konsol serial dan Anda akan 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

Ame D

Kode QR dienkode dalam URL, yang dicetak di konsol serial 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 Silikon

EFR32MG12

Setelah board booting, Anda akan menemukan kode QR di layar LCD yang kecil.

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

Sambungkan perangkat

Ada dua cara untuk menyambungkan perangkat:

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

Kedua metode menggunakan API Jaringan Matter dan Thread yang sama.

Aplikasi Google Home

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

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

  1. Pastikan Anda telah mengaktifkan Opsi developer untuk perangkat seluler.
  2. Segera setelah upaya penyambungan gagal, ambil laporan bug.

SDK Android

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

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

Sebaiknya mulai dengan Google Home Sample App for Matter, yang menggambarkan cara membuat, menyambungkan, dan mengontrol perangkat yang mengaktifkan Matter di ekosistem Google Home dengan SDK ini.

Dokumentasi referensi untuk kedua SDK tersedia di situs ini:

Batasan penyambungan

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

  • VID pengujian tidak dapat digunakan di perangkat konsumen.
  • VID produksi Anda harus dikeluarkan paling lambat Connectivity Standards Alliance (Alliance). Google akan memvalidasi Anda sebagai pemilik VID tersebut sebelum dapat menggunakannya di Google Home Developer Console. Setelah itu, Anda dapat membuat integrasi untuk VID tersebut.
  • Untuk tujuan pengembangan dan uji coba kolom, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. Pengguna yang meminta perangkat harus merupakan anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah mendapatkan sertifikasi dari Alliance.
Tabel: ID vendor (VID) dan skenario penyambungan jenis perangkat
Jenis pengguna mana yang dapat menetapkan perangkat ke ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)
Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Uji Tidak ada integrasi di Developer Console (tidak dapat disertifikasi)
Uji Integrasi ada di Developer Console (tidak dapat disertifikasi)
Produksi Tidak tersertifikasi, integrasi tidak ada di Developer Console
Produksi Tidak tersertifikasi, integrasi ada di Developer Console
Produksi Tersertifikasi di DCL Alliance, integrasi tidak ada di Developer Console
Produksi Tersertifikasi 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 kanan atas.
  3. Ketuk Informasi teknis.

ID seperti Produsen, Model, dan Versi hardware berasal dari firmware Matter pada perangkat, bukan dari Developer Console. Misalnya, nilai CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME dan CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME di konfigurasi perangkat di Matter SDK.

ID ini dapat berguna untuk memvalidasi perangkat yang telah disambungkan untuk tujuan Pengujian, terutama saat menggunakan ID Vendor dan ID Produk pengujian (yang dapat diduplikasi di seluruh integrasi).

Memecahkan masalah penyambungan

Jika Anda telah menyambungkan perangkat dengan ID Vendor pengujian (VID) dan ID Produk (PID), tetapi perangkat tidak muncul saat Anda mencoba menguji perangkat dengan Test Suite di Developer Console, hal ini kemungkinan disebabkan oleh penggunaan 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 diuji lagi.

Untuk memvalidasi bahwa Anda telah menyambungkan perangkat yang benar, Anda dapat menetapkan informasi Produsen dan Model (nilai CHIP_DEVICE_CONFIG_DEVICE_*) untuk perangkat ke nilai unik dalam firmware pengujian.

Lihat Informasi perangkat untuk mengetahui informasi selengkapnya.