Тестирование OTA на Nordic

В следующих инструкциях используется пример приложения освещения из Matter SDK вместе с платой разработки Nordic nRF52840.

Настройка среды

Эти инструкции основаны на установке набора инструментов nRF Connect на основе Docker. Если вы предпочитаете не использовать Docker, инструкции по установке nRF Connect на хост-компьютер находятся на сайте Nordic .

Ознакомьтесь с 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

Проверьте правильный образ Docker, который будет использоваться. Используйте один из образов, созданных для непрерывной интеграции Matter SDK.

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

Подключите плату Nordic к компьютеру. Проверьте нумерацию USB последовательного интерфейса:

В MacOS:

user@host> ls /dev/tty.usbmodem*
/dev/tty.usbmodem0123456789000

В Linux либо:

user@host> ls /dev/tty*AC*
/dev/ttyACM0

или

user@host> ls /dev/tty*USB*
/dev/ttyUSB0

Запустите контейнер, используя информацию, собранную предыдущей командой. Передайте флаги для монтирования папки Host Matter SDK и последовательного интерфейса USB в контейнер.

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

Остановите и запустите контейнер Matter Docker.

Всякий раз, когда вы запускаете команду docker run , вы создаете новый контейнер с указанным образом. При этом ваши старые данные, сохраненные в предыдущем экземпляре контейнера, будут потеряны. Иногда это то, что вам нужно, потому что это позволяет вам начать новую установку. Но в этом примере вы, скорее всего, захотите сохранить конфигурацию своей работы и среды между сеансами.

user@host> docker stop container_name

Когда вы будете готовы снова запустить контейнер, запустите контейнер и откройте окно терминала:

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

Вы можете открыть дополнительные сеансы терминала для вашего контейнера с помощью:

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

Или запустите корневой сеанс, используя: 

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

Инициализируйте SDK

В контейнере инициализируйте Matter SDK и переменные среды для цепочки инструментов Nordic nRF52. Инициализация Matter SDK часто занимает несколько минут. 

$ 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

Сборка и прошивка

Настройте VID и PID для устройства:

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

В опциях интерактивного меню:

  1. Modules --->

  2. connectedhomeip --->

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

  4. Введите Device vendor ID (VID) и Device product ID (PID) в целочисленном формате по основанию 10.

  5. Убедитесь, что установлен флаг [*] Enable OTA requestor .

  6. Нажмите s , чтобы сохранить конфигурацию, нажмите Enter для подтверждения, затем q , чтобы выйти из menuconfig .

Настройка сертификатов испытаний

Следуйте инструкциям в разделе «Создание тестовых сертификатов устройств Matter» , чтобы создать сертификаты CD, DAC и PAI.

Создайте свое устройство 

$ west build -b nrf52840dk_nrf52840

Прошейте свое устройство

Это делается на главном компьютере, а не в контейнере Docker.

Если у вас еще нет инструментов командной строки nRFConnect, загрузите и установите их .

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

Откройте терминальное соединение с вашим устройством либо на хосте, либо в контейнере. Используйте свой любимый инструмент терминала, такой как minicom или GNU screen . 

user@host> minicom -c on -D /dev/ttyACM0 115200

user@host> screen /dev/ttyACM0 115200

Создайте и загрузите OTA-образ

После прошивки устройства еще раз измените настройки сборки, чтобы создать OTA-образ с увеличенной версией программного обеспечения устройства.

Запустите menuconfig Zephyr:

$ west build -b nrf52840dk_nrf52840 -t menuconfig

В опциях интерактивного меню:

  1. Modules -->

  2. connectedhomeip -->

  3. Connected Home over IP protocol stack -->

  4. Измените Device Software Version на 2 .

  5. Измените Device Software Version String на prerelease-2 .

  6. Нажмите s , чтобы сохранить конфигурацию, нажмите Enter для подтверждения, затем q , чтобы выйти из menuconfig .

Создайте новый файл пакета Matter OTA. Вывод помещается в 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

Подтвердите свойства созданного вами файла пакета Matter OTA:

/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

Поскольку Matter SDK монтируется с вашего хоста контейнера, OTA-образ также доступен на вашем хосте контейнера. Загрузите изображение OTA в Google Home Developer Console , следуя инструкциям по загрузке OTA .

Запустите устройство и наблюдайте за процессом OTA.

Откройте терминальное соединение с устройством либо на хосте, либо в контейнере. Используйте свой любимый терминал, например minicom или GNU screen :

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

Нажмите кнопку сброса устройства, чтобы просмотреть журналы загрузки.

В выходных данных устройства вы должны увидеть установленные вами VID и PID, а также URL-адрес QR-кода для ввода в эксплуатацию:

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

Убедитесь, что ваш хаб подключен к сети, и включите устройство с помощью Google Home app (GHA) используя QR-код по ссылке, найденной в журнале.

После ввода в эксплуатацию оставьте устройство вести журнал своей деятельности.

В журнале устройства вы должны увидеть следующий текст:

/* 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

После применения образа устройство перезагружается. После перезагрузки время компиляции образа должно совпадать со временем, загруженным в Developer Console .

Подтвердите обновление программного обеспечения OTA

Версию программного обеспечения устройства можно проверить с помощью приложения Google Home (GHA). После ввода устройства в эксплуатацию выполните следующие процедуры:

  1. Нажмите и удерживайте плитку устройства на главном экране GHA
  2. Нажмите значок в правом верхнем углу.
  3. Нажмите Техническая информация.
  4. Проверьте поле «Версия программного обеспечения».

Экран приложения Google Home с полем версии программного обеспечения