ZAP Atina'e ma le Silicon Labs Owner's Manual

ZAP Amataina
- Ina ia amata ile ZAP, mulimuli i laasaga nei:
  - Sii mai le ZAP Executable mai le fale teu oloa.
  - Faʻapipiʻi faʻalagolago e faʻaaoga ai le npm install command.
  - Mo fa'apipi'i fa'apitoa a Windows, va'ai ile ta'iala Fa'apipi'i ZAP mo Windows OS.
Atinae Zigbee
- Afai o lo'o e atia'e ni talosaga a Zigbee:
  - Fa'aoga le Simplicity Studio lea e aofia ai le ZAP ma isi meafaigaluega talafeagai.

Atinae o Mataupu
- Afai o lo'o e atia'e talosaga a Matter:
  - O filifiliga e aofia ai le faʻaaogaina o le Simplicity Studio poʻo le faʻaogaina o le Silicon Labs poʻo le CSA Github repositories.
  - Va'ai i fa'atonuga fa'afouga mo le ZAP i fafo atu o le si'osi'omaga fa'amatu'u mai le Simplicity Studio pe a mana'omia.

FAQs

Q: O a ituaiga eseese o ZAP binaries o loʻo maua?
- A: E lua fa'aliliuga o lo'o avanoa - Fa'asalalau aloa'ia fa'atasi ma fau fa'amaonia ma mua'i tu'uina atu fa'atasi ma foliga fou.

F: O le a se mea e tatau ona ou faia pe a ou feagai ma faʻafitauli o le tuʻufaʻatasia o faletusi a le atunuʻu i le taimi o le faʻapipiʻiina?
- A: Va'ai ile FAQ fa'amatalaga e uiga i fa'amaumauga fa'apitoa e fo'ia ai ia fa'afitauli.

