سلڪون ليبز جي مالڪ جي دستور سان ZAP جي ترقي

ZAP شروع ڪرڻ
- ZAP سان شروع ڪرڻ لاءِ، انهن قدمن تي عمل ڪريو:
  - سرڪاري مخزن مان ZAP ايگزيڪيوٽيبل ڊائون لوڊ ڪريو.
  - npm انسٽال ڪمانڊ استعمال ڪندي انحصار کي انسٽال ڪريو.
  - ونڊوز جي مخصوص انسٽاليشن لاءِ، ونڊوز او ايس گائيڊ لاءِ ZAP انسٽاليشن ڏسو.
زگبي ڊولپمينٽ
- جيڪڏهن توهان Zigbee ايپليڪيشنون ٺاهي رهيا آهيو:
  - سمپليسيٽي اسٽوڊيو استعمال ڪريو جنهن ۾ ZAP ۽ ٻيا ضروري اوزار شامل آهن.

مادي جي ترقي
- جيڪڏهن توهان ميٽر ايپليڪيشنون ٺاهي رهيا آهيو:
  - اختيارن ۾ سمپليسيٽي اسٽوڊيو استعمال ڪرڻ يا سلڪون ليبز يا سي ايس اي گٿب ريپوزٽريز تائين رسائي شامل آهي.
  - جيڪڏهن ضرورت هجي ته سمپليسيٽي اسٽوڊيو رليز سائيڪل کان ٻاهر ZAP لاءِ اپڊيٽ هدايتون ڏسو.

FAQs

سوال: ZAP بائنري جا مختلف نسخا ڪهڙا موجود آهن؟
- A: ٻه نسخا موجود آهن - تصديق ٿيل بلڊز سان سرڪاري رليز ۽ جديد خصوصيتن سان پري رليز.

سوال: جيڪڏهن مون کي انسٽاليشن دوران مقامي لائبريري ڪمپليشن جا مسئلا درپيش اچن ته مون کي ڇا ڪرڻ گهرجي؟
- A: اهڙن مسئلن کي حل ڪرڻ لاءِ پليٽ فارم جي مخصوص اسڪرپٽ بابت FAQ معلومات جو حوالو ڏيو.

