Idagbasoke ZAP Pẹlu Afọwọṣe Oniwun Awọn Labs Silicon

ZAP Bibẹrẹ
- Lati bẹrẹ pẹlu ZAP, tẹle awọn igbesẹ wọnyi:
  - Ṣe igbasilẹ ZAP Executable lati ibi ipamọ osise.
  - Fi awọn igbẹkẹle sori ẹrọ nipa lilo pipaṣẹ fifi sori ẹrọ npm.
  - Fun fifi sori Windows-pato, tọka si Fifi sori ZAP fun itọsọna Windows OS.
Zigbee Development
- Ti o ba n ṣe agbekalẹ awọn ohun elo Zigbee:
  - Lo Simplicity Studio eyiti o pẹlu ZAP ati awọn irinṣẹ pataki miiran.

Idagbasoke ọrọ
- Ti o ba n ṣe agbekalẹ awọn ohun elo Matter:
  - Awọn aṣayan pẹlu lilo Simplicity Studio tabi iraye si Silicon Labs tabi awọn ibi ipamọ CSA Github.
  - Tọkasi awọn ilana imudojuiwọn fun ZAP ni ita Simplicity Studio itusilẹ ọmọ ti o ba nilo.

FAQs

Q: Kini awọn ẹya oriṣiriṣi ti awọn alakomeji ZAP ti o wa?
- A: Awọn ẹya meji wa ti o wa - Itusilẹ osise pẹlu awọn itumọ ti a ti rii daju ati itusilẹ tẹlẹ pẹlu awọn ẹya tuntun.

Q: Kini MO yẹ ki n ṣe ti MO ba pade awọn iṣoro akojọpọ ile-ikawe abinibi lakoko fifi sori ẹrọ?
- A: Tọkasi alaye FAQ nipa awọn iwe afọwọkọ-ipilẹ kan pato lati yanju iru awọn ọran naa.

