Haɓaka ZAP Tare da Jagorar Mai Silicon Labs

ZAP Farawa
- Don farawa da ZAP, bi waɗannan matakan:
  - Zazzage ZAP Executable daga ma'ajiyar hukuma.
  - Shigar da abin dogara ta amfani da npm shigar da umarnin.
  - Don takamaiman shigarwa na Windows, koma zuwa Shigar ZAP don jagorar Windows OS.
Ci gaban Zigbee
- Idan kuna haɓaka aikace-aikacen Zigbee:
  - Yi amfani da Sauƙi Studio wanda ya haɗa da ZAP da sauran kayan aikin da ake buƙata.

Ci gaban Al'amari
- Idan kuna haɓaka aikace-aikacen Matter:
  - Zaɓuɓɓuka sun haɗa da amfani da Sauƙaƙe Studio ko samun damar Silicon Labs ko ma'ajiyar CSA Github.
  - Koma zuwa sabunta umarnin don ZAP a wajen zagayowar sakin Sauƙaƙe Studio idan an buƙata.

FAQs

Tambaya: Menene nau'ikan binaries na ZAP daban-daban akwai?
- A: Akwai nau'ikan nau'ikan nau'ikan guda biyu - Saki na hukuma tare da ingantattun abubuwan ginawa da riga-kafi tare da sabbin abubuwa.

Tambaya: Menene zan yi idan na gamu da matsalolin harhada laburare na asali yayin shigarwa?
- A: Koma zuwa bayanan FAQ game da takamaiman rubutun dandali don warware irin waɗannan batutuwa.

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Haɓakawa tare da Silicon Labs ZAP

Farawa
Zap yana farawaview Shigar ZAP Shigar ZAP Windows FAQ
Tushen ZAP Tushen
Jagorar Mai Amfani Jagorar Mai Amfani ZAP Samaview Custom XML Custom XML Tags don Zigbee Multiple Na'ura Nau'in Nau'in Nau'in Ƙarshen Nau'in Nau'in Fasalin Shafi Faɗakarwa Bayanan Bayanai-Model/ZCL Ƙayyadaddun Ƙididdiga Samun Ikon Ƙaddamar da ZAP don aikace-aikacen Matter ko Zigbee Ƙirƙirar lambar don Matter ko Zigbee Sabunta ZAP a cikin Studio Concurrent Multi-protocol tsakanin Zigbee da Matter Integrate SLC CLI tare da ZAP

1/35

Haɓakawa tare da Silicon Labs ZAP
Haɓakawa tare da Silicon Labs ZAP
ZAP
ZAP injin ƙirƙira lambar ƙira ce da ƙirar mai amfani don aikace-aikace da ɗakunan karatu dangane da Laburaren Cluster na Zigbee daga Zigbee ko Samfurin Bayanai daga Matter. Haɗin kai Standards Alliance ne ya haɓaka ƙayyadaddun bayanai. ZAP yana ba ku damar aiwatar da ayyuka masu zuwa:
Yi ƙayyadaddun ƙayyadaddun ƙirar SDK na duk kayan tarihi na duniya (tsayawa, nau'ikan, ID, da sauransu) dangane da ƙayyadaddun ƙirar ZCL/Data-Model. Yi ƙayyadaddun ƙayyadaddun ƙayyadaddun SDK na duk kayan aikin da aka zaɓa na mai amfani (tsarin aiki, ƙayyadaddun ƙayyadaddun bayanai, da sauransu) dangane da ƙayyadaddun ƙirar ZCL/Bayanai da ƙirar aikace-aikacen abokin ciniki. Samar da UI don mai amfani na ƙarshe don zaɓar ƙayyadaddun ƙayyadaddun ƙayyadaddun aikace-aikacen (makikan ƙarewa, tari, halaye, umarni, da sauransu).

Abubuwan da ke cikin waɗannan sassan suna bayyana yadda ake haɓaka aikace-aikacen Zigbee da Matter ta hanyar daidaita Layers ZCL (Zigbee) ko Model Data (Matter) ta amfani da ZAP.

2/35

ZAP Farawa

ZAP Farawa
Farawa da ZAP
Waɗannan sassan suna bayyana hanyoyi daban-daban don ƙirƙirar aikace-aikacen Zigbee da Matter. Lura cewa Sauƙaƙe Studio yana ba da hanya don ƙirƙirar aikace-aikacen Zigbee da Matter ɗinku daga ƙarshe zuwa ƙarshe inda duk kayan aikin suka zo an riga an shigar dasu tare da Sauƙi Studio (ciki har da ZAP). Hakanan kuna iya yanke shawarar bincika wasu hanyoyin ƙirƙirar aikace-aikacenku, kamar yadda aka bayyana anan.
Ci gaban Zigbee
Masu haɓaka aikace-aikacen Zigbee na iya gina aikace-aikacen su ta amfani da Sauƙi Studio, wanda ya riga ya haɗa da ZAP da sauran kayan aikin da ke taimaka muku gina aikace-aikacenku daga ƙarshe zuwa ƙarshe.
Ci gaban Al'amari
Masu haɓaka Matter Application na iya gina aikace-aikacen su ta amfani da hanyoyi masu zuwa: Sauƙi Studio: Wannan ya haɗa da ZAP da sauran kayan aikin da ake buƙata don gina Matter aikace-aikacen ƙarshe zuwa ƙarshe. Github (Silicon Labs) Github (CSA)
Lura: Don sabunta ZAP a wajen sake zagayowar Simplicity Studio, duba sabunta ZAP a cikin Sauƙi Studio da Jagoran Shigar ZAP

3/35

Shigar da ZAP

Sassan da ke gaba suna bayyana shigarwar ZAP da yadda ake sabunta ZAP a cikin Sauƙi Studio IDE.
Ana Shawarar Zazzagewar Zazzagewar ZAP)
Wannan ita ce hanyar da aka ba da shawarar farawa da ZAP. Kuna iya samun sabon binaries na ZAP daga aa https://github.com/project-chip/zp/releses. Binariyoyi da aka riga aka gina sun zo cikin nau'i biyu daban-daban.
Saki na hukuma: Ingantaccen gini tare da sadaukarwar Matter da rukunin gwajin Zigbee. Tsarin sunan sakin shine vYYYY.DD.MM. Pre-saki: Gina tare da sabbin fasaloli da gyare-gyaren kwaro amma waɗannan gine-ginen ba a tabbatar da su tare da sadaukarwar Matter da suites ɗin gwajin Zigbee. Tsarin sunan sakin shine vYYYY.DD.MM-dare.
Shigar da ZAP daga Source
Umarnin asali don Shigar ZAP
Saboda wannan aikace-aikacen node.js ne, kuna buƙatar shigar da yanayin kumburi. Hanya mafi kyau don yin wannan ita ce zazzage sabuwar shigar da kumburi, wanda ya haɗa da node da npm. Idan kana da tsohuwar sigar kumburi da aka shigar akan wurin aikinka, yana iya haifar da matsala, musamman idan ya tsufa sosai. Tabbatar cewa kuna da sabon nau'in node v16.x tare da npm wanda aka haɗa. Gudu node-version don bincika sigar da aka ɗauka. v18.x ana bada shawarar. Bayan kuna da nau'in kumburin da ake so, zaku iya gudanar da waɗannan abubuwan:
Shigar da Dogara
Yi amfani da umarni masu zuwa don shigar da abin dogaro:

