ההוראות הבאות משתמשות בדוגמה של אפליקציית התאורה מ-Matter SDK יחד עם לוח פיתוח nRF52840 נורדי.
הגדרת סביבה
ההוראות האלו מבוססות על התקנה מבוססת-Docker של שרשור הכלים nRF Connect. אם אתם מעדיפים לא להשתמש ב-Docker, ההוראות להתקנת nRF Connect באופן טבעי במחשב מארח נמצאות באתר הנורדי.
בדיקת ה-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
באפשרויות שבתפריט האינטראקטיבי:
Modules --->
connectedhomeip --->
[*] Connected Home over IP protocol stack --->
מזינים את
Device vendor ID
(VID) ואתDevice product ID
(PID) בפורמט של מספרים שלמים מסוג base-10.מוודאים שהדגל
[*] Enable OTA requestor
מסומן.מקישים על 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
באפשרויות שבתפריט האינטראקטיבי:
Modules -->
connectedhomeip -->
Connected Home over IP protocol stack -->
שינוי
Device Software Version
ל2
.שינוי
Device Software Version String
לprerelease-2
.מקישים על 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
בגלל ש-Matter SDK נטען ממארח הקונטיינר, תמונת ה-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). אחרי שמזמינים מכשיר, צריך לבצע את הפעולות הבאות:
- לוחצים לחיצה ארוכה על משבצת המכשיר במסך הראשי של GHA
- מקישים על הסמל בצד שמאל למעלה
- מקישים על מידע טכני.
- בודקים את השדה גרסת תוכנה.