ההוראות הבאות כוללות את אפליקציית תאורה דוגמה מ-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
באפשרויות שבתפריט האינטראקטיבי:
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 שנוצרה 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). אחרי שמזמינים מכשיר, צריך לבצע את הפעולות הבאות:
- לוחצים לחיצה ארוכה על משבצת המכשיר במסך הראשי של GHA
- מקישים על הסמל בצד שמאל למעלה
- מקישים על מידע טכני.
- בודקים את השדה גרסת תוכנה.