ZAP Kupanga Ndi Buku la Mwini wa Silicon Labs

ZAP Yoyambira
- Kuti muyambe ndi ZAP, tsatirani izi:
  - Tsitsani Zap Executable kuchokera kumalo ovomerezeka.
  - Ikani zodalira pogwiritsa ntchito npm install command.
  - Pakuyika kwa Windows mwachindunji, onani ZaP Installation ya Windows OS guide.
Kukula kwa Zigbee
- Ngati mukupanga mapulogalamu a Zigbee:
  - Gwiritsani Ntchito Situdiyo Yosavuta yomwe imaphatikizapo ZAP ndi zida zina zofunika.

Kukula kwa Zinthu
- Ngati mukupanga Matter applications:
  - Zosankha zikuphatikiza kugwiritsa ntchito Simplicity Studio kapena kupeza Silicon Labs kapena CSA Github repositories.
  - Onani malangizo osinthidwa a ZAP kunja kwa Siplicity Studio kumasulidwa ngati pakufunika.

FAQs

Q: Ndi mitundu iti yamitundu yosiyanasiyana ya ZAP yomwe ilipo?
- A: Pali mitundu iwiri yomwe ilipo - Kutulutsidwa kovomerezeka ndi zomanga zotsimikizika ndikutulutsidwa kale ndi zatsopano.

Q: Ndiyenera kuchita chiyani ndikakumana ndi zovuta zopanga laibulale yakunyumba panthawi yoyika?
- A: Onani zambiri za FAQ zokhudzana ndi zolemba zapapulatifomu kuti muthetse vutoli.

"``

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Kupanga ndi Silicon Labs ZAP

Kuyambapo
ZAP Kuyambansoview Kuyika ZAP Kuyika ZAP Windows FAQ
Zofunika ZAP Zofunika
Maupangiri Ogwiritsa Ntchito ZAP Maupangiri Ogwiritsa Ntchitoview Makonda XML Mwamakonda XML Tags kwa Zigbee Multiple Device Types Per Endpoint Matter Device Type Feature Page Notifications Data-Model/ZCL Specification Compliance Access Control Kuyambitsa ZAP ya Matter kapena Zigbee applications Kupanga code ya Matter kapena Zigbee Update ZAP mu Studio Concurrent Multi-protocol pakati pa Zigbee ndi Matter Integrate SLC CLI ndi ZAPLC CLI

1/35

Kupanga ndi Silicon Labs ZAP
Kupanga ndi Silicon Labs ZAP
ZAP
ZAP ndi injini yopangira ma code a generic ndi mawonekedwe ogwiritsa ntchito ndi malaibulale otengera Zigbee Cluster Library kuchokera ku Zigbee kapena Data Model from Matter. Kufotokozeraku kumapangidwa ndi Connectivity Standards Alliance. ZAP imakupatsani mwayi wochita izi:
Pangani m'badwo wokhazikika wa SDK wazinthu zonse zapadziko lonse lapansi (nthawi zonse, mitundu, ma ID, ndi zina zotero) kutengera mafotokozedwe a ZCL/Data-Model. Chitani m'badwo wokhazikika wa SDK wazinthu zonse zosankhidwa ndi ogwiritsa ntchito (makonzedwe a pulogalamu, makonzedwe a mapeto, ndi zina zotero) kutengera mafotokozedwe a ZCL/Data-Model ndi kasinthidwe kantchito koperekedwa ndi kasitomala. Perekani UI kwa wogwiritsa ntchito kuti asankhe kasinthidwe ka ntchito (ma endpoints, masango, mawonekedwe, malamulo, ndi zina zotero).

Zomwe zili m'zigawozi zikufotokozera momwe mungapangire mapulogalamu a Zigbee ndi Matter pokonza ZCL (Zigbee) kapena Data Model (Matter) Layers pogwiritsa ntchito ZAP.

2/35

ZAP Yoyambira

ZAP Yoyambira
Chiyambi ndi ZAP
Magawowa akufotokoza njira zosiyanasiyana zopangira mapulogalamu a Zigbee ndi Matter. Dziwani kuti Situdiyo Yosavuta imapereka njira yopangira mapulogalamu anu a Zigbee ndi Matter kuchokera kumapeto mpaka kumapeto pomwe zida zonse zimabwera zitayikiridwapo limodzi ndi Situdiyo Yosavuta (kuphatikiza ZAP). Mutha kusankhanso kufufuza njira zina zopangira mapulogalamu anu, monga tafotokozera apa.
Kukula kwa Zigbee
Opanga mapulogalamu a Zigbee amatha kupanga mapulogalamu awo pogwiritsa ntchito Simplicity Studio, yomwe ili kale ndi ZAP ndi zida zina zomwe zimakuthandizani kupanga pulogalamu yanu kuyambira kumapeto mpaka kumapeto.
Kukula kwa Zinthu
Opanga Matter Application atha kupanga mapulogalamu awo pogwiritsa ntchito njira izi: Situdiyo Yosavuta: Izi zikuphatikiza ZAP ndi zida zina zomwe zimafunikira kuti pulogalamu ya Matter ithe. Github (Silicon Labs) Github (CSA)
Zindikirani: Kuti musinthe ZAP kunja kwa Siplicity Studio yotulutsa, onani zosintha za ZAP mu Simplicity Studio ndi ZAP Installation Guide.

3/35

Kukhazikitsa ZAP

Magawo otsatirawa akufotokoza kukhazikitsa kwa ZAP ndi momwe mungasinthire ZAP mu IDE Yosavuta ya Studio.
Kutsitsa Zoyeserera za ZAP Zomwe Zalimbikitsidwa)
Iyi ndi njira yoyenera yoyambira ndi ZAP. Mutha kupeza ma binaries aposachedwa a ZAP kuchokera ku aa https://github.com/project-chip/zp/releses. Ma binaries omangidwa kale amabwera m'mitundu iwiri yosiyana.
Kutulutsidwa kovomerezeka: Zomanga zotsimikizika zokhala ndi zida zoyeserera za Matter ndi Zigbee. Mtundu wa dzina lotulutsidwa ndi vYYYY.DD.MM. Kutulutsiratu: Imamanga ndi zida zaposachedwa komanso kukonza zolakwika koma zomangazi SIZIKUtsimikiziridwa ndi zida zoyeserera za Matter ndi Zigbee. Mtundu wa dzina lotulutsidwa ndi vYYYY.DD.MM-usiku uliwonse.
Kuyika ZAP kuchokera ku Source
Malangizo oyambira kukhazikitsa ZAP
Chifukwa iyi ndi pulogalamu ya node.js, mufunika malo a node ayikidwe. Njira yabwino yochitira izi ndikutsitsa kuyika kwaposachedwa kwa node, komwe kumaphatikizapo node ndi npm. Ngati muli ndi mtundu wakale wa node woyikidwa pamalo anu antchito, zitha kuyambitsa zovuta, makamaka ngati ndi zakale kwambiri. Onetsetsani kuti muli ndi mtundu waposachedwa wa v16.x wokhala ndi npm womwe waphatikizidwa. Thamangani node -version kuti muwone mtundu womwe watengedwa. v18.x ikulimbikitsidwa. Mukakhala ndi mtundu womwe mukufuna wa node, mutha kuyendetsa izi:
Ikani Ma Dependencies
Gwiritsani ntchito malamulo awa kuti muyike zodalira:

