An lámhleabhar úsáideora le haghaidh ZAP ag Forbairt Le Silicon Labs

ZAP Ag Tosú
- Chun tús a chur le ZAP, lean na céimeanna seo:
  - ZAP a íoslódáil ó an suíomh oifigiúil.
  - Suiteáil na spleáchais ag baint úsáide as ordú suiteála npm.
  - Le haghaidh suiteáil a bhaineann go sonrach le Windows, féach ar an Suiteáil ZAP le haghaidh Windows OS treoir.
Forbairt Zigbee
- Má tá feidhmchláir Zigbee á bhforbairt agat:
  - Úsáid Simplicity Studio lena n-áirítear ZAP agus uirlisí riachtanacha eile.

Forbairt Ábhar
- Má tá feidhmchláir Matter á bhforbairt agat:
  - I measc na roghanna tá Simplicity Studio a úsáid nó rochtain a fháil ar stórtha Silicon Labs nó CSA Github.
  - Déan tagairt do na treoracha nuashonraithe le haghaidh ZAP lasmuigh de thimthriall scaoileadh Simplicity Studio más gá.

CCanna

C: Cad iad na leaganacha éagsúla de dhénártha ZAP atá ar fáil?
- A: Tá dhá leagan ar fáil - Eisiúint oifigiúil le tógálacha fíoraithe agus réamhscaoileadh leis na gnéithe is déanaí.

C: Cad ba cheart dom a dhéanamh má bhíonn fadhbanna agam le tiomsú na leabharlainne dúchais le linn na suiteála?
- A: Déan tagairt don fhaisnéis Ceisteanna Coitianta faoi scripteanna a bhaineann go sonrach le hardáin chun saincheisteanna den sórt sin a réiteach.