“`

View Fullscreen

Silikoni Labs ZAP
Silikoni Labs ZAP

Dagbasoke pẹlu Silicon Labs ZAP

Bibẹrẹ
ZAP Bibẹrẹ Loriview Fifi sori ZAP fifi sori ẹrọ ZAP Windows FAQ
Awọn ipilẹ ZAP Awọn ipilẹ
Itọsọna olumulo ZAP Itọsọna olumulo Loriview Aṣa XML Aṣa XML Tags fun Awọn iru Ẹrọ Ọpọ Zigbee Fun Ipari Ohun elo Iru Ẹya Oju-iwe Awọn Iwifunni Data-Awoṣe/Iṣakoso Ijẹwọgbigba Iṣepe ZCL Ṣiṣe ifilọlẹ ZAP fun Ohun elo tabi awọn ohun elo Zigbee Ṣiṣe koodu fun Matter tabi imudojuiwọn ZAP ni Studio Concurrent Multi-protocol laarin Zigbee ati Matter Integrate SLC CLI pẹlu ZAP

1/35

Dagbasoke pẹlu Silicon Labs ZAP
Dagbasoke pẹlu Silicon Labs ZAP
ZAP
ZAP jẹ ẹrọ iran koodu jeneriki ati wiwo olumulo fun awọn ohun elo ati awọn ile ikawe ti o da lori Ile-ikawe Cluster Zigbee lati Zigbee tabi Awoṣe Data lati ọrọ. Sipesifikesonu jẹ idagbasoke nipasẹ Alliance Standards Asopọmọra. ZAP gba ọ laaye lati ṣe awọn iṣẹ wọnyi:
Ṣiṣe SDK-kan pato iran ti adani ti gbogbo awọn ohun-ọṣọ agbaye (awọn iduro, awọn oriṣi, ID, ati bẹbẹ lọ) ti o da lori sipesifikesonu ZCL/Data-Awoṣe. Ṣiṣe SDK-kan pato iran ti adani ti gbogbo olumulo-yan atunto onisebaye (ohun elo iṣeto ni, endpoint iṣeto ni, ati bẹ bẹ lori) da lori ZCL/Data-Awoṣe sipesifikesonu ati onibara-pese ohun elo iṣeto ni. Pese UI fun olumulo ipari lati yan iṣeto ohun elo kan pato (awọn aaye ipari, awọn iṣupọ, awọn abuda, awọn aṣẹ, ati bẹbẹ lọ).

Awọn akoonu ti o wa ninu awọn apakan wọnyi ṣe apejuwe bi o ṣe le ṣe agbekalẹ awọn ohun elo Zigbee ati Matter nipa tito leto ZCL (Zigbee) tabi Data Awoṣe (Matter) Layers lilo ZAP.

2/35

ZAP Bibẹrẹ

ZAP Bibẹrẹ
Bibẹrẹ pẹlu ZAP
Awọn apakan wọnyi ṣe apejuwe awọn ọna oriṣiriṣi lati ṣẹda awọn ohun elo Zigbee ati Matter. Ṣe akiyesi pe Simplicity Studio n pese ọna lati ṣẹda awọn ohun elo Zigbee ati Matter lati opin si opin nibiti gbogbo awọn irinṣẹ wa ti fi sii tẹlẹ pẹlu Simplicity Studio (pẹlu ZAP). O tun le pinnu lati ṣawari awọn ọna miiran ti ṣiṣẹda awọn ohun elo rẹ, bi a ti ṣalaye nibi.
Zigbee Development
Awọn olupilẹṣẹ ohun elo Zigbee le kọ awọn ohun elo wọn ni lilo Simplicity Studio, eyiti o pẹlu ZAP tẹlẹ ati awọn irinṣẹ miiran ti o ṣe iranlọwọ fun ọ lati kọ ohun elo rẹ lati opin si opin.
Idagbasoke ọrọ
Awọn olupilẹṣẹ Ohun elo Ohun elo le kọ awọn ohun elo wọn ni lilo awọn ọna atẹle: Simplicity Studio: Eyi pẹlu ZAP ati awọn irinṣẹ miiran eyiti o nilo lati kọ ohun elo Ohun elo opin si ipari. Github (Silicon Labs) Github (CSA)
Akiyesi: Lati ṣe imudojuiwọn ZAP ni ita ọna itusilẹ Studio Simplicity, wo imudojuiwọn ZAP ni Simplicity Studio ati Itọsọna Fifi sori ZAP

3/35

Fifi sori ZAP

Awọn apakan atẹle yii ṣe apejuwe fifi sori ZAP ati bii o ṣe le ṣe imudojuiwọn ZAP ni IDE Studio Simplicity.
Ṣiṣe igbasilẹ ZAP ti a ṣe iṣeduro)
Eyi ni ọna ti a ṣeduro fun bibẹrẹ pẹlu ZAP. O le gba awọn alakomeji ZAP tuntun lati aa https://github.com/project-chip/zp/releses. Awọn alakomeji ti a ti kọ tẹlẹ wa ni awọn ẹya oriṣiriṣi meji.
Itusilẹ osise: Awọn ile ti a rii daju pẹlu ọrọ iyasọtọ ati awọn suites idanwo Zigbee. Ọna kika orukọ itusilẹ jẹ vYYYY.DD.MM. Itusilẹ-ṣaaju: Kọ pẹlu awọn ẹya tuntun ati awọn atunṣe kokoro ṣugbọn awọn ile wọnyi ko ni ijẹrisi pẹlu Matter igbẹhin ati awọn suites idanwo Zigbee. Ọna idasilẹ orukọ jẹ vYYYY.DD.MM-nightly.
Fifi ZAP lati Orisun
Awọn ilana ipilẹ lati fi sori ẹrọ ZAP
Nitori eyi jẹ ohun elo node.js, o nilo agbegbe ipade ti a fi sori ẹrọ. Ọna ti o dara julọ lati ṣe eyi ni igbasilẹ fifi sori ẹrọ tuntun ti node, eyiti o pẹlu node ati npm. Ti o ba ni ẹya agbalagba ti ipade ti a fi sori ẹrọ lori ibi iṣẹ rẹ, o le fa awọn ọran, paapaa ti o ba ti dagba pupọ. Rii daju pe o ni ẹya tuntun v16.x node pẹlu npm ti o wa pẹlu. Ṣiṣe node –version lati ṣayẹwo iru ẹya wo ni o ti gbe. v18.x niyanju. Lẹhin ti o ni ẹya ti o fẹ ti ipade, o le ṣiṣe atẹle naa:
Fi sori ẹrọ Awọn igbẹkẹle
Lo awọn aṣẹ wọnyi lati fi awọn igbẹkẹle sori ẹrọ:

npm fi sori ẹrọ
Akiyesi: Fun fifi sori ZAP kan pato Windows, wo Fifi sori ZAP fun Windows OS Kii ṣe loorekoore lati ṣiṣẹ sinu awọn iṣoro akojọpọ ikawe abinibi ni aaye yii. Orisirisi awọn iwe afọwọkọ src-src/fi sori ẹrọ-* wa fun awọn iru ẹrọ oriṣiriṣi. Wo alaye FAQ nipa iru iwe afọwọkọ lati ṣiṣẹ lori awọn iru ẹrọ oriṣiriṣi ati lẹhinna tun npm fi sori ẹrọ .
Bẹrẹ Ohun elo naa
Lo awọn aṣẹ wọnyi lati bẹrẹ ohun elo naa:

npm ṣiṣe zap
Bẹrẹ Iwaju-Ipari ni Ipo Idagbasoke
Ṣe atilẹyin gbigba koodu gbigbona, ijabọ aṣiṣe, ati bẹbẹ lọ. Lo awọn aṣẹ atẹle lati bẹrẹ opin-iwaju ni idagbasoke
mode:
quasar dev -m elekitironi
or

4/35

ZAP Insta ati iwọ yoo wọle
npm ṣiṣe elekitironi-dev

5/35

Windows fifi sori ZAP
Windows fifi sori ZAP
Fifi sori ZAP fun Windows OS
1. Windows Powershell
Ninu ọpa wiwa tabili tabili, tẹ Windows Powershell wọle ati ṣiṣẹ bi oluṣakoso. Ṣiṣe gbogbo awọn aṣẹ wọnyi ninu Powershell.
2. Chocolatey
Fi sori ẹrọ lati https://chocolatey.org/install. Ṣayẹwo ti o ba fi sori ẹrọ daradara pẹlu awọn aṣẹ wọnyi:
choco -v
Fi sori ẹrọ pkgconfiglite package pẹlu awọn aṣẹ wọnyi:
choco fi sori ẹrọ pkgconfiglite
3. Fi sori ẹrọ Node
Ṣiṣe awọn aṣẹ wọnyi lati fi sori ẹrọ:
choco fi sori ẹrọ nodejs-lts
* Ẹya naa gbọdọ jẹ 18 lati kọja idanwo ayẹwo ẹya, lẹhin fifi sori ẹrọ, ṣayẹwo pẹlu node -v *Ti o ba ti fi Node sori ẹrọ tẹlẹ, ti o kuna diẹ ninu awọn idanwo ti o jọra si ko le rii Node, tun fi Node pẹlu chocolatey lẹẹkansii.
4. Tẹle Awọn Ilana Ipilẹ lati Fi ZAP sori ẹrọ
Tẹle awọn ilana fifi sori ZAP lati orisun ni Fifi sori ZAP. Lakoko ti o tẹle awọn ilana ipilẹ fun fifi ZAP sori ẹrọ ṣọra fun awọn aṣiṣe wọnyi ati bii o ṣe le yanju wọn:
sqlite3
Nigbati o ba nṣiṣẹ ZAP (fun apẹẹrẹ, npm run zap), ti o ba ri aṣiṣe nipa sqlite3.node ni window agbejade, ṣiṣe:
npm tun sqlite3
elekitironi-Akole
Nigbati o ba n ṣe fifi sori ẹrọ npm, ni fifi sori ẹrọ, ti aṣiṣe ba waye lori aṣẹ atẹle ti o ni ibatan si elekitironi-akọle install-appdeps , npx electron-rebuild canvas fail or node-pre-gyp , ẹyà kanfasi lọwọlọwọ ko ni ibamu pẹlu Windows ati aṣiṣe fifi sori kii yoo fa ikuna ni ṣiṣe ZAP. node-canvas n ṣiṣẹ lori ojutu ni bayi ati pe ọrọ naa yoo yanju ni ọjọ iwaju nitosi.
“fifi sori ẹrọ”: “electron-builder install-app-deps && husky install && npm rebuild canvas –update-binary && npm run version-stamp”

6/35

Windows fifi sori ZAP
Kanfasi
Ti idanwo ṣiṣe npm ba kuna nitori aṣiṣe suite Idanwo kuna lati ṣiṣẹ. Ko le ri module '../build/Release/canvas.node' tabi
zapnode_modulescanvasbuildReleasecanvas.node kii ṣe ohun elo Win32 ti o wulo. , tun kanfasi kọ bi atẹle:
npm atunṣe kanfasi - imudojuiwọn-alakomeji
gba index.html tabi Awọn oran olupin miiran
Ti idanwo ṣiṣe npm ba kuna nitori aṣiṣe gba index.html ibeere kuna pẹlu koodu ipo 404 ninu awọn idanwo ẹyọkan tabi nini olupin
awọn ọran asopọ ni awọn idanwo e2e-ci, ṣiṣe awọn aṣẹ wọnyi:
npm ṣiṣe kọ
Omiiran
Ṣayẹwo boya ẹya node jẹ v18 ati gbiyanju lati fi sii pẹlu Chocolatey.

7/35

FAQ
FAQ
Awọn ibeere Nigbagbogbo
Q: Bii o ṣe le bẹrẹ UI ni ipo idagbasoke kan? A: O le bẹrẹ UI ni ipo idagbasoke, eyiti yoo ja si ni iṣeto atẹle:
Olupin HTTP quasar idagbasoke lọtọ, eyiti o ṣe isọdọtun laaye lori ibudo 8080 ZAP ẹhin ipari ti nṣiṣẹ lori ibudo 9070 Chrome tabi ẹrọ aṣawakiri miiran, nṣiṣẹ ni ominira Lati lọ si iṣeto yẹn, tẹle awọn itọnisọna ni isalẹ. ò Ni akọkọ, ṣiṣe olupin idagbasoke ZAP, eyiti o bẹrẹ lori ibudo 9070.
npm run zap-devserver ó Nigbamii ti, ṣiṣe olupin idagbasoke quasar, eyiti o bẹrẹ lori ibudo 8080.
Quasar dev ô Tọka aṣàwákiri rẹ tabi ṣiṣe ọkan lodi si awọn to dara URL pẹlu ariyanjiyan restPort:
google-chrome http://localhost:8080/?restPort=9070

Q: Bawo ni lati ṣe iṣẹ yii lori Mac / Linux OS? A:
npm fi sori ẹrọ ni a lo lati ṣe igbasilẹ gbogbo awọn idii igbẹkẹle ti a beere. Ti o ba ri awọn aṣiṣe ti o ni ibatan si node-gyp ati awọn ile-ikawe agbegbe ti o padanu, bii pixman, ati bẹbẹ lọ, o padanu awọn igbẹkẹle abinibi lati ni itẹlọrun lati ṣajọ awọn alakomeji node ti kii ṣe tẹlẹ fun diẹ ninu awọn akojọpọ awọn iru ẹrọ ati awọn ẹya. Npm lori awọsanma n ṣe imudojuiwọn atokọ nigbagbogbo ti awọn alakomeji ti a pese, nitorinaa o ṣee ṣe pe iwọ yoo gbe wọn ni itanran, ṣugbọn ti o ko ba ṣe bẹ, iwọnyi jẹ awọn ilana fun awọn iru ẹrọ oriṣiriṣi:
Fedora Core pẹlu dnf:
dnf fi sori ẹrọ pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
tabi ṣiṣe akosile:
src-akosile / fi sori ẹrọ-packages-fedora
Ubuntu pẹlu apt-gba:
apt-gba imudojuiwọn apt-gba fifi sori ẹrọ –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
tabi ṣiṣe akosile:

8/35

FAQ
src-script/fi sori ẹrọ-awọn idii-ubuntu
OSX lori Mac kan pẹlu Homebrew pọnti:
pọnti fi sori ẹrọ pkg-konfigi cairo pango libpng jpeg giflib librsvg
tabi ṣiṣe akosile:
src-akosile / fi sori ẹrọ-packages-osx
Q: Bawo ni lati ṣe iṣẹ yii lori Windows OS?
A: Rii daju pe o jẹ imudojuiwọn nigbagbogbo ati pe ko si awọn ayipada ti a ko ti ṣe. Imọran: git fa, ipo git & git stash jẹ awọn ọrẹ rẹ. O gbọdọ lo Chocolately lati jẹ ki Zap ṣiṣẹ lori Windows OS. Rii daju lati ṣe igbasilẹ package pkgconfiglite.
choco fi sori ẹrọ pkgconfiglite
Ti o ba ni awọn ọran pẹlu cairo, fun example ti o ba gba ohun ašiše nipa cairo.h': Ko si iru file tabi liana, ṣe awọn wọnyi: ò Ṣayẹwo boya kọmputa rẹ jẹ 32 tabi 64 bit. Ó da lori iyẹn, ṣe igbasilẹ package ti o yẹ lati aaye yii
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:
Tẹ Awọn Eto Eto To ti ni ilọsiwaju. Ninu taabu to ti ni ilọsiwaju tẹ lori Awọn iyipada Ayika. Ni apakan Awọn iyipada Eto, wa iyipada ayika PATH ki o yan. Tẹ Ṣatunkọ ati ṣafikun C:/GTK si. Ti iyipada ayika PATH ko ba si, tẹ Titun. Ti a ko ba ri jpeglib.h, gbiyanju nkan wọnyi: ò Lori ebute, ṣiṣe: choco install libjpeg-turbo ó Rii daju pe o mọ nipa lilo: git clean -dxff ati ṣiṣe npm fi sori ẹrọ lẹẹkansi ô ti ko ba si awọn aṣiṣe waye ti awọn ikilọ nikan han, gbiyanju lati lo npm audit fix õ ti o ko ba le ṣiṣẹ ZAP, lọ si file src-script/zap-start.js ö Yipada
÷ const { spawn } = beere ('cross-spawn') lati const { spawn } = beere('child_process') ø Ṣiṣe npm ati ṣiṣe zap. Awọn itọkasi:
https://github.com/fabricjs/fabric.js/issues/3611 https://github.com/benjamind/delarre.docpad/blob/master/src/documents/posts/installing-node-canvas-for-windows.html.md [https://chocolatey.org/packages/libjpeg-turbo#dependencies](https://chocolatey.org/packages/libjpeg-turbo#dependencies)
Q: Mo gba aṣiṣe "sqlite3_node" ko ri tabi iru.

9/35

FAQ
A: Tun rẹ abinibi sqlite3 abuda. Lati ṣatunṣe eyi ni ọpọlọpọ igba, ṣiṣe:
npm fi sori ẹrọ
./node_modules / .bin / itanna-atunṣe -w sqlite3 -p
Ti ko ba tun ṣe atunṣe, ṣe:
rm -rf node_modules ati lẹhinna gbiyanju awọn aṣẹ loke lẹẹkansi. Nigbakugba iṣagbega npm rẹ tun ṣe iyatọ:
npm fi sori ẹrọ -g npm
Q: Mo gba aṣiṣe “Ẹya N-API ti apẹẹrẹ Node yii jẹ 1. Ẹya yii ṣe atilẹyin ẹya N-API (awọn) 3. Apeere Node yii ko le ṣiṣẹ module yii.”
A: Ṣe igbesoke ẹya ipade rẹ. Ojutu fun eyi ni a jiroro ninu o tẹle Stack Overflow yii: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Q: PC idagbasoke mi ko ṣiṣẹ pẹlu ZAP fun ohunkohun ti idi. Ṣe Mo le lo apo eiyan docker?
A: Bẹẹni o le. TBD.
Q: Bawo ni MO ṣe nṣiṣẹ ZAP inu VSCode?
A: Ti o ba VSCode ni ọna rẹ tẹ zap repo ki o si tẹ koodu . Eyi yoo ṣii ZAP ni VSCode. Lati ṣiṣẹ ZAP ni ipo yokokoro, yan aaye iṣẹ ZAP ki o tẹ aami Ṣiṣe lori ọpa irinṣẹ ọwọ osi. Iwọ yoo ni awọn aṣayan meji lati yan lati ṣiṣe ZAP, yan Node.js Terminal Debug . Eyi yoo ṣii window ebute kan lati eyiti o le tẹ npm run zap , eyi ti yoo so olu ṣatunṣe aṣiṣe naa ati ṣiṣe ZAP bi o ṣe le ṣe deede lati laini aṣẹ. A ku oriire, o yẹ ki o rii bayi ZAP ti n ṣiṣẹ ni yokokoro. O le ṣeto awọn aaye fifọ ni VSCode bi o ṣe le ṣe ni IDE miiran.
Q: Idanwo ẹyọ UI kuna pẹlu diẹ ninu awọn aṣiṣe ni ayika kanfasi ko kọ fun ẹya ọtun ti ipade. Ki ni ki nse?
A: Ti o ba ri aṣiṣe wọnyi:
FAIL test/ui.test.js Igbeyewo suite kuna lati ṣiṣẹ module 'canvas.node' ni a ṣe akojọpọ lodi si ẹya Node.js ti o yatọ ni lilo NODE_MODULE_VERSION 80. Ẹya Node.js yii nilo NODE_MODULE_VERSION 72. Jọwọ gbiyanju tun-kojọpọ tabi tun fi sori ẹrọ module`n tabi tun fi sii` (fun apẹẹrẹ, fun apẹẹrẹ).
ni Nkan. ( node_modules/canvas/lib/bindings.js:3 18)
ki o si sure: npm rebuild canvas –update-binary

10/35

Awọn ipilẹ ZAP

ZCL/Data-Awoṣe ZAP Pataki
Abala yii ni alaye ninu fun awọn olumulo ZAP tuntun. Tẹ aami ikẹkọ ni igun apa ọtun loke ti ZAP UI, eyiti o fihan bi o ṣe le ṣẹda iṣeto ZAP kan. Ikẹkọ naa yoo ṣe itọsọna fun ọ nipasẹ atẹle yii: Ṣẹda aaye ipari Yan iru ẹrọ kan Ṣe atunto iṣupọ kan Ṣeto ẹda kan Ṣeto aṣẹ kan Fun itọkasi alaye, wo Itọsọna Iṣeto Iṣọkan ti Zigbee

11/35

ZAP olumulo ká Itọsọna
ZAP olumulo ká Itọsọna
ZAP olumulo ká Itọsọna
Awọn apakan labẹ itọsọna yii pese awọn alaye diẹ sii nipa awọn ẹya oriṣiriṣi ti a pese nipasẹ ZAP.

12/35

XML aṣa

Ṣafikun Aṣa XML lati ZAP UI
Tẹ aami “Awọn amugbooro” ni ZAP UI. Tẹ bọtini “+” ṣafikun lati yan aṣa xml kan file Awọn iṣupọ aṣa, awọn abuda, awọn aṣẹ, ati bẹbẹ lọ yẹ ki o ṣafihan ni ZAP UI ni kete ti a ti ṣafikun xml aṣa.
Ṣiṣẹda XML aṣa tirẹ ni Zigbee
Abala naa fihan bi o ṣe le ṣẹda awọn iṣupọ aṣa tirẹ ati fa awọn iṣupọ boṣewa ti o wa pẹlu awọn abuda aṣa ati awọn aṣẹ fun Zigbee.
Awọn iṣupọ Olupese-Pato ni Zigbee
O le ṣafikun awọn iṣupọ olupese-pato si pro boṣewa kanfile. A pese ohun example ti yi ni isalẹ. Lati ṣe eyi o gbọdọ ni itẹlọrun awọn adehun meji:
ID iṣupọ gbọdọ wa ni ibiti olupese kan pato, 0xfc00 – 0xffff. Itumọ iṣupọ gbọdọ pẹlu koodu olupese kan eyiti yoo lo si GBOGBO awọn abuda ati awọn aṣẹ laarin iṣupọ yẹn ati pe o gbọdọ pese nigba fifiranṣẹ ati gbigba awọn aṣẹ ati ibaraenisepo pẹlu awọn abuda. Example:

Sample Mfg Specific iṣupọ Gbogboogbo Yi iṣupọ pese ohun Mofiample ti bii Ilana Ohun elo ṣe le faagun si lati pẹlu awọn iṣupọ olupese kan pato.
0xFC00
ember sample ro pe
ember sampẹya ara 2

A sample olupese-pato pipaṣẹ laarin awọn sample olupese-kan pato
iṣupọ.

Awọn aṣẹ Olupese-Pato ni Iṣupọ Zigbee Standard
O le ṣafikun awọn aṣẹ tirẹ si iṣupọ Zigbee boṣewa eyikeyi pẹlu awọn ibeere wọnyi:
Awọn aṣẹ kan pato ti olupese le lo id aṣẹ eyikeyi laarin iwọn id aṣẹ, 0x00 – 0xff. O tun gbọdọ pese koodu olupese fun aṣẹ ki o le ṣe iyatọ si awọn ofin miiran ninu iṣupọ ati mu ni deede. Example ti faagun iṣupọ Tan/Pa pẹlu awọn aṣẹ iṣelọpọ:

13/35

XML aṣa
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o pa ẹrọ naa pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificOnWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o tan ẹrọ naa pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificToggleWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o yi ẹrọ pada pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificOnWithTransition2″ iyan =”otitọ” olupeseCode=”0 1049″> Aṣẹ alabara ti o tan ẹrọ naa pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificToggleWithTransition2″ iyan =”otitọ”
olupeseCode=”0 1049″> Aṣẹ alabara ti o yi ẹrọ pada pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.

Olupese-Pato Awọn eroja ni Standard Zigbee Cluster
O le ṣafikun awọn abuda tirẹ si iṣupọ Zigbee boṣewa eyikeyi pẹlu awọn ibeere wọnyi:
Awọn abuda kan pato ti olupese rẹ le lo eyikeyi idamọ abuda laarin iwọn id ikasi, 0x0000 – 0xffff. O tun gbọdọ pese koodu olupese fun abuda naa ki o le ṣe iyatọ si awọn abuda miiran ninu iṣupọ ati mu ni deede. Example ti faagun iṣupọ Titan/Paa pẹlu awọn abuda iṣelọpọ:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” Iru=”INT16U” min=”0 0000″
max = "0xFFFF" kikọ = "otitọ" aiyipada = "0 0000" iyan = "otitọ" olupeseCode = "0 1002"> Sample Mfg Ni pato: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ Iru =”INT8U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 0000″ iyan=”otito” olupeseCode=”0 1049″>Sample Mfg Ni pato: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ Iru =”INT8U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 00″ iyan=”otito” olupeseCode=”0 1002″>Sample Mfg Ni pato: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ Iru =”INT16U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 0000″ iyan=”otito” olupeseCode=”0 1049″>Sample Mfg Ni pato: 0 0001 0 1040
Ṣiṣẹda XML aṣa tirẹ ni ọrọ
Abala naa fihan bi o ṣe le ṣẹda awọn iṣupọ aṣa tirẹ ati fa awọn iṣupọ boṣewa ti o wa pẹlu awọn abuda aṣa ati awọn aṣẹ fun Ọrọ.
Awọn iṣupọ Olupese-Pato ni Ọrọ
O le ṣafikun awọn iṣupọ olupese-pato si ni ọrọ. A pese ohun example ti yi ni isalẹ.
Awọn 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 aṣa
Ni awọn wọnyi example, apapo ID ataja (ID Olupese Idanwo) ti 0xFFF1 ati ID iṣupọ ti 0xFC20 awọn abajade ni value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Gbogboogbo Sample MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Awọn Sample MEI iṣupọ ṣe afihan iṣupọ olupese awọn amugbooro Ipadasẹyin airotẹlẹ
Idahun fun AddArguments ti o da apao pada. Aṣẹ ti o gba awọn ariyanjiyan uint8 meji ati da apao wọn pada. Aṣẹ ti o rọrun laisi awọn ayeraye eyikeyi ati laisi esi.
Olupese-Pato Awọn eroja ni Standard Ọrọ iṣupọ
O le ṣafikun awọn abuda kan pato ti olupese si iṣupọ ọrọ boṣewa eyikeyi pẹlu awọn ibeere wọnyi:
T aaaa o iṣupọ th t awọn ami-ara ti a n pin si gbọdọ jẹ pato -
e xte nd ed > >>
Koodu ti abuda naa jẹ apapọ 32-bit ti koodu olupese ati id fun ikasi naa. Awọn iwọn 16 pataki julọ jẹ koodu olupese. Iwọn fun awọn koodu olupese idanwo jẹ 0xFFF1 - 0xFFF4. Awọn die-die 16 pataki ti o kere julọ jẹ ID abuda. Iwọn fun awọn abuda ti kii ṣe agbaye jẹ 0x0000 - 0x4FFF.
Example ti faagun iṣupọ Ọrọ Titan/Paa pẹlu awọn abuda kan pato:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ Iru=”INT8U” min=”0 0000″
max = "0xFFFF" kikọ = "otitọ" aiyipada = "0 0000" iyan = "otitọ"> SampLe Mfg Specific Attribut 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ Iru=”INT16U” min=”0 0000″
max = "0xFFFF" kikọ = "otitọ" aiyipada = "0 0000" iyan = "otitọ"> SampLe Mfg Specific Attribut 4
Awọn aṣẹ Olupese-Pato ni Awọn iṣupọ Ọrọ Iṣaju
O le ṣafikun awọn aṣẹ kan pato olupese si iṣupọ ọrọ boṣewa eyikeyi pẹlu awọn ibeere wọnyi:
T aaa o iṣupọ ti awọn comm nds ti a ti sọ si gbọdọ jẹ pato -
e xte nd ed > >>
Koodu ti aṣẹ naa jẹ apapo 32-bit ti koodu olupese ati id fun aṣẹ naa. Awọn die-die 16 pataki julọ jẹ koodu olupese. Ibiti o fun awọn koodu olupese idanwo jẹ 0xFFF1 - 0xFFF4. Awọn die-die 16 pataki ti o kere julọ jẹ ID aṣẹ. Iwọn fun awọn aṣẹ ti kii ṣe agbaye jẹ 0x0000 - 0x00FF.
Example ti faagun iṣupọ Ọrọ Titan/Paa pẹlu awọn iṣupọ kan pato ti iṣelọpọ:

15/35

XML aṣa

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ iyan =”otitọ"> Aṣẹ alabara ti o tan ẹrọ naa pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ iyan =”otitọ">
Aṣẹ alabara ti o yi ẹrọ pada pẹlu iyipada ti a fun nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.

16/35

XML aṣa Tags fún Zigbee

Iwe atẹle yii sọrọ nipa ọkọọkan xml tags ni nkan ṣe pẹlu Zigbee.
xml kọọkan file ti wa ni akojọ laarin awọn configurator tags:

Data orisi le ti wa ni telẹ laarin awọn configurator tag. Lọwọlọwọ Zigbee ṣe atilẹyin itumọ ti awọn maapu, awọn nọmba, awọn nọmba, awọn okun tabi awọn ọna. Ṣaaju ki o to ṣalaye awọn iru diẹ sii rii daju lati ṣayẹwo gbogbo awọn iru atomiki ti o wa tẹlẹ ti a ṣalaye ni awọn iru.xml ati gbogbo awọn iru atomiki ti kii ṣe asọye ninu xml miiran files. O le setumo wọn bi wọnyi:
Bitmap: orukọ: orukọ iru bitmap. iru: Bitmap pẹlu iwọn laarin awọn 8-64 die-die ni a le ṣe alaye, gbogbo eyiti o yẹ ki o jẹ awọn nọmba ti 8. Kọọkan bitmap kọọkan le ni awọn aaye pupọ pẹlu orukọ ati iboju-boju ti o ni nkan ṣe pẹlu rẹ. fun apẹẹrẹ:

“`
Enum: orukọ: orukọ iru enum. iru: Enum pẹlu kan iwọn laarin 8-64 die-die le ti wa ni telẹ, gbogbo awọn ti eyi ti o yẹ ki o wa ọpọ ti 8. Kọọkan enum le ni ọpọ awọn ohun kan pẹlu orukọ kan ati ki o iye ni nkan ṣe pẹlu ti o. fun apẹẹrẹ:

Odidi: Orisi odidi ti wa ni asọye tẹlẹ labẹ awọn iru atomiki eyiti o wa ni awọn oriṣi.xml. Iwọn wọn le wa lati awọn die-die 8-64 ati pe o le fowo si tabi ko fowo si. fun apẹẹrẹ:

Okun: Awọn oriṣi okun ti wa ni asọye tẹlẹ labẹ awọn iru atomiki eyiti o wa ninu awọn oriṣi.xml. Awọn oriṣi okun lọwọlọwọ pẹlu okun octet, okun char, okun octet gigun ati okun char fun apẹẹrẹ:

Igbekale: orukọ: orukọ iru struct. Ẹya kọọkan le ni awọn ohun pupọ pẹlu orukọ ati iru ti o ni nkan ṣe pẹlu rẹ. Iru le jẹ awọn iru asọye tẹlẹ labẹ awọn iru data. fun apẹẹrẹ:

17/35

XML aṣa Tags fún Zigbee

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

Awọn iṣupọ Aṣa le ṣe asọye laarin oluṣeto tag. orukọ: orukọ ti awọn cluster domain: domain ti awọn iṣupọ. Iṣupọ naa yoo han ni ZAP UI labẹ agbegbe yii. apejuwe: Apejuwe koodu iṣupọ: koodu iṣupọ asọye: iṣupọ asọye eyiti o jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣalaye iṣupọ ni ọna kan olupeseCode: Ti a lo lati ṣalaye iṣupọ iṣelọpọ kan pato. Eyi ni lati wa laarin 0xfc00 – 0xffff. Koodu olupese fun iṣupọ nilo lati ṣalaye bi atẹle:

Iṣupọ iṣelọpọ laifọwọyi n ṣe awọn abuda ati awọn aṣẹ labẹ rẹ ti koodu olupese kanna ayafi ti wọn ṣe atokọ ni gbangba koodu olupese. IntroductionIn: Ti a lo lati pinnu ẹya pato ninu eyiti a ṣe agbekalẹ iṣupọ naa. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. kuroNi: Ti a lo lati pinnu ẹya pato ninu eyiti a ti yọ iṣupọ naa kuro. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. singleton(boolean): Ti a lo lati pinnu iṣupọ kan bi ẹyọkan kan gẹgẹbi apẹẹrẹ kan ṣoṣo ti iṣupọ yẹn ti o pin kọja awọn aaye ipari. abuda: asọye ẹya kan fun orukọ iṣupọ: Orukọ ẹda jẹ mẹnuba laarin ẹya tag.
ikalara orukọ
ẹgbẹ (onibara / olupin): Awọn ẹgbẹ ti iṣupọ si eyiti ẹda ti o ni nkan ṣe pẹlu. koodu: koodu olupese koodu eroja: Eleyi le ṣee lo lati setumo olupese kan pato abuda ita zigbee sipesifikesonu mẹnuba nipasẹ awọn boṣewa xml. setumo: asọye abuda eyiti o jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣalaye abuda kan ni iru ọna kan: iru ikasi eyiti o le jẹ eyikeyi awọn iru data ti a mẹnuba ninu aiyipada xml: iye aiyipada fun ẹda naa. min: Kere laaye iye fun ohun ro pe o pọju: O pọju laaye iye fun ohun kikọ kikọ: Jẹ ikalara iye kikọ tabi ko. Eyi le ṣee lo lati ṣe idiwọ abuda lati yipada nipasẹ awọn aṣẹ kikọ. iyan(boolean): Lo lati pinnu boya ẹya jẹ iyan tabi kii ṣe fun iṣupọ. min: Kere laaye iye fun ohun ro pe nigba ti o jẹ ẹya odidi, enum tabi bitmap iru. max: O pọju laaye iye fun awọn ro pe nigba ti o jẹ ẹya odidi, enum tabi bitmap iru ipari: Lo lati tokasi awọn ti o pọju ipari ti awọn ro nigba ti o jẹ ti iru okun. minLength: Ti a lo lati pato ipari to kere julọ ti abuda nigbati o jẹ ti iru okun. reportable(Boolian): Sọ ti o ba ti ẹya ro pe jẹ reportable tabi ko isNullable(boolean): Faye gba asan iye fun awọn ro pe. array (Boolian): Ti a lo lati sọ ẹya iru orun. IntroductionIn: Ti a lo lati pinnu ẹya pato ninu eyiti a ṣe afihan abuda naa. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. kuroIn: Ti a lo lati pinnu ẹya pato ninu eyiti a ti yọ abuda naa kuro. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. pipaṣẹ: setumo aṣẹ kan fun orukọ iṣupọ: Orukọ aṣẹ.

