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

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

إعداد البيئة

تستند هذه التعليمات إلى تثبيت سلسلة أدوات nRF Connect المستندة إلى Docker. إذا كنت تفضّل عدم استخدام Docker، يمكنك العثور على تعليمات تثبيت nRF Connect بشكلٍ أصلي على جهاز كمبيوتر مضيف على موقع Nordic الإلكتروني.

الاطّلاع على حزمة تطوير البرامج (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

وصِّل لوحة 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 وواجهة 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

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

  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

افتح اتصال وحدة طرفية بجهازك إما على المضيف أو على الحاوية. استخدِم أداة Terminal المفضّلة لديك، مثل minicom أو GNU screen.

user@host> minicom -c on -D /dev/ttyACM0 115200
user@host> screen /dev/ttyACM0 115200

إنشاء نسخة OTA وتحميلها

بعد تثبيت البرنامج الثابت على جهازك، غيِّر إعدادات الإصدار مرة أخرى لإنشاء صورة OTA بإصدار برنامج جهاز متزايد.

إطلاق 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.

أنشئ ملف حزمة 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:

/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.

شغِّل الجهاز وراقِب عملية التحديث عبر الهواء.

افتح اتصال وحدة طرفية بالجهاز إما على المضيف أو على الحاوية. استخدِم وحدة التحكّم المفضّلة لديك، مثل 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.

التحقّق من تحديث البرنامج عبر الاتصال اللاسلكي

يمكن التحقّق من إصدار برنامج الجهاز باستخدام تطبيق Google Home. بعد تشغيل الجهاز، اتّبِع الإجراءات التالية:

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

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