ZAP Inakuza na Mwongozo wa Mmiliki wa Maabara ya Silicon

ZAP Kuanza
- Ili kuanza kutumia ZAP, fuata hatua hizi:
  - Pakua ZAP Inayotekelezeka kutoka kwa hazina rasmi.
  - Sakinisha utegemezi kwa kutumia npm install amri.
  - Kwa usakinishaji mahususi wa Windows, rejelea Usakinishaji wa ZAP kwa mwongozo wa Mfumo wa Uendeshaji wa Windows.
Maendeleo ya Zigbee
- Ikiwa unatengeneza programu za Zigbee:
  - Tumia Studio ya Urahisi inayojumuisha ZAP na zana zingine muhimu.

Maendeleo ya Jambo
- Ikiwa unatengeneza programu za Matter:
  - Chaguo ni pamoja na kutumia Studio ya Urahisi au kufikia Maabara ya Silicon au hazina za CSA Github.
  - Rejelea maagizo ya usasishaji wa ZAP nje ya mzunguko wa uchapishaji wa Studio ya Urahisi ikihitajika.

Maswali Yanayoulizwa Mara kwa Mara

Swali: Je, ni matoleo gani tofauti ya jozi za ZAP zinazopatikana?
- A: Kuna matoleo mawili yanayopatikana - Toleo rasmi lenye miundo iliyothibitishwa na toleo la awali lenye vipengele vipya zaidi.

Swali: Nifanye nini ikiwa nitakutana na shida za ujumuishaji wa maktaba ya asili wakati wa usakinishaji?
- A: Rejelea maelezo ya Maswali Yanayoulizwa Mara kwa Mara kuhusu hati mahususi za jukwaa ili kutatua masuala kama haya.

View Fullscreen

Maabara ya Silicon ZAP
Maabara ya Silicon ZAP

Kuendeleza na Silicon Labs ZAP

Kuanza
ZAP Kuanza upyaview Ufungaji wa ZAP Maswali Yanayoulizwa Mara kwa Mara ya Ufungaji wa ZAP
Misingi Misingi ya ZAP
Mwongozo wa Mtumiaji ZAP Mwongozo wa Mtumiaji Zaidiview XML Maalum ya XML Tags kwa Zigbee Aina za Vifaa Vingi kwa Kila Aina ya Kifaa Aina ya Kipengele cha Arifa za Ukurasa wa Data-Model/ZCL Uainishaji Udhibiti wa Upataji wa Ufikiaji Inazindua ZAP kwa programu za Matter au Zigbee Kuzalisha msimbo wa Matter au Zigbee Sasisha ZAP katika Studio Itifaki nyingi Sambamba kati ya Zigbee na Matter Integrate SLC CLI na ZAPLC.

1/35

Kuendeleza na Silicon Labs ZAP
Kuendeleza na Silicon Labs ZAP
ZAP
ZAP ni injini ya kuzalisha msimbo wa jumla na kiolesura cha mtumiaji kwa programu na maktaba kulingana na Maktaba ya Nguzo ya Zigbee kutoka Zigbee au Modeli ya Data kutoka Matter. Vipimo vinatengenezwa na Muungano wa Viwango vya Kuunganishwa. ZAP hukuruhusu kufanya shughuli zifuatazo:
Tekeleza uundaji maalum wa SDK wa vizalia vya programu vyote vya kimataifa (mara kwa mara, aina, vitambulisho, na kadhalika) kulingana na vipimo vya ZCL/Data-Model. Tekeleza kizazi mahususi cha SDK cha vizalia vyote vya usanidi vilivyochaguliwa na mtumiaji (usanidi wa programu, usanidi wa sehemu ya mwisho, na kadhalika) kulingana na vipimo vya ZCL/Data-Model na usanidi wa programu unaotolewa na mteja. Toa UI kwa mtumiaji wa mwisho kuchagua usanidi maalum wa programu (vituo vya mwisho, vikundi, sifa, amri, na kadhalika).

Maudhui katika sehemu hizi yanaeleza jinsi ya kutengeneza programu za Zigbee na Matter kwa kusanidi Tabaka za ZCL (Zigbee) au Data Model (Matter) kwa kutumia ZAP.

2/35

ZAP Kuanza

ZAP Kuanza
Kuanza na ZAP
Sehemu hizi zinaelezea mbinu tofauti za kuunda programu za Zigbee na Matter. Kumbuka kuwa Studio ya Urahisi hutoa njia ya kuunda programu zako za Zigbee na Matter kutoka mwisho hadi mwisho ambapo zana zote husakinishwa mapema pamoja na Siplicity Studio (pamoja na ZAP). Unaweza pia kuamua kuchunguza njia zingine za kuunda programu zako, kama ilivyoelezwa hapa.
Maendeleo ya Zigbee
Wasanidi programu wa Zigbee wanaweza kuunda programu zao kwa kutumia Siplicity Studio, ambayo tayari inajumuisha ZAP na zana zingine zinazokusaidia kuunda programu yako kutoka mwisho hadi mwisho.
Maendeleo ya Jambo
Wasanidi Programu wa Matter wanaweza kuunda programu zao kwa kutumia mbinu zifuatazo: Studio ya Urahisi: Hii inajumuisha ZAP na zana zingine ambazo zinahitajika ili kuunda mwisho wa programu ya Matter. Github (Silicon Labs) Github (CSA)
Kumbuka: Ili kusasisha ZAP nje ya mzunguko wa uchapishaji wa Studio ya Urahisi, angalia sasisho la ZAP katika Studio ya Urahisi na Mwongozo wa Usakinishaji wa ZAP.

3/35

Ufungaji wa ZAP

Sehemu zifuatazo zinaelezea usakinishaji wa ZAP na jinsi ya kusasisha ZAP katika IDE ya Studio ya Urahisi.
Kupakua ZAP Inayotekelezeka Inapendekezwa)
Hii ndiyo njia inayopendekezwa ya kuanza kutumia ZAP. Unaweza kupata jozi za hivi punde za ZAP kutoka aa https://github.com/project-chip/zp/releses. Binari zilizojengwa mapema huja katika matoleo mawili tofauti.
Toleo rasmi: Miundo iliyothibitishwa yenye vyumba maalum vya majaribio vya Matter na Zigbee. Umbizo la jina la toleo ni vYYYY.DD.MM. Toleo la awali: Miundo iliyo na vipengele vya hivi punde na kurekebishwa kwa hitilafu lakini miundo hii HAIJAthibitishwa na vyumba maalum vya majaribio vya Matter na Zigbee. Umbizo la jina la toleo ni vYYYY.DD.MM-usiku.
Kufunga ZAP kutoka Chanzo
Maagizo ya msingi ya Kufunga ZAP
Kwa sababu hii ni programu ya node.js, unahitaji mazingira ya nodi kusakinishwa. Njia bora ya kufanya hivyo ni kupakua usakinishaji wa hivi karibuni wa nodi, ambayo ni pamoja na nodi na npm. Ikiwa una toleo la zamani la nodi iliyosakinishwa kwenye kituo chako cha kazi, inaweza kusababisha masuala, haswa ikiwa ni ya zamani sana. Hakikisha una toleo jipya zaidi la nodi v16.x na npm ambayo imejumuishwa. Endesha nodi -version ili kuangalia ni toleo gani limechukuliwa. v18.x inapendekezwa. Baada ya kuwa na toleo unalotaka la nodi, unaweza kuendesha yafuatayo:
Sakinisha Vitegemezi
Tumia amri zifuatazo kusanikisha utegemezi:

