اختبار التحديث عبر الهواء على Nordic

تستخدم التعليمات التالية تطبيق الإضاءة مثال من حزمة تطوير البرامج (SDK) Matter مع nRF52840 Nordic مجلس التطوير.

إعداد البيئة

وتستند هذه التعليمات إلى عملية تثبيت لنظام التشغيل 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 الصحيحة لاستخدامها. استخدم إحدى الصور التي تم إنشاؤها من أجل الدمج المستمر لحزمة تطوير البرامج (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 لمتغير البيئة لسلسلة أدوات 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

في خيارات القائمة التفاعلية:

  1. Modules --->

  2. connectedhomeip --->

  3. [*] Connected Home over IP protocol stack --->

  4. أدخِل Device vendor ID (VID) وDevice product ID (PID) في الأساس-10. تنسيق عدد صحيح.

  5. تأكَّد من اختيار العلامة [*] Enable OTA requestor.

  6. اضغط على 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

في خيارات القائمة التفاعلية:

  1. Modules -->

  2. connectedhomeip -->

  3. Connected Home over IP protocol stack -->

  4. تغيير Device Software Version إلى 2

  5. تغيير Device Software Version String إلى prerelease-2

  6. اضغط على 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

تأكَّد من اتصال الموزع (Hub) بالإنترنت، ثم افحص الجهاز 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). بعد تشغيل الجهاز، اتّبِع الإجراءات التالية:

  1. اضغط مع الاستمرار على مربّع الجهاز في شاشة "GHA" الرئيسية.
  2. انقر على الرمز في أعلى يسار الشاشة.
  3. انقر على المعلومات الفنية.
  4. تحقَّق من حقل إصدار البرنامج.

شاشة في تطبيق Google Home تعرض حقل إصدار البرنامج