“`

View Fullscreen

Sileacan Labs ZAP
Sileacan Labs ZAP

Ag forbairt le Silicon Labs ZAP

Tús a chur leis
ZAP Ag Tosú Ar Leatview ZAP Suiteáil ZAP Suiteáil Windows Ceisteanna Coitianta
Bunúsacha ZAP Bunúsacha
Treoir Úsáideora ZAP Treoir Úsáideora Tharview Saincheaptha XML Saincheaptha XML Tags le haghaidh Zigbee Cineálacha Gléasanna Iolracha In aghaidh an Ábhair Deiridh Cineál Gné an Ghléis Fógraí Leathanach Fógraí-Samhail Sonraí/ZCL Sonraíocht Comhlíonta Rialú Rochtana Seoladh ZAP d'fheidhmchláir Ábhar nó Zigbee Ag giniúint cód don Ábhar nó don Zigbee Nuashonraigh ZAP i Stiúideo Comhthráthach Ilphrótacal idir Zigbee agus Matter Comhtháthaigh SLC CLI le ZAP

1/35

Ag forbairt le Silicon Labs ZAP
Ag forbairt le Silicon Labs ZAP
ZAP
Is inneall giniúna cód cineálach é ZAP agus comhéadan úsáideora le haghaidh feidhmchláir agus leabharlanna atá bunaithe ar Leabharlann Braisle Zigbee ó Zigbee nó ar an tSamhail Sonraí ó Ábhar. Is é an Comhaontas um Chaighdeáin Nascachta a fhorbraíonn an tsonraíocht. Ligeann ZAP duit na hoibríochtaí seo a leanas a dhéanamh:
Déan giniúint shaincheaptha SDK de gach déantán domhanda (tairiseacha, cineálacha, IDanna, agus mar sin de) bunaithe ar shonraíocht ZCL/Samhail Sonraí. Giniúint shaincheaptha SDK a dhéanamh de na déantáin chumraíochta ar fad atá roghnaithe ag an úsáideoir (cumraíocht an fheidhmchláir, cumraíocht an chríochphointe, agus mar sin de) bunaithe ar shonraíocht ZCL/Samhail Sonraí agus cumraíocht feidhmchláir arna soláthar ag an gcustaiméir. Cuir UI ar fáil don úsáideoir deiridh chun cumraíocht feidhmchláir ar leith a roghnú (deireadhphointí, braislí, tréithe, orduithe, agus mar sin de).

Déanann an t-ábhar sna hailt seo cur síos ar conas feidhmchláir Zigbee agus Matter a fhorbairt trí na Sraitheanna ZCL (Zigbee) nó Samhail Sonraí (Ábhar) a chumrú ag baint úsáide as ZAP.

2/35

ZAP Ag Tosú

ZAP Ag Tosú
Tús a chur le ZAP
Déanann na hailt seo cur síos ar mhodhanna éagsúla chun feidhmchláir Zigbee agus Matter a chruthú. Tabhair faoi deara go soláthraíonn Simplicity Studio bealach chun d’fheidhmchláir Zigbee and Matter a chruthú ó cheann go deireadh ina ndéantar na huirlisí go léir a réamhshuiteáil in éineacht le Simplicity Studio (lena n-áirítear ZAP). B’fhéidir go gcinnfidh tú bealaí eile a fhiosrú chun d’fheidhmchláir a chruthú, mar a mhínítear anseo.
Forbairt Zigbee
Is féidir le forbróirí feidhmchlár Zigbee a gcuid feidhmchláir a thógáil ag baint úsáide as Simplicity Studio, a chuimsíonn ZAP cheana féin agus uirlisí eile a chuidíonn leat d'iarratas a thógáil ó cheann go ceann.
Forbairt Ábhar
Is féidir le forbróirí Feidhmchláir Matter a gcuid feidhmchláir a thógáil ag baint úsáide as na modhanna seo a leanas: Simplicity Studio: Áirítear leis seo ZAP agus uirlisí eile atá ag teastáil chun an feidhmchlár Matter a thógáil ó cheann ceann go deireadh. Github (Saotharlanna Sileacain) Github (CSA)
Nóta: Chun ZAP a nuashonrú lasmuigh de thimthriall scaoileadh Simplicity Studio, féach ar nuashonrú ZAP in Simplicity Studio agus ZAP Installation Guide

3/35

Suiteáil ZAP

Déanann na hailt seo a leanas cur síos ar shuiteáil ZAP agus conas ZAP a nuashonrú i Simplicity Studio IDE.
Íoslódáil an Inrite ZAP Molta)
Is é seo an bealach molta chun tús a chur le ZAP. Is féidir leat na binaries ZAP is déanaí a fháil ó aa https://github.com/project-chip/zp/releses. Tagann binaries réamhthógtha i dhá leagan éagsúla.
Eisiúint oifigiúil: Tógálacha fíoraithe le seomraí tástála tiomnaithe Matter agus Zigbee. Is é vYYYY.DD.MM formáid an ainm eisiúna. Réamhscaoileadh: Tógtar leis na gnéithe is déanaí agus na réitigh fabhtanna ach NACH fíoraítear na tógálacha seo le seomraí tástála Matter agus Zigbee tiomnaithe. Is é an fhormáid ainm eisiúna vYYYY.DD.MM-oíche.
Suiteáil ZAP ó Foinse
Treoracha bunúsacha chun ZAP a shuiteáil
Toisc gur feidhmchlár nód.js é seo, ní mór duit an timpeallacht nód a shuiteáil. Is é an bealach is fearr chun é seo a dhéanamh ná an suiteáil nód is déanaí a íoslódáil, lena n-áirítear nód agus npm. Má tá leagan níos sine den nód suiteáilte agat ar do stáisiún oibre, d’fhéadfadh fadhbanna a bheith ann, go háirithe má tá sé an-sean. Bí cinnte go bhfuil an leagan nód v16.x is déanaí agat leis an npm atá san áireamh. Rith nód –leagan chun a sheiceáil cén leagan a roghnaíodh. v18.x molta. Tar éis duit leagan inmhianaithe den nód a bheith agat, is féidir leat an méid seo a leanas a rith:
Suiteáil na Spleáchais
Úsáid na horduithe seo a leanas chun spleáchais a shuiteáil:

npm a shuiteáil
Nóta: Maidir le suiteáil ZAP a bhaineann go sonrach le Windows, féach Suiteáil ZAP le haghaidh Windows OS Níl sé neamhchoitianta fadhbanna tiomsaithe na leabharlainne dúchais a rith ag an bpointe seo. Tá scripteanna éagsúla src-script/install-* ann le haghaidh ardáin éagsúla. Féach ar an eolas Ceisteanna Coitianta maidir le cén script le rith ar ardáin éagsúla agus ansin athrith npm install .
Tosaigh an Feidhmchlár
Úsáid na horduithe seo a leanas chun an feidhmchlár a thosú:

npm rith zap
Tosaigh an Ceann Tosaigh i Mód Forbartha
Tacaíonn sé le hathlódáil cód te, tuairisciú earráide, agus mar sin de. Bain úsáid as na horduithe seo a leanas chun tús a chur leis an gceann tosaigh i bhforbairt
mód:
quasar dev -m leictreon
or

4/35

ZAP Insta ag o ll in
npm rith electron-dev

5/35

ZAP Suiteáil Windows
ZAP Suiteáil Windows
Suiteáil ZAP le haghaidh Windows OS
1. Windows Powershell
Sa bharra cuardaigh deisce, ionchur Windows Powershell agus reáchtáil mar riarthóir. Rith na horduithe seo a leanas go léir taobh istigh de Powershell.
2. Seacláid
Suiteáil ó https://chocolatey.org/install. Seiceáil an bhfuil sé suiteáilte i gceart leis na horduithe seo a leanas:
seacláid -v
Suiteáil pacáiste pkgconfiglite leis na horduithe seo a leanas:
choco shuiteáil pkgconfiglite
3. Suiteáil Nód
Rith na horduithe seo a leanas chun a shuiteáil:
choco shuiteáil nodejs-lts
*Caithfidh an leagan a bheith 18 chun tástáil seiceála leagan a phasáil, tar éis é a shuiteáil, seiceáil le nód -v *Má tá Nód suiteáilte agat cheana féin, agus má theipeann ar roinnt tástálacha cosúil leis nach féidir teacht ar Nód , athshuiteáil Nód le chocolatey arís.
4. Lean na Treoracha Bunúsacha chun ZAP a shuiteáil
Lean na treoracha suiteála ZAP ón bhfoinse i Suiteáil ZAP. Agus tú ag leanúint na dtreoracha bunúsacha chun ZAP a shuiteáil bí ag faire amach do na hearráidí seo a leanas agus conas iad a réiteach:
sqlite3
Agus ZAP á rith (m.sh., npm run zap ), má fheiceann tú earráid faoi sqlite3.node i bhfuinneog aníos, rith:
npm atógáil sqlite3
leictreon-tógálaí
Agus npm install á dhéanamh, in iar-shuiteáil, má tharlaíonn earráid ar an ordú seo a leanas a bhaineann le install-appdeps leictreon-tógálaí , theip ar chanbhás npx electron-rebuild nó nód-pre-gyp , níl an leagan chanbhás reatha comhoiriúnach le Windows agus ní bheidh an earráid suiteála ina chúis le teip i rith ZAP. Tá nód-chanbhás ag obair ar an réiteach anois agus réiteofar an cheist go luath amach anseo.
“postinstall”: “leictreon-tógálaí install-app-deps && husky install && npm atógáil canbhás – nuashonraigh-dénártha && npm run version-stamp”

6/35

ZAP Suiteáil Windows
Canbhás
Má theipeann ar thástáil rith npm mar gheall ar an earráid theip ar an tsraith tástála a rith. Ní féidir modúl '../build/Release/canvas.node' a aimsiú nó
zapnode_modulescanvasbuildReleasecanvas.node Ní feidhmchlár Win32 bailí é. , canbhás a atógáil mar seo a leanas:
npm atógáil chanbhás – nuashonraigh-dénártha
faigh index.html nó Saincheisteanna Freastalaí Eile
Má theipeann ar thástáil rith npm mar gheall ar an earráid faigh an t-iarratas index.html theip le cód stádais 404 i dtrialacha aonaid nó tá an freastalaí
saincheisteanna nasctha i dtrialacha e2e-ci, reáchtáil na horduithe seo a leanas:
tógáil rith npm
Eile
Seiceáil an bhfuil an leagan nód v18 agus déan iarracht é a shuiteáil le Chocolatey.

7/35

CCanna
CCanna
Ceisteanna Coitianta
C: Conas UI a thosú i mód forbartha? A: Is féidir leat an Chomhéadain a thosú i mód forbartha, as a dtiocfaidh an socrú seo a leanas:
Freastalaí HTTP forbartha quasar ar leith, a dhéanann athnuachan beo ar phort 8080 ZAP cúil ag rith ar phort 9070 Chrome nó brabhsálaí eile, ag rith go neamhspleách Chun an socrú sin a fháil, lean na treoracha thíos. ò Ar dtús, reáchtáil an freastalaí forbartha ZAP, a thosaíonn ar phort 9070.
npm run zap-devserver ó Ar Aghaidh, reáchtáil an freastalaí forbartha quasar, a thosaíonn ar phort 8080.
quasar dev ô Pointe do bhrabhsálaí nó rith ceann i gcoinne an gceart URL leis an argóint restPort:
google-chrome http://localhost:8080/?restPort=9070

C: Conas é seo a dhéanamh ar Mac/Linux OS? A:
Úsáidtear npm install chun gach pacáiste spleáchais riachtanach a íoslódáil. Má fheiceann tú earráidí a bhaineann le nód-gyp agus leabharlanna áitiúla ar iarraidh, cosúil le pixman , agus mar sin de, tá tú ag iarraidh spleáchais dhúchasacha a shásamh a thiomsú dénártha nód neamh-réamhthógtha le haghaidh roinnt teaglaim de ardáin agus leaganacha. Tá Npm ar an scamall ag nuashonrú liosta na ndénártha a chuirtear ar fáil i gcónaí, agus mar sin is féidir go roghnóidh tú iad go breá, ach mura ndéanann tú, is treoracha iad seo le haghaidh ardáin éagsúla:
Fedora Core le dnf :
suiteáil dnf pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
nó rith script:
src-script/install-packages-fedora
Ubuntu le apt-get :
apt-get update apt-get install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
nó rith script:

8/35

CCanna
src-script/install-packages-ubuntu
OSX ar Mac le brew Homebrew :
brew install pkg-config cairo pango libpng jpeg giflib librsvg
nó rith script:
src-script/install-packages-osx
C: Conas é seo a dhéanamh ar Windows OS?
F: Déan cinnte go bhfuil sé suas chun dáta i gcónaí agus nach bhfuil aon athruithe nach bhfuil déanta. Leid: is cairde iad git pull, git status & git stash. Ní mór duit Chocolately a úsáid chun Zap a chur ag obair ar Windows OS. Déan cinnte an pacáiste pkgconfiglite a íoslódáil.
choco shuiteáil pkgconfiglite
Má tá fadhbanna agat le Cairo, le haghaidh example má fhaigheann tú earráid faoi cairo.h': Níl a leithéid file nó eolaire, déan an méid seo a leanas: ò Seiceáil an bhfuil do ríomhaire 32 nó 64 giotán. y Ag brath air sin, íoslódáil an pacáiste cuí ón suíomh seo
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:
Cliceáil ar Ardsocruithe an Chórais. Sa chluaisín chun cinn cliceáil ar Athróga Comhshaoil. Sa rannóg Athróga Córais, faigh an t-athróg timpeallachta PATH agus roghnaigh é. Cliceáil Edit agus cuir C:/GTK leis. Mura bhfuil an athróg timpeallachta PATH ann, cliceáil Nua. Mura n-aimsítear jpeglib.h, bain triail as na rudaí seo a leanas: ò Ar an teirminéal, rith: choco install libjpeg-turbo ó Cinntigh go bhfuil sé glan trí úsáid a bhaint as: git clean -dxff agus rith npm install again ô mura dtarlaíonn aon earráidí agus mura bhfuil ach rabhaidh le feiceáil, bain triail as deisiú iniúchta npm a úsáid õ murar féidir leat ZAP a rith, téigh go dtí file src-script/zap-start.js ö Athrú
÷ const { sceith } = a cheangal ('tras-sceite') chun const { sceith } = a cheangal ('child_process') ø Rith npm agus rith zap. Tagairtí:
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)
C: Faighim earráid “sqlite3_node” nár aimsíodh nó a leithéid.

9/35

CCanna
A: Déan do cheangail dhúchasacha sqlite3 a atógáil. Chun é seo a shocrú i bhformhór na gcásanna, rith:
npm a shuiteáil
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Mura bhfuil sé socraithe fós, déan:
rm -rf nóde_modules agus ansin bain triail as na horduithe thuas arís. Ó am go chéile déanann uasghrádú do npm difríocht freisin:
npm shuiteáil -g npm
C: Faighim earráid "Is é an leagan N-API den ásc Nód seo ná 1. Tacaíonn an modúl seo le leagan N-API 3. Ní féidir leis an ásc Nód seo an modúl seo a rith."
A: Uasghrádaigh do leagan nód. Pléitear an réiteach dó seo sa snáithe Stack Overflow seo: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
C: Ní oibríonn mo ríomhaire forbartha le ZAP ar chúis ar bith. An féidir liom coimeádán docker a úsáid?
A: Is féidir leat. TBD.
C: Conas a ritheann ZAP taobh istigh de VSCode?
A: Má dhéanann tú VSCode ar do chosán cuir isteach an zap repo agus clóscríobh an cód . Osclóidh sé seo ZAP i gCód VSC. Chun ZAP a rith i mód dífhabhtaithe, roghnaigh an spás oibre ZAP agus cliceáil ar an deilbhín Rith ar an mbarra uirlisí ar chlé. Beidh cúpla rogha agat le roghnú astu chun ZAP a rith, roghnaigh Node.js Debug Terminal . Osclóidh sé seo fuinneog teirminéil ónar féidir leat npm run zap a chur isteach , a cheangail an dífhabhtóir agus a reáchtálfaidh ZAP mar a dhéanfá de ghnáth ón líne ordaithe. Comhghairdeas, ba cheart duit ZAP a fheiceáil ag rith sa dífhabhtóir anois. Is féidir leat brisphointí a shocrú i gCód VSC mar a dhéanfá in aon IDE eile.
C: Teipeann ar thástáil aonaid Chomhéadain le roinnt earráidí timpeall ar chanbhás gan tógáil don leagan ceart den nód. Cad a dhéanfaidh mé?
A: Má fheiceann tú an earráid seo a leanas:
FAIL test/ui.test.js Theip ar an tsraith tástála a rith Tiomsaíodh an modúl 'canvas.node' le leagan eile de Node.js ag úsáid NODE_MODULE_VERSION 80. Tá NODE_MODULE_VERSION 72 ag teastáil ón leagan seo de Node.js. Déan iarracht an modúl a ath-thiomsú nó a athshuiteáil (mar shampla, ag baint úsáide as `n` repmbuild).
ag Cuspóir. (node_modules/canvas/lib/bindings.js:3 18)
ansin rith: npm atógáil chanbhás – nuashonraigh-dénártha

10/35

Bunúsacha ZAP

ZCL/Samhail-Sonraí Bunúsanna ZAP
Tá faisnéis sa chuid seo d’úsáideoirí nua ZAP. Cliceáil ar an deilbhín teagaisc ar an gcúinne uachtarach ar dheis den Chomhéadain ZAP, a thaispeánann conas cumraíocht ZAP a chruthú. Treoróidh an rang teagaisc tú tríd an méid seo a leanas: Cruthaigh críochphointe Roghnaigh cineál gléis Cumraigh braisle Cumraigh tréith Cumraigh ordú Le haghaidh tagartha mionsonraithe, féach Treoir Cumróra Braisle Zigbee

11/35

ZAP lámhleabhar úsáideora
ZAP lámhleabhar úsáideora
ZAP lámhleabhar úsáideora
Tugann na hailt faoin treoir seo tuilleadh sonraí faoi na gnéithe éagsúla a sholáthraíonn ZAP.

12/35

XML Saincheaptha

Ag cur XML Saincheaptha ón Chomhéadain ZAP leis
Cliceáil ar an deilbhín “Eisínteachtaí” san Chomhéadain ZAP. Cliceáil ar an gcnaipe "+" chun xml saincheaptha a roghnú file Ba chóir go mbeadh na braislí saincheaptha, na tréithe, na horduithe, srl le feiceáil sa Chomhéadain ZAP nuair a bheidh an xml saincheaptha curtha leis.
Do XML saincheaptha féin a chruthú i Zigbee
Léiríonn an chuid seo conas do bhraislí saincheaptha féin a chruthú agus braislí caighdeánacha atá ann cheana a leathnú le tréithe agus orduithe saincheaptha do Zigbee.
Cnuasaigh a Bhaineann go Sonrach le Monaróirí i Zigbee
Is féidir leat braislí a bhaineann go sonrach leis an monaróir a chur le pro caighdeánachfile. Cuirimid example de seo thíos. Chun é seo a dhéanamh ní mór duit dhá oibleagáid a chomhlíonadh:
NÍ MÓR an t-aitheantas braisle a bheith sa raon a bhaineann go sonrach leis an monaróir, 0xfc00 – 0xffff. Ní mór cód déantúsóra a bheith sa sainmhíniú braisle a chuirfear i bhfeidhm ar GACH tréithe agus ordú laistigh den bhraisle sin agus ní mór é a sholáthar nuair a bhíonn orduithe á seoladh agus á bhfáil agus ag idirghníomhú le tréithe. example:

Sample Mfg Cnuasach Sonrach Ginearálta Soláthraíonn an braisle seo seanample conas is féidir an Creat Feidhmchláir a leathnú chun braislí a bhaineann go sonrach leis an monaróir a chuimsiú.
0xFC00
ember sample tréithe
ember sample tréithe 2

A sample hordú monaróir-shonrach laistigh de na sample monaróir-shonrach
cnuasach.

Orduithe Sonracha Monaróra i gCnuasach Caighdeánach Zigbee
Is féidir leat d’orduithe féin a chur le haon bhraisle caighdeánach Zigbee leis na riachtanais seo a leanas:
Féadfaidh d’orduithe a bhaineann go sonrach leis an monaróir úsáid a bhaint as aon aitheantas ordaithe laistigh den raon aitheantais ordaithe, 0x00 – 0xff. Ní mór duit freisin cód monaróir a sholáthar don ordú ionas gur féidir é a idirdhealú ó orduithe eile sa bhraisle agus a láimhseáil go cuí. example síneadh a chur leis an mbraisle Ar/As le horduithe déantúsaíochta:

13/35

XML Saincheaptha
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a mhúchtar an gléas le haistriú tugtha ag an am aistrithe san Ember Sample tréith ama aistrithe.ampleMfgSpecificOnWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a chuireann an gléas ar siúl le haistriú arna thabhairt ag an am aistrithe san Ember Sample tréith ama aistrithe.ampleMfgSpecificToggleWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a scorálann an gléas le trasdul tugtha ag an am trasdula san Ember Sample tréith ama aistrithe.ampleMfgSpecificOnWithTransition2″ roghnach=”fíor” monaróirCode=”0 1049″> Ordú cliaint a chuireann an gléas ar siúl le haistriú arna thabhairt ag an am aistrithe san Ember Sample tréith ama aistrithe.ampleMfgSpecificToggleWithTransition2″ roghnach=”fíor”
monaróirCode=”0 1049″> Ordú cliaint a scorálann an gléas le trasdul tugtha ag an am trasdula san Ember Sample tréith ama aistrithe.

Tréithe Sonracha Monaróra i gCnuasach Caighdeánach Zigbee
Is féidir leat do chuid tréithe féin a chur le haon bhraisle caighdeánach Zigbee leis na riachtanais seo a leanas:
Féadfaidh do shaintréithe monaróir-shonrach úsáid a bhaint as aon aitheantas aitreabúide laistigh den raon aitheantais aitreabúide, 0x0000 – 0xffff. Ní mór duit freisin cód monaróra a sholáthar don aitreabúid ionas gur féidir í a idirdhealú ó shaintréithe eile sa bhraisle agus a láimhseáil go cuí. example síneadh a chur leis an mbraisle Ar/As le tréithe déantúsaíochta:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” cineál=”INT16U” nóim=”0 0000″
max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = “fíor” monaróirCode = ” 0 1002 ″>Sample Mfg Tréith Shonrach: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ cineál=”INT8U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor” monaróirCode = ” 0 1049 ″>Sample Mfg Tréith Shonrach: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ cineál=”INT8U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 00 ″ roghnach = ”fíor” monaróirCode = ” 0 1002 ″>Sample Mfg Tréith Shonrach: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ cineál=”INT16U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor” monaróirCode = ” 0 1049 ″>Sample Mfg Tréith Shonrach: 0 0001 0 1040
Do XML saincheaptha féin a chruthú in Matter
Taispeánann an chuid seo conas do bhraislí saincheaptha féin a chruthú agus braislí caighdeánacha atá ann cheana a leathnú le tréithe agus orduithe saincheaptha le haghaidh Matter.
Braislí a Bhaineann go Sonrach le Monaróirí i bhFeidhm
Is féidir leat braislí a bhaineann go sonrach leis an monaróir a chur leis in Matter. Cuirimid example de seo thíos.
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 Saincheaptha
Sa example, tá value of 0xFFF1FC0. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Ginearálta Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Tá an Sample MEI braisle taispeántais monaróir braisle síntí FlipFlop
Freagra ar AddArguments a thugann an tsuim ar ais. Ordú a thógann dhá argóint uint8 agus a thugann a suim ar ais. Ordú simplí gan aon pharaiméadair agus gan freagra.
Tréithe Sonracha Monaróra i mBraislí d'Ábhair Chaighdeánacha
Is féidir leat tréithe sonracha an mhonaróra a chur le haon bhraisle Ábhar caighdeánach leis na ceanglais seo a leanas:
T aaaa cnuasaigh sé go gcaithfear na tréithe a bhfuiltear ag dul dóibh a shonrú –
agus xte nd ed > “ >
Is meascán 32-giotán é cód an aitreabúide de chód an mhonaróra agus an t-aitheantas don aitreabúid. Is iad na 16 giotán is suntasaí ná an cód monaróir. Is é 0xFFF1 – 0xFFF4 an raon do chóid déantóirí tástála. Is iad na 16 ghiotán is lú suntas ná an t-aitheantas tréithe. Is é an raon tréithe neamhdhomhanda ná 0x0000 - 0x4FFF.
Example braisle Ábhar Ar/Amach a leathnú le tréithe a bhaineann go sonrach leis an monarú:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ cineál=”INT8U” nóim=”0 0000″
max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor”>Sample Mfg Tréith Shonrach 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ cineál=”INT16U” nóim=”0 0000″
max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor”>Sample Mfg Tréith Shonrach 4
Orduithe a Bhaineann go Sonrach le Monaróirí i mBraislí d'Ábhair Chaighdeánacha
Is féidir leat orduithe sain-mhonaróra a chur le haon bhraisle Ábhar caighdeánach leis na ceanglais seo a leanas:
T aaaa cnuasaigh sé go gcaithfear na moltaí a bhfuiltear ag dul dóibh a shonrú –
agus xte nd ed > “ >
Is meascán 32-giotán é cód an ordaithe de chód an mhonaróra agus an t-aitheantas don ordú. Is iad na 16 giotán is suntasaí ná an cód monaróir. Is é 0xFFF1 – 0xFFF4 an raon do chóid déantóirí tástála. Is iad na 16 giotán is lú suntasaí ná an t-aitheantas ordaithe. Is é an raon orduithe neamhdhomhanda ná 0x0000 - 0x00FF.
Example braisle Ábhar Ar/Amach a leathnú le braislí a bhaineann go sonrach le déantúsaíocht:

15/35

XML Saincheaptha

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ optional=”fíor"> Ordú cliaint a chuireann an gléas ar siúl le haistriú arna thabhairt ag an am aistrithe san Ember Sample tréith ama aistrithe.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ roghnach=”fíor”>
Ordú cliaint a scorálann an gléas le trasdul tugtha ag an am trasdula san Ember Sample tréith ama aistrithe.

16/35

XML Saincheaptha Tags le haghaidh Zigbee

Labhraíonn an doiciméad seo a leanas faoi gach ceann de na xml tags a bhaineann le Zigbee.
Gach xml file atá liostaithe idir an cumróir tags:

Is féidir cineálacha sonraí a shainiú laistigh den chumróir tag. Faoi láthair tacaíonn Zigbee leis an sainmhíniú ar ghiotán, uimhreacha, slánuimhreacha, teaghráin nó struchtúir. Sula sainítear níos mó cineálacha déan cinnte seiceáil ar na cineálacha adamhach atá ann cheana féin atá sainmhínithe i gcineálacha.xml agus na cineálacha neamhadamhacha go léir atá sainmhínithe sa xml eile files. Is féidir leat iad a shainiú mar seo a leanas:
Giotán: ainm: ainm an chineáil léarscáil ghiotán. cineál: Is féidir léarscáil ghiotán le méid idir 8-64 giotán a shainiú, agus ba cheart go mbeadh iolraí de 8 ar gach ceann díobh. Is féidir le réimsí iolracha a bheith ag gach léarscáil ghiotán agus ainm agus masc a bhaineann leis. msh:

“`
Enum: ainm: ainm an chineáil enum. cineál: Is féidir enum le méid idir 8-64 giotán a shainiú, agus ba cheart go mbeadh iolraí de 8 ar gach ceann díobh. Is féidir go mbeadh míreanna iolracha ag gach enum a bhfuil ainm agus luach bainteach leis. msh:

Slánuimhir: Sainmhínítear cineálacha slánuimhreacha cheana féin faoi chineálacha adamhach atá i gcineálacha.xml. Féadfaidh a méid a bheith idir 8-64 giotán agus is féidir iad a shíniú nó gan síniú. msh:

Teaghrán: Sainmhínítear cineálacha teaghráin cheana féin faoi chineálacha adamhach atá i gcineálacha.xml. I measc na gcineálacha teaghrán reatha tá téad octet, téad gualaigh, téad octet fhada agus teaghrán guaille fada m.sh.

Struchtúr: ainm: ainm an chineáil struchtúir. Is féidir le gach struchtúr míreanna iolracha a bhfuil ainm agus cineál a bhaineann leis. Is féidir leis an gcineál a bheith ar aon chineál réamhshainithe faoi chineálacha sonraí. msh:

17/35

XML Saincheaptha Tags le haghaidh Zigbee

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

Is féidir Cnuasaigh Chustaim a shainiú laistigh den chumróir tag. ainm: ainm an chnuasaigh fearainn: domain of the cluster. Taispeánfar an braisle san Chomhéadain ZAP faoin bhfearann seo. Cur síos: Cur síos ar an gcód braisle: cód braisle a shainiú: braisle shainiú a úsáideann gineadóir cód chun an braisle a shainiú ar bhealach áirithe monaróirCode: A úsáidtear chun braisle déantúsaíochta ar leith a shainiú. Caithfidh sé seo a bheith idir 0xfc00 - 0xffff. Is gá cód an mhonaróra don bhraisle a shainiú mar seo a leanas:

