Przetestuj OTA na Espressif ESP32

Poniższe instrukcje wykorzystują przykładową aplikację do oświetlenia z pakietu SDK Matter oraz płytę deweloperską M5Stack ESP32.

Konfiguracja środowiska kompilacji

Najpierw skopiuj pakiet SDK Matter.

W tym przykładzie sprawdzamy minimalne obsługiwane zobowiązanie w przypadku wersji 5 systemu Google Home Matter:

$ 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

Następnie sprawdzamy wersję używaną w przepływie pracy GitHub ESP32, aby określić, który obraz Dockera najlepiej pasuje do naszej kompilacji:

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

Uruchamiamy kontener z obrazu Dockera, przekazując flagi umożliwiające podłączenie pakietu SDK Matter do kontenera i zapewnienie dostępu do urządzenia EP32.

$ 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

Zatrzymywanie i uruchamianie kontenera Dockera Matter

Po każdym uruchomieniu polecenia docker run tworzysz nowy kontener z określonym obrazem. Gdy to zrobisz, stare dane zapisane w poprzedniej instancji kontenera zostaną utracone. Czasem tak się dzieje, bo pozwala to zacząć od nowej instalacji. Jednak w tym przypadku najprawdopodobniej zechcesz zapisywać konfigurację środowiska pracy i środowiska między sesjami.

user@host> docker stop container_name

Jeśli chcesz ponownie uruchomić kontener, uruchom kontener i otwórz okno terminala:

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

Możesz otworzyć dodatkowe sesje terminala w kontenerze, używając:

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

Możesz też rozpocząć sesję główną za pomocą:

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

Inicjowanie pakietu SDK

W kontenerze inicjujemy pakiet SDK Matter i identyfikator ESP IDF:

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

Tworzenie i flashowanie

Następnym zadaniem jest utworzenie obrazu i wdrożenie pakietu dla programistów w celu otrzymania aktualizacji oprogramowania OTA Matter.

W tym celu musisz utworzyć obraz.

Najpierw skonfiguruj kompilację za pomocą narzędzia menuconfig z identyfikatora ESP IDF.

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

W interaktywnym menu skonfiguruj te ustawienia:

  1. Component config --->

  2. CHIP Device Layer --->

  3. Device Identification Options --->

  4. Ustaw Vendor ID na swój identyfikator VID przypisany do Connectivity Standards Alliance (Alliance).

  5. Ustaw Product ID na identyfikator PID ustawiony w integracji Matter w Google Home Developer Console.

Włącz flagę żądania OTA:

  1. Component config -->

  2. CHIP Core -->

  3. System options --->

  4. Włącz flagę żądania OTA [*] Enable OTA Requestor

  5. Naciśnij dwukrotnie ESC, aby powrócić do menu najwyższego poziomu.

Włącz flagę tworzenia obrazu OTA Matter:

  1. Component config -->

  2. CHIP Device Layer --->

  3. Matter OTA Image --->

  4. [*] Generate OTA IMAGE

Ustaw numer wersji:

  1. Application manager --->

  2. Wybierz [*] Get the project version from Kconfig

  3. Ustaw Project version (NEW) na 1.0

  4. Naciśnij S, aby zapisać konfigurację, naciśnij dwukrotnie Enter, a następnie Q, aby wyjść z menuconfig.

Konfigurowanie certyfikatów testowych

Wykonaj czynności opisane w artykule Tworzenie certyfikatów testowych urządzeń Matter, aby utworzyć certyfikaty CD, DAC i PAI.

Skompiluj urządzenie

Teraz uruchom kompilację i zainstaluj urządzenie:

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

Tworzenie i przesyłanie obrazu OTA

Teraz ponownie zmień ustawienia kompilacji, aby utworzyć obraz OTA. Użyj tego samego obrazu, ale z zwiększonym numerem wersji.

Uruchom menuconfig.

idf.py menuconfig

