ZAP A’ Leasachadh Le Leabhar-làimhe Sealbhadair Silicon Labs

ZAP a’ tòiseachadh
- Gus tòiseachadh le ZAP, lean na ceumannan seo:
  - Luchdaich sìos ZAP Executable bho làrach-lìn oifigeil.
  - Stàlaich na h-eisimeileachd le bhith a’ cleachdadh àithne stàlaidh npm.
  - Airson stàladh a tha sònraichte do Windows, thoir sùil air an stiùireadh ZAP Installation for Windows OS.
Leasachadh Zigbee
- Ma tha thu a’ leasachadh thagraidhean Zigbee:
  - Cleachd Simplicity Studio anns a bheil ZAP agus innealan riatanach eile.

Leasachadh Cùisean
- Ma tha thu a’ leasachadh thagraidhean Matter:
  - Am measg nan roghainnean tha cleachdadh Simplicity Studio no faighinn gu stòran Silicon Labs no CSA Github.
  - Thoir sùil air an stiùireadh ùrachaidh airson ZAP taobh a-muigh cearcall fuasglaidh Simplicity Studio ma tha feum air.

Ceistean Cumanta

C: Dè na dreachan eadar-dhealaichte de ZAP binaries a tha rim faighinn?
- A: Tha dà dhreach ri fhaighinn - Foillseachadh oifigeil le togalaichean dearbhte agus ro-sgaoileadh leis na feartan as ùire.

C: Dè bu chòir dhomh a dhèanamh ma choinnicheas mi ri duilgheadasan cruinneachaidh leabharlann dùthchasach rè an stàladh?
- A: Thoir sùil air an fhiosrachadh Ceistean Cumanta mu sgriobtaichean àrd-ùrlar sònraichte gus fuasgladh fhaighinn air cùisean mar sin.