Déanann braisle déantúsaíochta na tréithe agus na horduithe faoi go huathoibríoch den chód monaróir céanna mura liostaíonn siad go sainráite cód an mhonaróra. introducedIn: Úsáidtear é chun an leagan sonrach inar tugadh isteach an bhraisle a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. removeIn: Úsáidte chun an leagan sonrúcháin inar baineadh an braisle a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. singleton(boolean): Úsáidtear é chun braisle a aimsiú mar shingil ionas nach bhfuil ach cás amháin den bhraisle sin roinnte thar na críochphointí. tréith: sainmhíníonn aitreabúid don ainm braisle : Luaitear ainm an aitreabúide idir an aitreabúid tag.
ainm aitreabúide
taobh(cliant/freastalaí): Taobh an bhraisle lena mbaineann an tréith freisin. cód: cód aitreabúide cód an mhonaróra: Is féidir é seo a úsáid chun tréith shainiúil an mhonaróra a shainiú lasmuigh den tsonraíocht zigbee atá luaite ag an xml caighdeánach. shainigh: tréith shainigh a úsáideann gineadóir cóid chun tréith a shainiú ar bhealach áirithe cineál: cineál an aitreabúide is féidir a bheith mar aon cheann de na cineálacha sonraí a luaitear sa réamhshocrú xml: luach réamhshocraithe don aitreabúid. nóim: Íosluach ceadaithe do aitreabúid uasta: Uasluach ceadaithe do aitreabúid inscríofa: An bhfuil luach na haitreabúide inscríofa nó nach bhfuil. Is féidir é seo a úsáid chun cosc a chur ar an tréith a mhodhnú trí orduithe a scríobh. roghnach(boolean): Úsáidtear é chun a fháil amach an bhfuil tréith roghnach nó nach bhfuil don bhraisle. nóim: Íosluach ceadaithe tréith nuair is slánuimhir, enum nó cineál léarscáile í. uas: Uasluach ceadaithe don aitreabúid nuair is slánuimhir, enum nó cineál giotánmap é: Úsáidtear é chun uasfhad an aitreabúide a shonrú nuair atá sé den chineál teaghrán. minLength: Úsáidtear é chun íosfhad an aitreabúide a shonrú agus é den chineál teaghrán. intuairiscithe(boolean): Insíonn sé má tá aitreabúid intuairiscithe nó nach bhfuilNullable(boolean): Ceadaíonn luachanna nialasach don aitreabúid. eagar(boolean): Úsáidtear é chun tréith de chineál eagar a dhearbhú. introducedIn: Úsáidtear é chun an leagan sonrach inar tugadh isteach an tréith a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. removedIn: Úsáidtear é chun an leagan sonrúcháin inar baineadh an tréith a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. ordú : sainigh ordú le haghaidh ainm braisle : Ainm an ordaithe.