npm shigar
Lura: Don takamaiman shigarwar ZAP na Windows, duba Shigar ZAP don Windows OS Ba sabon abu ba ne a shiga cikin matsalolin harhada laburare na asali a wannan lokacin. Akwai rubutun src-script/install-* daban-daban don dandamali daban-daban. Dubi bayanan FAQ game da wane rubutun da za a gudanar akan dandamali daban-daban sannan a sake kunna npm shigar .
Fara aikace-aikacen
Yi amfani da waɗannan umarni don fara aikace-aikacen:

npm gudu zap
Fara Gaba-Ƙarshen a Yanayin haɓakawa
Yana goyan bayan sake lodin lambar zafi, rahoton kuskure, da sauransu. Yi amfani da umarni masu zuwa don fara ƙarshen gaba a haɓakawa
yanayin:
quasar dev -m electron
or

4/35

ZAP Insta za a shiga
npm gudu electron-dev

5/35

Shigar ZAP Windows
Shigar ZAP Windows
Shigar da ZAP don Windows OS
1. Windows Powershell
A cikin mashaya binciken tebur, shigar da Windows Powershell kuma gudanar azaman mai gudanarwa. Gudanar da duk waɗannan umarni a cikin Powershell.
2. Chocolate
Shigar daga https://chocolatey.org/install. Bincika idan an shigar dashi yadda yakamata tare da umarni masu zuwa:
suke -v
Shigar da kunshin pkgconfiglite tare da umarni masu zuwa:
choco shigar pkgconfiglite
3. Sanya Node
Gudanar da umarni masu zuwa don shigarwa:
choco shigar nodejs-lts
*Tsarin ya zama 18 don wucewa gwajin duba sigar, bayan shigarwa, duba tare da node -v * Idan kun shigar da Node riga, kuma ku kasa wasu gwaje-gwaje masu kama da ba za ku iya samun Node ba, sake shigar da Node tare da cakulan.
4. Bi Basic Umurnai don Sanya ZAP
Bi umarnin shigarwa na ZAP daga tushe a cikin Shigar da ZAP. Yayin bin ainihin umarnin don shigar da ZAP, kula da kurakurai masu zuwa da yadda ake warware su:
sqlite3
Lokacin gudanar da ZAP (misali, npm run zap), idan kun ga kuskure game da sqlite3.node a cikin taga mai tashi, gudu:
npm sake gina sqlite3
electron-gini
Lokacin yin shigarwa na npm, a cikin shigarwa bayan shigarwa, idan kuskure ya faru akan umarni mai zuwa da ke da alaka da mai ginawa na lantarki install-appdeps , npx electron-rebuild canvas ya kasa ko node-pre-gyp , sigar zane na yanzu ba ta dace da Windows ba kuma kuskuren shigarwa ba zai haifar da gazawa a cikin tafiyar da ZAP ba. node-canvas yana aiki akan mafita yanzu kuma za'a warware batun nan gaba kadan.
"postinstall": "electron-builder install-app-deps && husky install && npm sake gina canvas -update-binary && npm run version-stamp”

6/35

Shigar ZAP Windows
Canvas
Idan gwajin npm run ya gaza saboda kuskuren gwajin suite ya kasa aiki. Ba za a iya samun samfurin '../build/Release/canvas.node' ko
zapnode_modulescanvasbuildReleasecanvas.node ba ingantaccen aikace-aikacen Win32 bane. , sake gina zane kamar haka:
npm sake gina zane-update-binary
sami index.html ko Wasu Matsalolin Sabar
Idan gwajin gudu na npm ya gaza saboda kuskuren sami buƙatar index.html ta gaza tare da lambar matsayi 404 a cikin gwaje-gwaje naúrar ko samun uwar garke.
matsalolin haɗin gwiwa a cikin gwaje-gwajen e2e-ci, gudanar da umarni masu zuwa:
npm gudu ginawa
Sauran
Bincika idan nau'in kumburin v18 ne kuma gwada shigar da shi tare da Chocolatey.

7/35

FAQ
FAQ
Tambayoyin da ake yawan yi
Tambaya: Yadda ake fara UI a cikin yanayin ci gaba? A: Kuna iya fara UI a cikin yanayin haɓakawa, wanda zai haifar da saitin mai zuwa:
Rarrabe uwar garken ci gaban quasar HTTP, wanda ke wartsakewa akan tashar jiragen ruwa 8080 ZAP baya baya yana gudana akan tashar jiragen ruwa 9070 Chrome ko wani mai bincike, yana gudana da kansa Don zuwa wannan saitin, bi umarnin da ke ƙasa. ò Na farko, gudanar da uwar garken ci gaban ZAP, wanda ke farawa akan tashar jiragen ruwa 9070.
npm run zap-devserver ó Na gaba, gudanar da uwar garken ci gaban quasar, wanda ke farawa akan tashar jiragen ruwa 8080.
Nuna mai binciken ku ko gudanar da ɗaya a kan abin da ya dace URL tare da hujjar restPort:
google-chrome http://localhost:8080/?restPort=9070

Tambaya: Yadda ake yin wannan aiki akan Mac / Linux OS? A:
npm install ana amfani dashi don zazzage duk fakitin dogaro da ake buƙata. Idan kun ga kurakurai masu alaƙa da node-gyp da ɓataccen ɗakunan karatu na gida, kamar pixman , da sauransu, kuna rasa abubuwan dogaro na asali don gamsuwa don haɗa binaries ɗin da ba a riga an gina shi ba don wasu haɗin dandamali da sigogin. Npm akan gajimare yana ci gaba da sabunta jerin abubuwan da aka bayar, don haka yana yiwuwa za ku ɗauke su da kyau, amma idan ba ku yi ba, waɗannan umarni ne don dandamali daban-daban:
Fedora Core tare da dnf:
dnf shigar pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
ko gudanar da rubutun:
src-script/install-packages-fedora
Ubuntu tare da apt-samun:
apt-samun sabuntawa dace-samun shigar –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
ko gudanar da rubutun:

8/35

FAQ
src-script/install-packages-ubuntu
OSX akan Mac tare da Brew Homebrew:
shigar pkg-config cairo pango libpng jpeg giflib librsvg
ko gudanar da rubutun:
src-script/shigar-kunshi-osx
Tambaya: Yadda ake yin wannan aiki akan Windows OS?
A: Tabbatar cewa koyaushe yana sabuntawa kuma babu canje-canjen da ba a yi ba. Tukwici: git pull, git status & git stash abokanka ne. Dole ne ku yi amfani da Chocolately don sanya Zap yayi aiki akan Windows OS. Tabbatar zazzage fakitin pkgconfiglite.
choco shigar pkgconfiglite
Idan kuna da matsala da Cairo, misaliampidan kun sami kuskure game da cairo.h': A'a file ko directory, yi haka: ò Bincika idan kwamfutarka 32 ko 64 bit. Ya danganta da wannan, zazzage fakitin da ya dace daga wannan rukunin yanar gizon
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:
Danna kan Babban Saitunan Tsari. A cikin ci-gaba shafin danna kan Muhalli Variables. A cikin sashin Tsarin Tsarin, nemo canjin yanayin PATH kuma zaɓi shi. Danna Gyara kuma ƙara C:/GTK zuwa gare shi. Idan canjin yanayi na PATH bai wanzu ba, danna Sabo. Idan ba a samo jpeglib.h ba, gwada waɗannan masu zuwa: ò A kan tashar, gudu: choco shigar libjpeg-turbo ó Tabbatar yana da tsabta ta amfani da: git clean -dxff kuma sake shigar da npm ô idan babu kurakurai kuma kawai gargadi ya bayyana, gwada amfani da npm audit fix õ idan ba za ku iya gudanar da ZAP ba, je zuwa. file src-script/zap-start.js ö Canji
÷ const { spawn } = buƙatar ('cross-spawn') don ƙaddamar da { spawn } = buƙatar ('tsarin yara') ø Gudu npm kuma kunna zap. Magana:
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)
Tambaya: Na sami kuskure "sqlite3_node" ba a samo ko makamancin haka ba.