“`

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

A’ leasachadh le Silicon Labs ZAP

Toiseach tòiseachaidh
ZAP a’ tòiseachadh thairisview Stàladh ZAP Stàladh ZAP Windows Ceistean Cumanta
Bun-bheachdan ZAP Basics
Stiùireadh Cleachdaiche ZAP Stiùireadh Cleachdaiche Thairisview Custom XML Custom XML Tags airson Zigbee Seòrsaichean ioma-inneal gach seòrsa inneal cùis-crìochnachaidh feart feart Duilleag fiosan-modail dàta / Sònrachadh ZCL gèilleadh smachd ruigsinneachd A’ cur air bhog ZAP airson tagraidhean Matter no Zigbee A’ gineadh còd airson Matter or Zigbee Update ZAP ann an Studio Concurrent Multi-protocol eadar Zigbee agus Matter Integrate SLC CLI le ZAP

1/35

A’ leasachadh le Silicon Labs ZAP
A’ leasachadh le Silicon Labs ZAP
ZAP
Tha ZAP na einnsean gineadh còd coitcheann agus eadar-aghaidh cleachdaiche airson tagraidhean agus leabharlannan stèidhichte air Leabharlann Zigbee Cluster bho Zigbee no am Model Data from Matter. Tha an sònrachadh air a leasachadh leis a’ Chaidreachas Inbhean Ceangalachd. Leigidh ZAP leat na h-obraichean a leanas a dhèanamh:
Dèan gineadh gnàthaichte sònraichte SDK de gach artifact cruinneil (seasmhachan, seòrsaichean, IDan, agus mar sin air adhart) stèidhichte air sònrachadh ZCL / Data-Model. Dèan gineadh gnàthaichte sònraichte SDK de gach artifact rèiteachaidh a thagh an neach-cleachdaidh (rèiteachadh tagraidh, rèiteachadh endpoint, agus mar sin air adhart) stèidhichte air sònrachadh ZCL / Data-Model agus rèiteachadh tagraidh air a sholarachadh le teachdaiche. Thoir seachad UI don neach-cleachdaidh deireannach gus rèiteachadh tagraidh sònraichte a thaghadh (puingean crìochnachaidh, cruinneachaidhean, buadhan, òrdughan, agus mar sin air adhart).

Tha an susbaint anns na h-earrannan seo a’ toirt cunntas air mar a leasaicheas tu tagraidhean Zigbee and Matter le bhith a’ rèiteachadh na sreathan ZCL (Zigbee) no Model Data (Matter) a’ cleachdadh ZAP.

2/35

ZAP a’ tòiseachadh

ZAP a’ tòiseachadh
A’ tòiseachadh le ZAP
Tha na h-earrannan sin a’ toirt cunntas air diofar dhòighean air tagraidhean Zigbee and Matter a chruthachadh. Thoir an aire gu bheil Simplicity Studio a’ toirt seachad dòigh air na tagraidhean Zigbee and Matter agad a chruthachadh bho cheann gu ceann far am bi a h-uile inneal air a chuir a-steach ro-làimh còmhla ri Simplicity Studio (a’ toirt a-steach ZAP). Faodaidh tu cuideachd co-dhùnadh dòighean eile a sgrùdadh gus na h-aplacaidean agad a chruthachadh, mar a tha air a mhìneachadh an seo.
Leasachadh Zigbee
Faodaidh luchd-leasachaidh tagradh Zigbee na tagraidhean aca a thogail a’ cleachdadh Simplicity Studio, a tha mar-thà a’ toirt a-steach ZAP agus innealan eile a chuidicheas tu gus an tagradh agad a thogail bho cheann gu ceann.
Leasachadh Cùisean
Faodaidh luchd-leasachaidh Iarrtas Matter na h-iarrtasan aca a thogail a’ cleachdadh na dòighean a leanas: Simplicity Studio: Tha seo a’ toirt a-steach ZAP agus innealan eile a tha a dhìth gus an tagradh Matter a thogail deireadh gu deireadh. Github (Silicon Labs) Github (CSA)
Nota: Gus ZAP ùrachadh taobh a-muigh cearcall fuasglaidh Simplicity Studio, faic ùrachadh ZAP ann an Simplicity Studio agus ZAP Installation Guide

3/35

Stàladh ZAP

Tha na h-earrannan a leanas a’ toirt cunntas air stàladh ZAP agus mar as urrainn dhut ZAP ùrachadh ann an Simplicity Studio IDE.
A’ luchdachadh sìos an ZAP Executable air a mholadh)
Is e seo an dòigh a thathar a’ moladh airson tòiseachadh le ZAP. Gheibh thu na binaries ZAP as ùire bho aa https://github.com/project-chip/zp/releses. Bidh binaries ro-thogte a’ tighinn ann an dà dhreach eadar-dhealaichte.
Foillseachadh oifigeil: Togail dearbhte le seòmraichean deuchainn sònraichte Matter agus Zigbee. Is e cruth an ainm fuasglaidh vYYYY.DD.MM. Ro-sgaoileadh: A’ togail leis na feartan as ùire agus rèiteachadh bug ach CHAN EIL na togalaichean sin air an dearbhadh le seòmraichean deuchainn sònraichte Matter agus Zigbee. Tha cruth an ainm fuasglaidh vYYYY.DD.MM-oidhche.
A’ stàladh ZAP bho Stòr
Stiùireadh bunaiteach airson ZAP a stàladh
Leis gur e tagradh node.js a tha seo, feumaidh tu an àrainneachd nód air a chuir a-steach. Is e an dòigh as fheàrr air seo a dhèanamh luchdaich sìos an stàladh as ùire de nód, a tha a’ toirt a-steach nód agus npm. Ma tha dreach nas sine de nód agad air a chuir a-steach air an ionad-obrach agad, dh’ fhaodadh e cùisean adhbhrachadh, gu sònraichte ma tha e gu math sean. Dèan cinnteach gu bheil an tionndadh nód v16.x as ùire agad leis an npm a tha air a ghabhail a-steach. Ruith nód -version gus faighinn a-mach dè an dreach a thèid a thogail. v18.x air a mholadh. Às deidh dhut an dreach de nód a tha thu ag iarraidh, faodaidh tu na leanas a ruith:
Stàlaich na Dependencies
Cleachd na h-òrdughan a leanas gus eisimeileachd a stàladh:

npm a stàladh
Nota: Airson stàladh ZAP a tha sònraichte do Windows, faic Stàladh ZAP airson Windows OS Chan eil e neo-àbhaisteach ruith a-steach do dhuilgheadasan cruinneachaidh leabharlann dùthchasach aig an ìre seo. Tha grunn sgriobtaichean src-script/install-* ann airson diofar àrd-ùrlaran. Faic fiosrachadh Ceistean Cumanta mu dè an sgriobt a thèid a ruith air diofar àrd-ùrlaran agus an uairsin ath-ruith npm install .
Tòisich an Iarrtas
Cleachd na h-òrdughan a leanas gus an tagradh a thòiseachadh:

npm ruith zap
Tòisich a’ cheann-aghaidh ann am modh leasachaidh
A ’toirt taic do ath-luchdachadh còd teth, aithris mhearachdan, agus mar sin air adhart. Cleachd na h-òrdughan a leanas gus tòiseachadh air a’ cheann-aghaidh ann an leasachadh
modh:
quasar dev -m dealanach
or

4/35

ZAP Insta no ll a-steach
npm ruith electron-dev

5/35

ZAP stàladh Windows
ZAP stàladh Windows
Stàladh ZAP airson Windows OS
1. Windows Powershell
Anns a ’bhàr sgrùdaidh deasg, cuir a-steach Windows Powershell agus ruith mar rianadair. Ruith na h-òrdughan a leanas taobh a-staigh Powershell.
2. Seoclaid
Stàlaich bho https://chocolatey.org/install. Dèan cinnteach a bheil e air a stàladh ceart leis na h-òrdughan a leanas:
choco -v
Stàlaich pasgan pkgconfiglite leis na h-òrdughan a leanas:
choco stàladh pkgconfiglite
3. Stàlaich Node
Ruith na h-òrdughan a leanas airson a stàladh:
choco stàladh nodejs-lts
* Feumaidh an dreach a bhith 18 gus a dhol seachad air deuchainn dearbhaidh dreach, às deidh an stàladh, thoir sùil le nód -v * Ma tha thu air Node a chuir a-steach mu thràth, agus ma dh’ fhàillig thu cuid de dheuchainnean coltach ris nach urrainn Node a lorg, ath-stàlaich Node le chocolatey a-rithist.
4. Lean an Stiùireadh Bunaiteach airson ZAP a stàladh
Lean an stiùireadh stàlaidh ZAP bhon stòr ann an ZAP Installation. Fhad ‘s a leanas tu an stiùireadh bunaiteach airson stàladh ZAP cùm sùil a-mach airson na mearachdan a leanas agus mar a bu chòir dhut am fuasgladh:
sgith 3
Nuair a bhios tu a’ ruith ZAP (me, npm run zap ), ma chì thu mearachd mu sqlite3.node ann an uinneag pop-up, ruith:
npm ath-thogail sqlite3
neach-togail dealanach
Nuair a bhios tu a’ dèanamh npm install, ann an post-stàladh, ma thachras mearachd air an àithne a leanas co-cheangailte ri install-appdeps electronbuilder , npx electron-rebuild canabhas air fàiligeadh no node-pre-gyp , chan eil an tionndadh canabhas gnàthach co-chòrdail ri Windows agus cha adhbharaich mearachd an stàlaidh fàilligeadh ann an ruith ZAP. tha node-canvas ag obair air an fhuasgladh a-nis agus thèid a’ chùis fhuasgladh a dh’ aithghearr.
“postinstall”: “electron-builder install-app-deps && husky install && npm ath-thogail canabhas -update-binary && npm run version-stamp”

6/35

ZAP stàladh Windows
Canabhas
Ma dh’ fhailicheas npm run test air sgàth mearachd dh’fhàillig an t-sreath deuchainn ruith. Chan urrainn dhuinn modal '../build/Release/canvas.node' a lorg no
zapnode_modulescanvasbuildReleasecanvas.node Chan e tagradh Win32 dligheach a th’ ann. , ath-thog canabhas mar a leanas:
npm ath-thogail canabhas - ùrachadh-binary
faigh index.html no Cùisean Frithealaiche eile
Ma dh’ fhailicheas deuchainn ruith npm air sgàth na mearachd faigh iarrtas index.html air fàiligeadh le còd inbhe 404 ann an deuchainnean aonaid no ma tha frithealaiche agad
cùisean ceangail ann an deuchainnean e2e-ci, ruith na h-òrdughan a leanas:
npm ruith togail
Eile
Dèan cinnteach a bheil an tionndadh nód v18 agus feuch ris a stàladh le Chocolatey.

7/35

Ceistean Cumanta
Ceistean Cumanta
Ceistean Cumanta
C: Ciamar a thòisicheas tu UI ann am modh leasachaidh? A: Faodaidh tu an UI a thòiseachadh ann am modh leasachaidh, a thig gu suidheachadh a leanas:
Frithealaiche HTTP leasachaidh quasar air leth, a bhios ag ùrachadh beò air port 8080 ZAP deireadh cùil a ’ruith air port 9070 Chrome no brobhsair eile, a’ ruith gu neo-eisimeileach Gus faighinn chun stèidheachadh sin, lean an stiùireadh gu h-ìosal. ò An toiseach, ruith am frithealaiche leasachaidh ZAP, a thòisicheas air port 9070.
npm run zap-devserver o Next, ruith am frithealaiche leasachaidh quasar, a thòisicheas air port 8080.
quasar dev ô Comharraich do bhrobhsair no ruith fear mu choinneamh an tè cheart URL leis an argamaid restPort:
google-chrome http://localhost:8080/?restPort=9070

C: Ciamar a bheir seo air obrachadh air Mac/Linux OS? A:
npm install air a chleachdadh gus a h-uile pasgan eisimeileachd a tha a dhìth a luchdachadh sìos. Ma chì thu mearachdan co-cheangailte ri nód-gyp agus leabharlannan ionadail a tha a dhìth, leithid pixman , agus mar sin air adhart, tha thu ag ionndrainn eisimeileachd dùthchasach gus a bhith riaraichte gus binaries nód neo-thogte a chuir ri chèile airson measgachadh de àrd-ùrlaran agus dreachan. Tha Npm air an sgòth an-còmhnaidh ag ùrachadh an liosta de binaries a chaidh a thoirt seachad, agus mar sin tha e comasach gun tog thu iad ceart gu leòr, ach mura dèan thu sin, is iad seo stiùireadh airson diofar àrd-ùrlaran:
Fedora Core le dnf:
dnf stàlaich pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
no ruith sgriobt:
src-script/install-packages-fedora
Ubuntu le apt-get :
apt-faigh ùrachadh apt-faigh install -fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
no ruith sgriobt:

8/35

Ceistean Cumanta
src-script/install-packages-ubuntu
OSX air Mac le brew Homebrew:
brew install pkg-config cairo pango libpng jpeg giflib librsvg
no ruith sgriobt:
src-script/install-packages-osx
C: Ciamar a bheir thu air seo obrachadh air Windows OS?
F: Dèan cinnteach gu bheil e an-còmhnaidh ùraichte agus nach eil atharrachaidhean sam bith ann nach deach a ghealltainn. Gliocas: is e git pull, git status & git stash do charaidean. Feumaidh tu Chocolately a chleachdadh gus toirt air Zap obrachadh air Windows OS. Dèan cinnteach gun luchdaich thu sìos am pasgan pkgconfiglite.
choco stàladh pkgconfiglite
Ma tha duilgheadasan agad le Cairo, airson example if you get an error about Cairo.h' : No such file no eòlaire, dèan na leanas: ò Dèan cinnteach a bheil an coimpiutair agad 32 neo 64 bit. y A rèir sin, luchdaich sìos am pasgan iomchaidh bhon làrach 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:
Cliog air Roghainnean an t-siostaim adhartach. Anns an taba adhartach cliog air Caochlaidhean Àrainneachd. Anns an roinn System Variables, lorg caochladair àrainneachd PATH agus tagh e. Cliog Deasaich agus cuir C:/GTK ris. Mura h-eil an caochladair àrainneachd PATH ann, cliog Ùr. Mura lorgar jpeglib.h, feuch na leanas: ò Air an inneal-crìochnachaidh, ruith: choco install libjpeg-turbo ó Dèan cinnteach gu bheil e glan le bhith a’ cleachdadh: git clean -dxff agus ruith npm install again ô mura tachair mearachdan is nach nochd ach rabhaidhean, feuch ri npm audit fix õ a chleachdadh mura h-urrainn dhut ZAP a ruith, rach gu file src-script/zap-start.js ö Atharraich
÷ const { spawn } = feum ('cross-spawn') gus const { spawn } = feum ('child_process') ø Ruith npm agus ruith zap. Iomraidhean:
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: Tha mi a’ faighinn mearachd “sqlite3_node” nach deach a lorg no a leithid.

9/35

Ceistean Cumanta
A: Ath-thog na ceanglaichean dùthchasach sqlite3 agad. Gus seo a rèiteachadh sa mhòr-chuid de chùisean, ruith:
npm a stàladh
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Mura h-eil e fhathast air a rèiteachadh, dèan:
rm -rf node_modules agus an uairsin feuch na h-òrdughan gu h-àrd a-rithist. Bho àm gu àm bidh ùrachadh do npm a’ dèanamh eadar-dhealachadh cuideachd:
npm stàladh -g npm
C: Tha mi a’ faighinn mearachd “’S e 1 an tionndadh N-API den eisimpleir Node seo. Tha am modal seo a’ toirt taic do dhreach(an) N-API 3. Chan urrainn dhan eisimpleir Node seo am modal seo a ruith.”
A: Àrdaich an tionndadh nod agad. Tha am fuasgladh airson seo air a dheasbad anns an t-snàthainn Stack Overflow seo: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
C: Chan eil am PC leasachaidh agam ag obair le ZAP airson adhbhar sam bith. Am faod mi soitheach docker a chleachdadh?
A: 'S urrainn dhut. TBD.
C: Ciamar a ruitheas mi ZAP taobh a-staigh VSCCode?
A: Ma tha VSCode agad nad shlighe cuir a-steach an zap repo agus dèan an còd . Fosglaidh seo ZAP ann an VSCcode. Gus ZAP a ruith ann am modh deasbaid, tagh àite-obrach ZAP agus cliog air an ìomhaigh Run air a’ bhàr-inneal air an taobh chlì. Bidh roghainn no dhà agad airson taghadh bho bhith a’ ruith ZAP, tagh Node.js Debug Terminal . Fosglaidh seo uinneag crìochnachaidh às an urrainn dhut a dhol a-steach npm run zap , a cheanglas an dì-bhugadair agus a ruitheas ZAP mar a bhiodh tu mar as àbhaist bhon loidhne-àithne. Mealaibh ur naidheachd, bu chòir dhut a-nis ZAP fhaicinn a’ ruith anns an debugger. Faodaidh tu puingean brisidh a shuidheachadh ann an Còd VSC mar a dhèanadh tu ann an IDE sam bith eile.
C: Bidh deuchainn aonad UI a’ fàiligeadh le cuid de mhearachdan timcheall air canabhas nach deach a thogail airson an dreach ceart de nód. Dè nì mi?
A: Ma chì thu am mearachd a leanas:
FAIL test/ui.test.js Dh'fhàillig an t-sreath deuchainn a ruith Chaidh am modal 'canvas.node' a chur ri chèile mu choinneamh tionndadh Node.js eile a' cleachdadh NODE_MODULE_VERSION 80. Feumaidh an tionndadh seo de Node.js NODE_MODULE_VERSION 72. Feuch ris a' mhodal 'canvas.node' ath-chur ri chèile no ath-stàladh (mar eisimpleir, a' cleachdadh `n repmbuild, a' cleachdadh `n repmbuild).
aig Rud. (node_modules/canvas/lib/bindings.js:3 18)
an uairsin ruith: npm ath-thogail canabhas -update-binary

