ZAP þróun með Silicon Labs eigandahandbók

ZAP Að hefjast handa
- Til að byrja með ZAP skaltu fylgja þessum skrefum:
  - Sæktu ZAP Executable úr opinberu geymslunni.
  - Settu upp ósjálfstæðin með því að nota npm install skipunina.
  - Fyrir Windows-sértæka uppsetningu, skoðaðu ZAP Installation for Windows OS handbókina.
Zigbee þróun
- Ef þú ert að þróa Zigbee forrit:
  - Notaðu Simplicity Studio sem inniheldur ZAP og önnur nauðsynleg verkfæri.

Málsþróun
- Ef þú ert að þróa Matter forrit:
  - Valkostir fela í sér að nota Simplicity Studio eða fá aðgang að Silicon Labs eða CSA Github geymslunum.
  - Sjá uppfærsluleiðbeiningar fyrir ZAP utan Simplicity Studio útgáfuferlisins ef þörf krefur.

Algengar spurningar

Sp.: Hverjar eru mismunandi útgáfur af ZAP tvöfaldur í boði?
- A: Það eru tvær útgáfur í boði - Opinber útgáfa með staðfestum byggingum og forútgáfu með nýjustu eiginleikum.

Sp.: Hvað ætti ég að gera ef ég lendi í vandræðum með söfnun innfæddra bókasafna við uppsetningu?
- A: Skoðaðu FAQ upplýsingar um vettvangssértæk forskrift til að leysa slík vandamál.