npm kufunga
Kumbuka: Kwa usakinishaji wa ZAP wa Windows mahususi, angalia Usakinishaji wa ZAP kwa Mfumo wa Uendeshaji wa Windows Si kawaida kupata matatizo ya utungaji wa maktaba asilia katika hatua hii. Kuna hati mbalimbali za src-script/install-* za majukwaa tofauti. Tazama maelezo ya Maswali Yanayoulizwa Mara kwa Mara kuhusu hati ya kuendeshwa kwenye mifumo tofauti kisha ufanye upya npm install .
Anzisha Maombi
Tumia amri zifuatazo ili kuanzisha programu:

npm kukimbia zap
Anzisha Mwisho-Mbele katika Hali ya Maendeleo
Inaauni upakiaji upya wa nambari-moto, kuripoti makosa, na kadhalika. Tumia amri zifuatazo ili kuanza mwisho wa mbele katika ukuzaji
hali:
quasar dev -m elektroni
or

4/35

ZAP Insta katika oll in
npm endesha elektroni-dev

5/35

Ufungaji wa Windows ZAP
Ufungaji wa Windows ZAP
Ufungaji wa ZAP kwa Windows OS
1. Windows Powershell
Kwenye upau wa utaftaji wa eneo-kazi, ingiza Windows Powershell na uendeshe kama msimamizi. Endesha amri zote zifuatazo ndani ya Powershell.
2. Chokoleti
Sakinisha kutoka https://chocolatey.org/install. Angalia ikiwa imewekwa vizuri na amri zifuatazo:
choko -v
Sakinisha pkgconfiglite kifurushi na amri zifuatazo:
choco kufunga pkgconfiglite
3. Weka Node
Endesha amri zifuatazo ili kusakinisha:
choco install nodejs-lts
*Toleo lazima liwe 18 ili kupitisha jaribio la kukagua toleo, baada ya kusakinisha, angalia na nodi -v *Ikiwa umesakinisha Node tayari, na ushindwe majaribio kadhaa sawa na hayawezi kupata Node , sakinisha tena Node na chocolatey tena.
4. Fuata Maagizo ya Msingi ya Kufunga ZAP
Fuata maagizo ya usakinishaji wa ZAP kutoka chanzo katika Usakinishaji wa ZAP. Wakati wa kufuata maagizo ya kimsingi ya kusakinisha ZAP, angalia makosa yafuatayo na jinsi ya kuyasuluhisha:
sqlite3
Unapoendesha ZAP (kwa mfano, npm run zap ), ukiona hitilafu kuhusu sqlite3.node kwenye dirisha ibukizi, endesha:
npm jenga tena sqlite3
mjenzi wa elektroni
Wakati wa kufanya npm install, baada ya kusakinisha, ikiwa hitilafu hutokea kwenye amri ifuatayo inayohusiana na elektroni-builder install-appdeps , npx electron-rebuild canvas imeshindwa au node-pre-gyp , toleo la sasa la turuba haliendani na Windows na hitilafu ya ufungaji haitasababisha kushindwa katika kuendesha ZAP. node-canvas inafanya kazi kwenye suluhisho sasa na suala litatatuliwa katika siku za usoni.
"postinstall": "install-programu-deps ya kijenzi-elektroniki && sakinisha husky && npm jenga upya turubai -sasisha-binary && npm endesha toleo-stamp”

6/35

Ufungaji wa Windows ZAP
Turubai
Ikiwa npm run test itashindwa kwa sababu ya hitilafu Kitengo cha majaribio kimeshindwa kufanya kazi. Haiwezi kupata moduli '../build/Release/canvas.node' au
zapnode_modulescanvasbuildReleasecanvas.node si programu halali ya Win32. , tengeneza turubai kama ifuatavyo:
npm jenga upya turubai -sasisha-binary
pata index.html au Masuala Mengine ya Seva
Ikiwa npm run test itashindwa kwa sababu ya kosa pata index.html ombi limeshindwa na nambari ya hali 404 kwenye vipimo vya kitengo au kuwa na seva.
maswala ya unganisho katika majaribio ya e2e-ci, endesha amri zifuatazo:
npm kukimbia kujenga
Nyingine
Angalia ikiwa toleo la nodi ni v18 na ujaribu kuisanikisha na Chocolatey.

7/35

Maswali Yanayoulizwa Mara kwa Mara
Maswali Yanayoulizwa Mara kwa Mara
Maswali Yanayoulizwa Mara Kwa Mara
Swali: Jinsi ya kuanzisha UI katika hali ya ukuzaji? J: Unaweza kuanzisha UI katika hali ya ukuzaji, ambayo itasababisha usanidi ufuatao:
Seva tofauti ya HTTP ya ukuzaji wa quasar, ambayo huonyesha upya moja kwa moja kwenye bandari 8080 ZAP inayoendesha mwisho wa bandari 9070 Chrome au kivinjari kingine, inafanya kazi kwa kujitegemea Ili kupata usanidi huo, fuata maagizo yaliyo hapa chini. ò Kwanza, endesha seva ya ukuzaji ya ZAP, ambayo huanza kwenye bandari 9070.
npm endesha zap-devserver ó Ifuatayo, endesha seva ya ukuzaji ya quasar, ambayo huanza kwenye bandari 8080.
quasar dev ô Elekeza kivinjari chako au endesha moja dhidi ya sahihi URL na hoja ya restPort:
google-chrome http://localhost:8080/?restPort=9070

Swali: Jinsi ya kufanya kazi hii kwenye Mac/Linux OS? A:
npm install inatumika kupakua vifurushi vyote vya utegemezi vinavyohitajika. Ukiona hitilafu zinazohusiana na node-gyp na kukosa maktaba za ndani, kama vile pixman , na kadhalika, unakosa utegemezi asilia wa kutosheleza kuunda jozi za nodi ambazo hazijajengwa mapema kwa mchanganyiko fulani wa majukwaa na matoleo. Npm kwenye wingu inasasisha kila mara orodha ya jozi zilizotolewa, kwa hivyo inawezekana kwamba utazichukua vizuri, lakini usipofanya hivyo, haya ni maagizo ya majukwaa tofauti:
Fedora Core na dnf :
dnf sakinisha pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
au endesha hati:
src-script/install-packages-fedora
Ubuntu na apt-get :
apt-get update apt-get install -fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
au endesha hati:

8/35

Maswali Yanayoulizwa Mara kwa Mara
src-script/install-packages-ubuntu
OSX kwenye Mac iliyo na Homebrew brew :
brew install pkg-config cairo pango libpng jpeg giflib librsvg
au endesha hati:
src-script/install-packages-osx
Swali: Jinsi ya kufanya kazi hii kwenye Windows OS?
Jibu: Hakikisha kuwa imesasishwa kila wakati na hakuna mabadiliko ambayo hayajafanywa. Kidokezo: git pull, git status & git stash ni marafiki zako. Ni lazima utumie Chocolately kufanya Zap ifanye kazi kwenye Windows OS. Hakikisha kupakua kifurushi cha pkgconfiglite.
choco kufunga pkgconfiglite
Ikiwa una matatizo na cairo, kwa mfanoample ukipata hitilafu kuhusu cairo.h': Hapana file au saraka, fanya yafuatayo: ò Angalia kama kompyuta yako ni 32 au 64 bit. ó Kutegemeana na hilo, pakua kifurushi kinachofaa kutoka kwa tovuti hii
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:
Bofya kwenye Mipangilio ya Mfumo wa Juu. Kwenye kichupo cha hali ya juu, bonyeza kwenye Vigezo vya Mazingira. Katika sehemu ya Vigezo vya Mfumo, pata mabadiliko ya mazingira ya PATH na uchague. Bofya Hariri na uongeze C:/GTK kwake. Ikiwa mabadiliko ya mazingira ya PATH haipo, bofya Mpya. Ikiwa jpeglib.h haipatikani, jaribu yafuatayo: ò Kwenye terminal, endesha: choco install libjpeg-turbo ó Hakikisha ni safi kwa kutumia: git clean -dxff na endesha npm install tena ô ikiwa hakuna makosa kutokea na onyo pekee linaonekana, jaribu kutumia npm audit fix õ kama huwezi kuendesha ZAP, nenda kwa file src-script/zap-start.js ö Badilisha
÷ const { spawn } = require('cross-spawn') to const { spawn } = require('child_process') ø Endesha npm na endesha zap. Marejeleo:
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)
Swali: Ninapata hitilafu "sqlite3_node" haijapatikana au sawa.

