ZAP e Tsoela Pele ka Buka ea Mong'a Silicon Labs

ZAP Ho qala
- Ho qala ka ZAP, latela mehato ena:
  - Khoasolla ZAP e Phethahatsang ho tsoa polokelong ea semmuso.
  - Kenya litšepe ho sebelisa npm install command.
  - Bakeng sa ho kenya Windows ka ho khetheha, sheba Tataiso ea ZAP bakeng sa Windows OS.
Nts'etsopele ea Zigbee
- Haeba u nts'etsapele lits'ebetso tsa Zigbee:
  - Sebelisa Simplicity Studio e kenyelletsang ZAP le lisebelisoa tse ling tse hlokahalang.

Tsoelo-pele ea Litaba
- Haeba u nts'etsapele lits'ebetso tsa Matter:
  - Likhetho li kenyelletsa ho sebelisa Simplicity Studio kapa ho fumana Silicon Labs kapa CSA Github repositories.
  - Sheba litaelo tsa ntlafatso bakeng sa ZAP kantle ho potoloho ea tokollo ea Simplicity Studio ha ho hlokahala.

FAQs

P: Ke mefuta efe e fapaneng ea li-binary tsa ZAP tse fumanehang?
- A: Ho na le mefuta e 'meli e fumanehang - Tokollo ea semmuso e nang le meaho e netefalitsoeng le tokollo ea pele e nang le likarolo tsa morao-rao.

P: Ke lokela ho etsa eng haeba ke kopana le mathata a ho bokella laebrari nakong ea ho kenya?
- A: Sheba lintlha tsa FAQ mabapi le lingoliloeng tse ikhethileng sethaleng ho rarolla mathata a joalo.

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Ho nts'etsapele ka Silicon Labs ZAP

Rea qala
ZAP ea ho qala bochaview Ho kenya ZAP ho kenya ZAP ea Windows FAQ
Lintlha tsa motheo tsa ZAP
Tataiso ea mosebelisi ZAP Tataiso ea mosebelisi Overview XML Custom Custom XML Tags bakeng sa Zigbee Multiple Device Types Per Endpoint Matter Device Type Feature Page Notifications Data-Model/ZCL Specification Compliance Access Control E Qala ZAP bakeng sa Matter kapa Zigbee applications Ho hlahisa khoutu ea Matter kapa Zigbee Update ZAP in Studio Concurrent Multi-protocol between Zigbee le Matter Integrate SLC CLI le ZAPL CLI.

1/35

Ho nts'etsapele ka Silicon Labs ZAP
Ho nts'etsapele ka Silicon Labs ZAP
ZAP
ZAP ke enjene ea ho hlahisa khoutu e akaretsang le sebopeho sa mosebelisi bakeng sa lits'ebetso le lilaebrari tse thehiloeng ho Zigbee Cluster Library ho tsoa Zigbee kapa Data Model from Matter. Tlhaloso e hlahisoa ke Connectivity Standards Alliance. ZAP e u lumella ho etsa ts'ebetso e latelang:
Etsa tlhahiso e ikhethileng ea SDK ea li-artifacts tsa lefats'e (ka linako tsohle, mefuta, li-ID, joalo-joalo) ho latela litlhaloso tsa ZCL/Data-Model. Etsa tlhahiso e ikhethileng ea SDK ea li-artifacts tsa tlhophiso tse khethiloeng ke mosebelisi (tlhophiso ea ts'ebeliso, tlhophiso ea pheletso, joalo-joalo) ho ipapisitse le litlhaloso tsa ZCL/Data-Model le tlhophiso ea kopo e fanoeng ke bareki. Fana ka UI bakeng sa mosebelisi oa ho qetela ho khetha tlhophiso e itseng ea ts'ebeliso (lihlopha, lihlopha, litšobotsi, litaelo, joalo-joalo).

Likahare likarolong tsena li hlalosa mokhoa oa ho hlahisa lisebelisoa tsa Zigbee le Matter ka ho hlophisa Lisebelisoa tsa ZCL (Zigbee) kapa Data Model (Matter) ho sebelisa ZAP.

2/35

ZAP Ho qala

ZAP Ho qala
Ho qala ka ZAP
Likarolo tsena li hlalosa mekhoa e fapaneng ea ho theha lits'ebetso tsa Zigbee le Matter. Hlokomela hore Simplicity Studio e fana ka mokhoa oa ho theha lits'ebetso tsa hau tsa Zigbee le Matter ho tloha pheletsong ho isa qetellong moo lisebelisoa tsohle li tlang li kentsoe pele le Simplicity Studio (ho kenyeletsoa le ZAP). U kanna ua nka qeto ea ho hlahloba mekhoa e meng ea ho theha lits'ebetso tsa hau, joalo ka ha ho hlalositsoe mona.
Nts'etsopele ea Zigbee
Basebelisi ba kopo ea Zigbee ba ka theha lits'ebetso tsa bona ba sebelisa Simplicity Studio, e seng e kenyelletsa ZAP le lisebelisoa tse ling tse u thusang ho aha kopo ea hau ho tloha pheletsong ho isa qetellong.
Tsoelo-pele ea Litaba
Basebelisi ba Matter Application ba ka aha lits'ebetso tsa bona ba sebelisa mekhoa e latelang: Studio ea Bonolo: Sena se kenyelletsa ZAP le lisebelisoa tse ling tse hlokahalang ho aha pheletso ea kopo ea Matter hore e fele. Github (Silicon Labs) Github (CSA)
Tlhokomeliso: Ho nchafatsa ZAP kantle ho potoloho ea tokollo ea Simplicity Studio, bona ntlafatso ea ZAP ho Simplicity Studio le Tataiso ea ho Kenya ea ZAP.

3/35

Ho kenya ZAP

Likarolo tse latelang li hlalosa ts'ebetso ea ZAP le mokhoa oa ho nchafatsa ZAP ho Simplicity Studio IDE.
Khothalletsa ZAP e ka Phethahatso e khothalelitsoeng)
Ona ke mokhoa o khothaletsoang oa ho qala ka ZAP. U ka fumana li-binary tsa ZAP tsa morao-rao ho tloha ho aa https://github.com/project-chip/zp/releses. Li-binaries tse hahiloeng esale pele li tla ka mefuta e 'meli e fapaneng.
Phatlalatso ea semmuso: Meaho e netefalitsoeng e nang le lisutu tsa tlhahlobo tsa Matter le Zigbee tse inehetseng. Sebopeho sa lebitso la tokollo ke vYYYY.DD.MM. E lokollotsoe esale pele: E hahiloe ka likarolo tsa morao-rao le litokiso tsa liphoso, empa meaho ena HA E KHOAFATSOE ka lisutu tsa tlhahlobo tsa Matter le Zigbee. Sebopeho sa lebitso la tokollo ke vYYYY.DD.MM-bosiu.
Ho kenya ZAP ho tsoa Mohloling
Litaelo tsa mantlha tsa ho kenya ZAP
Hobane sena ke sesebelisoa sa node.js, o hloka tikoloho ea node e kenngoe. Mokhoa o motle oa ho etsa sena ke ho khoasolla sesebelisoa sa morao-rao sa node, se kenyelletsang node le npm. Haeba u na le mofuta oa khale oa node e kentsoeng setsing sa hau sa mosebetsi, e ka baka mathata, haholo haeba e tsofetse haholo. Etsa bonnete ba hore u na le mofuta oa morao-rao oa node v16.x o nang le npm e kenyellelitsoeng. Matha node -version ho lekola hore na ho nkuoa mofuta ofe. v18.x e kgothaletswa. Kamora ho ba le mofuta o lakatsehang oa node, o ka tsamaisa tse latelang:
Kenya li-Dependencies
Sebelisa litaelo tse latelang ho kenya li- dependencies :

