В следующих инструкциях используется пример приложения освещения из 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
В опциях интерактивного меню:
Modules --->
connectedhomeip --->
[*] Connected Home over IP protocol stack --->
Введите
Device vendor ID
(VID) иDevice product ID
(PID) в целочисленном формате по основанию 10.Убедитесь, что установлен флаг
[*] Enable OTA requestor
.Нажмите 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
В опциях интерактивного меню:
Modules -->
connectedhomeip -->
Connected Home over IP protocol stack -->
Измените
Device Software Version
на2
.Измените
Device Software Version String
наprerelease-2
.Нажмите 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). После ввода устройства в эксплуатацию выполните следующие процедуры:
- Нажмите и удерживайте плитку устройства на главном экране GHA
- Нажмите значок в правом верхнем углу.
- Нажмите Техническая информация.
- Проверьте поле «Версия программного обеспечения» .