9/35

Maswali Yanayoulizwa Mara kwa Mara
J: Jenga upya vifungashio vyako vya asili vya sqlite3. Ili kurekebisha hii katika hali nyingi, endesha:
npm kufunga
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Ikiwa bado haijarekebishwa, fanya:
rm -rf node_modules kisha ujaribu amri zilizo hapo juu tena. Wakati mwingine kusasisha npm yako pia hufanya tofauti:
npm kufunga -g npm
Swali: Ninapata hitilafu "Toleo la N-API la mfano huu wa Nodi ni 1. Sehemu hii inaauni toleo la 3 la N-API. Mfano huu wa Nodi hauwezi kutekeleza moduli hii."
A: Boresha toleo lako la nodi. Suluhisho la hili linajadiliwa katika uzi huu wa kufurika kwa Stack: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Swali: Kompyuta yangu ya ukuzaji haifanyi kazi na ZAP kwa sababu yoyote ile. Je, ninaweza kutumia chombo cha docker?
A: Ndiyo unaweza. TBD.
Swali: Je, ninaendeshaje ZAP ndani ya VSCode?
J: Ikiwa una VSCode kwenye njia yako ingiza zap repo na chapa msimbo . Hii itafungua ZAP katika VSCode. Ili kuendesha ZAP katika hali ya utatuzi, chagua nafasi ya kazi ya ZAP na ubofye ikoni ya Endesha kwenye upau wa vidhibiti wa mkono wa kushoto. Utakuwa na chaguzi kadhaa za kuchagua ili kuendesha ZAP, chagua Node.js Debug Terminal . Hii itafungua dirisha la terminal ambalo unaweza kuingiza npm run zap , ambalo litaambatisha kitatuzi na kuendesha ZAP kama kawaida kutoka kwa safu ya amri. Hongera, unapaswa kuona sasa ZAP inaendesha utatuzi. Unaweza kuweka sehemu za mapumziko katika VSCode kama ungefanya katika IDE nyingine yoyote.
Swali: Mtihani wa kitengo cha UI haufaulu na makosa kadhaa karibu na turubai ambayo haijaundwa kwa toleo sahihi la nodi. nifanye nini?
J: Ukiona hitilafu ifuatayo:
FAIL test/ui.test.js Kitengo cha majaribio kimeshindwa kufanya kazi Moduli ya 'canvas.node' iliundwa dhidi ya toleo tofauti la Node.js kwa kutumia NODE_MODULE_VERSION 80. Toleo hili la Node.js linahitaji NODE_MODULE_VERSION 72. Tafadhali jaribu kukusanya tena au kusakinisha tena moduli (kwa mfano, kwa mfano, sakinisha tena).`
kwenye Object. (nodi_modules/canvas/lib/bindings.js:3 18)
kisha endesha: npm jenga upya turubai -sasisha-binary

10/35

Misingi ya ZAP

Misingi ya ZAP ya ZCL/Data-Model
Sehemu hii ina taarifa kwa watumiaji wapya wa ZAP. Bofya kwenye ikoni ya mafunzo kwenye kona ya juu kulia ya UI ya ZAP, ambayo inaonyesha jinsi ya kuunda usanidi wa ZAP. Mafunzo yatakuongoza kupitia yafuatayo: Unda ncha Teua aina ya kifaa Sanidi kundi Sanidi sifa Sanidi amri Kwa marejeleo ya kina, ona Mwongozo wa Usanidi wa Nguzo ya Zigbee.

11/35

Mwongozo wa Mtumiaji wa ZAP
Mwongozo wa Mtumiaji wa ZAP
Mwongozo wa Mtumiaji wa ZAP
Sehemu zilizo chini ya mwongozo huu zinatoa maelezo zaidi kuhusu vipengele tofauti vilivyotolewa na ZAP.

12/35

XML maalum

Inaongeza XML Maalum kutoka kwa UI ya ZAP
Bofya kwenye ikoni ya "Viendelezi" katika UI ya ZAP. Bofya kitufe cha kuongeza "+" ili kuchagua xml maalum file Nguzo maalum, sifa, amri, n.k zinapaswa kuonekana kwenye ZAP UI mara tu xml maalum imeongezwa.
Kuunda XML yako maalum katika Zigbee
Sehemu inaonyesha jinsi ya kuunda makundi yako maalum na kupanua makundi ya kawaida yaliyopo na sifa maalum na amri za Zigbee.
Makundi Maalum ya Watengenezaji katika Zigbee
Unaweza kuongeza makundi mahususi ya mtengenezaji kwa mtaalamu wa kawaidafile. Tunatoa examphii hapa chini. Ili kufanya hivyo, lazima utimize majukumu mawili:
Kitambulisho cha nguzo LAZIMA kiwe katika safu mahususi ya mtengenezaji, 0xfc00 - 0xffff. Ufafanuzi wa nguzo lazima ujumuishe msimbo wa mtengenezaji ambao utatumika kwa sifa na amri ZOTE ndani ya nguzo hiyo na lazima itolewe wakati wa kutuma na kupokea amri na kuingiliana na sifa. Kwa mfanoample:

Sample Nguzo Maalum ya Mfg Mkuu Kundi hili hutoa example ya jinsi Mfumo wa Maombi unavyoweza kupanuliwa ili kujumuisha makundi mahususi ya mtengenezaji.
0xFC00
makaa sampsifa
makaa sampsifa 2

A sampamri maalum ya mtengenezaji ndani ya sample mtengenezaji mahususi
nguzo.

Amri Maalum za Mtengenezaji katika Kundi la Kawaida la Zigbee
Unaweza kuongeza amri zako mwenyewe kwa nguzo yoyote ya kawaida ya Zigbee yenye mahitaji yafuatayo:
Amri zako mahususi za mtengenezaji zinaweza kutumia kitambulisho chochote cha amri ndani ya safu ya kitambulisho cha amri, 0x00 - 0xff. Lazima pia utoe msimbo wa mtengenezaji kwa amri ili iweze kutofautishwa kutoka kwa amri zingine kwenye nguzo na kushughulikiwa ipasavyo. Kwa mfanoample ya kupanua nguzo ya Washa/Zima kwa amri za utengenezaji:

13/35

XML maalum
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja ambayo huzima kifaa kwa mpito uliotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificOnWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja inayowasha kifaa kwa mpito uliotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificToggleWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja ambayo hugeuza kifaa kwa mpito unaotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificOnWithTransition2″ optional=”true” manufacturerCode="0 1049″> Amri ya mteja inayowasha kifaa kwa mpito uliotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificToggleWithTransition2″ hiari=”kweli”
mtengenezajiCode=”0 1049″> Amri ya mteja ambayo hugeuza kifaa kwa mpito unaotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.

Sifa Maalum za Mtengenezaji katika Kundi la Kawaida la Zigbee
Unaweza kuongeza sifa zako kwa nguzo yoyote ya kawaida ya Zigbee yenye mahitaji yafuatayo:
Sifa zako mahususi za mtengenezaji zinaweza kutumia kitambulisho chochote cha sifa ndani ya safu ya kitambulisho cha sifa, 0x0000 - 0xffff. Ni lazima pia utoe msimbo wa mtengenezaji wa sifa ili iweze kutofautishwa na sifa nyingine katika kundi na kushughulikiwa ipasavyo. Kwa mfanoample ya kupanua nguzo ya Washa/Zima yenye sifa za utengenezaji:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min="0 0000″
max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Sifa Maalum: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1049″>Sample Mfg Sifa Maalum: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 00″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Sifa Maalum: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1049″>Sample Mfg Sifa Maalum: 0 0001 0 1040
Kuunda XML yako maalum katika Matter
Sehemu inaonyesha jinsi ya kuunda makundi yako maalum na kupanua makundi ya kawaida yaliyopo na sifa maalum na amri za Matter.
Nguzo Maalum za Mtengenezaji katika Matoleo
Unaweza kuongeza makundi maalum ya mtengenezaji kwenye Matter. Tunatoa examphii hapa chini.
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

XML maalum
Katika ex ifuatayoample, mseto wa kitambulisho cha mchuuzi (Kitambulisho cha Mtengenezaji wa Jaribio) cha 0xFFF1 na Kitambulisho cha nguzo cha 0xFC20 husababisha value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Mkuu Sampna MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Jumba la SampNguzo ya le MEI inaonyesha viendelezi vya watengenezaji wa nguzo FlipFlop
Majibu ya AddArguments ambayo yanarudisha jumla. Amri ambayo inachukua hoja mbili za uint8 na kurudisha jumla yao. Amri rahisi bila vigezo vyovyote na bila jibu.
Sifa Maalum za Mtengenezaji katika Nguzo za Kawaida za Matter
Unaweza kuongeza sifa mahususi za mtengenezaji kwa nguzo yoyote ya kawaida ya Matter yenye mahitaji yafuatayo:
Ili kujumuisha sifa zinazoongezwa lazima zibainishwe -
e xte nd ed > ">
Msimbo wa sifa ni mchanganyiko wa 32-bit wa msimbo wa mtengenezaji na kitambulisho cha sifa. Biti 16 muhimu zaidi ni nambari ya mtengenezaji. Masafa ya misimbo ya watengenezaji wa majaribio ni 0xFFF1 - 0xFFF4. Biti 16 zenye umuhimu mdogo zaidi ni kitambulisho cha sifa. Upeo wa sifa zisizo za kimataifa ni 0x0000 - 0x4FFF.
Example ya kupanua nguzo ya On/Off Matter yenye sifa mahususi za utengenezaji:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min="0 0000″
max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true”>Sample Mfg Sifa Maalum 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min="0 0000″
max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true”>Sample Mfg Sifa Maalum 4
Amri Maalum za Mtengenezaji katika Nguzo za Kawaida za Matter
Unaweza kuongeza amri maalum za mtengenezaji kwa nguzo yoyote ya kawaida ya Matter yenye mahitaji yafuatayo:
Kwa aaaa yeye nguzo ambayo amri inaongezwa lazima ibainishwe -
e xte nd ed > ">
Nambari ya amri ni mchanganyiko wa 32-bit wa msimbo wa mtengenezaji na kitambulisho cha amri. Biti 16 muhimu zaidi ni nambari ya mtengenezaji. Masafa ya misimbo ya watengenezaji wa majaribio ni 0xFFF1 - 0xFFF4. Biti 16 muhimu zaidi ni kitambulisho cha amri. Masafa ya amri zisizo za kimataifa ni 0x0000 - 0x00FF.
Example ya kupanua nguzo ya On/Off Matter yenye nguzo mahususi za utengenezaji:

15/35

XML maalum

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ hiari=”true”> Amri ya mteja inayowasha kifaa kwa mpito uliotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ optional=”true”>
Amri ya mteja ambayo hugeuza kifaa kwa mpito unaotolewa na muda wa mpito katika Ember Sampsifa ya wakati wa mpito.

16/35

XML maalum Tags kwa Zigbee

Hati ifuatayo inazungumza juu ya kila xml tags kuhusishwa na Zigbee.
Kila xml file imeorodheshwa kati ya kisanidi tags:

Aina za data zinaweza kufafanuliwa ndani ya kisanidi tag. Zigbee kwa sasa inasaidia ufafanuzi wa bitmaps, enums, integers, strings au structs. Kabla ya kufafanua aina zaidi hakikisha kuwa umeangalia aina zote zilizopo za atomiki zilizofafanuliwa katika type.xml na aina zote zisizo za atomiki zilizobainishwa katika xml nyingine. files. Unaweza kuzifafanua kama ifuatavyo:
Bitmap: jina: jina la aina ya bitmap. aina: Bitmap yenye ukubwa kati ya biti 8-64 inaweza kufafanuliwa, zote zinapaswa kuwa nyingi za 8. Kila bitmap inaweza kuwa na sehemu nyingi zenye jina na kinyago kinachohusishwa nayo. kwa mfano:

"`
Enum: jina: jina la aina ya enum. aina: Enum yenye ukubwa kati ya biti 8-64 inaweza kufafanuliwa, zote zinapaswa kuwa nyingi za 8. Kila enum inaweza kuwa na vitu vingi vilivyo na jina na thamani inayohusishwa nayo. kwa mfano:

Nambari kamili: Aina kamili tayari zimefafanuliwa chini ya aina za atomiki ambazo zipo katika type.xml. Ukubwa wao unaweza kuanzia biti 8-64 na unaweza kusainiwa au kutotiwa saini. kwa mfano:

Kamba: Aina za kamba tayari zimefafanuliwa chini ya aina za atomiki ambazo zipo katika type.xml. Aina za kamba za sasa ni pamoja na uzi wa pweza, uzi wa char, uzi wa pweza na uzi mrefu wa char mfano:

Muundo: jina: jina la aina ya muundo. Kila muundo unaweza kuwa na vitu vingi vilivyo na jina na aina inayohusishwa nayo. Aina inaweza kuwa aina yoyote iliyofafanuliwa awali chini ya aina za data. kwa mfano:

17/35

XML maalum Tags kwa Zigbee

<item name=”structItem1″ type=” Any defined type name in the xml files]”/>

Makundi Maalum yanaweza kuelezwa ndani ya kisanidi tag. jina: jina la kikoa cha nguzo: kikoa cha nguzo. Kundi hili litaonekana katika UI ya ZAP chini ya kikoa hiki. maelezo: Ufafanuzi wa msimbo wa nguzo: msimbo wa nguzo fafanua: nguzo fafanua ambayo hutumiwa na jenereta ya msimbo kufafanua nguzo kwa njia fulani mtengenezajiMsimbo: Inatumika kufafanua nguzo maalum ya utengenezaji. Hii lazima iwe kati ya 0xfc00 - 0xffff. Nambari ya mtengenezaji kwa nguzo inahitaji kufafanuliwa kama ifuatavyo:

Kundi la utengenezaji hutengeneza sifa na amri chini yake za msimbo sawa wa mtengenezaji isipokuwa ziorodheshe kwa uwazi msimbo wa mtengenezaji. ilianzisha: Inatumika kuamua toleo maalum ambalo nguzo ilianzishwa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. removedIn: Inatumika kubainisha toleo maalum ambalo nguzo iliondolewa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. singleton(boolean): Hutumika kubainisha nguzo kama singleton hivi kwamba kuna mfano mmoja tu wa nguzo hiyo iliyoshirikiwa kote kwenye miisho. sifa: inafafanua sifa ya jina la nguzo: Jina la sifa limetajwa kati ya sifa. tag.
jina la sifa
side(mteja/seva): Upande wa nguzo ambayo sifa inahusishwa pia. msimbo: msimbo wa mtengenezaji wa msimbo wa sifa: Hii inaweza kutumika kufafanua sifa mahususi ya mtengenezaji nje ya vipimo vya zigbee vilivyotajwa na xml ya kawaida. define: attribute define ambayo hutumiwa na jenereta ya msimbo kufafanua sifa kwa namna fulani: aina ya sifa ambayo inaweza kuwa aina yoyote ya data iliyotajwa katika chaguo-msingi ya xml: thamani chaguo-msingi ya sifa. dakika: Thamani ya chini inayoruhusiwa kwa upeo wa sifa: Thamani ya juu inayoruhusiwa kwa sifa inayoweza kuandikwa: Je, thamani ya sifa inaweza kuandikwa au la. Hii inaweza kutumika kuzuia sifa kurekebishwa na amri za uandishi. hiari(boolean): Inatumika kubainisha kama sifa ni ya hiari au la kwa nguzo. min: Thamani ya chini inayoruhusiwa ya sifa wakati ni nambari kamili, enum au aina ya bitmap. max: Thamani ya juu inayoruhusiwa ya sifa ikiwa ni nambari kamili, enum au urefu wa aina ya bitmap: Hutumika kubainisha urefu wa juu zaidi wa sifa wakati ni wa mfuatano wa aina. minLength: Hutumika kubainisha urefu wa chini kabisa wa sifa wakati ni wa aina ya mfuatano. reportable(boolean): Hueleza kama sifa inaweza kuripotiwa au la, Haiwezekani (boolean): Huruhusu thamani batili za sifa. array(boolean): Inatumika kutangaza sifa ya aina ya safu. ilianzisha: Inatumika kuamua toleo maalum ambalo sifa ilianzishwa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. removedIn: Inatumika kubainisha toleo maalum ambalo sifa iliondolewa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. amri: fafanua amri kwa jina la nguzo: Jina la amri.

nambari: nambari ya amri

18/35

XML maalum Tags kwa Zigbee
msimbo wa mtengenezaji: Hii inaweza kutumika kufafanua amri maalum ya mtengenezaji nje ya vipimo vya zigbee vilivyotajwa na xml ya kawaida. maelezo: maelezo ya chanzo cha amri (mteja/seva): chanzo cha amri. hiari(boolean): Inatumika kubainisha kama amri ni ya hiari au la kwa nguzo. ilianzisha: Inatumika kuamua toleo maalum ambalo amri ilianzishwa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. removeIn: Inatumika kuamua toleo maalum ambalo amri iliondolewa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. amri hoja:
Kila amri inaweza kuwa na seti ya jina la hoja za amri: jina la aina ya hoja ya amri: aina ya hoja ya amri ambayo inaweza kuwa aina zozote zilizotajwa kwenye xml. min: Thamani ya chini inayoruhusiwa kwa hoja wakati ni nambari kamili, enum au aina ya bitmap. max: Thamani ya juu inayoruhusiwa kwa hoja wakati ni urefu wa aina kamili, enum au bitmap: Inatumika kubainisha urefu unaokubalika zaidi kwa hoja ya amri wakati ni ya aina ya mfuatano. minLength: Hutumika kubainisha urefu wa chini unaoruhusiwa kwa hoja ya amri wakati ni wa aina ya mfuatano. array(boolean): Kuamua ikiwa hoja ya amri ni ya aina ya safu. presentIf(string): Huu unaweza kuwa mfuatano wa masharti wa shughuli za kimantiki kulingana na hoja zingine za amri ambapo unaweza kutarajia hoja ya amri ikiwa kamba ya masharti itatathmini kuwa kweli. kwa mfano:

Kumbuka: Hapa hali ni jina lingine la hoja ya amri. optional(boolean): Inatumika kubainisha hoja ya amri kama hiari. countArg: Inatumika wakati hoja ya amri ni ya aina ya safu. Hii inatumika kutaja hoja nyingine ya amri ambayo inaashiria saizi ya safu ya hoja hii.

ilianzisha: Inatumika kuamua toleo maalum ambalo hoja ya amri ilianzishwa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. removeIn: Inatumika kuamua toleo maalum ambalo hoja ya amri iliondolewa. Hii inatumiwa na jenereta ya msimbo kuongeza mantiki ya ziada. Kiendelezi cha Nguzo kinaweza kufafanuliwa ndani ya kisanidi tag. Upanuzi wa Nguzo hutumiwa kupanua nguzo ya kawaida yenye sifa na amri za utengenezaji kwa mfano

19/35

XML maalum Tags kwa Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Sifa Maalum: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1049″>Sample Mfg Sifa Maalum: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 00″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Sifa Maalum: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1049″>Sample Mfg Sifa Maalum: 0 0001 0 1040ampleMfgSpecificOffWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja ambayo huzima kifaa kwa mpito uliotolewa
kwa wakati wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificOnWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja inayowasha kifaa kwa mpito uliotolewa
kwa wakati wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificToggleWithTransition” optional=”true” manufacturerCode="0 1002″> Amri ya mteja ambayo hugeuza kifaa na mpito uliotolewa
kwa wakati wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificOnWithTransition2″ optional=”true” manufacturerCode="0 1049″> Amri ya mteja inayowasha kifaa kwa mpito uliotolewa
kwa wakati wa mpito katika Ember Sampsifa ya wakati wa mpito.ampleMfgSpecificToggleWithTransition2″ optional=”true” manufacturerCode="0 1049″> Amri ya mteja ambayo hugeuza kifaa na mpito uliotolewa
kwa wakati wa mpito katika Ember Sampsifa ya wakati wa mpito.

20/35

Aina Nyingi za Vifaa Kwa Kila Mwisho

Hiki ni kipengele cha Matter-only ambapo mtumiaji anaweza kuchagua zaidi ya aina moja ya kifaa kwa kila ncha. Kuongezwa kwa aina nyingi za vifaa vya aaa kutaongeza usanidi wa nguzo ndani ya aina za kifaa kwenye usanidi wa sehemu ya mwisho.

21/35

Aina Nyingi za Vifaa Kwa Kila Mwisho

Picha iliyo hapo juu inaonyesha kuwa sehemu ya mwisho ya 1 ina zaidi ya aina moja za kifaa zilizochaguliwa. "Kifaa Cha Msingi" kinaashiria aina ya kifaa msingi ambacho sehemu ya mwisho itahusishwa nayo. Aina ya kifaa msingi huwa katika faharasa ya 0 ya orodha ya aina za vifaa vilivyochaguliwa kwa hivyo kuchagua aina tofauti ya kifaa kutabadilisha upangaji wa aina za kifaa zilizochaguliwa. Chaguo za aina ya kifaa pia zina vikwazo kulingana na Uainisho wa Muundo wa Data. ZAP hulinda watumiaji dhidi ya kuchagua michanganyiko batili ya aina za kifaa kwenye sehemu ya mwisho kwa kutumia vikwazo hivi.