“`

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Atiina ma le Silicon Labs ZAP

Amataina
ZAP Toe Amatainaview Fa'apipi'i ZAP Fa'apipi'i ZAP Windows FAQ
Fa'avae ZAP Fa'avae
Ta'iala a le Fa'aoga ZAP Ta'iala mo le Fa'aogaview Custom XML Custom XML Tags mo Zigbee Tele Ituaiga Masini I Endpoint Matter Ituaiga Mea Fa'aaliga Itulau Fa'amatalaga Fa'amatalaga-Fa'ata'ita'iga/ZCL Fa'amatalaga Tausi'i Avanoa Pule Fa'alauiloa le ZAP mo Matter po'o Zigbee talosaga Fa'atupuina code mo Matter po'o Zigbee Fa'afouina ZAP i le Studio Fa'atasi Tele-protocol i le va o Zigbee ma Matter Fa'atasi le SLC CLI ma le ZAP

1/35

Atiina ma le Silicon Labs ZAP
Atiina ma le Silicon Labs ZAP
ZAP
O le ZAP ose masini fa'atupu fa'ailoga lautele ma fa'aoga fa'aoga mo tusi talosaga ma faletusi e fa'avae i le Zigbee Cluster Library mai Zigbee po'o le Fa'ata'ita'iga Fa'amatalaga mai Matter. O le faʻamatalaga ua atiaʻe e le Connectivity Standards Alliance. O le ZAP e fa'atagaina oe e fa'atino galuega nei:
Fa'atino fa'atupu fa'apitoa fa'apitoa a le SDK o mea uma a le lalolagi (fa'ato'aga, ituaiga, ID, ma isi) fa'atatau i le ZCL/Data-Model specification. Fa'atino fa'asologa fa'apitoa a le SDK o fa'asologa uma na filifilia e le tagata fa'aoga (fa'atonuga fa'aoga, fa'asologa fa'ai'uga, ma isi mea) fa'avae i luga ole fa'asologa o le ZCL/Data-Model ma le fa'atulagaina o talosaga e tu'uina atu e tagata fa'atau. Tuuina atu le UI mo le tagata faʻauʻu e filifili ai se faʻatulagaga faʻapitoa o talosaga (faʻaiʻuga, fuifui, uiga, poloaiga, ma isi).

O mea o lo'o i totonu o nei vaega o lo'o fa'amatalaina ai le fa'atupuina o talosaga a Zigbee ma Matter e ala i le fa'atulagaina o le ZCL (Zigbee) po'o Fa'amatalaga Fa'ata'ita'iga (Matter) Layers e fa'aaoga ai le ZAP.

2/35

ZAP Amataina

ZAP Amataina
Amata ile ZAP
O nei vaega o lo'o fa'amatalaina auala eseese e fai ai fa'aoga Zigbee ma Matter. Manatua o le Simplicity Studio o loʻo tuʻuina atu se auala e fai ai au talosaga Zigbee ma Matter mai le pito i le pito lea e oʻo mai ai meafaigaluega uma faʻatasi ma le Simplicity Studio (e aofia ai le ZAP). E mafai foi ona e filifili e su'esu'e isi auala e fai ai au tusi talosaga, e pei ona fa'amatalaina iinei.
Atinae Zigbee
Zigbee e mafai ona fausia a latou tusi talosaga e faʻaaoga ai le Simplicity Studio, lea ua uma ona aofia ai le ZAP ma isi meafaigaluega e fesoasoani ia te oe e fausia lau talosaga mai le pito i le pito.
Atinae o Mataupu
Matter Application developers e mafai ona fausia a latou tusi talosaga e fa'aoga ai metotia nei: Simplicity Studio: E aofia ai le ZAP ma isi mea faigaluega e mana'omia e fau ai le Matter application i le pito i le pito. Github (Silicon Labs) Github (CSA)
Fa'aaliga: Ina ia fa'afou le ZAP i fafo atu o le ta'amilosaga fa'asao a le Simplicity Studio, va'ai fa'afou le ZAP ile Simplicity Studio ma le ZAP Installation Guide.

3/35

Fa'apipi'i ZAP

O vaega nei o lo'o fa'amatalaina le fa'apipi'iina o le ZAP ma pe fa'afefea ona fa'afou le ZAP ile Simplicity Studio IDE.
La'uina o le ZAP Executable Fautuaina)
O le auala fautuaina lea e amata ai le ZAP. E mafai ona e maua tala fou ZAP binaries mai aa https://github.com/project-chip/zp/releses. O binaries muai fausia e sau i ni lomiga eseese se lua.
Fa'asalalauga aloa'ia: Fa'amaonia faufale fa'atasi ma su'ega su'ega a Matter ma Zigbee. Ole faatulagaga ole igoa ole vYYYY.DD.MM. A'o le'i fa'asa'oloto: Fausia fa'atasi ma foliga aupito lata mai ma fa'aleleia o pusa ae o nei faufale e LE fa'amaonia i su'ega su'ega Matter ma Zigbee. Ole faatulagaga ole igoa ole vYYYY.DD.MM-po.
Fa'apipi'i le ZAP mai Puna
Fa'atonuga autu e Fa'apipi'i le ZAP
Ona o le node.js talosaga lenei, e te manaʻomia le faʻapipiʻiina o le siosiomaga node. O le auala sili e fai ai lenei mea o le siiina lea o le faʻapipiʻi fou o le node, lea e aofia ai le node ma le npm. Afai e iai sau vaega tuai o le node o lo'o fa'apipi'i i lau fale faigaluega, e ono tupu ai fa'afitauli, aemaise lava pe a matua tuai. Ia mautinoa o loʻo ia te oe le lomiga fou v16.x faʻatasi ma le npm o loʻo aofia ai. Fa'asolo le node -version e siaki po'o fea le fa'asologa e piki i luga. v18.x ua fautuaina. A maeʻa ona e maua se faʻamatalaga manaʻomia o le node, e mafai ona e faʻatautaia mea nei:
Fa'apipi'i le Dependencies
Fa'aoga tulafono nei e fa'apipi'i ai fa'alagolago:

npm faʻapipiʻi
Fa'aaliga: Mo le fa'apipi'iina o le ZAP fa'apitoa a Windows, va'ai le Fa'apipi'iina o le ZAP mo le OS Windows E le o se mea e masani ai le fa'aogaina o fa'afitauli tu'ufa'atasiga o faletusi i le taimi nei. E iai src-script/install-* scripts eseese mo tulaga eseese. Vaʻai FAQ faʻamatalaga e uiga i le tusitusiga e taʻavale i luga o faʻasalalauga eseese ona toe faʻafoʻi lea npm install .
Amata le Talosaga
Fa'aoga tulafono nei e amata ai le talosaga:

npm tamoe zap
Amata le Luma-I'u ile Atina'e Faiga
Lagolagoina le toe utaina o le vevela-code, lipoti sese, ma isi. Fa'aoga tulafono nei e amata ai le pito i luma ile atina'e
faiga:
quasar dev -m eletise
or

4/35

ZAP Insta i totonu
npm tamoe electron-dev

5/35

ZAP Fa'apipi'i Pupuni
ZAP Fa'apipi'i Pupuni
Fa'apipi'i ZAP mo Windows OS
1. Pupuni Powershell
I totonu ole laulau su'esu'e, fa'aoga le Windows Powershell ma tamo'e e avea ma pule. Fa'asolo uma tulafono nei i totonu o le Powershell.
2. Sukalati
Fa'apipi'i mai https://chocolatey.org/install. Siaki pe fa'apipi'i lelei ma fa'atonuga nei:
koko -v
Faʻapipiʻi le pusa pkgconfiglite ma tulafono nei:
choco faʻapipiʻi pkgconfiglite
3. Fa'apipi'i Node
Fa'atonu tulafono nei e fa'apipi'i ai:
choco faʻapipiʻi nodejs-lts
*O le lomiga e tatau ona 18 e pasi le suʻega suʻega, pe a uma ona faʻapipiʻi, siaki i le node -v * Afai ua uma ona e faʻapipiʻi Node, ma faʻaletonu nisi o suʻega e le mafai ona maua Node, toe faʻapipiʻi le Node ma le sukalati.
4. Mulimuli i Fa'atonuga Autu e Fa'apipi'i le ZAP
Mulimuli i fa'atonuga fa'apipi'i ZAP mai fa'apogai ile ZAP Installation. A'o mulimulitai i fa'atonuga fa'avae mo le fa'apipi'iina o le ZAP mata'ituina mea sese ma pe fa'apefea ona fo'ia:
sqlite3
A e fa'agasolo le ZAP (fa'ata'ita'iga, npm run zap ), afai e te va'ai i se mea sese e uiga i le sqlite3.node i se fa'amalama fa'aoso, tamo'e:
npm toe fausia sqlite3
fau-eletonika
Pe a fai le npm faʻapipiʻi, i le post-install, pe a tupu se mea sese i luga o le poloaiga o loʻo mulimuli mai e fesoʻotaʻi ma le electron-builder install-appdeps , npx electron-rebuild canvas ua toilalo poʻo le node-pre-gyp , o le tapoleni o loʻo i ai nei e le fetaui ma Windows ma o le faʻapipiʻi mea sese o le a le mafua ai le toilalo i le faʻaogaina o le ZAP. node-canvas o loʻo galue i le fofo i le taimi nei ma o le a foia le mataupu i se taimi lata mai.
"postinstall": "fausia eletise fau-app-deps && husky fa'apipi'i && npm toe fausia tapoleni -fa'afou-binary && npm run version-stamp”

6/35

ZAP Fa'apipi'i Pupuni
tapoleni
Afai e le manuia le suega o le npm ona o le mea sese Ua le mafai ona tamoe le suʻega suʻega. Le mafai ona maua le module '../build/Release/canvas.node' po'o
zapnode_modulescanvasbuildReleasecanvas.node e le o se talosaga Win32 aoga. , toe fausia tapoleni e fa'apea:
npm toe fausia tapoleni -update-binary
maua le index.html po'o Isi Fa'afitauli Fa'atonu
Afai e le manuia le suega o le npm run ona o le mea sese e le maua le talosaga index.html i le tulaga code 404 i suʻega iunite poʻo le i ai o le server
faʻafitauli fesoʻotaʻiga i suʻega e2e-ci, faʻatautaia tulafono nei:
npm tamoe fausia
Isi
Siaki pe o le node version v18 ma taumafai e faʻapipiʻi i Chocolatey.

7/35

FAQ
FAQ
Fesili e Fai soo
Q: E faʻafefea ona amataina le UI ile atinaʻe? A: E mafai ona e amataina le UI i se faiga atinaʻe, lea o le a iʻu ai i se seti o loʻo mulimuli mai:
Vaevae quasar development HTTP server, lea e ola faʻafouina i luga o le taulaga 8080 ZAP pito i tua o loʻo faʻaogaina i luga o le taulaga 9070 Chrome poʻo se isi masini suʻesuʻe, taʻavale tutoatasi Ina ia oʻo i lena seti, mulimuli i faatonuga o loʻo i lalo. ò Muamua, faʻatautaia le ZAP development server, lea e amata ile port 9070.
npm run zap-devserver ó Soso'o, tamomoe le quasar development server, lea e amata ile port 8080.
quasar dev ô Fa'asino lau su'esu'ega pe fa'asaga le tasi i le sa'o URL faatasi ai ma le finauga restPort:
google-chrome http://localhost:8080/?restPort=9070

Q: Fa'afefea ona fa'atino lenei mea ile Mac/Linux OS? A:
npm install o loʻo faʻaaogaina e download uma ai pusa faʻalagolago e manaʻomia. Afai e te vaʻai i mea sese e fesoʻotaʻi ma le node-gyp ma le misia o faletusi i le lotoifale, e pei o pixman, ma isi mea, o loʻo e misia faʻalagolago i le atunuʻu e faʻamalieina ai le tuʻufaʻatasia o binaries node e leʻi fausia muamua mo nisi tuʻufaʻatasiga o tulaga ma faʻaliliuga. Npm i luga o le ao o loʻo faʻafouina pea le lisi o binaries ua saunia, o lea e mafai ai ona e pikiina lelei, ae afai e te le faia, o faʻatonuga ia mo faʻavae eseese:
Fedora Core ma le dnf:
dnf fa'apipi'i pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
poʻo le faʻataʻitaʻiina o tusitusiga:
src-script/install-packages-fedora
Ubuntu ma apt-get:
apt-get update apt-get install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
poʻo le faʻataʻitaʻiina o tusitusiga:

8/35

FAQ
src-script/install-packages-ubuntu
OSX i luga o le Mac ma le Homebrew brew :
brew fa'apipi'i pkg-config cairo pango libpng jpeg giflib librsvg
poʻo le faʻataʻitaʻiina o tusitusiga:
src-script/install-packages-osx
Q: E fa'afefea ona fai lenei mea ile Windows OS?
A: Ia mautinoa o loʻo faʻafouina i taimi uma ma e leai ni suiga e leʻi faia. Motugaafa: git pull, git status & git stash o au uo. E tatau ona e fa'aoga Sukalati e fa'aoga ai le Zap ile Windows OS. Ia mautinoa e sii maia le pusa pkgconfiglite.
choco faʻapipiʻi pkgconfiglite
Afai ei ai ni au fa'afitauli i Cairo, mo se fa'ata'ita'igaample pe afai e te maua se mea sese e uiga i cairo.h': Leai file po'o le fa'atonuga, fai mea nei: ò Siaki pe 32 pe 64 bit lau komepiuta. ó Fa'alagolago i lena mea, la'u mai le afifi talafeagai mai lenei saite
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:
Kiliki i luga o le Advanced System Settings. I le advanced tab kiliki i le Environment Variables. I le vaega System Variables, saili le PATH environment variable ma filifili ai. Kiliki Fa'atonu ma fa'aopoopo C:/GTK i ai. Afai e le o iai le suiga ole siosiomaga PATH, kiliki Fou. Afai e le maua jpeglib.h, taumafai mea nei: ò I luga o le laina, tamoe: choco install libjpeg-turbo ó Ia mautinoa e mama e ala i le faʻaaogaina: git clean -dxff ma toe tamoe npm install ô pe a leai se mea e tupu ae naʻo lapataiga e aliali mai, taumafai e faʻaaoga le npm audit fix õ pe a le mafai ona e tamoe ZAP, alu i le file src-script/zap-start.js ö Suiga
÷ const { spawn } = mana'omia('cross-spawn') to const { spawn } = mana'omia('child_process') ø Tamomoe npm ma tamoe zap. Fa'asinomaga:
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)
F: Ua ou maua se mea sese "sqlite3_node" e le maua pe tutusa.

9/35

FAQ
A: Toe fa'atupu lau sqlite3 fa'amauina. Ina ia faaleleia lenei mea i le tele o tulaga, tamoe:
npm faʻapipiʻi
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Afai e le o toe faaleleia, fai:
rm -rf node_modules ona toe taumafai lea o tulafono o loʻo i luga. O nisi taimi o le faʻaleleia o lau npm e faia ai foi se eseesega:
npm faʻapipiʻi -g npm
F: Ua ou maua se mea sese "O le N-API version o lenei Node instance o le 1. O lenei module e lagolagoina le N-API version(s) 3. O lenei Node instance e le mafai ona fa'agaoioia lenei module."
A: Fa'alelei lau fa'ailoga node. O le fofo mo lenei mea o loʻo talanoaina i lenei Stack Overflow thread: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Q: O la'u atina'e PC e le galue ma le ZAP po'o le a lava le mafua'aga. E mafai ona ou fa'aogaina se koneteina fa'atau?
A: Ioe e mafai. TBD.
Q: E fa'afefea ona ou ta'e le ZAP i totonu o le VSCode?
A: Afai e te VSCode i lou ala ulufale i le zap repo ma faʻailoga code . Ole mea lea ole a tatala ai le ZAP ile VSCode. Ina ia faʻagasolo le ZAP i le faʻaogaina o le debug mode, filifili le ZAP workspace ma kiliki i luga o le Run icon i le itu tauagavale lima meafaigaluega. O le ai ai ni au filifiliga se lua e te filifili mai ai e faʻatautaia le ZAP, filifili Node.js Debug Terminal . O lenei mea o le a tatalaina ai se faʻamalama faʻamalama e mafai ona e ulufale ai npm run zap , lea o le a faʻapipiʻi ai le debugger ma taʻavale ZAP e pei ona e masani ai mai le laina faʻatonu. Fa'afetai, e tatau ona e va'ai i le ZAP o lo'o tamo'e i le debugger. E mafai ona e setiina va'aiga i le VSCode e pei ona e faia i so'o se isi IDE.
F: E le manuia le su'ega a le UI i nisi o mea sese ile tapoleni e le fausia mo le sa'o o le node. O le a la'u mea e fai?
A: Afai e te vaʻaia le mea sese:
FAIL test/ui.test.js Le su'ega su'ega na le mafai ona fa'agaoioi le module 'canvas.node' na tu'ufa'atasia e faasaga i se isi Node.js version e fa'aaoga ai le NODE_MODULE_VERSION 80. O lenei version of Node.js e mana'omia le NODE_MODULE_VERSION 72. Fa'amolemole taumafai e toe fa'apipi'i pe toe fa'apipi'i le module (mo se fa'ata'ita'iga, toe fa'apipi'i le `npmnbuild` po'o le`npmnbuild le module).
i le Mea. (node_modules/canvas/lib/bindings.js:3 18)
ona tamoe lea: npm toe fausia tapoleni -update-binary