npm kukhazikitsa
Zindikirani: Pakuyika kwa ZAP kwa Windows, onani Kuyika kwa ZAP kwa Windows OS Si zachilendo kukumana ndi mavuto ophatikiza laibulale yakunyumba pakadali pano. Pali zolemba zosiyanasiyana za src-script/install-* zamapulatifomu osiyanasiyana. Onani zambiri za FAQ zokhuza script yomwe iyenera kuyendetsedwa pamapulatifomu osiyanasiyana ndikuyambiranso npm install .
Yambitsani Ntchito
Gwiritsani ntchito malamulo otsatirawa kuti muyambe kugwiritsa ntchito:

npm thamanga zap
Yambitsani Front-End mu Njira Yachitukuko
Imathandizira kutsitsanso nambala yotentha, malipoti olakwika, ndi zina zotero. Gwiritsani ntchito malamulo otsatirawa kuti muyambe kumapeto kwa chitukuko
mode:
quasar dev -m electron
or

4/35

ZAP Insta ndi oll in
npm kuthamanga electron-dev

5/35

Kuyika ZAP Windows
Kuyika ZAP Windows
Kuyika ZAP kwa Windows OS
1. Windows Powershell
Mu bokosi losakira pakompyuta, lowetsani Windows Powershell ndikuyendetsa ngati woyang'anira. Pangani malamulo onse otsatirawa mkati mwa Powershell.
2. Chokoleti
Kwabasi kuchokera https://chocolatey.org/install. Onani ngati idayikidwa bwino ndi malamulo awa:
choko -v
Ikani phukusi la pkgconfiglite ndi malamulo awa:
choco kukhazikitsa pkgconfiglite
3. Ikani Node
Pangani malamulo otsatirawa kuti muyike:
choco kukhazikitsa nodejs-lts
* Mtunduwu uyenera kukhala 18 kuti udutse mayeso a cheke, mutatha kukhazikitsa, fufuzani ndi node -v * Ngati mwayika Node kale, ndikulephera mayeso ena ofanana ndi osapeza Node, khazikitsaninso Node ndi chocolatey kachiwiri.
4. Tsatirani Malangizo Oyambira Kuyika ZAP
Tsatirani malangizo a kukhazikitsa ZAP kuchokera kochokera ku ZAP Installation. Mukamatsatira malangizo oyambira kukhazikitsa ZAP samalani ndi zolakwika zotsatirazi ndi momwe mungawathetsere:
sqli3
Mukamayendetsa ZAP (mwachitsanzo, npm run zap ), ngati muwona cholakwika sqlite3.node pawindo lotulukira, thamangani:
npm kumanganso sqlite3
electron-builder
Pamene mukuchita npm install, mu post-install, ngati cholakwika chikachitika pa lamulo lotsatirali okhudzana ndi electron-builder install-appdeps , npx electron-rebuild canvas inalephera kapena node-pre-gyp , mawonekedwe amakono a canvas sagwirizana ndi Windows ndipo cholakwika chokhazikitsa sichidzachititsa kulephera kuyendetsa ZAP. node-canvas ikugwira ntchito yothetsera vutoli tsopano ndipo nkhaniyi idzathetsedwa posachedwa.
"postinstall": "electron-builder install-app-deps && husky install && npm kumanganso canvas -update-binary && npm run version-stamp”

6/35

Kuyika ZAP Windows
Chinsalu
Ngati npm run test ikalephera chifukwa cha cholakwika Test suite yalephera kuthamanga. Sitinapeze gawo la '../build/Release/canvas.node' kapena
zapnode_modulescanvasbuildReleasecanvas.node si ntchito Win32 yovomerezeka. , panganinso chinsalu motere:
npm kumanganso canvas -update-binary
pezani index.html kapena Nkhani Zina za Seva
Ngati npm run test ikalephera chifukwa cha cholakwika pezani index.html pempho lalephera ndi code code 404 pamayeso a unit kapena kukhala ndi seva
kugwirizana mu mayeso a e2e-ci, yendetsani malamulo awa:
npm run build
Zina
Onani ngati mtundu wa node ndi v18 ndikuyesera kuyiyika ndi Chocolatey.

7/35

FAQ
FAQ
Mafunso Ofunsidwa Kawirikawiri
Q: Momwe mungayambitsire UI munjira yachitukuko? A: Mutha kuyambitsa UI munjira yachitukuko, zomwe zingapangitse kukhazikitsidwa kotsatira:
Seva ya HTTP yopatukana ya quasar, yomwe imakhala yotsitsimutsa pa doko 8080 ZAP kumapeto kwa doko 9070 Chrome kapena msakatuli wina, ikuyenda paokha Kuti mufike ku kukhazikitsa, tsatirani malangizo omwe ali pansipa. ò Choyamba, yendetsani seva yachitukuko ya ZAP, yomwe imayambira pa doko 9070.
npm thamangitsani zap-devserver ó Kenako, yendetsani seva yachitukuko cha quasar, yomwe imayambira pa doko 8080.
quasar dev ô Lozani msakatuli wanu kapena yesani imodzi molunjika URL ndi mkangano wa restPort:
google-chrome http://localhost:8080/?restPort=9070

Q: Kodi mungapangire bwanji izi pa Mac / Linux OS? A:
npm install imagwiritsidwa ntchito kutsitsa zonse zofunikira zodalira. Ngati muwona zolakwika zokhudzana ndi node-gyp ndi malaibulale akumaloko omwe akusowa, monga pixman, ndi zina zotero, mukusowa zodalira zakwawo kuti mukwaniritse kupanga ma binaries osamangidwiratu ophatikizira mapulatifomu ndi mitundu. Npm pamtambo ikusintha nthawi zonse mndandanda wamabina omwe aperekedwa, ndiye ndizotheka kuti muwatenge bwino, koma ngati simutero, awa ndi malangizo pamapulatifomu osiyanasiyana:
Fedora Core yokhala ndi dnf:
dnf yikani pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
kapena yambitsani script:
src-script/install-packages-fedora
Ubuntu wokhala ndi apt-get:
apt-get update apt-get install -kukonza-kusoweka libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
kapena yambitsani script:

8/35

FAQ
src-script/install-packages-ubuntu
OSX pa Mac yokhala ndi Homebrew brew :
brew install pkg-config cairo pango libpng jpeg giflib librsvg
kapena yambitsani script:
src-script/install-packages-osx
Q: Momwe mungapangire izi pa Windows OS?
Yankho: Onetsetsani kuti nthawi zonse zimakhala zatsopano ndipo palibe zosintha zomwe sizinachitike. Langizo: git pull, git status & git stash ndi anzanu. Muyenera kugwiritsa ntchito Chocolately kuti Zap igwire ntchito pa Windows OS. Onetsetsani kuti mwatsitsa phukusi la pkgconfiglite.
choco kukhazikitsa pkgconfiglite
Ngati muli ndi vuto ndi cairo, mwachitsanzoample ngati mupeza cholakwika pa cairo.h': Ayi file kapena chikwatu, chitani izi: ò Onani ngati kompyuta yanu ili 32 kapena 64 bit. ó Kutengera ndi izi, tsitsani phukusi loyenera kuchokera patsamba lino
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:
Dinani pa Advanced System Settings. Pa tabu yapamwamba dinani Zosintha Zachilengedwe. Mugawo Zosintha Zadongosolo, pezani PATH chilengedwe chosinthika ndikusankha. Dinani Sinthani ndikuwonjezera C:/GTK kwa izo. Ngati PATH chilengedwe kulibe, dinani Chatsopano. Ngati jpeglib.h sinapezeke, yesani zotsatirazi: ò Pa terminal, thamangani: choco install libjpeg-turbo ó Onetsetsani kuti ndi yoyera pogwiritsa ntchito: git clean -dxff and run npm install again ô ngati palibe zolakwika ndipo machenjezo akuwonekera, yesani kugwiritsa ntchito npm audit fix õ ngati simungathe kuyendetsa ZAP, pitani ku file src-script/zap-start.js ö Sinthani
÷ const {spawn } = amafuna('cross-spawn') to const {spawn} = amafuna('child_process') ø Thamanga npm ndi kuthamanga zap. Zolozera:
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)
Q: Ndikupeza cholakwika "sqlite3_node" sichinapezeke kapena chofanana.

