ZAP Kugadzira NeSilicon Labs Muridzi Chinyorwa

ZAP Kutanga
- Kuti utange neZAP, tevera matanho aya:
  - Dhawunirodha iyo ZAP Inoitiswa kubva kune yepamutemo repository.
  - Isa zvinotsamira uchishandisa npm install command.
  - Pakuisa Windows-chaiwo, tarisa kuZAP Kuiswa kweWindows OS gwara.
Zigbee Development
- Kana iwe uri kugadzira Zigbee application:
  - Shandisa Simplicity Studio iyo inosanganisira ZAP uye mamwe maturusi anodiwa.
Matter Development
- Kana iwe uri kugadzira Matter application:
  - Sarudzo dzinosanganisira kushandisa Simplicity Studio kana kuwana iyo Silicon Labs kana CSA Github repositories.
  - Tarisa kune mirairo yekuvandudza yeZAP kunze kweSiplicity Studio kuburitswa kutenderera kana zvichidikanwa.

FAQs

Q: Ndeapi akasiyana mavhezheni eZAP mabhinari aripo?
- A: Pane mavhezheni maviri aripo - Kuburitswa zviri pamutemo neakasimbiswa anovaka uye pre-kuburitswa neazvino maficha.
Mubvunzo: Chii chandinofanira kuita kana ndikasangana nematambudziko ekuunganidza raibhurari panguva yekuisa?
- A: Tarisa kune iyo FAQ ruzivo nezve papuratifomu-chaiyo zvinyorwa kugadzirisa nyaya dzakadai.

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Kugadzira neSilicon Labs ZAP

Kutanga
ZAP Kutanga Patsvaview ZAP Kuisa ZAP Kuisa Windows FAQ
Zvinokosha ZAP Zvinokosha
Gwaro reMushandisi ZAP Mushandisi Wekushandisa Papfuuraview Tsika XML Tsika XML Tags yeZigbee Multiple Device Types Per Endpoint Matter Device Type Feature Peji Notifications Data-Model/ZCL Specification Compliance Access Control Kutangisa ZAP yeMatter kana Zigbee applications Kugadzira kodhi yeMatter kana Zigbee Update ZAP muStudio Concurrent Multi-protocol pakati peZigbee neMatter Integrate SLC CLI neZAPL CLI.

1/35

Kugadzira neSilicon Labs ZAP
Kugadzira neSilicon Labs ZAP
ZAP
ZAP igeneric code generation engine uye user interface yemaapplication nemaraibhurari yakavakirwa paZigbee Cluster Library kubva kuZigbee kana iyo Data Model kubva kuMatter. Iyo yakatarwa inogadzirwa neConnectivity Standards Alliance. ZAP inobvumidza iwe kuita zvinotevera mashandiro:
Ita SDK-chaiyo yakasarudzika chizvarwa chezvese zvigadzirwa zvepasirese (nguva dzose, mhando, maID, zvichingodaro) zvichibva pane iyo ZCL/Data-Model yakatarwa. Ita SDK-chaiyo yakagadziridzwa chizvarwa chese-yakasarudzwa-yakasarudzwa gadziriso artifacts (application configuration, endpoint configuration, zvichingodaro) zvichibva paZCL/Data-Model tsanangudzo uye mutengi-akapihwa application configuration. Ipa UI kune yekupedzisira-mushandisi kuti asarudze chaiyo application kumisikidza (yekupedzisira, masumbu, hunhu, mirairo, zvichingodaro).

Zviri muzvikamu izvi zvinotsanangura magadzirirwo eZigbee uye Matter maapplication nekugadzirisa ZCL (Zigbee) kana Data Model (Matter) Layers uchishandisa ZAP.

2/35

ZAP Kutanga

ZAP Kutanga
Kutanga neZAP
Zvikamu izvi zvinotsanangura nzira dzakasiyana dzekugadzira Zigbee uye Matter application. Ziva kuti Simplicity Studio inopa nzira yekugadzira yako Zigbee uye Matter zvikumbiro kubva kumagumo kusvika kumagumo uko maturusi ese anouya pre-akaiswa pamwe neSiplicity Studio (kusanganisira ZAP). Iwe unogona zvakare kusarudza kuongorora dzimwe nzira dzekugadzira zvikumbiro zvako, sezvatsanangurwa pano.
Zigbee Development
Vagadziri veZigbee application vanogona kuvaka maapplication avo vachishandisa Simplicity Studio, iyo inotosanganisira ZAP uye mamwe maturusi anokubatsira iwe kuvaka yako application kubva kumagumo kusvika kumagumo.
Matter Development
Matter Application Developers vanogona kuvaka maapplication avo vachishandisa nzira dzinotevera: Simplicity Studio: Izvi zvinosanganisira ZAP nemamwe maturusi anodiwa kuvaka Matter application kupera kuti ipere. Github (Silicon Labs) Github (CSA)
Ongorora: Kuti ugadzirise ZAP kunze kweiyo Simplicity Studio kuburitswa kutenderera, ona yekuvandudza ZAP muSiplicity Studio uye ZAP Installation Guide.

3/35

ZAP Installation

Zvikamu zvinotevera zvinotsanangura kuiswa kweZAP uye maitiro ekuvandudza ZAP muSiplicity Studio IDE.
Kudhaunirodha iyo ZAP Inoshandiswa Inokurudzirwa)
Iyi ndiyo nzira inokurudzirwa yekutanga neZAP. Unogona kuwana azvino ZAP mabhinari kubva kuaa https://github.com/project-chip/zp/releses. Prebuilt mabhinari anouya mumhando mbiri dzakasiyana.
Kuburitswa zviri pamutemo: Yakasimbiswa inovaka ine yakatsaurwa Matter uye Zigbee test suites. Manyorerwo ezita rekuburitsa ndeekuti vYYYY.DD.MM. Pre-kuburitswa: Inovaka iine azvino maficha uye bug kugadzirisa asi izvi zvinovaka HAZVISINA kusimbiswa neakazvitsaurira Matter uye Zigbee test suites. Manyorerwo ezita rekuburitsa ndeekuti vYYYY.DD.MM-husiku humwe.
Kuisa ZAP kubva Kunobva
Mirayiridzo yekutanga yekuisa ZAP
Nekuti iyi i node.js application, unoda iyo node nharaunda yakaiswa. Nzira yakanakisa yekuita izvi kurodha yazvino kuisirwa node, iyo inosanganisira node uye npm. Kana iwe uine yekare vhezheni yenode yakaiswa pane yako yebasa, inogona kukonzera nyaya, kunyanya kana yasakara. Ita shuwa kuti une yazvino node v16.x vhezheni ine npm inosanganisirwa. Mhanya node -version kutarisa kuti ndeipi vhezheni yatorwa. v18.x inokurudzirwa. Mushure mekunge uine vhezheni yaunoda yenode, unogona kumhanya zvinotevera:
Isa the Dependencies
Shandisa mirairo inotevera kuisa dependencies:

npm kuisa
Cherechedzo: Pakuisa Windows-chaiyo ZAP, ona Kuiswa kweZAP yeWindows OS Hazvishamisi kusangana nezvinetso zvekuunganidza raibhurari panguva ino. Kune akasiyana src-script/install-* zvinyorwa zvemapuratifomu akasiyana. Ona FAQ ruzivo rwekuti nderipi script yekushandisa pamapuratifomu akasiyana wobva waitazve npm install .
Tanga Application
Shandisa mirairo inotevera kutanga application:

npm mhanya zap
Tanga iyo Front-End muDevelopment Mode
Inotsigira hot-code kurodhazve, kukanganisa kukanganisa, zvichingodaro. Shandisa mirairo inotevera kuti utange kumberi-kuguma mukusimudzira
modhi:
quasar dev -m electron
or

4/35

ZAP Insta pa oll in
npm mhanya electron-dev

5/35

ZAP Kuisa Windows
ZAP Kuisa Windows
ZAP Kuiswa kweWindows OS
1. Windows Powershell
Mune desktop yekutsvaga bhaa, isa Windows Powershell uye mhanya semaneja. Mhanya yese inotevera mirairo mukati mePowershell.
2. Chocolate
Isa kubva https://chocolatey.org/install. Tarisa kana yakaiswa nemazvo nemirairo inotevera:
choko -v
Isa pkgconfiglite package nemirairo inotevera:
choco kuisa pkgconfiglite
3. Isa Node
Mhanya inotevera mirairo yekuisa:
choco kuisa nodejs-lts
* Iyo vhezheni inofanirwa kunge iri gumi nesere kuti ipfuure vhezheni cheki bvunzo, mushure mekuisa, tarisa ne node -v * Kana iwe watoisa Node, uye kutadza mimwe miedzo yakafanana neyo kusawana Node, dzosera Node ine chocolatey zvakare.
4. Tevera Mirayiridzo Yekutanga yekuisa ZAP
Tevedza iyo ZAP yekumisikidza mirairo kubva kutsime muZAP Kuiswa. Paunenge uchitevera mirairo yekutanga yekuisa ZAP tarisa zvikanganiso zvinotevera uye kuti ungazvigadzirisa sei:
sqlite3
Paunenge uchimhanyisa ZAP (semuenzaniso, npm run zap ), kana ukaona kukanganisa nezve sqlite3.node muhwindo rinobuda, mhanya:
npm kuvakazve sqlite3
electron-builder
Paunenge uchiita npm install, in post-install, kana kukanganisa kukaitika pamurairo unotevera une hukama neelectron-builder install-appdeps, npx electron-rebuild canvas yakundikana kana node-pre-gyp , shanduro yemazuva ano ye canvas haienderani neWindows uye kukanganisa kwekuisa hakuzokonzeri kukanganisa mukushanda ZAP. node-canvas iri kushanda pamhinduro ikozvino uye nyaya yacho ichagadziriswa munguva pfupi iri kutevera.
"postinstall": "electron-builder install-app-deps && husky install && npm gadzirazve canvas -update-binary && npm run version-stamp”

6/35

ZAP Kuisa Windows
Canvas
Kana npm run test ikatadza nekuda kwechikanganiso Test suite yatadza kumhanya. Hatikwanise kuwana module '../build/Release/canvas.node' kana
zapnode_modulescanvasbuildReleasecanvas.node haisiriyo Win32 application. , gadzirazve canvas sezvinotevera:
npm kuvakazve canvas -update-binary
tora index.html kana Zvimwe Zvinetso Sevha
Kana npm run test ikatadza nekuda kwechikanganiso tora index.html chikumbiro chakatadza nechimiro kodhi 404 muyuniti bvunzo kana kuve neserver.
nyaya dzekubatanidza mune e2e-ci bvunzo, mhanyisa inotevera mirairo:
npm mhanya kuvaka
Zvimwe
Tarisa kana iyo node vhezheni iri v18 uye edza kuiisa neChocolatey.

7/35

FAQ
FAQ
Mibvunzo Inowanzo bvunzwa
Mubvunzo: Ungatanga sei UI mune yekuvandudza maitiro? A: Unogona kutanga iyo UI mune yekuvandudza modhi, izvo zvinozoguma nekutevera setup:
Separate quasar development HTTP server, iyo inorarama inozorodza pachiteshi 8080 ZAP yekumashure inomhanya pachiteshi 9070 Chrome kana imwe browser, inomhanya yakazvimiririra Kuti usvike kune iyo setup, tevera mirairo iri pasi apa. ò Kutanga, mhanyisa iyo ZAP yekuvandudza server, iyo inotanga pachiteshi 9070.
npm mhanya zap-devserver ó Tevere, mhanyisa quasar development server, iyo inotanga pachiteshi 8080.
quasar dev ô Nongedza bhurawuza rako kana kumhanya imwe ichipikisana neyakakodzera URL pamwe neimwePort nharo:
google-chrome http://localhost:8080/?restPort=9070

Mubvunzo: Kuita kuti izvi zvishande paMac / Linux OS? A:
npm yekuisa inoshandiswa kurodha zvese zvinodiwa kutsamira mapakeji. Kana iwe ukaona zvikanganiso zvine chekuita nenode-gyp uye zvisipo maraibhurari emunharaunda, senge pixman , uye zvichingodaro, iwe urikurasikirwa nekwazvino kutsamira kugutsa kuunganidza isina-prebuilt node mabhinari kune imwe musanganiswa yemapuratifomu neshanduro. Npm pagore inogara ichivandudza rondedzero yemabhinari akapihwa, saka zvinogoneka kuti unovatora zvakanaka, asi kana ukasadaro, iyi mirairo yemapuratifomu akasiyana:
Fedora Core ine dnf:
dnf isa pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
kana kumhanya script:
src-script/install-packages-fedora
Ubuntu ine apt-get :
apt-tora update apt-get install -gadzirisa-isipo libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
kana kumhanya script:

8/35

FAQ
src-script/install-packages-ubuntu
OSX paMac ine Homebrew brew:
brew install pkg-config cairo pango libpng jpeg giflib librsvg
kana kumhanya script:
src-script/install-packages-osx
Mubvunzo: Kuita kuti izvi zvishande paWindows OS?
A: Ita shuwa kuti inogara iripo uye hapana shanduko dzisina kuitwa. Zano: git dhonza, git chimiro & git stash ishamwari dzako. Iwe unofanirwa kushandisa Chocolately kuti Zap ishande paWindows OS. Ita shuwa yekurodha pkgconfiglite package.
choco kuisa pkgconfiglite
Kana uine nyaya necairo, example kana ukawana kukanganisa nezve cairo.h': Kwete zvakadaro file kana dhairekitori, ita zvinotevera: ò Tarisa kana komputa yako iri 32 kana 64 bit. ó Zvichienderana nazvo, dhawunirodha pasuru yakakodzera kubva pane ino saiti
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:
Dzvanya pane Advanced System Settings. Mune iyo yepamusoro tebhu tinya pane Environment Variables. Muchikamu cheSystem Variables, tsvaga PATH nharaunda inoshanduka uye sarudza iyo. Dzvanya Rongedza uye wedzera C:/GTK kwairi. Kana iyo PATH nharaunda shanduko isipo, tinya Nyowani. Kana jpeglib.h isina kuwanikwa, edza zvinotevera: ò Pachiteshi, mhanya: choco install libjpeg-turbo ó Ita shuwa kuti yakachena nekushandisa: git clean -dxff uye run npm install zvakare ô kana pasina kukanganisa kunoitika uye yambiro chete inoonekwa, edza kushandisa npm audit fix õ kana usingakwanise kumhanyisa ZAP, enda ku. file src-script/zap-start.js ö Shandura
÷ const {spawn } = inoda('cross-spawn') to const {spawn} = inoda('child_process') ø Mhanya npm uye mhanya zap. References:
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)
Mubvunzo: Ndinowana kukanganisa "sqlite3_node" isina kuwanikwa kana yakafanana.

