בדיקת OTA ב-Nordic

בהוראות הבאות נעשה שימוש בדוגמה של אפליקציית התאורה מ-SDK של Matter, יחד עם לוח פיתוח של Nordic nRF52840.

הגדרת סביבה

ההוראות האלה מבוססות על התקנה של כלי הפיתוח של nRF Connect שמבוססת על Docker. אם אתם מעדיפים לא להשתמש ב-Docker, ההוראות להתקנת nRF Connect באופן טבעי במחשב מארח נמצאות באתר הנורדי.

כדאי לעיין ב-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

מחברים את הלוח הנורדי למחשב. בודקים את ספירת ה-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

מריצים קונטיינר באמצעות המידע שנאסף בפקודה הקודמת. מעבירים את הדגלים כדי לטעון את תיקיית ה-SDK Matter של המארח ואת הממשק הטורי של ה-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

לחלופין, אפשר להתחיל סשן root באמצעות:

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

אתחול ה-SDK

בקונטיינר, מאתחלים את ה-SDK של Matter ואת משתני הסביבה של ערכת הכלים של Nordic nRF52. הפעלת ה-SDK Matter בדרך כלל נמשכת כמה דקות.

$ 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

פיתוח ו-Flash

מגדירים את ה-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

אחרי הפלאש של המכשיר, משנים שוב את הגדרות ה-build כדי ליצור קובץ אימג' OTA עם גרסת תוכנה מורחבת של המכשיר.

הפעלת Zephyr menuconfig:

$ 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.

יוצרים את קובץ החבילה החדש של OTA ‏Matter. הפלט ימוקם ב-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

מוודאים את המאפיינים של קובץ החבילה של OTA מסוג Matter שנוצר:

/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

מכיוון ש-SDK של Matter מותקן במארח הקונטיינר, קובץ האימג' של 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

צריך לוודא ש-Hub מחובר לאינטרנט, ולהזמין את המכשיר עם 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 שבו מוצג השדה 'גרסת תוכנה'