בדיקת OTA ב-Nordic

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

הגדרת סביבה

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

בדיקת ה-SDK של תקן Matter

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 הנכונה שבה רוצים להשתמש. צריך להשתמש באחת מהתמונות שנוצרו עבור אינטגרציה רציפה (CI) של ה-SDK Matter.

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

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

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

הפעלת ה-SDK

בקונטיינר, מאתחלים את ה-SDK של Matter ואז של משתני הסביבה לצרור הכלים 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

Build ו-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 שנוצרה file:

/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 שמוצג בו השדה של גרסת התוכנה