“`

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Þróun með Silicon Labs ZAP

Að byrja
ZAP Að byrja afturview ZAP uppsetning ZAP uppsetning Windows Algengar spurningar
Undirstöðuatriði ZAP Grundvallaratriði
Notendahandbók ZAP Notendahandbók lokiðview Sérsniðið XML Sérsniðið XML Tags fyrir Zigbee Margar tækjagerðir á endapunkti Mál Gerð tækis Eiginleikasíðu Tilkynningar Gagnagerð/ZCL forskrift Samræmi aðgangsstýring Ræsir ZAP for Matter eða Zigbee forrit Búa til kóða fyrir Matter eða Zigbee Uppfæra ZAP í Studio Samhliða fjölsamskiptareglur milli Zigbee og Matter Samþætta SLC CLI með ZAP

1/35

Þróun með Silicon Labs ZAP
Þróun með Silicon Labs ZAP
ZAP
ZAP er almenn kóða kynslóðarvél og notendaviðmót fyrir forrit og bókasöfn byggt á Zigbee Cluster Library frá Zigbee eða Data Model from Matter. Forskriftin er þróuð af Connectivity Standards Alliance. ZAP gerir þér kleift að framkvæma eftirfarandi aðgerðir:
Framkvæmdu SDK-sérstaka sérsniðna kynslóð af öllum alþjóðlegum gripum (fastur, gerðir, auðkenni og svo framvegis) byggt á ZCL/Data-Model forskriftinni. Framkvæmdu SDK-sérstaka sérsniðna kynslóð af öllum notendavöldum stillingargripum (forritsstillingar, endapunktastillingar, og svo framvegis) byggt á ZCL/Data-Model forskrift og uppsetningu forrita frá viðskiptavinum. Gefðu notandanum notendaviðmót til að velja tiltekna forritastillingu (endapunkta, klasa, eiginleika, skipanir og svo framvegis).

Innihaldið í þessum köflum lýsir því hvernig á að þróa Zigbee og Matter forrit með því að stilla ZCL (Zigbee) eða Data Model (Matter) lögin með því að nota ZAP.

2/35

ZAP Að hefjast handa

ZAP Að hefjast handa
Að byrja með ZAP
Þessir hlutar lýsa mismunandi aðferðum til að búa til Zigbee og Matter forrit. Athugaðu að Simplicity Studio býður upp á leið til að búa til Zigbee og Matter forritin þín frá enda til enda þar sem öll verkfæri eru foruppsett ásamt Simplicity Studio (þar á meðal ZAP). Þú gætir líka ákveðið að kanna aðrar leiðir til að búa til forritin þín, eins og lýst er hér.
Zigbee þróun
Zigbee forritarar geta smíðað forrit sín með Simplicity Studio, sem inniheldur nú þegar ZAP og önnur verkfæri sem hjálpa þér að byggja upp forritið þitt frá enda til enda.
Málsþróun
Matter Forritaframleiðendur geta smíðað forrit sín með því að nota eftirfarandi aðferðir: Simplicity Studio: Þetta felur í sér ZAP og önnur verkfæri sem þarf til að byggja upp Matter forritið enda til enda. Github (Silicon Labs) Github (CSA)
Athugið: Til að uppfæra ZAP utan Simplicity Studio útgáfuferilsins, sjá uppfærslu ZAP í Simplicity Studio og ZAP Uppsetningarhandbók

3/35

ZAP uppsetning

Eftirfarandi hlutar lýsa ZAP uppsetningu og hvernig á að uppfæra ZAP í Simplicity Studio IDE.
Að hlaða niður ZAP keyrslu sem mælt er með)
Þetta er ráðlögð leið til að byrja með ZAP. Þú getur fengið nýjustu ZAP tvöfaldana frá aa https://github.com/project-chip/zp/releses. Forsmíðaðir tvíþættir koma í tveimur mismunandi útgáfum.
Opinber útgáfa: Staðfestar smíðir með sérstökum Matter og Zigbee prófunarsvítum. Snið útgáfuheitisins er vYYYY.DD.MM. Forútgáfa: Byggir með nýjustu eiginleikum og villuleiðréttingum en þessar smíðir eru EKKI staðfestar með sérstökum Matter og Zigbee prófunarsvítum. Snið útgáfuheitisins er vYYYY.DD.MM-kvöldlega.
Að setja upp ZAP frá Source
Grunnleiðbeiningar til að setja upp ZAP
Þar sem þetta er node.js forrit þarftu að setja upp hnútaumhverfið. Besta leiðin til að gera þetta er að hlaða niður nýjustu uppsetningu hnútsins, sem inniheldur hnút og npm. Ef þú ert með eldri útgáfu af hnút uppsett á vinnustöðinni þinni getur það valdið vandræðum, sérstaklega ef það er mjög gamalt. Gakktu úr skugga um að þú sért með nýjustu hnút v16.x útgáfuna með npm sem fylgir. Keyrðu hnút –útgáfu til að athuga hvaða útgáfa er tekin upp. Mælt er með v18.x. Eftir að þú hefur fengið viðkomandi útgáfu af hnút geturðu keyrt eftirfarandi:
Settu upp Dependencies
Notaðu eftirfarandi skipanir til að setja upp ósjálfstæði:

npm setja upp
Athugið: Fyrir Windows-sértæka ZAP uppsetningu, sjá ZAP uppsetning fyrir Windows OS. Það er ekki óalgengt að lenda í vandamálum við söfnun innfæddra bókasafna á þessum tímapunkti. Það eru til ýmis src-script/install-* forskriftir fyrir mismunandi vettvang. Sjá algengar upplýsingar um hvaða forskrift á að keyra á mismunandi kerfum og endurræstu síðan npm install.
Ræstu forritið
Notaðu eftirfarandi skipanir til að ræsa forritið:

npm keyra zap
Ræstu framhliðina í þróunarham
Styður endurhleðslu með heitum kóða, villutilkynningar og svo framvegis. Notaðu eftirfarandi skipanir til að hefja framenda í þróun
háttur:
Quasar dev -m rafeind
or

4/35

ZAP Insta kl
npm keyra rafeinda-dev

5/35

ZAP uppsetning Windows
ZAP uppsetning Windows
ZAP uppsetning fyrir Windows OS
1. Windows Powershell
Í skjáborðsleitarstikunni skaltu slá inn Windows Powershell og keyra sem stjórnandi. Keyrðu allar eftirfarandi skipanir inni í Powershell.
2. Súkkulaði
Settu upp frá https://chocolatey.org/install. Athugaðu hvort það sé rétt uppsett með eftirfarandi skipunum:
choco -v
Settu upp pkgconfiglite pakka með eftirfarandi skipunum:
choco setja upp pkgconfiglite
3. Settu upp Node
Keyrðu eftirfarandi skipanir til að setja upp:
choco setja upp nodejs-lts
*Útgáfan þarf að vera 18 til að standast útgáfupróf, eftir uppsetningu, athugaðu með node -v *Ef þú hefur þegar sett upp Node og mistókst sum próf sem líkjast getur ekki fundið Node , settu aftur upp Node með chocolatey aftur.
4. Fylgdu grunnleiðbeiningunum til að setja upp ZAP
Fylgdu ZAP uppsetningarleiðbeiningunum frá uppruna í ZAP uppsetningu. Meðan þú fylgir grunnleiðbeiningunum til að setja upp ZAP skaltu passa þig á eftirfarandi villum og hvernig á að leysa þær:
sqlite3
Þegar þú keyrir ZAP (td npm run zap ), ef þú sérð villu um sqlite3.node í sprettiglugga skaltu keyra:
npm endurbyggja sqlite3
rafeindabyggjandi
Þegar þú gerir npm uppsetningu, eftir uppsetningu, ef villa kemur upp í eftirfarandi skipun sem tengist rafeindabyggir install-appdeps, npx rafeindauppbyggingu striga mistókst eða hnútur fyrir gyp, núverandi strigaútgáfa er ekki samhæf við Windows og uppsetningarvillan mun ekki valda bilun í keyrslu ZAP. node-canvas er að vinna að lausninni núna og málið verður leyst á næstunni.
“postinstall”: “electron-builder install-app-deps && husky install && npm endurbyggja striga –update-binary && npm run version-stamp”

6/35

ZAP uppsetning Windows
Striga
Ef npm keyrslupróf mistekst vegna villunnar Test suite mistókst að keyra. Get ekki fundið einingu '../build/Release/canvas.node' eða
zapnode_modulescanvasbuildReleasecanvas.node er ekki gilt Win32 forrit. , endurbyggja striga sem hér segir:
npm endurbyggja striga –update-binary
fáðu index.html eða önnur netþjónamál
Ef npm keyrslupróf mistekst vegna villunnar fá index.html beiðni mistókst með stöðukóða 404 í einingaprófum eða með miðlara
tengingarvandamál í e2e-ci prófunum skaltu keyra eftirfarandi skipanir:
npm keyra byggja
Annað
Athugaðu hvort hnútútgáfan sé v18 og reyndu að setja hana upp með Chocolatey.

7/35

Algengar spurningar
Algengar spurningar
Algengar spurningar
Sp.: Hvernig á að ræsa notendaviðmót í þróunarham? A: Þú getur ræst notendaviðmótið í þróunarham sem mun leiða til eftirfarandi uppsetningar:
Aðskilinn quasar þróun HTTP þjónn, sem gerir lifandi endurnýjun á port 8080 ZAP bakenda keyrir á port 9070 Chrome eða öðrum vafra, keyrir sjálfstætt Til að komast í þá uppsetningu, fylgdu leiðbeiningunum hér að neðan. ò Keyrðu fyrst ZAP þróunarþjóninn, sem byrjar á höfn 9070.
npm keyra zap-devserver - Næst skaltu keyra Quasar þróunarþjóninn, sem byrjar á port 8080.
quasar dev ô Beindu vafranum þínum eða keyrðu einn á móti hinum rétta URL með restPort röksemdinni:
google-chrome http://localhost:8080/?restPort=9070

Sp.: Hvernig á að láta þetta virka á Mac/Linux OS? A:
npm uppsetning er notuð til að hlaða niður öllum nauðsynlegum ávanapakka. Ef þú sérð villur tengdar hnúta-gyp og vantar staðbundin bókasöfn, eins og pixman, og svo framvegis, vantar þig innfædda ósjálfstæði til að fullnægja til að setja saman óforsmíðaða hnúttvíundir fyrir einhverja samsetningu af kerfum og útgáfum. Npm á skýinu er stöðugt að uppfæra listann yfir útgefinn tvöfaldur, svo það er mögulegt að þú náir þeim bara vel, en ef þú gerir það ekki, þá eru þetta leiðbeiningar fyrir mismunandi vettvang:
Fedora Core með dnf:
dnf setja upp pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
eða keyra script:
src-script/install-packages-fedora
Ubuntu með apt-get:
apt-fá uppfærslu apt-fá uppsetningu – laga-vantar libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
eða keyra script:

8/35

Algengar spurningar
src-script/install-packages-ubuntu
OSX á Mac með Homebrew brugg:
brugga setja upp pkg-config cairo pango libpng jpeg giflib librsvg
eða keyra script:
src-script/install-packages-osx
Sp.: Hvernig á að láta þetta virka á Windows OS?
A: Gakktu úr skugga um að það sé alltaf uppfært og að það séu engar breytingar sem ekki hafa verið gerðar. Ábending: git pull, git status og git stash eru vinir þínir. Þú verður að nota Chocolately til að láta Zap virka á Windows OS. Gakktu úr skugga um að hlaða niður pkgconfiglite pakkanum.
choco setja upp pkgconfiglite
Ef þú átt í vandræðum með Kaíró, tdample ef þú færð villu um cairo.h': Engin slík file eða skrá, gerðu eftirfarandi: ò Athugaðu hvort tölvan þín sé 32 eða 64 bita. ó Það fer eftir því, hlaðið niður viðeigandi pakka af þessari síðu
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:
Smelltu á Advanced System Settings. Í háþróaða flipanum smelltu á Umhverfisbreytur. Í kaflanum Kerfisbreytur, finndu PATH umhverfisbreytuna og veldu hana. Smelltu á Edit og bættu C:/GTK við það. Ef PATH umhverfisbreytan er ekki til, smelltu á Nýtt. Ef jpeglib.h finnst ekki, reyndu eftirfarandi: ò Á flugstöðinni, keyrðu: choco install libjpeg-turbo ó Gakktu úr skugga um að það sé hreint með því að nota: git clean -dxff og keyrðu npm install aftur ô ef engar villur koma upp og aðeins viðvaranir birtast, reyndu að nota npm audit fix õ ef þú getur ekki keyrt ZAP, farðu í file src-script/zap-start.js ö Breyta
÷ const { spawn } = require('cross-spawn') to const { spawn } = require('child_process') ø Keyra npm og keyra zap. Heimildir:
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)
Sp.: Ég fæ villu „sqlite3_node“ fannst ekki eða álíka.

9/35

Algengar spurningar
A: Endurbyggðu innfæddu sqlite3 bindingarnar þínar. Til að laga þetta í flestum tilfellum skaltu keyra:
npm setja upp
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Ef það lagast samt ekki skaltu gera:
rm -rf node_modules og reyndu síðan ofangreindar skipanir aftur. Stundum skiptir það líka máli að uppfæra npm:
npm setja upp -g npm
Spurning: Ég fæ villu "N-API útgáfan af þessu hnúttilviki er 1. Þessi eining styður N-API útgáfu(r) 3. Þetta hnúttilvik getur ekki keyrt þessa einingu."
A: Uppfærðu hnútútgáfuna þína. Lausnin á þessu er rædd í þessum Stack Overflow þræði: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Sp.: Þróunartölvan mín virkar ekki með ZAP af hvaða ástæðu sem er. Get ég notað docker gám?
A: Já þú getur það. TBD.
Sp.: Hvernig keyri ég ZAP inni í VSCode?
A: Ef þú VSCode á slóðinni þinni sláðu inn zap repo og sláðu inn kóðann. Þetta mun opna ZAP í VSCode. Til að keyra ZAP í villuleitarham, veldu ZAP vinnusvæðið og smelltu á Run táknið á vinstri tækjastikunni. Þú munt hafa nokkra möguleika til að velja úr til að keyra ZAP, veldu Node.js Debug Terminal . Þetta mun opna flugstöðvarglugga þar sem þú getur slegið inn npm run zap , sem mun tengja kembiforritið og keyra ZAP eins og venjulega frá skipanalínunni. Til hamingju, þú ættir nú að sjá ZAP keyra í kembiforritinu. Þú getur stillt brotpunkta í VSCode eins og þú myndir gera í öðrum IDE.
Sp.: HÍ einingapróf mistekst með einhverjum villum í kringum striga sem ekki er smíðaður fyrir rétta útgáfu af hnút. Hvað á ég að gera?
A: Ef þú sérð eftirfarandi villu:
FAIL test/ui.test.js Test suite mistókst að keyra Einingin 'canvas.node' var sett saman á móti annarri Node.js útgáfu með NODE_MODULE_VERSION 80. Þessi útgáfa af Node.js krefst NODE_MODULE_VERSION 72. Vinsamlega reyndu að setja saman eða endursetja eininguna aftur (til dæmis með `npm rebuild)``.
hjá Object. (node_modules/canvas/lib/bindings.js:3 18)
keyrðu síðan: npm endurbyggja striga –update-binary