9/35

FAQ
A: Sake gina abubuwan dauri na sqlite3 na asali. Don gyara wannan a mafi yawan lokuta, gudu:
npm shigar
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Idan har yanzu ba a gyara ba, yi:
rm -rf node_modules sannan a sake gwada umarnin da ke sama. Lokaci-lokaci haɓaka npm ɗinku shima yana haifar da bambanci:
npm shigar -g npm
Tambaya: Na sami kuskure "Siffar N-API na wannan misalin Node shine 1. Wannan tsarin yana goyan bayan sigar N-API 3. Wannan Node misalin ba zai iya gudanar da wannan tsarin ba."
A: Haɓaka sigar kumburin ku. An tattauna maganin wannan a cikin wannan zaren Ƙofar Ruwa: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Tambaya: PC na ci gaba baya aiki tare da ZAP saboda kowane dalili. Zan iya amfani da kwandon docker?
A: Eh za ka iya. TBD.
Tambaya: Ta yaya zan gudanar da ZAP a cikin VSCode?
A: Idan ka VSCcode a kan hanyarka shigar da zap repo kuma rubuta lambar. Wannan zai buɗe ZAP a cikin VSCcode. Don gudanar da ZAP a yanayin gyara kuskure, zaɓi wurin aiki na ZAP kuma danna gunkin Run a mashaya kayan aikin hannun hagu. Kuna da zaɓuɓɓuka biyu don zaɓar daga don gudanar da ZAP, zaɓi Node.js Debug Terminal. Wannan zai buɗe taga tasha wanda daga ciki zaku iya shigar da npm run zap , wanda zai haɗa mai gyara kuma ya kunna ZAP kamar yadda kuke saba daga layin umarni. Taya murna, ya kamata yanzu ku ga ZAP yana gudana a cikin mai gyara kuskure. Kuna iya saita wuraren hutu a cikin VSCode kamar yadda kuke yi a kowane IDE.
Tambaya: Gwajin naúrar UI ya gaza tare da wasu kurakurai a kusa da zane ba a gina don daidaitaccen sigar kumburi ba. Me zan yi?
A: Idan kun ga kuskure mai zuwa:
FAIL test/ui.test.js Test suite ya kasa gudanar da tsarin 'canvas.node' an haɗa shi da wani nau'in Node.js na daban ta amfani da NODE_MODULE_VERSION 80. Wannan sigar Node.js tana buƙatar NODE_MODULE_VERSION 72. Da fatan za a gwada sake haɗawa ko sake shigar da module ta amfani da `npm, a sake sakawa'n.
a Abu. (node_modules/canvas/lib/bindings.js:3 18)
sannan gudu: npm sake gina canvas -update-binary

10/35

Tushen ZAP

ZCL/Data-Model ZAP Tushen
Wannan sashe ya ƙunshi bayanai don sababbin masu amfani da ZAP. Danna gunkin koyawa a saman kusurwar dama na ZAP UI, wanda ke nuna yadda ake ƙirƙirar tsarin ZAP. Koyarwar za ta jagorance ku ta hanyar da ke biyowa: Ƙirƙiri wurin ƙarshe Zaɓi nau'in na'ura Ka saita tari Tsaya sifa Ka saita umarni Don cikakken bayani, duba Jagoran Kanfigareta na Zigbee

11/35

Jagorar Mai Amfani ZAP
Jagorar Mai Amfani ZAP
Jagorar Mai Amfani ZAP
Sassan da ke ƙarƙashin wannan jagorar sun ba da ƙarin cikakkun bayanai game da fasaloli daban-daban waɗanda ZAP ke bayarwa.

12/35

Custom XML

Ƙara Custom XML daga ZAP UI
Danna alamar "Extensions" a cikin ZAP UI. Danna maɓallin ƙara "+" don zaɓar xml na al'ada file Ya kamata gungu na al'ada, halaye, umarni, da sauransu su bayyana a cikin ZAP UI da zarar an ƙara xml na al'ada.
Ƙirƙirar XML na al'ada a Zigbee
Sashen yana nuna yadda ake ƙirƙira gungu na al'ada da kuma tsawaita madaidaitan gungu na yau da kullun tare da halaye na al'ada da umarni na Zigbee.
Tambayoyin Ƙirar-Ƙira a Zigbee
Kuna iya ƙara takamaiman gungu na masana'anta zuwa daidaitaccen ƙwararrun masana'antafile. Mun samar da wani example wannan a kasa. Don yin wannan dole ne ku cika wajibai guda biyu:
DOLE ID ɗin gungu ya kasance a cikin takamaiman kewayon masana'anta, 0xfc00 - 0xffff. Dole ne ma'anar gungu ya haɗa da lambar ƙirar ƙira wacce za a yi amfani da ita ga DUK halaye da umarni a cikin wannan tarin kuma dole ne a samar da ita lokacin aikawa da karɓar umarni da hulɗa tare da halaye. Exampda:

Sampda Mfg Specific Cluster Gabaɗaya Wannan gungu yana ba da exampyadda za a iya tsawaita Tsarin Aikace-aikacen don haɗa takamaiman gungu na masana'anta.
0xFC00
zamo sampda sifa
zamo sampsifa 2

A samptakamaiman umarni na masana'anta a cikin sampda manufacturer-takamaiman
tari.

Takamaiman Umarni-Manufacturer a cikin Madaidaicin Taguwar Zigbee
Kuna iya ƙara umarnin ku zuwa kowane daidaitaccen gungu na Zigbee tare da buƙatu masu zuwa:
takamaiman umarnin masana'anta na iya amfani da kowane id umarni a cikin kewayon id umarni, 0x00 – 0xff. Dole ne ku samar da lambar ƙirar ƙira don umarnin don a bambanta shi da sauran umarni a cikin tari kuma a sarrafa shi yadda ya kamata. Exampna tsawaita gungu na Kunnawa/Kashe tare da umarnin masana'anta:

13/35

Custom XML
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition" zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umarnin abokin ciniki wanda ke kashe na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificOnWithTransition" na zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umarnin abokin ciniki wanda ke kunna na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificToggleWithTransition" zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umarnin abokin ciniki wanda ke jujjuya na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificOnWithTransition2 ″ na zaɓi =”gaskiya” manufacturerCode=”0 1049″> Umarnin abokin ciniki wanda ke kunna na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificToggleWithTransition2″ na zaɓi =”gaskiya”
manufacturerCode=”0 1049″> Umarnin abokin ciniki wanda ke jujjuya na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.

