ZAP Jiżviluppa Bil-Manwal tas-Sid tas-Silicon Labs

ZAP Nibdew
- Biex tibda b'ZAP, segwi dawn il-passi:
  - Niżżel iż-ŻAP Executable mir-repożitorju uffiċjali.
  - Installa d-dipendenzi bl-użu tal-kmand npm install.
  - Għal installazzjoni speċifika għall-Windows, irreferi għall-gwida Installazzjoni ZAP għall-Windows OS.
Żvilupp Zigbee
- Jekk qed tiżviluppa applikazzjonijiet Zigbee:
  - Uża Simplicity Studio li jinkludi ZAP u għodod oħra meħtieġa.

Żvilupp tal-Materja
- Jekk qed tiżviluppa applikazzjonijiet tal-Matter:
  - L-għażliet jinkludu l-użu ta’ Simplicity Studio jew l-aċċess għar-repożitorji ta’ Silicon Labs jew CSA Github.
  - Irreferi għall-istruzzjonijiet tal-aġġornament għal ZAP barra miċ-ċiklu ta' rilaxx ta' Simplicity Studio jekk meħtieġ.

FAQs

Q: X'inhuma l-verżjonijiet differenti tal-binarji ZAP disponibbli?
- A: Hemm żewġ verżjonijiet disponibbli - Rilaxx uffiċjali b'bini verifikat u rilaxx minn qabel bl-aħħar karatteristiċi.

Q: X'għandi nagħmel jekk niltaqa' ma' problemi ta' kumpilazzjoni tal-libreriji indiġeni waqt l-installazzjoni?
- A: Irreferi għall-informazzjoni tal-FAQ dwar skripts speċifiċi għall-pjattaforma biex issolvi kwistjonijiet bħal dawn.

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Żvilupp ma' Silicon Labs ZAP

Nibdew
ZAP Nibdewview Installazzjoni ZAP Installazzjoni ZAP Windows FAQ
Fundamenti ZAP Fundamenti
Gwida tal-Utent ZAP Gwida tal-Utent Overview Custom XML Custom XML Tags għal Zigbee Multiple Device Types Per Endpoint Matter Device Type Feature Page Notifiki Data-Mudell/ZCL Speċifikazzjoni Konformità Kontroll ta’ Aċċess Tnedija ta’ ZAP għal Matter jew applikazzjonijiet Zigbee Ġenerazzjoni ta’ kodiċi għal Matter jew Zigbee Aġġornament ZAP fi Studio Multi-protocol Koncurrent bejn Zigbee u Matter Integra SLC CLI ma ZAP

1/35

Żvilupp ma' Silicon Labs ZAP
Żvilupp ma' Silicon Labs ZAP
ZAP
ZAP hija magna ġenerika tal-ġenerazzjoni tal-kodiċi u interface tal-utent għal applikazzjonijiet u libreriji bbażati fuq il-Librerija tal-Cluster Zigbee minn Zigbee jew il-Mudell tad-Data minn Materja. L-ispeċifikazzjoni hija żviluppata mill-Konnettività Standards Alliance. ZAP jippermettilek li twettaq l-operazzjonijiet li ġejjin:
Wettaq ġenerazzjoni personalizzata speċifika għall-SDK tal-artifatti globali kollha (kostanti, tipi, IDs, eċċ) ibbażati fuq l-ispeċifikazzjoni ZCL/Data-Mudell. Wettaq ġenerazzjoni personalizzata speċifika għall-SDK tal-artifatti kollha tal-konfigurazzjoni magħżula mill-utent (konfigurazzjoni tal-applikazzjoni, konfigurazzjoni tal-endpoint, eċċ) ibbażati fuq speċifikazzjoni ZCL/Data-Mudell u konfigurazzjoni tal-applikazzjoni pprovduta mill-klijent. Ipprovdi UI għall-utent aħħari biex jagħżel konfigurazzjoni speċifika tal-applikazzjoni (endpoints, clusters, attributi, kmandi, eċċ).

Il-kontenut f'dawn it-taqsimiet jiddeskrivi kif tiżviluppa applikazzjonijiet Zigbee u Materja billi tikkonfigura s-Saffi ZCL (Zigbee) jew Mudell tad-Data (Matterja) bl-użu ta 'ZAP.

2/35

ZAP Nibdew

ZAP Nibdew
Nibdew maż-ZAP
Dawn it-taqsimiet jiddeskrivu metodi differenti biex jinħolqu applikazzjonijiet Zigbee u Matter. Innota li Simplicity Studio jipprovdi mod kif toħloq l-applikazzjonijiet Zigbee u Matter tiegħek minn tarf sa tarf fejn l-għodod kollha jiġu installati minn qabel flimkien ma 'Simplicity Studio (inkluż ZAP). Tista' wkoll tiddeċiedi li tesplora modi oħra kif toħloq l-applikazzjonijiet tiegħek, kif deskritt hawn.
Żvilupp Zigbee
L-iżviluppaturi tal-applikazzjonijiet Zigbee jistgħu jibnu l-applikazzjonijiet tagħhom billi jużaw Simplicity Studio, li diġà jinkludi ZAP u għodod oħra li jgħinuk tibni l-applikazzjoni tiegħek minn tarf sa tarf.
Żvilupp tal-Materja
L-iżviluppaturi tal-Applikazzjoni tal-Matter jistgħu jibnu l-applikazzjonijiet tagħhom billi jużaw il-metodi li ġejjin: Simplicity Studio: Dan jinkludi ZAP u għodod oħra li huma meħtieġa biex tinbena l-applikazzjoni Matter minn tarf sa tarf. Github (Laboratorji tas-Silicon) Github (CSA)
Nota: Biex taġġorna ZAP barra miċ-ċiklu ta' rilaxx ta' Simplicity Studio, ara aġġorna ZAP fi Simplicity Studio u Gwida ta' Installazzjoni ta' ZAP

3/35

Installazzjoni ZAP

Is-sezzjonijiet li ġejjin jiddeskrivu l-installazzjoni ta 'ZAP u kif taġġorna ZAP fi Simplicity Studio IDE.
Tniżżil taż-ŻAP Executable Rakkomandat)
Dan huwa l-mod rakkomandat kif tibda biż-ZAP. Tista 'tikseb l-aħħar binarji ZAP minn aa https://github.com/project-chip/zp/releses. Il-binarji mibnija minn qabel jiġu f'żewġ verżjonijiet differenti.
Rilaxx uffiċjali: Bini verifikati b'suites dedikati għat-test ta' Matter u Zigbee. Il-format tal-isem tar-rilaxx huwa vYYYY.JJ.MM. Pre-rilaxx: Bini bl-aħħar karatteristiċi u bug fixes iżda dawn il-bini MHUMIEX ivverifikati b'suites dedikati għat-test Matter u Zigbee. Il-format tal-isem tar-rilaxx huwa vYYYY.JJ.MM-filgħaxija.
Installazzjoni ta' ZAP mis-Sors
Istruzzjonijiet bażiċi biex Installa ZAP
Minħabba li din hija applikazzjoni node.js, għandek bżonn l-ambjent tan-node installat. L-aħjar mod biex tagħmel dan huwa tniżżel l-aħħar installazzjoni ta 'node, li tinkludi node u npm. Jekk għandek verżjoni eqdem ta 'node installata fuq il-workstation tiegħek, tista' tikkawża problemi, partikolarment jekk hija antika ħafna. Kun żgur li għandek l-aħħar verżjoni node v16.x bl-npm li huwa inkluż. Mexxi node –version biex tivverifika liema verżjoni tinġabar. v18.x huwa rakkomandat. Wara li jkollok verżjoni mixtieqa ta 'node, tista' tmexxi dan li ġej:
Installa d-Dipendenzi
Uża l-kmandi li ġejjin biex tinstalla d-dipendenzi:

npm install
Nota: Għall-installazzjoni ZAP speċifika għall-Windows, ara Installazzjoni ZAP għall-Windows OS Mhux rari li wieħed isib problemi ta' kumpilazzjoni ta' librerija nattiva f'dan il-punt. Hemm diversi skripts src-script/install-* għal pjattaformi differenti. Ara l-informazzjoni tal-FAQ dwar liema script għandu jaħdem fuq pjattaformi differenti u mbagħad erġa' wettaq npm install .
Ibda l-Applikazzjoni
Uża l-kmandi li ġejjin biex tibda l-applikazzjoni:

npm run zap
Ibda l-Front-End fil-Modalità ta 'żvilupp
Jappoġġja tagħbija mill-ġdid tal-kodiċi sħun, rappurtar ta 'żbalji, eċċ. Uża l-kmandi li ġejjin biex tibda l-front-end fl-iżvilupp
modalità:
quasar dev -m elettron
or

4/35

ZAP Insta at o ll in
npm run electron-dev

5/35

Windows Installazzjoni ZAP
Windows Installazzjoni ZAP
Installazzjoni ZAP għall-Windows OS
1. Windows Powershell
Fil-bar tat-tiftix tad-desktop, daħħal Windows Powershell u mexxi bħala amministratur. Mexxi l-kmandi kollha li ġejjin ġewwa Powershell.
2. Ċikkulata
Installa minn https://chocolatey.org/install. Iċċekkja jekk installat sew bil-kmandi li ġejjin:
choco -v
Installa l-pakkett pkgconfiglite bil-kmandi li ġejjin:
choco install pkgconfiglite
3. Installa Node
Mexxi l-kmandi li ġejjin biex tinstalla:
choco jinstalla nodejs-lts
* Il-verżjoni trid tkun 18 biex tgħaddi t-test tal-verifika tal-verżjoni, wara l-installazzjoni, iċċekkja b'node -v *Jekk diġà installajt Node, u falla xi testijiet simili għal ma tistax issib Node, erġa' installa Node bi ċikkulata.
4. Segwi l-Istruzzjonijiet Bażiċi biex Tinstalla ZAP
Segwi l-istruzzjonijiet tal-installazzjoni ZAP mis-sors fl-Installazzjoni ZAP. Filwaqt li ssegwi l-istruzzjonijiet bażiċi għall-installazzjoni ta’ ZAP oqgħod attent għall-iżbalji li ġejjin u kif issolvihom:
sqlite3
Meta tħaddem ZAP (eż. npm run zap ), jekk tara żball dwar sqlite3.node f'tieqa pop up, agħmel:
npm rebuild sqlite3
il-bennej tal-elettroni
Meta tagħmel npm install, wara l-installazzjoni, jekk iseħħ żball fuq il-kmand li ġej relatat ma 'elettron-builder install-appdeps , npx electron-rebuild canvas fallut jew node-pre-gyp , il-verżjoni attwali tal-kanvas mhix kompatibbli mal-Windows u l-iżball ta' installazzjoni mhux se jikkawża falliment fit-tħaddim ta 'ZAP. node-canvas qed jaħdem fuq is-soluzzjoni issa u l-kwistjoni se tissolva fil-futur qarib.
“postinstall”: “elettron-builder install-app-deps && husky install && npm rebuild canvas –update-binary && npm run version-stamp”

6/35

Windows Installazzjoni ZAP
Kanvas
Jekk npm run test ifalli minħabba l-iżball Test suite naqset milli taħdem. Ma tistax issib il-modulu '../build/Release/canvas.node' jew
zapnode_modulescanvasbuildReleasecanvas.node mhix applikazzjoni Win32 valida. , ibni mill-ġdid il-kanvas kif ġej:
npm rebuild canvas –update-binary
tikseb index.html jew Kwistjonijiet Oħra dwar Server
Jekk npm run test ifalli minħabba l-iżball tikseb index.html it-talba falliet bil-kodiċi tal-istatus 404 fit-testijiet tal-unità jew li jkollok server
kwistjonijiet ta 'konnessjoni fit-testijiet e2e-ci, mexxi l-kmandi li ġejjin:
npm run build
Oħrajn
Iċċekkja jekk il-verżjoni tan-node hijiex v18 u ipprova tinstallaha ma' Chocolatey.

7/35

FAQ
FAQ
Mistoqsijiet Frekwenti
Q: Kif tibda UI f'mod ta 'żvilupp? A: Tista 'tibda l-UI f'modalità ta' żvilupp, li tirriżulta f'setup li ġej:
Server HTTP separat għall-iżvilupp tal-quasar, li jġedded live fuq il-port 8080 ZAP back-end jaħdem fuq il-port 9070 Chrome jew browser ieħor, jaħdem b'mod indipendenti Biex tasal għal dik is-setup, segwi l-istruzzjonijiet hawn taħt. ò L-ewwel, ħaddem is-server tal-iżvilupp ZAP, li jibda mill-port 9070.
npm run zap-devserver ó Sussegwentement, ħaddem is-server tal-iżvilupp tal-quasar, li jibda mill-port 8080.
quasar dev ô Ippunta l-browser tiegħek jew mexxi wieħed kontra dak xieraq URL bl-argument tal-bqija tal-Port:
google-chrome http://localhost:8080/?restPort=9070

Q: Kif tagħmel dan jaħdem fuq Mac/Linux OS? A:
npm install jintuża biex tniżżel il-pakketti ta' dipendenza kollha meħtieġa. Jekk tara żbalji relatati ma 'node-gyp u libreriji lokali neqsin, bħal pixman , eċċ, qed nieqes dipendenzi indiġeni biex tissodisfa biex tikkompila binarji ta' nodi mhux mibnija minn qabel għal xi kombinazzjoni ta 'pjattaformi u verżjonijiet. Npm fuq is-sħaba qed taġġorna kontinwament il-lista ta' binarji pprovduti, għalhekk huwa possibbli li tiġborhom sew, imma jekk ma tagħmilx hekk, dawn huma struzzjonijiet għal pjattaformi differenti:
Fedora Core b'dnf:
dnf install pixman-devel Cairo-devel pango-devel libjpeg-devel giflib-devel
jew mexxi script:
src-script/install-packages-fedora
Ubuntu b'apt-get:
apt-get update apt-get install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
jew mexxi script:

8/35

FAQ
src-script/install-packages-ubuntu
OSX fuq Mac bil-birra Homebrew:
brew install pkg-config Cairo pango libpng jpeg giflib librsvg
jew mexxi script:
src-script/install-packages-osx
Q: Kif tagħmel dan jaħdem fuq Windows OS?
A: Kun żgur li huwa dejjem aġġornat u ma jkun hemm l-ebda tibdil li ma jkunx sar. Tip: git pull, git status u git stash huma ħbieb tiegħek. Trid tuża Chocolately biex tagħmel Zap jaħdem fuq Windows OS. Kun żgur li tniżżel il-pakkett pkgconfiglite.
choco install pkgconfiglite
Jekk għandek problemi bil-Kajr, pereżempjuample jekk ikollok żball dwar Cairo.h': Le tali file jew direttorju, agħmel dan li ġej: ò Iċċekkja jekk il-kompjuter tiegħek huwiex 32 jew 64 bit. ó Skont dan, niżżel il-pakkett xieraq minn dan is-sit
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:
Ikklikkja fuq Settings Avvanzati tas-Sistema. Fit-tab avvanzata ikklikkja fuq Varjabbli Ambjentali. Fit-taqsima Varjabbli tas-Sistema, sib il-varjabbli tal-ambjent PATH u agħżelha. Ikklikkja Editja u żid C:/GTK magħha. Jekk il-varjabbli tal-ambjent PATH ma teżistix, ikklikkja Ġdid. Jekk jpeglib.h ma jinstabx, ipprova dan li ġej: ò Fit-terminal, mexxi: choco install libjpeg-turbo ó Kun żgur li huwa nadif billi tuża: git clean -dxff u agħmel npm install mill-ġdid ô jekk ma jseħħux żbalji u jidhru biss twissijiet, ipprova uża npm audit fix õ jekk ma tistax tħaddem ZAP, mur fuq file src-script/zap-start.js ö Bidla
÷ const { spawn } = require('cross-spawn') to const { spawn } = require('child_process') ø Mexxi npm u mexxi zap. Referenzi:
https://github.com/fabricjs/fabric.js/issues/3611 https://github.com/benjamind/delarre.docpad/blob/master/src/documents/posts/installing-node-canvas-for-windows.html.md [https://chocolatey.org/packages/libjpeg-turbo#dependencies](https://chocolatey.org/packages/libjpeg-turbo#dependencies)
Q: Nirċievi żball "sqlite3_node" li ma nstabx jew simili.