cód: cód ordú

18/35

XML Saincheaptha Tags le haghaidh Zigbee
cód an déantóra: Is féidir é seo a úsáid chun ordú sonrach don mhonaróir a shainiú lasmuigh den tsonraíocht zigbee atá luaite leis an xml caighdeánach. tuairisc: cur síos ar fhoinse an ordaithe (cliant/freastalaí): foinse an ordaithe. roghnach (boolean): Úsáidtear é chun a chinneadh an bhfuil ordú roghnach nó nach bhfuil don bhraisle. introducedIn: Úsáidtear é chun an leagan sonrach inar tugadh an t-ordú isteach a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. removeIn: Úsáidtear é chun an leagan sonrach inar baineadh an t-ordú a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. argóintí ordaithe:
Is féidir sraith argóintí ordaithe a bheith ag gach ordú ainm: ainm an argóint ordaithe cineál: cineál argóint an ordaithe a d'fhéadfadh a bheith in aon cheann de na cineálacha a luaitear san xml. nóim: An luach íosta ceadaithe d'argóint nuair is cineál slánuimhir, enum nó léarscáil ghiotán í. uas: Uasluach ceadaithe d'argóint nuair is slánuimhir, enum nó fad cineál léarscáile í: Úsáidtear é chun an t-uasfhad incheadaithe le haghaidh argóint ordaithe a shonrú nuair is teaghrán cineáil í. minLength: Úsáidtear é chun an t-íosfhad incheadaithe le haghaidh argóint ordaithe a shonrú nuair is teaghrán cineáil é. eagar(boolean): Chun a chinneadh an bhfuil an argóint ordaithe de chineál eagar. presentIf(teaghrán): Is féidir seo a bheith ina teaghrán coinníollach d'oibríochtaí loighciúla bunaithe ar argóintí ordaithe eile inar féidir leat a bheith ag súil leis an argóint ordaithe má mheasann an teaghrán coinníollach a bheith fíor. msh:

Nóta: Anseo tá stádas ainm argóint ordaithe eile. roghnach (boolean): Úsáidtear é chun argóint an ordaithe a chinneadh mar roghnach. countArg: Úsáidtear é nuair is eagar cineáil an argóint ordaithe. Úsáidtear é seo chun an argóint ordaithe eile a lua a léiríonn méid an eagar don argóint seo.

introducedIn: Úsáidtear é chun an leagan sonrach inar tugadh an argóint ordaithe isteach a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. removedIn: Úsáidte chun an leagan sonrúcháin inar baineadh an argóint ordaithe a chinneadh. Úsáideann gineadóir cód é seo chun loighic bhreise a chur leis. Is féidir Síneadh Braisle a shainiú laistigh den chumróir tag. Úsáidtear síneadh braisle chun braisle caighdeánach a leathnú le tréithe agus orduithe déantúsaíochta m.sh

19/35

XML Saincheaptha Tags le haghaidh Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor” monaróirCode = ” 0 1002 ″>Sample Mfg Tréith Shonrach: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ cineál=”INT8U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor” monaróirCode = ” 0 1049 ″>Sample Mfg Tréith Shonrach: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ cineál=”INT8U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 00 ″ roghnach = ”fíor” monaróirCode = ” 0 1002 ″>Sample Mfg Tréith Shonrach: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ cineál=”INT16U” nóim=”0 0000″ max=”0xFFFF” inscríofa = “fíor” réamhshocraithe = ” 0 0000 ″ roghnach = ”fíor” monaróirCode = ” 0 1049 ″>Sample Mfg Tréith Shonrach: 0 0001 0 1040ampleMfgSpecificOffWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a chasann an gléas as le trasdul tugtha
faoin idirthréimhse san Ember Sample tréith ama aistrithe.ampleMfgSpecificOnWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a chuireann an gléas ar siúl le trasdul tugtha
faoin idirthréimhse san Ember Sample tréith ama aistrithe.ampleMfgSpecificToggleWithTransition” roghnach = “fíor” monaróirCode=”0 1002″> Ordú cliaint a scoránaigh an gléas le trasdul tugtha
faoin idirthréimhse san Ember Sample tréith ama aistrithe.ampleMfgSpecificOnWithTransition2″ roghnach=”fíor” monaróirCode=”0 1049″> Ordú cliaint a chuireann an gléas ar siúl le trasdul tugtha
faoin idirthréimhse san Ember Sample tréith ama aistrithe.ampleMfgSpecificToggleWithTransition2″ roghnach=”fíor” monaróirCode=”0 1049″> Ordú cliaint a scoránaigh an gléas le trasdul tugtha
faoin idirthréimhse san Ember Sample tréith ama aistrithe.

20/35

Cineálacha Ilghléasanna in aghaidh an chríochphointe

Is gné Ábhar Amháin é seo inar féidir le húsáideoir níos mó ná cineál gléas amháin a roghnú in aghaidh an chríochphointe. Má chuirtear ilchineálacha gléasanna aaa leis, cuirfear na cumraíochtaí braisle laistigh de na cineálacha gléasanna leis an gcumraíocht críochphointe.

21/35

Cineálacha Ilghléasanna in aghaidh an chríochphointe