Takamaiman Halayen Mai ƙirƙira a cikin Madaidaicin Taguwar Zigbee
Kuna iya ƙara halayen ku zuwa kowane daidaitaccen gungu na Zigbee tare da buƙatu masu zuwa:
Ƙayyadaddun halayen masana'anta na iya amfani da kowane sifa id a cikin kewayon id sifa, 0x0000 - 0xffff. Dole ne ku samar da lambar ƙirar ƙira don sifa ta yadda za a iya bambanta ta da sauran sifofi a cikin gungu kuma a sarrafa su yadda ya kamata. Exampna fadada gungu na Kunnawa/Kashe tare da halayen masana'anta:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME" nau'in = "INT16U" min = "0 0000"
max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya" manufacturerCode = "0 1002"> SampLe Mfg Musamman Sifa: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ nau'in = "INT8U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya" manufacturerCode = "0 1049"> SampLe Mfg Musamman Sifa: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ nau'in = "INT8U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 00" na zaɓi = "gaskiya" manufacturerCode = "0 1002"> SampLe Mfg Musamman Sifa: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ nau'in = "INT16U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya" manufacturerCode = "0 1049"> SampLe Mfg Specific Sifa: 0 0001 0 1040
Ƙirƙirar XML na al'ada a cikin Matter
Sashen yana nuna yadda ake ƙirƙira gungu na al'ada da kuma tsawaita madaidaitan gungu tare da halaye na al'ada da umarni don Matter.
Tambayoyi na Musamman na Maƙera-Ƙara a cikin Matter
Kuna iya ƙara takamaiman gungu na masana'anta zuwa cikin Matter. Mun samar da wani example wannan a kasa.
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
A cikin wadannan example, haɗewar ID ɗin mai siyarwa (ID ɗin Mai ƙirƙira Gwaji) na 0xFFF1 da gungun ID na 0xFC20 yana haifar da value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Exampda:
Gabaɗaya Sampda MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER A SampLe MEI cluster yana nuna haɓaka masana'anta ta gungu FlipFlop
Martani don AddArguments wanda ke dawo da jimlar. Umurnin da ke ɗaukar gardama uint8 guda biyu kuma ya dawo da jimlar su. Umarni mai sauƙi ba tare da kowane sigogi ba kuma ba tare da amsa ba.
Halayen Maƙera-Takamaiman a cikin Matsakaicin Rukunin Matter
Kuna iya ƙara takamaiman halayen masana'anta zuwa kowane daidaitaccen gunkin Matter tare da buƙatu masu zuwa:
T aaa ya tari th a sifofin da ake ɗora su dole ne a ƙayyade -
e xte nd ed >>>
Lambar sifa ita ce haɗin 32-bit na lambar ƙira da id don sifa. Mafi mahimmancin 16 ragowa shine lambar masana'anta. Matsakaicin lambar ƙirar ƙirar gwaji shine 0xFFF1 - 0xFFF4. Mafi ƙanƙanta mahimmin ragi 16 shine sifa ID. Matsakaicin abubuwan da ba na duniya ba shine 0x0000 - 0x4FFF.
ExampƘarfafa gungu na Kunnawa/Kashe Matter tare da takamaiman halayen ƙira:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″
max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya"> SampLe Mfg Specific Siffar 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″
max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya"> SampLe Mfg Specific Siffar 4
Manufacturer-Takamaiman Umarni a cikin Matsalolin Matsalolin Matsala
Kuna iya ƙara takamaiman umarni na masana'anta zuwa kowane daidaitaccen gungu na Matter tare da buƙatu masu zuwa:
T aaa ya tari ga umarnin da ake ɗora wa dole ne a ƙayyade -
e xte nd ed >>>
Lambar umarni shine haɗin 32-bit na lambar ƙira da id don umarnin. Mafi mahimmancin 16 ragowa shine lambar masana'anta. Matsakaicin lambar ƙirar ƙirar gwaji shine 0xFFF1 - 0xFFF4. Mafi ƙanƙanta mahimmin ragi 16 shine ID na umarni. Matsakaicin umarnin da ba na duniya ba shine 0x0000 - 0x00FF.
ExampƘarfafa gungu na Kunnawa/Kashe Matter tare da takamaiman gungu na kerawa:

15/35

Custom XML

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2 ″ na zaɓi =”gaskiya”> Umarnin abokin ciniki wanda ke kunna na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ na zaɓi =”gaskiya”>
Umarnin abokin ciniki wanda ke jujjuya na'urar tare da canji da aka bayar ta lokacin miƙa mulki a cikin Ember Sample miƙa mulki lokaci sifa.

16/35

Custom XML Tags domin Zigbee

Daftarin da ke gaba yana magana game da kowane xml tags hade da Zigbee.
Kowane xml file an jera tsakanin mai daidaitawa tags:

Ana iya bayyana nau'ikan bayanai a cikin mai daidaitawa tag. Zigbee a halin yanzu yana goyan bayan ma'anar bitmaps, enums, lamba, kirtani ko tsari. Kafin kayyade ƙarin nau'ikan tabbatar da bincika duk nau'ikan atomic da ke wanzu waɗanda aka ayyana su a cikin nau'ikan.xml da duk nau'ikan da ba na atomic da aka ayyana a cikin sauran xml files. Kuna iya ayyana su kamar haka:
Bitmap: suna: sunan nau'in bitmap. nau'in: Bitmap tare da girman tsakanin 8-64 bits za a iya bayyana shi, duk wanda ya kamata ya zama nau'i na 8. Kowane bitmap zai iya samun filayen da yawa tare da suna da abin rufe fuska hade da shi. misali:

"'
Enum: sunan: sunan nau'in enum. nau'in: Enum tare da girman tsakanin 8-64 bits za'a iya bayyana shi, duk wanda ya kamata ya zama nau'i na 8. Kowane enum na iya samun abubuwa da yawa tare da suna da darajar da ke hade da shi. misali:

Integer: Nau'in lamba an riga an bayyana su ƙarƙashin nau'ikan atomic waɗanda ke wanzu a nau'ikan.xml. Girman su na iya zuwa daga 8-64 ragowa kuma ana iya sanya hannu ko ba a sanya hannu ba. misali:

Nau'in igiya: An riga an bayyana nau'ikan igiyoyi a ƙarƙashin nau'ikan atomic waɗanda ke wanzu a nau'ikan.xml. Nau'o'in kirtani na yanzu sun haɗa da kirtani octet, kirtani char, doguwar kirtan octet da dogon kirtani misali:

Tsarin: suna: sunan nau'in tsari. Kowane tsarin yana iya samun abubuwa da yawa tare da suna da nau'in da ke da alaƙa da shi. Nau'in na iya zama kowane nau'in da aka riga aka ƙayyade a ƙarƙashin nau'ikan bayanai. misali:

17/35

Custom XML Tags domin Zigbee

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

Za'a iya siffanta tagulla na al'ada a cikin mai daidaitawa tag. sunan: sunan yankin gungu: yankin gungu. Tarin zai bayyana a cikin ZAP UI a ƙarƙashin wannan yanki. bayanin: Bayanin lambar tari: lambar cluster ayyana: cluster ayyana wanda ake amfani da janareta na lamba don ayyana gungu ta wata hanya manufacturerCode: Ana amfani da shi don ayyana takamaiman gungu. Wannan dole ne ya kasance tsakanin 0xfc00 - 0xffff. Ana buƙatar fayyace lambar ƙirar ƙira don gungu kamar haka:

Tarin masana'anta ta atomatik yana yin sifofi da umarni a ƙarƙashinsa na lambar masana'anta iri ɗaya sai dai idan sun jera lambar ƙirar a sarari. Introducing: Ana amfani da shi don tantance ƙayyadaddun sigar da aka gabatar da gungu a ciki. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. removeIn: Ana amfani da shi don tantance ƙayyadaddun sigar da aka cire tarin. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. singleton(boolean): Ana amfani da ita don tantance gungu azaman nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau’in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in nau'in) wanda ake amfani da shi don tantance gungu. sifa: yana bayyana sifa don sunan tari: An ambaci sunan sifa tsakanin sifa. tag.
sifa sunan
gefe(abokin ciniki/uwar garke): Gefen gungu wanda sifa ta ke da alaƙa kuma. lambar: lambar ƙirar ƙirar ƙira: Ana iya amfani da wannan don ayyana takamaiman sifa mai ƙira a wajen ƙayyadaddun zigbee da aka ambata ta daidaitaccen xml. ayyana: sifa ayyana wanda janareta na lamba ke amfani dashi don ayyana sifa ta wata hanya nau'in: nau'in sifa wanda zai iya zama kowane nau'in bayanan da aka ambata a cikin tsohowar xml: ƙimar tsoho don sifa. min: Ƙimar da aka ba da izini mafi ƙarancin sifa: Matsakaicin ƙimar da aka yarda don abin da ake iya rubutawa: Ana iya rubuta ƙimar sifa ko a'a. Ana iya amfani da wannan don hana haɓaka sifa ta hanyar rubuta umarni. na zaɓi (boolean): Ana amfani da shi don tantance ko sifa na zaɓi ne ko a'a don tari. min: Ƙimar mafi ƙarancin izini don sifa idan ta kasance lamba, enum ko nau'in bitmap. max: Matsakaicin ƙimar da aka yarda don sifa lokacin yana da lamba, enum ko tsayin nau'in bitmap: Ana amfani da shi don tantance matsakaicin tsayin sifa lokacin yana da nau'in kirtani. MinLength: Ana amfani da shi don ƙididdige mafi ƙarancin tsayin sifa idan ta nau'in kirtani ne. reportable(boolean): Yana gaya idan sifa ce mai ba da rahoto ko a'a ba ta zama Nullable(boolean): Yana ba da izinin ƙima mara kyau ga sifa. array(boolean): Ana amfani da shi don bayyana sifa ta nau'in tsararru. Introducing: Ana amfani da shi don tantance takamaiman sigar da aka gabatar da sifa. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. removeIn: Ana amfani da shi don tantance ƙayyadaddun sigar da aka cire sifa. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. umarni: ayyana umarni don sunan gungu: Sunan umarni.

code: lambar umarni

18/35

Custom XML Tags domin Zigbee
lambar masana'anta: Ana iya amfani da wannan don ayyana takamaiman umarni na masana'anta a waje da ƙayyadaddun zigbee da aka ambata ta daidaitaccen xml. bayanin: bayanin tushen umarnin (abokin ciniki/uwar garke): tushen umarnin. na zaɓi (boolean): Ana amfani da shi don tantance ko umarni na zaɓi ne ko ba don tari ba. Introducing: Ana amfani da shi don tantance takamaiman sigar da aka gabatar da umarnin. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. cirewaIn: Ana amfani da shi don tantance takamaiman sigar da aka cire umarnin a ciki. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. dalilan umarni:
Kowane umarni yana iya samun saitin sunan gardamar umarni: sunan nau'in hujjar umarni: nau'in hujjar umarnin wanda zai iya zama kowane nau'in da aka ambata a cikin xml. min: Mafi ƙarancin ƙima da aka yarda don hujja lokacin lamba ce, enum ko nau'in bitmap. max: Matsakaicin ƙimar da aka yarda don hujja lokacin da yake lamba ce, enum ko tsayin nau'in bitmap: Ana amfani da shi don ƙididdige matsakaicin tsayin da aka yarda don hujjar umarni lokacin da yake na nau'in kirtani. MinLength: Ana amfani da shi don ƙididdige mafi ƙarancin tsayin da aka yarda don hujjar umarni lokacin da nau'in kirtani ne. array (boolean): Don tantance ko hujjar umarni na nau'in tsararru ne. presentIf (kirtani): Wannan na iya zama keɓaɓɓen kirtani na ayyuka masu ma'ana dangane da wasu gardama na umarni inda zaku iya tsammanin hujjar umarni idan kirtani na yanayi ta kimanta gaskiya. misali:

Lura: Anan matsayi shine wani sunan hujjar umarni. na zaɓi (boolean): Ana amfani dashi don tantance hujjar umarni azaman zaɓi. countArg: Ana amfani dashi lokacin da gardamar umarni ta nau'in tsararru ne. Ana amfani da wannan don ambaton sauran gardamar umarni wanda ke nuna girman tsararru don wannan hujja.

Intro: An yi amfani da shi don tantance ƙayyadaddun sigar da aka gabatar da hujjar umarni. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. RemoveIn: Ana amfani da shi don tantance ƙayyadaddun sigar da aka cire hujjar umarni a ciki. Ana amfani da wannan ta janareta na lamba don ƙara ƙarin dabaru. Za'a iya ayyana Tsawaita Tagulla a cikin mai daidaitawa tag. Ana amfani da tsawo na gungu don tsawaita daidaitaccen gungu tare da halayen masana'anta da umarni misali

19/35

Custom XML Tags domin Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME" type = "INT16U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" zaɓi = "gaskiya" manufacturerCode = "0 1002"> SampLe Mfg Musamman Sifa: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ nau'in = "INT8U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya" manufacturerCode = "0 1049"> SampLe Mfg Musamman Sifa: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ nau'in = "INT8U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 00" na zaɓi = "gaskiya" manufacturerCode = "0 1002"> SampLe Mfg Musamman Sifa: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ nau'in = "INT16U" min = "0 0000" max = "0xFFFF" rubuta = "gaskiya" tsoho = "0 0000" na zaɓi = "gaskiya" manufacturerCode = "0 1049"> SampLe Mfg Specific Sifa: 0 0001 0 1040ampleMfgSpecificOffWithTransition" zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umurnin abokin ciniki wanda ke kashe na'urar tare da canjin da aka bayar
A cikin watan, Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificOnWithTransition" na zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umarnin abokin ciniki wanda ke kunna na'urar tare da canjin da aka bayar
A cikin watan, Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificToggleWithTransition" zaɓi = "gaskiya" manufacturerCode = "0 1002″> Umurnin abokin ciniki wanda ke kunna na'urar tare da canjin da aka bayar
A cikin watan, Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificOnWithTransition2 ″ na zaɓi =”gaskiya” manufacturerCode=”0 1049″> Umarnin abokin ciniki wanda ke kunna na'urar tare da canjin da aka bayar
A cikin watan, Ember Sample miƙa mulki lokaci sifa.ampleMfgSpecificToggleWithTransition2″ na zaɓi =”gaskiya” manufacturerCode=”0 1049″> Umurnin abokin ciniki wanda ke kunna na'urar tare da canjin da aka bayar
A cikin watan, Ember Sample miƙa mulki lokaci sifa.

20/35

Nau'o'in Na'ura da yawa a Kowane Wurin Ƙarshe

Wannan siffa ce ta Matter-kawai inda mai amfani zai iya zaɓar nau'in na'ura fiye da ɗaya a kowane wurin ƙarshe. Ƙarin nau'ikan na'urorin aaa da yawa zai ƙara daidaita tsarin cluster a cikin nau'ikan na'urar zuwa yanayin daidaitawa.

21/35

Nau'o'in Na'ura da yawa a Kowane Wurin Ƙarshe