10/35

Fa'avae ZAP

ZCL/Fa'ata-Fa'ata'ita'iga ZAP Fa'avae
Ole vaega lea e iai fa'amatalaga mo tagata fou ole ZAP. Kiliki i luga o le faʻataʻitaʻiga icon i le pito i luga taumatau o le ZAP UI, o loʻo faʻaalia ai le auala e fai ai se faʻatulagaga ZAP. O le a'oa'oga o le a ta'ita'ia oe i mea nei: Fausia se fa'ai'uga Filifili se ituaiga masini Fa'atulaga se fuifui Fa'atulaga se uiga Fa'atonu se fa'atonuga Mo fa'amatalaga auiliili, va'ai Zigbee Cluster Configurator Guide

11/35

ZAP User's Guide
ZAP User's Guide
ZAP User's Guide
O vaega o lo'o i lalo o lenei ta'iala o lo'o tu'uina atu ai nisi fa'amatalaga e uiga i vaega eseese o lo'o tu'uina mai e le ZAP.

12/35

XML fa'apitoa

Fa'aopoopoina le Custom XML mai le ZAP UI
Kiliki i luga o le "Extensions" icon i le ZAP UI. Kiliki i le "+" add button e filifili ai se xml masani file O fuifui masani, uiga, poloaiga, ma isi e tatau ona faʻaalia i le ZAP UI pe a uma ona faʻaopoopo le xml masani.
Fausia lau oe lava XML masani ile Zigbee
O lo'o fa'aalia e le vaega le fa'atupuina o au lava fuifui fa'aleaganu'u ma fa'alautele fuifui fa'ata'ita'i o lo'o iai fa'atasi ai ma uiga fa'aleaganu'u ma fa'atonuga mo Zigbee.
Fa'alapotopotoga Fa'apitoa a le Aufaigaluega i Zigbee
E mafai ona e fa'aopoopo fa'aputuga fa'apitoa a le gaosiga i se tulaga fa'apitoafile. Matou te tuʻuina atu se example o lenei i lalo. Ina ia faia lenei mea e tatau ona e faʻamalieina ni matafaioi se lua:
O le ID fa'apipi'i E TATAU ona i ai i le vaega fa'apitoa gaosi, 0xfc00 – 0xffff. O le fa'auigaina o fuifui e tatau ona aofia ai se fa'ailoga faufale lea o le a fa'aoga i uiga UMA ma fa'atonuga i totonu o lena fuifui ma e tatau ona tu'uina atu pe a lafo ma talia fa'atonuga ma fegalegaleai ma uiga. ExampLe:

Sample Mfg Specific Cluster lautele O lenei fuifui e maua ai se example auala e mafai ai ona fa'alautele le Ta'iala Talosaga e aofia ai fuifui fa'apitoa faufale.
0xFC00
mumu sample uiga
mumu sample uiga 2

A sample fa'atonuga fa'apitoa i totonu ole sample gaosi-fa'apitoa
fuifui.

Poloaiga Fa'apitoa a le Faumea i totonu ole Zigbee Cluster
E mafai ona e fa'aopoopo au lava fa'atonuga i so'o se fa'aputuga Zigbee fa'atasi ma mana'oga nei:
E mafai e au fa'atonuga fa'apitoa ona fa'aogaina so'o se fa'atonuga i totonu ole fa'atonuga id, 0x00 - 0xff. E tatau fo'i ona e tu'uina atu se fa'ailoga faufale mo le fa'atonuga ina ia mafai ai ona fa'ailogaina mai isi fa'atonuga i totonu o le fuifui ma fa'agaoioi lelei. Example o le faʻalauteleina o le faʻaogaina o le On/Off faʻatasi ma le faʻatonuga o le gaosiga:

13/35

XML fa'apitoa
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition" filifiliga = "moni" manufacturerCode = "0 1002″> Poloaiga a le aufaipisinisi e tape ai le masini ma se suiga na tuuina mai e le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificOnWithTransition" filifiliga = "moni" manufacturerCode = "0 1002"> Poloaiga a le tagata fa'atau e fa'aola ai le masini ma se suiga na tu'uina mai e le taimi o suiga ile Ember Sample uiga tau suiga.ampleMfgSpecificToggleWithTransition" filifiliga = "moni" manufacturerCode = "0 1002"> Poloaiga a le aufaipisinisi e fesuia'i ai le masini ma se suiga na tuuina mai e le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificOnWithTransition2″ faitalia = “moni” manufacturerCode =”0 1049″> Poloaiga a le tagata fa'atau e fa'aola ai le masini ma se suiga na tu'uina mai e le taimi o suiga ile Ember Sample uiga tau suiga.ampleMfgSpecificToggleWithTransition2″ faitalia=”moni”
Fa'ailoga Faumea =”0 1049″> Poloaiga a le aufaipisinisi e fesuia'i ai le masini ma se suiga na tuuina mai e le taimi o suiga i le Ember Sample uiga tau suiga.