9/35

FAQ
A: Panganinso zomangira zanu zaku sqlite3. Kuti mukonze izi nthawi zambiri, yesani:
npm kukhazikitsa
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Ngati sichikukonzedwa, chitani:
rm -rf node_modules ndiyeno yesaninso malamulo omwe ali pamwambapa. Nthawi zina kukweza npm yanu kumapangitsanso kusiyana:
npm kukhazikitsa -g npm
Q: Ndapeza cholakwika "N-API ya N-API yachitsanzo cha Node iyi ndi 1. Gawoli limathandizira mtundu wa N-API 3. Chitsanzo cha Node ichi sichingathe kuyendetsa gawoli."
A: Sinthani mtundu wanu wa node. Yankho la izi likukambidwa mu ulusi wa Stack Overflow: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Q: PC yanga yachitukuko sigwira ntchito ndi ZAP pazifukwa zilizonse. Kodi ndingagwiritse ntchito chotengera cha docker?
A: Inde mungathe. Mtengo wa TBD.
Q: Kodi ine kuthamanga ZAP mkati VSCode?
A: Ngati VSCode mu njira yanu lowetsani zap repo ndikulemba kachidindo. Izi zidzatsegula ZAP mu VSCode. Kuti muthamangitse ZAP muzowongolera, sankhani malo ogwirira ntchito a ZAP ndikudina chizindikiro cha Thamangani chakumanzere chakumanzere. Mudzakhala ndi zosankha zingapo zomwe mungasankhe kuti muyendetse ZAP, sankhani Node.js Debug Terminal. Izi zidzatsegula zenera la terminal momwe mungalowetse npm run zap , yomwe idzagwirizanitsa debugger ndikuyendetsa ZAP monga momwe mungakhalire kuchokera pamzere wolamula. Zabwino zonse, tsopano muyenera kuwona ZAP ikuyenda mu debugger. Mutha kukhazikitsa zopumira mu VSCode monga momwe mungakhalire mu IDE ina iliyonse.
Q: Kuyesa kwa unit ya UI kumalephera ndi zolakwika zina kuzungulira canvas osapanga mtundu woyenera wa node. Nditani?
A: Ngati muwona zolakwika zotsatirazi:
FAIL test/ui.test.js Test suite inalephereka Module ya 'canvas.node' idapangidwa motsutsana ndi mtundu wina wa Node.js pogwiritsa ntchito NODE_MODULE_VERSION 80. Mtundu uwu wa Node.js umafunika NODE_MODULE_VERSION 72. Chonde yesani kulembanso kapena kuyimitsanso gawoli (mwachitsanzo, mwachitsanzo, ppmild install).`
ku Object. (node_modules/canvas/lib/bindings.js:3 18)
ndiye thamangani: npm kumanganso canvas -update-binary

10/35

Zofunikira za ZAP

ZCL/Data-Model ZAP Zofunikira
Gawoli lili ndi zambiri za ogwiritsa ntchito atsopano a ZAP. Dinani pa chithunzi chamaphunziro chomwe chili kumanja kumanja kwa ZAP UI, chomwe chikuwonetsa momwe mungapangire masinthidwe a ZAP. Phunziroli likutsogolerani pa izi: Pangani pomaliza Sankhani mtundu wa chipangizo Konzani gulu Konzani mawonekedwe Konzani lamulo Kuti mumve zambiri, onani Zigbee Cluster Configurator Guide

11/35

Zap User Guide
Zap User Guide
Zap User Guide
Magawo omwe ali mu bukhuli akupereka tsatanetsatane wazinthu zosiyanasiyana zoperekedwa ndi ZAP.

12/35

Makonda XML

Kuwonjezera Custom XML kuchokera ku ZAP UI
Dinani pa "Zowonjezera" mu ZAP UI. Dinani pa "+" batani lowonjezera kuti musankhe xml yokhazikika file Magulu, machitidwe, malamulo, ndi zina ziyenera kuwonekera mu ZAP UI mukangowonjezera xml.
Kupanga makonda anu a XML ku Zigbee
Gawoli likuwonetsa momwe mungapangire magulu anuanu ndikukulitsa magulu omwe alipo omwe ali ndi machitidwe ndi malamulo a Zigbee.
Magulu Opanga-Specific ku Zigbee
Mutha kuwonjezera magulu apadera a opanga ku pro wambafile. Timapereka exampndi izi apa. Kuti muchite izi muyenera kukwaniritsa maudindo awiri:
ID ya cluster IYENERA kukhala m'gulu la wopanga, 0xfc00 - 0xffff. Tanthauzo la masango liyenera kukhala ndi nambala ya opanga yomwe idzagwiritsidwe ntchito pazikhumbo ZONSE ndi malamulo omwe ali mgululi ndipo ziyenera kuperekedwa potumiza ndi kulandira malamulo ndikulumikizana ndi mawonekedwe. EksampLe:

Sampndi Mfg Specific Cluster General Gulu ili limapereka example la momwe Application Framework ingakulitsidwire kuti aphatikize magulu enieni a opanga.
0xFC00
mbe sampndi chikhalidwe
mbe sampndi attribute 2

A samplamulo la wopanga mkati mwa sample wopanga-mwachindunji
gulu.

Manufacturer-Specific Commands mu Standard Zigbee Cluster
Mutha kuwonjezera malamulo anu pagulu lililonse la Zigbee ndi izi:
Malamulo anu okhudzana ndi opanga amatha kugwiritsa ntchito id iliyonse yamalamulo pamtundu wa id, 0x00 - 0xff. Muyeneranso kupereka kachidindo ka wopanga lamulolo kuti lizisiyanitsidwa ndi malamulo ena mgululi ndikusamalidwa moyenera. Eksampkukulitsa gulu la On/Off ndi malamulo opanga:

13/35

Makonda XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe limazimitsa chipangizocho ndi kusintha komwe kumaperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificOnWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe limayatsa chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificToggleWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe limasintha chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificOnWithTransition2″ optional=”zoona” wopangaCode="0 1049″> Lamulo la kasitomala lomwe limayatsa chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificToggleWithTransition2″ optional=”zoona”
wopanga kodi=”0 1049″> Lamulo la kasitomala lomwe limasintha chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.

Mawonekedwe Odziwika A wopanga mu Gulu Lokhazikika la Zigbee
Mutha kuwonjezera zomwe muli nazo pagulu lililonse la Zigbee ndi izi:
Makhalidwe opangidwa ndi opanga anu amatha kugwiritsa ntchito id iliyonse yomwe ili mumtundu wa id, 0x0000 - 0xffff. Muyeneranso kupereka kachidindo ka wopanga kuti azitha kusiyanitsa ndi zina zomwe zili mgululi ndikusamalidwa moyenera. Eksampkukulitsa gulu la On/Off lomwe lili ndi mawonekedwe opanga:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” mtundu=”INT16U” min="0 0000″
max=”0xFFFF” writable=”zoona” default=”0 0000″ optional=”zoona” wopangaCode=”0 1002″>Sample Mfg Chikhalidwe Chapadera: 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 Chikhalidwe Chapadera: 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 Chikhalidwe Chapadera: 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 Khalidwe Lapadera: 0 0001 0 1040
Kupanga XML yanu mu Matter
Gawoli likuwonetsa momwe mungapangire magulu anuanu ndikukulitsa magulu omwe alipo omwe ali ndi machitidwe ndi malamulo a Matter.
Magulu Opanga-Specific mu Matter
Mutha kuwonjezera magulu enieni a opanga ku Matter. Timapereka exampndi izi apa.
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

Makonda XML
Mu example, kuphatikiza ID ya ogulitsa (ID Yoyesa Wopanga Mayeso) ya 0xFFF1 ndi ID ya cluster ya 0xFC20 imapangitsa value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. ExampLe:
General Sampndi MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER The SampGulu la MEI likuwonetsa zowonjezera zamagulu opanga magulu Phidigu phidigu
Mayankho a AddArguments omwe amabwezera ndalamazo. Lamulo lomwe limatenga mikangano iwiri ya uint8 ndikubweza kuchuluka kwawo. Lamulo losavuta popanda magawo aliwonse komanso opanda yankho.
Maonekedwe Odziwikiratu Opanga Mumagulu Okhazikika a Matter
Mutha kuwonjezera zomwe opanga amapanga pagulu lililonse lokhazikika la Matter ndi izi:
Taaaa aphatikiza zomwe zikuwonjezedwa ziyenera kufotokozedwa -
e xte ndi ed> ">
Khodi ya chikhalidwe ndi kuphatikiza kwa 32-bit kwa code ya wopanga ndi id ya chikhalidwecho. Ma bits 16 ofunikira kwambiri ndi ma code opanga. Mitundu yamakhodi opanga mayeso ndi 0xFFF1 - 0xFFF4. Ma bits 16 ofunikira kwambiri ndi ID. Kusiyanasiyana kwa zomwe si zapadziko lonse lapansi ndi 0x0000 - 0x4FFF.
Exampkukulitsa gulu la On/Off Matter lomwe lili ndi mawonekedwe enieni opanga:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ mtundu=”INT8U” min="0 0000″
max=”0xFFFF” writable=”zoona” default=”0 0000″ optional=”zoona”>Sample Mfg Specific Attribute 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ mtundu=”INT16U” min="0 0000″
max=”0xFFFF” writable=”zoona” default=”0 0000″ optional=”zoona”>Sample Mfg Specific Attribute 4
Malamulo Odziwikiratu Opanga Magulu Okhazikika
Mutha kuwonjezera malamulo enieni a opanga pagulu lililonse lodziwika la Matter ndi izi:
T aaaa iye akuphatikiza zomwe malamulo akuwonjezeredwa ayenera kufotokozedwa -
e xte ndi ed> ">
Khodi ya lamulo ndi kuphatikiza kwa 32-bit kwa code ya wopanga ndi id ya lamulo. Ma bits 16 ofunikira kwambiri ndi ma code opanga. Mitundu yamakhodi opanga mayeso ndi 0xFFF1 - 0xFFF4. Ma bits 16 ofunikira kwambiri ndi ID yolamula. Mndandanda wamalamulo omwe siapadziko lonse lapansi ndi 0x0000 - 0x00FF.
ExampKukulitsa gulu la On/Off Matter lokhala ndi magulu apadera opanga:

15/35

Makonda XML

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ optional=”zoona”> Lamulo la kasitomala lomwe limayatsa chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ optional=”zoona”>
Lamulo la kasitomala lomwe limasintha chipangizocho ndikusintha koperekedwa ndi nthawi yosinthira mu Ember Sampchikhalidwe cha nthawi ya kusintha.

16/35

Makonda XML Tags za Zigbee

Chikalata chotsatirachi chikulankhula za xml iliyonse tags kugwirizana ndi Zigbee.
xml aliyense file yalembedwa pakati pa configurator tags:

Mitundu ya data imatha kufotokozedwa mkati mwa configurator tag. Zigbee pakadali pano amathandizira kutanthauzira kwa bitmaps, enums, integers, zingwe kapena structs. Musanafotokoze mitundu yambiri onetsetsani kuti mwayang'ana mitundu yonse ya atomiki yomwe ili mu type.xml ndi mitundu yonse yopanda atomiki yofotokozedwa mu xml ina. files. Mutha kuwatanthauzira motere:
Bitmap: dzina: dzina la mtundu wa bitmap. mtundu: Bitmap yokhala ndi kukula pakati pa 8-64 bits ikhoza kufotokozedwa, zonsezi ziyenera kukhala zochulukitsa za 8. Bitmap iliyonse ikhoza kukhala ndi minda yambiri yokhala ndi dzina ndi mask yogwirizana nayo. mwachitsanzo:

"``
Enum: dzina: dzina la mtundu wa enum. mtundu: Enum ndi kukula pakati pa 8-64 bits akhoza kufotokozedwa, zonsezi ziyenera kukhala zochulukitsa za 8. Enum iliyonse ikhoza kukhala ndi zinthu zambiri zomwe zili ndi dzina ndi mtengo wogwirizana nawo. mwachitsanzo:

Integer: Mitundu yonse imatanthauzidwa kale pansi pa mitundu ya atomiki yomwe ilipo mu mitundu.xml. Kukula kwawo kumatha kuyambira 8-64 bits ndipo kumatha kusaina kapena kusaina. mwachitsanzo:

Chingwe: Mitundu ya zingwe imatanthauzidwa kale pansi pa mitundu ya atomiki yomwe ilipo mu mitundu.xml. Mitundu yamakono ya zingwe imaphatikizapo chingwe cha octet, char string, chingwe chachitali cha octet ndi chingwe chachitali mwachitsanzo:

Kapangidwe: dzina: dzina la mtundu wa struct. Chigawo chilichonse chikhoza kukhala ndi zinthu zingapo zomwe zili ndi dzina ndi mtundu wogwirizana nazo. Mtundu ukhoza kukhala mtundu uliwonse wokonzedweratu pansi pa mitundu ya deta. mwachitsanzo:

17/35

Makonda XML Tags za Zigbee

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

Custom Clusters akhoza kufotokozedwa mkati mwa configurator tag. name: name of the cluster domain: domain of the cluster. Gululi liziwoneka mu ZAP UI pansi pa domain iyi. Kufotokozera: Kutanthauzira kwa Cluster Code: Cluster Code Define: Cluster Define (Cluster Define) yomwe imagwiritsidwa ntchito ndi jenereta ya code kutanthauzira gululo mwanjira inayake wopangaCode: Amagwiritsidwa ntchito kutanthauzira gulu lapadera lopanga. Izi ziyenera kukhala pakati pa 0xfc00 - 0xffff. Khodi ya wopanga masango iyenera kufotokozedwa motere:

Gulu lopanga zinthu limangopanga zikhalidwe ndi malamulo omwe ali pansi pake kuti akhale ndi code yofananira pokhapokha atalemba momveka bwino code ya wopanga. introducedIn: Amagwiritsidwa ntchito kutsimikizira mtundu womwe gululo lidayambitsidwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuti muwonjezere malingaliro owonjezera. removeIn: Amagwiritsidwa ntchito kutsimikizira mtundu womwe gululo linachotsedwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuti muwonjezere malingaliro owonjezera. singleton(boolean): Amagwiritsidwa ntchito kudziwa gulu ngati singleton kotero kuti pamakhala gawo limodzi lokha la gululo lomwe limagawidwa kumapeto. chikhalidwe: chimatanthawuza chikhalidwe cha dzina la gulu: Dzina lachidziwitso limatchulidwa pakati pa chikhalidwecho. tag.
dzina lachikhumbo
side(kasitomala/seva): Mbali ya tsango lomwe limalumikizidwanso. kachidindo: kachidindo kopanga kachidindo: Izi zitha kugwiritsidwa ntchito kutanthauzira mawonekedwe a wopanga kunja kwa zigbee zomwe zatchulidwa ndi xml wamba. define: attribute define zomwe zimagwiritsidwa ntchito ndi code jenereta kutanthauzira chikhalidwe mwanjira inayake: mtundu wa mawonekedwe omwe atha kukhala mtundu uliwonse wa data womwe watchulidwa mu xml kusakhazikika: mtengo wosasinthika wa chikhalidwecho. min: Mtengo wochepera wololedwa wa chiwongola dzanja chachikulu: Mtengo wovomerezeka wa chinthu chomwe chingalembedwe: Kodi mtengo wake ndi wolembedwa kapena ayi. Izi zitha kugwiritsidwa ntchito kuletsa mawonekedwewo kuti asasinthidwe ndi malamulo olembera. optional(boolean): Amagwiritsidwa ntchito kutsimikizira ngati chosankha ndichosankha kapena ayi pagulu. min: Mtengo wochepera wololedwa wa chikhalidwe chikakhala chamtundu wamtundu, enum kapena bitmap. max: Utali wololedwa wamtengo wapatali ukakhala wowerengeka, enum kapena utali wamtundu wa bitmap: Amagwiritsidwa ntchito pofotokoza kutalika kwachinthu chikakhala chamtundu wa chingwe. minLength: Amagwiritsidwa ntchito pofotokoza utali wochepera wa chiganizo chikakhala chamtundu wa chingwe. reportable(boolean): Imauza ngati mawonekedwe ndi okambidwa kapena ayi isNullable(boolean): Imalola kuti pakhale zinthu zopanda pake. array(boolean): Amagwiritsidwa ntchito kulengeza zamtundu wamtundu. introducedIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe unayambika. Izi zimagwiritsidwa ntchito ndi code jenereta kuwonjezera malingaliro owonjezera. removeIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe adachotsedwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuwonjezera malingaliro owonjezera. lamulo: fotokozani lamulo la dzina la gulu: Dzina la lamulo.

kodi: command kodi

18/35

Makonda XML Tags za Zigbee
khodi ya wopanga: Izi zitha kugwiritsidwa ntchito kutanthauzira lamulo la wopanga kunja kwa zigbee zomwe zatchulidwa ndi xml wamba. kufotokoza: kufotokozera gwero la lamulo (kasitomala / seva): gwero la lamulo. optional(boolean): Amagwiritsidwa ntchito kudziwa ngati lamulo ndilosankha kapena ayi pagulu. introducedIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe lamuloli lidayambitsidwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuwonjezera malingaliro owonjezera. removeIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe lamulolo lidachotsedwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuwonjezera malingaliro owonjezera. lamula mfundo:
Lamulo lirilonse likhoza kukhala ndi mndandanda wa zotsutsana za lamulo: dzina la mtundu wa mtsutso wa lamulo: mtundu wa mtsutso wa lamulo womwe ukhoza kukhala mtundu uliwonse wotchulidwa mu xml. min: Mtengo wochepera wololedwa pa mkangano ukakhala nambala, enum kapena mtundu wa bitmap. max: Kuchuluka kololedwa kwa mkangano ukakhala wowerengeka, enum kapena utali wa mtundu wa bitmap: Amagwiritsidwa ntchito kutchula kutalika kovomerezeka kwa mtsutso wa lamulo ukakhala wamtundu wa chingwe. minLength: Amagwiritsidwa ntchito pofotokoza utali wovomerezeka wovomerezeka pa mtsutso wa lamulo ukakhala wamtundu wa chingwe. array(boolean): Kuti muwone ngati mkangano wamalamulo ndi wamtundu wamtundu. presentIf(chingwe): Ichi chikhoza kukhala chotsatira chokhazikika cha machitidwe omveka potengera mfundo zina zamalamulo komwe mungayembekezere mtsutso wa lamulo ngati chingwe chokhazikika chikuwona kuti ndichowona. mwachitsanzo:

Zindikirani: Apa udindo ndi dzina lina la lamulo. optional(boolean): Amagwiritsidwa ntchito kutsimikizira mkangano wamalamulo ngati mwasankha. countArg: Amagwiritsidwa ntchito pamene mtsutso wa lamulo uli wamtundu wamtundu. Izi zimagwiritsidwa ntchito kutchula mtsutso wina wamalamulo womwe umatanthauza kukula kwa mkanganowu.

introducedIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe kutsutsana kwalamulo kudayambika. Izi zimagwiritsidwa ntchito ndi code jenereta kuti muwonjezere malingaliro owonjezera. removeIn: Amagwiritsidwa ntchito kutsimikizira mtundu wamtundu womwe mkangano wamalamulo adachotsedwa. Izi zimagwiritsidwa ntchito ndi code jenereta kuti muwonjezere malingaliro owonjezera. Cluster Extension ikhoza kufotokozedwa mkati mwa configurator tag. Cluster extension imagwiritsidwa ntchito kukulitsa gulu lokhazikika lokhala ndi mawonekedwe opangira ndi malamulo mwachitsanzo

19/35

Makonda XML Tags za 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”makerCode=”0 1002″>Sample Mfg Chikhalidwe Chapadera: 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 Chikhalidwe Chapadera: 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 Chikhalidwe Chapadera: 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 Khalidwe Lapadera: 0 0001 0 1040ampleMfgSpecificOffWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe lizimitsa chipangizocho ndikusintha kwaperekedwa
pa nthawi ya kusintha kwa Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificOnWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe limayatsa chipangizocho ndikusintha kwaperekedwa
pa nthawi ya kusintha kwa Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificToggleWithTransition” optional=”zoona” wopangaCode="0 1002″> Lamulo la kasitomala lomwe limasintha chipangizocho ndikusintha kwaperekedwa
pa nthawi ya kusintha kwa Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificOnWithTransition2″ optional=”zoona” wopangaCode="0 1049″> Lamulo la kasitomala lomwe limayatsa chipangizocho ndikusintha kwaperekedwa
pa nthawi ya kusintha kwa Ember Sampchikhalidwe cha nthawi ya kusintha.ampleMfgSpecificToggleWithTransition2″ optional=”zoona” wopangaCode="0 1049″> Lamulo la kasitomala lomwe limasintha chipangizocho ndikusintha kwaperekedwa
pa nthawi ya kusintha kwa Ember Sampchikhalidwe cha nthawi ya kusintha.

20/35

Mitundu Yazida Zambiri Pamapeto

Ichi ndi gawo la Matter-only pomwe wogwiritsa ntchito amatha kusankha mitundu yopitilira chipangizo chimodzi pamapeto pake. Kuwonjezedwa kwa mitundu ingapo ya zida za aaa kudzawonjezera masinthidwe a cluster mkati mwa mitundu ya chipangizocho ku ma endpoint tion.

21/35

Mitundu Yazida Zambiri Pamapeto

Chithunzi pamwambapa chikuwonetsa kuti pomaliza 1 ili ndi mitundu yopitilira chipangizo chimodzi yosankhidwa. "Chida Chachikulu" chikutanthauza mtundu wa chipangizo chomwe chimaliziro chidzalumikizidwa nacho. Mtundu wa chipangizocho nthawi zonse umakhala pa index 0 pa mndandanda wa zida zomwe zasankhidwa kotero kusankha mtundu wina wa chipangizocho kumasintha mayitanitsa amitundu yazida zomwe zasankhidwa. Zosankha zamtundu wa chipangizocho zimakhalanso ndi zopinga zochokera ku Data Model Specification. ZAP imateteza ogwiritsa ntchito kuti asasankhe mitundu yosavomerezeka yamitundu yazida kumapeto kwake pogwiritsa ntchito zopingazi.

22/35

Tsamba la Matter Device Type
Tsamba la Matter Device Type
Tsamba la Matter Device Type
ZAP imathandizira kuwona ndikusintha mawonekedwe a Matter patsamba la mtundu wa chipangizocho. Zida zamtundu wa chipangizo zokha zomwe zafotokozedwa mu matter-devices.xml munkhokwe ya CHIP zidzawonetsedwa.

Kupita ku Tsamba la Feature
ò Yambitsani ZAP mu Matter yokhala ndi Matter SDK yaposachedwa. ó Pangani pothera ndi mtundu wa chipangizo cha Matter. ô Dinani batani la Mtundu wa Chipangizo pamwamba pa gululo view. Dziwani kuti batani ili likupezeka ku ZAP kokha
masinthidwe a Matter komanso data yofananira ikapezeka mu Matter SDK. Kudina batani ili kudzatsegula chithunzi pamwambapa.
Conformance
Conformance imatanthawuza kusankha ndikudalira mawonekedwe, malamulo, zochitika, ndi mitundu ya data. Imatsimikizira ngati chinthucho chili chovomerezeka, chosankha, kapena chosachirikizidwa pansi pa masinthidwe ena a ZAP.
Mawonekedwe amtundu wa chipangizo amakhala patsogolo kuposa mawonekedwe a cluster. Za example, mawonekedwe a Lighting ali ndi mawonekedwe osankha mu gulu la On/Off koma amanenedwa kuti ndi ovomerezeka mumtundu wa chipangizo cha On/Off Light chomwe chimaphatikizapo gulu la On/Off. Kupanga pomaliza ndi mtundu wa chipangizo cha On/Off Light kudzawonetsa mawonekedwe a Kuwala ngati kovomerezeka patsamba lachiwonetsero.
Feature Toggling
Patsamba lomwe lili patsamba, mukadina batani losintha kuti mutsegule kapena kuletsa mawonekedwe, ZAP itero:
Sinthani zinthu zogwirizana (makhalidwe, malamulo, zochitika) kuti mukonze mayendedwe, ndikuwonetsa zokambirana zomwe zikuwonetsa kusintha.

23/35

Tsamba la Matter Device Type Feature Page Sinthani mawonekedwe a mawonekedwe a Mapu a gulu lomwe likugwirizana

Yambitsani Nkhani Yokambirana

Zimitsani Nkhani Yokambirana

Kusintha kumayimitsidwa pazinthu zina ngati kufanana kwake kuli ndi mtengo wosadziwika kapena mawonekedwe osagwiritsidwa ntchito pano t. Mu ac se, ZAP iwonetsa machenjezo mu chidziwitso ap ne.
ndi Wa Element Conform nce rings

Mukasintha chinthu, ZAP ikhoza kuwonetsa machenjezo okhudzana ndi chipangizocho komanso machenjezo okhudzana ndi kutsata. Ngati gawo la chinthucho silikugwirizana ndi zomwe zikuyembekezeredwa, ZAP iwonetsa chizindikiro chochenjeza ndikulemba chenjezo mu chidziwitso ap ne. Eksampchenjezo la kutsata ndi kutsata zomwe zikuwonetsedwa pa chinthu:

24/35

Zidziwitso
Zidziwitso
Zidziwitso
Gawo lotsatirali likufotokoza momwe zidziwitso zimaperekedwa kwa ogwiritsa ntchito a ZAP mu UI.
Zidziwitso Zaphukusi
Zidziwitso za phukusi ndi machenjezo kapena mauthenga olakwika okhudzana ndi phukusi lililonse lomwe lalowetsedwa mu ZAP. Za example, muzithunzi zomwe zili pansipa, kudina chizindikiro cha chenjezo pansi pa gawoli kukutsogolerani ku zokambirana zomwe zikuwonetsa zidziwitso zonse za phukusilo.

25/35

Zidziwitso
Zidziwitso za Gawo
Zidziwitso za Session ndi machenjezo kapena mauthenga olakwika omwe amalumikizidwa ndi gawo la ogwiritsa ntchito. Machenjezo/zolakwa izi zitha kuwoneka podina batani la Zidziwitso pazida pamwamba pa ZAP UI. Za example, chithunzi pansipa chikuwonetsa tsamba lazidziwitso za gawo pambuyo pa isc file adakwezedwa ku ZAP.

26/35

Kugwirizana kwa Mafotokozedwe a Data-Model/ZCL
Kugwirizana kwa Mafotokozedwe a Data-Model/ZCL
Chitsanzo cha Data ndi ZCL Specification Compliance
Izi mu ZAP zimathandiza ogwiritsa ntchito kuwona kulephera kutsata kwa Data Model kapena ZCL ndi masinthidwe awo omwe alipo kale a ZAP. Mauthenga ochenjeza olephera kutsatira adzawonekera pagawo la Zidziwitso mu ZAP UI ndipo adzalowetsedwanso pa kontrakitala mukayendetsa ZAP kudzera pa CLI. Chotsatira pakali pano chimapereka machenjezo a kutsata kwa mtundu wa chipangizo ndi kutsata magulu kumapeto.
Machenjezo Otsatira mu ZAP UI
Pamene wosuta atsegula .zap file pogwiritsa ntchito ZAP UI awona machenjezo pagawo lazidziwitso la ZAP UI pazolephera zonse kutsatira. Za example, chithunzi pansipa chikusonyeza gawo zidziwitso tsamba pambuyo .zap file idatsegulidwa ndi zovuta zotsata.

Mauthenga otsatiridwa adzachoka pamene nkhanizo zathetsedwa pogwiritsa ntchito ZAP UI kotero kuti mutha kuyang'anitsitsa zomwe zatsala. Machenjezo atsopano adzawonekeranso kuti atsatire ngati wogwiritsa ntchito aletsa zinthu zovomerezeka (tsanga/malamulo/makhalidwe) pakusinthitsa. Zidziwitso zakutsatiridwa kwatsatanetsatane nthawi zonse zizisunga zolephera zilizonse zomwe zimayambitsidwa mu kasinthidwe ka ZAP koma dziwani kuti machenjezo omwe amawonekera pakutsegulidwa kwa .zap file ali ndi zambiri chifukwa chake idalephera kutsatira poyerekeza ndi machenjezo omwe amawonekera polumikizana ndi UI. Izi ndizomwe zimapangidwira ndipo kufufuza kwathunthu kumachitidwa panthawi yotsegulira .zap file.
Machenjezo Otsatira pa Console

27/35

Kugwirizana kwa Mafotokozedwe a Data-Model/ZCL
Pamene wosuta atsegula .zap file pogwiritsa ntchito ZAP standalone UI kapena ZAP CLI adzawona machenjezo atalowa mu console/terminal pazolephera zonse kutsatira. Za example, chithunzi chili m'munsimu chikusonyeza machenjezo zidziwitso gawo pa konsoni/terminal pambuyo .zap file idatsegulidwa ndi zovuta zotsata.

28/35

Access Control

Access Control Features
ZAP imathandizira kuwongolera mwayi pamabungwe onse a ZCL. Zatsala pang'ono kukhazikitsidwa kwa SDK kuti apangire mawonekedwewa kuti agwirizane ndi zofunikira komanso zothandizidwa ndi zowongolera za SDK. ZAP nthawi zambiri imapereka chitsanzo cha data ndi njira yoziyika mu meta-info files ndikufalitsa detayo ku ma templates a m'badwo, popanda kugawa matanthauzo enieni kumalo a deta.
Mfundo Zoyambira
Kuwongolera kofikira kwa ZAP kumatanthawuza mawu atatu oyambira, motere: ò ntchito : kufotokozedwa ngati chinthu chomwe chingachitike. Eksample: werengani, lembani, pemphani. ó udindo: wofotokozedwa ngati mwayi wa sewero. Monga "View mwayi", "udindo woyang'anira", ndi mwana pa. ô zosintha: zomwe zimatanthauzidwa ngati zowongolera mwapadera, monga data yansalu kapena data yofikira pansalu. Mawu oyambira amafotokozedwa mu metadata XML pansi pa pamwamba tag . Chotsatira ndi example of access control base term definitions:
<role type=”view"mafotokozedwe="View mwayi”/>
Ex iziample imatanthauzira machitidwe atatu, kuwerenga, kulemba ndi kuyitanitsa, zosintha ziwiri ndi maudindo anayi.
Pezani Maulendo Atatu
Kufikira kulikonse kwa munthu kumatha kufotokozedwa ndi mwayi wofikira katatu mu XML. Access triplet ndi kuphatikiza kwa ntchito, gawo ndi zosintha. Ndizosankha, kotero mutha kukhala ndi imodzi mwa izi. Gawo losowa la triplet nthawi zambiri limatanthawuza permissivenes, yomwe imakhala yokhazikika pa SDK yopatsidwa. Bungwe lomwe limafotokoza zofikira zake litha kukhala ndi mwayi umodzi kapena angapo katatu. Chotsatira ndi exampLe:
ku 0
Uku ndi tanthawuzo la chiganizo chomwe chili ndi mwayi wofikira katatu, kulengeza kuti chimalola kulemba ntchito ndi ntchito yoyang'anira, ndikuyika chosinthira chopangidwa ndi nsalu.
Zilolezo Zosasinthika

29/35

Access Control
Mabungwe a ZCL amatha kufotokozera zilolezo zawo. Komabe, palinso tanthauzo lapadziko lonse la zilolezo zosasinthika za
mitundu yopatsidwa. Izi zimaganiziridwa ndi bungwe lomwe lapatsidwa, pokhapokha ngati lipereka zilolezo zakezake.
Zilolezo zofikira zimalengezedwa kudzera pa a tag pamlingo wapamwamba wa XML file. EksampLe:
aa a<ccess op="invoke"/> a a aa <ccess op=”re d”/> a<ccess op=”lembani”/> a aa aa <ccess op="re d" role="view”/> aa <ccess op=”write” role="oper te”/> a
Othandizira Ma template
Chothandizira pachithunzi chofunikira kugwiritsa ntchito ndi {{#access}} … {{/access}} chobwereza. Wobwerezabwereza uyu akubwereza maulendo atatu operekedwa.
Imathandizira njira ziwiri zotsatirazi:
entity=”mawonekedwe/lamulo/chochitika” - ngati bungwe silingadziwike kuchokera munkhani, izi zimakhazikitsa mtundu wa bungwe. includeDefault = "zowona / zabodza" - zimatsimikizira ngati zikhalidwe zosasinthika zikuphatikizidwa kapena ayi. Chotsatira ndi 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: {{udindo}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa - comm nd: {{n me}}} [{antity{#} comm] a RM a M * p: {{oper tion}} / ole: {{udindo}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – chochitika: {{n me}} [{{code}}] a {{# ccess entity=”chochitika”}} O a RM a M * p: {{oper tion}} / ole: {{ role}} / odifier: {{ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Kukhazikitsa ZAP pamapulogalamu a Matter kapena Zigbee
Kukhazikitsa ZAP pamapulogalamu a Matter kapena Zigbee
Kukhazikitsa ZAP ya Matter kapena Zigbee Application
Magawo otsatirawa akufotokoza za kukhazikitsa ZAP munjira yodziyimira yokha ndi Matter kapena Zigbee-specific metadata. Lingaliro ndikuyambitsa ZAP ndi mfundo zolondola zokhudzana ndi metadata ya XML (matanthauzidwe amagulu ndi mitundu ya zida malinga ndi mafotokozedwe a CSA) ndi ma tempuleti am'badwo, omwe amagwiritsidwa ntchito kupanga code yoyenera.
Kukhazikitsa ZAP ndi Matter
Zolemba zotsatirazi zimatenga metadata yolondola kuchokera ku Matter SDK poyambitsa ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Zindikirani: Mukhozanso kupita ku njira yotsatira ya Zigbee kuti mutsegule ZAP mu Matter.
Kukhazikitsa ZAP ndi Zigbee
Lamulo lotsatirali likuyambitsa ZAP ndi mafotokozedwe a ZCL ndi ma tempuleti am'badwo kuchokera ku 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: Iyi ndi njira yopita ku gwero la ZAP kapena njira ya sdk: Iyi ndi njira yopita ku SDK.
Kukhazikitsa ZAP popanda Metadata
Kumbukirani kuti mukamayambitsa ZAP mwachindunji kudzera pa zomwe zingatheke kapena kuchokera ku gwero pogwiritsa ntchito npm run zap mukuyambitsa ZAP yokhala ndi metadata yoyeserera ya Matter/Zigbee yomangidwa mkati mwa ZAP osati metadata yeniyeni yochokera ku Matter ndi Zigbee SDKs zomwe tazitchula pamwambapa. Chifukwa chake, kumbukirani kupanga masinthidwe anu a ZAP pogwiritsa ntchito metadata ya SDK osati kutsegula ZAP mwachindunji ndi metadata yoyeserera.

31/35

Kupanga khodi ya Matter kapena Zigbee

Kupanga Code for Matter, Zigbee kapena SDK Yamakonda
Magawo otsatirawa akufotokoza momwe mungapangire ma code pogwiritsa ntchito ZAP.
Pangani Khodi Pogwiritsa Ntchito ZAP UI
Yambitsani ZAP UI molingana ndi malangizo mu Kukhazikitsa ZAP ya Matter kapena Zigbee ndikudina batani Pangani pamenyu yapamwamba.
Pangani Code popanda UI
Malangizo otsatirawa amapereka njira zosiyanasiyana zopangira ma code kudzera pa CLI popanda kuyambitsa ZAP UI.
Kupanga Khodi kuchokera ku ZAP Source
Thamangani lamulo ili kuti mupange code pogwiritsa ntchito ZAP kuchokera ku gwero: node 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
Kupanga Code kuchokera ku ZAP Executable
Thamangani lamulo ili kuti mupange code pogwiritsa ntchito ZAP: [zap-path] pangani -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
Kupanga Code kuchokera ku ZAP CLI Executable
Thamangani lamulo ili kuti mupange code pogwiritsa ntchito ZAP CLI Executable: [zap-cli-path] pangani -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

Sinthani ZAP mu Studio

Kusintha kwa ZAP
Sinthani ZAP mu Situdiyo Yosavuta
Makinawa amatha kugwiritsidwa ntchito mukamagwira ntchito ndi Matter extension kapena Zigbee kuchokera ku Silicon Labs SDK. ZAP ikhoza kusinthidwa mkati mwa Situdiyo Yosavuta popanda kutulutsidwa kwa Situdiyo Yosavuta potsitsa zaposachedwa za ZAP (zovomerezeka) kapena kukoka zaposachedwa kuchokera ku gwero la ZAP monga zikuwonetsedwa mu Zap Installation Guide. Mutakhala ndi ZAP yaposachedwa kutengera OS yomwe mukugwiritsa ntchito pano, mutha kusintha ZAP mkati mwa Studio ngati paketi ya adaputala. Tsatirani malangizo omwe ali pansipa mutatsitsa ZAP yaposachedwa:
Pitani ku Situdiyo Yosavuta ndikusankha Zokonda> Situdiyo Yosavuta> Adapter Packs. Dinani Onjezani… ndipo sakatulani ku chikwatu cha ZAP chomwe mwatsitsa ndikudina Sankhani Foda . Dinani Ikani ndi Tsekani ndiyeno ZAP yowonjezeredwa idzagwiritsidwa ntchito nthawi iliyonse pamene .zap file chatsegulidwa.
Zindikirani: Nthawi zina pakhoza kukhala zochitika zakale za ZAP zomwe zikuyenda kale ngakhale mutasinthidwa ku ZAP yaposachedwa. Onetsetsani kuti mwathetsa zochitika zonse za ZAP kuti ZAP yomwe yangotengedwa igwiritsidwe ntchito m'malo mwa yakale, yomwe ikugwirabe ntchito kumbuyo.
Sinthani ZAP ya Matter Development ku Github
Mukamagwira ntchito ndi Matter kapena Matter-Silicon Labs repos pa Github, ikani zosintha zachilengedwe molingana ndi ZAP kuti mupange / kupanga masinthidwe atsopano a ZAP kapena kupanganso zosintha zomwe zilipo kale.ample ZAP masinthidwe mutatha kugwiritsa ntchito zosintha kwa iwo. Khazikitsani ZAP_DEVELOPMENT_PATH kukhala ZAP kuchokera koyambira pokoka zaposachedwa kapena kuyika ZAP_INSTALLATION_PATH kukhala ZAP zomwe mudatsitsa komaliza m'ndandanda yanu. Dziwani kuti zonse ZAP_DEVELOPMENT_PATH ndi ZAP_INSTALLATION_PATH zikakhazikitsidwa, ZAP_DEVELOPMENT_PATH zimagwiritsidwa ntchito.
Otsatirawa ndi akaleampzomwe zikuwonetsa zosinthika zomwe zili pamwambapa zomwe zikugwiritsidwa ntchito:
Kukhazikitsa ZAP pogwiritsa ntchito Matter specification Kukonzanso magawo onseample ZAP masinthidwe a Matter application
Zindikirani: Mukamagwiritsa ntchito zoyeserera za ZAP, onetsetsani kuti mukugwiritsa ntchito kutulutsa kovomerezeka usiku wonse kuti mukhale bata. Mwaona
Kutsitsa Zoyeserera za ZAP mu Zap Installation Guide

33/35

Concurrent Multi-protocol pakati pa Zigbee ndi Matter
Concurrent Multi-protocol pakati pa Zigbee ndi Matter
MCoanttceurrent Multi-protocol pakati pa Zigbee ndi
ZAP itha kugwiritsidwa ntchito kukonza masinthidwe a ZCL (Zigbee) ndi Data-Model (Matter) mu pulogalamu yamitundu yambiri ya Zigbee ndi Matter. ZAP imakulolani kuti mupange ma endpoints a Zigbee ndi Matter momveka bwino mumasinthidwe omwewo. file. Ngati mapeto a Zigbee ndi Matter ali pachizindikiritso chofanana chakumapeto (kwa mwachitsanzoample, LO Dimmable Light pa endpoint Id 1 ndi Matter Dimmable Light pa nthawi ina ya endpoint 1), ZAP imasamalira kulunzanitsa mikhalidwe yodziwika pa Matter ndi Zigbee. Onetsetsani kuti zomwe zikulumikizidwa zili ndi mtundu womwewo wa data. Zomwe zimafanana pakati pa Zigbee ndi Matter zimakhazikitsidwa kudzera mu a file amatchedwa multi-protocol.json . Wogwiritsa ntchito amatha kulumikiza magulu awiri aliwonse kudutsa Zigbee ndi Matter pamodzi ndi zomwe amafanana pogwiritsa ntchito masango ndi zizindikiro motsatana. Izi file imapezeka mu [SDKPath]/app/zcl/multi-protocol.json. Izi file zasinthidwa ndi gulu lina la magulu ndi makhalidwe poyambira, koma wosuta akhoza kusintha izi file monga zikufunikira ndipo ZAP idzasamalira kuyanjanitsa mawonekedwe pa Zigbee ndi Matter pazozindikiritsa zofananira.
Mutha kupezanso maphunziro a ZAP mu pulogalamu iliyonse ya Zigbee ndi Matter multiprotocol pansi pa tsamba la maphunziro. Maphunzirowa akuwongolera njira yopangira ma protocol ambiri. Phunziroli limapezeka kokha mukatsegula pulogalamu yamitundu yambiri yomwe ilipo ndipo mutha kupezeka monga momwe tawonera pachithunzichi:

34/35

Gwirizanitsani SLC CLI ndi ZAP
Gwirizanitsani SLC CLI ndi ZAP
Gwirizanitsani SLC CLI ndi ZAP
Tsatirani izi kuti muphatikize SLC CLI ndi ZAP: ò Ikani SLC CLI potsatira malangizo oyika mu Siplicity Studio 5 User Guide. ó Ikani ZAP potsatira malangizo omwe ali mu ZAP Installation Guide. ô Kuti muphatikize SLC CLI ndi ZAP, onjezani STUDIO_ADAPTER_PACK_PATH yolozera ku ZAP application.
directory. õ Kumbukirani kuyambitsanso SLC CLI Daemon pambuyo pa sitepe 3. ö Pulojekiti iliyonse yomwe imagwiritsa ntchito ZAP idzagwiritsa ntchito njira yofotokozedwa mu sitepe 3 ikapangidwa kuchokera ku SLC CLI. Chonde onani SLC CLI
Gwiritsani ntchito malangizo ogwiritsira ntchito SLC CLI pama projekiti anu.

35/35

Zolemba / Zothandizira

SILICON LABS ZAP Kupanga Ndi Silicon Labs [pdf] Buku la Mwini
ZAP Kupanga Ndi Silicon Labs, ZAP, Kupanga Ndi Silicon Labs, Silicon Labs, Labs

Maumboni

Buku Logwiritsa Ntchito

ZAP Kupanga Ndi Silicon Labs

Zofotokozera

Malangizo Ogwiritsira Ntchito Zogulitsa

FAQs

Kupanga ndi Silicon Labs ZAP

ZAP Yoyambira

Kukhazikitsa ZAP

Zofunikira za ZAP

Makonda XML

Makonda XML Tags za Zigbee

Mitundu Yazida Zambiri Pamapeto

Access Control

Kupanga khodi ya Matter kapena Zigbee

Sinthani ZAP mu Studio

Zolemba / Zothandizira

Maumboni

Siyani ndemanga

Letsani yankho