9/35

FAQ
A: Ibni mill-ġdid l-irbit sqlite3 nattiv tiegħek. Biex tirranġa dan fil-biċċa l-kbira tal-każijiet, mexxi:
npm install
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Jekk xorta ma tissewwax, agħmel:
rm -rf node_modules u mbagħad erġa' pprova l-kmandi ta' hawn fuq. Kultant ittejjeb npm tiegħek jagħmel ukoll differenza:
npm install -g npm
Q: Niġi żball "Il-verżjoni N-API ta 'din l-istanza Node hija 1. Dan il-modulu jappoġġja verżjoni(jiet) N-API 3. Din l-istanza Node ma tistax tħaddem dan il-modulu."
A: Aġġorna l-verżjoni tan-node tiegħek. Is-soluzzjoni għal dan hija diskussa f'dan il-ħajt Stack Overflow: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Q: Il-PC tal-iżvilupp tiegħi ma jaħdimx maż-ZAP għal kwalunkwe raġuni. Nista' nuża kontenitur docker?
A: Iva tista '. TBD.
Q: Kif nista' nmexxi ZAP ġewwa VSCode?
A: Jekk inti VSCode fit-triq tiegħek daħħal il-zap repo u ttajpja l-kodiċi . Dan se jiftaħ ZAP f'VSCode. Biex tħaddem ZAP fil-modalità debug, agħżel l-ispazju tax-xogħol ZAP u kklikkja fuq l-ikona Mexxi fuq il-bar tal-għodda tan-naħa tax-xellug. Ikollok ftit għażliet minn fejn tagħżel biex tħaddem ZAP, agħżel Node.js Debug Terminal . Dan se tiftaħ tieqa terminali li minnha tista 'tidħol npm run zap , li se tehmeż id-debugger u tħaddem ZAP kif inti normalment mil-linja tal-kmand. Prosit, issa għandek tara ZAP jaħdem fid-debugger. Tista' tissettja breakpoints f'VSCode kif tagħmel fi kwalunkwe IDE ieħor.
Q: It-test tal-unità tal-UI jonqos b'xi żbalji madwar il-kanvas li ma jinbenax għall-verżjoni t-tajba tan-node. X'nagħmel?
A: Jekk tara l-iżball li ġej:
FAIL test/ui.test.js Test suite naqas milli jaħdem Il-modulu 'canvas.node' ġie kkompilat ma' verżjoni differenti ta' Node.js bl-użu ta' NODE_MODULE_VERSION 80. Din il-verżjoni ta' Node.js teħtieġ NODE_MODULE_VERSION 72. Jekk jogħġbok ipprova erġa' tikkompila jew terġa' tinstalla l-modulu (pereżempju, uża ` jew `npmn `).
fl-Oġġett. (node_modules/canvas/lib/bindings.js:3 18)
imbagħad mexxi: npm rebuild canvas –update-binary

10/35

Fundamenti ZAP

ZCL/Data-Mudell ZAP Fundamentali
Din it-taqsima fiha informazzjoni għal utenti ZAP ġodda. Ikklikkja fuq l-ikona tutorja fuq ir-rokna ta' fuq tal-lemin tal-UI ZAP, li turi kif toħloq konfigurazzjoni ZAP. It-tutorja jiggwidak permezz ta’ dan li ġej: Oħloq punt ta’ tmiem Agħżel tip ta’ apparat Ikkonfigura cluster Ikkonfigura attribut Ikkonfigura kmand Għal referenza dettaljata, ara Gwida tal-Konfiguratur ta’ Cluster Zigbee

11/35

Gwida għall-Utent ZAP
Gwida għall-Utent ZAP
Gwida għall-Utent ZAP
It-taqsimiet taħt din il-gwida jipprovdu aktar dettalji dwar il-karatteristiċi differenti pprovduti minn ZAP.

12/35

XML personalizzat

Żieda ta' Custom XML mill-UI ZAP
Ikklikkja fuq l-ikona "Estenzjonijiet" fl-UI ZAP. Ikklikkja fuq il-buttuna "+" żid biex tagħżel xml personalizzat file Ir-raggruppamenti tad-dwana, l-attributi, il-kmandi, eċċ għandhom jidhru fl-UI ZAP ladarba l-xml personalizzat ikun ġie miżjud.
Il-ħolqien tal-XML tad-dwana tiegħek f'Zigbee
It-taqsima turi kif toħloq clusters personalizzati tiegħek stess u testendi clusters standard eżistenti b'attributi u kmandi tad-dwana għal Zigbee.
Clusters Speċifiċi għall-Manifattur f'Zigbee
Tista 'żżid clusters speċifiċi għall-manifattur ma' pro standardfile. Aħna nipprovdu example ta 'dan hawn taħt. Biex tagħmel dan trid tissodisfa żewġ obbligi:
L-ID tal-cluster GĦANDU jkun fil-medda speċifika għall-manifattur, 0xfc00 – 0xffff. Id-definizzjoni tal-cluster trid tinkludi kodiċi tal-manifattur li se jiġi applikat għall-attributi u l-kmandi KOLLHA fi ħdan dak il-cluster u għandha tiġi pprovduta meta jintbagħtu u jirċievu kmandi u jinteraġixxu mal-attributi. Eżample:

Sample Mfg Cluster Speċifiku Ġenerali Dan il-cluster jipprovdi exampLe ta' kif il-Qafas ta' Applikazzjoni jista' jiġi estiż biex jinkludi clusters speċifiċi għall-manifattur.
0xFC00
ember sample attribut
ember sample attribut 2

A sample kmand speċifiku għall-manifattur fi ħdan l-sample speċifiċi għall-manifattur
cluster.

Kmandi Speċifiċi għall-Manifattur fi Standard Zigbee Cluster
Tista 'żżid il-kmandi tiegħek ma' kwalunkwe cluster Zigbee standard bir-rekwiżiti li ġejjin:
Il-kmandi speċifiċi għall-manifattur tiegħek jistgħu jużaw kwalunkwe km id fil-medda tal-id tal-kmand, 0x00 – 0xff. Trid tipprovdi wkoll kodiċi tal-manifattur għall-kmand sabiex ikun jista 'jiġi distint minn kmandi oħra fil-cluster u mmaniġġjat kif xieraq. EżampLe li testendi r-raggruppament On/Off bi kmandi tal-manifattura:

13/35

XML personalizzat
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” optional="true" manufacturerCode="0 1002″> Kmand tal-klijent li jitfi l-apparat bi tranżizzjoni mogħtija mill-ħin ta 'tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificOnWithTransition” optional="true" manufacturerCode="0 1002″> Kmand tal-klijent li jixgħel l-apparat bi tranżizzjoni mogħtija mill-ħin ta 'tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificToggleWithTransition” optional="true" manufacturerCode="0 1002″> Kmand tal-klijent li jibdel l-apparat ma 'tranżizzjoni mogħtija mill-ħin ta' transizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificOnWithTransition2″ optional=”true” manufacturerCode=”0 1049″> Kmand tal-klijent li jixgħel l-apparat bi tranżizzjoni mogħtija mill-ħin ta 'tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificToggleWithTransition2″ optional="true"
manufacturerCode="0 1049″> Kmand tal-klijent li jibdel l-apparat ma 'tranżizzjoni mogħtija mill-ħin ta' transizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.

Attributi Speċifiċi għall-Manifattur fi Standard Zigbee Cluster
Tista 'żżid l-attributi tiegħek ma' kwalunkwe cluster Zigbee standard bir-rekwiżiti li ġejjin:
L-attributi speċifiċi għall-manifattur tiegħek jistgħu jużaw kwalunkwe attribut id fil-firxa tal-attribut id, 0x0000 – 0xffff. Trid tipprovdi wkoll kodiċi tal-manifattur għall-attribut sabiex ikun jista' jiġi distint minn attributi oħra fil-cluster u mmaniġġjat kif xieraq. EżampLe ta' estensjoni tar-raggruppament Mixgħul/Mitfi b'attributi tal-manifattura:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” tip=”INT16U” min=”0 0000″
max="0xFFFF" writable="true" default="0 0000″ optional="true" manufacturerCode="0 1002″>Sample Mfg Attribut Speċifiku: 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 Attribut Speċifiku: 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 Attribut Speċifiku: 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 Attribut Speċifiku: 0 0001 0 1040
Il-ħolqien tal-XML tad-dwana tiegħek fil-Matter
It-taqsima turi kif toħloq clusters tad-dwana tiegħek stess u testendi clusters standard eżistenti b'attributi u kmandi tad-dwana għall-Matterja.
Clusters Speċifiċi għall-Manifattur fil-Matter
Tista 'żżid clusters speċifiċi għall-manifattur ma' in Matter. Aħna nipprovdu example ta 'dan hawn taħt.
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 personalizzat
Fl-eżample, il-kombinazzjoni tal-ID tal-bejjiegħ (ID tal-Manifattur tat-Test) ta '0xFFF1 u l-ID tal-cluster ta' 0xFC20 tirriżulta f'valur value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Ġenerali Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Is-Sampil-cluster MEI juri estensjonijiet tal-manifattur tal-grupp FlipFlop
Rispons għal AddArguments li jirritorna s-somma. Kmand li jieħu żewġ argumenti uint8 u jirritorna s-somma tagħhom. Kmand sempliċi mingħajr ebda parametri u mingħajr rispons.
Attributi Speċifiċi għall-Manifattur fi Clusters ta' Materja Standard
Tista 'żżid attributi speċifiċi tal-manifattur ma' kwalunkwe cluster Matter standard bir-rekwiżiti li ġejjin:
T aaaa hu raggruppat li l-attributi li qed jiżdiedu magħhom iridu jiġu speċifikati -
e xte nd ed > “>
Il-kodiċi tal-attribut huwa kombinazzjoni ta' 32 bit tal-kodiċi tal-manifattur u l-id għall-attribut. L-aktar 16-il bit sinifikanti huma l-kodiċi tal-manifattur. Il-firxa għall-kodiċijiet tal-manifattur tat-test hija 0xFFF1 – 0xFFF4. L-inqas 16-il bit sinifikanti huma l-ID tal-attribut. Il-firxa għall-attributi mhux globali hija 0x0000 – 0x4FFF.
ExampLe ta' estensjoni tal-cluster ta' Materjal On/Off b'attributi speċifiċi għall-manifattura:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ tip=”INT8U” min=”0 0000″
max="0xFFFF" writable="true" default="0 0000″ optional="true">Sample Mfg Attribut Speċifiku 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ tip=”INT16U” min=”0 0000″
max="0xFFFF" writable="true" default="0 0000″ optional="true">Sample Mfg Attribut Speċifiku 4
Kmandi Speċifiċi għall-Manifattur fi Clusters ta' Materja Standard
Tista 'żżid kmandi speċifiċi tal-manifattur ma' kwalunkwe cluster Matter standard bir-rekwiżiti li ġejjin:
T aaaa hu raggruppat li l-kum ndijiet li qed jiżdiedu magħhom iridu jiġu speċifikati -
e xte nd ed > “>
Il-kodiċi tal-kmand huwa kombinazzjoni ta '32-bit tal-kodiċi tal-manifattur u l-id għall-kmand. L-aktar 16-il bit sinifikanti huma l-kodiċi tal-manifattur. Il-firxa għall-kodiċijiet tal-manifattur tat-test hija 0xFFF1 – 0xFFF4. L-inqas 16-il bit sinifikanti huma l-ID tal-kmand. Il-firxa għall-kmandi mhux globali hija 0x0000 – 0x00FF.
ExampL-estensjoni tal-cluster ta' Materja Mixgħul/Mitfi b'raggruppamenti speċifiċi għall-manifattura:

15/35

XML personalizzat

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ optional="true"> Kmand tal-klijent li jixgħel l-apparat bi tranżizzjoni mogħtija mill-ħin ta 'tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ optional="true">
Kmand tal-klijent li jibdel l-apparat ma 'tranżizzjoni mogħtija mill-ħin ta' transizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.

16/35

XML personalizzat Tags għal Zigbee

Id-dokument li ġej jitkellem dwar kull wieħed mill-xml tags assoċjati ma 'Zigbee.
Kull xml file hija elenkata bejn il-konfiguratur tags:

It-tipi tad-dejta jistgħu jiġu definiti fil-konfiguratur tag. Zigbee bħalissa jappoġġja d-definizzjoni ta 'bitmaps, enums, interi, strings jew structs. Qabel ma tiddefinixxi aktar tipi kun żgur li tiċċekkja t-tipi atomiċi eżistenti kollha definiti f'types.xml u t-tipi kollha mhux atomiċi definiti fl-xml l-oħra files. Tista' tiddefinixxihom kif ġej:
Bitmap: isem: isem tat-tip bitmap. tip: Bitmap b'daqs bejn 8-64 bit jista 'jiġi definit, li kollha għandhom ikunu multipli ta' 8. Kull bitmap jista 'jkollu oqsma multipli b'isem u maskra assoċjati magħha. eż:

"`
Enum: isem: isem tat-tip enum. tip: Enum b'daqs bejn 8-64 bits jista 'jiġi definit, li kollha għandhom ikunu multipli ta' 8. Kull enum jista 'jkollha oġġetti multipli b'isem u valur assoċjat miegħu. eż:

Integer: Tipi Integer diġà huma definiti taħt tipi atomiċi li jeżistu f'types.xml. Id-daqs tagħhom jista 'jvarja minn 8-64 bit u jista' jkun iffirmat jew mhux iffirmat. eż:

String: Tipi String huma diġà definiti taħt tipi atomiċi li jeżistu f'types.xml. It-tipi ta' kordi attwali jinkludu sekwenza ta' ottetti, sekwenza ta' char, korda twila ta' ottetti u sekwenza twila ta' char eż:

Struct: isem: isem tat-tip struct. Kull struct jista 'jkollha oġġetti multipli b'isem u tip assoċjati magħha. It-tip jista 'jkun kwalunkwe tip predefinit taħt tipi ta' dejta. eż:

17/35

XML personalizzat Tags għal Zigbee

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

Clusters personalizzati jistgħu jiġu definiti fi ħdan il-konfiguratur tag. name: name of the cluster domain: domain of the cluster. Il-cluster se jidher fl-UI ZAP taħt dan id-dominju. deskrizzjoni: Deskription of the cluster code: cluster code define: cluster define liema huwa użat mill-ġeneratur tal-kodiċi biex jiddefinixxi l-cluster b'ċertu mod manufacturerCode: Użat biex jiddefinixxi cluster speċifiku tal-manifattura. Dan irid ikun bejn 0xfc00 – 0xffff. Il-kodiċi tal-manifattur għall-cluster jeħtieġ li jiġi definit kif ġej:

Raggruppament tal-manifattura awtomatikament jagħmel l-attributi u l-kmandi taħtu tal-istess kodiċi tal-manifattur sakemm ma jelenkawx b'mod espliċitu l-kodiċi tal-manifattur. introdudIn: Użat biex tiddetermina l-verżjoni spec li fiha ġie introdott il-cluster. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. removedIn: Użat biex tiddetermina l-verżjoni spec li fiha tneħħa l-cluster. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. singleton(boolean): Jintuża biex jiġi ddeterminat cluster bħala singleton b'tali mod li jkun hemm biss istanza waħda ta' dak il-cluster kondiviża bejn l-endpoints. attribut: jiddefinixxi attribut għall-isem tal-cluster: Isem tal-attribut jissemma bejn l-attribut tag.
isem attribut
side(client/server): In-naħa tal-cluster li magħha huwa assoċjat ukoll l-attribut. kodiċi: kodiċi tal-attribut kodiċi tal-manifattur: Dan jista 'jintuża biex jiddefinixxi attribut speċifiku tal-manifattur barra l-ispeċifikazzjoni zigbee msemmija mill-xml standard. tiddefinixxi: attribut jiddefinixxi liema huwa użat mill-ġeneratur tal-kodiċi biex jiddefinixxi attribut b'ċertu mod tip: it-tip tal-attribut li jista 'jkun kwalunkwe mit-tipi ta' data msemmija fl-xml default: valur default għall-attribut. min: Valur minimu permess għal attribut max: Valur massimu permess għal attribut li jista' jinkiteb: Il-valur tal-attribut jista' jinkiteb jew le. Dan jista 'jintuża biex jipprevjeni li l-attribut jiġi modifikat permezz ta' kmandi tal-kitba. optional(boolean): Użat biex jiddetermina jekk attribut huwiex fakultattiv jew le għall-cluster. min: Valur minimu permess għal attribut meta jkun tip ta' numru sħiħ, enum jew bitmap. max: Valur massimu permess għall-attribut meta jkun tul tat-tip integer, enum jew bitmap: Użat biex jispeċifika t-tul massimu tal-attribut meta jkun tat-tip string. minLength: Użat biex jispeċifika t-tul minimu tal-attribut meta jkun tat-tip string. rapportable(boolean): Jgħid jekk attribut huwa rapportabbli jew le isNullable(boolean): Jippermetti valuri nulli għall-attribut. array(boolean): Użat biex tiddikjara attribut tat-tip array. introdudIn: Użat biex tiddetermina l-verżjoni spec li fiha ġie introdott l-attribut. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. removedIn: Użat biex tiddetermina l-verżjoni spec li fiha tneħħa l-attribut. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. kmand: iddefinixxi kmand għal isem ta' cluster: Isem tal-kmand.

kodiċi: kodiċi tal-kmand

18/35

XML personalizzat Tags għal Zigbee
kodiċi tal-manifattur: Dan jista 'jintuża biex jiddefinixxi kmand speċifiku tal-manifattur barra l-ispeċifikazzjoni zigbee msemmija mill-xml standard. deskrizzjoni: deskrizzjoni tas-sors tal-kmand (klijent/server): sors tal-kmand. optional(boolean): Użat biex jiddetermina jekk kmand huwiex fakultattiv jew le għall-cluster. introdudIn: Użat biex tiddetermina l-verżjoni spec li fiha ġie introdott il-kmand. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. removedIn: Użat biex tiddetermina l-verżjoni spec li fiha tneħħa l-kmand. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. argumenti tal-kmand:
Kull kmand jista' jkollu sett ta' argumenti tal-kmand isem: isem tal-argument tal-kmand tip: tip tal-argument tal-kmand li jista' jkun kwalunkwe mit-tipi msemmija fl-xml. min: Valur minimu permess għal argument meta jkun tip ta' numru sħiħ, enum jew bitmap. max: Valur massimu permess għal argument meta jkun tul tat-tip integer, enum jew bitmap: Użat biex jispeċifika t-tul massimu permess għal argument tal-kmand meta jkun tat-tip string. minLength: Użat biex jispeċifika t-tul minimu permess għal argument tal-kmand meta jkun tat-tip string. array(boolean): Biex tiddetermina jekk l-argument tal-kmand huwiex tat-tip array. presentIf(string): Din tista' tkun sensiela kondizzjonali ta' operazzjonijiet loġiċi bbażati fuq argumenti tal-kmand oħra fejn tista' tistenna l-argument tal-kmand jekk is-sekwenza kondizzjonali tevalwa bħala vera. eż:

Nota: Hawnhekk l-istatus huwa isem ieħor tal-argument tal-kmand. optional(boolean): Użat biex jiddetermina l-argument tal-kmand bħala fakultattiv. countArg: Użat meta l-argument tal-kmand huwa ta’ tip array. Dan jintuża biex isemmi l-argument tal-kmand l-ieħor li jindika d-daqs tal-firxa għal dan l-argument.

introdudIn: Użat biex tiddetermina l-verżjoni spec li fiha ġie introdott l-argument tal-kmand. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. removedIn: Użat biex tiddetermina l-verżjoni spec li fiha tneħħa l-argument tal-kmand. Dan huwa użat mill-ġeneratur tal-kodiċi biex iżżid loġika addizzjonali. Cluster Extension tista' tiġi definita fil-konfiguratur tag. L-estensjoni tal-cluster tintuża biex testendi cluster standard b'attributi u kmandi tal-manifattura eż

19/35

XML personalizzat Tags għal 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″ fakultattiv=”veru” manufacturerCode=”0 1002″>Sample Mfg Attribut Speċifiku: 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 Attribut Speċifiku: 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 Attribut Speċifiku: 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 Attribut Speċifiku: 0 0001 0 1040ampleMfgSpecificOffWithTransition” optional="true" manufacturerCode="0 1002″> Kmand tal-klijent li jitfi l-apparat bi transizzjoni mogħtija
mill-ħin tat-tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificOnWithTransition” optional="true" manufacturerCode="0 1002″> Kmand tal-klijent li jixgħel l-apparat b'transizzjoni mogħtija
mill-ħin tat-tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificToggleWithTransition” optional="true" manufacturerCode="0 1002″> Klijent kmand li toggles l-apparat ma 'transizzjoni mogħtija
mill-ħin tat-tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificOnWithTransition2″ optional=”true” manufacturerCode=”0 1049″> Kmand tal-klijent li jixgħel l-apparat b'transizzjoni mogħtija
mill-ħin tat-tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.ampleMfgSpecificToggleWithTransition2″ optional=”true” manufacturerCode=”0 1049″> Klijent kmand li toggles l-apparat ma 'transizzjoni mogħtija
mill-ħin tat-tranżizzjoni fl-Ember Sampl-attribut tal-ħin tat-tranżizzjoni.

20/35

Tipi ta' Apparat Multipli għal kull Endpoint

Din hija karatteristika ta' Materja biss fejn utent jista' jagħżel aktar minn tip ta' apparat wieħed għal kull endpoint. Iż-żieda ta' diversi tipi ta' apparat aaa se jdaħħal il-konfigurazzjonijiet tal-cluster fi ħdan it-tipi ta' apparat għall-konfigurazzjoni tal-endpoint.

21/35

Tipi ta' Apparat Multipli għal kull Endpoint

L-immaġni ta 'hawn fuq turi li l-endpoint 1 għandu aktar minn tip wieħed ta' apparat magħżul. Il-"Apparat Primarju" jindika tip ta' apparat primarju li l-endpoint se jkun assoċjat miegħu. It-tip ta 'apparat primarju huwa dejjem preżenti fl-indiċi 0 tal-lista ta' tipi ta 'apparat magħżula għalhekk l-għażla ta' tip ta 'apparat primarju differenti se tbiddel l-ordni tat-tipi ta' apparat magħżula. L-għażliet tat-tip ta 'apparat għandhom ukoll restrizzjonijiet ibbażati fuq l-Ispeċifikazzjoni tal-Mudell tad-Dejta. ZAP jipproteġi lill-utenti milli jagħżlu kombinazzjonijiet invalidi ta 'tipi ta' apparat fuq endpoint billi juża dawn ir-restrizzjonijiet.

22/35

Materja Tip ta' Apparat Feature Page
Materja Tip ta' Apparat Feature Page
Materja Tip ta' Apparat Feature Page
ZAP jappoġġja l-viżwalizzazzjoni u t-toggling tal-karatteristiċi tal-Matter fil-paġna tal-karatteristika tat-tip ta 'apparat. Se jintwerew biss karatteristiċi tat-tip ta' apparat speċifikati f'mater-devices.xml fir-repożitorju CHIP.

Navigazzjoni lejn il-Paġna tal-Karatteristiċi
ò Tnedija ZAP in Matter b'Matter SDK aġġornat. ó Oħloq endpoint b'tip ta' apparat Matter. ô Ikklikkja l-buttuna Karatteristiċi tat-Tip ta' Apparat fin-nofs ta' fuq tal-cluster view. Innota li din il-buttuna hija disponibbli biss f'ZAP
konfigurazzjonijiet għal Matter u meta teżisti data ta' konformità fl-SDK Matter. Meta tikklikkja din il-buttuna tiftaħ l-immaġni ta 'hawn fuq.
Konformità
Il-konformità tiddefinixxi l-għażla u d-dipendenza għal attributi, kmandi, avvenimenti u tipi ta' dejta. Jiddetermina jekk element huwiex obbligatorju, fakultattiv, jew mhux appoġġjat taħt ċerti konfigurazzjonijiet ZAP.
Il-konformità tal-karatteristika tat-tip ta' apparat tieħu preċedenza fuq il-konformità tal-karatteristika tal-cluster. Per example, il-karatteristika tad-Dawl għandha konformità mhux obbligatorja fil-grupp Mixgħul/Mitfi iżda hija ddikjarata bħala obbligatorja fit-tip ta 'apparat tad-Dawl Mixgħul/Mifi li jinkludi l-grupp Mixgħul/Mifi. Il-ħolqien ta 'endpoint bit-tip ta' apparat tad-Dawl Mixgħul/Mitfi se juri l-karatteristika tad-Dawl bħala obbligatorja fuq il-paġna tal-karatteristika.
Karatteristika Toggling
Fuq il-paġna tal-karatteristika, wara li tikklikkja l-buttuna ta' toggle biex tattiva jew tiddiżattiva karatteristika, ZAP se:
Aġġorna l-elementi assoċjati (attributi, kmandi, avvenimenti) biex tikkoreġi l-konformità, u turi djalogu li juri l-bidliet.

23/35

Matter Device Type Feature Page Aġġorna l-bit tal-karatteristika fl-attribut featureMap tar-raggruppament assoċjat

Ippermetti d-Djalogu tal-Karatteristiċi

Iddiżattiva d-Djalogu tal-Karatteristiċi

It-toggling huwa diżattivat għal xi karatteristiċi meta l-konformità tagħhom għandha valur mhux magħruf jew formola t bħalissa mhux appoġġjata. F'dan l-ac se, ZAP se juri twissijiet fin-notifika ap ne.
a Wa Element Konformità rnings

Meta taqleb element, ZAP jista' juri kemm twissijiet ta' konformità tal-apparat kif ukoll twissijiet ta' konformità. Jekk l-istat tal-element ma jaqbilx mal-konformità mistennija, ZAP se juri ikona ta' twissija u jirreġistra t-twissija fin-notifikazzjoni apne. EżampIt-twissijiet kemm ta' konformità kif ukoll ta' konformità murija għal element:

24/35

Notifiki
Notifiki
Notifiki
It-taqsima li ġejja tiddefinixxi kif in-notifiki jingħataw lill-utenti ZAP fl-UI.
Notifiki tal-Pakkett
Notifiki tal-pakketti huma t-twissijiet jew messaġġi ta' żball assoċjati għal kwalunkwe pakkett speċifiku mgħobbi f'ZAP. Per example, fl-immaġini hawn taħt, li tikklikkja l-ikona ta 'twissija taħt il-kolonna tal-istatus iwassalk għal djalogu li juri n-notifiki kollha għal dak il-pakkett.

25/35

Notifiki
Notifiki ta' Sessjoni
Notifiki ta' sessjoni huma t-twissijiet jew messaġġi ta' żball li huma assoċjati ma' sessjoni ta' utent. Dawn it-twissijiet/iżbalji jistgħu jidhru billi tikklikkja fuq il-buttuna Notifiki fil-bar tal-għodda fuq l-UI ZAP. Per example, l-immaġni hawn taħt turi l-paġna tan-notifiki tas-sessjoni wara isc file kien mgħobbi f'ZAP.

26/35

Konformità tal-Ispeċifikazzjoni tad-Data-Mudell/ZCL
Konformità tal-Ispeċifikazzjoni tad-Data-Mudell/ZCL
Mudell tad-Data u Konformità tal-Ispeċifikazzjoni ZCL
Din il-karatteristika f'ZAP tgħin lill-utenti jaraw fallimenti ta 'konformità għall-Mudell tad-Data jew ZCL bil-konfigurazzjonijiet ZAP eżistenti tagħhom. Il-messaġġi ta' twissija għal fallimenti ta' konformità se jidhru fuq il-panew tan-Notifiki fl-UI ZAP u se jiġu illoggjati wkoll fuq il-console meta jħaddmu ZAP permezz tas-CLI. Il-karatteristika ta' konformità bħalissa tipprovdi twissijiet għal konformità tat-tip ta' apparat u konformità ta' cluster fuq endpoint.
Twissijiet ta' Konformità fl-UI ZAP
Meta utent jiftaħ .zap file bl-użu taż-ZAP UI huma se jaraw twissijiet fil-panew tan-notifiki taż-ZAP UI għall-fallimenti kollha ta 'konformità. Per example, l-immaġni hawn taħt turi l-paġna tan-notifiki tas-sessjoni wara .zap file infetaħ bi kwistjonijiet ta’ konformità.

Il-messaġġi ta' konformità se jmorru ladarba l-kwistjonijiet jiġu solvuti bl-użu taż-ZAP UI b'tali mod li tkun tista' żżomm kont tal-kwistjonijiet ta' konformità li fadal biss. Twissijiet ġodda se jidhru wkoll għall-konformità jekk l-utent jiddiżattiva elementi obbligatorji (cluster/kmandi/attributi) tal-konfigurazzjoni. Notifiki ta' konformità tal-ispeċifikazzjoni dejjem se jżommu rekord ta' kwalunkwe fallimenti li jiġu introdotti fil-konfigurazzjoni ZAP iżda innota li t-twissijiet li jidhru waqt il-ftuħ ta' .zap file huma aktar elaborati dwar għaliex naqset mill-konformità meta mqabbla mat-twissijiet li jidhru waqt li jinteraġixxu mal-UI. Dan huwa mid-disinn u verifika sħiħa ta 'konformità hija mwettqa waqt il-ftuħ ta' .zap file.
Twissijiet ta' Konformità fuq il-Console

27/35

Konformità tal-Ispeċifikazzjoni tad-Data-Mudell/ZCL
Meta utent jiftaħ .zap file billi tuża l-UI standalone ZAP jew iż-ZAP CLI se jaraw twissijiet illoggjati fil-console/terminal għall-fallimenti kollha ta 'konformità. Per example, l-immaġni hawn taħt turi t-twissijiet tan-notifika tas-sessjoni fuq il-console/terminal wara .zap file infetaħ bi kwistjonijiet ta’ konformità.

28/35

Kontroll ta' Aċċess

Karatteristiċi tal-Kontroll tal-Aċċess
ZAP jappoġġja l-kontroll tal-aċċess fuq l-entitajiet ZCL kollha. Jiddependi mill-implimentazzjoni tal-SDK biex jiġu mmappjati dawn il-karatteristiċi mal-karatteristiċi tal-SDK tal-kontroll tal-aċċess meħtieġa u appoġġjati. ZAP ġeneralment jipprovdi mudell tad-dejta u mekkaniżmu biex jikkodifikah fil-meta-info files u propagate dik id-data għall-mudelli tal-ġenerazzjoni, mingħajr ma tassenja tifsiriet speċifiċi għall-punti tad-data.
Termini Bażi
Il-kontroll tal-aċċess ZAP jiddefinixxi tliet termini bażi, kif ġej: ò operazzjoni : definit bħala xi ħaġa li tista' ssir. Eżample: aqra, tikteb, invoka. — rwol: definit bħala privileġġ ta' attur. Bħal “View privileġġ”, “Rwol amministrattiv”, u iben fuq. ô modifikaturi: definiti bħala kundizzjonijiet speċjali ta' kontroll ta' aċċess, bħal data sensittiva tad-drapp jew data b'ambitu tad-drapp. It-termini bażi huma definiti fil-metadata XML taħt top tag . Dan li ġej huwa exampdefinizzjonijiet tat-terminu bażi tal-kontroll tal-aċċess:
<role type=”view” deskrizzjoni ="View privileġġ”/>
Dan example jiddefinixxi tliet operazzjonijiet, aqra, tikteb u tinvoka, żewġ modifikaturi u erba' rwoli.
Aċċess Triplets
Kull kundizzjoni ta' aċċess individwali tista' tiġi definita bi triplet ta' aċċess fl-XML. Aċċess triplet hija taħlita ta 'operazzjoni, rwol u modifikatur. Huma fakultattivi, għalhekk jista' jkollok wieħed minn dawn biss. Parti nieqsa minn triplet ġeneralment tfisser permissivenes, li hija speċifika għall-implimentazzjoni għall-SDK partikolari. Entità li tiddefinixxi l-aċċess tagħha jista' jkollha triplet ta' aċċess wieħed jew aktar. Dan li ġej huwa example:
at0
Din hija definizzjoni ta' attribut li għandu triplet ta' aċċess, li tiddikjara li tippermetti operazzjoni ta' kitba minn rwol ta' ġestjoni, b'modifikatur b'ambitu tad-drapp applikat.
Permessi Default

29/35

Kontroll ta' Aċċess
L-entitajiet ZCL jistgħu jiddefinixxu l-permessi individwali tagħhom stess. Madankollu, hemm ukoll definizzjoni globali ta 'permessi default għal
tipi mogħtija. Dawn huma preżunti għall-entità partikolari, sakemm ma tipprovdix xi permessi speċifiċi tagħha stess.
Il-permessi default huma ddikjarati permezz ta' a tag fl-ogħla livell tal-XML file. Eżample:
aa a< ccess op="invoke"/> a a aa < ccess op=”re d”/> a< ccess op=”write”/> a aa aa < ccess op="re d" rwol="view”/> aa < ccess op=”write” role=”oper te”/> a
Template Helpers
L-helper tal-mudell bażiku li għandek tuża huwa l-iteratur {{#access}} … {{/access}}. Dan l-iteratur itenni fuq it-tripletti kollha tal-aċċess mogħtija.
Jappoġġja ż-żewġ għażliet li ġejjin:
entità=”attribut/kmand/avveniment” – jekk l-entità ma tistax tiġi determinata mill-kuntest, dan jistabbilixxi t-tip ta’ entità. includeDefault="true/false" – jiddetermina jekk il-valuri default humiex inklużi jew le. Dan li ġej huwa example:
{{#zcl_clusters}}
a Cluster: {{n me}} [{{code}}] a {{#zcl_ ttributes}} aa – ttribute: {{n me}} [{{code}}] aa {{# ness entity=" ttribute"}}
O a RM a M * p: {{operazz joni}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – kum nd: {{n me}}] [{a s-{a] kodjenza }} ] nd”}} O a RM a M * p: {{operat}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – avveniment: {{n me}} [{{code}}] a {{# ness entity=”event”}} O a RM a M * p: {{operat}} / ole: {{role}} / odifier: {{ access odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Tnedija ta' ZAP għal applikazzjonijiet Matter jew Zigbee
Tnedija ta' ZAP għal applikazzjonijiet Matter jew Zigbee
Tnedija ta' ZAP għal Applikazzjonijiet ta' Matter jew Zigbee
Is-sezzjonijiet li ġejjin jiddeskrivu t-tnedija ta' ZAP f'modalità waħedha bil-metadejta Matter jew Zigbee speċifika. L-idea hija li tniedi ZAP bl-argumenti korretti relatati mal-metadata XML (ir-raggruppamenti u d-definizzjonijiet tat-tipi ta 'apparat skont l-ispeċifikazzjonijiet CSA) u l-mudelli tal-ġenerazzjoni, li jintużaw biex jiġġeneraw il-kodiċi xieraq.
Tnedija ta' ZAP mal-Matter
L-iskrittura li ġejja tiġbor il-metadejta korretta mill-Matter SDK meta tniedi ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Nota: Tista 'wkoll tieħu l-approċċ Zigbee li ġej biex tniedi ZAP in Matter.
Tnedija ta' ZAP ma' Zigbee
Il-kmand li ġej iniedi ZAP bl-ispeċifikazzjonijiet ZCL u mudelli ta 'ġenerazzjoni mill-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: Din hija t-triq għas-sors ZAP jew sdk-path eżekutibbli: Din hija t-triq għall-SDK
Tnedija ta' ZAP mingħajr Metadata
Ftakar li meta tniedi ZAP direttament permezz ta 'eżekutibbli jew mis-sors billi tuża npm run zap tkun qed tniedi ZAP b'metadejta tat-test għal Matter/Zigbee mibnija fi ħdan ZAP u mhux il-metadejta attwali li ġejja mill-Matter u Zigbee SDKs imsemmija hawn fuq. Għalhekk, ftakar li toħloq il-konfigurazzjonijiet ZAP tiegħek billi tuża l-metadejta tal-SDK u mhux billi tiftaħ ZAP direttament bil-metadejta tat-test mibnija.

31/35

Tiġġenera kodiċi għal Matter jew Zigbee

Tiġġenera Kodiċi għal Materja, Zigbee jew SDK Custom
It-taqsimiet li ġejjin jiddeskrivu kif tiġġenera kodiċi bl-użu ta' ZAP.
Iġġenera Kodiċi billi tuża ZAP UI
Niedi l-UI ZAP skont l-istruzzjonijiet f'Tnedija ta' ZAP għal Materja jew Zigbee u kklikkja fuq il-buttuna Iġġenera fil-bar tal-menu ta' fuq.
Iġġenera Kodiċi mingħajr l-UI
L-istruzzjonijiet li ġejjin jipprovdu modi differenti ta 'ġenerazzjoni ta' kodiċi permezz ta 'CLI mingħajr ma titnieda l-UI ZAP.
Tiġġenera Kodiċi minn Sors ZAP
Mexxi l-kmand li ġej biex tiġġenera kodiċi billi tuża ZAP mis-sors: 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
Tiġġenera Kodiċi minn ZAP Executable
Mexxi l-kmand li ġej biex tiġġenera kodiċi billi tuża l-eżekutibbli ZAP: [zap-path] genera –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
Tiġġenera Kodiċi minn ZAP CLI Eżegwibbli
Mexxi l-kmand li ġej biex tiġġenera kodiċi billi tuża ZAP CLI Executable: [zap-cli-path] generate –genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp

32/35

Aġġorna ZAP fi Studio

Aġġorna ZAP
Aġġorna ZAP fi Simplicity Studio
Dan il-mekkaniżmu jista 'jintuża meta taħdem bl-estensjoni tal-Matter jew Zigbee mir-rilaxxi tal-SDK ta' Silicon Labs. ZAP jista' jiġi aġġornat fi ħdan Simplicity Studio mingħajr rilaxx ta' Simplicity Studio billi tniżżel l-aħħar eżekutibbli ZAP (rakkomandat) jew tiġbed l-aħħar mis-sors ZAP kif muri fil-Gwida ta' Installazzjoni ZAP. Wara li jkollok l-aħħar ZAP ibbażat fuq l-OS użat bħalissa tiegħek, tista' taġġorna ZAP fi Studio bħala pakkett ta' adapter. Segwi l-istruzzjonijiet hawn taħt wara li tniżżel l-aħħar ZAP:
Mur Simplicity Studio u agħżel Preferenzi > Simplicity Studio > Pakketti tal-Adapter. Ikklikkja Żid... u bbrawżja għall-folder ZAP estiż li niżżilt u kklikkja Agħżel Folder . Ikklikkja Applika u Agħlaq u mbagħad iż-ZAP li għadu kif ġie miżjud se jintuża kull meta .zap file jinfetaħ.
Nota: Xi drabi jista 'jkun hemm każijiet anzjani ta' ZAP diġà qed jaħdmu anke wara aġġornament għall-aħħar ZAP. Kun żgur li ttemm l-istanzi kollha taż-ZAP eżistenti b'tali mod li l-ZAP li għadu kif inġibed jintuża minflok istanza qadima, li għadha taħdem fl-isfond.
Aġġorna ZAP għall-Iżvilupp tal-Materja f'Github
Meta taħdem mal-Mater jew Matter-Silicon Labs repos fuq Github, issettja l-varjabbli tal-ambjent fir-rigward taż-ZAP biex toħloq/tiġġenera konfigurazzjonijiet ZAP ġodda jew tiġġenera mill-ġdid s eżistentiample ZAP konfigurazzjonijiet wara li tapplika bidliet għalihom. Issettja ZAP_DEVELOPMENT_PATH għal ZAP mis-sors billi tiġbed l-aħħar jew issettja ZAP_INSTALLATION_PATH għal ZAP eżekutibbli li niżżilt l-aħħar fid-direttorju lokali tiegħek. Innota li meta jiġu stabbiliti kemm ZAP_DEVELOPMENT_PATH kif ukoll ZAP_INSTALLATION_PATH, jintuża ZAP_DEVELOPMENT_PATH.
Dawn li ġejjin huma examples li juru l-varjabbli ambjentali ta' hawn fuq fl-użu:
Tnedija ta' ZAP bl-użu tal-ispeċifikazzjoni tal-Materja Riġenerazzjoni tal-sample ZAP konfigurazzjonijiet għall-applikazzjonijiet Matter
Nota: Meta tuża l-eżekutibbli ZAP, kun żgur li qed tuża rilaxx uffiċjali fuq rilaxx ta 'filgħaxija għal aktar stabbiltà. Ara
Tniżżil ta' ZAP Executable fil-Gwida ta' Installazzjoni ZAP

33/35

Multi-protokoll konkorrenti bejn Zigbee u Matter
Multi-protokoll konkorrenti bejn Zigbee u Matter
MCoanttceurrrent Multi-protokoll bejn Zigbee u
ZAP jista 'jintuża biex jiġi kkonfigurat konfigurazzjonijiet ZCL (Zigbee) u Data-Mudell (Matterja) f'applikazzjoni multi-protokoll għal Zigbee u Matter. ZAP jippermettilek li toħloq endpoints għal Zigbee u Matter b'mod espliċitu fl-istess konfigurazzjoni file. Jekk l-endpoints Zigbee u Matter huma fuq l-istess Identifikatur tal-endpoint (eżample, LO Dimmable Light fuq endpoint Id 1 u Matter Dimmable Light fuq każ ieħor ta 'endpoint 1), ZAP jieħu ħsieb li jissinkronizza l-attributi komuni madwar l-attributi Matter u Zigbee. Kun żgur li l-attributi li qed jiġu sinkronizzati għandhom l-istess tip ta' dejta. L-attributi komuni bejn Zigbee u Matter huma stabbiliti permezz ta 'a file imsejħa multi-protocol.json . L-utent jista 'jgħaqqad kwalunkwe żewġ clusters madwar Zigbee u Matter flimkien mal-attributi korrispondenti tagħhom billi juża l-cluster u l-kodiċi tal-attribut rispettivament. Dan file tista 'tinstab f'[SDKPath]/app/zcl/multi-protocol.json . Dan file ġie aġġornat b'ċertu sett ta 'clusters u attributi biex tibda, iżda l-utent jista' jaġġorna dan file kif meħtieġ u ZAP se jieħu ħsieb is-sinkronizzazzjoni tal-konfigurazzjoni tal-attribut madwar Zigbee u Matter għal identifikaturi tal-endpoint komuni.
Tista 'ssib ukoll tutorja ZAP fi kwalunkwe applikazzjoni multi-protokoll ta' Zigbee and Matter taħt il-paġna tat-tutorials. Dan it-tutorja jiggwidak permezz tal-proċess tal-ħolqien ta' applikazzjoni b'ħafna Protokolli. Dan it-tutorja huwa disponibbli biss meta tiftaħ applikazzjoni multi-protokoll eżistenti u tista' tinstab kif muri fl-immaġni hawn taħt:

34/35

Integra SLC CLI ma ZAP
Integra SLC CLI ma ZAP
Integra SLC CLI ma ZAP
Segwi dawn il-passi biex tintegra l-SLC CLI maż-ZAP: ò Installa SLC CLI billi ssegwi l-istruzzjonijiet ta' installazzjoni fil-Gwida għall-Utent ta' Simplicity Studio 5. ó Installa ZAP billi ssegwi l-istruzzjonijiet fil-Gwida ta' Installazzjoni ZAP. ô Biex tintegra SLC CLI ma ZAP, żid varjabbli ambjentali STUDIO_ADAPTER_PACK_PATH li tindika l-applikazzjoni ZAP
direttorju. õ Ftakar li terġa' tibda SLC CLI Daemon wara l-pass 3. ö Kwalunkwe proġett li juża ZAP issa se juża t-triq definita fil-pass 3 meta jiġi ġġenerat minn SLC CLI. Jekk jogħġbok irreferi għal SLC CLI
Użu għall-istruzzjonijiet dwar l-użu tal-SLC CLI għall-proġetti tiegħek.

35/35

Dokumenti / Riżorsi

SILICON LABS ZAP Jiżviluppaw Bil-Laboratorji tas-Silikon [pdfManwal tas-Sid
ZAP Jiżviluppa Mal-Laboratorji tas-Silikon, ZAP, Jiżviluppa Mal-Laboratorji tas-Silikon, Il-Laboratorji tas-Silikon, Il-Laboratorji

Referenzi

Manwal għall-Utent

ZAP Jiżviluppa Bil-Labs tas-Silikon

Speċifikazzjonijiet

Istruzzjonijiet għall-Użu tal-Prodott

FAQs

Żvilupp ma' Silicon Labs ZAP

ZAP Nibdew

Installazzjoni ZAP

Fundamenti ZAP

XML personalizzat

XML personalizzat Tags għal Zigbee

Tipi ta' Apparat Multipli għal kull Endpoint

Kontroll ta' Aċċess

Tiġġenera kodiċi għal Matter jew Zigbee

Aġġorna ZAP fi Studio

Dokumenti / Riżorsi

Referenzi

Ħalli kumment

Ikkanċella tweġiba