ZAP na-eji Silicon Labs na-emepe emepe
Nkọwapụta
- Aha ngwaahịa: Silicon Labs ZAP
- Ụdị: Usoro mmepụta koodu na interface onye ọrụ
- ndakọrịta: Ọbá akwụkwọ ụyọkọ Zigbee (Zigbee) ma ọ bụ Ihe Nlereanya Data (Matter)
- Mepụtara site: Njikọta Standards Alliance
Ntuziaka ojiji ngwaahịa
- ZAP na-amalite
- Iji malite ZAP, soro usoro ndị a:
- Budata ZAP Executable site na ebe nchekwa gọọmentị.
- Wụnye ndị dabere na iji iwu npm install.
- Maka nrụnye Windows akọwapụtara, rụtụ aka na ntinye ZAP maka ntuziaka Windows OS.
- Iji malite ZAP, soro usoro ndị a:
- Zigbee Development
- Ọ bụrụ na ị na-emepụta ngwa Zigbee:
- Jiri Studio Simplicity nke gụnyere ZAP na ngwaọrụ ndị ọzọ dị mkpa.
- Ọ bụrụ na ị na-emepụta ngwa Zigbee:
- Mmepe Okwu
- Ọ bụrụ na ị na-emepe emepe Matter ngwa:
- Nhọrọ gụnyere iji Simplicity Studio ma ọ bụ ịnweta Silicon Labs ma ọ bụ CSA Github repositories.
- Rụtụ aka na ntuziaka mmelite maka ZAP na mpụga okirikiri ntọhapụ Simplicity Studio ma ọ dị mkpa.
- Ọ bụrụ na ị na-emepe emepe Matter ngwa:
Ajụjụ
- Ajụjụ: Gịnị bụ ụdị dị iche iche nke ọnụọgụ abụọ ZAP dị?
- A: Enwere ụdị abụọ dị - Mwepụta gọọmentị nwere ihe nrụpụta akwadoro yana ewepụtara ya na njirimara kachasị ọhụrụ.
- Ajụjụ: Gịnị ka m ga-eme ma ọ bụrụ na m na-ezute nsogbu nchịkọta ọbá akwụkwọ ala nna n'oge echichi?
- A: Rụtụ aka na ozi FAQ gbasara edemede akọwapụtara n'elu ikpo okwu iji dozie ụdị nsogbu ahụ.
"'
Silicon Labs ZAP
Silicon Labs ZAP
Iji Silicon Labs ZAP na-emepe emepe
Na-amalite
ZAP na-amalite ọzọview Nwụnye ZAP Windows FAQ
Ihe ndị dị mkpa ZAP bụ isi
Ntuziaka onye ọrụ ZAP ntuziaka onye ọrụ gafereview Omenala XML omenala XML Tags n'ihi na Zigbee Multiple Device Types Per Endpoint Matter Device Type Feature Page Ịma ọkwa Data-Model/ZCL Specification Compliance Access Control Nwepụta ZAP maka Matter ma ọ bụ ngwa Zigbee Ịmepụta koodu maka Matter ma ọ bụ Zigbee Mmelite ZAP na Studio Concurrent Multi-protocol n'etiti Zigbee na Matter Integrate SLC CLI na ZAP
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
1/35
Iji Silicon Labs ZAP na-emepe emepe
Iji Silicon Labs ZAP na-emepe emepe
ZAP
ZAP bụ igwe ọgbara ọhụrụ koodu yana interface onye ọrụ maka ngwa na ọba akwụkwọ dabere na ọba akwụkwọ ụyọkọ Zigbee sitere na Zigbee ma ọ bụ Ihe Nlereanya Data sitere na Matter. Ndị Njikọ Standards Alliance mepụtara nkọwapụta a. ZAP na-enye gị ohere ịrụ ọrụ ndị a:
Mee SDK-kpọmkwem ọgbọ ahaziri ahazi nke ihe niile zuru ụwa ọnụ (mgbe niile, ụdị, NJ na ndị ọzọ) dabere na nkọwapụta ZCL/Data-Model. Mee SDK-kpọmkwem ọgbọ ahaziri ahazi nke ndị ọrụ ahọpụtara artifact (nhazi ngwa, nhazi njedebe njedebe, na ihe ndị ọzọ) dabere na nkọwapụta ZCL/Data-Model na nhazi ngwa ndị ahịa nyere. Nye UI maka onye ọrụ njedebe ịhọrọ nhazi ngwa (ntụpọ njedebe, ụyọkọ, njirimara, iwu, na ihe ndị ọzọ).
Ọdịnaya dị na ngalaba ndị a na-akọwa otu esi emepụta ngwa Zigbee na Matter site na ịhazi Layers ZCL (Zigbee) ma ọ bụ Data Model (Matter) site na iji ZAP.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
2/35
ZAP na-amalite
ZAP na-amalite
Na-amalite na ZAP
Akụkụ ndị a na-akọwa ụzọ dị iche iche iji mepụta ngwa Zigbee na Matter. Mara na Simplicity Studio na-enye ụzọ iji mepụta ngwa Zigbee na Matter gị site na njedebe ruo na njedebe ebe etinyere ngwa ọrụ niile yana Simplicity Studio (gụnyere ZAP). Ị nwekwara ike ikpebi inyocha ụzọ ndị ọzọ nke ịmepụta ngwa gị, dị ka akọwara ebe a.
Zigbee Development
Ndị na-emepụta ngwa Zigbee nwere ike iji Simplicity Studio wulite ngwa ha, nke gụnyerelarị ZAP na ngwaọrụ ndị ọzọ na-enyere gị aka iwulite ngwa gị site na nsọtụ ruo na nsọtụ.
Mmepe Okwu
Ndị na-emepụta ihe ngwa nwere ike iwulite ngwa ha site na iji ụzọ ndị a: Studio Simplicity: Nke a gụnyere ZAP na ngwaọrụ ndị ọzọ achọrọ iji wuo ngwa Matter na njedebe. Github (Silicon Labs) Github (CSA)
Mara: Ka imelite ZAP na mpụga okirikiri ntọhapụ Simplicity Studio, lee melite ZAP na Simplicity Studio na ntuziaka nwụnye ZAP
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
3/35
Nwụnye ZAP
Akụkụ ndị a na-akọwa nrụnye ZAP yana otu esi emelite ZAP na IDE Simplicity Studio.
Nbudata ZAP Executable kwadoro)
Nke a bụ ụzọ akwadoro isi malite na ZAP. Ị nwere ike nweta ọnụọgụ abụọ ZAP kacha ọhụrụ site na aa https://github.com/project-chip/zp/releses. ọnụọgụ abụọ e wuburu na-abịa na nsụgharị abụọ dị iche iche.
Ntọhapụ gọọmentị: akwadoro na-eji Matter raara onwe ya nye na ụlọ nyocha Zigbee. Ụdị aha mwepụta bụ vYYYY.DD.MM. Mwepụta mbụ: Na-eji atụmatụ kachasị ọhụrụ na ndozi ahụhụ na-ewu mana ejighi Matter na ụlọ nyocha Zigbee kwadoro ụlọ ndị a. Ụdị aha mwepụta bụ vYYYY.DD.MM-kwa abalị.
Ịwụnye ZAP site na Isi mmalite
Ntuziaka bụ isi ka ịwụnye ZAP
N'ihi na nke a bụ a node.js ngwa, ị chọrọ arụnyere na node gburugburu ebe obibi. Ụzọ kachasị mma isi mee nke a bụ ibudata ihe ntinye ọnụ kacha ọhụrụ, nke gụnyere ọnụ na npm. Ọ bụrụ na ị nwere ụdị ọnụ nke ochie arụnyere n'ebe a na-arụ ọrụ gị, ọ nwere ike ịkpata nsogbu, ọkachasị ma ọ bụrụ na ọ merela agadi. Gbaa mbọ hụ na ị nwere ụdị node v16.x kachasị ọhụrụ yana npm nke agụnyere. Gbaa node –ụdị ka ịlele ụdị ewelitere. v18.x ka akwadoro. Mgbe ị nwetachara ụdị node chọrọ, ị nwere ike ịme ihe ndị a:
Wụnye ndabere
Jiri iwu ndị a ka ịwụnye ndabere:
npm tinye
Mara: Maka nrụnye ZAP dị na Windows, lee Nwụnye ZAP maka Windows OS Ọ bụghị ihe ọhụrụ ịbanye na nsogbu nchịkọta ọba akwụkwọ obodo n'oge a. Enwere edemede src-script/install-* dị iche iche maka nyiwe dị iche iche. Hụ ozi FAQ gbasara edemede ị ga-agba na nyiwe dị iche iche wee megharịa npm wụnye .
Malite ngwa
Jiri iwu ndị a ka ịmalite ngwa:
npm agba zap
Malite ihu-ọgwụgwụ na ọnọdụ mmepe
Na-akwado mbugharị koodu ọkụ, mkpesa njehie, na ihe ndị ọzọ. Jiri iwu ndị a ka ịmalite njedebe ihu na mmepe
ụkpụrụ:
quasar dev -m eletrọn
or
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
4/35
ZAP Insta na n'ime
npm na-agba ọsọ eletrọn-dev
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
5/35
Windows wụnye ZAP
Windows wụnye ZAP
Nwụnye ZAP maka Windows OS
1. Windows Powershell
Na nchọta desktọpụ, tinye Windows Powershell wee gbaa ọsọ dị ka onye nchịkwa. Gbaa iwu niile a n'ime Powershell.
2. Chocolate
Wụnye site na https://chocolatey.org/install. Lelee ma arụnyere ya nke ọma site na iji iwu ndị a:
choco -v
Wụnye ngwugwu pkgconfiglite na iwu ndị a:
choco tinye pkgconfiglite
3. Wụnye Node
Gbaa iwu ndị a ka ịwụnye:
choco wụnye nodejs-lts
* Ụdị ahụ ga-abụ 18 iji gafee ule nlele ụdị, mgbe wụnyechara, lelee node -v * Ọ bụrụ na ị tinyela Node ugbua, wee daa ule ụfọdụ yiri nke enweghị ike ịchọta Node , tinyekwa Node na chocolatey ọzọ.
4. Soro ntuziaka ndị bụ isi ka ịwụnye ZAP
Soro ntuziaka nwụnye ZAP sitere na isi mmalite dị na ntinye ZAP. Mgbe ị na-eso ntuziaka bụ isi maka ịwụnye ZAP, lezie anya maka njehie ndị a yana otu esi edozi ha:
sqlite 3
Mgbe ị na-agba ọsọ ZAP (dịka ọmụmaatụ, npm run zap), ọ bụrụ na ị hụ njehie gbasara sqlite3.node na windo mmapụta, gbaa ọsọ:
npm wughachi sqlite3
eletrọn-nrụpụta
Mgbe ị na-eme npm install, na post-install, ọ bụrụ na njehie emee na iwu na-esonụ metụtara electron-builder install-appdeps , npx electron-rebuild canvas fail or node-pre-gyp , ụdị canvas dị ugbu a adabaghị na Windows na njehie nrụnye agaghị eme ka ọdịda na-agba ọsọ ZAP. node-canvas na-arụ ọrụ na ngwọta ugbu a na a ga-edozi okwu ahụ n'ọdịnihu dị nso.
"postinstall": "electron-builder install-app-deps && husky install && npm wughachikwa kanvas -update-binary && npm run version-stamp”
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
6/35
Windows wụnye ZAP
Kwaaji
Ọ bụrụ na npm run ule daa n'ihi njehie Test suite agaghị agba ọsọ. Enweghị ike ịhụ modul '../build/Release/canvas.node' ma ọ bụ
zapnode_modulescanvasbuildReleasecanvas.node abụghị ngwa Win32 bara uru. , wughachi kwaaji dị ka ndị a:
npm wughachikwa kanvas -update-binary
nweta index.html ma ọ bụ Okwu sava ndị ọzọ
Ọ bụrụ na npm run ule daa n'ihi njehie nweta index.html arịrịọ dara na koodu ọnọdụ 404 na unit ule ma ọ bụ inwe ihe nkesa.
nsogbu njikọ na ule e2e-ci, mee iwu ndị a:
npm ọsọ wuo
Ndị ọzọ
Lelee ma ụdị node bụ v18 wee nwaa itinye ya na Chocolatey.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
7/35
FAQ
FAQ
Ajụjụ a na-ajụkarị
Ajụjụ: Otu esi amalite UI na ọnọdụ mmepe? A: Ị nwere ike ịmalite UI n'ụdị mmepe, nke ga-ebute nhazi ndị a:
Ihe nkesa HTTP quasar mmepe dị iche, nke na-enye ume ọhụrụ na ọdụ ụgbọ mmiri 8080 ZAP azụ na-agba ọsọ na ọdụ ụgbọ mmiri 9070 Chrome ma ọ bụ ihe nchọgharị ọzọ, na-agba ọsọ n'onwe ya Iji ruo na nhazi ahụ, soro ntuziaka dị n'okpuru. Nke mbụ, mee ihe nkesa mmepe ZAP, nke na-amalite na ọdụ ụgbọ mmiri 9070.
npm na-agba zap-devserver na Na-esote, mee ihe nkesa mmepe quasar, nke na-amalite na ọdụ ụgbọ mmiri 8080.
Quasar dev ô Tụnye ihe nchọgharị gị ma ọ bụ mee otu megide nke dabara adaba URL ya na arụmụka restPort:
google-chrome http://localhost:8080/?restPort=9070
Q: Olee otú ime ka ọrụ a na Mac / Linux OS? A:
A na-eji npm install budata ngwugwu ndabere niile achọrọ. Ọ bụrụ na ị na-ahụ njehie metụtara node-gyp na ndị na-efunahụ ọba akwụkwọ mpaghara, dị ka pixman , na na, ị na-efu na-adabere nwa afọ ka afọ ju ikpokọta na-abụghị ewuru node ọnụọgụ abụọ maka ụfọdụ ngwakọta nke nyiwe na nsụgharị. Npm na ígwé ojii na-emelite ndepụta nke ọnụọgụ abụọ enyere mgbe niile, yabụ na ị ga-eburu ha nke ọma, mana ọ bụrụ na i meghị, ndị a bụ ntuziaka maka nyiwe dị iche iche:
Fedora Core nwere dnf:
dnf tinye pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
ma ọ bụ gbaa script:
src-script/wụnye-ngwugwu-fedora
Ubuntu nwere apt-nweta:
apt-nweta mmelite apt-nweta install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
ma ọ bụ gbaa script:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
8/35
FAQ
src-script/install-ngwugwu-ubuntu
OSX na Mac na Homebrew brew:
ime biya tinye pkg-config cairo pango libpng jpeg giflib librsvg
ma ọ bụ gbaa script:
src-script/install-ngwugwu-osx
Ajụjụ: Kedu otu esi eme nke a na Windows OS?
A: Gbaa mbọ hụ na ọ na-adị ọhụrụ ma ọ nweghị mgbanwe ọ bụla emebeghị. Ndụmọdụ: git pull, git status & git stash bụ ndị enyi gị. Ị ga-eji Chocolately mee ka Zap rụọ ọrụ na Windows OS. Gbaa mbọ hụ na ibudata ngwugwu pkgconfiglite.
choco tinye pkgconfiglite
Ọ bụrụ na ị nwere nsogbu na cairo, maka example ọ bụrụ na ị nweta njehie gbasara cairo.h': Ọ dịghị otú ahụ file ma ọ bụ ndekọ, mee ihe ndị a: ọ Lelee ma kọmputa gị bụ 32 ma ọ bụ 64 bit. Ọ dabere na nke ahụ, budata ngwugwu kwesịrị ekwesị na saịtị a
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:
Pịa na Advanced System Settings. Na elu taabụ pịa Environment Variables. Na ngalaba Sistem Variables, chọta PATH gburugburu ebe obibi wee họrọ ya. Pịa Dezie ma tinye C:/GTK na ya. Ọ bụrụ na mgbanwe gburugburu PATH adịghị, pịa Ọhụrụ. Ọ bụrụ na ahụghị jpeglib.h, gbalịa ihe ndị a: ò On the terminal, run: choco install libjpeg-turbo ó Jide n'aka na ọ dị ọcha site na iji: git clean -dxff wee mee npm install again ô ma ọ bụrụ na ọ dịghị njehie emee naanị ịdọ aka ná ntị pụtara, gbalịa iji npm audit fix õ ọ bụrụ na ị nweghị ike ịgba ọsọ ZAP, gaa na file src-script/zap-start.js ö Gbanwee
÷ const { spawn } = chọrọ ('cross-spawn') ka const { spawn } = chọrọ('child_process') ø Gbaa npm wee gbaa zap. Ntụaka:
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)
Ajụjụ: Enwetara m mperi "sqlite3_node" ahụghị ma ọ bụ yiri ya.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
9/35
FAQ
A: wughachi ihe nkedo nke sqlite3 ala gị. Iji dozie nke a n'ọtụtụ oge, gbaa ọsọ:
npm tinye
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Ọ bụrụ na ọ ka edobeghị ya, mee:
rm -rf node_modules wee nwalee iwu ndị dị n'elu ọzọ. Mgbe ụfọdụ ịkwalite npm gị na-emekwa ihe dị iche:
npm tinye -g npm
Ajụjụ: Enwetara m njehie "Ụdị N-API nke ihe atụ Node a bụ 1. Nke a modul na-akwado ụdị N-API 3. Nke a Node ihe atụ enweghị ike ịgba ọsọ a modul."
A: Kwalite ụdị ọnụ gị. A tụlere azịza maka nke a na eriri Stack Overflow: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Ajụjụ: PC mmepe m anaghị arụ ọrụ na ZAP maka ihe kpatara ya. Enwere m ike iji akpa docker?
A: Ee ị nwere ike. TBD.
Ajụjụ: Kedu ka m ga-esi agba ZAP n'ime VSCode?
A: Ọ bụrụ na ị VSCode n'ụzọ gị tinye zap repo na pịnye koodu . Nke a ga-emepe ZAP na VSCode. Iji mee ZAP na ọnọdụ nbipu, họrọ ebe ọrụ ZAP wee pịa akara ngosi Gbaa n'akụkụ aka ekpe. Ị ga-enwe nhọrọ abụọ ịhọrọ site na ịme ZAP, họrọ Node.js Debug Terminal . Nke a ga-emepe windo ọnụ nke ị nwere ike ịbanye npm run zap , nke ga-etinye ihe nbibi ma na-agba ọsọ ZAP dịka ị na-emekarị site na akara iwu. Ekele, ị ga-ahụ ugbu a ZAP na-agba ọsọ na nbibi. Ị nwere ike ịtọ ebe nkwụsịtụ na VSCode dịka ị ga-eme na IDE ọ bụla ọzọ.
Ajụjụ: Nnwale otu UI daa na ụfọdụ mperi gburugburu kwaaji anaghị ewuli maka ụdị ọnụ ziri ezi. Kedu ihe m ga-eme?
A: Ọ bụrụ na ị hụ njehie a:
FAIL test/ui.test.js Test suite agaghị agba ọsọ a chịkọtara modul 'canvas.node' megide ụdị Node.js dị iche site na iji NODE_MODULE_VERSION 80. Ụdị Node.js a chọrọ NODE_MODULE_VERSION 72. Biko nwaa ịtụgharị ma ọ bụ tinyegharịa site na iji `npm'n'n'atụ.
na Ihe. ( node_modules/canvas/lib/bindings.js:3 18)
wee gbaa ọsọ: npm wughachi canvas -update-binary
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
10/35
ZAP ntọala
ZCL/Data-Model ZAP Fundamentals
Akụkụ a nwere ozi maka ndị ọrụ ZAP ọhụrụ. Pịa akara ngosi nkuzi dị n'akụkụ aka nri elu nke ZAP UI, nke na-egosi otu esi emepụta nhazi ZAP. Nkuzi a ga-eduzi gị site na ihe ndị a: Mepụta njedebe njedebe Họrọ ụdị ngwaọrụ Hazie ụyọkọ Hazie àgwà Hazie iwu Maka ntụnye nkọwa zuru ezu, lee Ntuziaka nhazi nhazi nke Zigbee Cluster Configurator
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
11/35
Ntuziaka onye ọrụ ZAP
Ntuziaka onye ọrụ ZAP
Ntuziaka onye ọrụ ZAP
Akụkụ ndị dị n'okpuru ntuziaka a na-enye nkọwa ndị ọzọ gbasara njirimara dị iche iche nke ZAP nyere.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
12/35
Omenala XML
Na-agbakwụnye XML omenala site na ZAP UI
Pịa akara ngosi "Extensions" na ZAP UI. Pịa bọtịnụ mgbakwunye "+" ka ịhọrọ xml omenala file Ụyọkọ omenala, njirimara, iwu, wdg kwesịrị ịpụta na ZAP UI ozugbo agbakwunyere xml omenala.
Ịmepụta XML nke gị na Zigbee
Akụkụ a na-egosi otu esi emepụta ụyọkọ omenala nke gị wee gbasaa ụyọkọ ọkọlọtọ dị ugbu a nwere njirimara na iwu maka Zigbee.
Ụyọkọ ndị nrụpụta kpọmkwem na Zigbee
Ị nwere ike ịgbakwunye ụyọkọ ndị nrụpụta na ọkọlọtọ ọkọlọtọfile. Anyị na-enye example nke a n'okpuru. Iji mee nke a, ị ga-emerịrị ọrụ abụọ:
NJ ụyọkọ ahụ aghaghị ịdị na nso nso a na-emepụta ihe, 0xfc00 - 0xffff. Nkọwa ụyọkọ ahụ ga-agụnye koodu nrụpụta nke a ga-etinye na njirimara na iwu niile dị n'ime ụyọkọ ahụ ma a ga-enyerịrị ya mgbe ị na-eziga na ịnata iwu yana imekọrịta ihe na njirimara. ỌpụampLe:
Sample Mfg Specific ụyọkọ Izugbe Ụyọkọ a na-enye exampOtu esi agbatị ngwa Framework ka ọ gụnyere ụyọkọ ndị nrụpụta kpọmkwem.
0xFC00
mber sample àgwà
mber sample àgwà 2
A sample emeputa-kpọmkwem iwu n'ime sample emeputa-kpọmkwem
ụyọkọ.
Iwu ndị nrụpụta kpọmkwem na ụyọkọ Zigbee ọkọlọtọ
Ị nwere ike itinye iwu nke gị na ụyọkọ Zigbee ọkọlọtọ ọ bụla nwere ihe ndị a chọrọ:
Iwu ndị nrụpụta gị nwere ike iji id iwu ọ bụla n'ime oke id iwu, 0x00 – 0xff. Ị ga-ewetakwa koodu nrụpụta maka iwu ahụ ka e wee nwee ike ịpụ iche na iwu ndị ọzọ dị na ụyọkọ ahụ ma mee ya nke ọma. Ọpụampnke ịgbatị ụyọkọ ngbanyụ/ gbanyụọ site na iji iwu nrụpụta:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
13/35
Omenala XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition" nhọrọ ="ezi" manufacturerCode="0 1002″> Iwu onye ahịa na-agbanyụ ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificOnWithTransition" nhọrọ ="ezi" manufacturerCode="0 1002″> Iwu onye ahịa nke na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificToggleWithTransition" nhọrọ ="ezi" manufacturerCode ="0 1002″> Iwu onye ahịa na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificOnWithTransition2″ nhọrọ =”ezi” manufacturerCode=”0 1049″> Iwu onye ahịa nke na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificToggleWithTransition2″ nhọrọ ="eziokwu"
emeputaCode=”0 1049″> Iwu onye ahịa na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.
Àgwà ndị nrụpụta kpọmkwem na ụyọkọ Zigbee Standard
Ị nwere ike itinye njirimara nke gị na ụyọkọ Zigbee ọkọlọtọ ọ bụla nwere ihe ndị a chọrọ:
Àgwà ndị nrụpụta gị akọwapụtara nwere ike iji njirimara njirimara ọ bụla n'ime ogo njirimara njirimara, 0x0000 - 0xffff. Ị ga-ewetakwa koodu nrụpụta maka njirimara ahụ ka e wee nwee ike ịpụ iche na njirimara ndị ọzọ dị na ụyọkọ ahụ ma mee ya nke ọma. Ọpụample nke ịgbatị ụyọkọ ngbanyụ / gbanyụọ nwere njirimara nrụpụta:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” ụdị =”INT16U” nkeji =”0 0000″
max = "0xFFFF" e dere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" manufacturerCode = "0 1002"> Sample Mfg Specific àgwà: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ ụdị = "INT8U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" emeputaCode = "0 1049"> Sample Mfg Specific àgwà: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ ụdị = "INT8U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 00" nhọrọ = "ezi" emeputaCode = "0 1002"> Sample Mfg Specific àgwà: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ ụdị = "INT16U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" emeputaCode = "0 1049"> Sample Mfg Specific àgwà: 0 0001 0 1040
Ịmepụta XML omenala nke gị na Matter
Akụkụ a na-egosi otu esi emepụta ụyọkọ omenala nke gị ma gbasaa ụyọkọ ọkọlọtọ dị ugbu a nwere njirimara omenala na iwu maka Matter.
Ụyọkọ ndị nrụpụta kpọmkwem n'ihe
Ị nwere ike itinye ụyọkọ ndị nrụpụta kpọmkwem na Matter. Anyị na-enye example nke a n'okpuru.
Nke a 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.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
14/35
Omenala XML
Na ndị na-esonụ example, nchikota nke NJ onye na-ere ihe (NJ onye nrụpụta ule) nke 0xFFF1 na ID ụyọkọ nke 0xFC20 na-arụpụta value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. ExampLe:
Izugbe Sampna MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Ihe SampỤyọkọ MEI na-egosi ndọtị ndị nrụpụta ụyọkọ Slịpas
Azịza maka AddArguments na-eweghachi nchikota. Iwu nke na-ewe arụmụka uint8 abụọ wee weghachi nchikota ha. Iwu dị mfe na-enweghị paramita ọ bụla na enweghị nzaghachi.
Àgwà ndị nrụpụta-kpọmkwem na Ụyọkọ Matter Standard
Ị nwere ike ịgbakwunye njirimara ndị nrụpụta kpọmkwem na ụyọkọ ihe ọ bụla nwere ihe ndị a chọrọ:
T aaaa ọ ụyọkọ nke a ga-akọwapụtarịrị n'ụkpụrụ ndị a na-agbakọ.
e xte nd ed >>>
Koodu njirimara ahụ bụ ngwakọta 32-bit nke koodu nrụpụta yana id maka njirimara. Ihe kacha mkpa 16 bits bụ koodu nrụpụta. Oke maka koodu nrụpụta ule bụ 0xFFF1 – 0xFFF4. Nke kacha nta 16 ibe n'ibe bụ njirimara njirimara. Oke maka njirimara na-abụghị nke ụwa bụ 0x0000 - 0x4FFF.
Exampnke ịgbatị ụyọkọ On/ Gbanyụọ ihe nwere njirimara arụpụtara akọwapụtara:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ ụdị =”INT8U” nkeji =”0 0000″
max=”0xFFFF” dere =”ezigbo” ndabara=”0 0000″ nhọrọ =”ezi”>Sample Mfg Specific Njirimara 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ ụdị =”INT16U” nkeji =”0 0000″
max=”0xFFFF” dere =”ezigbo” ndabara=”0 0000″ nhọrọ =”ezi”>Sample Mfg Specific Njirimara 4
Iwu ndị nrụpụta-kpọmkwem na Ụyọkọ Matter Matter
Ị nwere ike ịgbakwunye iwu ndị nrụpụta kpọmkwem na ụyọkọ ihe ọ bụla nwere ihe ndị a chọrọ:
T aaaa ọ ụyọkọ nke comm ndị a na-ederede ka ọ ga-akọwarịrị -
e xte nd ed >>>
Koodu nke iwu ahụ bụ ngwakọta 32-bit nke koodu nrụpụta yana id maka iwu ahụ. Ihe kacha mkpa 16 bits bụ koodu nrụpụta. Oke maka koodu nrụpụta ule bụ 0xFFF1 – 0xFFF4. Nke kacha nta dị mkpa 16 bit bụ ID iwu. Oke maka iwu na-abụghị nke ụwa bụ 0x0000 - 0x00FF.
Exampnke ịgbatị ụyọkọ On/ Gbanyụọ ihe nwere ụyọkọ arụpụtara akọwapụtara:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
15/35
Omenala XML
<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ nhọrọ =”eziokwu”> Iwu onye ahịa nke na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ nhọrọ =”eziokwu”>
Iwu onye ahịa na-atụgharị ngwaọrụ ahụ site na mgbanwe nke oge mgbanwe nyere na Ember Sample mgbanwe oge àgwà.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
16/35
Akwụkwọ na-esonụ na-ekwu maka xml nke ọ bụla tags jikọtara ya na Zigbee.
xml nke ọ bụla file edepụtara n'etiti onye nhazi tags:
Enwere ike ịkọwa ụdị data n'ime nhazi tag. Zigbee ugbu a na-akwado nkọwapụta nke bitmaps, enums, integers, eriri ma ọ bụ nhazi. Tupu ịkọwapụta ụdịdị ndị ọzọ hụ na ịlele ụdị atomic niile dị adị akọwapụtara na ụdị.xml yana ụdị niile na-abụghị atọ akọwapụtara na xml ọzọ. files. Ị nwere ike ịkọwa ha dịka ndị a:
Bitmap: aha: aha ụdị bitmap. ụdị: Bitmap nwere nha n'etiti 8-64 bits nwere ike ịkọwa, ihe niile kwesịrị ịbụ ọnụọgụ nke 8. Bitmap ọ bụla nwere ike inwe ọtụtụ ubi nwere aha na ihe nkpuchi jikọtara ya. eg:
"'
Enum: aha: aha ụdị enum. ụdị: Enum nwere nha n'etiti 8-64 bits nwere ike ịkọwa, ihe niile kwesịrị ịbụ ọnụọgụ nke 8. Enum ọ bụla nwere ike ịnwe ọtụtụ ihe nwere aha na uru metụtara ya. eg:
Integer: A kọwapụtalarị ụdị integer n'okpuru ụdị atọm nke dị na ụdị.xml. Ogo ha nwere ike ịdị site na ibe 8-64 ma enwere ike ịbanye ma ọ bụ debanye aha ya. eg:
Ụdọ: A kọwapụtalarị ụdị eriri n'okpuru ụdị atọm nke dị na ụdị.xml. Ụdị eriri dị ugbu a gụnyere eriri octet, eriri char, eriri octet ogologo na eriri cha ogologo dịka:
Struct: aha: aha ụdị struct. Nhazi ọ bụla nwere ike ịnwe ọtụtụ ihe nwere aha yana ụdị jikọtara ya na ya. Ụdị ahụ nwere ike ịbụ ụdị ọ bụla eburu ụzọ kọwaa n'okpuru ụdị data. eg:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
17/35
Omenala XML Tags maka Zigbee
<item name=”structItem1″ type=” Any defined type name in the xml files]"/>
Enwere ike ịkọwa ụyọkọ omenala n'ime nhazi tag. aha: aha ngalaba ụyọkọ: ngalaba nke ụyọkọ. Ụyọkọ ahụ ga-apụta na ZAP UI n'okpuru ngalaba a. nkọwa: Nkọwa nke koodu ụyọkọ: koodu ụyọkọ kọwapụta: ụyọkọ kọwapụta nke ejiri koodu generator kọwaa ụyọkọ n'otu ụzọ manufacturerCode: A na-eji kọwaa ụyọkọ n'ichepụta kpọmkwem. Nke a ga-adị n'etiti 0xfc00 - 0xffff. Ekwesịrị ịkọwa koodu nrụpụta maka ụyọkọ dị ka ndị a:
Otu ụyọkọ n'ichepụta na-akpaghị aka na njirimara na iwu n'okpuru ya nke otu koodu nrụpụta belụsọ na ha depụtara koodu nrụpụta nke ọma. ewebataIn: Ejiri iji chọpụta ụdịdị nke ewebata ụyọkọ ahụ. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. RemoveIn: Eji iji chọpụta ụdịdị nke ewepụrụ ụyọkọ ahụ. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. singleton(boolean): A na-eji achọpụta ụyọkọ dị ka singleton nke mere na enwere naanị otu ihe atụ nke ụyọkọ ahụ na-ekekọrịta n'ofe njedebe. àgwà: na-akọwapụta àgwà maka ụyọkọ aha: Aha njirimara ka ekwuru n'etiti àgwà. tag.
aha njirimara
akụkụ(onye ahịa/ihe nkesa): Akụkụ ụyọkọ nke ejikọrọkwa àgwà ahụ. koodu: koodu mmepụta koodu: Enwere ike iji nke a kọwapụta njirimara onye nrụpụta na mpụga zigbee nkọwapụta nke xml ọkọlọtọ kwuru. kọwaa: àgwà kọwaa nke onye na-emepụta koodu na-eji kọwaa àgwà n'otu ụzọ ụdị: ụdị nke nwere ike ịbụ ụdị data ọ bụla a kpọtụrụ aha na ndabara xml: uru ndabara maka àgwà ahụ. min: Opekempe anabatara maka njirimara kacha: Uru kacha anabata maka njirimara enwere ike ede: Ọ bụ uru edere ma ọ bụ na ọ bụghị. Enwere ike iji nke a gbochie àgwà a site n'iwu ederede gbanwee. nhọrọ(boolean): A na-eji iji chọpụta ma àgwà ọ bụ nhọrọ ma ọ bụ na ọ bụghị maka ụyọkọ. min: Uru kacha nta anabatara maka njirimara mgbe ọ bụ integer, enum ma ọ bụ ụdị bitmap. max: Oke ekwere uru maka àgwà mgbe ọ bụ integer, enum ma ọ bụ bitmap ụdị ogologo: A na-eji ezipụta ogologo ogologo nke àgwà mgbe ọ bụ nke ụdị eriri. Ogologo ogologo: A na-eji ezipụta ogologo kacha nta nke njirimara mgbe ọ bụ ụdị eriri. reportable(boolean): Na-agwa ma ọ bụrụ na njirimara nwere ike ịkọ ma ọ bụ na ọ bụghịNullable(boolean): Na-enye ụkpụrụ efu maka njirimara ahụ. array(boolean): A na-eji ekwupụta njirimara ụdị array. InwetaIn: A na-eji achọpụta ụdịdị nke ewebata njirimara a. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. RemoveIn: A na-eji iji chọpụta ụdịdị nke ewepụrụ njirimara ahụ. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. iwu: kọwaa iwu maka aha ụyọkọ: Aha iwu.
koodu: iwu koodu
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
18/35
Omenala XML Tags maka Zigbee
koodu nrụpụta: Enwere ike iji nke a kọwapụta iwu onye nrụpụta na-abụghị nkọwa zigbee nke ọkọlọtọ xml kwuru. nkọwa: nkọwa nke isi iyi (onye ahịa / nkesa): isi iyi nke iwu. nhọrọ(boolean): A na-eji iji chọpụta ma iwu ọ bụ nhọrọ ma ọ bụ na ọ bụghị maka ụyọkọ. InwetaIn: A na-eji achọpụta ụdịdị nke ewebata iwu ahụ. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. RemoveIn: Eji iji chọpụta ụdịdị nke ewepụrụ iwu ahụ. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. arụmụka iwu:
Iwu ọ bụla nwere ike ịnwe aha arụmụka iwu: aha ụdị arụmụka iwu: ụdị arụmụka iwu nke nwere ike ịbụ ụdị ọ bụla a kpọtụrụ aha na xml. min: Uru kacha nta anabatara maka arụmụka mgbe ọ bụ integer, enum ma ọ bụ ụdị bitmap. max: Oke ekwere uru maka arụmụka mgbe ọ bụ integer, enum ma ọ bụ bitmap ụdị ogologo: A na-eji ezipụta ogologo ikike ogologo maka arụmụka iwu mgbe ọ bụ ụdị eriri. Ogologo ogologo: A na-eji ezipụta ogologo opekempe anabatara maka arụmụka iwu mgbe ọ bụ ụdị eriri. array(boolean): Iji chọpụta ma arụmụka iwu bụ ụdị array. presentIf (eriri): Nke a nwere ike ịbụ eriri ọnọdụ nke arụmọrụ ezi uche dabere na arụmụka iwu ndị ọzọ ebe ị nwere ike ịtụ anya arụmụka iwu ma ọ bụrụ na eriri ọnọdụ na-atụle eziokwu. eg:
Mara: Ebe a ọkwa bụ aha arụmụka iwu ọzọ. nhọrọ(boolean): A na-eji achọpụta arụmụka iwu dịka nhọrọ. countArg: A na-eji ya mgbe arụmụka iwu bụ ụdị array. A na-eji nke a kọwaa arụmụka iwu ọzọ nke na-egosi nha nhazi maka arụmụka a.
InwetaIn: A na-eji achọpụta ụdịdị nke ewebata arụmụka iwu. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. RemoveIn: A na-eji iji chọpụta ụdịdị akọwapụtara nke ewepụrụ arụmụka iwu. Nke a na-eji koodu generator tinye mgbakwunye mgbagha. Enwere ike ịkọwa ndọtị ụyọkọ n'ime nhazi tag. A na-eji ndọtị ụyọkọ gbatịa ụyọkọ ọkọlọtọ nwere njirimara na iwu dịka
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
19/35
Omenala XML Tags maka Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME" ụdị = "INT16U" min = "0 0000" max = "0xFFFF" e dere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" manufacturerCode = "0 1002"> Sample Mfg Specific àgwà: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ ụdị = "INT8U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" emeputaCode = "0 1049"> Sample Mfg Specific àgwà: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ ụdị = "INT8U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 00" nhọrọ = "ezi" emeputaCode = "0 1002"> Sample Mfg Specific àgwà: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ ụdị = "INT16U" min = "0 0000" max = "0xFFFF" edere = "eziokwu" ndabara = "0 0000" nhọrọ = "ezi" emeputaCode = "0 1049"> Sample Mfg Specific àgwà: 0 0001 0 1040ampleMfgSpecificOffWithTransition" nhọrọ ="ezi" manufacturerCode="0 1002″> Iwu onye ahịa na-atụgharị ngwaọrụ site na iji mgbanwe enyere
Site na oge mgbanwe na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificOnWithTransition" nhọrọ ="ezi" manufacturerCode="0 1002″> Iwu onye ahịa nke na-agbanye ngwaọrụ site na ngbanwe enyere
Site na oge mgbanwe na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificToggleWithTransition" nhọrọ ="ezi" manufacturerCode ="0 1002″> Iwu onye ahịa nke na-atụgharị ngwaọrụ ahụ site na iji mgbanwe enyere
Site na oge mgbanwe na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificOnWithTransition2″ nhọrọ =”ezi” manufacturerCode=”0 1049″> Iwu onye ahịa nke na-agbanye ngwaọrụ site na ngbanwe enyere
Site na oge mgbanwe na Ember Sample mgbanwe oge àgwà.ampleMfgSpecificToggleWithTransition2″ nhọrọ =”ezi” emeputaCode=”0 1049″> Iwu onye ahịa nke na-atụgharị ngwaọrụ ahụ site na iji mgbanwe enyere
Site na oge mgbanwe na Ember Sample mgbanwe oge àgwà.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
20/35
Ụdị Ngwaọrụ Otutu Kwa ngwụcha ngwụcha
Nke a bụ njirimara naanị ihe ebe onye ọrụ nwere ike họrọ ihe karịrị otu ụdị ngwaọrụ kwa njedebe. Mgbakwunye nke ọtụtụ ụdị ngwaọrụ aaa ga-agbakwunye nhazi ụyọkọ n'ime ụdị ngwaọrụ ahụ na nhazi njedebe njedebe.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
21/35
Ụdị Ngwaọrụ Otutu Kwa ngwụcha ngwụcha
Foto dị n'elu na-egosi na njedebe 1 nwere ihe karịrị otu ụdị ngwaọrụ ahọpụtara. “Ngwaọrụ izizi” na-egosi ụdị ngwaọrụ izizi nke a ga-ejikọta ya na njedebe. Ụdị ngwaọrụ bụ isi na-adị mgbe niile na ndeksi 0 nke ndepụta ụdị ngwaọrụ ahọpụtara ka ịhọrọ ụdị ngwaọrụ dị iche iche ga-agbanwe nhazi ụdị ngwaọrụ ahọpụtara. Nhọrọ ụdị ngwaọrụ ahụ nwekwara mgbochi dabere na nkọwapụta Model Data. ZAP na-echebe ndị ọrụ site na ịhọrọ nchikota ụdị ngwaọrụ ezighi ezi na njedebe n'iji mmachi ndị a.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
22/35
Ibe Njirimara Ụdị Ngwa
Ibe Njirimara Ụdị Ngwa
Ibe Njirimara Ụdị Ngwa
ZAP na-akwado ịhụ anya na ịtụgharị atụmatụ Matter na ibe njirimara ngwaọrụ. Naanị njirimara ụdị ngwaọrụ akọwapụtara na matter-devices.xml na ebe nchekwa CHIP ka a ga-egosipụta.
Na-agagharị na ibe njirimara
ò Mepee ZAP in Matter nwere ihe ọhụrụ SDK. ó Mepụta ebe njedebe na ụdị ngwaọrụ Matter. Pịa bọtịnụ Ụdị Ngwaọrụ dị n'elu etiti ụyọkọ ahụ view. Mara na bọtịnụ a dị naanị na ZAP
nhazi maka Matter na mgbe data nkwenye dị na Matter SDK. Ịpị bọtịnụ a ga-emepe foto dị n'elu.
Nkwekọrịta
Conformance na-akọwa nhọrọ na ndabere maka njirimara, iwu, mmemme na ụdị data. Ọ na-ekpebi ma mmewere ọ bụ iwu, nhọrọ, ma ọ bụ enweghị nkwado n'okpuru ụfọdụ nhazi ZAP.
Nkwekọrịta njirimara ụdị ngwaọrụ na-ebute ụzọ karịa njirimara njirimara ụyọkọ. Maka exampYabụ, njirimara ọkụ ahụ nwere nkwenye nhọrọ na ụyọkọ On/ Gbanyụọ mana ekwuputara ya dị ka iwunyere n'ụdị ngwaọrụ On/ Gbanyụọ nke na-agụnye ụyọkọ ngbanwu/ Gbanyụọ. Ịmepụta njedebe na ụdị ngwaọrụ On / Gbanyụọ ga-egosi njirimara ọkụ dị ka iwu na ibe njirimara.
Ntụgharị atụmatụ
Na ibe njirimara, ka ị pịa bọtịnụ ntụgharị iji mee ma ọ bụ gbanyụọ atụmatụ, ZAP ga-:
Melite ihe ndị emetụtara (njirimara, iwu, mmemme) iji mezie nkwenye, wee gosipụta mkparịta ụka na-egosi mgbanwe.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
23/35
Ibe nrụpụta Ụdị Ngwaọrụ Melite ntakịrị ihe dị na njirimara Map nke ụyọkọ jikọtara
Kwado mkparịta ụka atụmatụ
Gbanyụọ mkparịta ụka atụmatụ
Agbanyụrụ ntugharị maka ụfọdụ atụmatụ mgbe nkwenye ha nwere uru amaghi ama ma ọ bụ ụdị na-akwadoghị ugbu a t. Na nke a ac se, ZAP ga-egosi ịdọ aka ná ntị na ngosi ap ne.
a Wa Element Conform nce rnings
Mgbe ị na-atụgharị ihe mmewere, ZAP nwere ike igosipụta ịdọ aka ná ntị nnabata ngwaọrụ yana ịdọ aka ná ntị nkwenye. Ọ bụrụ na steeti mmewere adabaghị nkwekọ a na-atụ anya ya, ZAP ga-egosipụta akara ngosi ịdọ aka na ntị wee banye na ịdọ aka ná ntị na ngosi ap ne. Ọpụampnke ma nrube isi na ịdọ aka ná ntị nkwenye egosipụtara maka mmewere:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
24/35
Amamọkwa
Amamọkwa
Amamọkwa
Akụkụ na-esonụ na-akọwa otu esi enye ndị ọrụ ZAP ozi na UI.
Amamọkwa ngwugwu
Ọkwa ngwungwu bụ ịdọ aka na ntị ma ọ bụ ozi mperi jikọtara maka ngwugwu ọ bụla akọwapụtara na ZAP. Maka examplee, na onyonyo dị n'okpuru, ịpị akara ngosi ịdọ aka na ntị n'okpuru kọlụm ọkwa ga-eduga gị na mkparịta ụka na-egosi ọkwa niile maka ngwugwu ahụ.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
25/35
Amamọkwa
Ịmakwa Ọkwa
Ịma ọkwa nnọkọ bụ ịdọ aka ná ntị ma ọ bụ ozi mperi nke ejikọtara na nnọkọ onye ọrụ. Enwere ike ịhụ ịdọ aka ná ntị/mmehie ndị a site na ịpị bọtịnụ ngosi dị na toolbar dị n'elu ZAP UI. Maka examplee, foto dị n'okpuru na-egosi ibe ngosi nnọkọ mgbe isc gasịrị file etinyere na ZAP.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
26/35
Ndabere nkọwapụta data-Model/ZCL
Ndabere nkọwapụta data-Model/ZCL
Ihe nlere data na nnabata nkọwapụta ZCL
Njirimara a dị na ZAP na-enyere ndị ọrụ aka ịhụ ọdịda nnabata maka Model Data ma ọ bụ ZCL na nhazi ZAP ha dị. Ozi ịdọ aka ná ntị maka ọdịda nrube isi ga-apụta na pane ngosi dị na ZAP UI ma a ga-abanyekwa na njikwa mgbe ị na-agba ZAP site na CLI. Njirimara nnabata ugbu a na-enye ịdọ aka ná ntị maka nnabata ụdị ngwaọrụ yana nnabata ụyọkọ na njedebe njedebe.
Ịdọ aka ná ntị nnabata na ZAP UI
Mgbe onye ọrụ mepere .zap file iji ZAP UI ha ga-ahụ ịdọ aka ná ntị na pane ngosi nke ZAP UI maka ọdịda nnabata niile. Maka examplee, foto dị n'okpuru na-egosi ibe ngosi nnọkọ mgbe .zap gasịrị file ejiri okwu nnabata meghere.
Ozi nnabata ga-apụ ozugbo edozi nsogbu ahụ site na iji ZAP UI nke na ị nwere ike idobe naanị nsogbu nnabata ndị fọdụrụ. Ịdọ aka ná ntị ọhụrụ ga-egosikwa maka nnabata ma ọ bụrụ na onye ọrụ gbanyụọ ihe amanyere iwu (ụyọkọ/iwu/ njirimara) nke nhazi ahụ. Ọkwa nrubeisi nkọwapụta ga na-echekwa ọdịda ọ bụla ewebatara na nhazi ZAP mana mara na ịdọ aka ná ntị ndị na-egosi n'oge mmeghe nke .zap. file kọwakwuru ihe kpatara na ọ dara nrube isi ma e jiri ya tụnyere ịdọ aka ná ntị ndị na-egosi mgbe ya na UI na-emekọrịta ihe. Nke a bụ site na imewe na a na-eme nlele nnabata zuru oke n'oge mmeghe nke .zap file.
Ịdọ aka ná ntị nnabata na njikwa
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
27/35
Ndabere nkọwapụta data-Model/ZCL
Mgbe onye ọrụ mepere .zap file na-eji ZAP standalone UI ma ọ bụ ZAP CLI ha ga-ahụ ịdọ aka ná ntị abanyela na njikwa/terminal maka ọdịda nnabata niile. Maka examplee, foto dị n'okpuru na-egosi ịdọ aka ná ntị ngosi nnọkọ na console/terminal mgbe .zap gasịrị file ejiri okwu nnabata meghere.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
28/35
Njikwa nnweta
Njirimara njikwa nweta
ZAP na-akwado njikwa ịnweta na ụlọ ọrụ ZCL niile. Ọ gbadara na mmejuputa SDK iji mapụta atụmatụ ndị a na njirimara njikwa ohere SDK achọrọ yana akwadoro. ZAP na-enyekarị ụdị data yana usoro iji tinye ya na ozi meta files wee gbasaa data ahụ na ndebiri ọgbọ, na-ekenyeghị nkọwa akọwapụtara na isi data.
Usoro ntọala
Njikwa nnweta ZAP na-akọwa usoro ntọala atọ, dị ka ndị a: ò arụmọrụ : akọwara dị ka ihe nwere ike ime. Ọpụample: gụọ, dee, ịkpọku. ọ ọrụ: akọwara dị ka ihe ùgwù nke onye na-eme ihe nkiri. Dị ka "View ihe ùgwù”, “Ọrụ nchịkwa”, na nwa gara n'ihu. ô modifiers: akọwara dị ka ọnọdụ njikwa ohere pụrụ iche, dị ka data nwere mmetụta akwa ma ọ bụ data kpara akpa. A kọwapụtara usoro ntọala na XML metadata n'okpuru elu tag . Ihe na-esonụ bụ exampnkọwa okwu ntọala nke ohere nchịkwa:
<role type=”view"nkọwa ="View ihe ùgwù”/>
Nke a example na-akọwapụta arụmọrụ atọ, gụọ, dee na ịkpọku, ihe mgbanwe abụọ na ọrụ anọ.
Nweta Triplets
Enwere ike ịkọwa ọnọdụ ịnweta onye ọ bụla site na iji ohere atọ dị na XML. Access triplet bụ ngwakọta nke ọrụ, ọrụ na mgbanwe. Ha bụ nhọrọ, yabụ ị nwere ike ịnwe naanị otu n'ime ndị a. Akụkụ atọ na-efu efu n'ozuzu pụtara ikike, nke bụ mmejuputa-kpọmkwem maka SDK enyere. Ụlọ ọrụ na-akọwa ohere ya nwere ike ịnweta otu ma ọ bụ karịa ohere atọ. Ihe na-esonụ bụ exampLe:
na0
Nke a bụ nkọwa nke àgwà nwere ohere ụzọ atọ, na-ekwupụta na ọ na-enye ohere ide ihe site n'ọrụ jikwaa, na-eji ihe ngbanwe nke akwa ákwà tinye.
Ikikere ndabara
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
29/35
Njikwa nnweta
Ụlọ ọrụ ZCL nwere ike ịkọwa ikike nke onwe ha. Agbanyeghị, enwekwara nkọwa zuru ụwa ọnụ nke ikike ndabara maka
nyere ụdị. A na-ewere ihe ndị a maka ụlọ ọrụ enyere, belụsọ na ọ na-enye ikike nke ya kpọmkwem.
A na-ekwupụta ikike izizi site na a tag n'ọkwa dị elu nke XML file. ỌpụampLe:
aa a<ccess op=”kpọku”/> a a aa <ccess op=”re d”/> a<ccess op=”dee”/> a aa aa <ccess op=”re d” role=”view”/> aa <ccess op=”dee” role=”oper te”/> a
Ndị enyemaka template
Ihe enyemaka template ga-eji bụ {{#access}} … {{/access}} iterator. Nke a na-ekwughachi ugboro atọ karịa ohere ọ bụla enyere.
Ọ na-akwado nhọrọ abụọ a:
entity=”njirimara/iwu/mmemme” – ma ọ bụrụ na ụlọ ọrụ enweghị ike ikpebi site na onodu ya, nke a na-esetịpụ ụdị ihe ahụ. gụnyere Default=”ezi/ụgha” – na-ekpebi ma agụnyere ụkpụrụ ndabara ma ọ bụ na etinyeghị ya. Ihe na-esonụ bụ exampLe:
{{#zcl_clusters}}
ụyọkọ: {{n me}} [{{code}}] a {{#zcl_ tributes}} 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}} [{{code}} cm entity {{n me}} [{{code}} cm entity" {} p: {{operation}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – omume: {{n me}} [{{code}}] a {{# ccess entity="omume"}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}}
{{/zcl_events}}
{{/zcl_clusters}}
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
30/35
Ewelite ZAP maka ngwa Matter ma ọ bụ Zigbee
Ewelite ZAP maka ngwa Matter ma ọ bụ Zigbee
Ewelite ZAP maka ngwa Matter ma ọ bụ Zigbee
Akụkụ ndị a na-akọwa ibido ZAP na ọnọdụ kwụụrụ onwe ya site na iji metadata akọwapụtara ma ọ bụ Zigbee. Echiche bụ ịmalite ZAP na arụmụka ziri ezi metụtara XML metadata (ụyọkọ na nkọwa ụdị ngwaọrụ dịka nkọwapụta CSA si dị) na ndebiri ọgbọ, nke a na-eji emepụta koodu kwesịrị ekwesị.
Iji Matter malite ZAP
Edemede na-esote na-eburu metadata ziri ezi site na Matter SDK mgbe ị na-ebupute ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Cheta na: Ị nwekwara ike were usoro Zigbee ndị a iji malite ZAP na Matter.
Iji Zigbee malite ZAP
Iwu na-esonụ na-ebupụta ZAP na nkọwa ZCL na ndebiri ọgbọ sitere na SDK.
[zap-ụzọ] -z [sdk-ụzọ]/gsdk/app/zcl/zcl-zap.json -g [sdk-ụzọ]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
zap-ụzọ: Nke a bụ ụzọ isi iyi ZAP ma ọ bụ sdk-ụzọ a na-arụ ọrụ: Nke a bụ ụzọ SDK.
Na-amalite ZAP na-enweghị metadata
Cheta na mgbe ịmalitere ZAP ozugbo site na arụ ọrụ ma ọ bụ site na isi mmalite site na iji npm run zap ị na-ebupụta ZAP na metadata nnwale maka Matter/Zigbee wuru n'ime ZAP ma ọ bụghị metadata n'ezie na-abịa site na Matter na Zigbee SDK ndị a kpọtụrụ aha n'elu. Ya mere, cheta ịmepụta nhazi ZAP gị site na iji metadata SDK ọ bụghị site na imepe ZAP ozugbo site na iji metadata ule arụnyere.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
31/35
Na-emepụta koodu maka Matter ma ọ bụ Zigbee
Koodu na-emepụta maka ihe, Zigbee ma ọ bụ SDK omenala
Akụkụ ndị a na-akọwa otu esi emepụta koodu site na iji ZAP.
Mepụta koodu Iji ZAP UI
Mwepụta ZAP UI dị ka ntuziaka dị na Mwepụta ZAP maka Matter ma ọ bụ Zigbee wee pịa bọtịnụ Mepụta n'elu mmanya menu.
Mepụta koodu na-enweghị UI
Ntuziaka ndị a na-enye ụzọ dị iche iche nke ịmepụta koodu site na CLI na-ebughị ZAP UI.
Koodu na-emepụta site na isi mmalite ZAP
Gbaa iwu a ka ịmepụta koodu site na iji ZAP site na isi iyi: 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
Koodu na-emepụta site na ZAP Executable
Gbaa iwu na-esonụ ka ịmepụta koodu site na iji ZAP executable: [zap-path] generate -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
Koodu na-emepụta site na ZAP CLI Executable
Gbaa iwu na-esonụ iji mepụta koodu site na iji ZAP CLI Executable: [zap-cli-path] mepụta -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
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
32/35
Melite ZAP na Studio
Melite ZAP
Melite ZAP na Studio Simplicity
Enwere ike iji usoro a mgbe ị na-arụ ọrụ na ndọtị Matter ma ọ bụ Zigbee sitere na mwepụta Silicon Labs SDK. Enwere ike imelite ZAP n'ime Simplicity Studio na-enweghị ntọhapụ Simplicity Studio site na nbudata ZAP executable kachasị ọhụrụ (atụ aro) ma ọ bụ ịdọrọ nke kachasị ọhụrụ site na isi ZAP dị ka egosiri na ntuziaka nwụnye ZAP. Mgbe ị nwetachara ZAP kachasị ọhụrụ dabere na OS ị na-eji ugbu a, ị nwere ike imelite ZAP n'ime Studio dị ka mkpọ nkwụnye ọkụ. Soro ntuziaka dị n'okpuru mgbe nbudata ZAP kachasị ọhụrụ:
Gaa na Studio Simplicity wee họrọ Mmasị> Studio dị mfe> ngwugwu nkwụnye. Pịa Tinye… wee chọgharịa na nchekwa ZAP gbasaara ị ibudatara wee pịa Họrọ nchekwa . Pịa Ngwa na mechie wee jiri ZAP agbakwunyere ọhụrụ ga-eji oge ọ bụla .zap file na-emeghe.
Mara: Mgbe ụfọdụ enwere ike ịnwe ụdị ZAP ochie na-agba ọsọ ọbụlagodi na emelitere ZAP kachasị ọhụrụ. Jide n'aka na ị kwụsịrị usoro ZAP niile dị ugbu a nke mere na ejiri ZAP ewepụtara ọhụrụ kama nke ochie, nke ka na-arụ ọrụ n'azụ.
Melite ZAP maka mmepe ihe na Github
Mgbe ị na-arụ ọrụ na Matter ma ọ bụ Matter-Silicon Labs repos na Github, tọọ mgbanwe gburugburu ebe obibi gbasara ZAP iji mepụta/mepụta nhazi ZAP ọhụrụ ma ọ bụ megharịa s dị adị.ample ZAP nhazi mgbe itinye mgbanwe na ha. Tọọ ZAP_DEVELOPMENT_PATH ka ọ bụrụ ZAP site na isi iyi site na ịdọrọ nke kachasị ọhụrụ ma ọ bụ tọọ ZAP_INSTALLATION_PATH ka ọ bụrụ ZAP executable nke ibudatara ikpeazụ na ndekọ mpaghara gị. Rịba ama na mgbe edobere ma ZAP_DEVELOPMENT_PATH na ZAP_INSTALLATION_PATH, a na-eji ZAP_DEVELOPMENT_PATH.
Ndị a bụ examples nke na-egosi mgbanwe gburugburu ebe obibi dị n'elu a na-eji:
Ewelite ZAP site na iji Matter nkọwapụta Na-eweghachi s niileampNhazi ZAP maka ngwa Matter
Mara: Mgbe ị na-eji ZAP executables, hụ na ị na-eji ntọhapụ gọọmentị maka ntọhapụ abalị maka nkwụsi ike ọzọ. Lee
Ịbudata ZAP Executable na ntuziaka nwụnye ZAP
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
33/35
Usoro ọtụtụ n'otu oge n'etiti Zigbee na Matter
Usoro ọtụtụ n'otu oge n'etiti Zigbee na Matter
MCoanttceurrrent Multi-protocol n'etiti Zigbee na
Enwere ike iji ZAP hazie nhazi ZCL (Zigbee) na Data-Model (Matter) na ngwa ọtụtụ protocol maka Zigbee na Matter. ZAP na-enye gị ohere ịmepụta ebe njedebe maka Zigbee na Matter n'ụzọ doro anya na otu nhazi ahụ file. Ọ bụrụ na njedebe Zigbee na Matter nọ n'otu njirimara njedebe (maka example, LO Dimmable Light on endpoint Id 1 na Matter Dimmable Light na ihe atụ ọzọ nke njedebe 1), ZAP na-ahụ maka ịmekọrịta njirimara nkịtị n'ofe Matter na Zigbee àgwà. Gbaa mbọ hụ na njirimara a na-emekọrịtara nwere otu ụdị data. Àgwà ọma ndị a na-ahụkarị n'etiti Zigbee na Matter ka edoro site na a file akpọrọ multi-protocol.json . Onye ọrụ nwere ike jikọta ụyọkọ abụọ ọ bụla gafee Zigbee na Matter yana njirimara ha kwekọrọ na iji ụyọkọ na koodu njirimara n'otu n'otu. Nke a file enwere ike ịhụ na [SDKPath]/app/zcl/multi-protocol.json. Nke a file ejiri ụfọdụ ụyọkọ na njirimara emelitere, mana onye ọrụ nwere ike imelite nke a file dị ka achọrọ na ZAP ga-elekọta nhazi nhazi njirimara n'ofe Zigbee na Matter maka njirimara njedebe njedebe.
Ị nwekwara ike ịhụ nkuzi ZAP na ngwa Zigbee na Matter multiprotocol ọ bụla n'okpuru ibe nkuzi. Nkuzi a ga-eduzi gị site na usoro imepụta ngwa ọtụtụ protocol. Nkuzi a dị naanị mgbe imepere ngwa ọtụtụ protocol dị adị ma enwere ike ịhụ ya dịka egosiri na foto dị n'okpuru:
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
34/35
Jikọta SLC CLI na ZAP
Jikọta SLC CLI na ZAP
Jikọta SLC CLI na ZAP
Soro usoro ndị a iji jikọta SLC CLI na ZAP: ọ Wụnye SLC CLI site n'ịgbaso ntuziaka nwụnye na Ntuziaka Onye Ọrụ Simplicity Studio 5. Wụnye ZAP site na isoro ntuziaka dị na ntuziaka nwụnye ZAP. Iji jikọta SLC CLI na ZAP, tinye mgbanwe gburugburu STUDIO_ADAPTER_PACK_PATH nke na-atụ aka na ngwa ZAP.
ndekọ. Cheta ịmalitegharịa SLC CLI Daemon mgbe nzọụkwụ 3 gasịrị. ö Ọrụ ọ bụla na-eji ZAP ga-eji ụzọ akọwapụtara na nzọụkwụ 3 mgbe emepụtara ya na SLC CLI. Biko rụtụ aka na SLC CLI
Ojiji maka ntuziaka maka iji SLC CLI maka ọrụ gị.
Nwebiisinka © 2025 Silicon Laboratories. Ikike niile echekwabara.
35/35
Akwụkwọ / akụrụngwa
![]() |
SILICON LABS ZAP Na-emepe na Silicon Labs [pdf] Akwụkwọ ntuziaka onye nwe ZAP Na-eji Silicon Labs na-emepe emepe, ZAP, Na-emepe na Silicon Labs, Silicon Labs, Labs |