koodu: pipaṣẹ koodu

18/35

XML aṣa Tags fún Zigbee
koodu olupese: Eyi le ṣee lo lati ṣalaye aṣẹ olupese kan ni ita sipesifikesonu zigbee ti a mẹnuba nipasẹ boṣewa xml. apejuwe: apejuwe ti awọn pipaṣẹ orisun (onibara / olupin): orisun ti awọn pipaṣẹ. iyan (boolean): Ti a lo lati pinnu boya aṣẹ kan jẹ iyan tabi kii ṣe fun iṣupọ. notIn: Lo lati mọ awọn spec version ninu eyi ti awọn pipaṣẹ ti a ṣe. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. kuroIn: Ti a lo lati pinnu ẹya pato ninu eyiti a ti yọ aṣẹ kuro. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. awọn ariyanjiyan pipaṣẹ:
Aṣẹ kọọkan le ni eto awọn ariyanjiyan aṣẹ orukọ: orukọ iru ariyanjiyan aṣẹ: iru ariyanjiyan aṣẹ eyiti o le jẹ eyikeyi awọn iru ti a mẹnuba ninu xml. min: Kere laaye iye fun ohun ariyanjiyan nigbati o jẹ ẹya odidi, enum tabi bitmap iru. max: O pọju laaye iye fun ohun ariyanjiyan nigba ti o jẹ ẹya odidi, enum tabi bitmap iru ipari: Lo lati tokasi awọn ti o pọju Allowable ipari fun a aṣẹ ariyanjiyan nigbati o jẹ ti iru okun. minLength: Lo lati pato awọn kere Allowable ipari fun a ariyanjiyan pipaṣẹ nigbati o jẹ ti iru okun. array (Boolian): Lati pinnu boya ariyanjiyan pipaṣẹ jẹ iru orun. presentIf (okun): Eyi le jẹ okun ipo ti awọn iṣẹ ọgbọn ti o da lori awọn ariyanjiyan aṣẹ miiran nibiti o le nireti ariyanjiyan aṣẹ ti okun ipo ba ṣe iṣiro si otitọ. fun apẹẹrẹ:

Akiyesi: Ipo nihin jẹ orukọ ariyanjiyan aṣẹ miiran. iyan (Boolian): Ti a lo lati pinnu ariyanjiyan aṣẹ bi iyan. countArg: Ti a lo nigbati ariyanjiyan pipaṣẹ jẹ ti titobi oriṣi. Eyi ni a lo lati darukọ ariyanjiyan aṣẹ miiran eyiti o tọka iwọn titobi fun ariyanjiyan yii.

notIn: Lo lati mọ awọn spec version ninu eyi ti awọn ariyanjiyan pipaṣẹ ti a ṣe. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. kuroIn: Ti a lo lati pinnu ẹya pato ninu eyiti a ti yọ ariyanjiyan pipaṣẹ kuro. Eyi jẹ lilo nipasẹ olupilẹṣẹ koodu lati ṣafikun imọ-jinlẹ afikun. Itẹsiwaju iṣupọ le jẹ asọye laarin atunto tag. Iṣaagun iṣupọ jẹ lilo lati faagun iṣupọ boṣewa kan pẹlu awọn abuda iṣelọpọ ati awọn aṣẹ fun apẹẹrẹ

19/35

XML aṣa Tags fún Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” Iru =”INT16U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 0000″ iyan=”otito” olupeseCode=”0 1002″>Sample Mfg Ni pato: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ Iru =”INT8U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 0000″ iyan=”otito” olupeseCode=”0 1049″>Sample Mfg Ni pato: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ Iru =”INT8U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 00″ iyan=”otito” olupeseCode=”0 1002″>Sample Mfg Ni pato: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ Iru =”INT16U” min =”0 0000″ max=”0xFFFF”writable=”otitọ” aiyipada=”0 0000″ iyan=”otito” olupeseCode=”0 1049″>Sample Mfg Ni pato: 0 0001 0 1040ampleMfgSpecificOffWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o pa ẹrọ naa pẹlu iyipada ti a fun
nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificOnWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o tan ẹrọ naa pẹlu iyipada ti a fun
nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificToggleWithTransition” iyan =”otitọ” manufacturerCode=”0 1002″> Aṣẹ alabara ti o yi ẹrọ pada pẹlu iyipada ti a fun
nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificOnWithTransition2″ iyan =”otitọ” olupeseCode=”0 1049″> Aṣẹ alabara ti o tan ẹrọ naa pẹlu iyipada ti a fun
nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.ampleMfgSpecificToggleWithTransition2″ iyan =”otitọ” olupeseCode=”0 1049″> Aṣẹ alabara ti o yi ẹrọ pada pẹlu iyipada ti a fun
nipasẹ akoko iyipada ni Ember Sample orilede akoko ro pe.

20/35

Multiple Device Orisi Per Endpoint

Eyi jẹ ẹya Ọrọ-nikan nibiti olumulo le yan iru ẹrọ diẹ sii ju ọkan lọ fun aaye ipari. Awọn afikun ti awọn iru ẹrọ aaa pupọ yoo dd awọn atunto iṣupọ laarin awọn iru ẹrọ si atunto ipari ipari.

21/35

Multiple Device Orisi Per Endpoint

