تستخدم التعليمات التالية مثال تطبيق الإضاءة من حزمة تطوير البرامج (SDK) Matter مع لوحة تطوير nRF52840 شمالية.
إعداد البيئة
تستند هذه التعليمات إلى عملية تثبيت لسلسلة أدوات nRF Connect استنادًا إلى Docker. إذا كنت تفضّل عدم استخدام 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 الصحيحة لاستخدامها. استخدِم إحدى الصور التي تم إنشاؤها للدمج المستمر لحزمة تطوير البرامج (SDK) Matter.
user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
image: connectedhomeip/chip-build-nrf-platform:0.5.99
قم بتوصيل لوحة دول الشمال بالكمبيوتر. تحقق من تعداد USB لواجهته التسلسلية:
على نظام التشغيل Mac:
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 ومتغيّرات البيئة لسلسلة أدوات 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
الإصدار والفلاش
ضبط معرِّفات 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 لإنشاء شهادات الأقراص المدمجة و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
إنشاء صورة عبر الهواء وتحميلها
بعد تحديث جهازك، غيِّر إعدادات الإصدار مرة أخرى لإنشاء نسخة عبر الهواء باستخدام إصدار أحدث من برنامج الجهاز.
إطلاق 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.
أنشِئ ملف حزمة 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
تأكيد خصائص ملف حزمة 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 أيضًا في مضيف الحاوية. حمِّل صورة عبر الهواء إلى Google Home Developer Console من خلال اتّباع تعليمات التحميل عبر الهواء.
عليك تشغيل الجهاز ومراقبة عملية التحديث عبر الهواء.
افتح اتصالاً طرفيًا بالجهاز إمّا في المضيف أو في
الحاوية. استخدم المحطة الطرفية المفضلة لديك مثل minicom أو GNU screen:
$ minicom -c on -D /dev/ttyACM0 115200
اضغط على زر إعادة ضبط الجهاز للاطّلاع على السجلّات من عملية التشغيل.
في إخراج الجهاز، من المفترض أن يظهر لك معرّف VID وPID الذي ضبطته، بالإضافة إلى عنوان URL لرمز الاستجابة السريعة للعمولة:
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
تأكَّد من اتصال الموزع بالمركز، ويمكنك تشغيل الجهاز باستخدام Google Home app (GHA) باستخدام رمز الاستجابة السريعة الوارد في الرابط الوارد في السجلّ.
اترك الجهاز يسجِّل أنشطته بعد التشغيل.
من المفترض أن يظهر لك النص التالي في سجلّ الجهاز:
/* 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" الرئيسية.
- انقر على الرمز في أعلى يسار الشاشة.
- انقر على المعلومات الفنية.
- تحقَّق من حقل إصدار البرنامج.