npm kenya
Tlhokomeliso: Bakeng sa ho kenya ZAP ka mokhoa o ikhethileng oa Windows, sheba ho Kenya ZAP bakeng sa Windows OS Ho na le lingoloa tse fapaneng tsa src-script/install-* bakeng sa li-platform tse fapaneng. Sheba lintlha tsa FAQ mabapi le hore na ke sengoloa sefe se lokelang ho sebetsoa sethaleng se fapaneng ebe u sebelisa hape npm install .
Qala Kopo
Sebelisa litaelo tse latelang ho qala sesebelisoa:

npm matha zap
Qala Front-End ho Mokhoa oa Ntlafatso
E ts'ehetsa ho kenya khoutu e chesang hape, tlaleho ea liphoso, joalo-joalo. Sebelisa litaelo tse latelang ho qala karolo e ka pele ho nts'etsopele
mokhoa:
quasar dev -m electron
or

4/35

ZAP Insta o tla kena
npm tsamaisa electron-dev

5/35

ZAP ea ho kenya Windows
ZAP ea ho kenya Windows
Ho kenya ZAP bakeng sa Windows OS
1. Windows Powershell
Ka har'a bareng ea ho batla ea komporo, kenya Windows Powershell 'me u sebetse joalo ka motsamaisi. Sebelisa litaelo tsohle tse latelang ka har'a Powershell.
2. Tsokolate
Kenya ho tloha https://chocolatey.org/install. Sheba hore na e kentsoe hantle ka litaelo tse latelang:
choko -v
Kenya sephutheloana sa pkgconfiglite ka litaelo tse latelang:
choco kenya pkgconfiglite
3. Kenya Node
Etsa litaelo tse latelang ho kenya:
choco kenya nodejs-lts
* Phetolelo e tlameha ho ba 18 ho feta tlhahlobo ea tlhahlobo ea tlhahlobo, ka mor'a ho kenya, hlahloba le node -v * Haeba u se u kentse Node, 'me u hlōle liteko tse ling tse tšoanang le ho se fumane Node, khutlisetsa Node ka chokolete hape.
4. Latela Litaelo tsa Motheo ho kenya ZAP
Latela litaelo tsa ho instola tsa ZAP ho tsoa mohloling ho Kenyelletso ea ZAP. Ha u ntse u latela litaelo tsa mantlha tsa ho kenya ZAP ela hloko liphoso tse latelang le mokhoa oa ho li rarolla:
sqlite3
Ha u sebelisa ZAP (mohlala, npm run zap ), haeba u bona phoso ka sqlite3.node fensetereng e hlahang, matha:
npm tsosolosa sqlite3
sehahi sa elektronike
Ha u etsa npm kenya, ka mor'a ho kenya, haeba phoso e etsahala ka taelo e latelang e amanang le li-electron-builder install-appdeps, npx electron-rebuild canvas e hlōlehile kapa node-pre-gyp , phetolelo ea hona joale ea canvas ha e lumellane le Windows mme phoso ea ho kenya e ke ke ea baka ho hlōleha ho sebetsa ZAP. node-canvas e ntse e sebetsa tharollong hona joale mme taba e tla rarolloa haufinyane.
"postinstall": "electron-builder install-app-deps && husky install && npm rebuild canvas -update-binary && npm run version-stamp”

6/35

ZAP ea ho kenya Windows
Canvas
Haeba npm run test e hloleha ka lebaka la phoso Test suite e hlolehile ho sebetsa. Ha e khone ho fumana mojule '../build/Release/canvas.node' kapa
zapnode_modulescanvasbuildReleasecanvas.node ha se ts'ebeliso e nepahetseng ea Win32. , tsosolosa seile ka tsela e latelang:
npm haha hape seile -update-binary
fumana index.html kapa Mathata a Mang a Seva
Haeba npm run test e hloleha ka lebaka la phoso fumana index.html kopo e hlotsoe ka khoutu ea boemo 404 litekong tsa yuniti kapa ho ba le seva.
litaba tsa khokahano litekong tsa e2e-ci, tsamaisa litaelo tse latelang:
npm matha haha
Tse ding
Sheba hore na mofuta oa node ke v18 'me u leke ho e kenya ka Chocolatey.

7/35

LBH
LBH
Lipotso Tse Botsoang Hangata
P: U ka qala UI joang ka mokhoa oa nts'etsopele? A: O ka qala UI ka mokhoa oa nts'etsopele, e leng se tla fella ka tlhophiso e latelang:
Seva ea HTTP e arohaneng ea quasar, e lulang e khatholla boema-kepeng ba 8080 ZAP e sebetsang ho port 9070 Chrome kapa sebatli se seng, e sebetsang ka boikemelo Ho fihla ho setupong seo, latela litaelo tse ka tlase. ò Ntlha ea pele, tsamaisa seva ea nts'etsopele ea ZAP, e qalang ho port 9070.
npm matha zap-devserver ó E latelang, tsamaisa seva sa nts'etsopele ea quasar, e qalang ho port 8080.
quasar dev ô Supa sebatli sa hau kapa u tsamaise se seng khahlanong le se nepahetseng URL ka khang ea restPort:
google-chrome http://localhost:8080/?restPort=9070

Q: Mokhoa oa ho etsa hore e sebetse ho Mac / Linux OS? A:
npm install e sebelisoa ho khoasolla liphutheloana tsohle tse hlokahalang. Haeba u bona liphoso tse amanang le li-node-gyp le lilaebrari tsa lehae tse sieo, joalo ka pixman, joalo-joalo, u haelloa ke litšepeho tsa matsoalloa ho khotsofatsa ho bokella li-binary tse sa hahoang esale pele bakeng sa motsoako o itseng oa sethala le liphetolelo. Npm lerung e lula e nchafatsa lenane la li-binaries tse fanoeng, kahoo ho ka etsahala hore o tla li nka hantle, empa haeba u sa etse joalo, tsena ke litaelo tsa li-platform tse fapaneng:
Fedora Core e nang le dnf:
dnf kenya pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
kapa tsamaisa script:
src-script/install-packages-fedora
Ubuntu e nang le apt-get:
apt-fumana ntjhafatso apt-get install -fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
kapa tsamaisa script:

8/35

LBH
src-script/install-packages-ubuntu
OSX ho Mac e nang le Homebrew brew:
brew install pkg-config cairo pango libpng jpeg giflib librsvg
kapa tsamaisa script:
src-script/install-packages-osx
Q: Mokhoa oa ho etsa hore sena se sebetse ho Windows OS?
K: Etsa bonnete ba hore e lula e le nakong 'me ha ho na liphetoho tse so kang li etsoa. Keletso: git pull, boemo ba git & git stash ke metsoalle ea hau. U tlameha ho sebelisa Chocolately ho etsa hore Zap e sebetse ho Windows OS. Etsa bonnete ba hore o khoasolla sephutheloana sa pkgconfiglite.
choco kenya pkgconfiglite
Haeba u na le mathata le Cairo, mohlalaample haeba u fumana phoso ka cairo.h': Ha ho joalo file kapa directory, etsa tse latelang: ò Hlahloba hore na komporo ea hau e 32 kapa 64 bit. ó Ho itšetlehile ka seo, khoasolla sephutheloana se nepahetseng sebakeng sena sa marang-rang
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:
Tobetsa ho Advanced System Settings. Ho tab e tsoetseng pele, tobetsa ho Environment Variables. Karolong ea Liphetoho tsa Sistimi, fumana mofuta oa PATH oa tikoloho ebe u o khetha. Tobetsa Edita 'me u kenye C:/GTK ho eona. Haeba phapang ea tikoloho ea PATH e le sieo, tobetsa Ncha. Haeba jpeglib.h e sa fumanwe, leka tse latelang: ò Ho theminale, matha: choco kenya libjpeg-turbo ó Etsa bonnete ba hore e hlwekile ka ho sebedisa: git clean -dxff and run npm install again ô haeba ho se diphoso tse hlahang mme ho hlaha ditemoso feela, leka ho sebedisa npm audit fix õ ha o sa kgone ho tsamaisa ZAP, eya ho file src-script/zap-start.js ö Fetola
÷ const { spawn } = hloka('cross-spawn') to const { spawn } = hloka('child_process') ø Matha npm 'me u tsamaise zap. Litšupiso:
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)
P: Ke fumana phoso "sqlite3_node" ha e fumanehe kapa e tšoanang.