Aworan ti o wa loke fihan pe ipari ipari 1 ni diẹ ẹ sii ju awọn iru ẹrọ kan ti a yan. “Ẹrọ Akọbẹrẹ” n tọka iru ẹrọ akọkọ ti aaye ipari yoo ni nkan ṣe pẹlu. Iru ẹrọ akọkọ wa nigbagbogbo ni atọka 0 ti atokọ ti awọn iru ẹrọ ti a yan nitorina yiyan iru ẹrọ akọkọ ti o yatọ yoo yi aṣẹ ti awọn iru ẹrọ ti a yan pada. Awọn yiyan iru ẹrọ naa tun ni awọn idiwọ ti o da lori Sipesifikesonu Awoṣe Data. ZAP ṣe aabo fun awọn olumulo lati yan awọn akojọpọ aiṣedeede ti awọn iru ẹrọ lori aaye ipari nipa lilo awọn inira wọnyi.

22/35

Ohun elo Iru Ẹya Page
Ohun elo Iru Ẹya Page
Ohun elo Iru Ẹya Page
ZAP ṣe atilẹyin wiwo ati yiyi awọn ẹya ara ẹrọ Ọrọ ni oju-iwe ẹya iru ẹrọ. Awọn ẹya iru ẹrọ nikan ni pato-devices.xml ni ibi ipamọ CHIP yoo han.

Lilọ kiri si Oju-iwe Ẹya
ò Ṣe ifilọlẹ ZAP ni Ọrọ pẹlu ọrọ-si-ọjọ SDK. ó Ṣẹda ohun endpoint pẹlu a Matter ẹrọ iru. Tẹ bọtini Awọn ẹya ara ẹrọ Iru ẹrọ lori oke arin ti iṣupọ view. Ṣe akiyesi pe bọtini yii wa ni ZAP nikan
awọn atunto fun Matter ati nigbati data conformance wa ninu ọrọ SDK. Tite bọtini yii yoo ṣii aworan ti o wa loke.
Ibamu
Ibamu ṣe asọye iyan ati igbẹkẹle fun awọn abuda, awọn aṣẹ, awọn iṣẹlẹ, ati awọn iru data. O pinnu boya nkan kan jẹ dandan, iyan, tabi ti ko ṣe atilẹyin labẹ awọn atunto ZAP kan.
Ijẹrisi ẹya ara ẹrọ iru ẹrọ gba iṣaaju ju ibamu ẹya-ara iṣupọ. Fun example, awọn ẹya ara ẹrọ Lighting ni o ni iyan conformance ninu awọn Tan/pipa iṣupọ sugbon ti wa ni polongo bi dandan ni awọn Tan-Papa Light ẹrọ iru ti o ba pẹlu awọn Tan/pipa iṣupọ. Ṣiṣẹda ipari ipari pẹlu Iru ẹrọ Titan / Paa yoo ṣe afihan ẹya Imọlẹ bi dandan lori oju-iwe ẹya.
Ẹya Toggling
Lori oju-iwe ẹya, lẹhin ti o tẹ bọtini yiyi lati mu ṣiṣẹ tabi mu ẹya kan ṣiṣẹ, ZAP yoo:
Ṣe imudojuiwọn awọn eroja ti o somọ (awọn abuda, awọn aṣẹ, awọn iṣẹlẹ) lati ṣe atunṣe ibamu, ati ṣafihan ọrọ sisọ kan ti o nfihan awọn ayipada.

23/35

Oju-iwe Ẹya Iru Ẹrọ Ohun elo Ṣe imudojuiwọn ẹya diẹ ninu ẹya ẹya Map ti iṣupọ ti o somọ

Mu Ifọrọwọrọ Ẹya ṣiṣẹ

Pa Ọrọ sisọ Ẹya

Toggling jẹ alaabo fun diẹ ninu awọn ẹya nigbati ibamu wọn ni iye aimọ tabi fọọmu ti ko ni atilẹyin lọwọlọwọ t. Ninu ac se yii, ZAP yoo ṣe afihan awọn ikilo ninu ifitonileti ap ne.
a Wa Element Conform nce rnings

Nigbati o ba yi eroja pada, ZAP le ṣe afihan awọn ikilọ ibamu ẹrọ mejeeji ati awọn ikilọ ibamu. Ti o ba ti awọn ano ká ipinle ko ni ko baramu awọn ti ṣe yẹ conformance, ZAP yoo han a Ikilọ aami ati ki o wọle ìkìlọ ni iwifunni ap ne. Example ti ibamu mejeeji ati awọn ikilọ ibamu ti o han fun ipin kan:

24/35

Awọn iwifunni
Awọn iwifunni
Awọn iwifunni
Abala ti o tẹle n ṣalaye bi a ṣe fun awọn iwifunni si awọn olumulo ZAP ni UI.
Package iwifunni
Awọn iwifunni idii jẹ awọn ikilọ tabi awọn ifiranṣẹ aṣiṣe ti o somọ fun eyikeyi package kan pato ti o kojọpọ sinu ZAP. Fun example, ninu awọn aworan ti o wa ni isalẹ, titẹ aami ikilọ labẹ aaye ipo yoo mu ọ lọ si ọrọ sisọ kan ti o nfihan gbogbo awọn iwifunni fun package yẹn.

25/35

Awọn iwifunni
Awọn iwifunni Ikoni
Awọn iwifunni igba jẹ awọn ikilọ tabi awọn ifiranṣẹ aṣiṣe eyiti o ni nkan ṣe pẹlu igba olumulo kan. Awọn ikilọ/awọn aṣiṣe wọnyi ni a le rii nipa tite lori bọtini Awọn iwifunni ninu ọpa irinṣẹ lori oke ZAP UI. Fun example, aworan ti o wa ni isalẹ fihan oju-iwe awọn iwifunni igba lẹhin isc file ti kojọpọ sinu ZAP.

26/35

Data-Awoṣe/ZCL Ibamu pato
Data-Awoṣe/ZCL Ibamu pato
Awoṣe data ati Ibamu Ipesisọ ZCL
Ẹya yii ni ZAP ṣe iranlọwọ fun awọn olumulo lati rii awọn ikuna ibamu fun Awoṣe Data tabi ZCL pẹlu awọn atunto ZAP ti o wa tẹlẹ. Awọn ifiranṣẹ ikilọ fun awọn ikuna ibamu yoo han lori PAN Awọn iwifunni ni ZAP UI ati pe yoo tun wọle si console nigbati o nṣiṣẹ ZAP nipasẹ CLI. Ẹya ibamu lọwọlọwọ n pese awọn ikilọ fun ibamu iru ẹrọ ati ibamu iṣupọ lori aaye ipari.
Awọn ikilọ Ibamu ninu ZAP UI
Nigbati olumulo ba ṣi .zap kan file lilo ZAP UI wọn yoo rii awọn ikilọ ni pane awọn iwifunni ti ZAP UI fun gbogbo awọn ikuna ibamu. Fun example, aworan ti o wa ni isalẹ fihan oju-iwe awọn iwifunni igba lẹhin .zap kan file ti ṣii pẹlu awọn ọran ibamu.

Awọn ifiranṣẹ ifaramọ yoo lọ kuro ni kete ti awọn ọran ba ti yanju nipa lilo ZAP UI iru pe o le tọju abala awọn ọran ibamu to ku nikan. Awọn ikilọ tuntun yoo tun ṣafihan fun ibamu ti olumulo ba mu awọn eroja ti o jẹ dandan (iṣupọ/awọn aṣẹ/awọn abuda) ti iṣeto ni. Awọn ifitonileti ifaramọ sipesifikesonu yoo tọju abala awọn ikuna eyikeyi ti a ṣe sinu iṣeto ZAP ṣugbọn ṣe akiyesi pe awọn ikilọ eyiti o ṣafihan lakoko ṣiṣi .zap kan file jẹ alaye diẹ sii lori idi ti o kuna ibamu nigbati a ṣe afiwe si awọn ikilọ eyiti o ṣafihan lakoko ibaraenisepo pẹlu UI. Eyi jẹ nipasẹ apẹrẹ ati ayẹwo ibamu ni kikun ni a ṣe lakoko ṣiṣi ti .zap kan file.
Awọn ikilọ ibamu lori console

27/35

Data-Awoṣe/ZCL Ibamu pato
Nigbati olumulo ba ṣi .zap kan file lilo ZAP standalone UI tabi ZAP CLI wọn yoo rii awọn ikilọ ti o wọle sinu console/terminal fun gbogbo awọn ikuna ibamu. Fun example, awọn aworan ni isalẹ fihan igba iwifunni ikilo lori console / ebute lẹhin a .zap file ti ṣii pẹlu awọn ọran ibamu.

28/35

Iṣakoso wiwọle