10/35

Bun-bheachdan ZAP

ZCL/Model Dàta Bun-stèidh ZAP
Anns an roinn seo tha fiosrachadh airson luchd-cleachdaidh ZAP ùr. Cliog air an ìomhaigh oideachaidh air an oisean gu h-àrd air an làimh dheis den ZAP UI, a sheallas mar a chruthaicheas tu rèiteachadh ZAP. Bidh an oideachadh gad stiùireadh tro na leanas: Cruthaich crìoch-phuing Tagh seòrsa inneal Dèan rèiteachadh air brabhsair Dèan rèiteachadh air feart Dèan òrdugh Airson fiosrachadh mionaideach, faic Zigbee Cluster Configurator Guide

11/35

Leabhar-iùil cleachdaiche ZAP
Leabhar-iùil cleachdaiche ZAP
Leabhar-iùil cleachdaiche ZAP
Tha na h-earrannan fon stiùireadh seo a’ toirt seachad barrachd fiosrachaidh mu na diofar fheartan a thug ZAP seachad.

12/35

Custom XML

A’ cur Custom XML ris bhon ZAP UI
Cliog air ìomhaigh “Leudachadh” anns an ZAP UI. Cliog air a’ phutan “+” cuir ris gus xml àbhaisteach a thaghadh file Bu chòir na cruinneachaidhean àbhaisteach, buadhan, òrdughan, msaa nochdadh anns an ZAP UI aon uair ‘s gu bheil an xml àbhaisteach air a chur ris.
A’ cruthachadh an XML àbhaisteach agad fhèin ann an Zigbee
Tha an roinn a’ sealltainn mar a chruthaicheas tu na cruinneachaidhean àbhaisteach agad fhèin agus leudaich na cruinneachaidhean àbhaisteach a th’ ann mar-thà le buadhan gnàthaichte agus òrdughan airson Zigbee.
Cruinneachaidhean a tha sònraichte do luchd-saothrachaidh ann an Zigbee
Faodaidh tu cruinneachaidhean sònraichte neach-dèanamh a chur ri pro àbhaisteachfile. Bidh sinn a’ toirt seachad example seo gu h-ìosal. Gus seo a dhèanamh feumaidh tu dà dhleastanas a choileanadh:
FEUMAIDH an ID brabhsair a bhith anns an raon a tha sònraichte don neach-dèanamh, 0xfc00 - 0xffff. Feumaidh còd saothraiche a bhith anns a’ mhìneachadh brabhsair a thèid a chuir an sàs anns A H-UILE buadhan agus àithne taobh a-staigh a’ bhuidheann sin agus a dh’ fheumar a thoirt seachad nuair a thathar a’ cur agus a’ faighinn òrdughan agus ag eadar-obrachadh le buadhan. Mar eisimpleirample:

Sample Mfg Buidheann Shònraichte Coitcheann Tha an cruinneachadh seo a’ toirt seachad example iomradh air mar a ghabhas am Frèam Iarrtais a leudachadh gu bhith a’ toirt a-steach cruinneachaidhean a tha sònraichte do luchd-dèanamh.
0xFC00
ember sample feart
ember sample feart 2

A sample àithne neach-dèanamh sònraichte taobh a-staigh na sample neach-dèanamh sònraichte
cnuasachd.

Òrdughan sònraichte do luchd-saothrachaidh ann an Standard Zigbee Cluster
Faodaidh tu na h-òrdughan agad fhèin a chur ri cruinneachadh àbhaisteach Zigbee leis na riatanasan a leanas:
Faodaidh na h-òrdughan a tha sònraichte don neach-dèanamh agad id àithne sam bith a chleachdadh taobh a-staigh an raon id àithne, 0x00 - 0xff. Feumaidh tu cuideachd còd dèanadais a thoirt seachad airson an àithne gus an tèid a chomharrachadh bho òrdughan eile sa bhuidheann agus a làimhseachadh gu h-iomchaidh. Mar eisimpleirample bhith a’ leudachadh a’ bhuidheann On / Off le òrdughan saothrachaidh:

13/35

Custom XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thionndaidheas an inneal le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificOnWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thionndaidheas an inneal air le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificToggleWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thogas an inneal le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificOnWithTransition2 ″ optional = “fìor” manufacturerCode = ” 0 1049 ″> Òrdugh teachdaiche a thionndaidheas an inneal air le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificToggleWithTransition2″ optional = “fìor”
manufacturerCode =”0 1049 ″> Òrdugh teachdaiche a thogas an inneal le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.