W interaktywnym menu zaktualizuj te elementy:

  1. Application manager --->
  2. Wybierz [*] Get the project version from Kconfig
  3. Ustaw Project version (NEW) na 2.0
  4. Naciśnij S, aby zapisać konfigurację, naciśnij dwukrotnie Enter, a następnie naciśnij Q, aby wyjść z menuconfig.

Skompiluj i pobierz obraz. Poniższy przykład pokazuje lokalizację obrazu na potrzeby aktualizacji OTA i danych wyjściowych podczas analizowania za pomocą 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

Pakiet SDK Matter jest podłączony z hosta kontenera, dlatego obraz OTA jest dostępny na hoście kontenera.

Prześlij obraz OTA do Developer Console, postępując zgodnie z instrukcjami przesyłania OTA.

Komisję Google Home i obserwuj OTA.

Upewnij się, że urządzenie jest podłączone do hosta z systemem Linux przez USB. Poniższy przykład pokazuje wykorzystanie programu GNU screen do odczytu dzienników urządzenia:

screen -L /dev/ttyUSB0 115200

Spowoduje to wyświetlenie w terminalu danych wyjściowych urządzenia i zapisanie tych samych danych wyjściowych w domyślnym pliku logu ekranu o nazwie screenlog.0.

Możesz otworzyć plik screenlog.0 w innym edytorze tekstu lub wyświetlić go w innej powłoce przy użyciu cat, tail, more lub grep.

Naciśnij czerwony przycisk resetowania z boku urządzenia, aby wyświetlić logi z rozruchu.

W danych wyjściowych urządzenia powinny być widoczne ustawione wcześniej VID i PID oraz URL obrazu z kodem QR, którego użyjesz do uruchomienia urządzenia.

[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

Upewnij się, że Hub jest online w domu.

Prześlij urządzenie za pomocą identyfikatora Google Home app (GHA), korzystając z kodu QR dostępnego w linku w pliku dziennika.

Po uruchomieniu urządzenie powinno działać bez przerw przez kilka minut. W dzienniku powinny pojawić się dane wyjściowe dotyczące żądania OTA, pobierania obrazów OTA i OTAImageProcessor.

Po zainstalowaniu obrazu zwróć uwagę, że czas kompilacji obrazu jest zgodny z czasem przesłanym do konsoli i jest późniejszy niż czas kompilacji podany przy pierwszym uruchomieniu. Wykonanie polecenia grep z tym wzorem w trybie wyrażenia regularnego na stronie screenlog.0 może zilustrować proces 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

Po wstępnym uruchomieniu możesz powtórzyć czynności opisane w sekcji Tworzenie i przesyłanie obrazu OTA bez przesyłania nowego obrazu. Tym razem ustaw wersje z powrotem na 1.

Uruchom menuconfig i w interaktywnym menu wykonaj te czynności:

  1. Component config -->

  2. CHIP Device Layer --->

  3. Device Identification Options

  4. Ustaw Version String na v1.0.

  5. Ustaw Device Software Version Number na 1.

  6. Naciśnij s, aby zapisać konfigurację, a następnie q, aby wyjść z menuconfig.

Usuń urządzenie z domu w aplikacji GHA.

Utwórz obraz, jeśli nie został jeszcze utworzony:

idf.py build

Flash-a:

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

W razie potrzeby powtórz czynności opisane w artykule Prowizja do Google Home i obserwuj OTA.

Sprawdzanie aktualizacji oprogramowania OTA

Wersję oprogramowania urządzenia można sprawdzić w aplikacji Google Home (GHA). Po oddaniu urządzenia do użytku wykonaj te czynności:

  1. Przytrzymaj kafelek urządzenia na ekranie głównym aplikacji GHA
  2. W prawym górnym rogu kliknij ikonę .
  3. Kliknij Informacje techniczne.
  4. Sprawdź pole Wersja oprogramowania

Ekran aplikacji Google Home z polem wersji oprogramowania