9/35

LBH
A: Theha bocha litlamo tsa hau tsa tlhaho tsa sqlite3. Ho lokisa sena hangata, matha:
npm kenya
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Haeba e ntse e sa lokisoe, etsa:
rm -rf node_modules ebe u leka litaelo tse ka holimo hape. Ka linako tse ling ho ntlafatsa npm ea hau ho boetse ho etsa phapang:
npm kenya -g npm
P: Ke fumana phoso "Mofuta oa N-API oa mohlala ona oa Node ke 1. Mojule ona o tšehetsa mofuta oa 3 oa N-API. Mohlala ona oa Node ha o khone ho tsamaisa mojule ona."
A: Ntlafatsa mofuta oa hau oa node. Tharollo ea sena e tšohloa khoeleng ena ea Stack Overflow: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
P: PC ea ka ea nts'etsopele ha e sebetse le ZAP ka lebaka lefe kapa lefe. A na nka sebelisa sejana sa docker?
A: E, u ka khona. TBD.
P: Ke tsamaisa ZAP joang ka har'a VSCode?
A: Haeba u VSCode tseleng ea hau kenya zap repo ebe u ngola khoutu. Sena se tla bula ZAP ho VSCode. Ho tsamaisa ZAP ka mokhoa oa ho lokisa liphoso, khetha sebaka sa tšebetso sa ZAP ebe o tobetsa konopo ea Matha e letsohong le letšehali. U tla ba le likhetho tse 'maloa tseo u ka khethang ho tsona ho tsamaisa ZAP, khetha Node.js Debug Terminal. Sena se tla bula fensetere ea ho qetela eo u ka kenang ho eona npm run zap , e tla hokela debugger ebe e tsamaisa ZAP joalo ka ha u ne u tloaetse ho tsoa moleng oa taelo. Kea u lebohela, joale u lokela ho bona ZAP e sebetsa ho debugger. U ka beha li-breakpoints ho VSCode joalo ka ha u ne u ka etsa ho IDE efe kapa efe.
P: Teko ea yuniti ea UI e hloleha ka liphoso tse ling ho potoloha canvas e sa haheng bakeng sa mofuta o nepahetseng oa node. Ke etsa'ng?
A: Haeba u bona phoso e latelang:
FAIL test/ui.test.js Sehlopha sa teko se hlotswe ho sebetsa Mojuleng wa 'canvas.node' o hlophisitswe kgahlanong le mofuta o fapaneng wa Node.js o sebedisa NODE_MODULE_VERSION 80. Mofuta ona wa Node.js o hloka NODE_MODULE_VERSION 72. Ka kopo, leka ho bopa kapa ho kenya hape mojule oo (ka mohlala, ka mohlala, kenya hape.
ho Ntho. (node_modules/canvas/lib/bindings.js:3 18)
ebe o matha: npm rebuild canvas -update-binary

10/35

Metheo ea ZAP

ZCL/Data-Model tsa ZAP Metheo
Karolo ena e na le lintlha tsa basebelisi ba bacha ba ZAP. Tobetsa lets'oao la thuto hukung e kaholimo ho le letona la ZAP UI, e bonts'ang mokhoa oa ho theha tlhophiso ea ZAP. Thupelo e tla u tataisa ho tse latelang: Etsa ntlha ea ho qetela Kgetha mofuta wa sesebediswa Lokisa sehlopha Lokisa sebopeho Beakanya taelo Bakeng sa tšupiso e felletseng, bona Zigbee Cluster Configurator Guide.

11/35

Tataiso ea mosebelisi ea ZAP
Tataiso ea mosebelisi ea ZAP
Tataiso ea mosebelisi ea ZAP
Likarolo tse tlas'a tataiso ena li fana ka lintlha tse ling mabapi le likarolo tse fapaneng tse fanoeng ke ZAP.

12/35

XML e tloaelehileng

E eketsa Custom XML ho tsoa ho ZAP UI
Tobetsa ho "Extensions" ho ZAP UI. Tobetsa konopo ea "+" ho khetha xml e tloaelehileng file Lihlopha tsa tloaelo, litšoaneleho, litaelo, joalo-joalo li lokela ho hlaha ho ZAP UI hang ha xml ea tloaelo e kentsoe.
Ho iketsetsa XML ea hau ho Zigbee
Karolo e bontša mokhoa oa ho iketsetsa lihlopha tsa hau tsa tloaelo le ho atolosa lihlopha tse teng tse tloaelehileng ka litšobotsi le litaelo tsa Zigbee.
Lihlopha tse Khethehileng tsa Moetsi ho Zigbee
O ka eketsa lihlopha tse ikhethileng tsa moetsi ho pro e tloaelehilengfile. Re fana ka exampka sena ka tlase. Ho etsa sena o tlameha ho phethahatsa litlamo tse peli:
ID ea sehlopha E TLAMEHA ho ba maemong a ikhethileng a moetsi, 0xfc00 - 0xffff. Tlhaloso ea sehlopha e tlameha ho kenyelletsa khoutu ea moetsi e tla sebelisoa ho litšoaneleho le litaelo TSOHLE ka har'a sehlopha seo 'me e tlameha ho fanoa ha ho romela le ho amohela litaelo le ho sebelisana le litšobotsi. ExampLe:

Sample Mfg Specific Cluster Kakaretso Sehlopha sena se fana ka example hore na Moralo oa Kopo o ka atolosoa joang ho kenyelletsa lihlopha tse ikhethileng tsa moetsi.
0xFC00
ember sample tšobotsi
ember sample tšobotsi 2

A sample taelo e khethehileng ea moetsi ka hare ho sample moetsi ka ho khetheha
sehlopha.

Litaelo tse Khethehileng tsa Moetsi Sehlopheng sa Standard Zigbee
O ka eketsa litaelo tsa hau sehlopheng sefe kapa sefe se tloaelehileng sa Zigbee ka litlhoko tse latelang:
Litaelo tse khethehileng tsa moetsi li ka sebelisa id ea taelo efe kapa efe ka har'a lethathamo la id ea taelo, 0x00 - 0xff. Hape o tlameha ho fana ka khoutu ea moetsi bakeng sa taelo e le hore e ka khetholloa ho litaelo tse ling sehlopheng le ho tšoaroa ka nepo. Example ea ho holisa sehlopha sa On/Off ka litaelo tsa tlhahiso:

13/35

XML e tloaelehileng
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” boikhethelo=”nete” moetsiCode=”0 1002″> Taelo ea moreki e timang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificOnWithTransition” optional=”nete” moetsiCode=”0 1002″> Taelo ea moreki e bulelang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificToggleWithTransition” optional=”nete” moetsiCode="0 1002″> Taelo ea moreki e fetolang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificOnWithTransition2″ boikhethelo=”nete” moetsiCode="0 1049″> Taelo ea moreki e bulelang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificToggleWithTransition2″ boikhethelo=”nete”
moetsiCode=”0 1049″> Taelo ea moreki e fetolang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.

Litšobotsi tse Khethehileng tsa Moetsi ho Sehlopha se Tloaelehileng sa Zigbee
U ka eketsa litšoaneleho tsa hau ho sehlopha sefe kapa sefe se tloaelehileng sa Zigbee ka litlhoko tse latelang:
Litšobotsi tse ikhethileng tsa moetsi li ka sebelisa id ea mofuta ofe kapa ofe ka har'a mofuta oa id, 0x0000 - 0xffff. Hape o tlameha ho fana ka khoutu ea moetsi bakeng sa tšobotsi e le hore e ka khetholloa ho litšobotsi tse ling sehlopheng le ho tšoaroa ka nepo. Example ho holisa sehlopha sa On/Off ka litšobotsi tsa tlhahiso:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” mofuta=”INT16U” min="0 0000″
max=”0xFFFF” writable=”nete” default=”0 0000″ boikhethelo=”nete” moetsiCode=”0 1002″>Sample Mfg Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 0 0001 0 1040
Ho iketsetsa XML ea hau ho Matter
Karolo e bontša mokhoa oa ho iketsetsa lihlopha tsa hau tsa tloaelo le ho atolosa lihlopha tse teng tse tloaelehileng ka litšobotsi le litaelo tsa Matter.
Lihlopha tse Ikemetseng tsa Moetsi ka Taba
O ka eketsa lihlopha tse ikhethileng tsa moetsi ho Matter. Re fana ka exampka sena ka tlase.
is a 32-bit combination of the manufacturer code and the id for the cluster. (required) The most significant 16 bits are the manufacturer code. The range for test manufacturer codes is 0xFFF1 – 0xFFF4. The least significant 16 bits are the cluster id. The range for manufacturer-specific clusters are: 0xFC00 – 0xFFFE.

14/35

XML e tloaelehileng
Ho e latelang example, motsoako oa ID ea morekisi (ID ea Moetsi oa Teko) ea 0xFFF1 le ID ea sehlopha sa 0xFC20 e hlahisa value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. ExampLe:
Kakaretso Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER The SampSehlopha sa MEI se bonts'a lisebelisoa tsa moetsi oa lihlopha Flip flop
Karabo ea AddArguments e khutlisetsang kakaretso. Taelo e nkang likhang tse peli tsa uint8 ebe e khutlisa kakaretso ea tsona. Taelo e bonolo ntle le li-parameter le ntle le karabo.
Litšobotsi tse Khethehileng tsa Moetsi ho Li-Standard Matter Clusters
O ka eketsa litšoaneleho tse khethehileng tsa moetsi ho sehlopha sefe kapa sefe se tloaelehileng sa Matter ka litlhoko tse latelang:
Ehlile o kopanya lintlha tse ntseng li eketsoa li tlameha ho hlalosoa -
e xte nd ed > ">
Khoutu ea tšobotsi ke motsoako oa 32-bit oa khoutu ea moetsi le id bakeng sa tšobotsi. Li-bits tsa bohlokoa ka ho fetisisa tse 16 ke khoutu ea moetsi. Mefuta e fapaneng ea likhoutu tsa moetsi oa liteko ke 0xFFF1 - 0xFFF4. Li-bits tse 16 tse bohlokoa haholo ke ID ea semelo. Lethathamo la litšoaneleho tse seng tsa lefats'e ke 0x0000 - 0x4FFF.
Example ho holisa sehlopha sa On/Off Matter se nang le litšobotsi tse ikhethileng tsa moetsi:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ mofuta=”INT8U” min="0 0000″
max=”0xFFFF”writable=”nete” default=”0 0000″ boikhethelo="nete”>Sample Mfg Tšobotsi e khethehileng ea 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ mofuta=”INT16U” min="0 0000″
max=”0xFFFF”writable=”nete” default=”0 0000″ boikhethelo="nete”>Sample Mfg Specific Attribute 4
Litaelo tse Khethehileng tsa Moetsi ho Lihlopha tse Tloaelehileng tsa Matter
O ka eketsa litaelo tse khethehileng tsa moetsi ho sehlopha sefe kapa sefe se tloaelehileng sa Matter se nang le litlhoko tse latelang:
Ehlile o kopanya taba ea hore litaelo tse kenyelletsoang ho tsona li tlameha ho hlalosoa -
e xte nd ed > ">
Khoutu ea taelo ke motsoako oa 32-bit oa khoutu ea moetsi le id bakeng sa taelo. Li-bits tsa bohlokoa ka ho fetisisa tse 16 ke khoutu ea moetsi. Mefuta e fapaneng ea likhoutu tsa moetsi oa liteko ke 0xFFF1 - 0xFFF4. Li-bits tsa bohlokoa tse 16 ke ID ea taelo. Lethathamo la litaelo tseo e seng tsa lefats'e ke 0x0000 - 0x00FF.
Example ho holisa sehlopha sa On/Off Matter se nang le lihlopha tse ikhethileng tsa moetsi:

15/35

XML e tloaelehileng

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ boikhethelo=”nete”> Taelo ea moreki e bulelang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ boikhethelo=”nete”>
Taelo ea moreki e fetolang sesebelisoa ka phetoho e fanoeng ke nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.

16/35

XML e tloaelehileng Tags bakeng sa Zigbee

Tokomane e latelang e bua ka e 'ngoe le e' ngoe ea xml tags e amanang le Zigbee.
xml ka 'ngoe file e thathamisitsoe lipakeng tsa configurator tags:

Mefuta ea data e ka hlalosoa ka har'a configurator tag. Hajoale Zigbee e tšehetsa tlhaloso ea li-bitmaps, enums, integers, strings kapa structs. Pele o hlalosa mefuta e meng etsa bonnete ba hore o hlahloba mefuta eohle e teng ea athomo e hlalosoang ka mefuta.xml le mefuta eohle eo e seng ea athomo e hlalositsoeng ho xml e 'ngoe. files. U ka li hlalosa ka tsela e latelang:
Bitmap: lebitso: lebitso la mofuta oa bitmap. mofuta: Bitmap e nang le boholo bo pakeng tsa 8-64 bits e ka hlalosoa, kaofela ha eona e lokela ho ba li-multiples tsa 8. Bitmap e 'ngoe le e' ngoe e ka ba le masimo a mangata a nang le lebitso le mask a amanang le eona. mohlala:

"`
Enum: lebitso: lebitso la mofuta oa enum. mofuta: Enum e nang le boholo bo pakeng tsa 8-64 bits e ka hlalosoa, kaofela ha eona e lokela ho ba li-multiples tsa 8. Enum ka 'ngoe e ka ba le lintho tse ngata tse nang le lebitso le boleng bo amanang le eona. mohlala:

Integer: Mefuta e mengata e se e hlalositsoe tlas'a mefuta ea athomo e teng ka mefuta.xml. Boholo ba tsona bo ka tloha ho li-bits tse 8-64 'me li ka saena kapa tsa sa saena. mohlala:

Khoele: Mefuta ea likhoele e se e hlalositsoe tlasa mefuta ea athomo e teng ka mefuta.xml. Mefuta ea hona joale ea likhoele e kenyelletsa khoele ea octet, char string, khoele e telele ea octet le khoele e telele ea char mohlala:

Sebopeho: lebitso: lebitso la mofuta oa sebopeho. Sebopeho se seng le se seng se ka ba le lintho tse ngata tse nang le lebitso le mofuta o amanang le tsona. Mofuta o ka ba mefuta efe kapa efe e boletsoeng esale pele tlasa mefuta ea data. mohlala:

17/35

XML e tloaelehileng Tags bakeng sa Zigbee

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

Li-Cluster tsa Custom li ka hlalosoa ka har'a configurator tag. name: lebitso la sehlopha sa sehlopha: domain name ea sehlopha. Sehlopha se tla hlaha ho ZAP UI tlas'a sebaka sena. tlhaloso: Descirption of the cluster code: cluster code define: cluster define which is used by code generator ho hlalosa sehlopha ka tsela e itseng moetsiCode: E sebelisoa ho hlalosa sehlopha se khethehileng sa tlhahiso. Sena se tlameha ho ba pakeng tsa 0xfc00 - 0xffff. Khoutu ea moetsi bakeng sa sehlopha e hloka ho hlalosoa ka tsela e latelang:

Sehlopha sa tlhahiso se iketsetsa litšoaneleho le litaelo ka tlas'a eona tsa khoutu e tšoanang ea moetsi ntle le haeba li thathamisa ka ho hlaka khoutu ea moetsi. introducedIn: E sebelisetsoa ho fumana mofuta o itseng oo sehlopha se kentsoeng ka oona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. removeIn: E sebelisoa ho fumana mofuta o itseng oo sehlopha se tlositsoeng ho ona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. singleton(boolean): E sebelisetsoa ho khetholla sehlopha e le singleton hoo ho nang le mohlala o le mong feela oa sehlopha seo se arolelanoang ho pholletsa le li-endpoints. tšobotsi: e hlalosa tšobotsi bakeng sa lebitso la sehlopha: Lebitso la tšobotsi le boletsoe lipakeng tsa tšobotsi. tag.
lebitso la semelo
side(client/server): Lehlakore la sehlopha leo tšobotsi e amanang le lona le lona. khoutu: tšobotsi khoutu ea moetsi khoutu: Sena se ka sebelisoa ho hlalosa tšobotsi e khethehileng ea moetsi ka ntle ho tlhaloso ea zigbee e boletsoeng ke xml e tloaelehileng. define: attribute define e sebelisoang ke code generator ho hlalosa tšobotsi ka tsela e itseng: mofuta oa tšobotsi oo e ka bang ofe kapa ofe oa mefuta ea data e boletsoeng ho xml default: boleng ba kamehla bakeng sa tšobotsi. mets: Bonyane bo lumelletsoeng boleng ba max: Bongata bo lumelletsoeng ba boleng bo ka ngoloang: Na boleng ba tšobotsi boa ngoloa kapa che. Sena se ka sebelisoa ho thibela tšobotsi ho fetoloa ka litaelo tsa ho ngola. optional(boolean): E sebelisoa ho fumana hore na tšobotsi ke ea boikhethelo kapa che bakeng sa sehlopha. min: Bonyane bo lumelletsoeng boleng ba tšobotsi ha e le palo e felletseng, enum kapa mofuta oa bitmap. max: Bolelele ba boleng bo lumelletsoeng bakeng sa tšobotsi ha e le bolelele ba mofuta o felletseng, enum kapa bitmap: E sebelisoa ho hlakisa boholo ba bolelele ba tšobotsi ha e le mofuta oa khoele. minLength: E sebelisoa ho bolela bolelele ba bonyane ba tšobotsi ha e le mofuta oa khoele. reportable(boolean): E bolela hore na tšobotsi e ka tlalehoa kapa che e ke keng ea khoneha(boolean): E lumella boleng ba lefeela bakeng sa tšobotsi. array(boolean): E sebelisoa ho phatlalatsa tšobotsi ea mofuta oa mofuta. introducedIn: E sebelisoa ho fumana mofuta o itseng oo tšobotsi e hlahisitsoeng ka eona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. removeIn: E sebelisoa ho fumana mofuta o itseng oo tšobotsi e tlositsoeng ka eona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. taelo: hlalosa taelo bakeng sa lebitso la sehlopha: Lebitso la taelo.

khoutu: khoutu ea taelo

18/35

XML e tloaelehileng Tags bakeng sa Zigbee
khoutu ea moetsi: Sena se ka sebelisoa ho hlalosa taelo e khethehileng ea moetsi ka ntle ho li-zigbee tse boletsoeng ke xml e tloaelehileng. tlhaloso: tlhaloso ea mohloli oa taelo (moreki / seva): mohloli oa taelo. optional(boolean): E sebelisoa ho fumana hore na taelo ke ea boikhethelo kapa che bakeng sa sehlopha. introducedIn: E sebelisetsoa ho fumana mofuta o itseng oo taelo e kentsoeng ka oona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. removeIn: E sebelisoa ho tseba mofuta o itseng oo taelo e tlositsoeng ho eona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. litaelo tsa mabaka:
Taelo e 'ngoe le e' ngoe e ka ba le sehlopha sa mabaka a taelo ea lebitso: lebitso la mofuta oa khang ea taelo: mofuta oa khang ea taelo e ka bang mofuta ofe kapa ofe oa mefuta e boletsoeng ho xml. min: Bonyane bo lumelletsoeng ba khang ha e le palo e felletseng, enum kapa mofuta oa bitmap. max: Bolelele ba boleng bo lumelletsoeng bakeng sa khang ha e le bolelele ba mofuta o felletseng, enum kapa bitmap: E sebelisoa ho totobatsa bolelele bo lumelletsoeng ba khang ea taelo ha e le mofuta oa khoele. minLength: E sebelisoa ho bolela bolelele bo tlase bo lumelletsoeng bakeng sa khang ea taelo ha e le mofuta oa khoele. array(boolean): Ho fumana hore na khang ea taelo ke ea mofuta oa mofuta. presentIf(string): Ena e ka ba letoto le nang le maemo a ts'ebetso e thehiloeng ho mabaka a mang a taelo moo o ka lebellang khang ea taelo haeba khoele ea maemo e lekola 'nete. mohlala:

Tlhokomeliso: Mona boemo ke lebitso le leng la khang ea taelo. optional(boolean): E sebelisoa ho fumana hore khang ea taelo ke ea boikhethelo. countArg: E sebelisoa ha khang ea taelo e le ea mofuta oa mofuta. Sena se sebelisetsoa ho bolela khang e 'ngoe ea taelo e bolelang boholo ba sehlopha sa khang ena.

introducedIn: E sebelisetsoa ho fumana mofuta o itseng oo ho hlahisitsoeng khang ea taelo ho oona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. tloswaKa: E sebelisoa ho fumana mofuta o itseng oo ho tlositsoeng khang ea taelo ho oona. Sena se sebelisoa ke jenereithara ea khoutu ho eketsa logic e eketsehileng. Cluster Extension e ka hlalosoa ka har'a configurator tag. Katoloso ea Cluster e sebelisoa ho holisa sehlopha se tloaelehileng se nang le litšobotsi tsa tlhahiso le litaelo, mohlala

19/35

XML e tloaelehileng Tags bakeng sa Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ optional=”true” manufacturerCode=”0 1002″>Sample Mfg Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 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 Tšobotsi e Khethehileng: 0 0001 0 1040ampleMfgSpecificOffWithTransition” boikhethelo=”nete” moetsiCode=”0 1002″> Taelo ea moreki e timang sesebelisoa ka phetoho e fanoeng
ka nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificOnWithTransition” optional=”nete” moetsiCode=”0 1002″> Taelo ea moreki e bulelang sesebelisoa ka phetoho e fanoeng
ka nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificToggleWithTransition” optional=”nete” moetsiCode=”0 1002″> Taelo ea moreki e fetolang sesebelisoa ka phetoho e fanoeng
ka nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificOnWithTransition2″ boikhethelo=”nete” moetsiCode="0 1049″> Taelo ea moreki e bulelang sesebelisoa ka phetoho e fanoeng
ka nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.ampleMfgSpecificToggleWithTransition2″ boikhethelo=”nete” moetsiCode="0 1049″> Taelo ea moreki e fetolang sesebelisoa ka phetoho e fanoeng
ka nako ea phetoho ho Ember Sample tšobotsi ea nako ea phetoho.

20/35

Mefuta e mengata ea lisebelisoa ho ea ka ntlha ea ho qetela

Ena ke karolo ea Matter-feela moo mosebelisi a ka khethang mefuta e fetang e le 'ngoe ea lisebelisoa ka ntlha e 'ngoe. Keketso ea mefuta e mengata ea lisebelisoa tsa aaa e tla kenyelletsa litlhophiso tsa sehlopha ka har'a mefuta ea sesebelisoa ho ea ho endpoint configur tion.

21/35

Mefuta e mengata ea lisebelisoa ho ea ka ntlha ea ho qetela

Setšoantšo se ka holimo se bontša hore ntlha ea 1 e na le mefuta e fetang e le 'ngoe e khethiloeng. "Sesebelisoa sa mantlha" se bolela mofuta oa sesebelisoa seo pheletso e tla amahanngoa le sona. Mofuta oa mantlha oa sesebelisoa o lula o le teng ho index 0 ea lenane la mefuta ea lisebelisoa tse khethiloeng, kahoo ho khetha mofuta o fapaneng oa lisebelisoa ho tla fetola odara ea mefuta e khethiloeng. Khetho ea mofuta oa sesebelisoa e boetse e na le lithibelo tse thehiloeng ho Tlhaloso ea Data Model. ZAP e sireletsa basebelisi ho khetha mefuta e sa nepahalang ea mefuta ea lisebelisoa qetellong ea ho sebelisa lithibelo tsena.

22/35

Leqephe la Mofuta oa Sesebelisoa sa Matter
Leqephe la Mofuta oa Sesebelisoa sa Matter
Leqephe la Mofuta oa Sesebelisoa sa Matter
ZAP e ts'ehetsa ho bona le ho fetola likarolo tsa Matter leqepheng la mofuta oa sesebelisoa. Ke likarolo tsa mofuta oa sesebelisoa feela tse boletsoeng ho matter-devices.xml sebakeng sa polokelo ea CHIP tse tla hlahisoa.

Ho ea leqepheng la Feature
ò Qala ZAP ho Matter e nang le Matter SDK ea morao-rao. ó Etsa sebaka sa ho qetela ka mofuta oa sesebelisoa sa Matter. ô Tobetsa konopo ea Likarolo tsa Mofuta oa Sesebelisoa bohareng ba sehlopha view. Hlokomela hore konopo ena e fumaneha feela ho ZAP
Litlhophiso tsa Matter le ha data ea conformance e le teng ho Matter SDK. Ho tobetsa konopo ena ho tla bula setšoantšo se ka holimo.
Ho lumellana
Conformance e hlalosa boikhethelo le ho its'etleha bakeng sa litšobotsi, litaelo, liketsahalo, le mefuta ea data. E etsa qeto ea hore na ho na le ntho e tlamang, ea boikhethelo, kapa ha e tšehetsoe tlas'a tlhophiso e itseng ea ZAP.
Sebopeho sa mofuta oa sesebelisoa se tla pele ho feta sebopeho sa cluster. Bakeng sa mohlalaample, tšobotsi ea Leseli e na le boikhethelo ba ho lumellana ho sehlopha sa On/Off empa se phatlalatsoa e le tlamo mofuteng oa sesebelisoa sa On/Off Light se kenyeletsang sehlopha sa On/Off. Ho theha sebaka sa ho qetela ka mofuta oa sesebelisoa sa On / Off Light ho tla bontša tšobotsi ea Leseli e le tlamo leqepheng la likarolo.
Feature Toggling
Leqepheng la likarolo, ka mor'a hore u tobetse konopo ea toggle ho nolofalletsa kapa ho tima tšobotsi, ZAP e tla:
Ntlafatsa likarolo tse amanang (litšoaneleho, litaelo, liketsahalo) ho lokisa tšebelisano, le ho bonts'a puisano e bonts'ang liphetoho.

23/35

Leqephe la Mofuta oa Sesebediswa sa Matter Ntlafatsa karoloana ho tšobotsiMapa ea tšobotsi ea sehlopha se amanang

Numella Feature Dialogue

Thibela Feature Dialogue

Toggling e koetsoe bakeng sa likarolo tse ling ha ho lumellana ha tsona ho na le boleng bo sa tsejoeng kapa foromo ea hajoale e sa tšehetsoeng ke t. Tabeng ena, ZAP e tla bontša litemoso ho ap ne.
a Wa Element Conform nce ringings

Ha o fetola element, ZAP e ka hlahisa litemoso tsa ho latela melao ea sesebelisoa le litemoso tsa ho se tsamaisana. Haeba boemo ba element bo sa tsamaisane le maemo a lebelletsoeng, ZAP e tla hlahisa lets'oao la temoso mme e ngole temoso ho ap ne. ExampLe ea litemoso tsa boikamahanyo le tsa tumellano tse bonts'itsoeng ntho e itseng:

24/35

Litsebiso
Litsebiso
Litsebiso
Karolo e latelang e hlalosa kamoo litsebiso li fuoang basebelisi ba ZAP ho UI.
Litsebiso tsa Sephutheloana
Litsebiso tsa sephutheloana ke litemoso kapa melaetsa ea liphoso e amanang le sephutheloana sefe kapa sefe se kentsoeng ho ZAP. Bakeng sa mohlalaample, litšoantšong tse ka tlase, ho tobetsa letšoao la temoso ka tlas'a kholomo ea boemo ho tla u lebisa puisanong e bonts'ang litemoso tsohle tsa sephutheloana seo.

25/35

Litsebiso
Litsebiso tsa Seboka
Litsebiso tsa Session ke litemoso kapa melaetsa ea liphoso e amanang le nako ea basebelisi. Litemoso/liphoso tsena li ka bonoa ka ho tobetsa konopo ea Litsebiso ka har'a toolbar ka holim'a ZAP UI. Bakeng sa mohlalaample, setšoantšo se ka tlase se bonts'a leqephe la litemoso tsa seshene kamora isc file e kentsoe ka ZAP.

26/35

Ho lumellana ha Tlhaloso ea Data-Model / ZCL
Ho lumellana ha Tlhaloso ea Data-Model / ZCL
Moetso oa Lintlha le Ts'ebetso ea Tlhaloso ea ZCL
Karolo ena ho ZAP e thusa basebelisi ho bona liphoso tsa ho lumellana le Data Model kapa ZCL ka litlhophiso tse teng tsa ZAP. Melaetsa ea temoso bakeng sa ho hloleha ho latela melao e tla hlaha fenstereng ea Litsebiso ho ZAP UI hape e tla kengoa ho khomphutha ha e sebelisa ZAP ka CLI. Karolo ea ho latela melao ha joale e fana ka litemoso bakeng sa ho latela mofuta oa sesebelisoa le ho latela melao ea sehlopha qetellong.
Litemoso tsa Tumellano ho ZAP UI
Ha mosebelisi a bula .zap file ba sebelisa ZAP UI ba tla bona litemoso fenstereng ea litsebiso tsa ZAP UI bakeng sa liphoso tsohle tsa ho latela melao. Bakeng sa mohlalaample, sets'oants'o se ka tlase se bonts'a leqephe la litsebiso tsa thuto ka mor'a .zap file e ile ea buloa ka litaba tsa ho latela melao.

Melaetsa ea tumellano e tla fela hang ha litaba li rarollotsoe ka ZAP UI e le hore u ka boloka tlaleho ea litaba tse setseng tsa ho latela melao. Litemoso tse ncha li tla boela li hlahe bakeng sa ho lateloa haeba mosebelisi a tima likarolo tse tlamang (sehlopha/litaelo/litšoaneleho) tsa tlhophiso. Litsebiso tsa ho latela melao-motheo li tla lula li boloka tlaleho ea liphoso leha e le life tse hlahisoang ho tlhophiso ea ZAP empa hlokomela hore litemoso tse hlahang nakong ea ho buloa ha .zap. file li na le lintlha tse ngata mabapi le hore na ke hobane'ng ha e hlolehile ho latela melao ha e bapisoa le litemoso tse hlahang ha o sebelisana le UI. Sena se etsoa ka moralo mme tlhahlobo e felletseng ea ho latela melao e etsoa nakong ea ho buloa ha .zap file.
Litemoso tsa ho Latelana ho Console

27/35

Ho lumellana ha Tlhaloso ea Data-Model / ZCL
Ha mosebelisi a bula .zap file ba sebelisa UI e ikemetseng ea ZAP kapa ZAP CLI ba tla bona litemoso li kentsoe ka har'a console/terminal bakeng sa liphoso tsohle tsa ho latela melao. Bakeng sa mohlalaample, setšoantšo se ka tlase se bonts'a litemoso tsa tsebiso ea nako ho console/terminal ka mor'a .zap file e ile ea buloa ka litaba tsa ho latela melao.

28/35

Taolo ea ho fihlella

Access Control Features
ZAP e ts'ehetsa taolo ea phihlello litsing tsohle tsa ZCL. E itšetlehile ka ho kenya tšebetsong SDK ho etsa 'mapa likarolo tsena ho ea ho likarolo tse hlokahalang le tse tšehetsoeng tsa taolo ea phihlello ea SDK. ZAP ka kakaretso e fana ka mohlala oa data le mokhoa oa ho e kenyelletsa meta-info files le ho phatlalatsa data eo ho litempele tsa moloko, ntle le ho fana ka meelelo e itseng ho lintlha tsa data.
Melao ea motheo
Taolo ea phihlello ea ZAP e hlalosa mantsoe a mararo a motheo, ka tsela e latelang: ò ts'ebetso : e hlalosoa e le ntho e ka etsoang. Example: bala, ngola, kopa. ó karolo: e hlalosoang e le tokelo ea setšoantšisi. Joalo ka "View tokelo”, “Karolo ya tsamaiso”, le mora on. ô modifiers: e hlalosoang e le maemo a khethehileng a taolo ea phihlello, joalo ka data e hlokolosi ea masela kapa data ea scoped ea lesela. Mantsoe a motheo a hlalosoa ho XML ea metadata tlas'a top tag . Se latelang ke example of access control term definitions:
<role type=”view” tlhaloso = ”View tokelo”/>
Example e hlalosa ts'ebetso e meraro, ho bala, ho ngola le ho kopa, li-modifiers tse peli le likarolo tse 'ne.
Fumana Litharo-tharo
Boemo bo bong le bo bong ba phihlello ea motho ka mong bo ka hlalosoa ka phihlello e meraro ho XML. Access triplet ke motsoako oa ts'ebetso, karolo le mofetoleli. Ke taba ea boikhethelo, kahoo u ka ba le e 'ngoe ea tsona feela. Karolo e sieo ea triplet ka kakaretso e bolela li-permissivenes, e leng tse tobileng ts'ebetsong bakeng sa SDK e fanoeng. Setsi se hlalosang phihlello ea sona se ka ba le phihlello e le 'ngoe kapa tse ngata tse tharo. Se latelang ke exampLe:
ho0
Ena ke tlhaloso ea tšobotsi e nang le phihlello hararo, e bolelang hore e lumella ts'ebetso ea ho ngola ka karolo ea taolo, 'me ho kentsoe mofetoleli oa lesela.
Litumello tsa kamehla

29/35

Taolo ea ho fihlella
Mekhatlo ea ZCL e ka hlalosa tumello ea bona ka bomong. Leha ho le joalo, ho boetse ho na le tlhaloso ea lefats'e ea tumello ea kamehla ea
mefuta e fanoeng. Tsena li nkuoa bakeng sa mokhatlo o fanoeng, ntle le haeba o fana ka tumello leha e le efe e khethehileng ea oona.
Litumello tsa kamehla li phatlalatsoa ka tsela ea tag boemong bo holimo ba XML file. ExampLe:
aa a<ccess op="invoke"/> a a aa <ccess op=”re d”/> a<ccess op=”ngola”/> a aa aa <ccess op="re d" role="view”/> aa <ccess op=”write” role=”oper te”/> a
Bathusi ba Template
Mothusi oa motheo oa thempleite eo u ka e sebelisang ke {{#access}} … {{/access}} iterator. Phetolelo ena e pheta-pheta holim'a likarolo tsohle tse fanoeng ka makhetlo a mararo.
E tšehetsa likhetho tse peli tse latelang:
entity=”tšobotsi/taelo/ketsahalo” – haeba setheo se sa kgone ho tsejwa ho ya ka moelelo wa taba, sena se beakanya mofuta wa setheo. kenyeletsaDefault="nete/ bohata" - e etsa qeto ya hore na boleng ba kamehla bo kenyeleditswe kapa tjhe. Se latelang ke 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: {{karolo}} / 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: {{role}} / odifier: {{ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
ketsahalo: {{n me}} [{{code}}] a {{# ccess entity=”event”}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

E qala ZAP bakeng sa lits'ebetso tsa Matter kapa Zigbee
E qala ZAP bakeng sa lits'ebetso tsa Matter kapa Zigbee
E qala ZAP bakeng sa Likopo tsa Matter kapa Zigbee
Likarolo tse latelang li hlalosa ho qala ZAP ka mokhoa o ikemetseng ka Matter kapa Zigbee-specific metadata. Morero ke ho qala ZAP ka likhang tse nepahetseng tse amanang le metadata ea XML (litlhaloso tsa lihlopha le mefuta ea lisebelisoa ho latela litlhaloso tsa CSA) le litempele tsa moloko, tse sebelisetsoang ho hlahisa khoutu e nepahetseng.
Ho qala ZAP ka Matter
Mongolo o latelang o nka metadata e nepahetseng ho tsoa ho Matter SDK ha o qala ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Hlokomela: U ka boela ua nka mokhoa o latelang oa Zigbee ho qala ZAP ka Matter.
E qala ZAP le Zigbee
Taelo e latelang e hlahisa ZAP ka litlhaloso tsa ZCL le litempele tsa moloko ho tsoa ho SDK.
[zap-path] -z [sdk-path]/gsdk/app/zcl/zcl-zap.json -g [sdk-path]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
zap-path: Ena ke tsela e eang mohloling oa ZAP kapa sdk-path e ka phethisoang: Ena ke tsela e lebang SDK.
E qala ZAP ntle le Metadata
Hopola hore ha o qala ZAP ka kotloloho ka mokhoa o ka phethisoang kapa o tsoang mohloling o sebelisang npm run zap o qala ZAP ka metadata ea liteko bakeng sa Matter/Zigbee e hahiloeng kahare ho ZAP eseng metadata ea 'nete e tsoang ho Matter le Zigbee SDKs tse boletsoeng ka holimo. Ka hona, hopola ho theha meralo ea hau ea ZAP ka ho sebelisa metadata ea SDK eseng ka ho bula ZAP ka kotloloho ka metadata ea liteko e hahelletsoeng.

31/35

Ho hlahisa khoutu ea Matter kapa Zigbee

Ho Hlahisa Code for Matter, Zigbee kapa Custom SDK
Likarolo tse latelang li hlalosa mokhoa oa ho etsa khoutu ka ZAP.
Hlahisa Khoutu U Sebelisa UI ea ZAP
Hlakola UI ea ZAP ho latela litaelo tsa Ho Tseba ZAP bakeng sa Matter kapa Zigbee ebe o tobetsa konopo ea Hlahisa bareng ea menyu e holimo.
Hlahisa Khoutu ntle le UI
Litaelo tse latelang li fana ka mekhoa e fapaneng ea ho hlahisa khoutu ka CLI ntle le ho qala ZAP UI.
Ho hlahisa Khoutu ho tsoa Mohloling oa ZAP
Etsa taelo e latelang ho hlahisa khoutu u sebelisa ZAP ho tsoa mohloling: 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
Ho Hlahisa Khoutu ho tsoa ho ZAP E ka Phethahatsoang
Etsa taelo e latelang ho hlahisa khoutu u sebelisa ZAP e ka sebelisoang: [zap-path] hlahisa -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
Ho Hlahisa Khoutu ho tsoa ho ZAP CLI E ka Phethahatsoang
Sebelisa taelo e latelang ho hlahisa khoutu u sebelisa ZAP CLI E phethisoang: [zap-cli-path] hlahisa -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

Ntlafatsa ZAP ho Studio

Ntlafatsa ZAP
Ntlafatsa ZAP ho Studio e Bonolo
Mochini ona o ka sebelisoa ha o sebetsa le Matter extension kapa Zigbee ho tsoa ho litokollo tsa Silicon Labs SDK. ZAP e ka ntlafatsoa ka har'a Simplicity Studio ntle le tokollo ea Simplicity Studio ka ho khoasolla tsa morao-rao tse ka sebetsoang tsa ZAP (e khothalelitsoeng) kapa ho hula tsa morao-rao ho tsoa mohloling oa ZAP joalo ka ha ho bonts'itsoe ho Tataiso ea Tlhophiso ea ZAP. Kamora ho ba le ZAP ea morao-rao e ipapisitseng le OS ea hau e sebelisoang hajoale, o ka nchafatsa ZAP ka har'a Studio joalo ka sephutheloana sa adaptara. Latela litaelo tse ka tlase kamora ho khoasolla ZAP ea morao-rao:
Eya ho Simplicity Studio ebe u khetha Likhetho> Studio e bonolo> Liphutheloana tsa Adapter. Tobetsa Eketsa… ebe u sheba foldareng e atolositsoeng ea ZAP eo u e jarollotseng ebe u tobetsa Khetha Sephutheli. Tobetsa Etsa kopo le ho Koala ebe ZAP e sa tsoa eketsoa e tla sebelisoa neng kapa neng ha .zap file e butsoe.
Tlhokomeliso: Ka linako tse ling ho ka ba le maemo a khale a ZAP a seng a ntse a sebetsa le ka mor'a ho ntlafatsa ZAP ea morao-rao. Etsa bonnete ba hore o felisa liketsahalo tsohle tse teng tsa ZAP hore ho sebelisoe ZAP e sa tsoa latoa ho fapana le ea khale, e ntseng e sebetsa ka morao.
Ntlafatsa ZAP bakeng sa Tsoelo-pele ea Lintho ho Github
Ha o sebetsa le Matter kapa Matter-Silicon Labs repos ho Github, beha mefuta e fapaneng ea tikoloho mabapi le ZAP ho theha/ho hlahisa litlhophiso tse ncha tsa ZAP kapa ho hlahisa bochaample ZAP litlhophiso ka mor'a ho sebelisa liphetoho ho tsona. Hlophisa ZAP_DEVELOPMENT_PATH ho ZAP ho tsoa mohloling ka ho hula kapa ho beha ZAP_INSTALLATION_PATH ho ZAP eo u e kopitsitseng qetellong bukeng ea sebaka sa heno. Hlokomela hore ha ZAP_DEVELOPMENT_PATH le ZAP_INSTALLATION_PATH li setiloe, ho sebelisoa ZAP_DEVELOPMENT_PATH.
Tse latelang ke examptse bonts'ang mefuta e kaholimo ea tikoloho e sebelisoang:
Ho qala ZAP ho sebelisa Matter specification Regenerating all the sampLitlhophiso tsa ZAP bakeng sa lits'ebetso tsa Matter
Tlhokomeliso: Ha u sebelisa lisebelisoa tsa ZAP, etsa bonnete ba hore u sebelisa tokollo ea semmuso bakeng sa tokollo ea bosiu bakeng sa botsitso bo eketsehileng. Bona
Ho khoasolla ZAP e Phethahatsang ho Tataiso ea ho Kenya ea ZAP

33/35

Multi-protocol e tšoanang pakeng tsa Zigbee le Matter
Multi-protocol e tšoanang pakeng tsa Zigbee le Matter
MCoanttceurrrent Multi-protocol lipakeng tsa Zigbee le
ZAP e ka sebelisoa ho lokisa litlhophiso tsa ZCL (Zigbee) le Data-Model (Matter) ts'ebelisong ea liprothokhole tse ngata bakeng sa Zigbee le Matter. ZAP e u lumella ho etsa li-endpoints tsa Zigbee le Matter ka mokhoa o hlakileng ka tlhophiso e tšoanang. file. Haeba li-endpoints tsa Zigbee le Matter li le ho Identifier ea pheletso e tšoanang (bakeng sa mohlalaample, LO Dimmable Light on endpoint Id 1 le Matter Dimmable Light ketsahalong e 'ngoe ea endpoint 1), ZAP e hlokomela ho lumellana le litšobotsi tse tloaelehileng ho pholletsa le litšobotsi tsa Matter le Zigbee. Etsa bonnete ba hore litšobotsi tse ntseng li hokahanngoa li na le mofuta o tšoanang oa data. Litšobotsi tse tloaelehileng lipakeng tsa Zigbee le Matter li thehiloe ka file e bitsoang multi-protocol.json . Mosebelisi a ka hokahanya lihlopha life kapa life tse peli ho pholletsa le Zigbee le Matter hammoho le litšoaneleho tsa tsona tse tsamaellanang a sebelisa sehlopha le likhoutu tsa litšobotsi ka ho latellana. Sena file e ka fumanoa ho [SDKPath]/app/zcl/multi-protocol.json. Sena file e nchafalitsoe ka sehlopha se itseng sa lihlopha le litšoaneleho ho qala, empa mosebelisi a ka ntlafatsa sena file joalo ka ha ho hlokahala, 'me ZAP e tla hlokomela ho lumellana ha sebopeho ho pholletsa le Zigbee le Matter bakeng sa lintlha tse tloaelehileng tsa ho qetela.
U ka boela ua fumana thupelo ea ZAP ts'ebelisong efe kapa efe ea Zigbee le Matter ea liprothokhole tse ngata tlasa leqephe la lithuto. Thupelo ena e tla u tataisa ts'ebetsong ea ho theha likopo tse ngata tsa liprotocol. Thupelo ena e fumaneha feela ha o bula ts'ebeliso ea li-multi-protocol mme e ka fumanoa joalo ka ha ho bonts'itsoe setšoantšong se ka tlase:

34/35

Kopanya SLC CLI le ZAP
Kopanya SLC CLI le ZAP
Kopanya SLC CLI le ZAP
Latela mehato ena ho kopanya SLC CLI le ZAP: ò Kenya SLC CLI ka ho latela litaelo tsa ho instola ho Bukana ea Mosebelisi ea Simplicity Studio 5. ó Kenya ZAP ka ho latela litaelo tse ho Tataiso ea Tlhophiso ea ZAP. ô Ho kopanya SLC CLI le ZAP, eketsa mofuta oa tikoloho STUDIO_ADAPTER_PACK_PATH e supang ts'ebeliso ea ZAP.
directory. õ Hopola ho qala SLC CLI Daemon ka mor'a mohato oa 3. ö Morero ofe kapa ofe o sebelisang ZAP joale o tla sebelisa tsela e hlalositsoeng mohatong oa 3 ha o hlahisoa ho tsoa ho SLC CLI. Ka kopo sheba SLC CLI
Tšebeliso ea litaelo tsa ho sebelisa SLC CLI bakeng sa merero ea hau.

35/35

Litokomane / Lisebelisoa

SILICON LABS ZAP E Tsoela Pele Ka Silicon Labs [pdf] Buka ea Mong'a
ZAP e Tsoela Pele ka Li-Labs tsa Silicon, ZAP, e Tsoelang Pele ka Silicon Labs, Silicon Labs, Labs

Litšupiso

Bukana ea Mosebelisi

ZAP e Tsoelang Pele ka Silicon Labs

Litlhaloso

Litaelo tsa Tšebeliso ea Sehlahisoa

FAQs

Ho nts'etsapele ka Silicon Labs ZAP

ZAP Ho qala

Ho kenya ZAP

Metheo ea ZAP

XML e tloaelehileng

XML e tloaelehileng Tags bakeng sa Zigbee

Mefuta e mengata ea lisebelisoa ho ea ka ntlha ea ho qetela

Taolo ea ho fihlella

Ho hlahisa khoutu ea Matter kapa Zigbee

Ntlafatsa ZAP ho Studio

Litokomane / Lisebelisoa

Litšupiso

Tlohela maikutlo

Hlakola karabo