Petunjuk berikut menggunakan contoh aplikasi pencahayaan dari SDK Matter bersama dengan board pengembangan Nordic nRF52840.
Penyiapan Lingkungan
Petunjuk ini didasarkan pada penginstalan toolchain nRF Connect berbasis Docker. Jika Anda memilih untuk tidak menggunakan Docker, petunjuk untuk menginstal nRF Connect secara native di komputer host di situs Nordik.
Lihat Matter SDK
user@host> mkdir otaprep
user@host> cd otaprep
user@host> git clone https://github.com/project-chip/connectedhomeip.git
user@host> cd connectedhomeip/
user@host> git fetch origin v1.0-branch
user@host> git checkout FETCH_HEAD
Periksa image Docker yang benar untuk digunakan. Gunakan salah satu gambar yang dibuat untuk integrasi berkelanjutan SDK Matter.
user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
image: connectedhomeip/chip-build-nrf-platform:0.5.99
Hubungkan board Nordik ke komputer. Periksa enumerasi USB pada antarmuka serialnya:
Di MacOS:
user@host> ls /dev/tty.usbmodem*
/dev/tty.usbmodem0123456789000
Di Linux:
user@host> ls /dev/tty*AC*
/dev/ttyACM0
atau
user@host> ls /dev/tty*USB*
/dev/ttyUSB0
Jalankan penampung menggunakan informasi yang dikumpulkan pada perintah sebelumnya. Teruskan flag untuk memasang folder SDK Matter host dan antarmuka seri USB ke container.
user@host> docker run --name container_name -it --user $(id -u):$(id -g) --mount source=$(pwd),target=/workspace,type=bind connectedhomeip/chip-build-nrf-platform:0.5.99 /bin/bash
Menghentikan dan memulai container Matter Docker
Setiap kali menjalankan perintah docker run
, Anda akan membuat penampung baru dengan
gambar yang ditentukan. Saat melakukannya, data lama Anda, yang disimpan di instance container sebelumnya, akan hilang. Terkadang inilah yang Anda inginkan, karena memungkinkan Anda memulai penginstalan baru. Namun, dalam contoh ini, kemungkinan besar Anda ingin menyimpan konfigurasi pekerjaan dan lingkungan di antara sesi.
user@host> docker stop container_name
Setelah Anda siap menjalankan lagi, mulai penampung dan buka jendela terminal:
user@host> docker start container_name
user@host> docker exec -it container_name /bin/bash
Anda dapat membuka sesi terminal tambahan ke penampung Anda dengan:
user@host> docker exec -it container_name /bin/bash
Atau mulai sesi root menggunakan:
user@host> docker exec -u 0 -it container_name /bin/bash
Menginisialisasi SDK
Dalam penampung, lakukan inisialisasi Matter SDK dan variabel lingkungan untuk toolchain Nordic nRF52. Inisialisasi SDK Matter sering kali memakan waktu beberapa menit.
$ cd /workspace
$ git submodule update --init --recursive
$ source ./scripts/bootstrap.sh
$ source ./scripts/activate.sh
$ export ZEPHYR_BASE=/opt/NordicSemiconductor/nrfconnect/zephyr
$ export GNUARMEMB_TOOLCHAIN_PATH="$PW_ARM_CIPD_INSTALL_DIR"
$ scripts/run_in_build_env.sh "python3 scripts/setup/nrfconnect/update_ncs.py --update --shallow"
$ source /opt/NordicSemiconductor/nrfconnect/zephyr/zephyr-env.sh
Melakukan Build dan Flash
Konfigurasikan VID dan PID untuk perangkat:
$ cd examples/lighting-app/nrfconnect
$ west build -b nrf52840dk_nrf52840 -t menuconfig
Di opsi menu interaktif:
Modules --->
connectedhomeip --->
[*] Connected Home over IP protocol stack --->
Masukkan
Device vendor ID
(VID) danDevice product ID
(PID) dalam format bilangan bulat dasar-10.Pastikan tanda
[*] Enable OTA requestor
dipilih.Tekan s untuk menyimpan konfigurasi, tekan Enter untuk mengonfirmasi, lalu q untuk keluar dari
menuconfig
.
Menyiapkan sertifikat pengujian
Ikuti langkah-langkah di bagian Membuat sertifikat pengujian perangkat Matter untuk membuat sertifikat CD, DAC, dan PAI.
Membuat perangkat
$ west build -b nrf52840dk_nrf52840
Mem-flash perangkat
Ini dilakukan di komputer host, bukan di penampung Docker.
Jika Anda belum memiliki alat command line nRFConnect, download dan instal alat tersebut.
user@host> nrfjprog --program build/zephyr/merged.hex --chiperase -f NRF52
Buka koneksi terminal ke perangkat baik di host maupun di
penampung. Gunakan alat terminal favorit Anda, seperti minicom
atau GNU screen
.
user@host> minicom -c on -D /dev/ttyACM0 115200
user@host> screen /dev/ttyACM0 115200
Membuat dan mengupload image OTA
Setelah Anda melakukan flash perangkat, ubah setelan build sekali lagi untuk membuat image OTA dengan versi software perangkat yang ditingkatkan.
Luncurkan Zephyr menuconfig
:
$ west build -b nrf52840dk_nrf52840 -t menuconfig
Di opsi menu interaktif:
Modules -->
connectedhomeip -->
Connected Home over IP protocol stack -->
Ubah
Device Software Version
menjadi2
.Ubah
Device Software Version String
menjadiprerelease-2
.Tekan s untuk menyimpan konfigurasi, tekan Enter untuk mengonfirmasi, lalu q untuk keluar dari
menuconfig
.
Build file paket OTA Matter baru. Outputnya ditempatkan
di build/zephyr/zephyr.bin
.
$ /workspace/src/app/ota_image_tool.py create -v hex_VID -p hex_PID -vn version_no -vs version_string path_to_binary -da digest_algorithm path_to_ota_file
Konfirmasi properti file paket OTA Matter yang dibuat:
/workspace/examples/lighting-app/nrfconnect# /workspace/src/app/ota_image_tool.py show firmware-ota-update-test.bin
Magic: 1beef11e
Total Size: 951784
Header Size: 72
Header TLV:
[0] Vendor Id: XXXXX (0xXXXX)
[1] Product Id: 32768 (0x8000)
[2] Version: 2 (0x2)
[3] Version String: prerelease-2
[4] Payload Size: 951696 (0xe8590)
[8] Digest Type: 1 (0x1)
[9] Digest: 75f2e8b0c8e922b8bb3841504190bcdd83533e936a284c7254d29327d605c930
Karena Matter SDK dipasang dari host penampung, Image OTA juga tersedia di host penampung. Upload image OTA ke Google Home Developer Console dengan mengikuti petunjuk upload OTA.
Komisikan perangkat dan amati proses OTA.
Buka koneksi terminal ke perangkat di host atau di
penampung. Gunakan terminal favorit Anda, seperti minicom
atau GNU screen
:
$ minicom -c on -D /dev/ttyACM0 115200
Tekan tombol reset pada perangkat untuk melihat log dari booting.
Di output perangkat, Anda akan melihat VID dan PID yang Anda tetapkan, serta URL untuk kode QR komisi:
I: nRF5 802154 radio initialized
I: 4 Sectors of 4096 bytes
(...)
I: 681 [SVR]Server Listening...
I: 684 [DL]Device Configuration:
I: 687 [DL] Serial Number: 11223344556677889900
I: 692 [DL] Vendor Id: XXXXX (0xXXXX)
I: 695 [DL] Product Id: XXXXX (0xXXXX)
I: 699 [DL] Hardware Version: 0
I: 702 [DL] Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
I: 708 [DL] Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
I: 714 [DL] Manufacturing Date: (not set)
I: 718 [DL] Device Type: 65535 (0xFFFF)
I: 723 [SVR]SetupQRCode: [MT:6FCJ142C00KA0648G00]
I: 727 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 733 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%000000000000000000000
I: 742 [SVR]Manual pairing code: [30900112302]
I: 747 [DL]CHIP task running
I: 752 [DL]CHIPoBLE advertising started
I: 757 [DL]NFC Tag emulation started
Pastikan Hub Anda online, dan buat perangkat dengan Google Home app (GHA) menggunakan kode QR dari link yang ada di log.
Biarkan perangkat mencatat aktivitasnya setelah komisi.
Anda akan melihat teks berikut di log perangkat:
/* Hub OTA provider identification */
I: 69642 [SWU]OTA Requestor received AnnounceOTAProvider
D: 69647 [SWU] FabricIndex: 1
D: 69649 [SWU] ProviderNodeID: 0x00000000XXXXXXXX
D: 69654 [SWU] VendorID: 0x6006
D: 69657 [SWU] AnnouncementReason: 0
D: 69660 [SWU] Endpoint: 2
...
D: 69799 [SWU]Establishing session to provider node ID 0x00000000FC843D94 on fabric index 1
...
D: 262265 [SWU]QueryImageResponse:
D: 262268 [SWU] status: 0
D: 262271 [SWU] imageURI: bdx://00000000FC843D94/37f09fd6-0000-0000-0000-000000000000
D: 262278 [SWU] softwareVersion: 2
D: 262281 [SWU] softwareVersionString: 2
D: 262285 [SWU] updateToken: 36
D: 262288 [SWU] userConsentNeeded: 0
D: 262292 [SWU]Update available from version 0 to 2
...
D: 262372 [SWU]Establishing session to provider node ID 0x00000000FC843D94 on fabric index 1
...
D: 262409 [SWU]BDX::SendMessage
Setelah gambar diterapkan, perangkat akan memulai ulang. Setelah memulai ulang, waktu kompilasi gambar harus cocok dengan yang diupload ke Developer Console.
Memvalidasi Update Software OTA
Versi software perangkat dapat diperiksa menggunakan Aplikasi Google Home (GHA). Setelah perangkat dibuat, ikuti prosedur berikut:
- Tekan lama kartu perangkat di layar utama GHA
- Ketuk ikon di kanan atas
- Ketuk Informasi teknis
- Periksa kolom Versi software