Wiwọle Iṣakoso Awọn ẹya ara ẹrọ
ZAP ṣe atilẹyin iṣakoso wiwọle lori gbogbo awọn nkan ZCL. O wa ni isalẹ si imuse ti SDK lati ṣe maapu awọn ẹya wọnyi si awọn ẹya ti o nilo ati atilẹyin wiwọle iṣakoso awọn ẹya SDK. ZAP ni gbogbogbo n pese awoṣe data kan ati ẹrọ lati fi koodu pamọ sinu alaye-meta files ati tan kaakiri data yẹn si awọn awoṣe iran, laisi fifi awọn itumọ kan pato si awọn aaye data.
Awọn ofin ipilẹ
Iṣakoso wiwọle ZAP n ṣalaye awọn ofin ipilẹ mẹta, gẹgẹbi atẹle: ò operation : asọye bi nkan ti o le ṣee ṣe. Example: ka, kọ, okòwò. ó ipa: asọye bi a anfaani ti ẹya osere. Bi eleyi "View anfani”, “Ipa Isakoso”, ati ọmọ lori. ô modifiers: asọye bi awọn ipo iṣakoso iraye si pataki, gẹgẹbi data ifura aṣọ tabi data dopin aṣọ. Awọn ofin ipilẹ jẹ asọye ni metadata XML labẹ oke kan tag . Awọn atẹle jẹ ẹya exampAwọn itumọ ọrọ ipilẹ ti iṣakoso wiwọle:
<role type=”view"apejuwe="View anfani”/>
Eyi example asọye mẹta mosi, kika, kọ ati okòwò, meji modifiers ati mẹrin ipa.
Wiwọle Triplets
Ipo iraye si kọọkan kọọkan le jẹ asọye pẹlu iwọle mẹta ni XML. Access triplet ni a apapo ti ẹya isẹ, ipa ati modifier. Wọn jẹ iyan, nitorinaa o le ni ọkan ninu awọn wọnyi. Apakan ti o padanu ti meteta ni gbogbogbo tumọ si awọn iyọọda, eyiti o jẹ imuse-pato fun SDK ti a fun. Nkankan ti o ṣalaye iwọle si le ni iraye si ọkan tabi diẹ ẹ sii awọn meteta. Awọn atẹle jẹ ẹya example:
ni0
Eyi jẹ itumọ ti abuda kan ti o ni iraye si meteta, n ṣalaye pe o gba iṣẹ kikọ laaye nipasẹ ipa iṣakoso kan, pẹlu iyipada-dopin aṣọ ti a lo.
Awọn igbanilaaye aiyipada

29/35

