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

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

إعداد البيئة

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

التعرّف على Matter SDK

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

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

يمكنك تشغيل حاوية باستخدام المعلومات التي تم جمعها في الأمر السابق. يُرجى تمرير العلامات لتثبيت مجلد Matter SDK المضيف والواجهة التسلسلية 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)

في الحاوية، يمكنك إعداد Matter SDK و متغيّرات البيئة لسلسلة أدوات Nordic nRF52. غالبًا ما يستغرق إعداد Matter SDK عدة دقائق.

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) بتنسيق عدد صحيح أساسي.

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

  6. اضغط على s لحفظ الإعدادات، ثم اضغط على Enter للتأكيد، ثم q للخروج من menuconfig.

إعداد شهادات الاختبار

اتّبِع الخطوات الواردة في مقالة إنشاء شهادات اختبار لجهاز Matter لإنشاء شهادات CD وDAC وPAI.

إنشاء جهازك

west build -b nrf52840dk_nrf52840

تثبيت ذاكرة ROM على جهازك

يتم إجراء ذلك على الكمبيوتر المضيف، وليس في حاوية 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

إنشاء صورة 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

بما أنّ Matter SDK يتم تثبيته من مضيف الحاوية، تتوفّر صورة OTA أيضًا على مضيف الحاوية. يمكنك تحميل صورة OTA إلى Google Home Developer Console باتّباع تعليمات تحميل OTA.

يمكنك إعداد الجهاز ومراقبة عملية 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

تأكَّد من أنّ المحور متصل بالإنترنت، وأعِد إعداد الجهاز باستخدام الـ 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 تعرض حقل إصدار البرنامج