“`

View Fullscreen

سلڪون ليبز ZAP
سلڪون ليبز ZAP

سلڪون ليبز ZAP سان ترقي ڪندي

شروع ٿيڻ
ZAP ٻيهر شروع ڪرڻview ZAP انسٽاليشن ZAP انسٽاليشن ونڊوز FAQ
بنيادي اصول ZAP بنيادي اصول
استعمال ڪندڙ جي ھدايت ZAP استعمال ڪندڙ جي ھدايت ختمview ڪسٽم ايڪس ايم ايل ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ گھڻن ڊوائيسز جا قسم في اينڊ پوائنٽ ميٽر ڊيوائس جو قسم فيچر پيج نوٽيفڪيشن ڊيٽا-ماڊل/ZCL وضاحت تعميل رسائي ڪنٽرول ميٽر يا زگبي ايپليڪيشنن لاءِ ZAP لانچ ڪرڻ ميٽر يا زگبي لاءِ ڪوڊ پيدا ڪرڻ اسٽوڊيو ۾ ZAP کي اپڊيٽ ڪريو ڪنڪرنٽ زگبي ۽ ميٽر جي وچ ۾ ملٽي پروٽوڪول SLC CLI کي ZAP سان ضم ڪريو

1/35

سلڪون ليبز ZAP سان ترقي ڪندي
سلڪون ليبز ZAP سان ترقي ڪندي
ZAP
ZAP هڪ عام ڪوڊ جنريشن انجن ۽ ايپليڪيشنن ۽ لائبريرين لاءِ يوزر انٽرفيس آهي جيڪو Zigbee جي Zigbee ڪلسٽر لائبريري يا Matter جي ڊيٽا ماڊل تي ٻڌل آهي. وضاحت ڪنيڪٽيوٽي اسٽينڊرڊ الائنس پاران تيار ڪئي وئي آهي. ZAP توهان کي هيٺيان آپريشن ڪرڻ جي اجازت ڏئي ٿو:
ZCL/ڊيٽا-ماڊل وضاحت جي بنياد تي سڀني عالمي نمونن (مسلسل، قسم، ID، وغيره) جي SDK-مخصوص ڪسٽمائيز جنريشن انجام ڏيو. ZCL/ڊيٽا-ماڊل وضاحت ۽ گراهڪ پاران مهيا ڪيل ايپليڪيشن ترتيب جي بنياد تي سڀني صارف پاران چونڊيل ترتيب جي نمونن (ايپليڪيشن ترتيب، اينڊ پوائنٽ ترتيب، وغيره) جي SDK-مخصوص ڪسٽمائيز جنريشن انجام ڏيو. هڪ مخصوص ايپليڪيشن ترتيب (اينڊ پوائنٽس، ڪلسٽر، خاصيتون، ڪمانڊ، وغيره) چونڊڻ لاءِ آخري صارف لاءِ UI مهيا ڪريو.

انهن حصن ۾ موجود مواد بيان ڪري ٿو ته ZAP استعمال ڪندي ZCL (Zigbee) يا ڊيٽا ماڊل (Matter) پرتن کي ترتيب ڏيندي Zigbee ۽ Matter ايپليڪيشنن کي ڪيئن ترقي ڪجي.

2/35

ZAP شروع ڪرڻ

ZAP شروع ڪرڻ
ZAP سان شروعات ڪرڻ
هي حصا Zigbee ۽ Matter ايپليڪيشنون ٺاهڻ جا مختلف طريقا بيان ڪن ٿا. ياد رکو ته Simplicity Studio توهان جي Zigbee ۽ Matter ايپليڪيشنن کي آخر کان آخر تائين ٺاهڻ جو هڪ طريقو فراهم ڪري ٿو جتي سڀئي اوزار Simplicity Studio (ZAP سميت) سان گڏ اڳ ۾ نصب ٿيل هوندا آهن. توهان شايد پنهنجي ايپليڪيشنون ٺاهڻ جا ٻيا طريقا ڳولڻ جو فيصلو پڻ ڪري سگهو ٿا، جيئن هتي بيان ڪيو ويو آهي.
زگبي ڊولپمينٽ
زگبي ايپليڪيشن ڊولپرز سمپلسٽي اسٽوڊيو استعمال ڪندي پنهنجون ايپليڪيشنون ٺاهي سگهن ٿا، جنهن ۾ اڳ ۾ ئي ZAP ۽ ٻيا اوزار شامل آهن جيڪي توهان جي ايپليڪيشن کي هڪ سر کان ٻئي سر تائين ٺاهڻ ۾ مدد ڪن ٿا.
مادي جي ترقي
ميٽر ايپليڪيشن ڊولپرز هيٺ ڏنل طريقن کي استعمال ڪندي پنهنجون ايپليڪيشنون ٺاهي سگهن ٿا: سمپليسيٽي اسٽوڊيو: ان ۾ ZAP ۽ ٻيا اوزار شامل آهن جيڪي ميٽر ايپليڪيشن کي آخر تائين ٺاهڻ لاءِ گهربل آهن. گِٿب (سلِڪون ليبز) گِٿب (سي ايس اي)
نوٽ: سمپليسيٽي اسٽوڊيو رليز سائيڪل کان ٻاهر ZAP کي اپڊيٽ ڪرڻ لاءِ، سمپليسيٽي اسٽوڊيو ۾ ZAP کي اپڊيٽ ڪريو ۽ ZAP انسٽاليشن گائيڊ ڏسو.

3/35

ZAP جي انسٽاليشن

هيٺ ڏنل سيڪشن ZAP جي انسٽاليشن ۽ سمپلسٽي اسٽوڊيو IDE ۾ ZAP کي ڪيئن اپڊيٽ ڪجي ان جي وضاحت ڪن ٿا.
ZAP ايگزيڪيوٽوبل ڊائون لوڊ ڪرڻ جي سفارش ڪئي وئي آهي)
هي ZAP سان شروع ڪرڻ جو تجويز ڪيل طريقو آهي. توهان aa کان تازيون ZAP بائنري حاصل ڪري سگهو ٿا. https://github.com/project-chip/zp/releses. اڳ ۾ ٺهيل بائنري ٻن مختلف نسخن ۾ اچن ٿيون.
سرڪاري رليز: تصديق ٿيل بلڊز وقف ٿيل ميٽر ۽ زگبي ٽيسٽ سوئيٽس سان. رليز نالي جو فارميٽ vYYYY.DD.MM آهي. پري رليز: جديد خصوصيتن ۽ بگ فڪسز سان بلڊز پر اهي بلڊز وقف ٿيل ميٽر ۽ زگبي ٽيسٽ سوئيٽس سان تصديق ٿيل نه آهن. رليز نالي جو فارميٽ vYYYY.DD.MM-رات جو آهي.
ذريعو مان ZAP انسٽال ڪرڻ
ZAP انسٽال ڪرڻ لاءِ بنيادي هدايتون
ڇاڪاڻ ته هي هڪ node.js ايپليڪيشن آهي، توهان کي نوڊ ماحول انسٽال ڪرڻ جي ضرورت آهي. اهو ڪرڻ جو بهترين طريقو نوڊ جي تازي انسٽال ڊائون لوڊ ڪرڻ آهي، جنهن ۾ نوڊ ۽ npm شامل آهن. جيڪڏهن توهان جي ورڪ اسٽيشن تي نوڊ جو پراڻو ورزن انسٽال ٿيل آهي، ته اهو مسئلا پيدا ڪري سگهي ٿو، خاص طور تي جيڪڏهن اهو تمام پراڻو آهي. پڪ ڪريو ته توهان وٽ npm سان گڏ جديد نوڊ v16.x ورزن آهي. نوڊ –ورزن هلايو ته چيڪ ڪريو ته ڪهڙو ورزن چونڊيو ويو آهي. v18.x سفارش ڪئي وئي آهي. توهان وٽ نوڊ جو گهربل ورزن هجڻ کان پوءِ، توهان هيٺيان هلائي سگهو ٿا:
انحصار کي انسٽال ڪريو
انحصار کي نصب ڪرڻ لاءِ هيٺ ڏنل حڪم استعمال ڪريو:

اين پي ايم انسٽال ڪريو
نوٽ: ونڊوز جي مخصوص ZAP انسٽاليشن لاءِ، ونڊوز او ايس لاءِ ZAP انسٽاليشن ڏسو. هن وقت مقامي لائبريري ڪمپليشن مسئلن ۾ هلڻ غير معمولي ناهي. مختلف پليٽ فارمن لاءِ مختلف src-script/install-* اسڪرپٽ آهن. مختلف پليٽ فارمن تي ڪهڙي اسڪرپٽ کي هلائڻ ۽ پوءِ npm install کي ٻيهر هلائڻ بابت FAQ معلومات ڏسو.
اپليڪيشن شروع ڪريو
ايپليڪيشن شروع ڪرڻ لاءِ هيٺ ڏنل حڪم استعمال ڪريو:

اين پي ايم رن زپ
ڊولپمينٽ موڊ ۾ فرنٽ اينڊ شروع ڪريو
هاٽ ڪوڊ ري لوڊنگ، ايرر رپورٽنگ، ۽ انهي وانگر ٻين کي سپورٽ ڪري ٿو. ڊولپمينٽ ۾ فرنٽ اينڊ شروع ڪرڻ لاءِ هيٺ ڏنل حڪم استعمال ڪريو.
موڊ:
ڪواسر ڊيو - ايم اليڪٽران
or

4/35

ZAP انسٽاگرام تي موجود آهي
npm هلائيندڙ اليڪٽران-ڊيو

5/35

ZAP انسٽاليشن ونڊوز
ZAP انسٽاليشن ونڊوز
ونڊوز او ايس لاءِ ZAP انسٽاليشن
1. ونڊوز پاور شيل
ڊيسڪ ٽاپ سرچ بار ۾، ونڊوز پاور شيل داخل ڪريو ۽ ايڊمنسٽريٽر جي حيثيت سان هلايو. پاور شيل اندر هيٺ ڏنل سڀئي حڪم هلايو.
2. چاڪليٽي
تان انسٽال ڪريو https://chocolatey.org/installهيٺ ڏنل حڪمن سان صحيح طرح سان انسٽال ٿيل چيڪ ڪريو:
چاڪو -وي
هيٺ ڏنل حڪمن سان pkgconfiglite پيڪيج انسٽال ڪريو:
چاڪو انسٽال ڪريو pkgconfiglite
3. نوڊ انسٽال ڪريو
انسٽال ڪرڻ لاءِ ھيٺ ڏنل حڪم هلايو:
چاڪو انسٽال ڪريو nodejs-lts
*ورجن چيڪ ٽيسٽ پاس ڪرڻ لاءِ ورجن 18 هجڻ ضروري آهي، انسٽال ڪرڻ کان پوءِ، نوڊ -v سان چيڪ ڪريو *جيڪڏهن توهان اڳ ۾ ئي نوڊ انسٽال ڪيو آهي، ۽ ڪجهه ٽيسٽن ۾ ناڪام ٿيو ٿا جهڙوڪ نوڊ نه ڳولي سگهي ٿو، ته نوڊ کي چاڪليٽي سان ٻيهر انسٽال ڪريو.
4. ZAP انسٽال ڪرڻ لاءِ بنيادي هدايتن تي عمل ڪريو.
ZAP انسٽاليشن ۾ سورس کان ZAP انسٽاليشن جي هدايتن تي عمل ڪريو. ZAP انسٽال ڪرڻ لاءِ بنيادي هدايتن تي عمل ڪندي هيٺ ڏنل غلطين ۽ انهن کي ڪيئن حل ڪجي تي نظر رکو:
ايس ڪيو ايلائيٽ 3
ZAP هلائڻ وقت (مثال طور، npm run zap )، جيڪڏهن توهان کي پاپ اپ ونڊو ۾ sqlite3.node بابت ڪا غلطي نظر اچي ٿي، ته هلايو:
اين پي ايم ٻيهر تعمير ڪريو sqlite3
اليڪٽران ٺاهڻ وارو
npm انسٽال ڪرڻ وقت، پوسٽ انسٽال ۾، جيڪڏهن electron-builder install-appdeps، npx electron-rebuild canvas failed يا node-pre-gyp سان لاڳاپيل هيٺ ڏنل ڪمانڊ تي ڪا غلطي ٿئي ٿي، ته موجوده ڪينواس ورجن ونڊوز سان مطابقت نٿو رکي ۽ انسٽاليشن جي غلطي ZAP هلائڻ ۾ ناڪامي جو سبب نه بڻجندي. node-canvas هاڻي حل تي ڪم ڪري رهيو آهي ۽ مسئلو ويجهي مستقبل ۾ حل ٿي ويندو.
"پوسٽ انسٽال": "اليڪٽران-بلڊر انسٽال-ايپ-ڊيپس ۽&هسڪي انسٽال && اين پي ايم ري بلڊ ڪينواس -اپڊيٽ-بائنري ۽& اين پي ايم رن ورزن-اسٽamp”

6/35

ZAP انسٽاليشن ونڊوز
ڪينواس
جيڪڏهن npm رن ٽيسٽ غلطي جي ڪري ناڪام ٿئي ٿو ته ٽيسٽ سوٽ هلائڻ ۾ ناڪام ٿيو. ماڊيول '../build/Release/canvas.node' نه ملي سگهيو يا
zapnode_modulescanvasbuildReleasecanvas.node هڪ صحيح Win32 ايپليڪيشن ناهي. ، ڪينواس کي هيٺ ڏنل طريقي سان ٻيهر ٺاهيو:
npm ڪينواس ٻيهر تعمير ڪريو - اپڊيٽ-بائنري
index.html يا ٻيا سرور مسئلا حاصل ڪريو
جيڪڏهن اين پي ايم رن ٽيسٽ غلطي جي ڪري ناڪام ٿئي ٿي ته يونٽ ٽيسٽ ۾ يا سرور هجڻ سان اسٽيٽس ڪوڊ 404 سان index.html درخواست ناڪام ٿي وڃي.
e2e-ci ٽيسٽن ۾ ڪنيڪشن جا مسئلا، هيٺيان حڪم هلايو:
اين پي ايم رن بلڊ
ٻيو
چيڪ ڪريو ته ڇا نوڊ ورجن v18 آهي ۽ ان کي چاڪليٽي سان انسٽال ڪرڻ جي ڪوشش ڪريو.

7/35

FAQ
FAQ
اڪثر پڇيا ويا سوال
سوال: ڊولپمينٽ موڊ ۾ UI ڪيئن شروع ڪجي؟ جواب: توهان ڊولپمينٽ موڊ ۾ UI شروع ڪري سگهو ٿا، جنهن جي نتيجي ۾ هيٺ ڏنل سيٽ اپ ٿيندو:
الڳ ڪواسر ڊولپمينٽ HTTP سرور، جيڪو پورٽ 8080 تي لائيو ريفريش ڪري ٿو ZAP بيڪ اينڊ پورٽ 9070 ڪروم يا ٻئي برائوزر تي هلندڙ، آزاد طور تي هلندڙ انهي سيٽ اپ تي حاصل ڪرڻ لاءِ، هيٺ ڏنل هدايتن تي عمل ڪريو. ò پهرين، ZAP ڊولپمينٽ سرور هلايو، جيڪو پورٽ 9070 تي شروع ٿئي ٿو.
npm رن زپ-ڊيو سرور ó اڳيون، ڪواسر ڊولپمينٽ سرور هلايو، جيڪو پورٽ 8080 تي شروع ٿئي ٿو.
ڪواسار ڊيو ô پنهنجي برائوزر کي پوائنٽ ڪريو يا هڪ کي صحيح جي خلاف هلايو URL ريسٽ پورٽ دليل سان:
گوگل ڪروم http://لوڪل هوسٽ: 8080/؟ريسٽ پورٽ=9070

سوال: ميڪ/لينڪس او ايس تي هي ڪيئن ڪم ڪجي؟ الف:
npm انسٽال سڀني گهربل انحصار پيڪيجز کي ڊائون لوڊ ڪرڻ لاءِ استعمال ڪيو ويندو آهي. جيڪڏهن توهان node-gyp سان لاڳاپيل غلطيون ۽ مقامي لائبريريون غائب ڏسندا آهيو، جهڙوڪ pixman، ۽ انهي وانگر، توهان پليٽ فارمن ۽ نسخن جي ڪجهه ميلاپ لاءِ غير پري بلٽ نوڊ بائنريز کي مرتب ڪرڻ لاءِ مقامي انحصار وڃائي رهيا آهيو. ڪلائوڊ تي Npm مسلسل مهيا ڪيل بائنريز جي فهرست کي اپڊيٽ ڪري رهيو آهي، تنهنڪري اهو ممڪن آهي ته توهان انهن کي بلڪل ٺيڪ چونڊيندا، پر جيڪڏهن توهان نه ڪيو، ته اهي مختلف پليٽ فارمن لاءِ هدايتون آهن:
ڊي اين ايف سان فيڊورا ڪور:
ڊي اين ايف انسٽال ڪريو پِڪس مين-ڊيول قاهره-ڊيول پينگو-ڊيول لِب جِي پيگ-ڊيول گِف لِب-ڊيول
يا اسڪرپٽ هلايو:
src-اسڪرپٽ/انسٽال-پيڪيجز-فيڊورا
اوبنٽو apt-get سان:
apt-get اپڊيٽ apt-get انسٽال ڪريو - فڪس-مسنگ libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
يا اسڪرپٽ هلايو:

8/35

FAQ
src-script/install-packages-ubuntu
هومبرو بيرو سان ميڪ تي او ايس ايڪس:
brew انسٽال ڪريو pkg-config cairo pango libpng jpeg giflib librsvg
يا اسڪرپٽ هلايو:
src-اسڪرپٽ/انسٽال-پيڪيجز-او ايس ايڪس
سوال: ونڊوز او ايس تي هي ڪيئن ڪم ڪجي؟
الف: پڪ ڪريو ته اهو هميشه اپڊيٽ آهي ۽ ڪا به تبديلي نه آهي جيڪا انجام نه ڏني وئي آهي. صلاح: گٽ پل، گٽ اسٽيٽس ۽ گٽ اسٽيش توهان جا دوست آهن. ونڊوز او ايس تي زپ کي ڪم ڪرڻ لاءِ توهان کي چاڪليٽي استعمال ڪرڻ گهرجي. پڪ ڪريو ته pkgconfiglite پيڪيج ڊائون لوڊ ڪريو.
چاڪو انسٽال ڪريو pkgconfiglite
جيڪڏهن توهان کي قاهره سان مسئلا آهن، مثال طورampجيڪڏهن توهان کي cairo.h بابت ڪا غلطي ملي ته: اهڙو ڪو به ناهي file يا ڊاريڪٽري ۾، هيٺيان ڪريو: ò چيڪ ڪريو ته توهان جو ڪمپيوٽر 32 يا 64 بٽ آهي. ó ان تي منحصر ڪري، هن سائيٽ تان مناسب پيڪيج ڊائون لوڊ ڪريو.
https://github.com/benjamind/delarre.docpad/blob/master/src/documents/posts/installing-node-canvas-for-windows.html.md. ô Create a folder on your C drive called GTK if it doesn’t already exist. õ Unzip the downloaded content into C:/GTK. ö Copy all the dll files from C:/GTK/bin to your node_modules/canvas/build/Release folder in your zap folder. ÷ Add C:/GTK to the path Environment Variable by going to System in the Control Panel and doing the following:
ايڊوانسڊ سسٽم سيٽنگز تي ڪلڪ ڪريو. ايڊوانسڊ ٽيب ۾ انوائرمينٽ ويريبلز تي ڪلڪ ڪريو. سيڪشن سسٽم ويريبلز ۾، PATH انوائرمينٽ ويريبل ڳوليو ۽ ان کي چونڊيو. ايڊٽ تي ڪلڪ ڪريو ۽ ان ۾ C:/GTK شامل ڪريو. جيڪڏهن PATH انوائرمينٽ ويريبل موجود نه آهي، ته نئون تي ڪلڪ ڪريو. جيڪڏهن jpeglib.h نه مليو، ته هيٺ ڏنل ڪوشش ڪريو: ò ٽرمينل تي، هلايو: choco install libjpeg-turbo ó استعمال ڪندي پڪ ڪريو ته اهو صاف آهي: git clean -dxff ۽ هلايو npm install ٻيهر ô جيڪڏهن ڪا به غلطي نه ٿئي ۽ صرف ڊيڄاريندڙ ظاهر ٿين، npm آڊٽ فڪس استعمال ڪرڻ جي ڪوشش ڪريو õ جيڪڏهن توهان ZAP نه هلائي سگهو، ته وڃو file src-script/zap-start.js ö تبديلي
÷ const { spawn } = require('cross-spawn') کان const { spawn } = require('child_process') ø npm هلايو ۽ zap هلايو. حوالا:
https://github.com/fabricjs/fabric.js/issues/3611 https://github.com/benjamind/delarre.docpad/blob/master/src/documents/posts/installing-node-canvas-for-windows.html.md [https://chocolatey.org/packages/libjpeg-turbo#dependencies](https://chocolatey.org/packages/libjpeg-turbo#dependencies)
سوال: مون کي هڪ غلطي ملي ٿي "sqlite3_node" نه مليو يا ان سان ملندڙ.

9/35

FAQ
الف: پنهنجي اصلي sqlite3 بائنڊنگ کي ٻيهر ٺاهيو. گھڻن ڪيسن ۾ ان کي درست ڪرڻ لاءِ، هلايو:
اين پي ايم انسٽال ڪريو
./node_modules/.bin/اليڪٽران-ٻيهر تعمير -w sqlite3 -p
جيڪڏهن اهو اڃا تائين درست نه ٿئي، ته پوءِ ڪريو:
rm -rf node_modules ۽ پوءِ مٿي ڏنل حڪمن کي ٻيهر آزمايو. ڪڏهن ڪڏهن پنهنجي npm کي اپ گريڊ ڪرڻ سان پڻ فرق پوي ٿو:
اين پي ايم انسٽال - جي اين پي ايم
سوال: مون کي هڪ غلطي ملي ٿي "هن نوڊ انسٽنس جو N-API ورجن 1 آهي. هي ماڊيول N-API ورجن(ن) 3 کي سپورٽ ڪري ٿو. هي نوڊ انسٽنس هن ماڊيول کي هلائي نٿو سگهي."
الف: پنهنجي نوڊ ورجن کي اپ گريڊ ڪريو. ان جو حل هن اسٽيڪ اوور فلو ٿريڊ ۾ بحث ڪيو ويو آهي: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
سوال: منهنجو ڊولپمينٽ پي سي ڪنهن به سبب جي ڪري ZAP سان ڪم نٿو ڪري. ڇا مان ڊاڪر ڪنٽينر استعمال ڪري سگهان ٿو؟
الف: ها، توهان ڪري سگهو ٿا. نه.
سوال: مان VSCode اندر ZAP ڪيئن هلايان؟
الف: جيڪڏهن توهان پنهنجي رستي ۾ VSCode داخل ڪريو ٿا ته زپ ريپو داخل ڪريو ۽ ڪوڊ ٽائيپ ڪريو. اهو VSCode ۾ ZAP کوليندو. ڊيبگ موڊ ۾ ZAP هلائڻ لاءِ، ZAP ورڪ اسپيس چونڊيو ۽ کاٻي هٿ جي ٽول بار تي رن آئڪن تي ڪلڪ ڪريو. ZAP هلائڻ لاءِ توهان وٽ چونڊڻ لاءِ ڪجهه آپشن هوندا، Node.js ڊيبگ ٽرمينل چونڊيو. اهو هڪ ٽرمينل ونڊو کوليندو جتان توهان npm run zap داخل ڪري سگهو ٿا، جيڪو ڊيبگر کي ڳنڍيندو ۽ ZAP هلائيندو جيئن توهان عام طور تي ڪمانڊ لائن مان ڪندا آهيو. مبارڪون هجن، توهان کي هاڻي ڊيبگر ۾ ZAP هلندڙ ڏسڻ گهرجي. توهان VSCode ۾ بريڪ پوائنٽس سيٽ ڪري سگهو ٿا جيئن توهان ڪنهن ٻئي IDE ۾ ڪندا.
سوال: UI يونٽ ٽيسٽ ناڪام ٿي ويو آهي ۽ ڪينواس جي چوڌاري ڪجهه غلطيون آهن جيڪي نوڊ جي صحيح ورزن لاءِ نه ٺهيون آهن. مان ڇا ڪريان؟
الف: جيڪڏهن توهان هيٺ ڏنل غلطي ڏسو ٿا:
FAIL test/ui.test.js ٽيسٽ سوٽ هلائڻ ۾ ناڪام ٿيو. ماڊيول 'canvas.node' کي NODE_MODULE_VERSION 80 استعمال ڪندي هڪ مختلف Node.js ورجن جي خلاف مرتب ڪيو ويو. Node.js جي هن ورجن کي NODE_MODULE_VERSION 72 جي ضرورت آهي. مھرباني ڪري ماڊيول کي ٻيهر مرتب ڪرڻ يا ٻيهر انسٽال ڪرڻ جي ڪوشش ڪريو (مثال طور، `npm rebuild` يا `npm install` استعمال ڪندي).
اعتراض تي. (نوڊ_ماڊيولز/ڪينوس/لب/بائينڊنگس.جي ايس:3 18)
پوءِ هلايو: npm ڪينواس ٻيهر تعمير ڪريو - اپڊيٽ-بائنري

10/35

ZAP جا بنيادي اصول

ZCL/ڊيٽا ماڊل ZAP بنيادي اصول
هن حصي ۾ نون ZAP استعمال ڪندڙن لاءِ معلومات شامل آهي. ZAP UI جي مٿي ساڄي ڪنڊ تي ٽيوٽوريل آئڪن تي ڪلڪ ڪريو، جيڪو ڏيکاري ٿو ته ZAP ترتيب ڪيئن ٺاهجي. ٽيوٽوريل توهان کي هيٺ ڏنل ذريعي رهنمائي ڪندو: هڪ اينڊ پوائنٽ ٺاهيو هڪ ڊوائيس جو قسم چونڊيو هڪ ڪلسٽر ترتيب ڏيو هڪ خاصيت ترتيب ڏيو هڪ ڪمانڊ ترتيب ڏيو تفصيلي حوالي لاءِ، ڏسو Zigbee ڪلسٽر ترتيب ڏيڻ وارو گائيڊ

11/35

ZAP استعمال ڪندڙ جي ھدايت
ZAP استعمال ڪندڙ جي ھدايت
ZAP استعمال ڪندڙ جي ھدايت
هن گائيڊ هيٺ ڏنل سيڪشن ZAP پاران مهيا ڪيل مختلف خاصيتن بابت وڌيڪ تفصيل فراهم ڪن ٿا.

12/35

ڪسٽم ايڪس ايم ايل

ZAP UI مان ڪسٽم XML شامل ڪرڻ
ZAP UI ۾ "ايڪسٽينشن" آئڪن تي ڪلڪ ڪريو. ڪسٽم xml چونڊڻ لاءِ "+" ايڊ بٽڻ تي ڪلڪ ڪريو. file ڪسٽم ڪلسٽر، خاصيتون، ڪمانڊ، وغيره ZAP UI ۾ ظاهر ٿيڻ گهرجن جڏهن ڪسٽم xml شامل ڪيو ويندو.
زگبي ۾ پنهنجو ڪسٽم ايڪس ايم ايل ٺاهڻ
هي سيڪشن ڏيکاري ٿو ته ڪيئن پنهنجا ڪسٽم ڪلسٽر ٺاهيا وڃن ۽ موجوده معياري ڪلسٽرن کي Zigbee لاءِ ڪسٽم خاصيتن ۽ حڪمن سان وڌايو وڃي.
زگبي ۾ ٺاهيندڙ-مخصوص ڪلسٽر
توهان هڪ معياري پرو ۾ ٺاهيندڙ جي مخصوص ڪلسٽر شامل ڪري سگهو ٿاfile. اسان هڪ سابق مهيا ڪريون ٿاampهيٺ ڏنل مان. اهو ڪرڻ لاءِ توهان کي ٻه ذميواريون پوريون ڪرڻيون پونديون:
ڪلسٽر جي سڃاڻپ ٺاهيندڙ جي مخصوص حد ۾ هجڻ گهرجي، 0xfc00 - 0xffff. ڪلسٽر جي تعريف ۾ هڪ ٺاهيندڙ ڪوڊ شامل هجڻ گهرجي جيڪو ان ڪلسٽر اندر سڀني خاصيتن ۽ حڪمن تي لاڳو ڪيو ويندو ۽ حڪم موڪلڻ ۽ وصول ڪرڻ ۽ خاصيتن سان لهه وچڙ ڪرڻ وقت مهيا ڪيو ويندو. مثال طورampاليزي:

سampايم ايف جي مخصوص ڪلسٽر جنرل هي ڪلسٽر هڪ سابق مهيا ڪري ٿوampڪيئن ايپليڪيشن فريم ورڪ کي ٺاهيندڙ جي مخصوص ڪلسٽرن کي شامل ڪرڻ لاءِ وڌايو وڃي ٿو، ان بابت وضاحت.
0xFC00
ايمبر ايسampلي خاصيت
ايمبر ايسampخاصيت 2

اي ايسampٺاهيندڙ جي مخصوص حڪم جي اندرampٺاهيندڙ جي مخصوص
ڪلسٽر.

معياري زگبي ڪلسٽر ۾ ٺاهيندڙ-مخصوص حڪم
توهان هيٺ ڏنل گهرجن سان ڪنهن به معياري Zigbee ڪلسٽر ۾ پنهنجا حڪم شامل ڪري سگهو ٿا:
توهان جا ٺاهيندڙ مخصوص ڪمانڊ ڪمانڊ id رينج، 0x00 - 0xff اندر ڪنهن به ڪمانڊ id استعمال ڪري سگهن ٿا. توهان کي ڪمانڊ لاءِ هڪ ٺاهيندڙ ڪوڊ پڻ مهيا ڪرڻ گهرجي ته جيئن ان کي ڪلسٽر ۾ ٻين ڪمانڊ کان ڌار ڪري سگهجي ۽ مناسب طريقي سان سنڀاليو وڃي. مثال طور.ampپيداوار جي حڪمن سان آن/آف ڪلسٽر کي وڌائڻ جو طريقو:

13/35

ڪسٽم ايڪس ايم ايل
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي بند ڪري ٿو.ampمنتقلي وقت جي خاصيت.ampleMfgSpecificOnWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي آن ڪري ٿو.ampمنتقلي وقت جي خاصيت.ampleMfgSpecificToggleWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي ٽوگل ڪري ٿو.ampمنتقلي وقت جي خاصيت.ampleMfgSpecificOnWithTransition2″ اختياري=”سچو“ ٺاهيندڙ ڪوڊ=”0 1049″> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي آن ڪري ٿو.ampمنتقلي وقت جي خاصيت.ampleMfgSpecificToggleWithTransition2″ اختياري = "سچو"
ٺاهيندڙ ڪوڊ = "0 1049"> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي ٽوگل ڪري ٿو.ampمنتقلي وقت جي خاصيت.

معياري زگبي ڪلسٽر ۾ ٺاهيندڙ-مخصوص خاصيتون
توهان هيٺ ڏنل گهرجن سان ڪنهن به معياري Zigbee ڪلسٽر ۾ پنهنجون خاصيتون شامل ڪري سگهو ٿا:
توهان جي ٺاهيندڙ لاءِ مخصوص خاصيتون خاصيت جي سڃاڻپ جي حد اندر ڪنهن به خاصيت جي سڃاڻپ استعمال ڪري سگهن ٿيون، 0x0000 - 0xffff. توهان کي خاصيت لاءِ هڪ ٺاهيندڙ ڪوڊ پڻ مهيا ڪرڻ گهرجي ته جيئن ان کي ڪلسٽر ۾ ٻين خاصيتن کان ڌار ڪري سگهجي ۽ مناسب طريقي سان سنڀاليو وڃي. مثال طور.ampپيداوار جي خاصيتن سان آن/آف ڪلسٽر کي وڌائڻ جو فائدو:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” قسم = ”INT16U” منٽ = ”0 0000″
وڌ ۾ وڌ = "0xFFFF" لکڻ لائق = "سچو" ڊفالٽ = "0 0000" اختياري = "سچو" ٺاهيندڙ ڪوڊ = "0 1002"> ايسampايم ايف جي مخصوص خاصيت: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ قسم=”INT8U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 0000″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1049″>ايسampايم ايف جي مخصوص خاصيت: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ قسم=”INT8U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 00″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″>ايسampايم ايف جي مخصوص خاصيت: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ قسم=”INT16U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 0000″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1049″>ايسampايم ايف جي مخصوص خاصيت: 0 0001 0 1040
ميٽر ۾ پنهنجو ڪسٽم XML ٺاهڻ
هي سيڪشن ڏيکاري ٿو ته ڪيئن پنهنجا ڪسٽم ڪلسٽر ٺاهيا وڃن ۽ موجوده معياري ڪلسٽرن کي ڪسٽم خاصيتن ۽ ميٽر لاءِ ڪمانڊ سان وڌايو وڃي.
مادي ۾ ٺاهيندڙ-مخصوص ڪلسٽر
توهان ميٽر ۾ ٺاهيندڙ جي مخصوص ڪلسٽر شامل ڪري سگهو ٿا. اسان هڪ مثال فراهم ڪريون ٿاampهن جي هيٺان.
هي is a 32-bit combination of the manufacturer code and the id for the cluster. (required) The most significant 16 bits are the manufacturer code. The range for test manufacturer codes is 0xFFF1 – 0xFFF4. The least significant 16 bits are the cluster id. The range for manufacturer-specific clusters are: 0xFC00 – 0xFFFE.

14/35

ڪسٽم ايڪس ايم ايل
هيٺين مثال ۾ample، 0xFFF1 جي وينڊر ID (ٽيسٽ ٺاهيندڙ ID) ۽ 0xFC20 جي ڪلسٽر ID جو ميلاپ value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Exampاليزي:
جنرل سampلي ايم اي آءِ 0xFFF1FC20 سAMPلي_ايم اي آءِ_ڪلسٽر ايسampلي ايم اي آءِ ڪلسٽر هڪ ڪلسٽر ٺاهيندڙ ايڪسٽينشن ڏيکاري ٿو فلپ فلاپ
AddArguments لاءِ جواب جيڪو رقم واپس ڪري ٿو. ڪمانڊ جيڪو ٻه uint8 دليل وٺي ٿو ۽ انهن جو مجموعو واپس ڪري ٿو. سادو حڪم بغير ڪنهن پيرا ميٽر ۽ بغير ڪنهن جواب جي.
معياري مادي ڪلسٽر ۾ ٺاهيندڙ-مخصوص خاصيتون
توهان هيٺ ڏنل گهرجن سان ڪنهن به معياري ميٽر ڪلسٽر ۾ ٺاهيندڙ جي مخصوص خاصيتون شامل ڪري سگهو ٿا:
اهو ڪلسٽر جنهن سان وصفون منسوب ڪيون پيون وڃن، انهن کي بيان ڪيو وڃي -
ايڪسٽينڊ ايڊ > “>
خاصيت جو ڪوڊ ٺاهيندڙ ڪوڊ ۽ خاصيت لاءِ سڃاڻپ جو 32-بٽ ميلاپ آهي. سڀ کان اهم 16 بٽ ٺاهيندڙ ڪوڊ آهن. ٽيسٽ ٺاهيندڙ ڪوڊ جي حد 0xFFF1 - 0xFFF4 آهي. گهٽ ۾ گهٽ اهم 16 بٽ خاصيت جي سڃاڻپ آهن. غير عالمي خاصيتن جي حد 0x0000 - 0x4FFF آهي.
Exampپيداوار جي مخصوص خاصيتن سان آن/آف ميٽر ڪلسٽر کي وڌائڻ جو لي:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ قسم = "INT8U" منٽ = "0 0000"
وڌ ۾ وڌ = "0xFFFF" لکڻ لائق = "سچو" ڊفالٽ = "0 0000" اختياري = "سچو"> ايسampايم ايف جي مخصوص خاصيت 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ قسم = "INT16U" منٽ = "0 0000"
وڌ ۾ وڌ = "0xFFFF" لکڻ لائق = "سچو" ڊفالٽ = "0 0000" اختياري = "سچو"> ايسampايم ايف جي مخصوص خاصيت 4
معياري مادي ڪلسٽر ۾ ٺاهيندڙ-مخصوص حڪم
توهان هيٺ ڏنل گهرجن سان ڪنهن به معياري ميٽر ڪلسٽر ۾ ٺاهيندڙ مخصوص حڪم شامل ڪري سگهو ٿا:
اهو ڪلسٽر جنهن سان ڪمنٽ منسوب ڪيا پيا وڃن، ان کي ضرور بيان ڪيو وڃي -
ايڪسٽينڊ ايڊ > “>
ڪمانڊ جو ڪوڊ ٺاهيندڙ ڪوڊ ۽ ڪمانڊ لاءِ آئي ڊي جو 32-بٽ ميلاپ آهي. سڀ کان اهم 16 بٽ ٺاهيندڙ ڪوڊ آهن. ٽيسٽ ٺاهيندڙ ڪوڊ جي حد 0xFFF1 - 0xFFF4 آهي. گهٽ ۾ گهٽ اهم 16 بٽ ڪمانڊ آئي ڊي آهن. غير عالمي ڪمانڊ جي حد 0x0000 - 0x00FF آهي.
Exampپيداوار جي مخصوص ڪلسٽرن سان آن/آف ميٽر ڪلسٽر کي وڌائڻ جو طريقو:

15/35

ڪسٽم ايڪس ايم ايل

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ اختياري = "سچو"> ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي آن ڪري ٿو.ampمنتقلي وقت جي خاصيت.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ اختياري = "سچو">
ڪلائنٽ ڪمانڊ جيڪو ايمبر ايس ۾ منتقلي وقت پاران ڏنل منتقلي سان ڊوائيس کي ٽوگل ڪري ٿو.ampمنتقلي وقت جي خاصيت.

16/35

ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ

هيٺ ڏنل دستاويز هر هڪ xml بابت ڳالهائي ٿو tags زگبي سان لاڳاپيل.
هر ايڪس ايم ايل file ترتيب ڏيندڙ جي وچ ۾ درج ٿيل آهي tags:

ڊيٽا جي قسمن کي ترتيب ڏيندڙ اندر بيان ڪري سگهجي ٿو. tag. زگبي هن وقت بٽ ميپس، اينيمز، انٽيجرز، اسٽرنگز يا اسٽرڪٽس جي تعريف کي سپورٽ ڪري ٿو. وڌيڪ قسمن جي وضاحت ڪرڻ کان اڳ پڪ ڪريو ته types.xml ۾ بيان ڪيل سڀني موجوده ايٽمي قسمن ۽ ٻين xml ۾ بيان ڪيل سڀني غير ايٽمي قسمن کي چيڪ ڪريو. files. توهان انهن کي هن ريت بيان ڪري سگهو ٿا:
بِٽ ميپ: نالو: بِٽ ميپ جي قسم جو نالو. قسم: 8-64 بِٽ جي وچ ۾ سائيز وارو بِٽ ميپ بيان ڪري سگھجي ٿو، جيڪي سڀئي 8 جا ضرب هجڻ گهرجن. هر بِٽ ميپ ۾ ڪيترائي فيلڊ ٿي سگهن ٿا جن ۾ نالو ۽ ان سان لاڳاپيل هڪ ماسڪ هجي. مثال طور:

"`
اينوم: نالو: اينوم قسم جو نالو. قسم: 8-64 بِٽس جي وچ ۾ سائيز سان اينوم کي بيان ڪري سگهجي ٿو، جيڪي سڀئي 8 جا ضرب هجڻ گهرجن. هر اينوم ۾ ڪيترائي شيون ٿي سگهن ٿيون جن جو نالو ۽ ان سان لاڳاپيل قدر هجي. مثال طور:

