नॉर्डिक पर OTA की जांच करें

यहां दिए गए निर्देशों में, Matter SDK टूल के लाइटिंग ऐप्लिकेशन के उदाहरण के साथ-साथ, Nordic nRF52840 डेवलपमेंट बोर्ड का इस्तेमाल किया गया है.

एनवायरमेंट का सेटअप

ये निर्देश, Docker पर आधारित nRF Connect टूलचैन का इंस्टॉलेशन करने के बारे में हैं. अगर आपको 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

नॉर्डिक बोर्ड को कंप्यूटर से कनेक्ट करें. इसके सीरियल इंटरफ़ेस के यूएसबी एनिमेंशन की जांच करें:

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 टूल को शुरू करना

कंटेनर में, नॉर्डिक nRF52 टूलचेन के लिए, Matter SDK टूल और एनवायरमेंट वैरिएबल शुरू करें. 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

बिल्ड और फ़्लैश

डिवाइस के लिए वीआईडी और पीआईडी कॉन्फ़िगर करें:

$ 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 (वीआईडी) और Device product ID (पीआईडी) को आधार-10 के पूर्णांक फ़ॉर्मैट में डालें.

  5. पक्का करें कि [*] Enable OTA requestor फ़्लैग चुना गया हो.

  6. कॉन्फ़िगरेशन को सेव करने के लिए, s दबाएं. पुष्टि करने के लिए, Enter दबाएं. इसके बाद, menuconfig से बाहर निकलने के लिए q दबाएं.

टेस्ट सर्टिफ़िकेट सेट अप करना

सीडी, डीएसी, और पीएआई सर्टिफ़िकेट बनाने के लिए, Matter डिवाइस के टेस्ट सर्टिफ़िकेट बनाएं में दिया गया तरीका अपनाएं.

अपना डिवाइस बनाना

$ 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

ओटीए इमेज बनाना और अपलोड करना

डिवाइस को फ़्लैश करने के बाद, डिवाइस के सॉफ़्टवेयर वर्शन को बढ़ाकर, 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 दबाएं. इसके बाद, menuconfig से बाहर निकलने के लिए q दबाएं.

नई 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 OTA बंडल फ़ाइल की प्रॉपर्टी की पुष्टि करें:

/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 टूल को आपके कंटेनर होस्ट से माउंट किया जाता है. इसलिए, ओटीए इमेज भी आपके कंटेनर होस्ट पर उपलब्ध होती है. ओटीए इमेज अपलोड करने के निर्देशों का पालन करके, ओटीए इमेज को Google Home Developer Console पर अपलोड करें.

डिवाइस को कमीशन करें और ओटीए प्रोसेस को देखें.

डिवाइस का टर्मिनल कनेक्शन, होस्ट पर या कंटेनर पर खोलें. अपने पसंदीदा टर्मिनल का इस्तेमाल करें, जैसे कि minicom या GNU screen:

$ minicom -c on -D /dev/ttyACM0 115200

बूट के लॉग देखने के लिए डिवाइस का रीसेट बटन दबाएं.

डिवाइस के आउटपुट में, आपको सेट किया गया वीआईडी और पीआईडी दिखेगा. साथ ही, कमिशन करने के लिए क्यूआर कोड का यूआरएल भी दिखेगा:

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) का इस्तेमाल करके देखी जा सकती है। डिवाइस को कमीशन करने के बाद, यह तरीका अपनाएं:

  1. GHA की मुख्य स्क्रीन पर, डिवाइस की टाइल को दबाकर रखें
  2. सबसे ऊपर दाईं ओर, आइकॉन पर टैप करें
  3. तकनीकी जानकारी पर टैप करें
  4. सॉफ़्टवेयर वर्शन फ़ील्ड की जांच करें

Google Home ऐप्लिकेशन की स्क्रीन, जिसमें सॉफ़्टवेयर वर्शन फ़ील्ड दिख रहा है