تستخدم التعليمات التالية مثال تطبيق الإضاءة من حزمة تطوير البرامج Matter SDK مع لوحة تطوير Nordic 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 للواجهة التسلسلية:
على نظام التشغيل 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 ومتغيّرات البيئة لسلسلة أدوات 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
افتح اتصال طرفي بجهازك إما على المضيف أو على
الحاوية. استخدِم أداة Terminal المفضّلة لديك مثل 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 الرئيسية.
- انقر على رمز في أعلى يسار الشاشة.
- انقر على المعلومات الفنية.
- تحقَّق من حقل إصدار البرنامج.