Hoton da ke sama yana nuna cewa ƙarshen ƙarshen 1 yana da nau'ikan na'urori fiye da ɗaya da aka zaɓa. "Na'urar Farko" tana nuna nau'in na'ura na farko wanda za a haɗa ƙarshen ƙarshen. Nau'in na'ura na farko koyaushe yana kasancewa a index 0 na jerin nau'ikan na'urorin da aka zaɓa don haka zaɓin nau'in na'ura na farko daban zai canza tsarin na'urar da aka zaɓa. Hakanan zaɓin nau'in na'urar yana da takura bisa ƙayyadaddun Samfuran Bayanai. ZAP yana kare masu amfani daga zaɓar haɗaɗɗen nau'ikan na'urori marasa inganci akan ƙarshen ta amfani da waɗannan ƙuntatawa.

22/35

Shafi na Nau'in Matter Na'ura
Shafi na Nau'in Matter Na'ura
Shafi na Nau'in Matter Na'ura
ZAP yana goyan bayan gani da jujjuya fasalin Matter a cikin nau'in fasalin fasalin na'urar. Siffofin nau'in na'ura kawai da aka ƙayyade a cikin matter-devices.xml a cikin ma'ajiyar CHIP za a nuna.

Kewayawa zuwa Shafin Feature
ò Kaddamar da ZAP a cikin Matter tare da Matter SDK na zamani. ó Ƙirƙiri wurin ƙarshe tare da nau'in na'urar Matter. Danna maɓallin Fasalolin Nau'in Na'ura a saman tsakiyar tarin view. Lura cewa wannan maɓallin yana samuwa ne kawai a cikin ZAP
daidaitawa don Matter da lokacin da bayanan yarda ya wanzu a cikin Matter SDK. Danna wannan maɓallin zai buɗe hoton da ke sama.
Conformance
Conformance yana bayyana zaɓi da dogaro ga halaye, umarni, abubuwan da suka faru, da nau'ikan bayanai. Yana ƙayyadaddun ko kashi na tilas ne, na zaɓi, ko mara tallafi ƙarƙashin wasu saitunan ZAP.
Daidaiton fasalin nau'in na'ura yana da fifiko akan fasalin fasalin gungu. Don misaliampHar ila yau, fasalin Haske yana da zaɓi na zaɓi a cikin Kunnawa / Kashewa amma an ayyana shi azaman wajibi a cikin nau'in na'urar Kunnawa/Kashe wanda ya haɗa da gunkin Kunnawa/Kashe. Ƙirƙirar ƙarshen ƙarshen tare da nau'in na'urar Kunnawa / Kashe Haske zai nuna fasalin Haske a matsayin wajibi akan shafin fasalin.
Siffar Juyawa
A shafin fasalin, bayan kun danna maɓallin juyawa don kunna ko kashe fasalin, ZAP zai:
Sabunta abubuwan da ke da alaƙa (halaye, umarni, abubuwan da suka faru) don daidaita daidaito, da nuna tattaunawa da ke nuna canje-canje.

23/35

Shafi Nau'in Nau'in Matter Na'urar Sabunta ɗan ƙaramin fasalin a cikin fasalin fasalin taswira na gungu mai alaƙa

Kunna Tattaunawar Siffar

Kashe Maganar Siffar

An kashe jujjuyawa don wasu fasalulluka lokacin da daidaiton su yana da ƙimar da ba a san shi ba ko kuma a halin yanzu wanda ba ya goyan bayan fom t. A cikin wannan ac se, ZAP zai nuna gargadi a cikin sanarwar ap ne.
a Wa Element Conform nce rnings

Lokacin da kuka kunna wani abu, ZAP na iya nuna gargadin yarda da na'urar duka da gargaɗin yarda. Idan yanayin yanayin bai dace da daidaitattun da ake tsammani ba, ZAP za ta nuna alamar faɗakarwa kuma ta shiga cikin sanarwar ap ne. Exampna duka biyun yarda da faɗakarwa da aka nuna don wani abu:

24/35

Sanarwa
Sanarwa
Sanarwa
Sashe mai zuwa yana bayyana yadda ake ba da sanarwa ga masu amfani da ZAP a cikin UI.
Fakitin Fadakarwa
Sanarwa na fakiti sune gargaɗin ko saƙonnin kuskure masu alaƙa don kowane takamaiman fakitin da aka loda cikin ZAP. Domin misaliampDon haka, a cikin hotunan da ke ƙasa, danna alamar gargaɗin ƙarƙashin ginshiƙin matsayi zai kai ku ga maganganun da ke nuna duk sanarwar fakitin.

25/35

Sanarwa
Fadakarwa Zama
Sanarwa na zama gargadi ne ko saƙonnin kuskure waɗanda ke da alaƙa da zaman mai amfani. Ana iya ganin waɗannan faɗakarwa/kurakurai ta danna maɓallin Fadakarwa a cikin kayan aiki a saman ZAP UI. Don misaliample, hoton da ke ƙasa yana nuna shafin sanarwar zaman bayan isc file an ɗora a cikin ZAP.

26/35

Bayanan Bayani-Model/Binciken Ƙayyadaddun Bayanin ZCL
Bayanan Bayani-Model/Binciken Ƙayyadaddun Bayanin ZCL
Samfurin Bayanai da Yarda da Ƙididdiga na ZCL
Wannan fasalin a cikin ZAP yana taimaka wa masu amfani su ga gazawar yarda don Model Data ko ZCL tare da saitin ZAP ɗin su. Saƙonnin faɗakarwa don gazawar bin doka za su bayyana akan faretin Fadakarwa a cikin ZAP UI kuma kuma za a shiga cikin na'ura wasan bidiyo yayin gudanar da ZAP ta hanyar CLI. Siffar yarda a halin yanzu tana ba da faɗakarwa don yarda da nau'in na'ura da kuma bin gungu akan ƙarshen ƙarshen.
Gargadin Biyayya a cikin ZAP UI
Lokacin da mai amfani ya buɗe .zap file ta amfani da ZAP UI za su ga faɗakarwa a cikin sanarwar sanarwa na ZAP UI don duk gazawar yarda. Don misaliample, hoton da ke ƙasa yana nuna shafin sanarwar zaman bayan .zap file an bude shi tare da batutuwan yarda.

Saƙonnin yarda za su tafi da zarar an warware matsalolin ta amfani da ZAP UI wanda za ku iya ci gaba da lura da sauran batutuwan yarda kawai. Sabbin faɗakarwa kuma za su nuna don yarda idan mai amfani ya hana abubuwan da suka wajaba (gungu/umarni/ halaye) na daidaitawa. Faɗin ƙayyadaddun ƙayyadaddun ƙayyadaddun ƙayyadaddun bayanai koyaushe za su ci gaba da lura da duk wata gazawa da aka gabatar a cikin tsarin ZAP amma lura cewa gargaɗin da ke nunawa yayin buɗe .zap file sun fi dalla-dalla kan dalilin da ya sa ya gaza yin biyayya idan aka kwatanta da gargaɗin da ke nunawa yayin mu'amala da UI. Wannan shi ne ta ƙira kuma ana yin cikakken tabbatarwa yayin buɗe .zap file.
Gargadin Biyayya akan Console

27/35

Bayanan Bayani-Model/Binciken Ƙayyadaddun Bayanin ZCL
Lokacin da mai amfani ya buɗe .zap file ta amfani da ZAP tsaye UI ko ZAP CLI za su ga gargaɗin da aka shiga cikin na'ura mai ba da hanya tsakanin hanyoyin sadarwa / tasha don duk gazawar yarda. Don misaliampHar ila yau, hoton da ke ƙasa yana nuna gargaɗin sanarwar zaman a kan na'ura mai kwakwalwa / tasha bayan .zap file an bude shi tare da batutuwan yarda.

