Menyambungkan perangkat Masalah

Sambungkan perangkat yang mendukung Matter. Untuk melakukannya, Anda perlu 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. Periksa konsol serial Anda dan Anda seharusnya 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. Periksa 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 dalam URL, yang dicetak di konsol serial saat papan 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 booting, Anda akan menemukan kode QR di layar LCD 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

Pasangkan 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 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 muncul prompt terkait 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 pengembang untuk perangkat seluler Anda.
  2. Segera setelah upaya penyambungan yang gagal, ambil laporan bug.

Android SDK

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

Android SDK telah tersedia di Play services untuk diuji dan disambungkan 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 di ekosistem Google Home 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 Anda dapat menggunakannya di Google Home Developer Console. Setelah itu, 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 disertifikasi oleh Alliance.
Tabel: Skenario penyambungan ID vendor (VID) dan jenis perangkat
Jenis pengguna manakah yang dapat memesan perangkat ke ekosistem Google Home?
Jenis VID Sertifikasi VID dan status integrasi konsol Produksi
(Pengguna konsumen)		 Pengembangan
(Developer, pengguna Uji Coba Lapangan)
Pengujian Tidak ada integrasi di 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 integrasinya 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 pengujian dan ID Produk (yang dapat diduplikasi di seluruh integrasi).

Memecahkan masalah penyambungan

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

Sebelumnya
Layanan &modul Matter modul
Berikutnya
Mengontrol perangkat Masalah