10/35

ZAP grundvallaratriði

ZCL/Data-Model ZAP Grundvallaratriði
Þessi hluti inniheldur upplýsingar fyrir nýja ZAP notendur. Smelltu á kennslutáknið efst í hægra horninu á ZAP notendaviðmótinu, sem sýnir hvernig á að búa til ZAP stillingar. Kennsluefnið mun leiða þig í gegnum eftirfarandi: Búa til endapunkt Veldu tækisgerð Stilla klasa Stilla eigind Stilla skipun Fyrir nákvæma tilvísun, sjá Zigbee Cluster Configurator Guide

11/35

ZAP notendahandbók
ZAP notendahandbók
ZAP notendahandbók
Hlutarnir undir þessari handbók veita frekari upplýsingar um mismunandi eiginleika sem ZAP býður upp á.

12/35

Sérsniðið XML

Bætir við sérsniðnum XML frá ZAP UI
Smelltu á „Viðbætur“ táknið í ZAP notendaviðmótinu. Smelltu á "+" bæta við hnappinn til að velja sérsniðið XML file Sérsniðnu klasarnir, eiginleikarnir, skipanir osfrv. ættu að birtast í ZAP notendaviðmótinu þegar sérsniðnu XML hefur verið bætt við.
Búðu til þinn eigin sérsniðna XML í Zigbee
Hlutinn sýnir hvernig á að búa til eigin sérsniðna klasa og útvíkka núverandi staðlaða klasa með sérsniðnum eiginleikum og skipunum fyrir Zigbee.
Framleiðendasértækir klasar í Zigbee
Þú getur bætt framleiðandasértækum klösum við venjulegan atvinnumannfile. Við bjóðum upp á fyrrverandiample af þessu hér að neðan. Til að gera þetta þarftu að uppfylla tvær skyldur:
Auðkenni klasa VERÐUR að vera á sértæku sviði framleiðanda, 0xfc00 – 0xffff. Klasaskilgreiningin verður að innihalda framleiðandakóða sem verður notaður á ALLA eiginleika og skipanir innan þess klasa og verður að koma fram þegar skipanir eru sendar og mótteknar og samskipti við eiginleika. Tdample:

Sample Mfg Sérstakur klasi Almennt Þessi þyrping veitir fyrrverandiampLeiðsögn um hvernig hægt er að stækka umsóknarrammann til að ná yfir framleiðandasértæka klasa.
0xFC00
glóð sample eiginleiki
glóð sampeiginleiki 2

A sample framleiðanda-sérstakur skipun innan sample framleiðanda sérstakt
þyrping.

Framleiðandasértækar skipanir í venjulegum Zigbee þyrpingum
Þú getur bætt þínum eigin skipunum við hvaða staðlaða Zigbee klasa sem er með eftirfarandi kröfum:
Framleiðandasértækar skipanir þínar geta notað hvaða skipanakenni sem er innan skipanakennisviðsins, 0x00 – 0xff. Þú verður einnig að gefa upp framleiðandakóða fyrir skipunina svo að hægt sé að greina hana frá öðrum skipunum í klasanum og meðhöndla hana á viðeigandi hátt. TdampLeið af því að stækka Kveikja/Slökkva þyrpinguna með framleiðsluskipunum:

13/35

Sérsniðið XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” valfrjálst=”true” manufacturerCode=”0 1002″> Viðskiptavinaskipun sem slekkur á tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.ampleMfgSpecificOnWithTransition” valfrjálst=”true” framleiðandiCode=”0 1002″> Viðskiptavinaskipun sem kveikir á tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.ampleMfgSpecificToggleWithTransition” valfrjálst=”true” framleiðandiCode=”0 1002″> Viðskiptavinaskipun sem breytir tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.ampleMfgSpecificOnWithTransition2″ valfrjálst=”true” framleiðandakóði=”0 1049″> Viðskiptavinaskipun sem kveikir á tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.ampleMfgSpecificToggleWithTransition2″ valfrjálst=“true”
framleiðandakóði="0 1049″> Viðskiptavinaskipun sem breytir tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.