Léiríonn an íomhá thuas go bhfuil níos mó ná cineálacha feiste amháin roghnaithe ag críochphointe 1. Léiríonn an “Gléas Príomhúil” an príomhchineál feiste a mbeidh baint ag an gcríochphointe leis. Bíonn an cineál feiste príomhúil i láthair i gcónaí ag innéacs 0 de liosta na gcineálacha feiste a roghnaítear agus mar sin má roghnaítear cineál feiste príomhúil eile athrófar ordú na gcineálacha feiste roghnaithe. Tá srianta ag baint leis na roghnúcháin cineáil feiste freisin bunaithe ar an tSamhail Sonraí. Cosnaíonn ZAP na húsáideoirí ó chomhcheangail neamhbhailí de chineálacha feiste a roghnú ar chríochphointe ag baint úsáide as na srianta seo.

22/35

Cineál Gléas Ábhar Leathanach Gné
Cineál Gléas Ábhar Leathanach Gné
Cineál Gléas Ábhar Leathanach Gné
Tacaíonn ZAP le gnéithe Matter a léirshamhlú agus a scoránú ar leathanach gné an chineáil ghléis. Ní thaispeánfar ach na gnéithe den chineál gléis atá sonraithe in matter-devices.xml sa stór CHIP.

Nascleanúint chuig an Leathanach Gné
ò Seoladh ZAP in Matter le Matter SDK cothrom le dáta. y Cruthaigh críochphointe le cineál feiste Matter. • Cliceáil ar an gcnaipe Gnéithe Cineál Gléas ar lár barr an bhraisle view. Tabhair faoi deara nach bhfuil an cnaipe seo ar fáil ach amháin i ZAP
cumraíochtaí le haghaidh Matter agus nuair atá sonraí comhlíonta sa Matter SDK. Má chliceálann tú ar an gcnaipe seo, osclófar an íomhá thuas.
Comhlíonadh
Sainmhíníonn Comhlíonadh roghnacht agus spleáchas maidir le tréithe, orduithe, imeachtaí agus cineálacha sonraí. Cinneann sé an bhfuil eilimint éigeantach, roghnach nó nach dtacaítear léi faoi chumraíochtaí áirithe ZAP.
Bíonn tosaíocht ag comhghéilleadh gné an chineáil ghléis thar chomhlíonta gné an bhraisle. Le haghaidh example, tá comhlíonadh roghnach ag an ngné Soilsithe sa bhraisle Ar/As ach dearbhaítear é a bheith éigeantach sa chineál gléas Solais Ar/As lena n-áirítear an bhraisle Ar/As. Nuair a chruthaítear críochphointe leis an gcineál gléis Solais Ar/Amach, léireofar an ghné Soilsithe mar ghné éigeantach ar an leathanach gné.
Gné Scoránaigh
Ar an leathanach gné, tar éis duit an cnaipe scoránaigh a chliceáil chun gné a chumasú nó a dhíchumasú, déanfaidh ZAP:
Nuashonraigh gnéithe gaolmhara (tréithe, orduithe, imeachtaí) chun comhlíonadh a cheartú, agus taispeáin dialóg a thaispeánann na hathruithe.

23/35

Gné-Leathanach Feiste Ábhar Nuashonraigh an giota gné san aitreabúid featureMap den bhraisle gaolmhar

Cumasaigh Comhphlé Gné

Díchumasaigh Comhphlé Gné

Tá scoránú díchumasaithe do roinnt gnéithe nuair a bhíonn luach anaithnid ag a gcomhlíonadh nó foirm t nach dtacaítear léi faoi láthair. Sa chás seo, léireoidh ZAP rabhaidh san aip fógra.
a Comhréireacht Eilimint Wa

Nuair a scorálann tú eilimint, féadfaidh ZAP rabhaidh comhlíonta gléas agus rabhaidh chomhlíonta araon a thaispeáint. Mura bhfuil staid na heiliminte ag teacht leis an gcomhlíonadh ionchais, taispeánfaidh ZAP deilbhín rabhaidh agus logálfaidh sé an rabhadh san ap nea fógra. examprabhaidh comhlíonta agus comhlíonta araon ar taispeáint le haghaidh eiliminte:

24/35

Fógraí
Fógraí
Fógraí
Sainmhínítear sa chuid seo a leanas conas a thugtar fógraí d’úsáideoirí ZAP san Chomhéadain.
Fógraí Pacáiste
Is éard atá i bhfógraí pacáiste ná na teachtaireachtaí rabhaidh nó earráide a bhaineann le haon phacáiste ar leith a lódáiltear isteach i ZAP. Le haghaidh example, sna híomhánna thíos, má chliceáiltear ar an deilbhín rabhaidh faoin gcolún stádais gheobhaidh tú dialóg a thaispeánfaidh gach fógra don phacáiste sin.

25/35

Fógraí
Fógraí Seisiúin
Is éard atá i bhfógraí seisiúin ná na teachtaireachtaí rabhaidh nó earráide a bhaineann le seisiún úsáideora. Is féidir na rabhaidh/earráidí seo a fheiceáil ach cliceáil ar an gcnaipe Fógraí sa bharra uirlisí ar bharr an Chomhéadain ZAP. Le haghaidh example, taispeánann an íomhá thíos an leathanach fógraí seisiúin tar éis isc file luchtaithe isteach ZAP.

26/35

Comhlíonadh Sonraíocht Sonraí-Samhail/ZCL
Comhlíonadh Sonraíocht Sonraí-Samhail/ZCL
Samhail Sonraí agus Comhlíonadh Sonraíochta ZCL
Cuidíonn an ghné seo i ZAP le húsáideoirí teipeanna comhlíonta le haghaidh Samhail Sonraí nó ZCL a fheiceáil lena bhfoirmíochtaí ZAP reatha. Beidh na teachtaireachtaí rabhaidh maidir le teipeanna comhlíonta le feiceáil ar an bpána Fógraí sa Chomhéadain ZAP agus déanfar iad a logáil freisin ar an gconsól agus ZAP á rith tríd an CLI. Soláthraíonn an ghné comhlíonta faoi láthair rabhaidh maidir le comhlíonadh cineál feiste agus comhlíonadh braisle ar chríochphointe.
Rabhaidh Comhlíonta san Chomhéadain ZAP
Nuair a osclaíonn úsáideoir .zap file ag baint úsáide as an Chomhéadain ZAP feicfidh siad rabhaidh i bpána fógraí Chomhéadain ZAP maidir le gach teip comhlíonta. Le haghaidh example, léiríonn an íomhá thíos an leathanach fógraí seisiúin tar éis .zap file osclaíodh é le saincheisteanna comhlíonta.

Imeoidh na teachtaireachtaí comhlíonta a luaithe a réitítear na saincheisteanna trí úsáid a bhaint as an Chomhéadain ZAP ionas gur féidir leat súil a choinneáil ar na saincheisteanna comhlíonta atá fágtha. Taispeánfar rabhaidh nua freisin maidir le comhlíonadh má dhíchumasaíonn úsáideoir gnéithe éigeantacha (cnuasach / orduithe / tréithe) den chumraíocht. Coinneoidh fógraí comhlíonta sonraíochtaí súil i gcónaí ar aon teipeanna a thugtar isteach i gcumraíocht ZAP ach tabhair faoi deara go bhfuil na rabhaidh a thaispeánfar le linn oscailt .zap file níos mine ar an bhfáth gur theip air comhlíonadh i gcomparáid leis na rabhaidh a thagann chun cinn agus iad ag idirghníomhú leis an Chomhéadain. De réir a dearadh a dhéantar é seo agus déantar seiceáil comhlíonta iomlán le linn oscailt .zap file.
Rabhaidh Comhlíonta ar an Consól

27/35

