Menguji OTA di Nordik

Petunjuk berikut menggunakan aplikasi lampu contoh dari SDK Matter bersama dengan nRF52840 Nordik papan pengembangan aplikasi.

Penyiapan Lingkungan

Petunjuk ini didasarkan pada penginstalan berbasis Docker dari nRF Connect Rantai Alat (Toolchain). Jika Anda memilih untuk tidak menggunakan Docker, berikut petunjuk cara menginstal nRF Terhubung secara native di komputer host di situs Nordik.

Melihat 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

Memeriksa image Docker yang benar untuk digunakan. Gunakan salah satu {i>image<i} yang dibuat untuk continuous integration SDK Matter.

user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
            image: connectedhomeip/chip-build-nrf-platform:0.5.99

Hubungkan papan Nordic ke komputer. Periksa enumerasi USB dari 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 container menggunakan informasi yang dikumpulkan pada perintah sebelumnya. Lewat tanda untuk memasang folder SDK Matter host dan folder usb antarmuka serial 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 Docker Matter

Setiap kali menjalankan perintah docker run, Anda akan membuat container baru dengan gambar yang ditentukan. Saat Anda melakukannya, data lama, yang disimpan di instance container sebelumnya, akan hilang. Terkadang inilah yang ingin Anda terjadi, karena memungkinkan Anda memulai dengan instalasi baru. Namun, dalam hal ini Misalnya, kemungkinan besar Anda ingin menyimpan konfigurasi kerja dan lingkungan antar sesi.

user@host> docker stop container_name

Jika Anda sudah siap menjalankan operasi lagi, mulai container dan buka terminal periode:

user@host> docker start container_name
user@host> docker exec -it container_name /bin/bash

Anda dapat membuka sesi terminal tambahan ke penampung 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

Di penampung, lakukan inisialisasi Matter SDK dan variabel lingkungan untuk toolchain nRF52 Nordic. Tujuan Inisialisasi SDK Matter sering kali memerlukan 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

Build dan Flash

Konfigurasi VID dan PID untuk perangkat:

$ cd examples/lighting-app/nrfconnect
$ west build -b nrf52840dk_nrf52840 -t menuconfig

Di opsi menu interaktif:

  1. Modules --->

  2. connectedhomeip --->

  3. [*] Connected Home over IP protocol stack --->

  4. Masukkan Device vendor ID (VID) dan Device product ID (PID) di base-10 format bilangan bulat.

  5. Pastikan flag [*] Enable OTA requestor dipilih.

  6. Tekan s untuk menyimpan konfigurasi, tekan Enter untuk mengonfirmasi, lalu q untuk keluar dari menuconfig.

Menyiapkan sertifikat pengujian

Ikuti langkah-langkah di 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 container Docker.

Jika Anda belum memiliki alat baris perintah nRFConnect, unduh dan menginstal.

user@host> nrfjprog --program build/zephyr/merged.hex --chiperase -f NRF52

Buka koneksi terminal ke perangkat Anda baik di {i>host<i} atau di container. 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 melakukan flash perangkat, ubah setelan build sekali lagi untuk membuat {i>image<i} OTA dengan versi perangkat lunak perangkat yang bertambah.

Luncurkan Zephyr menuconfig:

$ west build -b nrf52840dk_nrf52840 -t menuconfig

Di opsi menu interaktif:

  1. Modules -->

  2. connectedhomeip -->

  3. Connected Home over IP protocol stack -->

  4. Ubah Device Software Version menjadi 2.

  5. Ubah Device Software Version String menjadi prerelease-2.

  6. Tekan s untuk menyimpan konfigurasi, tekan Enter untuk mengonfirmasi, lalu q untuk keluar dari menuconfig.

Bangun file paket OTA Matter baru. Output 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 paket OTA Matter yang dihasilkan file:

/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 container Anda, Image OTA juga tersedia di host container Anda. Upload image OTA ke Google Home Developer Console dengan mengikuti langkah upload OTA petunjuk.

Komisi perangkat dan amati proses OTA.

Buka koneksi terminal ke perangkat baik di {i>host<i} atau di container. Gunakan terminal favorit Anda seperti minicom atau GNU screen:

$ minicom -c on -D /dev/ttyACM0 115200

Tekan tombol reset perangkat untuk melihat log dari proses booting.

Di output perangkat, Anda akan melihat VID dan PID yang Anda setel, serta URL untuk kode QR pemesanan:

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 lakukan komisi perangkat dengan Google Home app (GHA) menggunakan kode QR dari link yang ditemukan di log.

Biarkan perangkat mencatat aktivitasnya setelah dijalankan.

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 image diterapkan, perangkat akan dimulai ulang. Setelah {i>reboot<i}, waktu kompilasi gambar harus sesuai dengan yang diupload ke Developer Console.

Memvalidasi Update Software OTA

Versi software perangkat dapat diperiksa menggunakan Aplikasi Google Home (GHA). Setelah perangkat ditugaskan, ikuti prosedur berikut:

  1. Tekan lama kartu perangkat di layar utama GHA
  2. Ketuk ikon di kanan atas
  3. Ketuk Informasi teknis
  4. Periksa kolom Versi software

Layar Aplikasi Google Home yang menampilkan kolom versi software