Framleiðandasértækir eiginleikar í venjulegum Zigbee þyrpingum
Þú getur bætt eigin eiginleikum þínum við hvaða staðlaða Zigbee klasa sem er með eftirfarandi kröfum:
Framleiðandasértækar eigindir þínar kunna að nota hvaða eigindarauðkenni sem er innan eigindarauðkennissviðsins, 0x0000 – 0xffff. Þú verður einnig að gefa upp framleiðandakóða fyrir eigindina svo að hægt sé að greina hana frá öðrum eiginleikum í klasanum og meðhöndla hana á viðeigandi hátt. TdampLeið af því að stækka Kveikja/Slökkva þyrpinguna með framleiðslueiginleikum:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” mín=”0 0000″
max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandaCode=”0 1002″>Sample Mfg Sérstakur eiginleiki: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandaCode=”0 1049″>Sample Mfg Sérstakur eiginleiki: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 00″ valfrjálst=”true” framleiðandaCode=”0 1002″>Sample Mfg Sérstakur eiginleiki: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandaCode=”0 1049″>Sample Mfg Sérstakur eiginleiki: 0 0001 0 1040
Búðu til þinn eigin sérsniðna XML í Matter
Hlutinn sýnir hvernig á að búa til þína eigin sérsniðnu klasa og útvíkka núverandi staðlaða klasa með sérsniðnum eiginleikum og skipunum fyrir Matter.
Framleiðendasértækir klasar í efni
Þú getur bætt framleiðandasértækum klösum við í Matter. Við útvegum fyrrverandiample af þessu hér að neðan.
Þetta 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

Sérsniðið XML
Í eftirfarandi frvample, samsetning auðkennis seljanda (auðkenni prófunarframleiðanda) 0xFFF1 og klasaauðkennis 0xFC20 leiðir til value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Almennt Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER The Sample MEI þyrping sýnir þyrpingarframleiðendur viðbætur FlipFlop
Svar fyrir AddArguments sem skilar summu. Skipun sem tekur tvö uint8 rök og skilar summu þeirra. Einföld skipun án breytu og án svars.
Framleiðandasértækir eiginleikar í stöðluðum efnisþyrpingum
Þú getur bætt framleiðanda sérstökum eiginleikum við hvaða staðlaða efnisklasa með eftirfarandi kröfum:
T aaaa þyrpingin sem eiginleikarnir sem verið er að gera við verður að tilgreina –
næsta útg. > >>
Kóði eigindarinnar er 32 bita samsetning af kóða framleiðanda og auðkenni eigindarinnar. Mikilvægustu 16 bitarnir eru framleiðandakóði. Sviðið fyrir kóða framleiðanda prófunar er 0xFFF1 – 0xFFF4. Minnstu 16 bitarnir eru auðkenni eiginda. Sviðið fyrir ekki alþjóðlega eiginleika er 0x0000 – 0x4FFF.
ExampLeið af útvíkkun On/Off Matter klasa með framleiðslusértækum eiginleikum:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” mín=”0 0000″
max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true”>Sample Mfg Sérstakur eiginleiki 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” mín=”0 0000″
max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true”>Sample Mfg Sérstakur eiginleiki 4
Framleiðandasértækar skipanir í stöðluðum efnisþyrpingum
Þú getur bætt framleiðanda sérstökum skipunum við hvaða staðlaða efnisklasa með eftirfarandi kröfum:
T aaaa þyrpingin sem skipanirnar sem verið er að gera til verður að tilgreina –
næsta útg. > >>
Kóði skipunarinnar er 32 bita samsetning af kóða framleiðanda og auðkenni skipunarinnar. Mikilvægustu 16 bitarnir eru framleiðandakóði. Sviðið fyrir kóða framleiðanda prófunar er 0xFFF1 – 0xFFF4. Minnstu 16 bitarnir eru skipanakennið. Sviðið fyrir ekki alþjóðlegar skipanir er 0x0000 – 0x00FF.
ExampLeið af útvíkkun On/Off Matter klasa með framleiðslusértækum klasa:

15/35

Sérsniðið XML

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ valfrjálst=“true”> Viðskiptavinaskipun sem kveikir á tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ valfrjálst=“true”>
Viðskiptavinaskipun sem breytir tækinu með umskiptum sem gefin eru af umbreytingartímanum í Ember Sample umskipti tíma eigind.

16/35

Sérsniðið XML Tags fyrir Zigbee

Eftirfarandi skjal fjallar um hvert xml tags tengt Zigbee.
Hvert xml file er skráð á milli stillingar tags:

Hægt er að skilgreina gagnategundir í stillingarbúnaðinum tag. Zigbee styður sem stendur skilgreiningu á bitamyndum, upptalningum, heiltölum, strengjum eða strúktúrum. Áður en þú skilgreinir fleiri gerðir, vertu viss um að athuga allar núverandi frumeindagerðir sem eru skilgreindar í types.xml og allar ekki atómgerðir skilgreindar í hinu xml files. Þú getur skilgreint þær sem hér segir:
Bitmap: nafn: heiti bitmap tegundar. tegund: Hægt er að skilgreina bitamynd með stærð á bilinu 8-64 bita, sem öll ættu að vera margfeldi af 8. Hver bitamynd getur haft marga reiti með nafni og grímu sem tengist því. td:

“`
Enum: nafn: nafn á enum gerð. tegund: Hægt er að skilgreina enum með stærð á milli 8-64 bita, sem allir ættu að vera margfeldi af 8. Hvert enum getur haft marga hluti með nafni og gildi sem tengist því. td:

Heiltala: Heiltölugerðir eru þegar skilgreindar undir atómtegundum sem eru til í types.xml. Stærð þeirra getur verið á bilinu 8-64 bita og geta verið undirrituð eða óundirrituð. td:

Strengur: Strengjagerðir eru þegar skilgreindar undir atómtegundum sem eru til í types.xml. Núverandi strengjategundir innihalda áttunda streng, bleikjustreng, langan octet streng og langan bleikjustreng, td:

Skipulag: nafn: heiti á gerð struct. Hvert skipulag getur haft marga hluti með nafni og gerð sem tengist því. Gerðin getur verið hvaða forskilgreinda gerð sem er undir gagnategundum. td:

17/35

Sérsniðið XML Tags fyrir Zigbee

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

Hægt er að skilgreina sérsniðna klasa innan stillingar tag. nafn: nafn klasa léns: lén klasans. Klasinn mun birtast í ZAP notendaviðmótinu undir þessu léni. lýsing: Lýsing á klasakóðanum: klasakóði skilgreina: klasaskilgreina sem er notaður af kóðarafalli til að skilgreina klasann á ákveðinn hátt framleiðandakóði: Notaður til að skilgreina sérstakan framleiðsluklasa. Þetta verður að vera á milli 0xfc00 – 0xffff. Skilgreina þarf framleiðandakóðann fyrir klasann sem hér segir:

Framleiðsluklasi gerir sjálfkrafa eiginleika og skipanir undir honum af sama framleiðandakóða nema þeir skrái sérstaklega framleiðendakóðann. introducedIn: Notað til að ákvarða forskriftarútgáfuna þar sem þyrpingin var kynnt. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. RemoveIn: Notað til að ákvarða forskriftarútgáfuna þar sem þyrpingin var fjarlægð. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. singleton(boolean): Er notað til að ákvarða klasa sem singleton þannig að það er aðeins eitt tilvik af þeim klasa sem er deilt yfir endapunktana. eigind: skilgreinir eigind fyrir klasanafnið: Nafn eigindarinnar er nefnt á milli eigindarinnar tag.
eigindarheiti
hlið(viðskiptavinur/þjónn): Sú hlið þyrpingarinnar sem eigindin tengist líka. kóði: eiginleikakóði framleiðandakóði: Þetta er hægt að nota til að skilgreina framleiðandasértæka eiginleika utan zigbee forskriftarinnar sem getið er um í staðlaða xml. define: attribute define sem er notað af kóðarafallinu til að skilgreina eigind á ákveðinn hátt tegund: tegund eigindarinnar sem getur verið hvaða gagnategund sem er nefnd í xml sjálfgefnu: sjálfgefið gildi fyrir eigindina. mín: Lágmarks leyfilegt gildi fyrir eigind max: Hámarks leyfilegt gildi fyrir eigind sem hægt er að skrifa: Er eigindargildi skrifanlegt eða ekki. Þetta er hægt að nota til að koma í veg fyrir að eigindinni sé breytt með skrifskipunum. valfrjálst(boolean): Notað til að ákvarða hvort eiginleiki sé valfrjáls eða ekki fyrir klasann. mín: Leyfilegt lágmarksgildi fyrir eigind þegar það er heiltala, upptala eða bitamynd. max: Leyfilegt hámarksgildi fyrir eigindina þegar það er heiltala, enum eða bitmap tegundarlengd: Notað til að tilgreina hámarkslengd eigindarinnar þegar hún er af tegund strengs. minLength: Notað til að tilgreina lágmarkslengd eigindarinnar þegar það er af gerðinni streng. reportable(boolean): Segir hvort eigind er tilkynntanleg eða ekki erNullable(boolean): Leyfir núllgildi fyrir eigindina. array(boolean): Notað til að lýsa yfir eigind af tegund fylki. introducedIn: Notað til að ákvarða forskriftarútgáfuna þar sem eigindin var kynnt. Þetta er notað af kóðarafallinu til að bæta við viðbótar rökfræði. RemoveIn: Notað til að ákvarða forskriftarútgáfuna þar sem eigindin var fjarlægð. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. skipun: skilgreindu skipun fyrir klasaheiti: Heiti skipunar.

kóða: skipunarkóði

18/35

Sérsniðið XML Tags fyrir Zigbee
framleiðandakóði: Þetta er hægt að nota til að skilgreina sérstaka skipun framleiðanda utan zigbee forskriftarinnar sem venjulegt xml gefur til kynna. lýsing: lýsing á skipuninni (viðskiptavinur/þjónn): uppspretta skipunarinnar. valfrjálst(boolean): Notað til að ákvarða hvort skipun sé valfrjáls eða ekki fyrir klasann. introducedIn: Notað til að ákvarða forskriftarútgáfuna sem skipunin var kynnt í. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. RemoveIn: Notað til að ákvarða forskriftarútgáfuna þar sem skipunin var fjarlægð. Þetta er notað af kóðarafallinu til að bæta við viðbótar rökfræði. skipunarrök:
Hver skipun getur haft sett af skipunarröksemdum nafn: heiti skipunarröksemdategundar: tegund skipunarröksemda sem gæti verið hvaða tegund sem er nefnd í xml. mín: Leyfilegt lágmarksgildi fyrir viðfangsefni þegar það er heiltala, enum eða bitamyndagerð. max: Leyfilegt hámarksgildi fyrir frumbreytu þegar það er heiltala, enum eða bitamyndartegundarlengd: Notað til að tilgreina leyfilega hámarkslengd fyrir frumbreytu þegar það er af gerðinni streng. minLength: Notað til að tilgreina lágmarks leyfilega lengd fyrir skipunarrök þegar það er af gerðinni streng. array(boolean): Til að ákvarða hvort skipunarröksemdin sé af gerðinni array. presentIf(strengur): Þetta getur verið skilyrtur strengur rökrænna aðgerða sem byggjast á öðrum skipunarrökum þar sem þú getur búist við skipunarröksemdinni ef skilyrti strengurinn er metinn satt. td:

Athugið: Hér er staða annað nafn skipunarröksemda. valfrjálst(boolean): Notað til að ákvarða skipunarrök sem valfrjálst. countArg: Notað þegar skipunarröksemdin er af gerðinni array. Þetta er notað til að nefna hina skipunarröksemdina sem táknar stærð fylkisins fyrir þessa röksemdafærslu.

introducedIn: Notað til að ákvarða forskriftarútgáfuna þar sem skipunarrökin voru kynnt. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. removeIn: Notað til að ákvarða forskriftarútgáfuna þar sem skipunarröksemdin var fjarlægð. Þetta er notað af kóðarafalli til að bæta við viðbótar rökfræði. Cluster Extension er hægt að skilgreina innan stillingar tag. Klasaframlenging er notuð til að útvíkka staðlaðan klasa með framleiðslueiginleikum og skipunum td

19/35

Sérsniðið XML Tags fyrir Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandiCode=”0 1002″>Sample Mfg Sérstakur eiginleiki: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandaCode=”0 1049″>Sample Mfg Sérstakur eiginleiki: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 00″ valfrjálst=”true” framleiðandaCode=”0 1002″>Sample Mfg Sérstakur eiginleiki: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” skrifanlegt=”true” default=”0 0000″ valfrjálst=”true” framleiðandaCode=”0 1049″>Sample Mfg Sérstakur eiginleiki: 0 0001 0 1040ampleMfgSpecificOffWithTransition” valfrjálst=”true” manufacturerCode=”0 1002″> Viðskiptavinaskipun sem slekkur á tækinu með gefin umskipti
við umbreytingartímann í Ember Sample umskipti tíma eigind.ampleMfgSpecificOnWithTransition” valfrjálst=”true” framleiðandiCode=”0 1002″> Viðskiptavinaskipun sem kveikir á tækinu með gefin umskipti
við umbreytingartímann í Ember Sample umskipti tíma eigind.ampleMfgSpecificToggleWithTransition” valfrjálst=”true” framleiðandiCode=”0 1002″> Viðskiptavinaskipun sem breytir tækinu með gefin umskipti
við umbreytingartímann í Ember Sample umskipti tíma eigind.ampleMfgSpecificOnWithTransition2″ valfrjálst=”true” framleiðandakóði=”0 1049″> Viðskiptavinaskipun sem kveikir á tækinu með gefin umskipti
við umbreytingartímann í Ember Sample umskipti tíma eigind.ampleMfgSpecificToggleWithTransition2″ valfrjálst=”true” framleiðandakóði=”0 1049″> Viðskiptavinaskipun sem breytir tækinu með gefin umskipti
við umbreytingartímann í Ember Sample umskipti tíma eigind.

20/35

Margar tækjagerðir á hvern endapunkt

Þetta er eingöngu eiginleiki þar sem notandi getur valið fleiri en eina tegund tækis á hvern endapunkt. Að bæta við mörgum aaa tækjagerðum mun bæta klasastillingunum innan tækjagerðanna við endapunktastillinguna.

21/35

Margar tækjagerðir á hvern endapunkt

Myndin hér að ofan sýnir að endapunktur 1 hefur valið fleiri en eina tækjategund. „Aðaltæki“ táknar aðal tækjagerð sem endapunkturinn verður tengdur við. Aðaltegund tækisins er alltaf til staðar í vísitölunni 0 á listanum yfir valdar tækjagerðir þannig að val á annarri gerð tækja mun breyta röðun tækjategundanna sem valin er. Gerðarval tækisins hafa einnig takmarkanir byggðar á forskrift gagnalíkans. ZAP verndar notendur frá því að velja ógildar samsetningar tækjategunda á endapunkti með því að nota þessar takmarkanir.

22/35

Matter Device Type Eiginleikasíða
Matter Device Type Eiginleikasíða
Matter Device Type Eiginleikasíða
ZAP styður sjón og kveikingu á Matter eiginleikum á eiginleikasíðu tækjagerðar. Aðeins tækisgerðir sem tilgreindar eru í matter-devices.xml í CHIP geymslunni munu birtast.

Farið yfir á eiginleikasíðuna
ò Ræstu ZAP í Matter með uppfærðu Matter SDK. ó Búðu til endapunkt með Matter tækisgerð. ô Smelltu á hnappinn Tækjategundareiginleikar efst á miðjum klasanum view. Athugaðu að þessi hnappur er aðeins fáanlegur í ZAP
stillingar fyrir Matter og hvenær samræmisgögn eru til í Matter SDK. Með því að smella á þennan hnapp opnast myndin hér að ofan.
Samræmi
Samræmi skilgreinir valmöguleika og ósjálfstæði fyrir eiginleika, skipanir, atburði og gagnategundir. Það ákvarðar hvort þáttur sé lögboðinn, valfrjáls eða óstuddur undir ákveðnum ZAP stillingum.
Eiginleikasamræmi tækis hefur forgang fram yfir eiginleikasamræmi klasa. Til dæmisampLýsingareiginleikinn hefur valkvætt samræmi í Kveikt/Slökkt klasanum en er lýst sem skylda í Kveikt/Slökkt ljós tækisgerð sem inniheldur Kveikt/Slökkt klasann. Með því að búa til endapunkt með kveikt/slökkt ljós tækis gerð mun birta eiginleiki sem skylda á eiginleikasíðunni.
Eiginleikaskipti
Á eiginleikasíðunni, eftir að þú smellir á skiptahnappinn til að virkja eða slökkva á eiginleika, mun ZAP:
Uppfærðu tengda þætti (eiginleika, skipanir, atburði) til að leiðrétta samræmi og birtu glugga sem sýnir breytingarnar.

23/35

Matter Device Type Eiginleikasíða Uppfærðu eiginleikabitann í featureMap eigindinni í tengdum klasa

Virkjaðu eiginleikasamræður

Slökktu á eiginleikasamræðum

Skipting er óvirk fyrir suma eiginleika þegar samræmi þeirra hefur óþekkt gildi eða eyðublað sem er ekki studd sem stendur. Í þessu skjali mun ZAP sýna viðvaranir í tilkynningunni.
a Wa Element Conform nce rnings

Þegar þú kveikir á þætti getur ZAP birt bæði viðvaranir um samræmi tækja og viðvaranir um samræmi. Ef ástand þáttarins passar ekki við væntanlegt samræmi, mun ZAP birta viðvörunartákn og skrá viðvörunina í tilkynningunni. TdampLeið af bæði samræmi og samræmisviðvaranir sem sýndar eru fyrir þátt:

24/35

Tilkynningar
Tilkynningar
Tilkynningar
Eftirfarandi hluti skilgreinir hvernig tilkynningar eru gefnar til ZAP notenda í notendaviðmótinu.
Tilkynningar um pakka
Pakkatilkynningar eru viðvaranir eða villuboð sem tengjast sérhverjum tilteknum pakka sem er hlaðið inn í ZAP. Til dæmisample, á myndunum hér að neðan, með því að smella á viðvörunartáknið undir stöðudálknum mun þú fara í glugga sem sýnir allar tilkynningar fyrir þann pakka.

25/35

Tilkynningar
Fundartilkynningar
Lotutilkynningar eru viðvaranir eða villuboð sem tengjast notandalotu. Þessar viðvaranir/villur má sjá með því að smella á hnappinn Tilkynningar á tækjastikunni efst á ZAP notendaviðmótinu. Til dæmisample, myndin hér að neðan sýnir lotutilkynningarsíðuna eftir isc file var hlaðið inn í ZAP.

26/35

Samræmi við gagnalíkan/ZCL forskriftir
Samræmi við gagnalíkan/ZCL forskriftir
Gagnalíkan og samræmi við ZCL forskriftir
Þessi eiginleiki í ZAP hjálpar notendum að sjá fylgnibilanir fyrir Data Model eða ZCL með núverandi ZAP stillingum þeirra. Viðvörunarskilaboðin vegna mistaka í samræmi munu birtast á tilkynningaglugganum í ZAP notendaviðmótinu og verða einnig skráð inn á stjórnborðið þegar ZAP er keyrt í gegnum CLI. Samræmiseiginleikinn veitir eins og er viðvaranir um samræmi við gerð tækja og samræmi við klasa á endapunkti.
Viðvaranir um samræmi í ZAP notendaviðmóti
Þegar notandi opnar .zap file með því að nota ZAP notendaviðmótið munu þeir sjá viðvaranir í tilkynningaglugganum í ZAP notendaviðmótinu fyrir allar fylgnibilanir. Til dæmisample, myndin hér að neðan sýnir lotutilkynningarsíðuna eftir .zap file var opnað með regluvörslu.

Fylgniskilaboðin munu hverfa þegar vandamálin eru leyst með því að nota ZAP notendaviðmótið þannig að þú getir fylgst aðeins með þeim fylgnivandamálum sem eftir eru. Nýjar viðvaranir munu einnig birtast vegna samræmis ef notandi slekkur á skylduþáttum (þyrping/skipanir/eiginleika) stillingarinnar. Tilkynningar um samræmi við forskrift munu alltaf halda utan um allar bilanir sem koma inn í ZAP stillinguna en athugaðu að viðvaranirnar sem birtast við opnun .zap file eru ítarlegri um hvers vegna það mistókst í samræmi við viðvaranirnar sem birtast í samskiptum við HÍ. Þetta er í hönnun og full samræmisskoðun er framkvæmd við opnun .zap file.
Viðvaranir um samræmi á stjórnborðinu

27/35

Samræmi við gagnalíkan/ZCL forskriftir
Þegar notandi opnar .zap file með því að nota ZAP sjálfstæða notendaviðmótið eða ZAP CLI munu þeir sjá viðvaranir skráðar inn á stjórnborðið/útstöðina fyrir allar fylgnibilanir. Til dæmisample, myndin hér að neðan sýnir viðvaranir um lotutilkynningar á stjórnborðinu/útstöðinni eftir .zap file var opnað með regluvörslu.

28/35

Aðgangsstýring

Aðgangsstýringareiginleikar
ZAP styður aðgangsstýringu á öllum ZCL einingum. Það er undir innleiðingu SDK að kortleggja þessa eiginleika að nauðsynlegum og studdum aðgangsstýringar SDK eiginleikum. ZAP veitir almennt gagnalíkan og kerfi til að umrita það í meta-upplýsingunum files og dreifa þeim gögnum til kynslóðarsniðmátanna, án þess að gefa gagnapunktunum sérstaka merkingu.
Grunnskilmálar
ZAP aðgangsstýring skilgreinir þrjú grunnhugtök, sem hér segir: ò aðgerð: skilgreint sem eitthvað sem hægt er að gera. Tdample: lesa, skrifa, ákalla. ó hlutverk: skilgreint sem forréttindi leikara. Svo sem "View forréttindi“, „Stjórnunarhlutverk“ og sonur á. ô breytir: skilgreind sem sérstök aðgangsstýringarskilyrði, svo sem efnisnæm gögn eða efnisbundin gögn. Grunnhugtökin eru skilgreind í lýsigögnum XML undir toppi tag . Eftirfarandi er fyrrverandiampLeið af grunnskilgreiningum aðgangsstýringar:
<role type=”view"lýsing ="View forréttindi“/>
Þetta frvample skilgreinir þrjár aðgerðir, lesa, skrifa og kalla fram, tvær breytingar og fjögur hlutverk.
Aðgangur að þríburum
Hvert einstakt aðgangsskilyrði er hægt að skilgreina með aðgangsþrítali í XML. Access triplet er sambland af aðgerð, hlutverki og breyti. Þau eru valfrjáls, svo þú getur aðeins haft einn af þessum. Hluti sem vantar af þrískiptingu þýðir almennt leyfisveitingar, sem er útfærslusértækt fyrir tiltekið SDK. Eining sem skilgreinir aðgang sinn getur haft einn eða fleiri aðgangsþríningar. Eftirfarandi er fyrrverandiample:
kl 0
Þetta er skilgreining á eigind sem er með aðgangsþrískiptu, sem lýsir því yfir að hún leyfi skrifaðgerðir með stjórnunarhlutverki, með efnissviðsbreytingu beitt.
Sjálfgefnar heimildir

29/35

Aðgangsstýring
ZCL aðilar geta skilgreint sínar eigin heimildir. Hins vegar er einnig til alþjóðleg skilgreining á sjálfgefnum heimildum fyrir
gefnar tegundir. Gert er ráð fyrir þessu fyrir tiltekna aðila, nema hún veiti sérstakar heimildir.
Sjálfgefin heimildum er lýst yfir með a tag á efsta stigi XML file. Fyrrverandiample:
aa a< ccess op="invoke"/> a a aa < ccess op=”re d”/> a< ccess op=”skrifa”/> a aa aa < ccess op=”re d” role=”view”/> aa < ccess op=”write” role=”oper te”/> a
Sniðmátshjálparar
Grunnsniðmátshjálpin til að nota er {{#access}} … {{/access}} endurtekningin. Þessi endurtekning endurtekur sig yfir allar gefnar aðgangsþríræður.
Það styður eftirfarandi tvo valkosti:
entity=“eiginleiki/skipun/atburður” – ef ekki er hægt að ákvarða eininguna út frá samhengi, þá setur þetta einingargerðina. includeDefault=”true/false” – ákvarðar hvort sjálfgefin gildi eru innifalin eða ekki. Eftirfarandi er fyrrverandiample:
{{#zcl_clusters}}
a Cluster: {{n me}} [{{code}}] a {{#zcl_ tributes}} aa – tribute: {{n me}} [{{code}}] aa {{# ccess entity=" tribute"}}
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}} [{{ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{code=}}} com a cess a ent" RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – atburður: {{n me}} [{{kóði}}] 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

Ræsa ZAP for Matter eða Zigbee forrit
Ræsa ZAP for Matter eða Zigbee forrit
Ræsir ZAP for Matter eða Zigbee forrit
Eftirfarandi hlutar lýsa því að ræsa ZAP í sjálfstæðum ham með Matter eða Zigbee sértækum lýsigögnum. Hugmyndin er að ræsa ZAP með réttum rökum sem tengjast XML lýsigögnum (þyrpingar og skilgreiningar tækjategunda samkvæmt CSA forskriftunum) og kynslóðarsniðmátunum, sem eru notuð til að búa til viðeigandi kóða.
Ræsir ZAP með Matter
Eftirfarandi handrit tekur upp rétt lýsigögn úr Matter SDK þegar ZAP er ræst. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Athugið: Þú getur líka notað eftirfarandi Zigbee nálgun til að ræsa ZAP in Matter.
Ræsir ZAP með Zigbee
Eftirfarandi skipun ræsir ZAP með ZCL forskriftunum og kynslóðarsniðmátum frá 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: Þetta er slóðin að ZAP upprunanum eða keyranlega sdk-slóðinni: Þetta er slóðin að SDK
Ræsir ZAP án lýsigagna
Mundu að þegar þú ræsir ZAP beint í gegnum keyrslu eða frá uppruna með því að nota npm run zap þá ertu að ræsa ZAP með prófunarlýsigögnum fyrir Matter/Zigbee innbyggð í ZAP en ekki raunverulegu lýsigögnunum sem koma frá Matter og Zigbee SDKs sem nefnd eru hér að ofan. Mundu því að búa til ZAP stillingar þínar með því að nota SDK lýsigögnin en ekki með því að opna ZAP beint með innbyggðu próflýsigögnunum.

31/35

Búa til kóða fyrir Matter eða Zigbee

Búa til kóða fyrir efni, Zigbee eða sérsniðið SDK
Eftirfarandi hlutar lýsa því hvernig á að búa til kóða með ZAP.
Búðu til kóða með ZAP UI
Ræstu ZAP notendaviðmótið samkvæmt leiðbeiningunum í Starting ZAP for Matter eða Zigbee og smelltu á Búa til hnappinn í efstu valmyndarstikunni.
Búðu til kóða án notendaviðmótsins
Eftirfarandi leiðbeiningar veita mismunandi leiðir til að búa til kóða í gegnum CLI án þess að ræsa ZAP notendaviðmótið.
Búa til kóða frá ZAP Source
Keyrðu eftirfarandi skipun til að búa til kóða með ZAP frá uppruna: hnútur 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
Búa til kóða frá ZAP Executable
Keyrðu eftirfarandi skipun til að búa til kóða með því að nota ZAP executable: [zap-path] generate –genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp
Búa til kóða frá ZAP CLI Executable
Keyrðu eftirfarandi skipun til að búa til kóða með því að nota ZAP CLI Executable: [zap-cli-path] create –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

Uppfærðu ZAP í Studio

Uppfærðu ZAP
Uppfærðu ZAP í Simplicity Studio
Þetta kerfi er hægt að nota þegar unnið er með Matter extension eða Zigbee frá Silicon Labs SDK útgáfunum. Hægt er að uppfæra ZAP innan Simplicity Studio án Simplicity Studio útgáfu með því að hlaða niður nýjustu ZAP executable (mælt með) eða draga það nýjasta úr ZAP uppruna eins og sýnt er í ZAP Uppsetningarhandbók. Eftir að þú hefur nýjasta ZAP byggt á núverandi stýrikerfi þínu, geturðu uppfært ZAP innan Studio sem millistykki. Fylgdu leiðbeiningunum hér að neðan eftir að hafa hlaðið niður nýjasta ZAP:
Farðu í Simplicity Studio og veldu Preferences > Simplicity Studio > Adapter Packs. Smelltu á Bæta við... og flettu að stækkuðu ZAP möppunni sem þú hleður niður og smelltu á Veldu möppu . Smelltu á Apply and Close og þá verður nýlega bætt við ZAP notað í hvert sinn sem .zap file er opnað.
Athugið: Stundum gætu verið eldri tilvik af ZAP þegar í gangi jafnvel eftir uppfærslu í nýjasta ZAP. Gakktu úr skugga um að hætta öllum núverandi ZAP tilvikum þannig að nýsótt ZAP sé notað í stað gamals tilviks, sem er enn að virka í bakgrunni.
Uppfærðu ZAP fyrir málþróun í Github
Þegar unnið er með Matter eða Matter-Silicon Labs repos á Github, stilltu umhverfisbreyturnar með tilliti til ZAP til að búa til/búa til nýjar ZAP stillingar eða endurskapa núverandi s.ample ZAP stillingar eftir að hafa beitt breytingum á þeim. Stilltu ZAP_DEVELOPMENT_PATH á ZAP frá uppruna með því að draga það nýjasta eða stilltu ZAP_INSTALLATION_PATH á ZAP keyrslu sem þú hleður niður síðast í staðbundinni skrá. Athugaðu að þegar bæði ZAP_DEVELOPMENT_PATH og ZAP_INSTALLATION_PATH eru stillt er ZAP_DEVELOPMENT_PATH notað.
Eftirfarandi eru tdampmyndir sem sýna ofangreindar umhverfisbreytur í notkun:
Ræsir ZAP með Matter forskrift Endurnýjar allar sample ZAP stillingar fyrir Matter forrit
Athugið: Þegar þú notar ZAP executables skaltu ganga úr skugga um að þú sért að nota opinbera útgáfu yfir næturútgáfu til að fá meiri stöðugleika. Sjá
Að hlaða niður ZAP Executable í ZAP Uppsetningarhandbók

33/35

Samhliða fjölsamskiptareglur milli Zigbee og Matter
Samhliða fjölsamskiptareglur milli Zigbee og Matter
MCoanttceurrrent Multi-samskiptareglur milli Zigbee og
ZAP er hægt að nota til að stilla ZCL (Zigbee) og Data-Model (Matter) stillingar í fjölsamskiptaforriti fyrir Zigbee og Matter. ZAP gerir þér kleift að búa til endapunkta fyrir Zigbee og Matter sérstaklega í sömu uppsetningu file. Ef endapunktar Zigbee og Matter eru á sama endapunktauðkenni (tdample, LO Dimmable Light á endapunkti Id 1 og Matter Dimmable Light á öðru tilviki endapunkts 1), sér ZAP um að samstilla sameiginlegu eiginleikana yfir Matter og Zigbee eiginleikana. Gakktu úr skugga um að eigindirnar sem verið er að samstilla séu með sömu gagnategund. Sameiginlegir eiginleikar Zigbee og Matter eru staðfestir með a file kallað multi-protocol.json . Notandinn getur tengt hvaða tvo klasa sem er þvert á Zigbee og Matter ásamt samsvarandi eiginleikum þeirra með því að nota klasa- og eiginleikakóðann í sömu röð. Þetta file er að finna í [SDKPath]/app/zcl/multi-protocol.json . Þetta file hefur verið uppfært með ákveðnu setti af klösum og eiginleikum til að byrja með, en notandinn getur uppfært þetta file eins og krafist er og ZAP mun sjá um að samstilla eiginleika stillingar yfir Zigbee og Matter fyrir algeng endapunktaauðkenni.
Þú getur líka fundið ZAP kennsluefni í hvaða Zigbee and Matter fjölsamskiptaforriti sem er undir kennslusíðunni. Þessi kennsla mun leiða þig í gegnum ferlið við að búa til forrit með mörgum samskiptareglum. Þessi kennsla er aðeins í boði þegar þú opnar fyrirliggjandi forrit með mörgum samskiptareglum og er að finna eins og sýnt er á myndinni hér að neðan:

34/35

Samþætta SLC CLI við ZAP
Samþætta SLC CLI við ZAP
Samþætta SLC CLI við ZAP
Fylgdu þessum skrefum til að samþætta SLC CLI við ZAP: ò Settu upp SLC CLI með því að fylgja uppsetningarleiðbeiningunum í Simplicity Studio 5 notendahandbókinni. ó Settu upp ZAP með því að fylgja leiðbeiningunum í ZAP uppsetningarhandbókinni. ô Til að samþætta SLC CLI við ZAP skaltu bæta við umhverfisbreytu STUDIO_ADAPTER_PACK_PATH sem vísar á ZAP forritið
skrá. õ Mundu að endurræsa SLC CLI Daemon eftir skref 3. ö Sérhvert verkefni sem notar ZAP mun nú nota slóðina sem er skilgreind í skrefi 3 þegar það er búið til úr SLC CLI. Vinsamlegast vísa til SLC CLI
Notkun fyrir leiðbeiningar um notkun SLC CLI fyrir verkefnin þín.

35/35

Skjöl / auðlindir

SILICON LABS ZAP þróast með Silicon Labs [pdf] Handbók eiganda
ZAP Þróun Með Silicon Labs, ZAP, Þróun með Silicon Labs, Silicon Labs, Labs

Heimildir

Notendahandbók

ZAP þróast með Silicon Labs

Tæknilýsing

Notkunarleiðbeiningar fyrir vöru

Algengar spurningar

Þróun með Silicon Labs ZAP

ZAP Að hefjast handa

ZAP uppsetning

ZAP grundvallaratriði

Sérsniðið XML

Sérsniðið XML Tags fyrir Zigbee

Margar tækjagerðir á hvern endapunkt

Aðgangsstýring

Búa til kóða fyrir Matter eða Zigbee

Uppfærðu ZAP í Studio

Skjöl / auðlindir

Heimildir

Skildu eftir athugasemd

Hætta við svar