22/35

Ukurasa wa Kipengele cha Aina ya Kifaa cha Matter
Ukurasa wa Kipengele cha Aina ya Kifaa cha Matter
Ukurasa wa Kipengele cha Aina ya Kifaa cha Matter
ZAP inasaidia kuibua na kugeuza vipengele vya Matter katika ukurasa wa kipengele cha aina ya kifaa. Vipengele vya aina ya kifaa pekee vilivyobainishwa katika matter-devices.xml kwenye hazina ya CHIP ndivyo vitaonyeshwa.

Kuelekeza kwenye Ukurasa wa Kipengele
ò Zindua ZAP katika Matter na SDK ya kisasa ya Matter. ó Unda sehemu ya mwisho kwa kutumia aina ya kifaa cha Matter. ô Bofya kitufe cha Vipengele vya Aina ya Kifaa kwenye sehemu ya juu ya kati ya nguzo view. Kumbuka kuwa kitufe hiki kinapatikana katika ZAP pekee
usanidi wa Matter na wakati data ya ulinganifu inapatikana katika SDK ya Matter. Kubofya kitufe hiki kutafungua picha iliyo hapo juu.
Ulinganifu
Utiifu hufafanua chaguo na utegemezi wa sifa, amri, matukio na aina za data. Huamua ikiwa kipengele ni cha lazima, cha hiari, au hakitumiki chini ya usanidi fulani wa ZAP.
Upatanifu wa kipengele cha aina ya kifaa hutanguliwa kuliko upatanishi wa vipengele vya nguzo. Kwa mfanoampHata hivyo, kipengele cha Kuangazia kina utiaji wa hiari katika kundi la Kuwasha/Kuzimwa lakini kinatangazwa kuwa ni lazima katika aina ya kifaa cha Kuwasha/Kuzima Mwanga ambacho kinajumuisha nguzo ya Kuwasha/Kuzimwa. Kuunda sehemu ya mwisho kwa kutumia aina ya kifaa cha Washa/Zima kutaonyesha kipengele cha Mwangaza kama lazima kwenye ukurasa wa kipengele.
Kugeuza Kipengele
Kwenye ukurasa wa kipengele, baada ya kubofya kitufe cha kugeuza ili kuwezesha au kuzima kipengele, ZAP itafanya:
Sasisha vipengele vinavyohusishwa (sifa, amri, matukio) ili kusahihisha upatanifu, na uonyeshe mazungumzo yanayoonyesha mabadiliko.

23/35

Ukurasa wa Kipengele cha Aina ya Kifaa Muhimu Sasisha kidogo kipengele katika sifa ya Ramani ya kipengele cha nguzo inayohusishwa

Washa Mazungumzo ya Kipengele

Zima Mazungumzo ya Kipengele

Kugeuza kumezimwa kwa baadhi ya vipengele wakati ulinganifu wao una thamani isiyojulikana au fomu ya t ambayo haitumiki kwa sasa. Katika ac se hii, ZAP itaonyesha maonyo katika arifa ap ne.
a Wa Element Conform nce ringings

Unapogeuza kipengele, ZAP inaweza kuonyesha maonyo ya kufuata kifaa na maonyo ya utiifu. Ikiwa hali ya kipengele hailingani na utiifu unaotarajiwa, ZAP itaonyesha ikoni ya onyo na kuweka onyo katika arifa ap ne. Kwa mfanoample ya maonyo ya utiifu na utiifu yanayoonyeshwa kwa kipengele:

24/35

Arifa
Arifa
Arifa
Sehemu ifuatayo inafafanua jinsi arifa zinavyotolewa kwa watumiaji wa ZAP katika UI.
Arifa za Kifurushi
Arifa za kifurushi ni maonyo au ujumbe wa hitilafu unaohusishwa kwa kifurushi chochote mahususi kilichopakiwa kwenye ZAP. Kwa mfanoampna, katika picha zilizo hapa chini, kubofya ikoni ya onyo chini ya safu wima ya hali itakuelekeza kwenye kidirisha kinachoonyesha arifa zote za kifurushi hicho.

25/35

Arifa
Arifa za Kipindi
Arifa za kipindi ni maonyo au ujumbe wa hitilafu ambao huhusishwa na kipindi cha mtumiaji. Maonyo/hitilafu hizi zinaweza kuonekana kwa kubofya kitufe cha Arifa kwenye upau wa vidhibiti juu ya UI ya ZAP. Kwa mfanoampna, picha hapa chini inaonyesha ukurasa wa arifa za kipindi baada ya isc file ilipakiwa kwenye ZAP.

26/35

Uzingatiaji wa Uainishaji wa Data-Model/ZCL
Uzingatiaji wa Uainishaji wa Data-Model/ZCL
Muundo wa Data na Uzingatiaji wa Uainisho wa ZCL
Kipengele hiki katika ZAP huwasaidia watumiaji kuona kushindwa kwa utiifu kwa Modeli ya Data au ZCL na usanidi wao uliopo wa ZAP. Ujumbe wa onyo kwa kushindwa kwa utiifu utaonekana kwenye kidirisha cha Arifa katika UI ya ZAP na pia utawekwa kwenye kiweko wakati wa kuendesha ZAP kupitia CLI. Kipengele cha utiifu kwa sasa kinatoa maonyo kwa utiifu wa aina ya kifaa na utiifu wa makundi kwenye sehemu ya mwisho.
Maonyo ya Uzingatiaji katika UI ya ZAP
Mtumiaji anapofungua .zap file kwa kutumia ZAP UI wataona maonyo katika kidirisha cha arifa cha ZAP UI kwa mapungufu yote ya utiifu. Kwa mfanoampna, picha iliyo hapa chini inaonyesha ukurasa wa arifa za kipindi baada ya .zap file ilifunguliwa na masuala ya kufuata.

Ujumbe wa utiifu utaondolewa mara tu masuala yatakapotatuliwa kwa kutumia ZAP UI ili uweze kufuatilia masuala yaliyosalia ya utiifu. Maonyo mapya pia yataonyeshwa kwa utii ikiwa mtumiaji atazima vipengele vya lazima (nguzo/maagizo/sifa) za usanidi. Arifa za utiifu wa vipimo daima zitafuatilia makosa yoyote ambayo yanaletwa kwenye usanidi wa ZAP lakini kumbuka kuwa maonyo ambayo yanaonekana wakati wa ufunguzi wa .zap. file zina maelezo zaidi kwa nini ilishindwa kufuata ikilinganishwa na maonyo ambayo yanaonekana wakati wa kuingiliana na UI. Hii ni kwa kubuni na ukaguzi kamili wa kufuata unafanywa wakati wa ufunguzi wa .zap file.
Maonyo ya Uzingatiaji kwenye Dashibodi

27/35

Uzingatiaji wa Uainishaji wa Data-Model/ZCL
Mtumiaji anapofungua .zap file kwa kutumia UI inayojitegemea ya ZAP au ZAP CLI wataona maonyo yameingia kwenye kiweko/terminal kwa mapungufu yote ya utiifu. Kwa mfanoampna, picha iliyo hapa chini inaonyesha maonyo ya arifa ya kipindi kwenye kiweko/terminal baada ya .zap file ilifunguliwa na masuala ya kufuata.

28/35

Udhibiti wa Ufikiaji