Uiga Fa'apitoa a le Faumea i totonu ole Fa'aputuga Zigbee masani
E mafai ona e fa'aopoopoina au lava uiga i so'o se fuifui Zigbee masani fa'atasi ai ma mana'oga nei:
O au uiga fa'apitoa e gaosi oloa e mafai ona fa'aogaina so'o se uiga id i totonu ole uiga id, 0x0000 - 0xffff. E tatau fo'i ona e tu'uina atu se fa'ailoga gaosi oloa mo le uiga ina ia mafai ai ona fa'ailoga mai isi uiga i totonu o le fuifui ma fa'agaoioiga lelei. Example o le fa'alauteleina o le fa'apipi'i On/Off fa'atasi ai ma uiga faufale:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″
max = “0xFFFF” tusitusia = “moni” faaletonu = “0 0000″ filifiliga = “moni” Fa'ailoga Faumea =”0 1002″>Sample Mfg Uiga Fa'apitoa: 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=”moni” manufacturerCode=”0 1049″>Sample Mfg Uiga Fa'apitoa: 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=”moni” manufacturerCode=”0 1002″>Sample Mfg Uiga Fa'apitoa: 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=”moni” manufacturerCode=”0 1049″>Sample Mfg Uiga Fa'apitoa: 0 0001 0 1040
Fausia lau oe lava XML masani ile Matter
O le vaega o lo'o fa'aalia ai le fa'atupuina o au lava fuifui masani ma fa'alautele fuifui masani o lo'o iai fa'atasi ai ma uiga masani ma fa'atonuga mo Matter.
Fa'aputuga Fa'apitoa a le Aufaigaluega i Matā'upu
E mafai ona e fa'aopoopoina fa'aputuga fa'apitoa i le Matter. Matou te tuʻuina atu se example o lenei i lalo.
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 fa'apitoa
I le example, o le tu'ufa'atasiga o le ID fa'atau (Test Manufacturer ID) o le 0xFFF1 ma le fa'aputuga ID o le 0xFC20 e maua ai le value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. ExampLe:
lautele Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER O le Sample MEI fuifui fa'aalia se fa'aopoopoga gaosi oloa FlipFlop
Tali mo AddArguments e toe fa'afo'i le aofa'i. Poloaiga e lua uint8 finauga ma toe faafoi a latou aofaiga. Fa'atonuga faigofie e aunoa ma ni fa'amaufa'ailoga ma leai se tali.
Uiga Fa'apitoa a le Faumea i totonu o Fa'aputuga o Mataupu Fa'ata'atia
E mafai ona e fa'aopoopoina uiga fa'apitoa o le gaosiga i so'o se fuifui Matter masani ma mana'oga nei:
T aaaa e tatau ona fa'amaoti mai le fa'ailoga o lo'o tu'uina atu i ai -
e xte nd ed > “>
O le code o le uiga o se 32-bit tu'ufa'atasiga o le code gaosi oloa ma le id mo le uiga. Ole pito sili ona taua ole 16 bits ole tulafono ole gaosiga. Ole laina ole su'ega ole gaosiga ole 0xFFF1 - 0xFFF4. Ole pito sili ona taua ole 16 o le ID uiga. Ole laina ole uiga ole lalolagi ole 0x0000 – 0x4FFF.
Exampo le fa'alauteleina o le On/Off Matter cluster fa'atasi ai ma uiga fa'apitoa o le gaosiga:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″
max = "0xFFFF" tusitusi = "moni" faaletonu = "0 0000" filifiliga = "moni">Sample Mfg Uiga Fa'apitoa 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″
max = "0xFFFF" tusitusi = "moni" faaletonu = "0 0000" filifiliga = "moni">Sample Mfg Uiga Fa'apitoa 4
Poloaiga Fa'apitoa a le Faumea i Fa'aputuga o Mea Fa'apitoa
E mafai ona e fa'aopoopoina fa'atonuga fa'apitoa a le gaosiga i so'o se fuifui Matter masani ma mana'oga nei:
E tatau ona fa'amaoti mai poloaiga o lo'o tu'uina atu i ai -
e xte nd ed > “>
O le faʻailoga o le faʻatonuga o se 32-bit tuʻufaʻatasiga o le code gaosi oloa ma le id mo le faʻatonuga. Ole pito sili ona taua ole 16 bits ole tulafono ole gaosiga. Ole laina ole su'ega ole gaosiga ole 0xFFF1 - 0xFFF4. Ole pito sili ona taua ole 16 bits ole ID faʻatonu. Ole laina ole tulafono ole lalolagi ole 0x0000 - 0x00FF.
Example o le fa'alauteleina o le On/Off Matter fuifui fa'atasi ai ma fuifui fa'apitoa faufale:

15/35

XML fa'apitoa

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ faitalia=”moni”> Poloaiga a le tagata fa'atau e fa'aola ai le masini ma se suiga na tu'uina mai e le taimi o suiga ile Ember Sample uiga tau suiga.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ faitalia=”moni”>
Poloaiga a le aufaipisinisi e fesuia'i ai le masini ma se suiga na tuuina mai e le taimi o suiga i le Ember Sample uiga tau suiga.

16/35

XML fa'apitoa Tags mo Zigbee

O le pepa o loʻo i lalo o loʻo talanoa e uiga i xml taʻitasi tags fesootai ma Zigbee.
xml taitasi file ua lisiina i le va o le configurator tags:

E mafai ona fa'amalamalamaina ituaiga fa'amatalaga i totonu o le fa'atonu tag. O lo'o lagolagoina nei e le Zigbee le fa'amatalaga o bitmaps, enums, integers, strings po'o structs. A'o le'i fa'auigaina nisi ituaiga ia mautinoa e siaki uma ituaiga atomika o lo'o i ai o lo'o fa'amatalaina i le type.xml ma ituaiga uma e le'o atomika fa'amatalaina i le isi xml files. E mafai ona e faauigaina i latou e faapea:
Bitmap: igoa: igoa ole ituaiga bitmap. ituaiga: Bitmap ma le tele i le va o 8-64 bits e mafai ona faʻamalamalamaina, o ia mea uma e tatau ona faʻateleina o le 8. E mafai ona i ai i bitmap taʻitasi le tele o fanua ma se igoa ma se matapulepule e fesoʻotaʻi ma ia. fa'ata'ita'iga:

“`
Enum: igoa: igoa ole ituaiga enum. ituaiga: Enum ma le tele i le va o 8-64 bits e mafai ona faʻamalamalamaina, o ia mea uma e tatau ona faʻateleina o 8. E mafai e enum taʻitasi ona maua ni mea se tele ma se igoa ma se tau e fesoʻotaʻi ma ia. fa'ata'ita'iga:

Integer: O ituaiga integer ua uma ona faʻamalamalamaina i lalo o ituaiga atomika o loʻo iai i le type.xml. O latou lapopoa e mafai ona amata mai i le 8-64 bits ma e mafai ona sainia pe le saini. fa'ata'ita'iga:

String: O ituaiga manoa ua uma ona faʻamalamalamaina i lalo o ituaiga atomika o loʻo iai i le type.xml. O ituaiga manoa i le taimi nei e aofia ai le manoa octet, manoa char, manoa octet umi ma le manoa umi eg:

Struct: igoa: igoa ole ituaiga struct. E mafai ona iai ni mea ta'itasi ma se igoa ma se ituaiga e fa'atasi ai. O le ituaiga e mafai ona avea ma so'o se ituaiga fa'avasegaina i lalo o fa'amaumauga. fa'ata'ita'iga:

17/35

XML fa'apitoa Tags mo Zigbee

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

E mafai ona faauigaina Clusters i totonu ole configurator tag. igoa: igoa ole fuifui vaega: vaega ole fuifui. Ole fuifui ole a fa'aalia ile ZAP UI ile vaega lea. fa'amatalaga: Fa'amatalaga o le fuifui code: fuifui code fa'amatala: fuifui fa'amatala lea e fa'aogaina e le fa'atupu fa'ailoga e fa'amatala ai le fuifui i se auala fa'apitoa FaumeaCode: Fa'aaogaina e fa'amatala ai se fuifui fa'apitoa gaosiga. E tatau ona i ai i le va o le 0xfc00 - 0xffff. O le fa'ailoga o le gaosiga mo le fuifui e mana'omia ona fa'amatala fa'apea:

E otometi lava ona faia e le fuifui mea gaosi uiga ma poloaiga i lalo o le tulafono o le gaosiga e tasi se'i vagana ua latou lisiina manino le code gaosi oloa. introducedIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa na faʻafeiloaʻi ai le fuifui. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. RemoveIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa na aveese ai le fuifui. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. singleton(boolean): E fa'aaogaina e fa'ailoa ai se fuifui e pei o se tasitoni e na'o le tasi le fa'ata'ita'iga o lena fuifui fa'asoa i pito pito. uiga: fa'amatalaina se uiga mo le igoa fuifui: Igoa o le uiga o lo'o ta'ua i le va o le uiga tag.
igoa uiga
itu(client/server): Le itu o le fuifui lea e fesootai ai foi le uiga. code: uiga fa'ailoga code gaosi oloa: E mafai ona fa'aaoga e fa'amatala ai se uiga fa'apitoa gaosi oloa i fafo atu o le fa'amatalaga zigbee o lo'o ta'ua e le xml masani. fa'amatala: fa'auiga fa'auiga o lo'o fa'aogaina e le generator code e fa'amatala ai se uiga i se auala fa'apitoa ituaiga: le ituaiga o uiga e mafai ona avea ma so'o se ituaiga fa'amaumauga o lo'o ta'ua i le xml default: tau fa'aletonu mo le uiga. min: Fa'atauga maualalo fa'atagaina mo se uiga maualuga: Tulaga maualuga fa'atagaina mo se uiga e mafai ona tusia: E mafai ona tusia le tau o uiga pe leai. E mafai ona fa'aoga lenei mea e puipuia ai le uiga mai le suia e ala i le tusiaina o poloaiga. faitalia(boolean): Fa'aaoga e iloa ai pe o se uiga e filifili pe leai mo le fuifui. min: Fa'atauga maualalo fa'atagaina mo se uiga pe'a ose integer, enum po'o le bitmap type. max: Tulaga maualuga fa'atagaina mo le uiga pe'a ose integer, enum po'o le bitmap ituaiga umi: Fa'aaogaina e fa'amaoti ai le umi maualuga o le uiga pe a o le manoa ituaiga. minLength: Fa'aaoga e fa'ailoa ai le umi la'ititi o le uiga pe a o'o i le ituaiga manoa. lipoti (boolean): Ta'u mai pe o se uiga e lipotia pe leai isNullable(boolean): Fa'ataga null tau mo le uiga. array(boolean): Fa'aaogaina e fa'ailoa ai se uiga o le ituaiga array. introducedIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa na faʻaalia ai le uiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. RemoveIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa na aveesea ai le uiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. poloaiga: fa'amatala se fa'atonuga mo se igoa fuifui: Igoa o le fa'atonuga.

code: tulafono fa'atonu

18/35

XML fa'apitoa Tags mo Zigbee
code gaosi oloa: E mafai ona faʻaaogaina e faʻamatala ai se faʻatonuga faʻapitoa i fafo atu o le zigbee faʻamatalaga o loʻo taʻua e le xml masani. faʻamatalaga: faʻamatalaga o le faʻatonuga puna (tagata faʻatau / server): puna o le poloaiga. faitalia(boolean): Fa'aaoga e iloa ai pe o se poloaiga e filifili pe leai mo le fuifui. introducedIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa na faʻaalia ai le poloaiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. RemoveIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa lea na aveese ai le poloaiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. poloa'iga finauga:
O poloaiga ta'itasi e mafai ona i ai se seti o fa'atonuga igoa igoa: igoa o le ituaiga fa'atonuga: ituaiga o le fa'atonuga o le finauga lea e mafai ona avea ma so'o se ituaiga o lo'o ta'ua i le xml. min: Fa'atauga aupito maualalo e fa'atagaina mo se finauga pe a fa'atatau i le numera, enum po'o le fa'asologa o ata. max: Tulaga maualuga fa'atagaina mo se finauga pe'ā ose integer, enum po'o le bitmap ituaiga umi: Fa'aaoga e fa'amaoti ai le umi fa'atagaina mo se finauga fa'atonu pe a o le manoa. minLength: Faʻaaogaina e faʻamaonia ai le umi faʻatagaina maualalo mo se finauga faʻatonu pe a fai o le manoa. array(boolean): Ia iloa pe o le finauga o le poloaiga o le ituaiga array. presentIf( manoa): E mafai ona avea lea ma se manoa tuutuuga o gaioiga talafeagai e faʻavae i luga o isi faʻatonuga finauga lea e mafai ona e faʻamoemoeina le faʻatonuga o le faʻatonuga pe a fai o le manoa tuutuuga e iloilo i le moni. fa'ata'ita'iga:

Manatua: O le tulaga lea o le isi igoa ole fa'atonuga. faitalia(boolean): Fa'aaogā e fa'amautu ai le finauga o le fa'atonuga e filifili. countArg: Faʻaaogaina pe a fai o le finauga o le faʻatonuga o le ituaiga array. E faʻaaogaina lea mea e taʻua ai le isi faʻatonuga finauga lea e faʻaalia ai le tele o laina mo lenei finauga.

introducedIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa lea na faʻaalia ai le finauga o le poloaiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. RemoveIn: Faʻaaogaina e fuafua ai le faʻamatalaga faʻapitoa lea na aveese ai le finauga o le poloaiga. O lenei mea e faʻaaogaina e le code generator e faʻaopoopo ai manatu faʻaopoopo. Cluster Extension e mafai ona faauigaina i totonu ole configurator tag. O le fa'aopoopoga fa'aopoopo e fa'aoga e fa'alautele ai se fuifui fa'ata'ita'i fa'atasi ai ma uiga gaosi ma fa'atonuga eg

19/35

XML fa'apitoa Tags mo 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=”moni” manufacturerCode=”0 1002″>Sample Mfg Uiga Fa'apitoa: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF”writable=”true” default=”0 0000″ optional=”moni” manufacturerCode=”0 1049″>Sample Mfg Uiga Fa'apitoa: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF”writable=”true” default=”0 00″ optional=”moni” manufacturerCode=”0 1002″>Sample Mfg Uiga Fa'apitoa: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF”writable=”true” default=”0 0000″ optional=”moni” manufacturerCode=”0 1049″>Sample Mfg Uiga Fa'apitoa: 0 0001 0 1040ampleMfgSpecificOffWithTransition" filifiliga = "moni" manufacturerCode = "0 1002"> Poloaiga Client e tape ai le masini ma se suiga ua tuuina mai
i le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificOnWithTransition" filifiliga = "moni" manufacturerCode = "0 1002"> Poloaiga Client e fa'aola ai le masini ma se suiga ua tu'uina atu
i le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificToggleWithTransition" filifiliga = "moni" manufacturerCode = "0 1002"> Poloaiga a le tagata fa'atau e sui ai le masini ma se suiga ua tu'uina atu
i le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificOnWithTransition2″ faitalia = “moni” manufacturerCode =”0 1049″> Poloaiga Client e fa'aola ai le masini ma se suiga ua tu'uina atu
i le taimi o suiga i le Ember Sample uiga tau suiga.ampleMfgSpecificToggleWithTransition2″ filifiliga = “moni” manufacturerCode =”0 1049″> Poloaiga a le tagata fa'atau e sui ai le masini ma se suiga ua tu'uina atu
i le taimi o suiga i le Ember Sample uiga tau suiga.

20/35

Tele Ituaiga Masini I le I'uga

Ole mea lea ole Matter-na'o le mea lea e mafai ai e le tagata fa'aoga ona filifili e sili atu ma le tasi le ituaiga masini i le pito. O le fa'aopoopoina o le tele o ituaiga masini aaa o le a fa'aopoopoina ai le fa'aputuga o fuifui i totonu o ituaiga masini i le fa'asologa o le pito.

21/35

Tele Ituaiga Masini I le I'uga

O le ata o lo'o i luga o lo'o fa'aalia ai o le pito 1 e sili atu ma le tasi ituaiga masini ua filifilia. O le "Masini Tulaga Muamua" o lo'o fa'aalia ai le ituaiga masini muamua o le a fa'afeso'ota'i le pito i'uga. O le ituaiga masini muamua o lo'o i ai i taimi uma i le fa'asinomaga 0 o le lisi o ituaiga masini ua filifilia ina ia filifilia se isi ituaiga masini autu o le a suia ai le fa'atonuina o ituaiga masini ua filifilia. O filifiliga ituaiga masini e iai fo'i fa'alavelave e fa'atatau i le Fa'amatalaga Fa'ata'ita'i Fa'amatalaga. E puipuia e le ZAP tagata fa'aoga mai le filifilia o tu'ufa'atasiga le aoga o ituaiga masini i luga o se pito e fa'aaoga ai nei tapula'a.

22/35

Itulau Fa'apitoa Ituaiga Meafaitino Mea
Itulau Fa'apitoa Ituaiga Meafaitino Mea
Itulau Fa'apitoa Ituaiga Meafaitino Mea
E lagolagoina e le ZAP le va'aiga ma le fesuia'iina o foliga o le Matter i le itulau fa'atusa o masini. E na'o le ituaiga masini foliga o lo'o fa'amaoti mai ile matter-devices.xml ile fale teu oloa CHIP ole a fa'aalia.

Fa'asaga i le Itulau Fa'aaliga
ò Tatala le ZAP i Matter ma le Matter SDK lata mai. ó Fausia se fa'ai'uga i se ituaiga masini Matter. O Kiliki le masini Type Features button i le pito i luga ogatotonu o le fuifui view. Manatua o lenei fa'amau e na'o le ZAP e maua
fetuutuuna'i mo Matter ma pe a iai fa'amaumauga o fa'amaumauga i le Matter SDK. O le kilikiina o lenei faamau o le a tatala ai le ata o loʻo i luga.
Fa'atatauga
Fa'atonuga fa'amatala le filifiliga ma le fa'alagolago mo uiga, fa'atonuga, mea tutupu, ma ituaiga fa'amaumauga. E iloa ai pe fa'atulafonoina se elemene, faitalia, pe le lagolagoina i lalo o nisi fa'atulagaga ZAP.
E fa'amuamua le fa'aogaina o foliga o ituaiga masini nai lo le fa'aogaina o foliga o fuifui. Mo example, o le fa'aaliga moli e iai le fa'amaliega i le fa'aputuga On/Off ae fa'ailoa e fa'atulafonoina i le ituaiga masini I/Off Light e aofia ai le fuifui On/Off. O le fa'atupuina o se fa'ai'uga fa'atasi ma le On/Off Light device type o le a fa'aalia ai le fa'aaliga o le moli e fa'atulafonoina ile itulau fa'aaliga.
Fa'aaliga Toggling
I luga o le itulau faʻaalia, pe a uma ona e kiliki le kiki e mafai ai pe faʻamalo ai se vaega, ZAP o le a:
Fa'afou elemene feso'ota'i (uiga, fa'atonuga, mea e tutupu) e fa'asa'o ai le fa'atatau, ma fa'aali se talanoaga e fa'aalia ai suiga.

23/35

Matter Device Type Feature Page Fa'afou le vaega vaega i le featureMap uiga o le fuifui fa'atasi

Fa'aagaoi le Fa'aaliga Fa'aaliga

Fa'agata Fa'amatalaga Fa'aaliga

E fa'aletonu le fa'amalo mo nisi vaega pe a le iloa le fa'atatau po'o se fomu e le'o lagolagoina i le taimi nei. I lenei tulaga, o le a faʻaalia e le ZAP lapataiga ile faʻamatalaga ap ne.
a Wa Element Conform nce rnings

A e suiina se elemene, e mafai e le ZAP ona faʻaalia lapataiga o le tausisia o masini ma lapataʻiga tausisia. Afai e le fetaui le tulaga o le elemene ma le fa'atonuga o lo'o fa'amoemoeina, o le a fa'aalia e le ZAP se fa'ailoga lapatai ma fa'amau le lapataiga i le fa'aaliga ap ne. ExampLe o le tausisia ma le tausisia o lapataiga o loʻo faʻaalia mo se elemene:

24/35

Fa'asilasilaga
Fa'asilasilaga
Fa'asilasilaga
O le vaega o lo'o mulimuli mai o lo'o fa'amatalaina ai le tu'uina atu o fa'amatalaga i tagata fa'aoga ZAP ile UI.
Fa'asilasilaga o Paketi
O fa'amatalaga o afifi o lapata'iga po'o fe'au sese e feso'ota'i mo so'o se afifi fa'apitoa e utaina i le ZAP. Mo example, i ata o loʻo i lalo, o le kilikiina o le lapataiga faʻailoga i lalo o le tulaga koluma o le a taʻitaʻia oe i se talanoaga e faʻaalia ai faʻamatalaga uma mo lena afifi.

25/35

Fa'asilasilaga
Fa'aaliga o Sauniga
O fa'amatalaga o sauniga o lapata'iga po'o fa'amatalaga sese e feso'ota'i ma se fa'aoga fa'aoga. O nei lapataiga/sese e mafai ona iloa e ala i le kiliki i le Faasilasilaga faamau i le meafaigaluega i luga o le ZAP UI. Mo example, o le ata o loʻo i lalo o loʻo faʻaalia ai le itulau faʻamatalaga o sauniga pe a maeʻa se isc file na utaina i le ZAP.

26/35

Fa'ata'ita'iga-Fa'ata'ita'iga/ZCL Fa'amatalaga Fa'atatau
Fa'ata'ita'iga-Fa'ata'ita'iga/ZCL Fa'amatalaga Fa'atatau
Fa'ata'ita'iga Fa'amatalaga ma le Fa'atonuga o le ZCL
O lenei vaega i le ZAP e fesoasoani i tagata fa'aoga latou te va'ai fa'aletonu le tausisia o Fa'ata'ita'iga po'o le ZCL ma a latou fa'asologa o le ZAP o iai. O fe'au lapata'i mo le usita'ia o le a fa'aalia i luga o le fa'aaliga Fa'aaliga i le ZAP UI ma o le a saini fo'i i le fa'amafanafanaga pe a fa'agasolo le ZAP i le CLI. O le vaega o le tausisia o lo'o tu'uina atu i le taimi nei lapata'iga mo le tausisia o ituaiga masini ma le tausisia o fa'aputuga i se pito.
Lapataiga Tausisi i le ZAP UI
Pe a tatalaina e se tagata fa'aoga se .zap file fa'aaoga le ZAP UI o le a latou va'ai ai i lapataiga i le fa'ailoga o le ZAP UI mo fa'aletonu uma. Mo example, o le ata o loʻo i lalo o loʻo faʻaalia ai le itulau faʻaaliga o sauniga pe a uma le .zap file na tatalaina i mataupu o le tausisia.

O fe'au o le usita'ia o le a aluese pe a uma ona fo'ia fa'afitauli i le fa'aogaina o le ZAP UI ina ia mafai ai ona e siaki na'o mataupu o lo'o totoe o le tausisia. O lapata'iga fou o le a fa'aalia fo'i mo le usita'ia pe a fa'agata e le tagata fa'atonu elemene fa'atulafonoina (vaega/poloaiga/uiga) o le fa'atulagaga. O faʻamatalaga o le tausisia o faʻamatalaga o le a mataʻituina pea soʻo se toilalo e faʻafeiloaʻi i le ZAP configuration ae ia maitauina o lapataiga e faʻaalia i le taimi o le tatalaina o se .zap. file e sili atu ona faʻamalamalamaina pe aisea na le mafai ai ona tausisia pe a faʻatusatusa i lapataiga e faʻaalia aʻo fegalegaleai ma le UI. O lenei mea e ala i le mamanu ma o le siaki atoatoa o le tausisia e faia i le taimi o le tatalaina o se .zap file.
Lapataiga Tausisi i luga ole Console

27/35

Fa'ata'ita'iga-Fa'ata'ita'iga/ZCL Fa'amatalaga Fa'atatau
Pe a tatalaina e se tagata fa'aoga se .zap file fa'aaoga le ZAP standalone UI po'o le ZAP CLI o le a latou va'ai i lapataiga o lo'o saini i totonu o le fa'amafanafanaga/fa'aumu mo fa'aletonu uma. Mo example, o le ata o loʻo i lalo o loʻo faʻaalia ai lapataiga faʻasalalauga sauniga i luga o le faʻamafanafana / faʻamau pe a maeʻa se .zap file na tatalaina i mataupu o le tausisia.

28/35

Pulea Avanoa

Avanoa Pulea Features
E lagolagoina e le ZAP le puleaina o avanoa i fa'alapotopotoga ZCL uma. E o'o i le fa'atinoga o le SDK e fa'afanua nei vaega i mea mana'omia ma lagolagoina le fa'atonuina o le SDK. E masani ona maua e le ZAP se faʻataʻitaʻiga faʻamatalaga ma se masini e faʻapipiʻi ai i le meta-info files ma fa'asalalauina fa'amaumauga i fa'ata'ita'iga fa'atupu, e aunoa ma le tu'uina atu o uiga fa'apitoa i fa'amaumauga.
Tulaga Faavae
Fa'atonuga avanoa a le ZAP o lo'o fa'amatalaina ai upu fa'avae se tolu, e fa'apea: ò fa'agaioiga : fa'amatalaina o se mea e mafai ona fai. Example: faitau, tusi, valaau. ó matafaioi: fa'amatala o se fa'amanuiaga a se tagata fai ata tifaga. Pei o le "View fa'amanuiaga", "Mafaifai fa'atonu", ma le atali'i. o suiga: fa'amatalaina o tulaga fa'apitoa e pulea avanoa, e pei o fa'amatalaga ma'ale'ale ie po'o fa'amaumauga e va'aia ie. O faʻamatalaga faavae o loʻo faʻamatalaina i le metadata XML i lalo ole pito i luga tag . O le mea lenei o se example o avanoa pulea fa'avae fa'amatalaga fa'amatalaga:
<role type=”view"fa'amatalaga ="View avanoa”/>
O lenei example fa'amatala fa'agaioiga e tolu, faitau, tusi ma vala'au, lua fa'aliliuga ma le fa matafaioi.
Avanoa Triplets
E mafai ona fa'amalamalamaina tulaga ta'itasi ta'ito'atasi i se triplet avanoa i le XML. Avanoa triplet o se tu'ufa'atasiga o se fa'agaioiga, matafaioi ma suiga. E filifili, e na'o le tasi o nei mea e mafai ona e maua. O se vaega o lo'o misi o le ta'i tolu o lona uiga e fa'ataga, lea e fa'atino-fa'apitoa mo le SDK ua tu'uina atu. O se fa'alapotopotoga e fa'amatalaina lona avanoa e mafai ona maua se tasi pe sili atu fo'i fa'atolu. O le mea lenei o se exampLe:
i0
O le fa'amatalaga lea o se uiga e iai se avanoa e tolu, fa'ailoa e mafai ai ona fa'agaioi le tusitusi e ala i se matafaioi fa'afoe, fa'atasi ai ma le fa'aogaina o le 'ie-scoped modifier.
Fa'atagaga Fa'atonu

29/35

Pulea Avanoa
E mafai e fa'alapotopotoga a le ZCL ona fa'amatala a latou lava fa'atagaga. Ae ui i lea, o loʻo iai foʻi se faʻamatalaga faʻavaomalo o faʻatagaga faʻatagaina mo
ituaiga tuuina atu. O nei mea e fa'atatau mo le fa'alapotopotoga tu'ufa'atasia, se'i vagana ua tu'uina atu ni ana fa'atagaga patino.
O fa'atagaga fa'aleaogaina e fa'ailoa mai e ala ile a tag i le pito i luga ole XML file. ExampLe:
aa a<ccess op=”invoke”/> a a aa < ccess op=”re d”/> a< ccess op=”tusi”/> a aa aa <ccess op=”re d” role=”view”/> aa <ccess op=”tusi” role=”oper te”/> a
Fesoasoani Fa'atusa
Ole fesoasoani fa'ata'ita'i autu e fa'aoga ole {{#access}} … {{/access}} iterator. O lenei fa'atonu e fa'asolosolo i luga o ta'i tolu avanoa avanoa.
E lagolagoina filifiliga nei e lua:
entity=”uiga/poloaiga/event” – afai e le mafai ona iloa le itutino mai le talaaga, e setiina le ituaiga faalapotopotoga. includeDefault=”moni/sese” – e fuafua pe o iai ni tau fa'aletonu pe leai. O le mea lenei o se exampLe:
{{#zcl_clusters}}
a Cluster: {{n me}} [{{code}}] a {{#zcl_ ttributes}} aa – ttribute: {{n me}} [{{code}}] aa {{# ccess entity=” ttribute”}}
O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{code}}] aa {{}} O ccess entity” * * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – mea tutupu: {{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

Fa'alauiloa ZAP mo Matter po'o Zigbee talosaga
Fa'alauiloa ZAP mo Matter po'o Zigbee talosaga
Tatalaina le ZAP mo Matter po'o Zigbee Applications
O vaega o lo'o mulimuli mai o lo'o fa'amatalaina ai le fa'alauiloaina o le ZAP i le tulaga tuto'atasi ma le Matter po'o le Zigbee-specific metadata. O le manatu o le faʻalauiloaina o le ZAP ma faʻamatalaga saʻo e fesoʻotaʻi ma metadata XML (o faʻamatalaga ma faʻamatalaga ituaiga masini e tusa ai ma faʻamatalaga CSA) ma faʻataʻitaʻiga faʻavae, lea e faʻaaogaina e gaosia ai le code talafeagai.
Tatalaina le ZAP ma Matter
O le fa'amaumauga o lo'o mulimuli mai e pikiina le metadata sa'o mai le Matter SDK pe a fa'alauiloa le ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Faʻaaliga: E mafai foʻi ona e faʻaogaina le Zigbee lea e faʻalauiloa ai le ZAP i Matter.
Tatala ZAP ma Zigbee
O le fa'atonuga o lo'o mulimuli mai e fa'alauiloa le ZAP fa'atasi ai ma fa'amatalaga ZCL ma fa'ata'ita'iga fa'atupu mai le 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-ala: O le ala lea i le ZAP puna poʻo le faʻaaogaina sdk-ala: O le ala lea i le SDK
Tatala ZAP e aunoa ma Metadata
Manatua pe a faʻalauiloa saʻo le ZAP e ala i se faʻaogaina poʻo mai le puna e faʻaaoga ai le npm run zap o loʻo e faʻalauiloaina le ZAP ma suʻega metadata mo Matter / Zigbee fausia i totonu o le ZAP ae le o metadata moni e sau mai le Matter ma Zigbee SDKs o loʻo taʻua i luga. O le mea lea, ia manatua e fai au fa'atonuga ZAP e ala i le fa'aogaina o le SDK metadata ae le o le tatalaina sa'o o le ZAP fa'atasi ai ma metadata su'ega ua fausia.

31/35

Fausia code mo Matter poʻo Zigbee

Fa'atupu Tulafono mo Matter, Zigbee po'o se SDK Fa'apitoa
O vaega nei o lo'o fa'amatalaina pe fa'apefea ona fa'atupu fa'ailoga e fa'aaoga ai le ZAP.
Fausia Code Fa'aaoga le ZAP UI
Tatala le ZAP UI e tusa ai ma faʻatonuga ile Launching ZAP for Matter or Zigbee ma kiliki i le Fausia faʻamau i le pito i luga o le lisi.
Fausia Code e aunoa ma le UI
O fa'atonuga nei o lo'o tu'uina atu ai auala eseese e fa'atupu ai le code e ala i le CLI e aunoa ma le fa'alauiloaina o le ZAP UI.
Fausia Code mai le ZAP Source
Faʻatonu le faʻatonuga o loʻo i lalo e faʻatupu ai le code e faʻaaoga ai le ZAP mai le puna: 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
Fausia Code mai le ZAP Executable
Faʻataʻitaʻi le poloaiga lenei e faʻatupu ai le code e faʻaaoga ai le ZAP executable: [zap-path] faʻatupu -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
Fausia Code mai le ZAP CLI Executable
Faʻatonu le faʻatonuga o loʻo i lalo e faʻatupu ai le code e faʻaaoga ai le ZAP CLI Executable: [zap-cli-path] faʻatupu -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

Fa'afou le ZAP ile Studio

Fa'afou le ZAP
Fa'afou le ZAP ile Simplicity Studio
O lenei masini e mafai ona faʻaoga pe a galue ma Matter extension poʻo Zigbee mai faʻasalalauga Silicon Labs SDK. E mafai ona fa'afou le ZAP i totonu o le Simplicity Studio e aunoa ma le fa'asa'oina o le Simplicity Studio e ala i le la'uina mai o le ZAP executable (fautuaina) po'o le tosoina o le mea fou mai le puna ZAP e pei ona fa'aalia i le ZAP Installation Guide. A mae'a ona e maua le ZAP fou e fa'atatau i lau OS o lo'o fa'aogaina nei, e mafai ona e fa'afouina le ZAP i totonu o le Studio e fai ma pusa fa'apipi'i. Mulimuli i fa'atonuga o lo'o i lalo pe a uma ona la'uina le ZAP fou:
Alu i le Simplicity Studio ma filifili Mana'oga > Simplicity Studio > Adapter Packs. Kiliki Fa'aopoopo... ma su'esu'e i le fa'alautele ZAP faila na e siiina mai ma kiliki Filifili Folder. Kiliki Talosaga ma Tapuni ona fa'aopoopoina lea ole ZAP ole a fa'aoga i so'o se taimi ole .zap file ua tatalaina.
Fa'aaliga: O nisi taimi e ono iai ni fa'ata'ita'iga tuai o le ZAP o lo'o fa'agasolo e tusa lava pe ua uma ona fa'afou ile ZAP lata mai. Ia mautinoa e fa'amuta uma fa'ata'ita'iga ZAP o lo'o iai ina ia fa'aoga le ZAP fou na aumai nai lo se fa'ata'ita'iga tuai, lea o lo'o galue pea i tua.
Faʻafou le ZAP mo le Atinaʻeina o Mataupu ile Github
A e galue ma le Matter or Matter-Silicon Labs repos i Github, seti le siosiomaga fesuiaiga e faʻatatau i le ZAP e fatu / faʻatupuina fou ZAP configurations pe toe faʻatupu s o iai.ample ZAP configurations pe a uma ona faʻaoga suiga ia i latou. Seti le ZAP_DEVELOPMENT_PATH i le ZAP mai le fa'apogai e ala i le tosoina o le mea aupito lata mai pe seti le ZAP_INSTALLATION_PATH i le ZAP e mafai ona fa'atinoina na e la'uina mulimuli i lau fa'atonuga. Manatua a seti uma le ZAP_DEVELOPMENT_PATH ma le ZAP_INSTALLATION_PATH, e faʻaaoga le ZAP_DEVELOPMENT_PATH.
O mea nei o exampo lo'o fa'aalia ai suiga ole siosiomaga o lo'o i luga o lo'o fa'aogaina:
Fa'ailoaina le ZAP e fa'aaoga ai le Matter specification Toe fa'afouina uma sample ZAP configurations mo talosaga Matter
Fa'aaliga: A fa'aoga ZAP executables, fa'amautinoa o lo'o e fa'aogaina se fa'asalalauga aloa'ia i luga o le fa'amalo i le po mo le mautu. Vaai
La'uina o le ZAP Executable i le ZAP Installation Guide

33/35

Feso'ota'i Tele-protocol i le va o Zigbee ma Matter
Feso'ota'i Tele-protocol i le va o Zigbee ma Matter
MCoanttceurrrent Multi-protocol i le va o Zigbee ma
E mafai ona faʻaogaina le ZAP e faʻapipiʻi ai ZCL (Zigbee) ma Faʻamatalaga-Faʻataʻitaʻiga (Matter) i se faʻaoga tele-protocol mo Zigbee ma Matter. O le ZAP e mafai ai ona e faia fa'ai'uga mo le Zigbee ma le Matter i le fa'atulagaga tutusa file. Afai o le Zigbee ma le Matter endpoints o loʻo i luga o le mea e tasi e iloagofie ai (mo example, LO Malamalama Fa'apa'u ile pito Id 1 ma Matter Dimmable Malamalama ile isi fa'ata'ita'iga ole fa'ai'uga 1), e fa'atonutonu e le ZAP le fa'amaopoopoina o uiga masani ile uiga o Matter ma Zigbee. Ia mautinoa o uiga o loʻo tuʻufaʻatasia e tutusa le ituaiga faʻamaumauga. O uiga masani i le va o Zigbee ma Matter e faʻavaeina e ala i a file taʻua multi-protocol.json . E mafai e le tagata fa'aoga ona fa'afeso'ota'i so'o se lua fuifui i luga ole Zigbee ma Matter fa'atasi ai ma o latou uiga tutusa e fa'aaoga ai le fuifui ma fa'ailoga fa'atusa. Lenei file e mafai ona maua i le [SDKPath]/app/zcl/multi-protocol.json . Lenei file ua fa'afouina i se seti o fuifui ma uiga e amata ai, ae mafai e le tagata fa'aoga ona fa'afouina lenei mea file pe a mana'omia ma o le a tausia e le ZAP le fa'aogaina o le fa'atulagaina o uiga i le Zigbee ma le Matter mo fa'amatalaga masani fa'ai'uga.
E mafai fo'i ona e su'eina se a'oa'oga ZAP i so'o se Zigbee ma Matter multi-protocol application i lalo ole itulau a'oa'oga. O lenei aʻoaʻoga o le a taʻitaʻia oe i le tele-protocol application process process. O lenei aʻoaʻoga e naʻo avanoa pe a e tatalaina se faʻaoga tele-protocol o loʻo iai ma e mafai ona maua e pei ona faʻaalia i le ata o loʻo i lalo:

34/35

Fa'atasi le SLC CLI ma le ZAP
Fa'atasi le SLC CLI ma le ZAP
Fa'atasi le SLC CLI ma le ZAP
Mulimuli i laasaga nei e faʻapipiʻi ai le SLC CLI ma le ZAP: ò Faʻapipiʻi le SLC CLI e ala i le mulimuli i faʻatonuga faʻapipiʻi i le Simplicity Studio 5 User Guide. ó Fa'apipi'i le ZAP e ala i le mulimuli i fa'atonuga o lo'o i le Taiala Fa'apipi'i ZAP. ô Ina ia tuʻufaʻatasia le SLC CLI ma le ZAP, faʻaopoopo se suiga ole siosiomaga STUDIO_ADAPTER_PACK_PATH e faasino ile talosaga ZAP.
fa'atonuga. õ Manatua e toe amata le SLC CLI Daemon pe a uma le Laasaga 3. ö So'o se poloketi e fa'aogaina le ZAP o le a fa'aogaina nei le ala fa'amatala i le Laasaga 3 pe a fa'atupu mai le SLC CLI. Faamolemole silasila ile SLC CLI
Fa'aoga mo fa'atonuga ile fa'aogaina ole SLC CLI mo au galuega.

35/35

Pepa / Punaoa

SILICON LABS ZAP Atina'e ma Silicon Labs [pdf] Tusi Lesona a le Pule
ZAP Atina'e ma Silicon Labs, ZAP, Atina'e fa'atasi ma Silicon Labs, Silicon Labs, Labs

Fa'asinomaga

Tusi Taiala

ZAP Atina'e ma Silicon Labs

Fa'amatalaga

Fa'atonuga o le Fa'aaogaina o Mea

FAQs

Atiina ma le Silicon Labs ZAP

ZAP Amataina

Fa'apipi'i ZAP

Fa'avae ZAP

XML fa'apitoa

XML fa'apitoa Tags mo Zigbee

Tele Ituaiga Masini I le I'uga

Pulea Avanoa

Fausia code mo Matter poʻo Zigbee

Fa'afou le ZAP ile Studio

Pepa / Punaoa

Fa'asinomaga

Tuu se faamatalaga

Fa'aleaogaina le tali