नीचे दिए गए निर्देशों में, M5Stack ESP32 डेवलपमेंट बोर्ड के साथ-साथ Matter SDK टूल से lighting ऐप्लिकेशन के उदाहरण का इस्तेमाल किया गया है.
बिल्ड एनवायरमेंट का सेटअप
सबसे पहले, Matter SDK टूल का क्लोन बनाएं.
इस उदाहरण में, हमने Google Home की Matter रिलीज़ 5 के लिए कम से कम तय की गई सीमा के बारे में बताया है:
$ mkdir otaprep
$ cd otaprep
git clone https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
git fetch origin v1.0-branch
git checkout FETCH_HEAD
git submodule update --init --recursive
source ./scripts/activate.sh
इसके बाद, हम ESP32 GitHub वर्कफ़्लो में इस्तेमाल किए गए वर्शन की जांच करते हैं, ताकि हम यह तय कर सकें कि Docker इमेज हमारे बिल्ड के लिए सबसे सही है या नहीं:
$ cat .github/workflows/examples-esp32.yaml | grep chip-build | head -n 1
image: connectedhomeip/chip-build-esp32:0.5.99
हम Docker इमेज से एक कंटेनर चलाते हैं, जो कंटेनर में Matter SDK को माउंट करने और ESP32 डिवाइस का ऐक्सेस देने के लिए फ़्लैग पास करते हैं.
$ docker run --name container_name -it --user $(id -u):$(id -g) --mount source=$(pwd),target=/workspace,type=bind --device=/dev/ttyUSB0 connectedhomeip/chip-build-esp32: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 टूल और ईएसपी आईडीएफ़ शुरू करते हैं:
cd /workspace
git submodule update --init --recursive
source ./scripts/activate.sh
source /opt/espressif/esp-idf/export.sh
बिल्ड और फ़्लैश
अगला टास्क, इमेज बनाना और डेवलपमेंट किट को फ़्लैश करना है, ताकि Matter ओटीए फ़र्मवेयर अपडेट मिल सके.
ऐसा करने के लिए, आपको एक इमेज बनानी होगी.
सबसे पहले बिल्ड को ईएसपी आईडीएफ़ से मिली menuconfig
सुविधा का इस्तेमाल करके कॉन्फ़िगर करें.
cd examples/lighting-app/esp32
idf.py menuconfig
इंटरैक्टिव मेन्यू में, ये सेटिंग कॉन्फ़िगर करें:
Component config --->
CHIP Device Layer --->
Device Identification Options --->
Connectivity Standards Alliance (Alliance) को असाइन किए गए वीआईडी पर
Vendor ID
सेट करें.Product ID
को उस पीआईडी पर सेट करें जिसे आपने Google Home Developer Console में Matter इंटिग्रेशन पर सेट किया है.
OTA अनुरोधकर्ता फ़्लैग चालू करें:
Component config -->
CHIP Core -->
System options --->
ओटीए अनुरोध करने वाले के लिए फ़्लैग
[*] Enable OTA Requestor
को चालू करेंटॉप लेवल मेन्यू पर वापस जाने के लिए, ESC दबाएं.
Matter ओटीए इमेज बनाने वाले फ़्लैग को चालू करें:
Component config -->
CHIP Device Layer --->
Matter OTA Image --->
[*] Generate OTA IMAGE
वर्शन नंबर सेट करें:
Application manager --->
[*] Get the project version from Kconfig
को चुनेंProject version (NEW)
को1.0
पर सेट करेंकॉन्फ़िगरेशन को सेव करने के लिए, s दबाएं और Enter दबाएं. इसके बाद,
menuconfig
से बाहर निकलने के लिए q दबाएं.
टेस्ट सर्टिफ़िकेट सेट अप करें
सीडी, डीएसी, और पीएआई सर्टिफ़िकेट बनाने के लिए, Matter डिवाइस टेस्ट सर्टिफ़िकेट बनाएं सेक्शन में दिया गया तरीका अपनाएं.
अपना डिवाइस बनाएं
अब बिल्ड को चलाएं और डिवाइस को फ़्लैश करें:
idf.py build
idf.py -p /dev/ttyUSB0 erase_flash
idf.py -p /dev/ttyUSB0 flash
ओटीए इमेज बनाना और उसे अपलोड करना
अब ओटीए इमेज बनाने के लिए, बिल्ड सेटिंग को फिर से बदलें. उसी इमेज का इस्तेमाल करें, लेकिन वर्शन नंबर की संख्या बढ़ाएं.
menuconfig
चलाएं.
idf.py menuconfig
इंटरैक्टिव मेन्यू में, इन्हें अपडेट करें:
Application manager --->
[*] Get the project version from Kconfig
को चुनेंProject version (NEW)
को2.0
पर सेट करें- कॉन्फ़िगरेशन को सेव करने के लिए, s दबाएं. इसके बाद, Enter को दो बार दबाएं. इसके बाद,
menuconfig
से बाहर निकलने के लिए q दबाएं.
इमेज बनाएं और उसे वापस पाएं. नीचे दिए गए उदाहरण में ओटीए के लिए इमेज की जगह और ota_image_tool.py
के साथ पार्स करते समय मिलने वाले आउटपुट, दोनों के बारे में बताया गया है.
cd build
/workspace/src/app/ota_image_tool.py show ./chip-lighting-app-ota.bin
Magic: 1beef11e
Total Size: 1243360
Header Size: 64
Header TLV:
[0] Vendor Id: XXXXX (0x000)
[1] Product Id: XXXXX (0x000)
[2] Version: 2 (0x2)
[3] Version String: v2.0
[4] Payload Size: 1243280 (0x12f890)
[8] Digest Type: 1 (0x1)
[9] Digest: e367f4d71e2ccd554b9a399c864abbf2c039382ef1def1b986fb2f59a99923a8
Matter SDK टूल आपके कंटेनर होस्ट से माउंट किया जाता है, इसलिए ओटीए इमेज आपके कंटेनर होस्ट पर उपलब्ध होती है.
ओटीए अपलोड करने के निर्देशों का पालन करके, ओटीए इमेज को Developer Console पर अपलोड करें.
Google Home पर कमीशन पाना और ओटीए की निगरानी करना
पक्का करें कि आपका डिवाइस, होस्ट Linux मशीन से यूएसबी का इस्तेमाल करके कनेक्ट किया गया हो. यहां दिए गए उदाहरण में, डिवाइस के लॉग पढ़ने के लिए GNU screen
का इस्तेमाल दिखाया गया है:
screen -L /dev/ttyUSB0 115200
यह, डिवाइस से आपके टर्मिनल पर आउटपुट दिखाता है और वही आउटपुट screenlog.0
नाम की डिफ़ॉल्ट स्क्रीन लॉग फ़ाइल पर लिखता है.
screenlog.0
फ़ाइल को किसी अन्य टेक्स्ट एडिटर में खोला जा सकता है या उसे cat
, tail
, more
या grep
के साथ किसी दूसरे शेल में दिखाया जा सकता है.
बूट से लॉग देखने के लिए डिवाइस के साइड में मौजूद लाल रंग के रीसेट बटन को दबाएं.
डिवाइस आउटपुट में, आपको वह वीआईडी और पीआईडी दिखेगा. साथ ही, आपको उस क्यूआर कोड की इमेज का यूआरएल भी दिखेगा जिसका इस्तेमाल डिवाइस को कमीशन देने के लिए किया जाएगा.
[0;32mI (2388) chip[DIS]: Advertise commission parameter vendorID=XXXXX productID=XXXX discriminator=3840/15 cm=1[0m
[0;32mI (1928) chip[SVR]: SetupQRCode: [MT:E59-000000000000000][0m
https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AE59-000000000000000
पक्का करें कि आपका हब, आपके घर में ऑनलाइन हो.
लॉग फ़ाइल में दिखने वाले लिंक में दिए गए क्यूआर कोड का इस्तेमाल करके, डिवाइस को Google Home app (GHA) के साथ कमीशन करें.
चालू होने के बाद, डिवाइस को कुछ मिनट तक बिना किसी रुकावट के चलने दें.
आपको ओटीए रिक्वेस्टर, ओटीए इमेज डाउनलोड, और OTAImageProcessor
से जुड़े लॉग आउटपुट दिख रहे हैं.
इमेज इंस्टॉल होने के बाद, देखें कि इमेज को कंपाइल करने में लगने वाला समय, कंसोल पर अपलोड किए गए समय से मेल खाता है. यह समय, पहली बार बूट करने पर रिपोर्ट किए गए कंपाइल समय के बाद का है. screenlog.0
पर रेगुलर एक्सप्रेशन मोड में, grep
को इस पैटर्न के साथ एक्ज़ीक्यूट करने पर, ओटीए प्रोसेस के बारे में पता चल सकता है:
$ grep -E "(Compile time|OTA)" screenlog.0
I (76) boot: 1 otadata OTA data 01 00 0000f000 00002000
I (91) boot: 3 ota_0 OTA app 00 10 00020000 00177000
I (99) boot: 4 ota_1 OTA app 00 11 001a0000 00177000
I (645) cpu_start: Compile time: Oct 15 2022 06:21:59
I (135558) chip[SWU]: OTA Requestor received AnnounceOTAProvider
I (540658) chip[SWU]: OTA image downloaded to offset 0x1a0000
I (541348) OTAImageProcessor: Applying, Boot partition set offset:0x1a0000
I (76) boot: 1 otadata OTA data 01 00 0000f000 00002000
I (91) boot: 3 ota_0 OTA app 00 10 00020000 00177000
I (99) boot: 4 ota_1 OTA app 00 11 001a0000 00177000
I (645) cpu_start: Compile time: Oct 15 2022 07:35:31
I (76) boot: 1 otadata OTA data 01 00 0000f000 00002000
I (91) boot: 3 ota_0 OTA app 00 10 00020000 00177000
I (99) boot: 4 ota_1 OTA app 00 11 001a0000 00177000
I (645) cpu_start: Compile time: Oct 15 2022 07:35:31
शुरुआती एक्ज़ीक्यूशन के बाद, नई इमेज अपलोड किए बिना ओटीए इमेज बनाएं और अपलोड करें सेक्शन में दिए गए चरणों को दोहराएं. इस बार,
वर्शन को वापस 1
पर सेट करें.
menuconfig
चलाएं और इंटरैक्टिव मेन्यू के विकल्पों में इसे चलाएं:
Component config -->
CHIP Device Layer --->
Device Identification Options
Version String
कोv1.0
पर सेट करें.Device Software Version Number
को1
पर सेट करें.कॉन्फ़िगरेशन को सेव करने के लिए, s दबाएं. इसके बाद,
menuconfig
से बाहर निकलने के लिए q दबाएं.
GHA में जाकर, उस डिवाइस को अपने होम से हटाएं.
अगर इमेज पहले से नहीं बनी है, तो उसे बनाएं:
idf.py build
इसे फ़्लैश करें:
idf.py -p /dev/ttyUSB0 erase_flash
idf.py -p /dev/ttyUSB0 flash
ज़रूरत के मुताबिक, Google Home पर कमीशन करें और ओटीए की निगरानी करें में दिया गया तरीका दोहराएं.
ओटीए सॉफ़्टवेयर के अपडेट की पुष्टि करना
Google Home ऐप्लिकेशन (जीएचए) का इस्तेमाल करके, डिवाइस के सॉफ़्टवेयर का वर्शन देखा जा सकता है. डिवाइस को चालू करने के बाद, यह तरीका अपनाएं:
- GHA की मुख्य स्क्रीन पर, डिवाइस की टाइल को दबाकर रखें
- सबसे ऊपर दाईं ओर, आइकॉन पर टैप करें
- तकनीकी जानकारी पर टैप करें
- सॉफ़्टवेयर वर्शन फ़ील्ड की जांच करें