Vipengele vya Udhibiti wa Ufikiaji
ZAP inasaidia udhibiti wa ufikiaji kwenye vyombo vyote vya ZCL. Inategemea utekelezaji wa SDK ili kuweka vipengele hivi kwenye vipengele vinavyohitajika na vinavyotumika vya udhibiti wa ufikiaji wa SDK. ZAP kwa ujumla hutoa modeli ya data na utaratibu wa kuisimba kwenye meta-info files na kueneza data hiyo kwa violezo vya kizazi, bila kugawa maana maalum kwa vidokezo vya data.
Masharti ya Msingi
Udhibiti wa ufikiaji wa ZAP unafafanua masharti matatu ya msingi, kama ifuatavyo: ò uendeshaji : hufafanuliwa kama kitu kinachoweza kufanywa. Kwa mfanoample: soma, andika, omba. ó jukumu: hufafanuliwa kama fursa ya mwigizaji. Kama vile "View upendeleo”, “Jukumu la Utawala”, na mwana kuendelea. virekebishaji vya ô: hufafanuliwa kama hali maalum za udhibiti wa ufikiaji, kama vile data nyeti ya kitambaa au data ya upeo wa kitambaa. Masharti ya msingi yamefafanuliwa katika metadata XML chini ya sehemu ya juu tag . Ifuatayo ni exampufafanuzi wa neno la msingi la udhibiti wa ufikiaji:
<role type=”view”maelezo=”View upendeleo”/>
Ex huyuample inafafanua shughuli tatu, kusoma, kuandika na kuomba, marekebisho mawili na majukumu manne.
Fikia Utatu
Kila hali ya ufikiaji ya mtu binafsi inaweza kufafanuliwa kwa sehemu tatu ya ufikiaji katika XML. Ufikiaji wa triplet ni mchanganyiko wa operesheni, jukumu na kirekebishaji. Ni za hiari, kwa hivyo unaweza kuwa na moja tu kati ya hizi. Sehemu inayokosekana ya sehemu tatu kwa ujumla inamaanisha ruhusa, ambayo ni mahususi ya utekelezaji kwa SDK iliyotolewa. Huluki inayofafanua ufikiaji wake inaweza kuwa na sehemu tatu za ufikiaji moja au zaidi. Ifuatayo ni example:
saa 0
Huu ni ufafanuzi wa sifa ambayo ina sehemu tatu ya ufikiaji, ikitangaza kwamba inaruhusu utendakazi wa uandishi kwa jukumu la kudhibiti, na kirekebishaji cha upeo wa kitambaa kitatumika.
Ruhusa Chaguomsingi

29/35

