Тестирование OTA на Espressif ESP32

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

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

Сначала клонируйте SDK Matter .

В этом примере мы рассмотрим минимально поддерживаемый коммит для пятого релиза Matter в Google Home:

mkdir otaprep
cd otaprep
git clone https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
git fetch origin v1.0-branch
git checkout FETCH_HEAD
git submodule update --init --recursive
source ./scripts/activate.sh

Далее мы проверяем версию, используемую в рабочем процессе ESP32 GitHub, чтобы определить, какой образ Docker лучше всего подходит для нашей сборки:

cat .github/workflows/examples-esp32.yaml | grep chip-build | head -n 1
image: connectedhomeip/chip-build-esp32:0.5.99

Мы запускаем контейнер из образа Docker, передавая флаги для монтирования SDK Matter в контейнере и предоставления доступа к устройству ESP32.

docker run --name container_name -it --user $(id -u):$(id -g)--mount source=$(pwd),target=/workspace,type=bind --device=/dev/ttyUSB0 connectedhomeip/chip-build-esp32:0.5.99 /bin/bash

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

При каждом запуске команды 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

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

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

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

В контейнере мы инициализируем Matter SDK и ESP IDF: 

cd /workspace
git submodule update --init --recursive
source ./scripts/activate.sh
source /opt/espressif/esp-idf/export.sh

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

Следующая задача — собрать образ и прошить комплект разработчика для получения OTA-обновления прошивки Matter .

Для этого необходимо создать изображение.

Сначала настройте сборку, используя утилиту menuconfig из ESP IDF. 

cd examples/lighting-app/esp32
idf.py menuconfig

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

  1. Component config --->

  2. CHIP Device Layer --->

  3. Device Identification Options --->

  4. Установите Vendor ID ) равным идентификатору поставщика (VID), присвоенному вам Connectivity Standards Alliance (Alliance) .

  5. Установите Product ID равным идентификатору продукта, который вы задали для интеграции Matter в Google Home Developer Console .

Включите флаг «Запрос OTA»:

  1. Component config -->

  2. CHIP Core -->

  3. System options --->

  4. Включить флаг OTA Requestor [*] Enable OTA Requestor

  5. Нажмите ESC дважды, чтобы вернуться в главное меню.

Включите флаг создания образа Matter OTA:

  1. Component config -->

  2. CHIP Device Layer --->

  3. Matter OTA Image --->

  4. [*] Generate OTA IMAGE

Установите номер версии:

  1. Application manager --->

  2. Выберите [*] Get the project version from Kconfig

  3. Установите Project version (NEW) на 1.0

  4. Нажмите s для сохранения конфигурации, дважды нажмите Enter , затем q для выхода из menuconfig .

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

Для создания сертификатов CD, DAC и PAI выполните действия, описанные в разделе «Создание сертификатов для тестирования устройств Create Matter» .

Соберите своё устройство

Теперь запустите сборку и прошейте устройство: 

idf.py build
idf.py -p /dev/ttyUSB0 erase_flash
idf.py -p /dev/ttyUSB0 flash

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

Теперь снова измените параметры сборки, чтобы создать образ OTA. Используйте тот же образ, но с увеличенным номером версии.

Запустите menuconfig . 

idf.py menuconfig

В интерактивном меню обновите следующие данные:

  1. Application manager --->
  2. Выберите [*] Get the project version from Kconfig
  3. Установите Project version (NEW) на 2.0
  4. Нажмите s для сохранения конфигурации, дважды нажмите Enter , затем нажмите q для выхода из menuconfig .

Создайте и получите образ. В примере показано как местоположение образа для OTA, так и результат его обработки с помощью скрипта ota_image_tool.py . 

cd build && /workspace/src/app/ota_image_tool.py show ./chip-lighting-app-ota.bin

Результат выглядит следующим образом: 

Magic: 1beef11e
Total Size: 1243360
Header Size: 64
Header TLV:
  [0] Vendor Id: XXXXX (0x000)
  [1] Product Id: XXXXX (0x000)
  [2] Version: 2 (0x2)
  [3] Version String: v2.0
  [4] Payload Size: 1243280 (0x12f890)
  [8] Digest Type: 1 (0x1)
  [9] Digest: e367f4d71e2ccd554b9a399c864abbf2c039382ef1def1b986fb2f59a99923a8

