تستخدِم التعليمات التالية مثالاً على تطبيق الإضاءة من حزمة تطوير البرامج (SDK) Matter إلى جانب لوحة تطوير Nordic nRF52840.
إعداد البيئة
وتستند هذه التعليمات إلى عملية تثبيت تستند إلى قاعدة الإرساء لسلسلة أدوات nRF Connect. إذا كنت تفضّل عدم استخدام Docker، يمكنك الاطّلاع على تعليمات تثبيت nRF في الأصل على الكمبيوتر المضيف على موقع Nordic site.
الاطّلاع على حزمة تطوير البرامج (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 الصحيحة لاستخدامها. استخدِم إحدى الصور التي تم إنشاؤها للدمج المتواصل لحزمة Matter.
user@host> cat .github/workflows/examples-nrfconnect.yaml | grep chip-build
image: connectedhomeip/chip-build-nrf-platform:0.5.99
اربط لوح Nordic بالكمبيوتر. تحقق من تعداد 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 وواجهة الواجهة التسلسلية في الحاوية.
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 لإنشاء شهادات 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
إنشاء صورة عبر الهواء وتحميلها
بعد تحديث جهازك، ما عليك سوى تغيير إعدادات الإصدار مرة أخرى لإنشاء صورة عبر الهواء باستخدام إصدار متزايد من برنامج الجهاز.
تشغيل تطبيق 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 من مضيف الحاوية، تتوفّر أيضًا صورة التحديث على الإنترنت في مضيف الحاوية. حمِّل الصورة عبر الهواء إلى 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.
التحقّق من صحة تحديث برنامج "عبر الهواء"
ويمكن التحقّق من إصدار برنامج الجهاز باستخدام تطبيق Google Home (GHA). بعد تشغيل الجهاز، اتّبِع الإجراءات التالية:
- اضغط مع الاستمرار على مربّع الجهاز في الشاشة الرئيسية "GHA".
- انقر على الرمز في أعلى يسار الصفحة.
- انقر على المعلومات الفنية
- تحقَّق من حقل إصدار البرنامج.