Feartan sònraichte neach-dèanamh ann an Standard Zigbee Cluster
Faodaidh tu na buadhan agad fhèin a chur ri cruinneachadh àbhaisteach Zigbee leis na riatanasan a leanas:
Faodaidh na buadhan sònraichte neach-dèanamh agad id feart sam bith a chleachdadh taobh a-staigh an raon id buadhan, 0x0000 - 0xffff. Feumaidh tu cuideachd còd saothraiche a thoirt seachad airson a’ fheart gus an tèid a chomharrachadh bho fheartan eile sa bhuidheann agus a làimhseachadh gu h-iomchaidh. Mar eisimpleirample bhith a’ leudachadh a’ bhuidheann On/Off le buadhan saothrachaidh:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″
max = ” 0xFFFF ”writable =” fìor ”default =” 0 0000 ″ roghainneil = “fìor” manufacturerCode = ” 0 1002 ″>Sample Mfg Feartan Sònraichte: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 0000 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1049 ″>Sample Mfg Feartan Sònraichte: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 00 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1002 ″>Sample Mfg Feartan Sònraichte: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 0000 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1049 ″>Sample Mfg Feartan Sònraichte: 0 0001 0 1040
A’ cruthachadh an XML àbhaisteach agad fhèin ann an Cùis
Tha an roinn a’ sealltainn mar a chruthaicheas tu na cruinneachaidhean àbhaisteach agad fhèin agus leudaich na cruinneachaidhean àbhaisteach a th’ ann mar-thà le buadhan gnàthaichte agus òrdughan airson Cùis.
Cruinneachaidhean a tha sònraichte do neach-dèanamh ann an cùis
Faodaidh tu cruinneachaidhean a tha sònraichte don neach-dèanamh a chur ris ann an Cùis. Bidh sinn a’ toirt seachad example seo gu h-ìosal.
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

Custom XML
Anns an t-example, tha an cothlamadh de ID an neach-reic (Test Manufacturer ID) de 0xFFF1 agus an ID brabhsair de 0xFC20 a’ leantainn gu value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Coitcheann Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Tha an Sample brabhsair MEI a’ taisbeanadh leudachaidhean saothraiche brabhsair FlipFlop
Freagairt airson AddArguments a thilleas an t-suim. Òrdugh a bheir dà argamaid uint8 agus a thilleas an t-suim aca. Òrdugh sìmplidh gun pharamadairean sam bith agus gun fhreagairt.
Feartan sònraichte neach-dèanamh ann an cruinneachaidhean cùis àbhaisteach
Faodaidh tu buadhan sònraichte neach-dèanamh a chur ri cruinneachadh àbhaisteach Cùisean leis na riatanasan a leanas:
T aaaa tha e a’ cruinneachadh gum feumar na buadhan air a bheilear a’ sònrachadh –
e xte nd deas >>>
Tha còd na feart na mheasgachadh 32-bit de chòd an neach-dèanamh agus an id airson a’ fheart. Is e na 16 pìosan as cudromaiche còd an neach-dèanamh. Is e an raon airson còdan dèanadais deuchainn 0xFFF1 - 0xFFF4. Is e an 16 pìosan as cudromaiche an ID feart. Is e an raon airson buadhan neo-chruinneil 0x0000 - 0x4FFF.
Example bhith a’ leudachadh brabhsair On/Off Matter le buadhan sònraichte airson saothrachadh:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ seòrsa=”INT8U” min=”0 0000″
max = ” 0xFFFF ”writable =” fìor ”default =” 0 0000 ″ roghainneil = “fìor”> Sample Mfg Feartan Sònraichte 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ seòrsa=”INT16U” min=”0 0000″
max = ” 0xFFFF ”writable =” fìor ”default =” 0 0000 ″ roghainneil = “fìor”> Sample Mfg Feartan Sònraichte 4
Òrdughan Sònraichte Dèanadair ann an Cruinneachaidhean Cùisean Coitcheann
Faodaidh tu òrdughan sònraichte neach-dèanamh a chur ri buidheann àbhaisteach Matter leis na riatanasan a leanas:
T aaaa tha e a’ cruinneachadh gum feumar na h-òrdughan a thathar ag iarraidh a shònrachadh –
e xte nd deas >>>
Tha còd na h-àithne na mheasgachadh 32-bit de chòd an neach-dèanamh agus an id airson an àithne. Is e na 16 pìosan as cudromaiche còd an neach-dèanamh. Is e an raon airson còdan dèanadais deuchainn 0xFFF1 - 0xFFF4. Is e an 16 pìosan as cudromaiche an ID àithne. Is e an raon airson òrdughan neo-chruinneil 0x0000 - 0x00FF.
ExampLe bhith a’ leudachadh brabhsair On/Off Matter le cruinneachaidhean a tha sònraichte do chinneasachadh:

15/35

Custom XML

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2 ″ optional = "fìor"> Òrdugh teachdaiche a thionndaidheas an inneal air le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ optional="fìor">
Òrdugh teachdaiche a thogas an inneal le eadar-ghluasad air a thoirt seachad leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.

16/35

Custom XML Tags airson Zigbee

Tha an sgrìobhainn a leanas a 'bruidhinn air gach aon de na xml tags co-cheangailte ri Zigbee.
Tha gach xml file air a liostadh eadar an configurator tags:

Faodar seòrsaichean dàta a mhìneachadh taobh a-staigh an rèiteachaidh tag. Tha Zigbee an-dràsta a’ toirt taic do mhìneachadh bitmaps, enums, integers, strings or structs. Mus mìnich thu barrachd sheòrsan dèan cinnteach gun toir thu sùil air a h-uile seòrsa atamach a tha air a mhìneachadh ann an seòrsaichean.xml agus a h-uile seòrsa neo-atamach a tha air a mhìneachadh san xml eile files. Faodaidh tu iad sin a mhìneachadh mar a leanas:
Bitmap: ainm: ainm seòrsa mapa bit. seòrsa: Faodar mapa-bit le meud eadar 8-64 pìosan a mhìneachadh, agus bu chòir dhaibh uile a bhith nan iomadan de 8. Faodaidh iomadh raon a bhith aig gach mapa le ainm agus masg co-cheangailte ris. m.e.:

“`
Enum: ainm: ainm an t-seòrsa enum. seòrsa: Faodar Enum le meud eadar pìosan 8-64 a mhìneachadh, agus bu chòir dhaibh uile a bhith nan iomadan de 8. Faodaidh iomadh rud a bhith aig gach enum le ainm agus luach co-cheangailte ris. m.e.:

Slàn-chunntas: Tha seòrsachan iomlanachd air am mìneachadh mar-thà fo sheòrsan atamach a tha ann an seòrsaichean.xml. Faodaidh am meud a bhith eadar 8-64 pìosan agus faodar a shoidhnigeadh no gun ainm-sgrìobhte. m.e.:

String: Tha seòrsachan sreang air am mìneachadh mar-thà fo sheòrsan atamach a tha ann an seòrsaichean.xml. Am measg nan seòrsaichean sreang a th’ ann an-dràsta tha sreang octet, sreang char, sreang octet fhada agus sreang fhada char m.e.:

Structar: ainm: ainm an t-seòrsa structar. Faodaidh iomadh rud a bhith aig gach structar le ainm agus seòrsa co-cheangailte ris. Faodaidh an seòrsa a bhith na sheòrsa sam bith ro-mhìnichte fo sheòrsan dàta. m.e.:

17/35

Custom XML Tags airson Zigbee

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

Faodar Custom Clusters a mhìneachadh taobh a-staigh an rèiteachaidh tag. ainm: ainm an àrainn braisle: domain of the cluster. Nochdaidh an cruinneachadh anns an ZAP UI fon raon seo. Tuairisgeul: Tuairisgeul air a’ chòd brabhsair: còd cnuasachaidh mìneachadh: cluster define a tha air a chleachdadh le gineadair còd gus am buidheann a mhìneachadh ann an dòigh shònraichte DèanadairCode: Air a chleachdadh gus brabhsair sònraichte saothrachaidh a mhìneachadh. Feumaidh seo a bhith eadar 0xfc00 - 0xffff. Feumaidh an còd saothraiche airson a’ bhuidheann a bhith air a mhìneachadh mar a leanas:

Bidh cruinneachadh saothrachaidh gu fèin-ghluasadach a’ dèanamh na buadhan agus na h-òrdughan fodha den aon chòd saothraiche mura h-eil iad ag ainmeachadh còd an neach-dèanamh gu soilleir. introducedIn: Air a chleachdadh gus an dreach sònraichte anns an deach am brabhsair a thoirt a-steach a dhearbhadh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. removedIn: Air a chleachdadh gus an dreach sònrachaidh anns an deach am brabhsair a thoirt air falbh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. singleton (boolean): Air a chleachdadh gus cruinneachadh a dhearbhadh mar singleton gus nach eil ach aon eisimpleir den bhuidheann sin air a roinn thairis air na puingean crìochnachaidh. feart : a’ mìneachadh buadh airson an ainm braisle : Tha ainm buadh air ainmeachadh eadar am feart tag.
ainm feart
taobh (neach-dèiligidh / frithealaiche): Taobh a’ bhuidheann ris a bheil am feart co-cheangailte cuideachd. còd: còd buadhach còd saothraiche: Faodar seo a chleachdadh gus feart sònraichte saothraiche a mhìneachadh taobh a-muigh an t-sònrachadh zigbee air ainmeachadh leis an xml àbhaisteach. mìneachadh: buadhan mìneachadh a tha air a chleachdadh le gineadair còd gus feart a mhìneachadh ann an dòigh shònraichte seòrsa: an seòrsa den fheart a dh’ fhaodadh a bhith mar aon de na seòrsaichean dàta a tha air an ainmeachadh san xml default: luach bunaiteach airson a’ bhuadh. min: An luach ceadaichte as ìsle airson feart max: An luach ceadaichte as àirde airson buadh a ghabhas sgrìobhadh: A bheil luach feart air a sgrìobhadh no nach eil. Faodar seo a chleachdadh gus casg a chuir air a’ bhuadh atharrachadh le bhith a’ sgrìobhadh òrdughan. roghainneil (boolean): Air a chleachdadh gus faighinn a-mach a bheil feart roghainneil no nach eil airson a’ bhuidheann. min: An luach as ìsle a tha ceadaichte airson feart nuair a tha e na sheòrsa slán-ìre, enum no mapa bit. max: An luach ceadaichte as àirde airson a’ bhuadh nuair a tha e na shlànaighear, enum no faid seòrsa bitmap: Air a chleachdadh gus an fhad as motha den fheart a shònrachadh nuair a tha e de sheòrsa sreang. minLength: Air a chleachdadh gus an fhad as lugha den fheart a shònrachadh nuair a tha e de sheòrsa sreang. aithris (boolean): Ag innse a bheil feart ri aithris no nach eil Nullable(boolean): A’ ceadachadh luachan null airson a’ bhuadh. array (boolean): Air a chleachdadh gus feart de sheòrsa seòrsa ainmeachadh. insertIn: Air a chleachdadh gus an dreach sònraichte anns an deach am feart a thoirt a-steach a dhearbhadh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. removedIn: Air a chleachdadh gus an dreach sònrachaidh anns an deach am feart a thoirt air falbh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. àithne: mìnich òrdugh airson ainm brabhsair: Ainm an àithne.

còd: còd àithne

18/35

Custom XML Tags airson Zigbee
còd dèanadais: Faodar seo a chleachdadh gus àithne neach-dèanamh sònraichte a mhìneachadh taobh a-muigh an t-sònrachadh zigbee air ainmeachadh leis an xml àbhaisteach. tuairisgeul: tuairisgeul air stòr an àithne (cliant / frithealaiche): stòr an àithne. roghainneil (boolean): Air a chleachdadh gus faighinn a-mach a bheil àithne roghainneil no nach eil airson a’ bhuidheann. introducedIn: Air a chleachdadh gus an dreach sònraichte anns an deach an àithne a thoirt a-steach a dhearbhadh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. removedIn: Air a chleachdadh gus an dreach sònraichte anns an deach an àithne a thoirt air falbh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. argamaidean àithne:
Faodaidh seata de dh’ argamaidean àithne a bhith aig gach àithne ainm: ainm na h-argamaid àithne: seòrsa na h-argamaid àithne a dh’ fhaodadh a bhith mar aon de na seòrsaichean a tha air an ainmeachadh san xml. min: An luach as ìsle a tha ceadaichte airson argamaid nuair a tha e na sheòrsa slán-ìre, enum no mapa bit. max: An luach as motha a tha ceadaichte airson argamaid nuair a tha e na shlànaighear, an enum no an seòrsa mapa-bit: Air a chleachdadh gus an fhad as motha a tha ceadaichte airson argamaid àithne a shònrachadh nuair a tha e de sheòrsa sreang. minLength: Air a chleachdadh gus an fhad as lugha a tha ceadaichte airson argamaid àithne a shònrachadh nuair a tha e de sheòrsa sreang. array (boolean): Gus faighinn a-mach a bheil an argamaid àithne de sheòrsa seòrsa. presentIf (sreang): Faodaidh seo a bhith na shreath chùmhnantach de ghnìomhachd loidsigeach stèidhichte air argamaidean àithne eile far am faod dùil a bhith agad ris an argamaid àithne ma tha an sreang chumhachan a’ measadh gu bheil e fìor. m.e.:

Nota: An seo tha inbhe ainm argamaid àithne eile. roghainneil (boolean): Air a chleachdadh gus an argamaid àithne a dhearbhadh mar roghainn. countArg: Air a chleachdadh nuair a tha an argamaid àithne de sheòrsa seòrsa. Tha seo air a chleachdadh airson iomradh a thoirt air an argamaid àithne eile a tha a’ comharrachadh meud raon airson na h-argamaid seo.

insertIn: Air a chleachdadh gus an dreach sònraichte a dhearbhadh anns an deach an argamaid àithne a thoirt a-steach. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. removedIn: Air a chleachdadh gus an dreach sònraichte anns an deach an argamaid àithne a thoirt air falbh. Tha seo air a chleachdadh le gineadair còd gus loidsig a bharrachd a chuir ris. Faodar leudachadh Cluster a mhìneachadh taobh a-staigh an rèiteachaidh tag. Thathas a’ cleachdadh leudachadh cnuasachaidh gus cruinneachadh àbhaisteach a leudachadh le buadhan saothrachaidh agus òrdughan me

19/35

Custom XML Tags airson Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” default = ” 0 0000 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1002 ″>Sample Mfg Feartan Sònraichte: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 0000 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1049 ″>Sample Mfg Feartan Sònraichte: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 00 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1002 ″>Sample Mfg Feartan Sònraichte: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max =” 0xFFFF” sgrìobhadh = “fìor” bunaiteach = ” 0 0000 ″ roghainneil = ”fìor” manufacturerCode = ” 0 1049 ″>Sample Mfg Feartan Sònraichte: 0 0001 0 1040ampleMfgSpecificOffWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thionndaidheas an inneal dheth le eadar-ghluasad air a thoirt seachad
leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificOnWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thionndaidheas an inneal air le eadar-ghluasad air a thoirt seachad
leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificToggleWithTransition" roghnach = "fìor" manufacturerCode = ” 0 1002 ″> Òrdugh teachdaiche a thogas an inneal le eadar-ghluasad air a thoirt seachad
leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificOnWithTransition2 ″ optional = “fìor” manufacturerCode = ” 0 1049 ″> Òrdugh teachdaiche a thionndaidheas an inneal air le eadar-ghluasad air a thoirt seachad
leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.ampleMfgSpecificToggleWithTransition2 ″ optional = “fìor” manufacturerCode = ” 0 1049 ″> Òrdugh teachdaiche a thogas an inneal le eadar-ghluasad air a thoirt seachad
leis an ùine gluasaid anns an Ember Sample feart ùine gluasaid.

20/35

Ioma seòrsa inneal a rèir puing crìochnachaidh

Is e feart Cùis a-mhàin a tha seo far an urrainn do neach-cleachdaidh barrachd air aon seòrsa inneal a thaghadh airson gach puing crìochnachaidh. Le bhith a’ cur iomadh seòrsa inneal aaa a-steach cuiridh sin na rèiteachaidhean cnuasachadh taobh a-staigh nan seòrsaichean inneal gu rèiteachadh a’ phuing crìochnachaidh.

21/35

Ioma seòrsa inneal a rèir puing crìochnachaidh

Tha an ìomhaigh gu h-àrd a’ sealltainn gu bheil barrachd air aon sheòrsa inneal air an taghadh aig endpoint 1. Tha am “Prìomh inneal” a’ comharrachadh prìomh sheòrsa inneal ris am bi am puing crìochnachaidh co-cheangailte. Tha am prìomh sheòrsa inneal an-còmhnaidh an làthair aig clàr-amais 0 den liosta de sheòrsan inneal a chaidh a thaghadh agus mar sin atharraichidh taghadh prìomh sheòrsa inneal eadar-dhealaichte òrdugh nan seòrsachan inneal a chaidh a thaghadh. Tha cuingealachaidhean aig taghadh seòrsa inneal cuideachd stèidhichte air an t-Sònrachadh Modail Dàta. Bidh ZAP a’ dìon an luchd-cleachdaidh bho bhith a’ taghadh measgachadh neo-dhligheach de sheòrsan inneal air puing crìochnachaidh a’ cleachdadh nan cuingeadan sin.

22/35

Duilleag feart seòrsa inneal cùis
Duilleag feart seòrsa inneal cùis
Duilleag feart seòrsa inneal cùis
Tha ZAP a’ toirt taic do bhith a’ fradharc agus a’ togail feartan Matter air duilleag feart seòrsa inneal. Cha tèid ach feartan seòrsa inneal a tha air an sònrachadh ann an matter-devices.xml ann an stòr CHIP a thaisbeanadh.

A’ seòladh chun na duilleig feart
ò Cuir air bhog ZAP in Matter le Matter SDK as ùire. o Cruthaich puing crìochnachaidh le seòrsa inneal Matter. ô Cliog air a’ phutan Feartan seòrsa inneal air meadhan mullach a’ bhraisle view. Thoir an aire nach eil am putan seo ri fhaighinn ach ann an ZAP
rèiteachaidhean airson Matter agus nuair a tha dàta gèillidh ann an Matter SDK. Ma bhriogas tu air a’ phutan seo fosglaidh an dealbh gu h-àrd.
Gèilleadh
Tha co-chòrdalachd a’ mìneachadh roghainn agus eisimeileachd airson buadhan, òrdughan, tachartasan, agus seòrsachan dàta. Bidh e a’ dearbhadh a bheil eileamaid èigneachail, roghainneil no gun taic fo rèiteachaidhean sònraichte ZAP.
Tha gèilleadh feart seòrsa inneal air thoiseach air gèilleadh feart brabhsair. Airson example, tha gèilleadh roghainneil aig an fheart Solais anns a’ bhuidheann On / Off ach tha e air ainmeachadh mar inneal èigneachail anns an t-seòrsa inneal On / Off Light a tha a’ toirt a-steach an cruinneachadh On / Off. Le bhith a’ cruthachadh puing crìochnachaidh leis an t-seòrsa inneal On / Off Light seallaidh e am feart Solais mar èigneachail air an duilleag feart.
Feart a 'togail
Air an duilleag feart, às deidh dhut briogadh air a’ phutan toggle gus feart a chomasachadh no a chuir à comas, nì ZAP:
Ùraich eileamaidean co-cheangailte (buadhan, òrdughan, tachartasan) gus gèilleadh a cheartachadh, agus taisbeanadh còmhradh a’ sealltainn nan atharrachaidhean.

23/35

Seòrsa inneal cùise duilleag feart Ùraich am pìos feart ann am feart feartMap den bhuidheann co-cheangailte

Dèan comas air Còmhradh Feart

Cuir à comas còmhradh feart

Tha togadh à comas airson cuid de fheartan nuair a tha luach neo-aithnichte aig a’ cho-chòrdalachd aca no foirm t. Anns an ac se seo, seallaidh ZAP rabhaidhean anns an aplacaid fios.
agus Co-chòrdadh Wa Element

Nuair a thogas tu eileamaid, faodaidh ZAP an dà chuid rabhaidhean gèillidh inneal agus rabhaidhean gèillidh a thaisbeanadh. Mura h-eil staid na h-eileamaid a’ freagairt ris a’ ghèilleadh ris a bheil dùil, seallaidh ZAP ìomhaigh rabhaidh agus logaidh e an rabhadh anns an ap ne. Mar eisimpleirample rabhaidhean gèillidh agus gèillidh air an taisbeanadh airson eileamaid:

24/35

Brathan
Brathan
Brathan
Tha an earrann a leanas a’ mìneachadh mar a thèid fiosan a thoirt do luchd-cleachdaidh ZAP san UI.
Sanasan pacaid
Is e fiosan pacaid na rabhaidhean no teachdaireachdan mearachd co-cheangailte ri pasgan sònraichte sam bith a thèid a luchdachadh a-steach do ZAP. Airson example, anns na h-ìomhaighean gu h-ìosal, ma bhriogas tu air an ìomhaigh rabhaidh fon cholbh inbhe bheir sin thu gu còmhradh a sheallas a h-uile fios airson a’ phacaid sin.

25/35

Brathan
Brathan Seisean
Is e brathan seisean na rabhaidhean no teachdaireachdan mearachd a tha co-cheangailte ri seisean cleachdaiche. Chithear na rabhaidhean/mearachdan sin le bhith a’ briogadh air a’ phutan Fiosan anns a’ bhàr-inneal air mullach an ZAP UI. Airson example, tha an ìomhaigh gu h-ìosal a’ sealltainn duilleag fiosan an t-seisein às deidh isc file air a luchdachadh gu ZAP.

26/35

Gèilleadh ri Sònrachadh Modail Dàta / ZCL
Gèilleadh ri Sònrachadh Modail Dàta / ZCL
Modail Dàta agus Gèilleadh Sònrachadh ZCL
Bidh am feart seo ann an ZAP a’ cuideachadh luchd-cleachdaidh a bhith a’ faicinn fàilligidhean gèillidh airson Modail Dàta no ZCL leis na rèiteachaidhean ZAP a th’ aca mar-thà. Nochdaidh na teachdaireachdan rabhaidh airson fàilligidhean gèillidh air a’ phana Fiosan anns an ZAP UI agus bidh iad cuideachd air an logadh a-steach don consol nuair a bhios iad a’ ruith ZAP tron CLI. Tha am feart gèillidh an-dràsta a’ toirt seachad rabhaidhean airson gèilleadh seòrsa inneal agus gèilleadh brabhsair air puing crìochnachaidh.
Rabhaidhean gèillidh anns an UI ZAP
Nuair a bhios neach-cleachdaidh a 'fosgladh .zap file a’ cleachdadh an ZAP UI chì iad rabhaidhean ann am pana fiosan an ZAP UI airson a h-uile fàiligeadh gèillidh. Airson example, tha an ìomhaigh gu h-ìosal a 'sealltainn duilleag brathan an t-seisein an dèidh .zap file fhosgladh le cùisean gèillidh.

Thèid na teachdaireachdan gèillidh air falbh aon uair ‘s gu bheil na cùisean air am fuasgladh le bhith a’ cleachdadh an ZAP UI gus nach urrainn dhut ach sùil a chumail air na cùisean gèillidh a tha air fhàgail. Nochdaidh rabhaidhean ùra cuideachd airson gèilleadh ma chuireas an neach-cleachdaidh à comas eileamaidean èigneachail (braisle / òrdughan / feartan) den rèiteachadh. Bidh fiosan gèillidh sònrachaidh an-còmhnaidh a’ cumail sùil air fàilligidhean sam bith a thèid a thoirt a-steach don rèiteachadh ZAP ach thoir an aire gu bheil na rabhaidhean a nochdas nuair a dh’fhosglas .zap file nas mionaidiche air carson a dh’ fhàillig e gèilleadh an taca ris na rabhaidhean a nochdas fhad ‘s a tha iad ag eadar-obrachadh leis an UI. Tha seo le dealbhadh agus thèid làn sgrùdadh gèillidh a dhèanamh fhad ‘s a tha fosgladh .zap file.
Rabhaidhean gèillidh air a’ Chonsole

27/35

Gèilleadh ri Sònrachadh Modail Dàta / ZCL
Nuair a bhios neach-cleachdaidh a 'fosgladh .zap file a’ cleachdadh an UI neo-eisimeileach ZAP no an ZAP CLI chì iad rabhaidhean air an logadh a-steach don chonsail/terminal airson a h-uile fàiligeadh gèillidh. Airson example, tha an ìomhaigh gu h-ìosal a’ sealltainn rabhaidhean fios an t-seisein air a’ chonsail/terminal às deidh .zap file fhosgladh le cùisean gèillidh.

28/35

Smachd Ruigsinneachd

Feartan smachd ruigsinneachd
Tha ZAP a’ toirt taic do smachd ruigsinneachd air a h-uile buidheann ZCL. Tha e an urra ri buileachadh an SDK na feartan sin a mhapadh gu na feartan SDK smachd ruigsinneachd a tha a dhìth agus le taic. Mar as trice bidh ZAP a’ toirt seachad modail dàta agus uidheamachd airson a chòdachadh anns a’ mheata-fhiosrachadh files agus iomadachadh an dàta sin gu na teamplaidean ginealach, gun a bhith a’ sònrachadh brìgh sònraichte dha na puingean dàta.
Teirmean Bunaiteach
Tha smachd ruigsinneachd ZAP a’ mìneachadh trì teirmean bunaiteach, mar a leanas: ò obrachadh : air a mhìneachadh mar rud a ghabhas dèanamh. Mar eisimpleirample: leugh, sgrìobh, gairm. bho dreuchd: air a mhìneachadh mar shochair actair. Leithid "View sochair", "Dleastanas rianachd", agus mac air adhart. o mion-atharraichean: air am mìneachadh mar chumhachan smachd ruigsinneachd sònraichte, leithid dàta mothachail air aodach no dàta le farsaingeachd aodach. Tha na teirmean bunaiteach air am mìneachadh anns a’ mheata-dàta XML fo mhullach tag . Tha na leanas mar exampMìneachaidhean teirm bunaiteach smachd ruigsinneachd:
<role type=”view” tuairisgeul = ”View sochair"/>
Tha an t-example mìneachadh trì obrachaidhean, leughadh, sgrìobhadh agus gairm, dà mhion-atharrachaidh agus ceithir dreuchdan.
Triplets ruigsinneachd
Faodar gach suidheachadh ruigsinneachd fa leth a mhìneachadh le triplet ruigsinneachd san XML. Tha triplet ruigsinneachd na mheasgachadh de ghnìomhachd, dreuchd agus inneal-atharrachaidh. Tha iad roghainneil, agus mar sin chan urrainn dhut ach aon dhiubh sin a bhith agad. Mar as trice bidh pàirt de triplet a tha a dhìth a’ ciallachadh ceadan, a tha sònraichte airson buileachadh an SDK a chaidh a thoirt seachad. Faodaidh aon turas no barrachd a bhith aig eintiteas a tha a’ mìneachadh a ruigsinneachd. Tha na leanas mar example:
aig 0
Is e seo mìneachadh air feart aig a bheil triplet ruigsinneachd, ag ràdh gu bheil e a’ ceadachadh obrachadh sgrìobhaidh le dreuchd stiùiridh, le inneal-atharrachaidh le farsaingeachd aodach air a chuir an sàs.
Ceadan bunaiteach

29/35

Smachd Ruigsinneachd
Faodaidh buidhnean ZCL na ceadan fa leth aca fhèin a mhìneachadh. Ach, tha mìneachadh cruinneil ann cuideachd air ceadan bunaiteach airson
seòrsaichean air an toirt seachad. Thathas a’ gabhail riutha sin airson an eintiteas ainmichte, mura toir e seachad cead sònraichte sam bith.
Bithear a’ cur an cèill ceadan bunaiteach tro a tag aig an ìre as àirde XML file. Mar eisimpleirample:
aa a< ccess op = “invoke”/> a a aa <ccess op="re d"> a <ccess op="sgrìobh"/> a aa aa < ccess op = ” re d ” role =”view”/> aa <ccess op=”write” role=”oper te”/> a
Luchd-cuideachaidh Teamplaid
'S e {{#access}} … {{/access}} an neach-cuideachaidh teamplaid bunaiteach a chleachdas tu. Bidh an iterator seo ag aithris thairis air na triplets ruigsinneachd a chaidh a thoirt seachad.
Tha e a’ toirt taic don dà roghainn a leanas:
eintiteas = “feart / àithne / tachartas” - mura h-urrainnear an eintiteas a dhearbhadh bhon cho-theacsa, bidh seo a’ suidheachadh an seòrsa eintiteas. includeDefault = “fìor / meallta” - a’ dearbhadh a bheil luachan bunaiteach air an toirt a-steach no nach eil. Tha na leanas mar example:
{{#zcl_clusters}}
a Cluster: {{ n me}} [{{code}}] a {{#zcl_ ttributes}} aa – ttribute: {{ n me}} [{{code}}] aa {{# ccess eintiteas=" ttribute"}}
O RM a M * P: {{Oper tion} / ODIFORE} {{{{n{ {3 Còd }}] AA {{# # # # comm nd "}} o rm a M * P: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – tachartas: {{ n me}} [{{code}}] a {{# ccess eintiteas=”event" }} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

A’ cur air bhog ZAP airson tagraidhean Matter no Zigbee
A’ cur air bhog ZAP airson tagraidhean Matter no Zigbee
A’ cur air bhog ZAP airson Iarrtasan Cùise no Zigbee
Tha na h-earrannan a leanas a’ toirt cunntas air cur air bhog ZAP ann am modh leis fhèin leis a’ mheata-dàta Matter no Zigbee-sònraichte. Is e am beachd ZAP a chuir air bhog leis na h-argamaidean ceart co-cheangailte ri meata-dàta XML (na cruinneachaidhean agus na mìneachaidhean seòrsa inneal a rèir mion-chomharrachadh CSA) agus na teamplaidean ginealach, a thathas a’ cleachdadh gus an còd iomchaidh a ghineadh.
A’ cur air bhog ZAP with Matter
Bidh an sgriobt a leanas a’ togail na meata-dàta ceart bhon Matter SDK nuair a chuireas tu ZAP air bhog. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Nota: Faodaidh tu cuideachd gabhail ris an dòigh Zigbee a leanas gus ZAP in Matter a chuir air bhog.
A’ cur air bhog ZAP le Zigbee
Bidh an àithne a leanas a’ cur ZAP air bhog leis na sònrachaidhean ZCL agus teamplaidean ginealach bhon 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 t-slighe gu stòr ZAP no slighe sdk so-ghnìomhaichte: Seo an t-slighe chun SDK
A 'cur air bhog ZAP gun Metadata
Cuimhnich, nuair a chuireas tu ZAP air bhog gu dìreach tro ghnìomhachd no bhon stòr a’ cleachdadh npm run zap gu bheil thu a’ cur air bhog ZAP le meata-dàta deuchainn airson Matter/Zigbee air a thogail a-steach taobh a-staigh ZAP agus chan e na fìor mheata-dàta a tha a’ tighinn bho na Matter agus Zigbee SDKs a chaidh ainmeachadh gu h-àrd. Mar sin, cuimhnich gun cruthaich thu na rèiteachaidhean ZAP agad le bhith a’ cleachdadh meata-dàta SDK agus chan ann le bhith a’ fosgladh ZAP gu dìreach leis a’ mheata-dàta deuchainn togte.

31/35

A’ cruthachadh còd airson Matter or Zigbee

A’ gineadh còd airson Cùis, Zigbee no Custom SDK
Tha na h-earrannan a leanas ag innse mar a ghineas tu còd a’ cleachdadh ZAP.
Cruthaich còd a’ cleachdadh ZAP UI
Cuir air bhog an ZAP UI a rèir an stiùiridh ann an Launch ZAP for Matter or Zigbee agus cliog air a ’phutan Generate anns a’ bhàr clàr gu h-àrd.
Cruthaich còd às aonais an UI
Tha an stiùireadh a leanas a’ toirt seachad diofar dhòighean air còd a ghineadh tro CLI gun a bhith a’ cur air bhog an ZAP UI.
A’ gineadh còd bho ZAP Source
Ruith an àithne a leanas gus còd a ghineadh a ’cleachdadh ZAP bhon stòr: 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
A’ gineadh còd bho ZAP Executable
Ruith an àithne a leanas gus còd a ghineadh a ’cleachdadh ZAP so-ghnìomhaichte: [zap-path] ghineadh -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
A’ gineadh còd bho ZAP CLI Executable
Ruith an àithne a leanas gus còd a ghineadh a ’cleachdadh ZAP CLI Executable: [zap-cli-path] cruthaich -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

Ùraich ZAP ann an Stiùidio

Cuir a-nuas ZAP
Ùraich ZAP ann an Simplicity Studio
Faodar an uidheamachd seo a chleachdadh nuair a bhios tu ag obair le leudachadh Matter no Zigbee bho na fiosan Silicon Labs SDK. Faodar ZAP ùrachadh taobh a-staigh Simplicity Studio às aonais foillseachadh Simplicity Studio le bhith a’ luchdachadh sìos an ZAP so-ghnìomhaichte as ùire (air a mholadh) no a’ tarraing an fheadhainn as ùire bho stòr ZAP mar a chithear ann an ZAP Installation Guide. Às deidh dhut an ZAP as ùire a bhith agad stèidhichte air an OS a chleachd thu an-dràsta, faodaidh tu ZAP ùrachadh taobh a-staigh Studio mar phasgan inneal-atharrachaidh. Lean an stiùireadh gu h-ìosal às deidh dhut an ZAP as ùire a luchdachadh sìos:
Rach gu Simplicity Studio agus tagh Preferences> Simplicity Studio> Adapter Packs. Cliog air Add ... agus brobhsadh chun phasgan ZAP leudaichte a luchdaich thu sìos agus cliog Tagh Folder . Cliog air Cuir a-steach is Dùin agus an uairsin thèid an ZAP a tha air ùr chur ris a chleachdadh uair sam bith a bhios .zap file air fhosgladh.
Nota: Aig amannan is dòcha gu bheil suidheachaidhean nas sine de ZAP a’ ruith mu thràth eadhon às deidh ùrachadh chun ZAP as ùire. Dèan cinnteach gun cuir thu crìoch air a h-uile suidheachadh ZAP a th’ ann mar-thà gus am bi an ZAP a chaidh fhaighinn às ùr air a chleachdadh an àite seann eisimpleir, a tha fhathast ag obair air a’ chùl.
Ùraich ZAP airson Leasachadh Cùisean ann an Github
Nuair a bhios tu ag obair leis na repos Matter or Matter-Silicon Labs air Github, suidhich caochladairean àrainneachd a thaobh ZAP gus rèiteachaidhean ZAP ùra a chruthachadh / a ghineadh no ath-ghinealach s a th’ ann mar-thà.ample rèiteachaidhean ZAP às deidh dhaibh atharrachaidhean a chuir an sàs. Suidhich an ZAP_DEVELOPMENT_PATH gu ZAP bhon tùs le bhith a' tarraing an tè as ùire no a' suidheachadh ZAP_INSTALLATION_PATH gu ZAP so-ghnìomhaichte a dh' luchdaich thu sìos mu dheireadh san eòlaire ionadail agad. Thoir an aire nuair a bhios an dà chuid ZAP_DEVELOPMENT_PATH agus ZAP_INSTALLATION_PATH air an suidheachadh, gun tèid ZAP_DEVELOPMENT_PATH a chleachdadh.
Tha na leanas exampnas lugha a sheallas na caochladairean àrainneachd gu h-àrd ann an cleachdadh:
A’ cur air bhog ZAP a’ cleachdadh sònrachadh Cùisean Ag ath-nuadhachadh a h-uile rud sample rèiteachadh ZAP airson tagraidhean Matter
Nota: Nuair a bhios tu a’ cleachdadh ZAP executables, dèan cinnteach gu bheil thu a’ cleachdadh brath oifigeil thairis air brath oidhche airson barrachd seasmhachd. Faic
Luchdaich sìos an ZAP Executable ann an ZAP Installation Guide

33/35

Ioma-phròtacal co-aontach eadar Zigbee agus Matter
Ioma-phròtacal co-aontach eadar Zigbee agus Matter
MCoanttceurrrent Ioma-phròtacal eadar Zigbee agus
Faodar ZAP a chleachdadh gus rèiteachadh ZCL (Zigbee) agus Data-Model (Matter) a rèiteachadh ann an tagradh ioma-phròtacal airson Zigbee and Matter. Leigidh ZAP leat puingean crìochnachaidh a chruthachadh airson Zigbee agus Matter gu soilleir san aon rèiteachadh file. Ma tha puingean crìochnachaidh Zigbee agus Matter air an aon aithnichear puing crìochnachaidh (airson example, LO Dimmable Light air endpoint Id 1 agus Matter Dimmable Light air eisimpleir eile de phuing crìochnachaidh 1), bidh ZAP a’ gabhail cùram mu bhith a ’sioncronadh nam feartan cumanta thairis air buadhan Matter agus Zigbee. Dèan cinnteach gu bheil an aon seòrsa dàta aig na buadhan a thathar a’ sioncronadh. Tha na buadhan coitcheann eadar Zigbee agus Matter air an stèidheachadh tro a file ris an canar multi-protocol.json . Faodaidh an neach-cleachdaidh dà bhuidheann sam bith a cheangal thairis air Zigbee agus Matter còmhla ris na buadhan co-fhreagarrach aca a’ cleachdadh na còdan brabhsair agus buadhan fa leth. Seo file ri lorg ann an [SDKPath]/app/zcl/multi-protocol.json . Seo file air ùrachadh le seata sònraichte de chlàran is bhuadhan an toiseach, ach faodaidh an neach-cleachdaidh seo ùrachadh file mar a dh ’fheumar agus bheir ZAP aire do bhith a’ sioncronadh rèiteachadh buadhan thairis air Zigbee agus Matter airson aithnichearan crìochnachaidh cumanta.
Gheibh thu cuideachd oideachadh ZAP ann an tagradh ioma-phròtacal Zigbee and Matter sam bith fon duilleag clasaichean. Bidh an oideachadh seo gad stiùireadh tron phròiseas cruthachadh tagradh ioma-phròtacal. Chan eil an oideachadh seo ri fhaighinn ach nuair a dh’ fhosglas tu tagradh ioma-phròtacal a tha ann mu thràth agus gheibhear e mar a chithear san dealbh gu h-ìosal:

34/35

Amalachadh SLC CLI le ZAP
Amalachadh SLC CLI le ZAP
Amalachadh SLC CLI le ZAP
Lean na ceumannan seo gus an SLC CLI fhilleadh a-steach le ZAP: ò Stàlaich SLC CLI le bhith a’ leantainn an stiùiridh stàlaidh ann an Stiùireadh Cleachdaiche Simplicity Studio 5. o Stàlaich ZAP le bhith a’ leantainn an stiùiridh anns an ZAP Installation Guide. ô Gus SLC CLI fhilleadh a-steach le ZAP, cuir caochladair àrainneachd STUDIO_ADAPTER_PACK_PATH a tha a’ comharrachadh an aplacaid ZAP
eòlaire. õ Cuimhnich gun ath-thòisich SLC CLI Daemon às deidh ceum 3. ö Cleachdaidh pròiseact sam bith a chleachdas ZAP a-nis an t-slighe a tha air a mhìneachadh ann an ceum 3 nuair a thèid a chruthachadh bho SLC CLI. Feuch an toir thu sùil air SLC CLI
Cleachdadh airson stiùireadh mu bhith a’ cleachdadh SLC CLI airson do phròiseactan.

35/35

Sgrìobhainnean/Goireasan

SILICON LABS ZAP a’ leasachadh le Silicon Labs [pdfLeabhar-làimhe an t-Sealbhadair
ZAP a’ leasachadh le Silicon Labs, ZAP, A’ leasachadh le Silicon Labs, Silicon Labs, Labs

Iomraidhean

Leabhar-làimhe cleachdaiche

ZAP a’ leasachadh le Silicon Labs

Sònrachaidhean

Stiùireadh airson cleachdadh bathar

Ceistean Cumanta

A’ leasachadh le Silicon Labs ZAP

ZAP a’ tòiseachadh

Stàladh ZAP

Bun-bheachdan ZAP

Custom XML

Custom XML Tags airson Zigbee

Ioma seòrsa inneal a rèir puing crìochnachaidh

Smachd Ruigsinneachd

A’ cruthachadh còd airson Matter or Zigbee

Ùraich ZAP ann an Stiùidio

Sgrìobhainnean/Goireasan

Iomraidhean

Fàg beachd

Sguir an fhreagairt