Menyambungkan perangkat Masalah

Sambungkan perangkat Anda yang mendukung Matter. Untuk melakukan ini, 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.

NXP

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

Amel 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 Silicon

EFR32MG12

Setelah board melakukan 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. SDK Jaringan Seluler Home dan Thread Google untuk Android (yang dapat digunakan di aplikasi pihak ketiga)

Kedua metode tersebut menggunakan API Jaringan Matter dan Thread yang sama.

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 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 yang gagal, buat laporan bug.

Android SDK

Implementasikan 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 cara melakukan komisi, menyambungkan, dan mengontrol perangkat yang mendukung Matter di ekosistem Google Home dengan SDK ini.

Dokumentasi referensi untuk kedua SDK tersedia di situs ini:

Batasan pemasangan

Perangkat Matter hanya dapat disambungkan dalam ekosistem Google Home dalam skenario jenis perangkat dan ID Vendor 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. Pengguna yang memesan perangkat harus merupakan anggota project atau disertakan dalam daftar pengguna uji coba lapangan.
  • Pengguna konsumen hanya dapat menggunakan produk Anda setelah produk tersebut disertifikasi oleh Alliance.
Tabel: Skenario penyambungan ID Vendor (VID) dan jenis perangkat
Jenis pengguna mana yang dapat memesan perangkat ke dalam ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)		 Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Pengujian Tidak ada integrasi dalam Developer Console (tidak dapat disertifikasi)
Pengujian 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 dalam DCL Alliance, integrasi tidak ada di Developer Console
Produksi Tersertifikasi dalam 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 Manufacturer, Model, dan Hardware version berasal dari firmware Matter di perangkat, bukan dari Developer Console. Misalnya, nilai CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME dan CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME dalam konfigurasi perangkat di Matter SDK.

ID ini dapat berguna untuk memvalidasi perangkat mana 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 (VID) dan ID Produk (PID) pengujian, tetapi 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 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 informasi selengkapnya.

Sebelumnya
Layanan &modul Matter modul
Berikutnya
Mengontrol perangkat Masalah