Comhlíonadh Sonraíocht Sonraí-Samhail/ZCL
Nuair a osclaíonn úsáideoir .zap file ag baint úsáide as an Chomhéadain neamhspleách ZAP nó an ZAP CLI feicfidh siad rabhaidh logáilte isteach sa chonsól / críochfort do gach teip comhlíonta. Le haghaidh example, taispeánann an íomhá thíos na rabhaidh fógra seisiúin ar an consól / críochfort tar éis .zap file osclaíodh é le saincheisteanna comhlíonta.

28/35

Rialú Rochtana

Gnéithe Rialaithe Rochtana
Tacaíonn ZAP le rialú rochtana ar gach aonán ZCL. Tá sé de dhualgas ar chur i bhfeidhm an SDK na gnéithe seo a mhapáil chuig na gnéithe SDK rialaithe rochtana atá ag teastáil agus tacaithe. Go ginearálta soláthraíonn ZAP samhail sonraí agus meicníocht chun é a ionchódú sa mheitea-fhaisnéis files agus na sonraí sin a iomadú chuig na teimpléid ghiniúna, gan bríonna sonracha a shannadh do na pointí sonraí.
Téarmaí Bunúsacha
Sainmhíníonn rialú rochtana ZAP trí bhunthéarma, mar a leanas: ò oibríocht : sainmhínithe mar rud is féidir a dhéanamh. example: léamh, scríobh, agairt. ó ról: a shainmhínítear mar phribhléid aisteoir. Mar “View pribhléid”, “Ról riaracháin”, agus mac ar. • mionathraitheoirí: arna sainiú mar choinníollacha rialaithe rochtana speisialta, amhail sonraí atá íogair ó thaobh fabraice nó sonraí scóipe fabraice. Sainmhínítear na buntéarmaí sna meiteashonraí XML faoi bharr tag . Seo a leanas seanampsainmhínithe buntéarmaí rialaithe rochtana:
<role type=”view" tuairisc = "View pribhléid”/>
Seo seanampsainmhíníonn le trí oibríocht, léamh, scríobh agus agairt, dhá mhodhnóir agus ceithre ról.
Triplets Rochtana
Is féidir gach coinníoll rochtana aonair a shainiú le triplet rochtana san XML. Is meascán d’oibríocht, de ról agus de mhodhnóir é triplet rochtana. Tá siad roghnach, mar sin ní féidir leat ach ceann amháin díobh seo a bheith agat. Is gnách go gciallaíonn cuid den triplet atá ar iarraidh ceadanna, atá sainiúil don chur i bhfeidhm don SDK tugtha. Is féidir le haonán a shainíonn a rochtain triplet rochtana amháin nó níos mó a bheith aige. Seo a leanas seanample:
ag0
Is sainmhíniú é seo ar tréith a bhfuil triplet rochtana aige, ag dearbhú go gceadaíonn sé oibriú scríofa de réir ról bainistithe, agus modhnóir scóip fabraice i bhfeidhm.
Ceadanna Réamhshocraithe

29/35