انٽيجر: انٽيجر جا قسم اڳ ۾ ئي ايٽمي قسمن جي تحت بيان ڪيا ويا آهن جيڪي types.xml ۾ موجود آهن. انهن جي سائيز 8-64 بِٽس تائين ٿي سگهي ٿي ۽ انهن کي سائن يا ان سائن ڪري سگهجي ٿو. مثال طور:

اسٽرنگ: اسٽرنگ جا قسم اڳ ۾ ئي ايٽمي قسمن جي تحت بيان ڪيا ويا آهن جيڪي types.xml ۾ موجود آهن. موجوده اسٽرنگ جي قسمن ۾ آڪٽيٽ اسٽرنگ، چار اسٽرنگ، ڊگهي آڪٽيٽ اسٽرنگ ۽ ڊگهي چار اسٽرنگ شامل آهن مثال طور:

ساخت: نالو: ساخت جي قسم جو نالو. هر ساخت ۾ ڪيترائي شيون ٿي سگهن ٿيون جن جو نالو ۽ ان سان لاڳاپيل هڪ قسم آهي. قسم ڊيٽا جي قسمن جي تحت ڪا به اڳواٽ بيان ڪيل قسم ٿي سگهي ٿو. مثال طور:

17/35

ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ

<item name=”structItem1″ type=” Any defined type name in the xml file["/>

ڪسٽم ڪلسٽرز کي ڪنفيگيوٽر اندر بيان ڪري سگهجي ٿو. tag. نالو: ڪلسٽر ڊومين جو نالو: ڪلسٽر جو ڊومين. ڪلسٽر هن ڊومين جي تحت ZAP UI ۾ ظاهر ٿيندو. وضاحت: ڪلسٽر ڪوڊ جي وضاحت: ڪلسٽر ڪوڊ بيان ڪريو: ڪلسٽر بيان ڪريو جيڪو ڪوڊ جنريٽر پاران ڪلسٽر کي هڪ خاص طريقي سان بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي ٺاهيندڙ ڪوڊ: هڪ پيداوار جي مخصوص ڪلسٽر کي بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي. اهو 0xfc00 - 0xffff جي وچ ۾ هجڻ گهرجي. ڪلسٽر لاءِ ٺاهيندڙ ڪوڊ کي هيٺ ڏنل طور تي بيان ڪرڻ جي ضرورت آهي:

هڪ پيداواري ڪلسٽر خود بخود ساڳئي ٺاهيندڙ ڪوڊ جون خاصيتون ۽ حڪم ٺاهيندو آهي جيستائين اهي واضح طور تي ٺاهيندڙ ڪوڊ کي لسٽ نه ڪن. introducedIn: مخصوص ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪلسٽر متعارف ڪرايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. removedIn: مخصوص ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪلسٽر هٽايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. singleton(boolean): هڪ ڪلسٽر کي سنگلٽن جي طور تي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي ته جيئن ان ڪلسٽر جو صرف هڪ مثال آخري پوائنٽن ۾ شيئر ڪيو وڃي. وصف: ڪلسٽر جي نالي لاءِ هڪ وصف بيان ڪري ٿو: خاصيت جو نالو خاصيت جي وچ ۾ ذڪر ڪيو ويو آهي tag.
خاصيت جو نالو
side(client/server): ڪلسٽر جو اهو پاسو جنهن سان وصف پڻ لاڳاپيل آهي. ڪوڊ: وصف ڪوڊ ٺاهيندڙ ڪوڊ: هي معياري xml پاران ذڪر ڪيل زگبي وضاحت کان ٻاهر هڪ ٺاهيندڙ جي مخصوص وصف کي بيان ڪرڻ لاءِ استعمال ڪري سگهجي ٿو. define: وصف بيان ڪريو جيڪو ڪوڊ جنريٽر پاران استعمال ڪيو ويندو آهي هڪ خاص طريقي سان وصف کي بيان ڪرڻ لاءِ قسم: وصف جو قسم جيڪو xml ۾ ذڪر ڪيل ڊيٽا جي قسمن مان ڪو به ٿي سگهي ٿو ڊفالٽ: وصف لاءِ ڊفالٽ قدر. منٽ: هڪ وصف لاءِ گهٽ ۾ گهٽ اجازت ڏنل قدر وڌ ۾ وڌ: هڪ وصف لاءِ وڌ ۾ وڌ اجازت ڏنل قدر لکڻ جي قابل: ڇا وصف جي قيمت لکڻ جي قابل آهي يا نه. اهو وصف کي لکڻ جي حڪمن ذريعي تبديل ٿيڻ کان روڪڻ لاءِ استعمال ڪري سگهجي ٿو. اختياري (بولين): اهو طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي ته هڪ وصف اختياري آهي يا نه ڪلسٽر لاءِ. منٽ: هڪ وصف لاءِ گهٽ ۾ گهٽ اجازت ڏنل قدر جڏهن اهو هڪ انٽيجر، اينم يا بٽ ميپ قسم هجي. وڌ ۾ وڌ: وصف لاءِ وڌ ۾ وڌ اجازت ڏنل قدر جڏهن اهو هڪ انٽيجر، اينم يا بٽ ميپ قسم جي ڊيگهه هجي: وصف جي وڌ ۾ وڌ ڊيگهه بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي جڏهن اهو قسم جي اسٽرنگ هجي. منٽ ڊگھائي: وصف جي گهٽ ۾ گهٽ ڊيگهه بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي جڏهن اهو قسم جي اسٽرنگ هجي. منٽ ڊگھائي: وصف جي گهٽ ۾ گهٽ ڊيگهه بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي جڏهن اهو قسم جي اسٽرنگ هجي. رپورٽ لائق (بولين): ٻڌائي ٿو ته ڪا خاصيت رپورٽ لائق آهي يا نه isNullable (بولين): خاصيت لاءِ خالي قدرن جي اجازت ڏئي ٿي. array(بولين): قسم جي صف جي خاصيت کي بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي. introducedIn: مخصوص ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ خاصيت متعارف ڪرائي وئي هئي. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. removedIn: مخصوص ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ خاصيت کي هٽايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. حڪم: ڪلسٽر جي نالي لاءِ هڪ حڪم بيان ڪريو: حڪم جو نالو.

ڪوڊ: حڪم ڪوڊ

18/35

ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ
ٺاهيندڙ ڪوڊ: هي معياري xml پاران ذڪر ڪيل زگبي وضاحت کان ٻاهر ٺاهيندڙ جي مخصوص ڪمانڊ کي بيان ڪرڻ لاءِ استعمال ڪري سگهجي ٿو. وضاحت: ڪمانڊ سورس (ڪلائنٽ/سرور) جي وضاحت: ڪمانڊ جو ذريعو. اختياري (بولين): اهو طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي ته ڪو ڪمانڊ ڪلسٽر لاءِ اختياري آهي يا نه. introducedIn: اسپيڪ ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪمانڊ متعارف ڪرايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. removedIn: اسپيڪ ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪمانڊ هٽايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. ڪمانڊ دليل:
هر ڪمانڊ ۾ ڪمانڊ دليلن جو هڪ سيٽ ٿي سگهي ٿو نالو: ڪمانڊ دليل جي قسم جو نالو: ڪمانڊ دليل جو قسم جيڪو xml ۾ ذڪر ڪيل ڪنهن به قسم جو ٿي سگهي ٿو. منٽ: هڪ دليل لاءِ گهٽ ۾ گهٽ اجازت ڏنل قدر جڏهن اهو هڪ انٽيجر، اينم يا بٽ ميپ قسم آهي. وڌ ۾ وڌ: هڪ دليل لاءِ وڌ ۾ وڌ اجازت ڏنل قدر جڏهن اهو هڪ انٽيجر، اينم يا بٽ ميپ قسم جي ڊيگهه آهي: ڪمانڊ دليل لاءِ وڌ ۾ وڌ اجازت ڏنل ڊيگهه بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي جڏهن اهو قسم جو اسٽرنگ آهي. منٽ ڊگھائي: ڪمانڊ دليل لاءِ گهٽ ۾ گهٽ اجازت ڏنل ڊيگهه بيان ڪرڻ لاءِ استعمال ڪيو ويندو آهي جڏهن اهو قسم جو اسٽرنگ آهي. array(boolean): اهو طئي ڪرڻ لاءِ ته ڇا ڪمانڊ دليل قسم جو array آهي. presentIf(string): اهو ٻين ڪمانڊ دليلن جي بنياد تي منطقي عملن جي هڪ مشروط اسٽرنگ ٿي سگهي ٿو جتي توهان ڪمانڊ دليل جي توقع ڪري سگهو ٿا جيڪڏهن مشروط اسٽرنگ صحيح ٿي وڃي. مثال طور:

نوٽ: هتي اسٽيٽس هڪ ٻيو ڪمانڊ دليل جو نالو آهي. optional(boolean): ڪمانڊ دليل کي اختياري طور طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي. countArg: استعمال ڪيو ويندو آهي جڏهن ڪمانڊ دليل قسم جو array هجي. اهو ٻئي ڪمانڊ دليل جو ذڪر ڪرڻ لاءِ استعمال ڪيو ويندو آهي جيڪو هن دليل لاءِ array جي سائيز کي ظاهر ڪري ٿو.

introducedIn: اسپيڪ ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪمانڊ دليل متعارف ڪرايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. removedIn: اسپيڪ ورجن کي طئي ڪرڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ ڪمانڊ دليل هٽايو ويو هو. هي ڪوڊ جنريٽر پاران اضافي منطق شامل ڪرڻ لاءِ استعمال ڪيو ويندو آهي. ڪلسٽر ايڪسٽينشن کي ترتيب ڏيندڙ اندر بيان ڪري سگهجي ٿو. tag. ڪلسٽر ايڪسٽينشن کي معياري ڪلسٽر کي وڌائڻ لاءِ استعمال ڪيو ويندو آهي جنهن ۾ پيداوار جون خاصيتون ۽ حڪم شامل آهن مثال طور

19/35

ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” قسم=”INT16U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 0000″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″>ايسampايم ايف جي مخصوص خاصيت: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ قسم=”INT8U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 0000″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1049″>ايسampايم ايف جي مخصوص خاصيت: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ قسم=”INT8U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 00″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″>ايسampايم ايف جي مخصوص خاصيت: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ قسم=”INT16U” منٽ=”0 0000″ وڌ ۾ وڌ=”0xFFFF” لکڻ لائق=”سچو” ڊفالٽ=”0 0000″ اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1049″>ايسampايم ايف جي مخصوص خاصيت: 0 0001 0 1040ampleMfgSpecificOffWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ڊوائيس کي هڪ منتقلي سان بند ڪري ٿو
ايمبر ايس ۾ منتقلي جي وقت سانampمنتقلي وقت جي خاصيت.ampleMfgSpecificOnWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ڊوائيس کي هڪ منتقلي سان آن ڪري ٿو
ايمبر ايس ۾ منتقلي جي وقت سانampمنتقلي وقت جي خاصيت.ampleMfgSpecificToggleWithTransition” اختياري=”سچو” ٺاهيندڙ ڪوڊ=”0 1002″> ڪلائنٽ ڪمانڊ جيڪو ڏنل منتقلي سان ڊوائيس کي ٽوگل ڪري ٿو
ايمبر ايس ۾ منتقلي جي وقت سانampمنتقلي وقت جي خاصيت.ampleMfgSpecificOnWithTransition2″ اختياري=”سچو“ ٺاهيندڙ ڪوڊ=”0 1049″> ڪلائنٽ ڪمانڊ جيڪو ڊوائيس کي هڪ منتقلي سان آن ڪري ٿو
ايمبر ايس ۾ منتقلي جي وقت سانampمنتقلي وقت جي خاصيت.ampleMfgSpecificToggleWithTransition2″ اختياري=”سچو“ ٺاهيندڙ ڪوڊ=”0 1049″> ڪلائنٽ ڪمانڊ جيڪو ڏنل منتقلي سان ڊوائيس کي ٽوگل ڪري ٿو
ايمبر ايس ۾ منتقلي جي وقت سانampمنتقلي وقت جي خاصيت.

20/35

هر اينڊ پوائنٽ تي ڪيترائي ڊوائيس قسم

هي هڪ Matter-only خصوصيت آهي جتي هڪ صارف هر اينڊ پوائنٽ لاءِ هڪ کان وڌيڪ ڊيوائس قسم چونڊي سگهي ٿو. ڪيترن ئي aaa ڊيوائس قسمن جو اضافو ڊيوائس قسمن اندر ڪلسٽر ترتيبن کي اينڊ پوائنٽ ترتيب ۾ شامل ڪندو.

21/35

هر اينڊ پوائنٽ تي ڪيترائي ڊوائيس قسم

مٿي ڏنل تصوير ڏيکاري ٿي ته اينڊ پوائنٽ 1 ۾ هڪ کان وڌيڪ ڊيوائس قسم چونڊيا ويا آهن. "پرائمري ڊيوائس" پرائمري ڊيوائس قسم کي ظاهر ڪري ٿو جنهن سان اينڊ پوائنٽ لاڳاپيل هوندو. پرائمري ڊيوائس قسم هميشه چونڊيل ڊيوائس قسمن جي فهرست جي انڊيڪس 0 تي موجود هوندو آهي تنهن ڪري هڪ مختلف پرائمري ڊيوائس قسم چونڊڻ سان چونڊيل ڊيوائس قسمن جي ترتيب تبديل ٿي ويندي. ڊيوائس قسم جي چونڊ ۾ ڊيٽا ماڊل وضاحت جي بنياد تي پابنديون پڻ هونديون آهن. ZAP صارفين کي انهن پابندين کي استعمال ڪندي اينڊ پوائنٽ تي ڊيوائس قسمن جي غلط ميلاپ چونڊڻ کان بچائيندو آهي.

22/35

ميٽر ڊيوائس ٽائپ فيچر پيج
ميٽر ڊيوائس ٽائپ فيچر پيج
ميٽر ڊيوائس ٽائپ فيچر پيج
ZAP ڊوائيس قسم جي خصوصيت واري صفحي ۾ ميٽر جي خاصيتن کي ڏسڻ ۽ ٽوگل ڪرڻ جي حمايت ڪري ٿو. صرف CHIP ريپوزٽري ۾ matter-devices.xml ۾ بيان ڪيل ڊوائيس قسم جون خاصيتون ڏيکاريون وينديون.

فيچر پيج تي نيويگيٽ ڪرڻ
ò اپ ٽو ڊيٽ Matter SDK سان Matter ۾ ZAP لانچ ڪريو. ó Matter ڊوائيس جي قسم سان هڪ اينڊ پوائنٽ ٺاهيو. ô ڪلسٽر جي مٿئين وچ ۾ ڊوائيس جي قسم جي خاصيتن جي بٽڻ تي ڪلڪ ڪريو. view. نوٽ ڪريو ته هي بٽڻ صرف ZAP ۾ موجود آهي.
ميٽر لاءِ ترتيبون ۽ جڏهن ميٽر SDK ۾ مطابقت ڊيٽا موجود آهي. هن بٽڻ تي ڪلڪ ڪرڻ سان مٿي ڏنل تصوير کلي ويندي.
مطابقت
مطابقت خاصيتن، حڪمن، واقعن، ۽ ڊيٽا جي قسمن لاءِ اختياري ۽ انحصار کي بيان ڪري ٿي. اهو طئي ڪري ٿو ته ڪو عنصر لازمي، اختياري، يا ڪجهه ZAP ترتيبن جي تحت غير معاون آهي.
ڊوائيس جي قسم جي خصوصيت جي مطابقت ڪلسٽر جي خصوصيت جي مطابقت تي ترجيح رکي ٿي. مثال طورampلي، لائٽنگ فيچر ۾ آن/آف ڪلسٽر ۾ اختياري مطابقت آهي پر ان کي آن/آف لائيٽ ڊيوائس ٽائپ ۾ لازمي قرار ڏنو ويو آهي جنهن ۾ آن/آف ڪلسٽر شامل آهي. آن/آف لائيٽ ڊيوائس ٽائپ سان اينڊ پوائنٽ ٺاهڻ سان لائٽنگ فيچر فيچر پيج تي لازمي طور تي ڏيکاريو ويندو.
خصوصيت ٽوگلنگ
فيچر پيج تي، جڏهن توهان ڪنهن فيچر کي فعال يا غير فعال ڪرڻ لاءِ ٽوگل بٽڻ تي ڪلڪ ڪندا، ZAP ڪندو:
مطابقت کي درست ڪرڻ لاءِ لاڳاپيل عنصرن (خاصيتون، حڪم، واقعا) کي اپڊيٽ ڪريو، ۽ تبديلين کي ڏيکاريندڙ هڪ ڊائلاگ ڏيکاريو.

23/35

ميٽر ڊيوائس ٽائيپ فيچر پيج لاڳاپيل ڪلسٽر جي فيچر ميپ وصف ۾ فيچر بٽ کي اپڊيٽ ڪريو

فيچر ڊائلاگ کي فعال ڪريو

خصوصيت واري ڊائلاگ کي غير فعال ڪريو

ڪجهه خاصيتن لاءِ ٽوگلنگ غير فعال آهي جڏهن انهن جي مطابقت ۾ ڪا نامعلوم قيمت هجي يا في الحال غير معاون فارم t هجي. هن عمل ۾، ZAP نوٽيفڪيشن ايپ ۾ ڊيڄاريندڙ ڏيکاريندو.
وا عنصر جي مطابقت

جڏهن توهان ڪنهن عنصر کي ٽوگل ڪندا آهيو، ته ZAP شايد ڊوائيس جي تعميل جي خبرداري ۽ مطابقت جي خبرداري ٻنهي کي ڏيکاري سگهي ٿو. جيڪڏهن عنصر جي حالت متوقع مطابقت سان نه ملندي آهي، ته ZAP هڪ خبرداري آئڪن ڏيکاريندو ۽ نوٽيفڪيشن ايپ ۾ خبرداري کي لاگ ڪندو. مثال طور.ampهڪ عنصر لاءِ ڏيکاريل تعميل ۽ مطابقت جي خبرداري ٻنهي جي لي:

24/35

نوٽيفڪيشن
نوٽيفڪيشن
نوٽيفڪيشن
هيٺ ڏنل سيڪشن وضاحت ڪري ٿو ته UI ۾ ZAP استعمال ڪندڙن کي اطلاع ڪيئن ڏنا وڃن ٿا.
پيڪيج نوٽيفڪيشن
پيڪيج نوٽيفڪيشنز ZAP ۾ لوڊ ٿيل ڪنهن به مخصوص پيڪيج سان لاڳاپيل ڊيڄاريندڙ يا غلطي جا پيغام آهن. مثال طورampيا، هيٺ ڏنل تصويرن ۾، اسٽيٽس ڪالم جي هيٺان وارننگ آئڪن تي ڪلڪ ڪرڻ سان توهان کي هڪ ڊائلاگ ڏانهن وٺي ويندو جيڪو ان پيڪيج لاءِ سڀ اطلاع ڏيکاريندو.

25/35

نوٽيفڪيشن
سيشن نوٽيفڪيشن
سيشن نوٽيفڪيشن اهي ڊيڄاريندڙ يا غلطي جا پيغام آهن جيڪي صارف سيشن سان لاڳاپيل هوندا آهن. اهي ڊيڄاريندڙ/ غلطيون ZAP UI جي مٿان ٽول بار ۾ نوٽيفڪيشن بٽڻ تي ڪلڪ ڪندي ڏسي سگهجن ٿيون. مثال طورampلي، هيٺ ڏنل تصوير هڪ isc کان پوءِ سيشن نوٽيفڪيشن صفحي کي ڏيکاري ٿي. file ZAP ۾ لوڊ ڪيو ويو.

26/35

ڊيٽا-ماڊل/ZCL وضاحتن جي تعميل
ڊيٽا-ماڊل/ZCL وضاحتن جي تعميل
ڊيٽا ماڊل ۽ ZCL وضاحتن جي تعميل
ZAP ۾ هي خصوصيت صارفين کي ڊيٽا ماڊل يا ZCL لاءِ انهن جي موجوده ZAP ترتيبن سان تعميل ناڪامين کي ڏسڻ ۾ مدد ڪري ٿي. تعميل ناڪامين لاءِ ڊيڄاريندڙ پيغام ZAP UI ۾ نوٽيفڪيشن پين تي ظاهر ٿيندا ۽ CLI ذريعي ZAP هلائڻ وقت ڪنسول تي پڻ لاگ ان ٿيندا. تعميل خصوصيت هن وقت هڪ اينڊ پوائنٽ تي ڊوائيس جي قسم جي تعميل ۽ ڪلسٽر تعميل لاءِ ڊيڄاريندڙ مهيا ڪري ٿي.
ZAP UI ۾ تعميل جي خبرداري
جڏهن ڪو صارف .zap کوليندو آهي file ZAP UI استعمال ڪندي اهي سڀني تعميل ناڪامين لاءِ ZAP UI جي نوٽيفڪيشن پين ۾ ڊيڄاريندڙ ڏسندا. مثال طورampلي، هيٺ ڏنل تصوير .zap کان پوءِ سيشن نوٽيفڪيشن صفحي کي ڏيکاري ٿي. file تعميل جي مسئلن سان کوليو ويو هو.

ZAP UI استعمال ڪندي مسئلا حل ٿيڻ کان پوءِ تعميل جا پيغام ختم ٿي ويندا ته جيئن توهان صرف باقي تعميل جي مسئلن جو ٽريڪ رکي سگهو. جيڪڏهن صارف ترتيب جي لازمي عنصرن (ڪلسٽر/ڪمانڊ/وصفات) کي غير فعال ڪري ٿو ته تعميل لاءِ نوان ڊيڄاريندڙ پڻ ظاهر ٿيندا. وضاحت جي تعميل جون اطلاعون هميشه ڪنهن به ناڪامي جو ٽريڪ رکنديون جيڪي ZAP ترتيب ۾ متعارف ڪرايون ويون آهن پر ياد رکو ته ڊيڄاريندڙ جيڪي .zap جي افتتاح دوران ظاهر ٿين ٿيون. file وڌيڪ تفصيل سان بيان ڪيو ويو آهي ته اهو ڇو ناڪام ٿيو جڏهن ان جي مقابلي ۾ ڊيڄاريندڙن جي مقابلي ۾ جيڪي UI سان لهه وچڙ دوران ظاهر ٿين ٿا. هي ڊيزائن جي لحاظ کان آهي ۽ هڪ مڪمل تعميل چيڪ .zap جي افتتاح دوران ڪيو ويندو آهي. file.
ڪنسول تي تعميل جي خبرداري

27/35

ڊيٽا-ماڊل/ZCL وضاحتن جي تعميل
جڏهن ڪو صارف .zap کوليندو آهي file ZAP اسٽينڊ اڪيلو UI يا ZAP CLI استعمال ڪندي اهي سڀني تعميل ناڪامين لاءِ ڪنسول/ٽرمينل ۾ لاگ ان ٿيل ڊيڄاريندڙ ڏسندا. مثال طورampلي، هيٺ ڏنل تصوير .zap کان پوءِ ڪنسول/ٽرمينل تي سيشن نوٽيفڪيشن وارننگ ڏيکاري ٿي. file تعميل جي مسئلن سان کوليو ويو هو.

28/35

رسائي ڪنٽرول

رسائي ڪنٽرول خاصيتون
ZAP سڀني ZCL ادارن تي رسائي ڪنٽرول کي سپورٽ ڪري ٿو. اهو SDK جي عملدرآمد تي منحصر آهي ته انهن خاصيتن کي گهربل ۽ سپورٽ ٿيل رسائي ڪنٽرول SDK خاصيتن سان نقشو ڪيو وڃي. ZAP عام طور تي هڪ ڊيٽا ماڊل ۽ ميٽا-معلومات ۾ انڪوڊ ڪرڻ لاءِ هڪ ميڪانيزم فراهم ڪري ٿو. files ۽ ان ڊيٽا کي جنريشن ٽيمپليٽس تائين پهچائين ٿا، ڊيٽا پوائنٽس کي مخصوص معنيٰ ڏيڻ کان سواءِ.
بنيادي شرطون
ZAP رسائي ڪنٽرول ٽن بنيادي اصطلاحن کي بيان ڪري ٿو، جيئن هيٺ ڏنل آهي: ò آپريشن: اهڙي شيءِ جي طور تي بيان ڪيو ويو آهي جيڪو ڪري سگهجي ٿو. مثال طورample: پڙهو، لکو، سڏ ڪريو. ó ڪردار: هڪ اداڪار جي استحقاق جي طور تي بيان ڪيو ويو آهي. جهڙوڪ "View "privilege"، "انتظامي ڪردار"، ۽ پٽ آن. ô modifiers: خاص رسائي ڪنٽرول حالتن جي طور تي بيان ڪيو ويو آهي، جهڙوڪ ڪپڙي جي حساس ڊيٽا يا ڪپڙي جي اسڪوپ ٿيل ڊيٽا. بنيادي اصطلاح ميٽا ڊيٽا XML ۾ مٿي هيٺ بيان ڪيا ويا آهن tag . هيٺ ڏنل هڪ سابق آهيampرسائي ڪنٽرول جي بنيادي اصطلاح جي وصف:
<role type=”view"وضاحت ="View امتياز"/>
هن اڳوڻيample ٽن عملن جي وضاحت ڪري ٿو، پڙهڻ، لکڻ ۽ سڏڻ، ٻه ترميم ڪندڙ ۽ چار ڪردار.
ٽرپلٽس تائين رسائي
هر انفرادي رسائي جي حالت کي XML ۾ رسائي ٽرپلٽ سان بيان ڪري سگهجي ٿو. رسائي ٽرپلٽ هڪ آپريشن، ڪردار ۽ موڊيفائر جو ميلاپ آهي. اهي اختياري آهن، تنهنڪري توهان انهن مان صرف هڪ رکي سگهو ٿا. ٽرپلٽ جو هڪ گم ٿيل حصو عام طور تي اجازت نامو جو مطلب آهي، جيڪو ڏنل SDK لاءِ لاڳو ڪرڻ لاءِ مخصوص آهي. هڪ ادارو جيڪو ان جي رسائي کي بيان ڪري ٿو ان ۾ هڪ يا وڌيڪ رسائي ٽرپلٽ ٿي سگهن ٿا. هيٺ ڏنل هڪ مثال آهيampاليزي:
at0 تي
هي هڪ اهڙي خاصيت جي تعريف آهي جنهن ۾ هڪ رسائي ٽرپلٽ آهي، اهو اعلان ڪندي ته اهو هڪ مينيجمينٽ رول ذريعي لکڻ جي آپريشن جي اجازت ڏئي ٿو، جنهن ۾ فيبرڪ-اسڪوپڊ موڊيفائر لاڳو ڪيو ويو آهي.
ڊفالٽ اجازتون

29/35

رسائي ڪنٽرول
ZCL ادارا پنهنجي انفرادي اجازتن کي بيان ڪري سگهن ٿا. جڏهن ته، ڊفالٽ اجازتن جي هڪ عالمي تعريف پڻ آهي
ڏنل قسم. اهي ڏنل اداري لاءِ فرض ڪيا ويا آهن، جيستائين اهو پنهنجي طرفان ڪا خاص اجازت نه ڏئي.
ڊفالٽ اجازتون هڪ ذريعي اعلان ڪيون وينديون آهن tag XML جي مٿين سطح تي file. سابقampاليزي:
آ a< ccess op="invoke"/> a هڪ aa <ccess op="re d"/> a< ccess op="write"/> a آ aa <ccess op="re d" ڪردار="view”/> aa <ccess op=”write” role=”oper te”/> a
ٽيمپليٽ مددگار
استعمال ڪرڻ لاءِ بنيادي ٽيمپليٽ مددگار {{#access}} … {{/access}} iterator آهي. هي iterator سڀني ڏنل رسائي ٽرپلٽس تي iterate ڪري ٿو.
اهو هيٺين ٻن اختيارن جي حمايت ڪري ٿو:
entity=”attribute/command/event” – جيڪڏهن entity کي تناظر مان طئي نه ٿو ڪري سگهجي، ته اهو entity جي قسم کي سيٽ ڪري ٿو. includeDefault=”true/false” – اهو طئي ڪري ٿو ته ڊفالٽ قدر شامل آهن يا نه. هيٺ ڏنل هڪ ex آهيampاليزي:
{{#zcl_clusters}}
هڪ ڪلسٽر: {{n me}} [{{code}}] هڪ {{#zcl_ ttributes}} aa – ttribute: {{n me}} [{{code}}] aa {{# ccess entity=” ttribute”}}
O a RM a M * p: {{operation}} / ole: {{role}} / ايڊيفائر: {{ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_commnds}} aa – commnd: {{n me}} [{{code}}] aa {{# ccess entity=”commnd”}} O a RM a M * p: {{operation}} / ole: {{role}} / ايڊيفائر: {{ccess odifier}} a{{/ ccess}} a {{/zcl_commnds}}
{{#zcl_events}}
a – واقعو: {{n me}} [{{code}}] a {{# ccess entity=”event”}} O a RM a M * p: {{operation}} / ole: {{role}} / تصنيف ڪندڙ: {{ ccess تصنيف ڪندڙ}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

ميٽر يا زگبي ايپليڪيشنن لاءِ ZAP لانچ ڪرڻ
ميٽر يا زگبي ايپليڪيشنن لاءِ ZAP لانچ ڪرڻ
ميٽر يا زگبي ايپليڪيشنن لاءِ ZAP لانچ ڪرڻ
هيٺ ڏنل سيڪشن بيان ڪن ٿا ته ZAP کي اسٽينڊ اڪيلو موڊ ۾ ميٽر يا زگبي مخصوص ميٽا ڊيٽا سان لانچ ڪيو وڃي. خيال اهو آهي ته XML ميٽا ڊيٽا سان لاڳاپيل صحيح دليلن (CSA وضاحتن مطابق ڪلسٽر ۽ ڊوائيس جي قسمن جي تعريف) ۽ جنريشن ٽيمپليٽس سان ZAP لانچ ڪيو وڃي، جيڪي مناسب ڪوڊ پيدا ڪرڻ لاءِ استعمال ڪيا ويندا آهن.
ميٽر سان ZAP لانچ ڪرڻ
هيٺ ڏنل اسڪرپٽ ZAP لانچ ڪرڻ وقت Matter SDK مان صحيح ميٽا ڊيٽا گڏ ڪري ٿي. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh نوٽ: توهان Matter ۾ ZAP لانچ ڪرڻ لاءِ هيٺ ڏنل Zigbee طريقو پڻ اختيار ڪري سگهو ٿا.
زگبي سان گڏ ZAP لانچ ڪرڻ
هيٺ ڏنل ڪمانڊ SDK مان ZCL وضاحتن ۽ جنريشن ٽيمپليٽس سان ZAP لانچ ڪري ٿو.
[زپ-پاٿ] -z [sdk-پاٿ]/gsdk/app/zcl/zcl-zap.json -g [sdk-پاٿ]/gsdk/protocol/zigbee/app/framework/gen-templates/gen-templates.json
زپ-پاٿ: هي ZAP سورس يا ايگزيڪيوٽيبل sdk-پاٿ جو رستو آهي: هي SDK جو رستو آهي.
ميٽا ڊيٽا کان سواءِ ZAP لانچ ڪرڻ
ياد رکو ته جڏهن Npm رن زپ استعمال ڪندي ZAP کي سڌو سنئون ايگزيڪيوٽوبل ذريعي يا ذريعو مان لانچ ڪيو وڃي ته توهان ZAP اندر بلٽ ان Matter/Zigbee لاءِ ٽيسٽ ميٽا ڊيٽا سان لانچ ڪري رهيا آهيو ۽ مٿي ذڪر ڪيل Matter ۽ Zigbee SDKs مان ايندڙ اصل ميٽا ڊيٽا نه. تنهن ڪري، ياد رکو ته پنهنجون ZAP ترتيبون SDK ميٽا ڊيٽا استعمال ڪندي ٺاهيو ۽ بلٽ ان ٽيسٽ ميٽا ڊيٽا سان سڌو سنئون ZAP کولڻ سان نه.

31/35

ميٽر يا زگبي لاءِ ڪوڊ ٺاهڻ

ميٽر، زگبي يا ڪسٽم SDK لاءِ ڪوڊ تيار ڪرڻ
هيٺ ڏنل سيڪشن بيان ڪن ٿا ته ZAP استعمال ڪندي ڪوڊ ڪيئن پيدا ڪجي.
ZAP UI استعمال ڪندي ڪوڊ ٺاهيو
ZAP UI لانچ ڪريو جيئن "Launching ZAP for Matter" يا "Zigbee" ۾ ڏنل هدايتن مطابق ۽ مٿي مينيو بار ۾ "Genret" بٽڻ تي ڪلڪ ڪريو.
UI کان سواءِ ڪوڊ ٺاهيو
هيٺ ڏنل هدايتون ZAP UI لانچ ڪرڻ کان سواءِ CLI ذريعي ڪوڊ پيدا ڪرڻ جا مختلف طريقا مهيا ڪن ٿيون.
ZAP ماخذ مان ڪوڊ تيار ڪرڻ
ZAP استعمال ڪندي سورس مان ڪوڊ ٺاهڻ لاءِ هيٺ ڏنل حڪم هلايو: node src-script/zap-generate.js –genResultFile - اسٽيٽ ڊائريڪٽري ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-
ٽيمپليٽ/زگبي/جن-ٽيمپليٽس.جيسن -i ./test/resource/three-endpoint-device.zap -o ./tmp
ZAP ايگزيڪيوٽو مان ڪوڊ تيار ڪرڻ
ZAP ايگزيڪيوٽوبل استعمال ڪندي ڪوڊ جنريٽر ڪرڻ لاءِ هيٺ ڏنل حڪم هلايو: [zap-path] generate –genResultFile - اسٽيٽ ڊائريڪٽري ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp
ZAP CLI ايگزيڪيوٽوبل مان ڪوڊ تيار ڪرڻ
ZAP CLI ايگزيڪيوٽو استعمال ڪندي ڪوڊ جنريٽر ڪرڻ لاءِ هيٺ ڏنل حڪم هلايو: [zap-cli-path] generate –genResultFile - اسٽيٽ ڊائريڪٽري ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp

32/35

اسٽوڊيو ۾ ZAP اپڊيٽ ڪريو

ZAP اپڊيٽ ڪريو
سمپليسيٽي اسٽوڊيو ۾ ZAP اپڊيٽ ڪريو
هي طريقو استعمال ڪري سگهجي ٿو جڏهن سلڪون ليبز SDK رليز مان ميٽر ايڪسٽينشن يا زگبي سان ڪم ڪري رهيو هجي. ZAP کي سمپليسيٽي اسٽوڊيو اندر بغير سمپليسيٽي اسٽوڊيو رليز جي تازه ترين ZAP ايگزيڪيوٽو (سفارش ٿيل) ڊائون لوڊ ڪندي يا ZAP انسٽاليشن گائيڊ ۾ ڏيکاريل ZAP سورس مان تازو ڪڍڻ سان اپڊيٽ ڪري سگهجي ٿو. جڏهن توهان وٽ توهان جي موجوده استعمال ٿيل OS جي بنياد تي جديد ZAP هجي، ته توهان اسٽوڊيو اندر هڪ اڊاپٽر پيڪ جي طور تي ZAP کي اپڊيٽ ڪري سگهو ٿا. جديد ZAP ڊائون لوڊ ڪرڻ کان پوءِ هيٺ ڏنل هدايتن تي عمل ڪريو:
سمپليسيٽي اسٽوڊيو ڏانهن وڃو ۽ ترجيحات > سمپليسيٽي اسٽوڊيو > اڊاپٽر پيڪ چونڊيو. شامل ڪريو تي ڪلڪ ڪريو... ۽ وڌايل ZAP فولڊر ڏانهن براؤز ڪريو جيڪو توهان ڊائون لوڊ ڪيو آهي ۽ فولڊر چونڊيو تي ڪلڪ ڪريو. لاڳو ڪريو ۽ بند ڪريو تي ڪلڪ ڪريو ۽ پوءِ نئون شامل ڪيل ZAP استعمال ڪيو ويندو جڏهن به .zap file کوليو ويو آهي.
نوٽ: ڪڏهن ڪڏهن ZAP جا پراڻا مثال اڳ ۾ ئي هلندڙ هوندا جيتوڻيڪ تازي ZAP تي اپڊيٽ ڪرڻ کان پوءِ. پڪ ڪريو ته سڀني موجوده ZAP مثالن کي ختم ڪريو ته جيئن نئين حاصل ڪيل ZAP کي پراڻي مثال جي بدران استعمال ڪيو وڃي، جيڪو اڃا تائين پس منظر ۾ ڪم ڪري رهيو آهي.
گِٿب ۾ ميٽر ڊولپمينٽ لاءِ ZAP اپڊيٽ ڪريو
جڏهن گِٿب تي ميٽر يا ميٽر-سلِڪون ليبز ريپوز سان ڪم ڪري رهيا آهيو، ته پوءِ نئين ZAP ترتيبون ٺاهڻ/جنريٽر ڪرڻ يا موجوده ايس کي ٻيهر جنريٽر ڪرڻ لاءِ ZAP جي حوالي سان ماحولياتي متغير مقرر ڪريو.ampتبديلين کي لاڳو ڪرڻ کان پوءِ ZAP ترتيبون. ZAP_DEVELOPMENT_PATH کي ذريعو کان ZAP تي سيٽ ڪريو تازو ڪڍڻ سان يا ZAP_INSTALLATION_PATH کي ZAP ايگزيڪيوٽو تي سيٽ ڪريو جيڪو توهان پنهنجي مقامي ڊاريڪٽري ۾ آخري ڊائون لوڊ ڪيو هو. نوٽ ڪريو ته جڏهن ZAP_DEVELOPMENT_PATH ۽ ZAP_INSTALLATION_PATH ٻئي سيٽ ٿيل آهن، ZAP_DEVELOPMENT_PATH استعمال ڪيو ويندو آهي.
هيٺيون آهن exampاهي جيڪي استعمال ۾ مٿي ڏنل ماحولياتي متغير ڏيکارين ٿا:
ميٽر جي وضاحت استعمال ڪندي ZAP لانچ ڪرڻ سڀني ايس کي ٻيهر پيدا ڪرڻampميٽر ايپليڪيشنن لاءِ ZAP ترتيبون
نوٽ: جڏهن ZAP ايگزيڪيوٽوبل استعمال ڪري رهيا آهيو، پڪ ڪريو ته توهان وڌيڪ استحڪام لاءِ رات جي رليز تي سرڪاري رليز استعمال ڪري رهيا آهيو. ڏسو
ZAP انسٽاليشن گائيڊ ۾ ZAP ايگزيڪيوٽيبل ڊائون لوڊ ڪرڻ

33/35

زگبي ۽ مادي جي وچ ۾ هم وقت ساز ملٽي پروٽوڪول
زگبي ۽ مادي جي وچ ۾ هم وقت ساز ملٽي پروٽوڪول
زگبي ۽ جي وچ ۾ MCoanttceurrrent ملٽي پروٽوڪول
ZAP کي Zigbee ۽ Matter لاءِ ملٽي پروٽوڪول ايپليڪيشن ۾ ZCL (Zigbee) ۽ ڊيٽا-ماڊل (Matter) ترتيبن کي ترتيب ڏيڻ لاءِ استعمال ڪري سگهجي ٿو. ZAP توهان کي Zigbee ۽ Matter لاءِ ساڳئي ترتيب ۾ واضح طور تي اينڊ پوائنٽ ٺاهڻ جي اجازت ڏئي ٿو. file. جيڪڏهن زگبي ۽ ميٽر اينڊ پوائنٽس ساڳئي اينڊ پوائنٽ آئيڊينٽيفائر تي آهن (مثال طورample، اينڊ پوائنٽ آئي ڊي 1 تي LO ڊمبل لائيٽ ۽ اينڊ پوائنٽ 1 جي ٻئي مثال تي ميٽر ڊمبل لائيٽ)، ZAP ميٽر ۽ زگبي خاصيتن ۾ عام خاصيتن کي هم وقت سازي ڪرڻ جو خيال رکي ٿو. پڪ ڪريو ته هم وقت سازي ڪيل خاصيتون ساڳيو ڊيٽا قسم جون آهن. زگبي ۽ ميٽر جي وچ ۾ عام خاصيتون هڪ ذريعي قائم ڪيون ويون آهن file جنهن کي multi-protocol.json سڏيو ويندو آهي. استعمال ڪندڙ Zigbee ۽ Matter ۾ ڪنهن به ٻن ڪلسٽرن کي انهن جي لاڳاپيل خاصيتن سان گڏ ڪلسٽر ۽ ايٽريبيوٽ ڪوڊ استعمال ڪندي ڳنڍي سگهي ٿو. هي file [SDKPath]/app/zcl/multi-protocol.json ۾ ملي سگهي ٿو. هي file شروع ڪرڻ لاءِ ڪلسٽرن ۽ خاصيتن جي هڪ خاص سيٽ سان اپڊيٽ ڪيو ويو آهي، پر استعمال ڪندڙ هن کي اپڊيٽ ڪري سگهي ٿو file جيئن ضرورت هجي ۽ ZAP عام اينڊ پوائنٽ سڃاڻپ ڪندڙن لاءِ Zigbee ۽ Matter ۾ خاصيت جي ترتيب کي هم وقت سازي جو خيال رکندو.
توهان ڪنهن به Zigbee ۽ Matter ملٽي پروٽوڪول ايپليڪيشن ۾ سبق واري صفحي هيٺ ZAP ٽيوٽوريل پڻ ڳولي سگهو ٿا. هي سبق توهان کي ملٽي پروٽوڪول ايپليڪيشن ٺاهڻ جي عمل ۾ رهنمائي ڪندو. هي سبق صرف تڏهن موجود آهي جڏهن توهان هڪ موجوده ملٽي پروٽوڪول ايپليڪيشن کوليو ٿا ۽ هيٺ ڏنل تصوير ۾ ڏيکاريل طريقي سان ڳولي سگهجي ٿو:

34/35

SLC CLI کي ZAP سان ضم ڪريو
SLC CLI کي ZAP سان ضم ڪريو
SLC CLI کي ZAP سان ضم ڪريو
SLC CLI کي ZAP سان ضم ڪرڻ لاءِ انهن قدمن تي عمل ڪريو: ò Simplicity Studio 5 يوزر گائيڊ ۾ انسٽاليشن جي هدايتن تي عمل ڪندي SLC CLI انسٽال ڪريو. ó ZAP انسٽاليشن گائيڊ ۾ هدايتن تي عمل ڪندي ZAP انسٽال ڪريو. ô SLC CLI کي ZAP سان ضم ڪرڻ لاءِ، هڪ ماحولياتي متغير STUDIO_ADAPTER_PACK_PATH شامل ڪريو جيڪو ZAP ايپليڪيشن ڏانهن اشارو ڪري ٿو.
ڊاريڪٽري. õ قدم 3 کان پوءِ SLC CLI ڊيمون کي ٻيهر شروع ڪرڻ ياد رکو. ö ڪو به منصوبو جيڪو ZAP استعمال ڪري ٿو هاڻي SLC CLI مان پيدا ٿيڻ تي قدم 3 ۾ بيان ڪيل رستو استعمال ڪندو. مهرباني ڪري SLC CLI جو حوالو ڏيو.
توهان جي منصوبن لاءِ SLC CLI استعمال ڪرڻ جي هدايتن لاءِ استعمال.

35/35

دستاويز / وسيلا

سلڪون ليبز سلڪون ليبز سان گڏ زيپ ٺاهي رهيو آهي [pdf] مالڪ جو دستور
سلڪون ليبز سان گڏ ZAP ترقي ڪري رهيو آهي، ZAP، سلڪون ليبز سان گڏ ترقي ڪري رهيو آهي، سلڪون ليبز، ليبز

حوالو

استعمال ڪندڙ دستي

سلڪون ليبز سان گڏ ZAP جي ترقي

وضاحتون

پيداوار جي استعمال جون هدايتون

FAQs

سلڪون ليبز ZAP سان ترقي ڪندي

ZAP شروع ڪرڻ

ZAP جي انسٽاليشن

ZAP جا بنيادي اصول

ڪسٽم ايڪس ايم ايل

ڪسٽم ايڪس ايم ايل Tags زگبي لاءِ

هر اينڊ پوائنٽ تي ڪيترائي ڊوائيس قسم

رسائي ڪنٽرول

ميٽر يا زگبي لاءِ ڪوڊ ٺاهڻ

اسٽوڊيو ۾ ZAP اپڊيٽ ڪريو

دستاويز / وسيلا

حوالو

تبصرو ڇڏي ڏيو

رد ڪريو جواب