9/35

FAQ
A: Vakazve yako yekuzvarwa sqlite3 bindings. Kugadzirisa izvi kazhinji, mhanya:
npm kuisa
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Kana iyo isati yagadziriswa, ita:
rm -rf node_modules wobva waedza mirairo iri pamusoro zvakare. Dzimwe nguva kukwidziridza npm yako kunoitawo mutsauko:
npm kuisa -g npm
Mubvunzo: Ndawana kukanganisa "N-API shanduro yeNode muenzaniso ndeye 1. Iyi module inotsigira N-API vhezheni 3. Iyi Node muenzaniso haigone kuita iyi module."
A: Simudzira yako node vhezheni. Mhinduro yeiyi inokurukurwa mune iyi Stack Overflow thread: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Mubvunzo: PC yangu yekuvandudza haishande neZAP chero chikonzero. Ndinogona kushandisa docker mudziyo?
A: Hongu unogona. TBD.
Q: Ndinomhanya sei ZAP mukati VSCode?
A: Kana iwe VSCode munzira yako isa zap repo uye nyora kodhi. Izvi zvichavhura ZAP muVSCode. Kuti umhanye ZAP mudebug mode, sarudza nzvimbo yekushanda yeZAP wobva wadzvanya pakanzi Mhanya paruboshwe rweturusi. Iwe uchave nesarudzo mbiri dzekusarudza kubva pakushandisa ZAP, sarudza Node.js Debug Terminal . Izvi zvinovhura hwindo rekupedzisira kubva paunogona kupinda npm run zap , iyo inosungirira debugger uye kumhanya ZAP sezvaunowanzoita kubva pamutsetse wekuraira. Makorokoto, unofanira kuona ZAP ichimhanya mudebugger. Iwe unogona kuseta mabreakpoints muVSCode sezvaungaita mune chero imwe IDE.
Mubvunzo: UI unit test inotadza nezvimwe zvikanganiso zvakatenderedza canvas kwete kuvaka iyo chaiyo vhezheni yenode. Ndoita sei?
A: Kana ukaona chikanganiso chinotevera:
FAIL test/ui.test.js Test suite yatadza kushanda The module 'canvas.node' yakagadzirwa zvichipesana neimwe Node.js vhezheni pachishandiswa NODE_MODULE_VERSION 80. Shanduro iyi yeNode.js inoda NODE_MODULE_VERSION 72. Tapota edza kugadzira patsva kana kuisa zvakare modulen (somuenzaniso, shandisai `pminupild).`
paChinhu. (node_modules/canvas/lib/bindings.js:3 18)
wobva wamhanya: npm kuvakazve canvas -update-binary

10/35

ZAP Basics

ZCL/Data-Modhi ZAP Zvinokosha
Ichi chikamu chine ruzivo rwevashandisi vatsva veZAP. Dzvanya pane yedzidziso icon pakona yekurudyi yeZAP UI, iyo inoratidza magadzirirwo eZAP. Chidzidzo chinokutungamirira kuburikidza nezvinotevera: Gadzira panogumira Sarudza rudzi rwechishandiso Gadzirisa cluster Gadzirisa hunhu Gadzirisa murairo Kuti uwane ruzivo rwakadzama, ona Zigbee Cluster Configurator Guide.

11/35

ZAP User's Guide
ZAP User's Guide
ZAP User's Guide
Zvikamu zviri pasi pegwaro rino zvinopa rumwe ruzivo nezve maficha akasiyana anopihwa neZAP.

12/35

Custom XML

Kuwedzera Tsika XML kubva kuZAP UI
Dzvanya pa "Extensions" icon muZAP UI. Dzvanya pa "+" wedzera bhatani kuti usarudze yakajairika xml file Iwo masumbu etsika, hunhu, mirairo, nezvimwe zvinofanirwa kuoneka muZAP UI kana tsika xml yawedzerwa.
Kugadzira yako yega XML muZigbee
Icho chikamu chinoratidza maitiro ekugadzira ako ega masumbu uye kuwedzera aripo akajairwa masumbu ane tsika hunhu uye mirairo yeZigbee.
Manufacturer-Specific Clusters muZigbee
Iwe unogona kuwedzera mugadziri-chaiwo masumbu kune yakajairwa profile. Isu tinopa exampizvi zviri pasi apa. Kuti uite izvi unofanirwa kuzadzisa zvisungo zviviri:
Iyo cluster ID INOFANIRA kunge iri mugadziri-chaiyo renji, 0xfc00 - 0xffff. Tsanangudzo yecluster inofanira kusanganisira kodhi yekugadzira iyo ichaiswa kune ESE hunhu nemirairo mukati meiyo cluster uye inofanirwa kupihwa kana uchitumira nekugamuchira mirairo uye uchidyidzana nehunhu. Example:

Sample Mfg Specific Cluster General Iyi cluster inopa example yekuti iyo Chikumbiro Framework inogona kukwidziridzwa sei kuti ibatanidze mugadziri-chaiwo masumbu.
0xFC00
ember sample attribute
ember sampuye unhu 2

A sample mugadziri-chaiwo kuraira mukati meiyo sample mugadziri-zvakananga
cluster.

Manufacturer-Specific Commands muStandard Zigbee Cluster
Iwe unogona kuwedzera yako mirairo kune chero yakajairwa Zigbee cluster ine zvinotevera zvinodiwa:
Yako yekugadzira-yakananga mirairo inogona kushandisa chero yekuraira id mukati meyekuraira id renji, 0x00 - 0xff. Iwe unofanirwawo kupa kodhi yekugadzira yekuraira kuitira kuti igone kusiyaniswa kubva kune mimwe mirairo musumbu uye inobatwa nemazvo. Example yekuwedzera iyo On / Off cluster nemirairo yekugadzira:

13/35

Custom XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inodzima chishandiso neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificOnWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inobatidza mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificToggleWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inoshandura mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificOnWithTransition2″ sarudzo=”chokwadi” mugadziriCode="0 1049″> Client command inobatidza mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificToggleWithTransition2″ sarudzo=”chokwadi”
mugadziriCode="0 1049″> Client command inoshandura mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.

Manufacturer-Specific Attributes muStandard Zigbee Cluster
Iwe unogona kuwedzera yako hunhu kune chero yakajairwa Zigbee cluster ine zvinotevera zvinodiwa:
Wako mugadziri-chaiwo hunhu anogona kushandisa chero hunhu id mukati mehunhu id renji, 0x0000 - 0xffff. Iwe unofanirwawo kupa mugadziri kodhi yehunhu kuitira kuti igone kusiyaniswa kubva kune humwe hunhu musumbu uye inobatwa nemazvo. Example yekuwedzera iyo On/Off cluster ine hunhu hwekugadzira:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min="0 0000″
max=”0xFFFF” inonyorwa=”chokwadi” default=”0 0000″ sarudzo=”chokwadi” mugadziriCode=”0 1002″>Sample Mfg Yakananga Hunhu: 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 Yakananga Hunhu: 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 Yakananga Hunhu: 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 Yakananga Hunhu: 0 0001 0 1040
Kugadzira yako yega XML muMatter
Chikamu chinoratidza maitiro ekugadzira ako ega masumbu uye kuwedzera aripo akajairwa masumbu ane tsika hunhu uye mirairo yeMatter.
Manufacturer-Specific Clusters in Matter
Iwe unogona kuwedzera mugadziri-chaiwo masumbu kuMatter. Isu tinopa exampizvi zviri pasi apa.
Iyo 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

Custom XML
Mune inotevera example, musanganiswa weID ID (Test Manufacturer ID) ye0xFFF1 uye cluster ID ye0xFC20 inoguma value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
General Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Iye Sample MEI cluster inoratidza kuwedzera kweboka rekugadzira FlipFlop
Mhinduro yeAddArguments inodzosera mari. Raira iyo inotora maviri uint8 nharo uye inodzorera summary yavo. Raira rakareruka pasina chero paramita uye pasina mhinduro.
Manufacturer-Specific Attributes in Standard Matter Clusters
Iwe unogona kuwedzera mugadziri chaiwo hunhu kune chero yakajairwa Matter cluster ine zvinotevera zvinodiwa:
Taaaa iye anounganidza kuti hunhu huri kuwedzerwa kunofanirwa kutsanangurwa -
e xte nd ed > ">
Iyo kodhi yehunhu ndeye 32-bit musanganiswa weiyo mugadziri kodhi uye id yehunhu. Iyo inonyanya kukosha 16 bits ndiyo kodhi yemugadziri. Iyo mhando yemakodhi emugadziri webvunzo ndeye 0xFFF1 - 0xFFF4. Iwo mashoma akakosha 16 bits ndiwo hunhu ID. Mutsara wezvisiri zvepasi rose hunhu ndeye 0x0000 - 0x4FFF.
Exampyekuwedzera On/Off Matter cluster ine magadzirirwo-chaiwo hunhu:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ rudzi=”INT8U” min="0 0000″
max=”0xFFFF” inonyorwa=”chokwadi” default=”0 0000″ sarudzo=”chokwadi”>Sample Mfg Specific Attribute 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ rudzi=”INT16U” min="0 0000″
max=”0xFFFF” inonyorwa=”chokwadi” default=”0 0000″ sarudzo=”chokwadi”>Sample Mfg Specific Attribute 4
Manufacturer-Specific Commands muStandard Matter Clusters
Iwe unogona kuwedzera mugadziri chaiwo mirairo kune chero yakajairwa Matter cluster ine zvinotevera zvinodiwa:
Taaaa iye anounganidza kuti mirairo irikuwedzerwa inofanira kutaurwa -
e xte nd ed > ">
Iyo kodhi yekuraira ndeye 32-bit musanganiswa weiyo mugadziri kodhi uye id yekuraira. Iyo inonyanya kukosha 16 bits ndiyo kodhi yemugadziri. Iyo mhando yemakodhi emugadziri webvunzo ndeye 0xFFF1 - 0xFFF4. Iwo mashoma akakosha 16 bits ndiyo yekuraira ID. Mutsara wemirairo isiri yepasi rose ndeye 0x0000 - 0x00FF.
Example yekuwedzera On/Off Matter cluster ine gadzira-chaiwo masumbu:

15/35

Custom XML

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ sarudzo=”chokwadi”> Client command inobatidza mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ sarudzo=”chokwadi”>
Client command inoshandura mudziyo neshanduko yakapihwa nenguva yekuchinja muEmber Sample transition time attribute.

16/35

Custom XML Tags zveZigbee

Gwaro rinotevera rinotaura nezve yega yega xml tags yakabatana neZigbee.
Imwe neimwe xml file yakanyorwa pakati pe configurator tags:

Mhando dze data dzinogona kutsanangurwa mukati meiyo configurator tag. Zigbee parizvino inotsigira tsananguro yebitmaps, enums, integers, tambo kana structs. Usati watsanangura mamwe marudzi ita shuwa kuti watarisa ese aripo marudzi eatomic anotsanangurwa mumhando.xml nemarudzi ese asiri maatomu anotsanangurwa mune imwe xml. files. Unogona kuzvitsanangura sezvinotevera:
Bitmap: zita: zita remhando yebitmap. mhando: Bitmap nehukuru pakati pe8-64 bits inogona kutsanangurwa, iyo yose inofanira kuva yakawanda ye8. Bitmap imwe neimwe inogona kuva neminda yakawanda ine zita uye mask inobatanidzwa nayo. eg:

"`
Enum: zita: zita re enum mhando. mhando: Enum nehukuru pakati pe8-64 bits inogona kutsanangurwa, iyo yose inofanira kuva yakawanda ye8. Enum imwe neimwe inogona kuva nezvinhu zvakawanda zvine zita uye kukosha kwakabatana nayo. eg:

Integer: Integer types dzakatotsanangurwa pasi pemhando dzeatomu dziri mumhando.xml. Saizi yavo inogona kubva pa8-64 bits uye inogona kusaina kana kusaina. eg:

Tambo: Mhando dzetambo dzakatotsanangurwa pasi pemhando dzeatomu dziri mumhando.xml. Mhando dzetambo dzazvino dzinosanganisira octet tambo, char tambo, refu octet tambo uye refu char tambo eg:

Chimiro: zita: zita rechimiro chechimiro. Imwe neimwe dhizaini inogona kuva nezvakawanda zvinhu zvine zita uye mhando yakabatana nayo. Iyo mhando inogona kuve chero yakafanotsanangurwa mhando pasi pemhando dzedata. eg:

17/35

Custom XML Tags zveZigbee

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

Custom Clusters inogona kutsanangurwa mukati meiyo configurator tag. zita: zita reiyo cluster domain: domain of the cluster. Iyo cluster ichaonekwa muZAP UI pasi peiyi domain. tsananguro: Tsananguro yekodhi yekodhi: cluster kodhi define: cluster define iyo inoshandiswa nekodhi jenareta kutsanangura cluster neimwe nzira mugadziriCode: Inoshandiswa kutsanangura yekugadzira chaiyo cluster. Izvi zvinofanirwa kunge zviri pakati pe0xfc00 - 0xffff. Iyo kodhi yekugadzira ye cluster inoda kutsanangurwa sezvizvi:

Boka rekugadzira rinoita otomatiki hunhu uye mirairo pasi payo yekodhi imwechete yekugadzira kunze kwekunge vanyora zvakajeka kodhi yemugadziri. yakaiswaIn: Inoshandiswa kuona iyo spec vhezheni iyo cluster yakaunzwa. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. removedIn: Inoshandiswa kuona iyo spec vhezheni yakabviswa cluster. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. singleton(boolean): Inoshandiswa kuona sumbu senge singleton zvekuti pane chiitiko chimwe chete chesumbu iro rakagovaniswa kumativi ekupedzisira. hunhu: inotsanangura hunhu hwezita reboka: Zita rehunhu rinotaurwa pakati pehunhu tag.
hunhu zita
side (mutengi / server): Rutivi rwesumbu uko hunhu hwakabatana zvakare. kodhi: hunhu kodhi yemugadziri kodhi: Izvi zvinogona kushandiswa kutsanangura mugadziri chaiwo hunhu kunze kweiyo zigbee yakatarwa inotaurwa neyakajairwa xml. define: define define iyo inoshandiswa necode generator kutsanangura hunhu mune imwe nzira mhando: mhando yehunhu hunogona kuve chero yemhando dzedata dzinotaurwa mu xml default: default kukosha kwehunhu. min: Hukoshi hudiki hunotenderwa hwehunhu hukuru: Hukoshi hwepamusoro hunobvumidzwa hwehunhu hunonyorwa: Ko kukosha kwehunhu hunonyorwa here kana kuti kwete. Izvi zvinogona kushandiswa kudzivirira hunhu kubva pakugadziriswa nemirairo yekunyora. optional(boolean): Inoshandiswa kuona kana hunhu huri sarudzo kana kuti kwete yeboka. min: Yakaderera kukosha inotenderwa yehunhu kana iri nhamba, enum kana bitmap mhando. max: Uwandu hwepamusoro hunotenderwa hwehunhu kana huri hurefu hwemhando, enum kana bitmap: Hunoshandiswa kudoma hurefu hwechimiro kana chiri chetambo yerudzi. minLength: Inoshandiswa kutsanangura hurefu hudiki hwehunhu kana huri hwemhando yetambo. reportable(boolean): Inotaurira kana hunhu huchitaurika kana kuti husingagoneki(boolean): Inobvumira kusakosha kwehunhu. array(boolean): Inoshandiswa kuzivisa hunhu hwemhando array. yakaiswaIn: Inoshandiswa kuona iyo spec vhezheni umo hunhu hwakaunzwa. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. removedIn: Inoshandiswa kuona iyo spec vhezheni yakabviswa hunhu. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. raira: tsanangura murairo wezita resumbu: Zita rekuraira.

code: command code

18/35

Custom XML Tags zveZigbee
mugadziri kodhi: Izvi zvinogona kushandiswa kutsanangura mugadziri chaiwo kuraira kunze kweiyo zigbee yakatarwa yakataurwa neyakajairwa xml. tsananguro: tsananguro yeiyo sosi yekuraira (mutengi / server): sosi yekuraira. optional(boolean): Inoshandiswa kuona kana murairo uri wekusarudza kana kwete weboka. yakaiswaIn: Inoshandiswa kuona iyo spec vhezheni umo rairo yakaunzwa. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. removedIn: Inoshandiswa kuona iyo spec vhezheni yakabviswa murairo. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. command nharo:
Murairo wega wega unogona kuve neseti yemirairo yezvipokana zita: zita reiyo command nharo mhando: mhando yemirairo nharo inogona kunge iri chero yemhando dzakataurwa mu xml. min: Ukoshi hudiki hunobvumidzwa hwenharo kana iri nhamba, enum kana bitmap mhando. max: Hurefu hunotenderwa hwenharo kana iri integer, enum kana bitmap type urefu: Hunoshandiswa kudoma hurefu hunotenderwa hwenharo yekuraira kana iri yemhando yetambo. minLength: Inoshandiswa kutsanangura hurefu hudiki hunotenderwa kune nharo yekuraira kana iri yerudzi rwetambo. array(boolean): Kuti uone kana chirevo chekuraira chiri chemhando array. presentIf(string): Iyi inogona kunge iri tambo ine mirau yezvishandiso zvine musoro zvichibva pane dzimwe nharo dzekuraira kwaungatarisira kupokana kwemirairo kana tambo yemamiriro ikaongorora kuti ichokwadi. eg:

Ongorora: Heino chimiro nderimwe zita renharo yekuraira. optional(boolean): Inoshandiswa kuona chirevo chekuraira sechisarudzo. countArg: Inoshandiswa kana chirevo chekuraira chiri chemhando yemhando. Izvi zvinoshandiswa kutaura imwe nharo yekuraira iyo inoratidza saizi yehurongwa hwenharo iyi.

yakaiswaIn: Inoshandiswa kuona iyo spec vhezheni umo iyo nharo yekuraira yakaunzwa. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. removeIn: Inoshandiswa kuona iyo spec vhezheni umo iyo nharo yekuraira yakabviswa. Izvi zvinoshandiswa nekodhi jenareta kuwedzera imwe pfungwa. Cluster Extension inogona kutsanangurwa mukati meiyo configurator tag. Cluster yekuwedzera inoshandiswa kuwedzera yakajairika cluster ine hunhu hwekugadzira uye mirairo semuenzaniso

19/35

Custom XML Tags zveZigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Yakananga Hunhu: 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 Yakananga Hunhu: 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 Yakananga Hunhu: 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 Yakananga Hunhu: 0 0001 0 1040ampleMfgSpecificOffWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inodzima mudziyo neshanduko yakapihwa
nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificOnWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inobatidza mudziyo neshanduko yakapihwa
nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificToggleWithTransition” optional=”chokwadi” mugadziriCode=”0 1002″> Client command inoshandura mudziyo neshanduko yakapihwa
nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificOnWithTransition2″ sarudzo=”chokwadi” mugadziriCode="0 1049″> Client command inobatidza mudziyo neshanduko yakapihwa
nenguva yekuchinja muEmber Sample transition time attribute.ampleMfgSpecificToggleWithTransition2″ sarudzo=”chokwadi” mugadziriCode="0 1049″> Client command inoshandura mudziyo neshanduko yakapihwa
nenguva yekuchinja muEmber Sample transition time attribute.

20/35

Multiple Device Types Per Endpoint

Ichi chinhu cheNyaya-chete apo mushandisi anogona kusarudza anopfuura mhando yemudziyo mumwe pamagumo. Kuwedzerwa kweakawanda aaa mudziyo mhando kuchawedzera iyo cluster configur tions mukati memhando dzemudziyo kune endpoint configur tion.

21/35

Multiple Device Types Per Endpoint

Mufananidzo uri pamusoro unoratidza kuti endpoint 1 ine mhando dzemudziyo dzinopfuura imwe dzakasarudzwa. Iyo "Primary Device" inoreva mhando yemhando yemudziyo iyo iyo yekupedzisira ichabatanidzwa nayo. Mhando yemudziyo wekutanga inogara iripo pa index 0 yerondedzero yemhando dzemidziyo yakasarudzwa saka kusarudza mhando yemudziyo wakasiyana kunochinja marongero emhando dzemudziyo wakasarudzwa. Sarudzo dzemhando yemudziyo dzinewo zvipingamupinyi zvinoenderana neData Model Specification. ZAP inodzivirira vashandisi kubva pakusarudza kusanganisa kusiri iko kwemhando dzemudziyo pamagumo vachishandisa zvipingaidzo izvi.

22/35

Matter Device Type Feature Peji
Matter Device Type Feature Peji
Matter Device Type Feature Peji
ZAP inotsigira kuona uye kushandura Matter maficha mumudziyo mhando peji peji. Chete mhando yemudziyo maficha anotsanangurwa mu matter-devices.xml muCHIP repository ndiwo acharatidzwa.

Kufamba uchienda kuFeature Peji
ò Tangisa ZAP muMatter ine up-to-date Matter SDK. ó Gadzira panogumira nerudzi rwechishandiso cheMatter. ô Dzvanya bhatani reChishandiso Type Features pamusoro pepakati peboka view. Ziva kuti bhatani iri rinowanikwa muZAP chete
zvigadziriso zveMatter uye kana data rekuenderana riripo muMatter SDK. Kudzvanya bhatani iri kunovhura mufananidzo uri pamusoro.
Conformance
Conformance inotsanangura sarudzo uye kutsamira kune hunhu, mirairo, zviitiko, uye data mhando. Inotarisa kuti chinhu chinosungirwa here, chaungasarudza, kana chisingatsigirwe pasi pemamwe magadzirirwo eZAP.
Kuenderana kwemhando yemudziyo kunotungamira pane kuenderana kwecluster. For exampuye, Chiedza cheChiedza chine sarudzo yekuenderana muboka reOn/Off asi chinoziviswa sechinofanirwa murudzi rweOn/Off Light mudziyo unosanganisira cluster yeOn/Off. Kugadzira magumo neOn/Off Light mudziyo mhando inoratidza Chiedza cheChiedza sechinosungirwa pane peji rechikamu.
Feature Toggling
Papeji peji, mushure mekudzvanya bhatani rekushandura kuti ugone kana kudzima chimiro, ZAP icha:
Gadziridza zvinhu zvakabatana (hunhu, mirairo, zviitiko) kugadzirisa kuenderana, uye kuratidza nhaurirano inoratidza shanduko.

23/35

Matter Device Type Feature Peji Gadziridza chimiro chidiki muchimiroMap hunhu hweboka rakabatana

Gonesa Feature Dialogue

Dzima Feature Dialogue

Toggling yakadzimwa kune mamwe maficha kana kuenderana kwawo kuine kukosha kusingazivikanwe kana fomu t risiri kutsigirwa parizvino. Mune iyi ac se, ZAP icharatidza yambiro mune yekuzivisa ap ne.
a Wa Element Conform nce rings

Paunochinja chimwe chinhu, ZAP inogona kuratidza yambiro yekuteedzera mudziyo uye yambiro yekuenderana. Kana chimiro chechinhu chisingaenderane nezviri kutarisirwa kuenderana, ZAP icharatidza chiratidzo cheyambiro uye nekuisa yambiro mukuzivisa ap ne. Example yezvose zviri zviviri kuteedzera uye kuenderana yambiro inoratidzwa yechinhu:

24/35

Notifications
Notifications
Notifications
Chikamu chinotevera chinotsanangura kuti zviziviso zvinopihwa sei kuvashandisi veZAP muUI.
Package Notifications
Zviziviso zvepakeji ndiyo yambiro kana meseji yekukanganisa yakabatana kune chero chaiyo package yakaiswa muZAP. For example, mumifananidzo iri pazasi, kudzvanya chiratidzo chenyevero pasi peiyo chimiro kuchakutungamirira kune dialog inoratidza zvese zviziviso zvepakeji iyoyo.

25/35

Notifications
Session Notifications
Zviziviso zveSession ndiyo yambiro kana mhosho dzemeseji dzine chekuita nechikamu chemushandisi. Idzi yambiro/zvikanganiso zvinogona kuvonekwa nekudzvanya pakanzi Notifications mubhara rekushandisa riri pamusoro peZAP UI. For example, mufananidzo uri pazasi unoratidza peji yekuzivisa yechikamu mushure meiyo isc file yakaiswa muZAP.

26/35

Dhata-Modhi/ZCL Tsanangudzo Kutevedzera
Dhata-Modhi/ZCL Tsanangudzo Kutevedzera
Data Model uye ZCL Specification Compliance
Ichi chikamu muZAP chinobatsira vashandisi kuona kutadza kwekuteerera kweData Model kana ZCL nemagadzirirwo avo aripo eZAP. Iwo mameseji yambiro yekutadza kutevedzera anozoonekwa pane Yekuzivisa pane yeZAP UI uye achaiswawo paconsole paunenge uchimhanyisa ZAP kuburikidza neCLI. Chimiro chekuteerera parizvino chinopa yambiro yekuteedzera rudzi rwechishandiso uye kutevedzera cluster pamagumo.
Yambiro dzekutevedzera muZAP UI
Kana mushandisi avhura .zap file vachishandisa ZAP UI vachaona yambiro pane zviziviso zveZAP UI pane zvese zvatadza kutevedza. For example, mufananidzo uri pazasi unoratidza peji yezviziviso zvechikamu mushure me.zap file yakavhurwa nenyaya dzekutevedzera.

Mameseji ezvekutevedza anopera kana nyaya dzagadziriswa uchishandisa ZAP UI zvekuti unongokwanisa kuronda nyaya dzasara dzekutevedzwa. Yambiro nyowani icharatidzawo kuteedzera kana mushandisi akadzima zvinhu zvinosungirwa (cluster/commands/attributes) yekumisikidza. Tsanangudzo yekutevedza zviziviso zvinogara zvichichengeta chero kukanganisa kunounzwa mukumisikidzwa kweZAP asi ziva kuti yambiro dzinoonekwa pakuvhurwa kwe.zap. file vane zvakawanda zvekuti sei yakatadza kuteedzera kana ichienzaniswa neyambiro inoratidzwa paunenge uchidyidzana neUI. Izvi nekugadzira uye cheki yekutevedzera yakazara inoitwa panguva yekuvhurwa kwe.zap file.
Yambiro Yekutevedzera PaConsole

27/35

Dhata-Modhi/ZCL Tsanangudzo Kutevedzera
Kana mushandisi avhura .zap file vachishandisa ZAP yakamira UI kana kuti ZAP CLI vanozoona yambiro yakapinda mukoni/terminal pane zvese zvatadza kutevedzera. For example, mufananidzo uri pazasi unoratidza yambiro yezviziviso paconsole/terminal mushure me.zap file yakavhurwa nenyaya dzekutevedzera.

28/35

Access Control

Access Control Features
ZAP inotsigira hurongwa hwekupinda muZCL pamasangano ese. Izvo zviri pasi pakuitwa kweiyo SDK kumepu aya maficha kune anodiwa uye anotsigirwa ekuwana ekutonga SDK maficha. ZAP inowanzopa modhi yedata uye nzira yekuiisa mune meta-info files uye kuparadzira iyo data kune chizvarwa matemplate, pasina kugovera zvirevo zvakananga kune data data.
Base Terms
ZAP access control inotsanangura mazwi matatu ekutanga, anotevera: ò kushanda : kunotsanangurwa sechinhu chinogona kuitwa. Example: verenga, nyora, kumbira. ó basa: rinotsanangurwa seropafadzo yemutambi. Zvakaita se "View ropafadzo”, “Administrative role”, uye mwanakomana on. ô modhifita: inotsanangurwa seyakakosha kudzora mamiriro ekupinda, senge machira anonzwa data kana machira akaongororwa data. Iwo mazwi ekutanga anotsanangurwa mune metadata XML pasi pepamusoro tag . Inotevera ndeye example yekuwana control base base term tsananguro:
<role type=”view”tsanangudzo="View ropafadzo”/>
Ex uyuample inotsanangura mashandiro matatu, kuverenga, kunyora uye kukumbira, maviri modifiers uye mana mabasa.
Access Triplets
Yese yemunhu yekuwana mamiriro anogona kutsanangurwa nekuwana katatu muXML. Kuwana katatu musanganiswa wekushanda, basa uye modifier. Izvo ndezvekusarudza, saka iwe unogona chete kuva nechimwe cheizvi. Chikamu chinoshaikwa chetatu chinowanzo reva mvumo, iri kuita-chaiyo kune yakapihwa SDK. Sangano rinotsanangura mapindiro aro rinogona kuva nechikamu chimwe chete kana anopfuura matatu. Inotevera ndeye example:
pa0
Iyi ndiyo tsananguro yehunhu hune mukana wekuwana katatu, ichizivisa kuti inobvumira kunyora kushanda nebasa rekutonga, rine machira-scoped modifier akaiswa.
Default Permissions

29/35

Access Control
Masangano eZCL anogona kutsanangura mvumo yavo yega. Nekudaro, kune zvakare tsananguro yepasirese yemvumo yekusarudzika ye
mhando dzakapiwa. Izvi zvinofungirwa sangano rakapihwa, kunze kwekunge richipa chero mvumo yaro.
Default mvumo inoziviswa kuburikidza nea tag padanho repamusoro reXML file. Example:
aa a<ccess op=”invoke”/> a a aa <ccess op=”re d”/> a<ccess op=”nyora”/> a aa aa <ccess op="re d" role="view”/> aa <ccess op=”write” role=”oper te”/> a
Template Helpers
Mubatsiri wetemplate yekushandisa ndeye {{#access}} … {{/access}} iterator. Iyi iterator inodzokorodza pane ese akapihwa mukana katatu.
Inotsigira nzira mbiri dzinotevera:
entity=”attribute/command/ event” – kana sangano racho risingakwanisi kutsanangurwa kubva pane zviri kutaurwa, izvi zvinoisa mhando yesangano. sanganisiraDefault = "chokwadi / nhema" - inosarudza kana maitiro ekutanga akabatanidzwa kana kuti kwete. Inotevera ndeye 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: {{basa}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa - comm nd: {{n me}}} [{codend{#}]com a {{codend{#}]} a RM a M * p: {{oper tion}} / ole: {{basa}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – chiitiko: {{n me}} [{{code}}] a {{# ccess entity=”chiitiko”}} O a RM a M * p: {{oper tion}} / ole: {{basa}} / odifier: {{ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Kutangisa ZAP yeMatter kana Zigbee application
Kutangisa ZAP yeMatter kana Zigbee application
Kutangisa ZAP yeMatter kana Zigbee Application
Zvikamu zvinotevera zvinotsanangura kutangisa ZAP nenzira yakamira neMatter kana Zigbee-specific metadata. Pfungwa ndeyekutanga ZAP nenharo dzakaringana dzine chekuita neXML metadata (masumbu uye tsananguro dzemhando dzemudziyo sezviri kutaurwa neCSA) uye matemplate echizvarwa, ayo anoshandiswa kugadzira kodhi yakakodzera.
Kutangisa ZAP neNyaya
Iyo inotevera script inotora iyo metadata chaiyo kubva kuMatter SDK paunotanga ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Cherechedza: Unogonawo kuenda kune inotevera Zigbee nzira yekuvhura ZAP muMatter.
Kutangisa ZAP neZigbee
Uyu unotevera murairo unotangisa ZAP neZCL zvakatemwa uye chizvarwa matemplate kubva kuSDK.
[zap-nzira] -z [sdk-path]/gsdk/app/zcl/zcl-zap.json -g [sdk-path]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
zap-nzira: Iyi ndiyo nzira inoenda kuZAP sosi kana sdk-nzira inogoneka: Iyi ndiyo nzira inoenda kuSDK.
Kuvhura ZAP pasina Metadata
Rangarira kuti kana uchitanga ZAP zvakanangana nezvinogoneka kana kubva kunobva uchishandisa npm run zap uri kutangisa ZAP ine test metadata yeMatter/Zigbee yakavakirwa mukati meZAP uye kwete iyo chaiyo metadata inobva kuMatter neZigbee SDKs dzataurwa pamusoro. Naizvozvo, yeuka kugadzira yako ZAP zvigadziriso nekushandisa iyo SDK metadata uye kwete nekuvhura ZAP zvakananga neyakavakwa muyedzo metadata.

31/35

Kugadzira kodhi yeMatter kana Zigbee

Kugadzira kodhi yeMatter, Zigbee kana Custom SDK
Zvikamu zvinotevera zvinotsanangura maitiro ekugadzira kodhi uchishandisa ZAP.
Gadzira Code Uchishandisa ZAP UI
Tangisa iyo ZAP UI sekuenderana nemirairo muKutangisa ZAP yeMatter kana Zigbee uye tinya pakanzi Gadzira bhatani repamusoro menyu bha.
Gadzira kodhi pasina UI
Mirayiridzo inotevera inopa nzira dzakasiyana dzekugadzira kodhi kuburikidza neCLI pasina kuvhura ZAP UI.
Kugadzira Code kubva kuZAP Source
Mhanya unotevera kuraira kugadzira kodhi uchishandisa ZAP kubva kunobva: 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
Kugadzira kodhi kubva kuZAP Inotevedzwa
Mhanya unotevera kuraira kuti ugadzire kodhi uchishandisa ZAP inogoneka: [zap-nzira] gadzira -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
Kugadzira kodhi kubva kuZAP CLI Inogadziriswa
Mhanya unotevera kuraira kuti ugadzire kodhi uchishandisa ZAP CLI Inogoneka: [zap-cli-path] gadzira -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

Gadziridza ZAP muStudio

Update ZAP
Gadziridza ZAP muSiplicity Studio
Iyi meshini inogona kushandiswa kana uchishanda neMatter yekuwedzera kana Zigbee kubva kuSilicon Labs SDK kuburitswa. ZAP inogona kuvandudzwa mukati meSiplicity Studio pasina Simplicity Studio kuburitswa nekudhawunirodha yazvino ZAP inoitiswa (inokurudzirwa) kana kudhonza ichangoburwa kubva kuZAP sosi sezvakaratidzwa muZAP Kuisa Gwaro. Mushure mekunge wave neZAP yazvino zvichibva pane yako yazvino OS, unogona kugadzirisa ZAP mukati meStudio seadhaputa pack. Tevedza mirairo iri pazasi mushure mekudhawunirodha yazvino ZAP:
Enda kuSiplicity Studio uye sarudza Zvaunoda> Simplicity Studio> Adapter Packs. Dzvanya Wedzera… uye tarisa kune yakawedzera ZAP folda yawakadhawunirodha wodzvanya Sarudza Folder. Baya Nyorera uye Vhara uyezve ichangobva kuwedzerwa ZAP ichashandiswa chero pa .zap file inovhurwa.
Ongorora: Dzimwe nguva panogona kunge paine ekare zviitiko zveZAP yatove kushanda kunyangwe mushure mekuvandudza kune yazvino ZAP. Ita shuwa yekupedza zvese zviripo ZAP zviitiko zvekuti iyo ichangobva kutorwa ZAP inoshandiswa pachinzvimbo chekare, iyo ichiri kushanda kumashure.
Gadziridza ZAP yeMatter Development muGithub
Paunenge uchishanda neMatter kana Matter-Silicon Labs repos paGithub, isa mamiriro ekunze akasiyana neruremekedzo kuZAP kugadzira/kugadzira mitsva yeZAP magadzirirwo kana kugadzirazve iripoample ZAP zvigadziriso mushure mekushandisa shanduko kwavari. Gadzirisa ZAP_DEVELOPMENT_PATH kuenda kuZAP kubva kwazvakabva nekudhonza ichangoburwa kana kuseta ZAP_INSTALLATION_PATH kuenda kuZAP inozoitwa yawakadhaunirodha kekupedzisira mudhairekitori renzvimbo yako. Ziva kuti kana zvese ZAP_DEVELOPMENT_PATH neZAP_INSTALLATION_PATH zvaiswa, ZAP_DEVELOPMENT_PATH inoshandiswa.
Vanotevera ndeva exampizvo zvinotaridza zviri pamusoro pemamiriro ekunze akasiyana ari kushandiswa:
Kutangisa ZAP uchishandisa Matter kududzira Kugadzirazve ese sample ZAP zvigadziriso zveMatter application
Ongorora: Paunenge uchishandisa ZAP zvinogoneka, ita shuwa kuti uri kushandisa kuburitswa kwepamutemo pamusoro pekuburitswa kwehusiku kuitira kugadzikana. Maona
Kudhawunirodha iyo ZAP Inoita muZAP Kuisa Gaidhi

33/35

Concurrent Multi-protocol pakati peZigbee neMatter
Concurrent Multi-protocol pakati peZigbee neMatter
MCoanttceurrent Multi-protocol pakati peZigbee uye
ZAP inogona kushandiswa kugadzirisa ZCL (Zigbee) uye Data-Model (Matter) zvigadziriso mune yakawanda-protocol application yeZigbee uye Matter. ZAP inokutendera iwe kuti ugadzire mamagumo eZigbee uye Matter zvakajeka mukumisikidzwa kumwe chete. file. Kana Zigbee uye Matter magumo ari pane imwechete yekupedzisira Identifier (yeexample, LO Dimmable Chiedza pamagumo Id 1 uye Matter Dimmable Chiedza pane imwe chiitiko chemagumo 1), ZAP inotarisira kuwiriranisa hunhu hwakajairika pane Matter uye Zigbee hunhu. Ita shuwa kuti maitiro ari kuwiriraniswa ane mhando yedata yakafanana. Humwe hunhu pakati peZigbee neMatter hunosimbiswa kuburikidza ne file inonzi multi-protocol.json . Mushandisi anogona kubatanidza chero masumbu maviri paZigbee uye Matter pamwe neawo anowirirana hunhu vachishandisa cluster uye hunhu macode zvichiteerana. Izvi file inogona kuwanikwa mu [SDKPath]/app/zcl/multi-protocol.json. Izvi file yakagadziridzwa neimwe seti yemasumbu uye hunhu kutanga, asi mushandisi anogona kugadzirisa izvi file sezvinodiwa uye ZAP ichatarisira kuwiriranisa hunhu hwese muZigbee uye Matter kune zvakajairika endpoint identifiers.
Iwe unogona zvakare kuwana dzidziso yeZAP mune chero Zigbee uye Matter multi-protocol application pasi peiyo tutorials peji. Ichi chidzidzo chinokutungamira iwe kuburikidza neakawanda-protocol application yekugadzira maitiro. Ichi chidzidzo chinongowanikwa kana iwe ukavhura iripo yakawanda-protocol application uye inogona kuwanikwa sezvakaratidzwa mumufananidzo pazasi:

34/35

Batanidza SLC CLI neZAP
Batanidza SLC CLI neZAP
Batanidza SLC CLI neZAP
Tevedza nhanho idzi kubatanidza iyo SLC CLI neZAP: ò Isa SLC CLI nekutevera mirairo yekuisa muSiplicity Studio 5 User Guide. ó Isa ZAP nekutevera mirairo iri muZAP Installation Guide. ô Kubatanidza SLC CLI neZAP, wedzera shanduko yenzvimbo STUDIO_ADAPTER_PACK_PATH inonongedza kuZAP application.
directory. õ Rangarira kutangazve SLC CLI Daemon mushure medanho rechitatu. ö Chero chirongwa chinoshandisa ZAP chave kushandisa nzira inotsanangurwa mudanho rechitatu kana yagadzirwa kubva kuSLC CLI. Ndokumbira utarise kune SLC CLI
Kushandiswa kwemirairo pakushandisa SLC CLI yemapurojekiti ako.

35/35

Zvinyorwa / Zvishandiso

SILICON LABS ZAP Kugadzira NeSilicon Labs [pdf] Bhuku reMuridzi
ZAP Kugadzira NeSilicon Labs, ZAP, Kugadzira NeSilicon Labs, Silicon Labs, Labs

References

User Manual

ZAP Kugadzira NeSilicon Labs

Zvinotsanangurwa

Mirayiridzo Yekushandiswa Kwechigadzirwa

FAQs

Kugadzira neSilicon Labs ZAP

ZAP Kutanga

ZAP Installation

ZAP Basics

Custom XML

Custom XML Tags zveZigbee

Multiple Device Types Per Endpoint

Access Control

Kugadzira kodhi yeMatter kana Zigbee

Gadziridza ZAP muStudio

Zvinyorwa / Zvishandiso

References

Siya mhinduro

Kanzura mhinduro