28/35

Ikon shiga

Siffofin Kulawa da shiga
ZAP yana goyan bayan ikon samun dama akan duk abubuwan ZCL. Ya rage zuwa aiwatar da SDK don taswirar waɗannan fasalulluka zuwa abubuwan da ake buƙata da goyan bayan abubuwan sarrafa SDK. ZAP gabaɗaya yana ba da ƙirar bayanai da kuma hanya don ɓoye shi a cikin bayanan meta files da kuma yada wannan bayanan zuwa samfuran tsara, ba tare da sanya takamaiman ma'ana ga wuraren bayanan ba.
Sharuɗɗan tushe
Ikon samun damar ZAP yana bayyana sharuɗɗan tushe guda uku, kamar haka: ò aiki : an ayyana shi azaman wani abu da za a iya yi. Example: karanta, rubuta, kira. rawar: an bayyana shi azaman gata na ɗan wasan kwaikwayo. Kamar "View gata”, “Gudun Gudanarwa”, da kuma ɗa. ô masu gyara: an ayyana azaman yanayin kulawa na musamman, kamar bayanan masana'anta ko bayanan da aka keɓe. An bayyana sharuɗɗan tushe a cikin metadata XML ƙarƙashin sama tag . Mai zuwa shine tsohonampma'anar ma'anar ma'anar ma'anar ma'anar ikon samun dama:
<role type=”view"bayani ="View gata”/>
Wannan exampLe ya bayyana ayyuka guda uku, karantawa, rubutawa da kira, masu gyara biyu da ayyuka huɗu.
Samun damar Triplets
Ana iya siffanta kowane yanayin samun damar mutum tare da samun damar sau uku a cikin XML. Samun damar sau uku haɗe ne na aiki, rawar da mai gyara. Suna na zaɓi, don haka za ku iya samun ɗaya daga cikin waɗannan. Bangaren da ya ɓace na sau uku gabaɗaya yana nufin izini, wanda ke ƙayyadaddun aiwatarwa ga SDK da aka bayar. Mahalarta da ke ayyana damar shiga na iya samun damar shiga ɗaya ko fiye da sau uku. Mai zuwa shine tsohonampda:
ku 0
Wannan ma'anar sifa ce wacce ke da damar samun sau uku, yana bayyana shi yana ba da damar yin aiki ta hanyar aikin gudanarwa, tare da yin amfani da na'urar gyara kayan aiki.
Izini na asali

29/35