Udhibiti wa Ufikiaji
Vyombo vya ZCL vinaweza kufafanua ruhusa zao za kibinafsi. Walakini, pia kuna ufafanuzi wa kimataifa wa ruhusa chaguo-msingi za
aina zilizopewa. Hizi huchukuliwa kwa huluki iliyotolewa, isipokuwa ikiwa inatoa ruhusa zake mahususi.
Ruhusa chaguo-msingi hutangazwa kupitia a tag katika kiwango cha juu cha XML file. Kutample:
aa a< ccess op="invoke”/> a a aa <ccess op=”re d”/> a< ccess op=”andika”/> a aa aa <ccess op="re d" role="view”/> aa < ccess op=”write” role=”oper te”/> a
Wasaidizi wa Violezo
Kisaidizi cha msingi cha kiolezo cha kutumia ni kiboreshaji cha {{#access}} … {{/access}}. Kirudishi hiki kinarudia zaidi ya sehemu tatu zote za ufikiaji.
Inasaidia chaguzi mbili zifuatazo:
chombo=”sifa/amri/tukio” – ikiwa huluki haiwezi kubainishwa kutokana na muktadha, hii itaweka aina ya huluki. includeDefault="true/false" - huamua kama maadili chaguo-msingi yamejumuishwa au la. Ifuatayo ni example:
{{#zcl_clusters}}
a Cluster: {{n me}} [{{code}}] a {{#zcl_ ttributes}} aa - ttribute: {{n me}} [{{code}}] aa {{# ccess entity="ttribute"}}
O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa - comm nd: {{n me}} [{{codend{}}comm c} {{codend=#}] a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – tukio: {{n me}} [{{code}}] a {{# ccess entity=”event”}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Inazindua ZAP kwa programu za Matter au Zigbee
Inazindua ZAP kwa programu za Matter au Zigbee
Inazindua ZAP kwa Programu za Matter au Zigbee
Sehemu zifuatazo zinaelezea kuzindua ZAP katika hali ya pekee kwa kutumia metadata mahususi ya Matter au Zigbee. Wazo ni kuzindua ZAP kwa hoja sahihi zinazohusiana na metadata ya XML (vikundi na ufafanuzi wa aina za vifaa kulingana na vipimo vya CSA) na violezo vya kuunda, ambavyo hutumika kutengeneza msimbo unaofaa.
Inazindua ZAP with Matter
Hati ifuatayo inachukua metadata sahihi kutoka kwa Matter SDK wakati wa kuzindua ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Kumbuka: Unaweza pia kutumia mbinu ifuatayo ya Zigbee ili kuzindua ZAP in Matter.
Inazindua ZAP na Zigbee
Amri ifuatayo inazindua ZAP na vipimo vya ZCL na violezo vya uzalishaji kutoka SDK.
[zap-path] -z [sdk-path]/gsdk/app/zcl/zcl-zap.json -g [sdk-path]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
zap-path: Hii ndio njia ya chanzo cha ZAP au njia ya sdk inayoweza kutekelezeka: Hii ndio njia ya SDK.
Inazindua ZAP bila Metadata
Kumbuka kwamba unapozindua ZAP moja kwa moja kupitia inayoweza kutekelezeka au kutoka kwa chanzo kwa kutumia npm run zap unazindua ZAP yenye metadata ya majaribio ya Matter/Zigbee iliyojengwa ndani ya ZAP na si metadata halisi inayotoka kwa Matter na Zigbee SDK zilizotajwa hapo juu. Kwa hivyo, kumbuka kuunda mipangilio yako ya ZAP kwa kutumia metadata ya SDK na si kwa kufungua ZAP moja kwa moja ukitumia metadata ya majaribio iliyojengewa ndani.

31/35

Inazalisha msimbo wa Matter au Zigbee

Inazalisha Msimbo wa Matter, Zigbee au SDK Maalum
Sehemu zifuatazo zinaelezea jinsi ya kutengeneza msimbo kwa kutumia ZAP.
Tengeneza Msimbo kwa kutumia ZAP UI
Zindua UI ya ZAP kulingana na maagizo katika Uzinduzi wa ZAP kwa Matter au Zigbee na ubofye kitufe cha Tengeneza kwenye upau wa menyu ya juu.
Tengeneza Msimbo bila UI
Maagizo yafuatayo yanatoa njia tofauti za kutengeneza msimbo kupitia CLI bila kuzindua ZAP UI.
Inazalisha Msimbo kutoka kwa Chanzo cha ZAP
Tekeleza amri ifuatayo ili kutoa nambari kwa kutumia ZAP kutoka chanzo: nodi src-script/zap-generate.js -genResultFile –stateDirectory ~/.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
Inazalisha Msimbo kutoka ZAP Inayoweza Kutekelezeka
Tekeleza amri ifuatayo ili kutoa nambari kwa kutumia ZAP inayoweza kutekelezwa: [zap-path] tengeneza -genResultFile –stateDirectory ~/.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
Inazalisha Nambari kutoka kwa ZAP CLI Inayotekelezeka
Tekeleza amri ifuatayo ili kutoa nambari kwa kutumia ZAP CLI Inayoweza Kutekelezwa: [zap-cli-path] tengeneza -genResultFile –stateDirectory ~/.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

Sasisha ZAP kwenye Studio

Sasisha ZAP
Sasisha ZAP katika Studio ya Urahisi
Utaratibu huu unaweza kutumika unapofanya kazi na Matter extension au Zigbee kutoka kwa matoleo ya SDK ya Silicon Labs. ZAP inaweza kusasishwa ndani ya Studio ya Urahisi bila toleo la Studio ya Urahisi kwa kupakua ZAP ya hivi punde inayoweza kutekelezeka (inapendekezwa) au kuvuta ya hivi punde kutoka chanzo cha ZAP kama inavyoonyeshwa katika Mwongozo wa Usakinishaji wa ZAP. Baada ya kupata ZAP mpya zaidi kulingana na Mfumo wa Uendeshaji unaotumika sasa, unaweza kusasisha ZAP ndani ya Studio kama kifurushi cha adapta. Fuata maagizo hapa chini baada ya kupakua ZAP ya hivi punde:
Nenda kwenye Studio ya Urahisi na uchague Mapendeleo > Studio ya Urahisi > Vifurushi vya Adapta. Bofya Ongeza... na uvinjari kwenye folda ya ZAP iliyopanuliwa uliyopakua na ubofye Chagua Folda . Bofya Tekeleza na Funga kisha ZAP iliyoongezwa hivi karibuni itatumika wakati wowote .zap file inafunguliwa.
Kumbuka: Wakati mwingine kunaweza kuwa na matukio ya zamani ya ZAP ambayo tayari inafanya kazi hata baada ya kusasishwa hadi ZAP ya hivi punde. Hakikisha kuwa umemaliza matukio yote yaliyopo ya ZAP kama vile ZAP iliyoletwa itumike badala ya mfano wa zamani, ambao bado unafanya kazi chinichini.
Sasisha ZAP kwa Maendeleo ya Mambo katika Github
Unapofanya kazi na Matter au Matter-Silicon Labs repos kwenye Github, weka vigeu vya mazingira kwa heshima na ZAP ili kuunda/kutoa usanidi mpya wa ZAP au kuzalisha upya zilizopo.ampusanidi wa ZAP baada ya kutumia mabadiliko kwao. Weka ZAP_DEVELOPMENT_PATH hadi ZAP kutoka chanzo kwa kuvuta ya hivi punde zaidi au weka ZAP_INSTALLATION_PATH hadi ZAP inayoweza kutekelezeka uliyopakua mwisho katika saraka ya eneo lako. Kumbuka kuwa ZAP_DEVELOPMENT_PATH na ZAP_INSTALLATION_PATH zinapowekwa, ZAP_DEVELOPMENT_PATH inatumika.
Wafuatao ni wa zamaniamples ambazo zinaonyesha anuwai za mazingira hapo juu zinazotumika:
Kuzindua ZAP kwa kutumia Matter vipimo Kutengeneza upya sampusanidi wa ZAP kwa programu za Matter
Kumbuka: Unapotumia vitekelezo vya ZAP, hakikisha kuwa unatumia toleo rasmi la toleo la usiku kwa uthabiti zaidi. Tazama
Kupakua ZAP Inayotekelezeka katika Mwongozo wa Usakinishaji wa ZAP

33/35

Itifaki nyingi za Sambamba kati ya Zigbee na Matter
Itifaki nyingi za Sambamba kati ya Zigbee na Matter
MCoanttceurrrent Multi-itifaki kati ya Zigbee na
ZAP inaweza kutumika kusanidi usanidi wa ZCL (Zigbee) na Data-Model (Matter) katika programu ya itifaki nyingi ya Zigbee na Matter. ZAP hukuruhusu kuunda miisho ya Zigbee na Matter kwa uwazi katika usanidi sawa. file. Ikiwa ncha za Zigbee na Matter ziko kwenye Kitambulishi cha ncha moja (kwa mfanoample, LO Dimmable Light kwenye endpoint Id 1 na Matter Dimmable Light kwenye tukio lingine la endpoint 1), ZAP inachukua huduma ya kusawazisha sifa za kawaida katika sifa za Matter na Zigbee. Hakikisha kuwa sifa zinazosawazishwa zina aina sawa ya data. Sifa za kawaida kati ya Zigbee na Matter zinaanzishwa kupitia a file inayoitwa multi-protocol.json . Mtumiaji anaweza kuunganisha makundi yoyote mawili kote Zigbee na Matter pamoja na sifa zao zinazolingana kwa kutumia nguzo na misimbo ya sifa mtawalia. Hii file inaweza kupatikana katika [SDKPath]/app/zcl/multi-protocol.json . Hii file imesasishwa na seti fulani ya makundi na sifa kwa kuanzia, lakini mtumiaji anaweza kusasisha hii file inavyohitajika na ZAP itachukua jukumu la kusawazisha usanidi wa sifa kote Zigbee na Matter kwa vitambulishi vya kawaida vya mwisho.
Unaweza pia kupata mafunzo ya ZAP katika programu yoyote ya itifaki ya Zigbee na Matter chini ya ukurasa wa mafunzo. Mafunzo haya yatakuongoza kupitia mchakato wa kuunda programu nyingi za itifaki. Mafunzo haya yanapatikana tu unapofungua programu ya itifaki nyingi iliyopo na yanaweza kupatikana kama inavyoonyeshwa kwenye picha hapa chini:

34/35

Unganisha SLC CLI na ZAP
Unganisha SLC CLI na ZAP
Unganisha SLC CLI na ZAP
Fuata hatua hizi ili kuunganisha SLC CLI na ZAP: ò Sakinisha SLC CLI kwa kufuata maagizo ya usakinishaji katika Mwongozo wa Mtumiaji wa Studio ya Rahisi 5. ó Sakinisha ZAP kwa kufuata maelekezo katika Mwongozo wa Ufungaji wa ZAP. ô Kuunganisha SLC CLI na ZAP, ongeza kigezo cha mazingira STUDIO_ADAPTER_PACK_PATH kinachoelekeza kwenye programu ya ZAP.
saraka. õ Kumbuka kuanzisha upya SLC CLI Daemon baada ya hatua ya 3. ö Mradi wowote unaotumia ZAP sasa utatumia njia iliyofafanuliwa katika hatua ya 3 inapotolewa kutoka SLC CLI. Tafadhali rejelea SLC CLI
Matumizi ya maagizo ya kutumia SLC CLI kwa miradi yako.

35/35

Nyaraka / Rasilimali

SILICON LABS ZAP Inakua na Silicon Labs [pdf] Mwongozo wa Mmiliki
ZAP Inakuza na Maabara ya Silicon, ZAP, Kuendeleza na Maabara ya Silicon, Maabara ya Silicon, Maabara

Marejeleo

Mwongozo wa Mtumiaji

ZAP Inakua na Maabara ya Silicon

Vipimo

Maagizo ya Matumizi ya Bidhaa

Maswali Yanayoulizwa Mara kwa Mara

Kuendeleza na Silicon Labs ZAP

ZAP Kuanza

Ufungaji wa ZAP

Misingi ya ZAP

XML maalum

XML maalum Tags kwa Zigbee

Aina Nyingi za Vifaa Kwa Kila Mwisho

Udhibiti wa Ufikiaji

Inazalisha msimbo wa Matter au Zigbee

Sasisha ZAP kwenye Studio

Nyaraka / Rasilimali

Marejeleo

Acha maoni

Ghairi jibu