Поскольку SDK Matter монтируется с хоста вашего контейнера, образ OTA будет доступен на вашем хосте контейнера.

Загрузите образ OTA в Developer Console , следуя инструкциям по загрузке OTA .

Выплатить комиссию Google Home и следить за OTA

Убедитесь, что ваше устройство подключено к хост-машине под управлением Linux через USB. В следующем примере показано использование GNU screen для чтения журналов устройства: 

screen -L /dev/ttyUSB0 115200

Эта команда выводит вывод с устройства на ваш терминал и записывает тот же вывод в стандартный файл журнала экрана с именем screenlog.0 .

Вы можете открыть файл screenlog.0 в другом текстовом редакторе или отобразить его в другой оболочке с помощью команд cat , tail , more или grep .

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

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

[0;32mI (2388) chip[DIS]: Advertise commission parameter vendorID=XXXXX productID=XXXX discriminator=3840/15 cm=1[0m

[0;32mI (1928) chip[SVR]: SetupQRCode: [MT:E59-000000000000000][0m

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AE59-000000000000000

Убедитесь, что ваш Hub подключен к интернету у вас дома.

Введите устройство в эксплуатацию с помощью Google Home app (GHA) используя QR-код по ссылке, которая появится в файле журнала.

После ввода устройства в эксплуатацию дайте ему поработать без перерыва несколько минут. Вы должны увидеть вывод логов, относящийся к OTA Requestor, OTA Image download и OTAImageProcessor .

После установки образа обратите внимание, что время компиляции образа совпадает с временем компиляции образа, загруженного в консоль, и превышает время компиляции, указанное при первой загрузке. Выполнение grep со следующим шаблоном в режиме регулярных выражений на screenlog.0 может проиллюстрировать процесс OTA: 

grep -E "(Compile time|OTA)" screenlog.0

Результат выглядит следующим образом: 

I (76) boot:  1 otadata          OTA data         01 00 0000f000 00002000
I (91) boot:  3 ota_0            OTA app          00 10 00020000 00177000
I (99) boot:  4 ota_1            OTA app          00 11 001a0000 00177000
I (645) cpu_start: Compile time:     Oct 15 2022 06:21:59
I (135558) chip[SWU]: OTA Requestor received AnnounceOTAProvider
I (540658) chip[SWU]: OTA image downloaded to offset 0x1a0000
I (541348) OTAImageProcessor: Applying, Boot partition set offset:0x1a0000
I (76) boot:  1 otadata          OTA data         01 00 0000f000 00002000
I (91) boot:  3 ota_0            OTA app          00 10 00020000 00177000
I (99) boot:  4 ota_1            OTA app          00 11 001a0000 00177000
I (645) cpu_start: Compile time:     Oct 15 2022 07:35:31
I (76) boot:  1 otadata          OTA data         01 00 0000f000 00002000
I (91) boot:  3 ota_0            OTA app          00 10 00020000 00177000
I (99) boot:  4 ota_1            OTA app          00 11 001a0000 00177000
I (645) cpu_start: Compile time:     Oct 15 2022 07:35:31

После первоначального выполнения вы можете повторить шаги из раздела «Создание и загрузка образа OTA» без загрузки нового образа. На этот раз установите версии обратно на 1 .

Запустите menuconfig и в интерактивном меню выберите следующие пункты:

  1. Component config -->

  2. CHIP Device Layer --->

  3. Device Identification Options

  4. Установите Version String на v1.0 .

  5. Установите Device Software Version Number равным 1 .

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

Удалите устройство из своего дома в районе GHA .

Создайте образ, если он еще не создан: 

idf.py build

Покажи это: 

idf.py -p /dev/ttyUSB0 erase_flash
idf.py -p /dev/ttyUSB0 flash

Повторите шаги, описанные в разделе «Ввод в эксплуатацию Google Home», и при необходимости следите за обновлениями по воздуху (OTA) .

Проверьте работоспособность обновления программного обеспечения по беспроводной сети (OTA).

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

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

На экране приложения Google Home отображается поле версии программного обеспечения.