Iṣakoso wiwọle
Awọn nkan ZCL le ṣalaye awọn igbanilaaye ti ara wọn. Sibẹsibẹ, itumọ agbaye tun wa ti awọn igbanilaaye aiyipada fun
fi fun orisi. Iwọnyi jẹ ipinnu fun nkan ti a fun, ayafi ti o pese eyikeyi awọn igbanilaaye kan pato ti tirẹ.
Awọn igbanilaaye aiyipada jẹ ikede nipasẹ a tag ni ipele oke ti XML file. Eksample:
aa a<ccess op=”ipe”/> a a aa <ccess op=”re d”/> a<ccess op=”kọ”/> a aa aa <ccess op=”re d” ipa=”view”/> aa <ccess op=”kọ” ipa=”oper te”/> a
Awọn oluranlọwọ awoṣe
Oluranlọwọ apẹrẹ ipilẹ lati lo ni {{#access}} … {{/access}} oluṣeto. Yi iterator iterates lori gbogbo fi fun wiwọle triplets.
O ṣe atilẹyin awọn aṣayan meji wọnyi:
nkankan =” abuda/aṣẹ/iṣẹlẹ” – ti nkan ko ba le ṣe ipinnu lati inu ọrọ-ọrọ, eyi ṣeto iru nkan naa. includeDefault=”otitọ/eke” – pinnu boya awọn iye aiyipada wa ninu tabi rara. Awọn atẹle jẹ ẹya example:
{{#zcl_clusters}}
Àkópọ̀: {{n me}} [{{code}}] a {{#zcl_ tributes}} aa – tribute: {{n me}} [{{code}}] aa {{# ccess entity=" tribute"}}
O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}} a {{/zcl_ tributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{code}}] aa {{n me}} [{{code}}] aa {} aa {} p: {{operation}} / ole: {{ipa}} / odifier: {{ccess odifier}} a{{/ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – iṣẹlẹ: {{n mi}} [{{code}}] a {{# ccess entity=”iṣẹlẹ”}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Ifilọlẹ ZAP fun awọn ohun elo Matter tabi Zigbee
Ifilọlẹ ZAP fun awọn ohun elo Matter tabi Zigbee
Ifilọlẹ ZAP fun Matter tabi Awọn ohun elo Zigbee
Awọn apakan atẹle yii ṣe apejuwe ifilọlẹ ZAP ni ipo adaduro pẹlu Ọrọ tabi metadata pato-Zigbee. Ero naa ni lati ṣe ifilọlẹ ZAP pẹlu awọn ariyanjiyan to tọ ti o ni ibatan si metadata XML (awọn iṣupọ ati awọn asọye iru ẹrọ gẹgẹbi awọn pato CSA) ati awọn awoṣe iran, eyiti a lo lati ṣe agbekalẹ koodu ti o yẹ.
Ifilọlẹ ZAP pẹlu Matter
Iwe afọwọkọ atẹle yii n gbe metadata ti o pe lati Matter SDK nigba ifilọlẹ ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Akiyesi: O tun le gba si ọna Zigbee atẹle lati ṣe ifilọlẹ ZAP ni Matter.
Ifilọlẹ ZAP pẹlu Zigbee
Aṣẹ atẹle yii ṣe ifilọlẹ ZAP pẹlu awọn pato ZCL ati awọn awoṣe iran lati SDK.
[zap-ona] -z [sdk-ona]/gsdk/app/zcl/zcl-zap.json -g [sdk-ona]/gsdk/protocol/zigbee/app/framework/gen- template/gen-templates.json
zap-ona: Eyi ni ọna si orisun ZAP tabi ipa ọna sdk: Eyi ni ọna si SDK
Ifilọlẹ ZAP laisi Metadata
Ranti pe nigba ifilọlẹ ZAP taara nipasẹ iṣẹ ṣiṣe tabi lati orisun nipa lilo npm run zap o n ṣe ifilọlẹ ZAP pẹlu metadata idanwo fun Matter/Zigbee ti a ṣe sinu laarin ZAP kii ṣe metadata gangan ti o nbọ lati Matter ati Zigbee SDKs ti a mẹnuba loke. Nitorinaa, ranti lati ṣẹda awọn atunto ZAP rẹ nipa lilo metadata SDK kii ṣe nipa ṣiṣi ZAP taara pẹlu itumọ ti metadata idanwo.

31/35

Ti ipilẹṣẹ koodu fun Matter tabi Zigbee

Koodu ti ipilẹṣẹ fun Ọrọ, Zigbee tabi Aṣa SDK
Awọn apakan atẹle yii ṣe apejuwe bi o ṣe le ṣe ipilẹṣẹ koodu nipa lilo ZAP.
Ṣẹda koodu Lilo ZAP UI
Lọlẹ ZAP UI gẹgẹ bi awọn ilana ni Ifilọlẹ ZAP fun Ọrọ tabi Zigbee ki o tẹ bọtini ina ni ọpa akojọ aṣayan oke.
Ṣẹda koodu laisi UI
Awọn ilana atẹle pese awọn ọna oriṣiriṣi ti ipilẹṣẹ koodu nipasẹ CLI laisi ifilọlẹ ZAP UI.
Ti o npese koodu lati ZAP Orisun
Ṣiṣe aṣẹ atẹle lati ṣe ipilẹṣẹ koodu nipa lilo ZAP lati orisun: node src-script/zap-generate.js –genResultFile –Itọkasi ipinlẹ ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-
template/zigbee/gen-templates.json -i ./test/resource/tri-endpoint-device.zap -o ./tmp
Ti o npese koodu lati ZAP Executable
Ṣiṣe aṣẹ atẹle lati ṣe ipilẹṣẹ koodu nipa lilo iṣẹ ṣiṣe ZAP: [zap-path] ipilẹṣẹ –genResultFile –Itọkasi ipinlẹ ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-awoṣe/zigbee/gen-
templates.json -i ./test/resource/tri-endpoint-device.zap -o ./tmp
Ti o npese koodu lati ZAP CLI Executable
Ṣiṣe aṣẹ atẹle lati ṣe ipilẹṣẹ koodu nipa lilo ZAP CLI Executable: [zap-cli-path] ipilẹṣẹ –genResultFile –Itọkasi ipinlẹ ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-awoṣe/zigbee/gen-
templates.json -i ./test/resource/tri-endpoint-device.zap -o ./tmp

32/35

Ṣe imudojuiwọn ZAP ni Studio

Ṣe imudojuiwọn ZAP
Ṣe imudojuiwọn ZAP ni Simplicity Studio
Ilana yii le ṣee lo nigbati o ba n ṣiṣẹ pẹlu itẹsiwaju Matter tabi Zigbee lati awọn idasilẹ Silicon Labs SDK. ZAP le ṣe imudojuiwọn laarin Simplicity Studio laisi itusilẹ Simplicity Studio nipasẹ gbigba lati ayelujara iṣẹ ṣiṣe ZAP tuntun (ṣeduro) tabi fifa tuntun lati orisun ZAP bi o ṣe han ninu Itọsọna Fifi sori ZAP. Lẹhin ti o ni ZAP tuntun ti o da lori OS ti o lo lọwọlọwọ, o le ṣe imudojuiwọn ZAP laarin Studio bi idii ohun ti nmu badọgba. Tẹle awọn itọnisọna ni isalẹ lẹhin igbasilẹ ZAP tuntun:
Lọ si Simplicity Studio ki o si yan Awọn ayanfẹ> Ile-iṣere Ayedero> Awọn akopọ Adapter. Tẹ Fikun-un… ki o lọ kiri si folda ZAP ti o gbooro ti o ṣe igbasilẹ ki o tẹ Yan Folda . Tẹ Waye ati Pade ati lẹhinna ZAP tuntun ti a ṣafikun yoo ṣee lo nigbakugba ti .zap kan file ti wa ni ṣiṣi.
Akiyesi: Nigba miiran awọn iṣẹlẹ agbalagba le wa ti ZAP ti nṣiṣẹ tẹlẹ paapaa lẹhin mimu dojuiwọn si ZAP tuntun. Rii daju pe o pari gbogbo awọn iṣẹlẹ ZAP ti o wa tẹlẹ gẹgẹbi ZAP tuntun ti a ti mu ni a lo dipo apẹẹrẹ atijọ, eyiti o tun n ṣiṣẹ ni abẹlẹ.
Ṣe imudojuiwọn ZAP fun Idagbasoke Ọrọ ni Github
Nigbati o ba n ṣiṣẹ pẹlu Matter tabi Matter-Silicon Labs repos lori Github, ṣeto awọn oniyipada ayika pẹlu ọwọ si ZAP lati ṣẹda/ ṣe ipilẹṣẹ awọn atunto ZAP tuntun tabi tun ṣe ipilẹṣẹ awọn s ti o wa tẹlẹ.ample awọn atunto ZAP lẹhin lilo awọn ayipada si wọn. Ṣeto ZAP_DEVELOPMENT_PATH si ZAP lati orisun nipasẹ fifa tuntun tabi ṣeto ZAP_INSTALLATION_PATH si ZAP executable ti o gba lati ayelujara kẹhin ninu ilana agbegbe rẹ. Akiyesi pe nigba ti mejeeji ZAP_DEVELOPMENT_PATH ati ZAP_INSTALLATION_PATH ti ṣeto, ZAP_DEVELOPMENT_PATH ti lo.
Awọn atẹle jẹ example ṣe afihan awọn oniyipada ayika ti o wa loke ni lilo:
Ifilọlẹ ZAP ni lilo sipesifikesonu Ohun elo Tuntun gbogbo awọn sample awọn atunto ZAP fun awọn ohun elo Matter
Akiyesi: Nigbati o ba nlo awọn imuṣiṣẹ ZAP, rii daju pe o nlo itusilẹ osise lori itusilẹ alẹ fun iduroṣinṣin diẹ sii. Wo
Gbigbasilẹ ZAP Executable ni Itọsọna Fifi sori ZAP

33/35

Ilana Olona-pupọ nigbakanna laarin Zigbee ati Matter
Ilana Olona-pupọ nigbakanna laarin Zigbee ati Matter
MCoanttceurrrent Olona-ilana laarin Zigbee ati
ZAP le ṣee lo lati tunto ZCL (Zigbee) ati Awọn atunto Data-Awoṣe (Nkan) ni ohun elo ilana-ọpọlọpọ fun Zigbee ati Matter. ZAP gba ọ laaye lati ṣẹda awọn aaye ipari fun Zigbee ati Ọrọ ni gbangba ni iṣeto kanna file. Ti awọn aaye ipari Zigbee ati Matter ba wa lori Idanimọ ipari ipari kanna (fun example, LO Dimmable Light on endpoint Id 1 ati Matter Dimmable Light lori apẹẹrẹ miiran ti ipari ipari 1), ZAP n ṣe abojuto mimuuṣiṣẹpọ awọn abuda ti o wọpọ kọja ọrọ ati awọn abuda Zigbee. Rii daju pe awọn abuda mimuṣiṣẹpọ ni iru data kanna. Awọn abuda ti o wọpọ laarin Zigbee ati Matter ti wa ni idasilẹ nipasẹ a file ti a npe ni multi-protocol.json. Olumulo naa le sopọ mọ awọn iṣupọ meji kọja Zigbee ati Matter pẹlu awọn abuda ti o baamu wọn nipa lilo iṣupọ ati awọn koodu ikawe lẹsẹsẹ. Eyi file le rii ni [SDKPath]/app/zcl/multi-protocol.json. Eyi file ti ni imudojuiwọn pẹlu eto awọn iṣupọ ati awọn abuda kan lati bẹrẹ pẹlu, ṣugbọn olumulo le ṣe imudojuiwọn eyi file bi o ṣe nilo ati ZAP yoo ṣe abojuto mimuuṣiṣẹpọ iṣeto ni abuda kọja Zigbee ati Matter fun awọn idamọ ipari ipari ti o wọpọ.
O tun le wa ikẹkọ ZAP ni eyikeyi Zigbee ati ohun elo ilana-ọpọlọpọ Matter labẹ oju-iwe ikẹkọ. Ikẹkọ yii yoo ṣe itọsọna fun ọ nipasẹ ilana ẹda ohun elo pupọ-ilana. Ikẹkọ yii wa nikan nigbati o ṣii ohun elo ilana-ọpọlọpọ ti o wa tẹlẹ ati pe o le rii bi o ṣe han ninu aworan ni isalẹ:

34/35

Ṣepọ SLC CLI pẹlu ZAP
Ṣepọ SLC CLI pẹlu ZAP
Ṣepọ SLC CLI pẹlu ZAP
Tẹle awọn igbesẹ wọnyi lati ṣepọ SLC CLI pẹlu ZAP: ò Fi SLC CLI sori ẹrọ nipa titẹle awọn ilana fifi sori ẹrọ ni Itọsọna olumulo Simplicity Studio 5. ó Fi ZAP sori ẹrọ nipa titẹle awọn ilana inu Itọsọna Fifi sori ZAP. Lati ṣepọ SLC CLI pẹlu ZAP, ṣafikun iyipada ayika STUDIO_ADAPTER_PACK_PATH ti o tọka si ohun elo ZAP
liana. Ranti lati tun SLC CLI Daemon bẹrẹ lẹhin igbesẹ 3. Eyikeyi iṣẹ akanṣe ti o nlo ZAP yoo lo ọna ti a ṣalaye ni igbesẹ 3 nigba ti ipilẹṣẹ lati SLC CLI. Jọwọ tọka si SLC CLI
Lilo fun awọn itọnisọna lori lilo SLC CLI fun awọn iṣẹ akanṣe rẹ.

35/35

Awọn iwe aṣẹ / Awọn orisun

SILICON LABS ZAP Idagbasoke Pẹlu Silicon Labs [pdf] Afọwọkọ eni
Idagbasoke ZAP Pẹlu Awọn ile-iṣẹ Silicon, ZAP, Idagbasoke Pẹlu Awọn ile-iṣẹ Silicon, Awọn ile-iṣẹ Silicon, Labs

Awọn itọkasi

Itọsọna olumulo

Idagbasoke ZAP Pẹlu Awọn Labs Silicon

Awọn pato

Awọn ilana Lilo ọja

FAQs

Dagbasoke pẹlu Silicon Labs ZAP

ZAP Bibẹrẹ

Fifi sori ZAP

Awọn ipilẹ ZAP

XML aṣa

XML aṣa Tags fún Zigbee

Multiple Device Orisi Per Endpoint

Iṣakoso wiwọle

Ti ipilẹṣẹ koodu fun Matter tabi Zigbee

Ṣe imudojuiwọn ZAP ni Studio

Awọn iwe aṣẹ / Awọn orisun

Awọn itọkasi

Fi ọrọìwòye

Fagilee esi