Ikon shiga
Ƙungiyoyin ZCL na iya ayyana nasu izini ɗaya. Duk da haka, akwai kuma ma'anar duniya na tsoffin izini don
da aka ba iri. Ana ɗaukar waɗannan don mahaɗin da aka bayar, sai dai idan ya ba da takamaiman izini na kansa.
Ana bayyana tsoffin izini ta hanyar a tag a saman matakin XML file. Exampda:
aa a <ccess op=”kira”/> a a aa <ccess op=”re d”/> a<ccess op=”rubuta”/> a aa aa <ccess op=”re d” role=”view”/> aa <ccess op=”write” role=”oper te”/> a
Mataimakan Samfura
Babban mataimaki na samfuri don amfani shine {{#access}} … {{/access}} mai maimaitawa. Wannan mai jujjuyawar yana jujjuya duk hanyoyin samun dama da aka bayar sau uku.
Yana goyan bayan zaɓuɓɓuka biyu masu zuwa:
entity=”siffa/umurni/hakika” – idan ba za a iya tantance mahallin daga mahallin ba, wannan yana saita nau’in mahallin. hadeddeDefault=”gaskiya/karya” – yana tantance idan an hada da tsoffin dabi’u ko a’a. Mai zuwa shine tsohonampda:
{{#zcl_clusters}}
a Cluster: {{n ni}} [{{code}}] a {{#zcl_ tributes}} aa - sifa: {{n ni}} [{{code}}] aa {{# ccess entity=" sifa"}}
O a RM a M * p: {{operation}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}} a {{/zcl_ tributes}} a {{#zcl_comm nds}} aa - comm nd: {{n me}} [{{code}} c m" aa {{{1} p: {{operation}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – Event: {{n me}} [{{code}}] a {{# ccess entity="event"}} O a RM a M * p: {{oper tion}} / ole: {{role}} / odifier: {{ccess odifier}} a{{/ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Ƙaddamar da ZAP don aikace-aikacen Matter ko Zigbee
Ƙaddamar da ZAP don aikace-aikacen Matter ko Zigbee
Ƙaddamar da ZAP don Aikace-aikacen Matter ko Zigbee
Sassan masu zuwa suna bayyana ƙaddamar da ZAP a cikin keɓantaccen yanayi tare da takamaiman metadata na Matter ko Zigbee. Manufar ita ce ƙaddamar da ZAP tare da ingantattun gardama masu alaƙa da metadata XML (ƙungiya da ma'anar nau'ikan na'ura kamar yadda aka tsara na CSA) da samfuran tsarawa, waɗanda ake amfani da su don samar da lambar da ta dace.
Ƙaddamar da ZAP tare da Matter
Rubutun mai zuwa yana ɗaukar daidaitattun metadata daga Matter SDK lokacin ƙaddamar da ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Lura: Hakanan zaka iya ɗaukar hanyar Zigbee mai zuwa don ƙaddamar da ZAP a cikin Matter.
Ƙaddamar da ZAP tare da Zigbee
Umurni mai zuwa yana ƙaddamar da ZAP tare da ƙayyadaddun ZCL da samfuran tsarawa daga SDK.
[zap-hanya] -z [sdk-hanya]/gsdk/app/zcl/zcl-zap.json -g [sdk-hanya]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
Hanyar zap: Wannan ita ce hanyar zuwa tushen ZAP ko hanyar sdk mai aiwatarwa: Wannan ita ce hanyar zuwa SDK
Ƙaddamar da ZAP ba tare da Metadata ba
Ka tuna cewa lokacin ƙaddamar da ZAP kai tsaye ta hanyar aiwatarwa ko daga tushe ta amfani da npm run zap kuna ƙaddamar da ZAP tare da gwajin metadata don Matter/Zigbee da aka gina a cikin ZAP kuma ba ainihin metadata da ke fitowa daga Matter da Zigbee SDKs da aka ambata a sama ba. Don haka, ku tuna ƙirƙirar saitin ZAP ɗinku ta amfani da metadata SDK kuma ba ta buɗe ZAP kai tsaye tare da ginanniyar metadata na gwaji ba.

31/35

Ƙirƙirar lamba don Matter ko Zigbee

Ƙirƙirar Code don Matter, Zigbee ko Custom SDK
Sassan da ke gaba suna bayyana yadda ake samar da lamba ta amfani da ZAP.
Ƙirƙirar lamba ta amfani da ZAP UI
Kaddamar da ZAP UI kamar yadda umarni ke cikin Ƙaddamar da ZAP don Matter ko Zigbee kuma danna maɓallin Ƙirƙiri a saman mashaya menu.
Ƙirƙirar Code ba tare da UI ba
Umurnai masu zuwa suna ba da hanyoyi daban-daban na samar da lamba ta hanyar CLI ba tare da ƙaddamar da ZAP UI ba.
Ƙirƙirar Code daga Tushen ZAP
Gudun umarni mai zuwa don samar da lamba ta amfani da ZAP daga tushe: node src-script/zap-generate.js -genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-
template/zigbee/gen-templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp
Ƙirƙirar Lambobi daga ZAP Executable
Gudun umarni mai zuwa don samar da lambar ta amfani da ZAP mai aiwatarwa: [zap-path] generated -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
Ƙirƙirar Code daga ZAP CLI Executable
Gudun umarni mai zuwa don samar da lambar ta amfani da ZAP CLI Executable: [zap-cli-path] haifar -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

Sabunta ZAP a cikin Studio

Sabunta ZAP
Sabunta ZAP a cikin Sauƙi Studio
Ana iya amfani da wannan hanyar yayin aiki tare da haɓaka Matter ko Zigbee daga fitowar Silicon Labs SDK. Za a iya sabunta ZAP a cikin Sauƙaƙe Studio ba tare da sakin Sauƙaƙe Studio ta hanyar zazzage sabuwar ZAP mai aiwatarwa (an shawarta) ko ja mafi sabo daga tushen ZAP kamar yadda aka nuna a Jagoran Shigar ZAP. Bayan kana da sabuwar ZAP dangane da OS ɗin da kake amfani dashi a halin yanzu, zaku iya sabunta ZAP a cikin Studio azaman fakitin adaftar. Bi umarnin da ke ƙasa bayan zazzage sabuwar ZAP:
Je zuwa Sauƙi Studio kuma zaɓi Zaɓuɓɓuka> Sauƙi Studio> Fakitin Adafta. Danna Ƙara… kuma bincika zuwa babban fayil ɗin ZAP da kuka zazzage kuma danna Zaɓi Jaka . Danna Aiwatar da Rufe sannan kuma za a yi amfani da sabon ZAP da aka ƙara a duk lokacin da .zap file an bude.
Lura: Wani lokaci ana iya samun tsofaffin lokuta na ZAP da ke gudana ko da bayan an sabunta su zuwa sabuwar ZAP. Tabbatar da kawo karshen duk wasu misalai na ZAP kamar yadda za a yi amfani da sabon ZAP maimakon tsohon misali, wanda har yanzu yana aiki a bango.
Sabunta ZAP don Ci gaban Al'amura a Github
Lokacin aiki tare da Matter ko Matter-Silicon Labs repos akan Github, saita sauye-sauyen yanayi dangane da ZAP don ƙirƙira/samar da sabbin saitunan ZAP ko sake haifar da s data kasance.ample ZAP saitin bayan amfani da canje-canje a gare su. Saita ZAP_DEVELOPMENT_PATH zuwa ZAP daga tushe ta hanyar cire sabon ko saita ZAP_INSTALLATION_PATH zuwa ZAP mai aiwatarwa wanda kuka zazzage karshe a cikin kundin adireshin ku. Lura cewa lokacin da aka saita duka ZAP_DEVELOPMENT_PATH da ZAP_INSTALLATION_PATH, ana amfani da ZAP_DEVELOPMENT_PATH.
Wadannan su ne exampKadan hakan ya nuna masu canjin yanayi na sama da ake amfani da su:
Ƙaddamar da ZAP ta amfani da ƙayyadaddun Matter Yana Sake haɓaka duk sampda tsarin ZAP don aikace-aikacen Matter
Lura: Lokacin amfani da masu aiwatarwa na ZAP, tabbatar cewa kuna amfani da sakin hukuma akan sakin dare don ƙarin kwanciyar hankali. Duba
Zazzage ZAP Executable a cikin Jagorar Shigar ZAP

33/35

Multi-protocol na lokaci ɗaya tsakanin Zigbee da Matter
Multi-protocol na lokaci ɗaya tsakanin Zigbee da Matter
MCoanttceurrrent Multi-protocol tsakanin Zigbee da
Za a iya amfani da ZAP don saita saitunan ZCL (Zigbee) da Data-Model (Matter) a cikin aikace-aikacen yarjejeniya da yawa don Zigbee da Matter. ZAP yana ba ku damar ƙirƙirar wuraren ƙarewa don Zigbee da Matter a sarari a cikin tsari iri ɗaya file. Idan wuraren ƙarshen Zigbee da Matter suna kan mai gano ƙarshen ƙarshen (misaliample, LO Dimmable Light akan ƙarshen Id 1 da Matter Dimmable Light akan wani misali na ƙarshen ƙarshen 1), ZAP tana kula da daidaita halayen gama gari a cikin halayen Matter da Zigbee. Tabbatar cewa halayen da ake daidaitawa suna da nau'in bayanai iri ɗaya. An kafa halayen gama-gari tsakanin Zigbee da Matter ta hanyar a file mai suna Multi-protocol.json . Mai amfani zai iya haɗa kowane gungu biyu a fadin Zigbee da Matter tare da madaidaitan halayensu ta amfani da gungu da lambobin sifa bi da bi. Wannan file ana iya samuwa a cikin [SDKPath]/app/zcl/multi-protocol.json. Wannan file an sabunta shi tare da takamaiman gungu da halaye don farawa, amma mai amfani zai iya sabunta wannan file kamar yadda ake buƙata kuma ZAP zata kula da daidaita tsarin sifa a cikin Zigbee da Matter don masu gano ƙarshen gama gari gama gari.
Hakanan zaka iya samun koyawa ta ZAP a cikin kowace Zigbee da Matter aikace-aikacen yarjejeniya da yawa a ƙarƙashin shafin koyawa. Wannan koyaswar za ta jagorance ku ta hanyar ƙirƙirar aikace-aikacen ƙa'idodi da yawa. Wannan koyawa tana samuwa ne kawai idan kun buɗe aikace-aikacen yarjejeniya da yawa kuma ana iya samun su kamar yadda aka nuna a hoton da ke ƙasa:

34/35

Haɗa SLC CLI tare da ZAP
Haɗa SLC CLI tare da ZAP
Haɗa SLC CLI tare da ZAP
Bi waɗannan matakan don haɗa SLC CLI tare da ZAP: ò Sanya SLC CLI ta bin umarnin shigarwa a cikin Sauƙi Studio 5 Jagorar Mai amfani. ó Shigar da ZAP ta bin umarnin da ke cikin Jagoran Shigarwa na ZAP. Don haɗa SLC CLI tare da ZAP, ƙara canjin yanayi STUDIO_ADAPTER_PACK_PATH wanda ke nuna aikace-aikacen ZAP
directory. õ Ka tuna sake kunna SLC CLI Daemon bayan mataki na 3. ö Duk wani aikin da ke amfani da ZAP zai yi amfani da hanyar da aka ayyana a mataki na 3 lokacin da aka samar daga SLC CLI. Da fatan za a koma zuwa SLC CLI
Amfani don umarni kan amfani da SLC CLI don ayyukan ku.

35/35

Takardu / Albarkatu

SILICON LABS ZAP Haɓaka Tare da Silicon Labs [pdf] Littafin Mai shi
Haɓaka ZAP Tare da Labs na Silicon, ZAP, Haɓakawa Tare da Labs na Silicon, Labs Silicon, Labs

Magana

Manual mai amfani

ZAP Haɓaka Tare da Silicon Labs

Ƙayyadaddun bayanai

Umarnin Amfani da samfur

FAQs

Haɓakawa tare da Silicon Labs ZAP

ZAP Farawa

Shigar da ZAP

Tushen ZAP

Custom XML

Custom XML Tags domin Zigbee

Nau'o'in Na'ura da yawa a Kowane Wurin Ƙarshe

Ikon shiga

Ƙirƙirar lamba don Matter ko Zigbee

Sabunta ZAP a cikin Studio

Takardu / Albarkatu

Magana

Bar sharhi

Soke amsa