ทดสอบ OTA ใน Espressif ESP32

วิธีการต่อไปนี้ใช้ตัวอย่างแอป Lighting จาก Matter SDK ร่วมกับบอร์ดการพัฒนา M5Stack ESP32

การตั้งค่าสภาพแวดล้อมของบิลด์

ก่อนอื่นให้โคลน SDK ของ Matter

ในตัวอย่างนี้ เราจะตรวจสอบคอมมิตขั้นต่ำที่รองรับสำหรับMatterรุ่นที่ 5 ของ 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

หยุดและเริ่มคอนเทนเนอร์ 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 และ 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 เป็น PID ที่คุณตั้งค่าไว้ในการผสานรวม Matter ใน Google Home Developer Console

เปิดใช้การตั้งค่าสถานะผู้ส่งคำขอ OTA ดังนี้

  1. Component config -->

  2. CHIP Core -->

  3. System options --->

  4. เปิดใช้การตั้งค่าสถานะผู้ส่งคำขอ OTA [*] Enable OTA Requestor

  5. กด ESC สองครั้งเพื่อกลับไปยังเมนูระดับบนสุด

เปิดใช้แฟล็กการสร้างรูปภาพ OTA ของ Matter ดังนี้

  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 2 ครั้ง แล้วกด q เพื่อออกจาก menuconfig

ตั้งค่าใบรับรองการทดสอบ

ทำตามขั้นตอนในสร้างใบรับรองการทดสอบอุปกรณ์ Matter เพื่อสร้างใบรับรอง CD, DAC และ PAI

สร้างอุปกรณ์ของคุณ

เรียกใช้บิลด์และแฟลชอุปกรณ์ด้วยคำสั่งต่อไปนี้

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 2 ครั้ง แล้วกด 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

เนื่องจากต่อเชื่อม Matter SDK จากโฮสต์คอนเทนเนอร์ อิมเมจ OTA จึงพร้อมใช้งานในโฮสต์คอนเทนเนอร์

อัปโหลดรูปภาพ OTA ไปยัง Developer Console โดยทําตามวิธีการอัปโหลด OTA

ว่าจ้าง Google Home และสังเกตการณ์ OTA

ตรวจสอบว่าอุปกรณ์เชื่อมต่อกับเครื่องโฮสต์ Linux ด้วย USB ตัวอย่างต่อไปนี้แสดงการใช้ GNU screen เพื่ออ่านบันทึกของอุปกรณ์

screen -L /dev/ttyUSB0 115200

วิธีนี้จะแสดงเอาต์พุตจากอุปกรณ์ไปยังเทอร์มินัลและเขียนเอาต์พุตเดียวกันไปยังไฟล์บันทึกหน้าจอเริ่มต้นที่ชื่อว่า screenlog.0

คุณอาจเปิดไฟล์ screenlog.0 ในเครื่องมือแก้ไขข้อความอื่นหรือแสดงในไฟล์ Shell อื่นโดยใช้ cat, tail, more หรือ grep

กดปุ่มรีเซ็ตสีแดงที่ด้านข้างของอุปกรณ์เพื่อดูบันทึกจากการเปิดเครื่อง

ในเอาต์พุตของอุปกรณ์ คุณควรเห็น VID และ PID ที่คุณตั้งค่าไว้ก่อนหน้านี้ รวมถึง URL ไปยังรูปภาพคิวอาร์โค้ดที่จะใช้ในการคอมมิชชันอุปกรณ์

[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) โดยใช้คิวอาร์โค้ดจากลิงก์ที่ปรากฏในไฟล์บันทึก

ปล่อยให้อุปกรณ์ทำงานแบบไม่ขาดตอนเป็นเวลาหลายนาทีหลังจากการสั่งงาน คุณควรสังเกตเอาต์พุตบันทึกที่เกี่ยวข้องกับผู้ส่งคำขอ OTA, การดาวน์โหลดรูปภาพ OTA และ 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 แสดงช่องเวอร์ชันซอฟต์แวร์