Rialú Rochtana
Is féidir le haonáin ZCL a gceadanna aonair féin a shainiú. Mar sin féin, tá sainmhíniú domhanda ann freisin ar cheadanna réamhshocraithe le haghaidh
cineálacha tugtha. Glactar leis seo don aonán ar leith, mura soláthraíonn sé aon cheadanna sonracha dá chuid féin.
Déantar ceadanna réamhshocraithe a dhearbhú trí a tag ag barrleibhéal an XML file. example:
aa a< ccess op = “invoke”/> a a aa < ccess op = ”re d” /> a< ccess op = ”scríobh”/> a aa aa < ccess op = ”re d” ról =”view”/> aa < ccess op=”write” role=”oper te”/> a
Cúntóirí Teimpléad
Is é {{#access}} … {{/access}} an cúntóir teimpléid bhunúsach le húsáid. Déanann an t-athrialóir seo atriallta thar na triplets rochtana ar fad a thugtar.
Tacaíonn sé leis an dá rogha seo a leanas:
eintiteas = “tréith/ordú/imeacht” – murar féidir an t-aonán a chinneadh ón gcomhthéacs, socraíonn sé seo an cineál aonáin. includeDefault = “fíor/bréagach” – socraítear an gcuirtear luachanna réamhshocraithe san áireamh nó nach gcuirtear. Seo a leanas seanample:
{{#zcl_clusters}}
a Braisle: {{ n me}} [{{code}}] a {{#zcl_ ttributes}} aa – ttribute: {{ n me}} [{{code}}] aa {{# ccess eintiteas="ttribute"}}
O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{code}}] aa {{# ccess entity=”comm nd”}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – imeacht: {{ n me}} [{{code}}] a {{# ccess eintiteas="imeacht" }} O a RM a M * p: {{oper tion}} / ole: {{ role}} / odifier: {{ ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Ag seoladh ZAP le haghaidh feidhmchláir Matter nó Zigbee
Ag seoladh ZAP le haghaidh feidhmchláir Matter nó Zigbee
Ag seoladh ZAP le haghaidh Feidhmchláir Matter nó Zigbee
Déanann na hailt seo a leanas cur síos ar ZAP a sheoladh i mód aonair leis na meiteashonraí Matter nó Zigbee-sonrach. Is é an smaoineamh ZAP a sheoladh leis na hargóintí cearta a bhaineann le meiteashonraí XML (na braislí agus sainmhínithe cineálacha gléas de réir na sonraíochtaí CSA) agus na teimpléid ghiniúna, a úsáidtear chun an cód cuí a ghiniúint.
Ag seoladh ZAP with Matter
Roghnaíonn an script seo a leanas na meiteashonraí cearta ón Matter SDK agus ZAP á sheoladh. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Nóta: Is féidir leat an cur chuige Zigbee seo a leanas a ghlacadh freisin chun ZAP in Matter a sheoladh.
Ag seoladh ZAP le Zigbee
Seolann an t-ordú seo a leanas ZAP leis na sonraíochtaí ZCL agus teimpléid giniúna ón 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: Seo é an cosán chuig foinse ZAP nó cosán sdk inrite: Seo é an cosán chuig an SDK
Ag seoladh ZAP gan Meiteashonraí
Cuimhnigh, agus ZAP á sheoladh go díreach trí fhoinse inrite nó ón bhfoinse ag baint úsáide as npm run zap tá tú ag seoladh ZAP le meiteashonraí tástála don Matter/Zigbee ionsuite laistigh de ZAP agus ní na meiteashonraí iarbhír a thagann ó na SDK Matter agus Zigbee atá luaite thuas. Mar sin, cuimhnigh ar do chuid cumraíochtaí ZAP a chruthú trí úsáid a bhaint as meiteashonraí SDK agus ní trí ZAP a oscailt go díreach leis na meiteashonraí tástála ionsuite.

31/35

Cód a ghiniúint do Matter nó Zigbee

Cód a Ghiniúint don Ábhar, Zigbee nó SDK Saincheaptha
Déanann na hailt seo a leanas cur síos ar conas cód a ghiniúint ag baint úsáide as ZAP.
Gin Cód Ag Úsáid Chomhéadain ZAP
Seol an Chomhéadain ZAP de réir na dtreoracha i Seoladh ZAP for Matter nó Zigbee agus cliceáil ar an Gin cnaipe sa bharra roghchláir barr.
Gin Cód gan an Chomhéadain
Soláthraíonn na treoracha seo a leanas bealaí éagsúla chun cód a ghiniúint trí CLI gan an Chomhéadain ZAP a sheoladh.
Cód a Ghiniúint ó Fhoinse ZAP
Rith an t-ordú seo a leanas chun cód a ghiniúint ag baint úsáide as ZAP ón bhfoinse: nód 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
Cód a Ghiniúint ó ZAP Inrite
Rith an t-ordú seo a leanas chun cód a ghiniúint ag baint úsáide as ZAP inrite: [zap-path] giniúint -genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
teimpléid.json -i ./test/resource/three-endpoint-device.zap -o ./tmp
Cód a Ghiniúint ó ZAP CLI Inrite
Rith an t-ordú seo a leanas chun cód a ghiniúint ag baint úsáide as ZAP CLI Inrite: [zap-cli-path] giniúint -genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
teimpléid.json -i ./test/resource/three-endpoint-device.zap -o ./tmp

32/35

Nuashonraigh ZAP sa Stiúideo

Nuashonraigh ZAP
Nuashonraigh ZAP i Simplicity Studio
Is féidir an meicníocht seo a úsáid agus tú ag obair le síneadh Matter nó Zigbee ó eisiúintí SDK Silicon Labs. Is féidir ZAP a nuashonrú laistigh de Simplicity Studio gan scaoileadh Simplicity Studio tríd an inrite ZAP is déanaí (molta) a íoslódáil nó an ceann is déanaí a tharraingt ó fhoinse ZAP mar a thaispeántar i ZAP Installation Guide. Tar éis duit an ZAP is déanaí a bheith agat bunaithe ar an OS a úsáidtear faoi láthair, is féidir leat ZAP a nuashonrú laistigh de Studio mar phacáiste oiriúnaitheora. Lean na treoracha thíos tar éis duit an ZAP is déanaí a íoslódáil:
Téigh go Simplicity Studio agus roghnaigh Preferences > Simplicity Studio > Adapter Packs. Cliceáil Add… agus brabhsáil chuig an bhfillteán ZAP méadaithe a d’íoslódáil tú agus cliceáil Roghnaigh Fillteán . Cliceáil Cuir i bhFeidhm agus Dún agus ansin úsáidfear an ZAP nua-chur leis aon uair a .zap file osclaítear.
Nóta: Uaireanta d'fhéadfadh go mbeadh cásanna níos sine de ZAP ag rith cheana féin fiú tar éis nuashonrú go dtí an ZAP is déanaí. Déan cinnte deireadh a chur le gach cás ZAP atá ann cheana féin ionas go n-úsáidtear an ZAP nua-aimsithe in ionad sean-áis, atá fós ag obair sa chúlra.
Nuashonraigh ZAP le haghaidh Forbairt Ábhar i Github
Agus tú ag obair le hathróga Matter or Matter-Silicon Labs ar Github, socraigh na hathróga timpeallachta maidir le ZAP chun cumraíochtaí ZAP nua a chruthú/a ghiniúint nó chun s atá ann cheana a athghiniúintample cumraíochtaí ZAP tar éis athruithe a chur i bhfeidhm orthu. Socraigh an ZAP_DEVELOPMENT_PATH go ZAP ón bhfoinse tríd an gceann is déanaí a tharraingt nó socraigh ZAP_INSTALLATION_PATH go ZAP inrite a d'íoslódáil tú go deireanach i d'eolaire áitiúil. Tabhair faoi deara nuair a shocraítear ZAP_DEVELOPMENT_PATH agus ZAP_INSTALLATION_PATH, úsáidtear ZAP_DEVELOPMENT_PATH.
Seo a leanas exampníos lú a thaispeánann na hathróga timpeallachta thuas in úsáid:
ZAP á sheoladh ag baint úsáide as sonraíocht Ábhar Athghiniúint na sample cumraíochtaí ZAP d'fheidhmchláir Matter
Tabhair faoi deara: Nuair a bhíonn earraí inrite ZAP á n-úsáid agat, cinntigh go bhfuil tú ag baint úsáide as scaoileadh oifigiúil thar scaoileadh oíche le haghaidh níos mó cobhsaíochta. Féach
Íoslódáil an Treoir Suiteála ZAP Inrite i ZAP

33/35

Ilphrótacal comhthráthach idir Zigbee agus Matter
Ilphrótacal comhthráthach idir Zigbee agus Matter
MCoanttceurrrent Ilphrótacal idir Zigbee agus
Is féidir ZAP a úsáid chun cumraíochtaí ZCL (Zigbee) agus Data-Model (Matter) a chumrú in feidhmchlár ilphrótacal do Zigbee and Matter. Ligeann ZAP duit críochphointí a chruthú do Zigbee agus Matter go sainráite sa chumraíocht chéanna file. Má tá críochphointí Zigbee agus Matter ar an Aitheantóir críochphointe céanna (le haghaidh example, LO Dimmable Light ar chríochphointe Id 1 agus Matter Dimmable Light ar shampla eile de chríochphointe 1), déanann ZAP aire do na tréithe coitianta a shioncronú ar fud na tréithe Matter agus Zigbee. Cinntigh go bhfuil an cineál sonraí céanna ag na tréithe atá á sioncronú. Bunaítear na tréithe coitianta idir Zigbee agus Matter trí a file ar a dtugtar multi-protocol.json . Is féidir leis an úsáideoir dhá bhraisle ar bith a nascadh trasna Zigbee agus Matter mar aon lena tréithe comhfhreagracha ag baint úsáide as na cóid bhraisle agus aitreabúide faoi seach. seo file le fáil in [SDKPath]/app/zcl/multi-protocol.json . seo file nuashonraíodh é le sraith áirithe braislí agus tréithe ar dtús, ach is féidir leis an úsáideoir é seo a nuashonrú file de réir mar is gá agus tabharfaidh ZAP aire do chumraíocht na tréithe a shioncronú trasna Zigbee agus Matter le haghaidh aitheantóirí críochphointe coitianta.
Is féidir leat teagaisc ZAP a fháil freisin in aon fheidhmchlár ilphrótacal Zigbee and Matter faoi leathanach na ranganna teagaisc. Treoróidh an rang teagaisc seo tú tríd an bpróiseas cruthaithe iarratais ilphrótacal. Níl an rang teagaisc seo ar fáil ach amháin nuair a osclaíonn tú feidhmchlár ilphrótacal atá ann cheana féin agus is féidir é a fháil mar a thaispeántar san íomhá thíos:

34/35

Comhtháthaigh SLC CLI le ZAP
Comhtháthaigh SLC CLI le ZAP
Comhtháthaigh SLC CLI le ZAP
Lean na céimeanna seo chun an SLC CLI a chomhtháthú le ZAP: ò Suiteáil SLC CLI trí na treoracha suiteála a leanúint sa Treoir Úsáideora Simplicity Studio 5. y Suiteáil ZAP trí na treoracha sa Treoir Suiteála ZAP a leanúint. ô Chun SLC CLI a chomhtháthú le ZAP, cuir athróg timpeallachta STUDIO_ADAPTER_PACK_PATH a dhíríonn ar an bhfeidhmchlár ZAP leis
eolaire. õ Cuimhnigh Deamhan SLC CLI a atosú tar éis chéim 3. ö Bainfidh aon tionscadal a úsáideann ZAP úsáid as an gcosán atá sainmhínithe i gcéim 3 anois nuair a ghinfear é ó SLC CLI. Déan tagairt le do thoil do SLC CLI
Úsáid le haghaidh treoracha ar úsáid SLC CLI do do thionscadail.

35/35

Doiciméid / Acmhainní

SABHAR SILICÓN ZAP Ag Forbairt Le Saotharlanna Sileacain [pdfLámhleabhar Úinéara
ZAP Ag Forbairt Le Saotharlanna Sileacain, ZAP, Ag Forbairt Le Saotharlanna Sileacain, Saotharlanna Sileacain, Saotharlanna

Tagairtí

Lámhleabhar Úsáideora

ZAP ag Forbairt Le Saotharlanna Sileacain

Sonraíochtaí

Treoracha Úsáide Táirge

CCanna

Ag forbairt le Silicon Labs ZAP

ZAP Ag Tosú

Suiteáil ZAP

Bunúsacha ZAP

XML Saincheaptha

XML Saincheaptha Tags le haghaidh Zigbee

Cineálacha Ilghléasanna in aghaidh an chríochphointe

Rialú Rochtana

Cód a ghiniúint do Matter nó Zigbee

Nuashonraigh ZAP sa Stiúideo

Doiciméid / Acmhainní

Tagairtí

Fág trácht

Cealaigh freagra