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