ZAP Ngembangake Kanthi Manual Pemilik Silicon Labs

ZAP Miwiti
- Kanggo miwiti ZAP, tindakake langkah iki:
  - Unduh ZAP Executable saka repositori resmi.
  - Instal dependensi nggunakake perintah npm install.
  - Kanggo instalasi khusus Windows, deleng pandhuan Instalasi ZAP kanggo Windows OS.
Pangembangan Zigbee
- Yen sampeyan ngembangake aplikasi Zigbee:
  - Gunakake Simplicity Studio sing kalebu ZAP lan alat liyane sing dibutuhake.

Pangembangan Materi
- Yen sampeyan ngembangake aplikasi Matter:
  - Opsi kalebu nggunakake Simplicity Studio utawa ngakses repositori Silicon Labs utawa CSA Github.
  - Delengen pandhuan nganyari kanggo ZAP ing njaba siklus rilis Simplicity Studio yen perlu.

Pitakonan

P: Apa macem-macem versi binari ZAP sing kasedhiya?
- A: Ana rong versi sing kasedhiya - Rilis resmi kanthi mbangun sing wis diverifikasi lan pra-rilis kanthi fitur paling anyar.

P: Apa sing kudu ditindakake yen nemoni masalah kompilasi perpustakaan asli sajrone instalasi?
- A: Delengen informasi FAQ babagan skrip khusus platform kanggo ngrampungake masalah kasebut.

“`

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Ngembangake karo Silicon Labs ZAP

Miwiti
ZAP Miwitiview Instalasi ZAP Instalasi ZAP Windows FAQ
Fundamentals ZAP Fundamentals
Pandhuan Pangguna Pandhuan Pangguna ZAPview Custom XML Custom XML Tags kanggo Zigbee Multiple Types Devices per Endpoint Matter Type Device Type Feature Page Notifications Data-Model/ZCL Specification Compliance Access Control Bukak ZAP kanggo Matter utawa aplikasi Zigbee Ngasilake kode kanggo Matter utawa Zigbee Update ZAP ing Studio Concurrent Multi-protocol antarane Zigbee lan Matter Integrasi SLC CLI karo ZAP

1/35

Ngembangake karo Silicon Labs ZAP
Ngembangake karo Silicon Labs ZAP
ZAP
ZAP minangka mesin generasi kode umum lan antarmuka panganggo kanggo aplikasi lan perpustakaan adhedhasar Zigbee Cluster Library saka Zigbee utawa Model Data saka Matter. Spesifikasi kasebut dikembangake dening Connectivity Standards Alliance. ZAP ngidini sampeyan nindakake operasi ing ngisor iki:
Nindakake generasi khusus SDK kanggo kabeh artefak global (konstanta, jinis, ID, lan liya-liyane) adhedhasar spesifikasi ZCL/Data-Model. Nindakake generasi khusus SDK saka kabeh artefak konfigurasi sing dipilih pangguna (konfigurasi aplikasi, konfigurasi endpoint, lan liya-liyane) adhedhasar spesifikasi ZCL/Data-Model lan konfigurasi aplikasi sing disedhiyakake pelanggan. Nyedhiyani UI kanggo pangguna pungkasan kanggo milih konfigurasi aplikasi tartamtu (titik pungkasan, kluster, atribut, printah, lan liya-liyane).

Isi ing bagean kasebut nerangake carane ngembangake aplikasi Zigbee lan Matter kanthi ngonfigurasi Lapisan ZCL (Zigbee) utawa Model Data (Matter) nggunakake ZAP.

2/35

ZAP Miwiti

ZAP Miwiti
Miwiti ZAP
Bagean kasebut nggambarake macem-macem cara kanggo nggawe aplikasi Zigbee lan Matter. Elinga yen Simplicity Studio nyedhiyakake cara kanggo nggawe aplikasi Zigbee lan Matter saka mburi nganti pungkasan ing ngendi kabeh alat wis diinstal bebarengan karo Simplicity Studio (kalebu ZAP). Sampeyan uga bisa mutusake kanggo njelajah cara liya kanggo nggawe aplikasi, kaya sing diterangake ing kene.
Pangembangan Zigbee
Pangembang aplikasi Zigbee bisa mbangun aplikasi nggunakake Simplicity Studio, sing wis kalebu ZAP lan alat liyane sing mbantu sampeyan mbangun aplikasi saka mburi nganti pungkasan.
Pangembangan Materi
Pangembang Aplikasi Matter bisa mbangun aplikasi kanthi nggunakake metode ing ngisor iki: Simplicity Studio: Iki kalebu ZAP lan alat liyane sing dibutuhake kanggo mbangun aplikasi Matter nganti pungkasan. Github (Silicon Labs) Github (CSA)
Cathetan: Kanggo nganyari ZAP ing njaba siklus rilis Simplicity Studio, deleng nganyari ZAP ing Simplicity Studio lan Pandhuan Instalasi ZAP

3/35

Instalasi ZAP

Bagean ing ngisor iki nggambarake instalasi ZAP lan carane nganyari ZAP ing Simplicity Studio IDE.
Ngundhuh ZAP Executable Recommended)
Iki minangka cara sing disaranake kanggo miwiti ZAP. Sampeyan bisa entuk binari ZAP paling anyar saka aa https://github.com/project-chip/zp/releses. Binari sing wis dibangun teka ing rong versi sing beda.
Rilis resmi: Diverifikasi dibangun kanthi suite tes Matter lan Zigbee khusus. Format jeneng rilis yaiku vYYYY.DD.MM. Pra-rilis: Dibangun kanthi fitur paling anyar lan koreksi bug, nanging bangunan kasebut ora diverifikasi nganggo suite uji Matter lan Zigbee sing darmabakti. Format jeneng release vYYYY.DD.MM-nightly.
Nginstal ZAP saka Sumber
Pandhuan dhasar kanggo Instal ZAP
Amarga iki aplikasi node.js, sampeyan kudu diinstal lingkungan simpul. Cara paling apik kanggo nindakake iki yaiku ndownload instal paling anyar saka simpul, sing kalebu simpul lan npm. Yen sampeyan duwe versi lawas saka simpul diinstal ing workstation, bisa nimbulaké masalah, utamané yen wis lawas banget. Priksa manawa sampeyan duwe versi v16.x simpul paling anyar kanthi npm sing kalebu. Run node -version kanggo mriksa versi sing dijupuk. v18.x dianjurake. Sawise sampeyan duwe versi simpul sing dikarepake, sampeyan bisa mbukak ing ngisor iki:
Instal Dependensi
Gunakake printah ing ngisor iki kanggo nginstal dependensi:

nginstal npm
Cathetan: Kanggo instalasi ZAP khusus Windows, deleng Instalasi ZAP kanggo OS Windows Ora umum yen ana masalah kompilasi perpustakaan asli ing wektu iki. Ana macem-macem skrip src-script/install-* kanggo macem-macem platform. Deleng informasi FAQ babagan skrip sing bakal ditindakake ing platform sing beda-beda banjur mbukak maneh npm install .
Miwiti Aplikasi
Gunakake printah ing ngisor iki kanggo miwiti aplikasi:

npm mbukak zap
Miwiti Front-End ing Mode Pangembangan
Ndhukung reloading kode panas, laporan kesalahan, lan liya-liyane. Gunakake printah ing ngisor iki kanggo miwiti front-end ing pembangunan
mode:
quasar dev -m elektron
or

4/35

ZAP Insta ing oll in
npm run electron-dev

5/35

Instalasi ZAP Windows
Instalasi ZAP Windows
Instalasi ZAP kanggo OS Windows
1. Windows Powershell
Ing garis telusur desktop, ketik Windows Powershell lan mbukak minangka administrator. Jalanake kabeh printah ing ngisor iki ing Powershell.
2. Coklat
Instal saka https://chocolatey.org/install. Priksa manawa diinstal kanthi bener kanthi printah ing ngisor iki:
coklat -v
Instal paket pkgconfiglite kanthi printah ing ngisor iki:
choco nginstal pkgconfiglite
3. Instal Node
Jalanake printah ing ngisor iki kanggo nginstal:
choco nginstal nodejs-lts
*Versi kudu 18 kanggo lulus test mriksa versi, sawise nginstal, mriksa karo node -v *Yen sampeyan wis nginstal Node, lan gagal sawetara tes padha ora bisa nemokake Node, instal maneh Node karo coklat maneh.
4. Tindakake Pandhuan dhasar kanggo Instal ZAP
Tindakake pandhuan instalasi ZAP saka sumber ing Instalasi ZAP. Nalika tindakake pandhuan dhasar kanggo nginstal ZAP, awas kesalahan ing ngisor iki lan cara ngatasi:
sqlite3
Nalika mbukak ZAP (contone, npm run zap ), yen sampeyan ndeleng kesalahan babagan sqlite3.node ing jendhela pop munggah, mbukak:
npm mbangun maneh sqlite3
pembangun elektron
Nalika nindakake npm install, ing post-install, yen ana kesalahan ing printah ing ngisor iki related kanggo electron-builder install-appdeps , npx electron-rebuild canvas failed or node-pre-gyp , versi kanvas saiki ora kompatibel karo Windows lan kesalahan instalasi ora bakal nyebabake kegagalan ing ZAP. node-canvas lagi nggarap solusi saiki lan masalah kasebut bakal dirampungake ing mangsa ngarep.
"postinstall": "electron-builder install-app-deps && husky install && npm rebuild canvas -update-binary && npm run version-stamp”

6/35

Instalasi ZAP Windows
Kanvas
Yen npm run test gagal amarga kesalahan Test suite gagal mbukak. Ora bisa nemokake modul '../build/Release/canvas.node' utawa
zapnode_modulescanvasbuildReleasecanvas.node dudu aplikasi Win32 sing bener. , gawe maneh kanvas kaya ing ngisor iki:
npm mbangun maneh kanvas -update-binary
entuk index.html utawa Masalah Server Liyane
Yen npm run test gagal amarga kesalahan njaluk index.html request gagal karo kode status 404 ing unit test utawa gadhah server
masalah sambungan ing tes e2e-ci, jalanake printah ing ngisor iki:
npm run mbangun
Liyane
Priksa manawa versi simpul kasebut v18 lan coba nginstal nganggo Chocolatey.

7/35

FAQ
FAQ
Pitakonan sing Sering Ditakoni
P: Kepiye cara miwiti UI ing mode pangembangan? A: Sampeyan bisa miwiti UI ing mode pangembangan, sing bakal ngasilake persiyapan ing ngisor iki:
Server HTTP pembangunan quasar kapisah, sing urip refresh ing port 8080 ZAP mburi mburi mlaku ing port 9070 Chrome utawa browser liyane, mlaku independen Kanggo njaluk menyang persiyapan sing, tindakake pandhuan ing ngisor iki. ò Pisanan, mbukak server pangembangan ZAP, sing diwiwiti ing port 9070.
npm run zap-devserver ó Sabanjure, mbukak server pangembangan quasar, sing diwiwiti ing port 8080.
quasar dev ô Arah browser sampeyan utawa bukak salah siji sing cocog URL karo argumen restPort:
google-chrome http: // localhost: 8080 /? restPort = 9070

P: Kepiye carane nindakake iki ing Mac/Linux OS? A:
npm install digunakake kanggo ndownload kabeh paket dependensi sing dibutuhake. Yen sampeyan ndeleng kesalahan sing ana gandhengane karo node-gyp lan perpustakaan lokal sing ilang, kaya pixman , lan liya-liyane, sampeyan ora duwe dependensi pribumi kanggo nyukupi kanggo ngumpulake binari simpul non-prebuilt kanggo sawetara kombinasi platform lan versi. Npm ing méga terus nganyari dhaptar binari sing disedhiyakake, mula sampeyan bisa milih kanthi becik, nanging yen ora, iki minangka pandhuan kanggo platform sing beda-beda:
Fedora Core karo dnf:
dnf nginstal pixman-devel cairo-devel pango-devel libjpeg-devel giflib-devel
utawa mbukak skrip:
src-script/install-packages-fedora
Ubuntu karo apt-get:
apt-get update apt-get install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
utawa mbukak skrip:

8/35

FAQ
src-script/install-packages-ubuntu
OSX ing Mac karo Homebrew brew :
brew install pkg-config cairo pango libpng jpeg giflib librsvg
utawa mbukak skrip:
src-script/install-packages-osx
P: Kepiye carane nindakake iki ing OS Windows?
A: Priksa manawa tansah anyar lan ora ana owah-owahan sing durung ditindakake. Tip: git pull, git status & git stash minangka kanca sampeyan. Sampeyan kudu nggunakake Chocolately supaya Zap bisa digunakake ing OS Windows. Priksa manawa kanggo ngundhuh paket pkgconfiglite.
choco nginstal pkgconfiglite
Yen sampeyan duwe masalah karo Cairo, kanggo Example yen sampeyan entuk kesalahan babagan cairo.h': Ora kaya ngono file utawa direktori, tindakake ing ngisor iki: ò Priksa manawa komputer sampeyan 32 utawa 64 bit. ó Gumantung saka iku, download paket sing cocog saka situs iki
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:
Klik ing Advanced System Settings. Ing tab majeng klik Variabel Lingkungan. Ing bagean Variabel Sistem, golek variabel lingkungan PATH banjur pilih. Klik Sunting lan tambahake C:/GTK. Yen variabel lingkungan PATH ora ana, klik Anyar. Yen jpeglib.h ora ditemokake, coba ing ngisor iki: ò Ing terminal, bukak: choco install libjpeg-turbo ó Priksa manawa wis resik kanthi nggunakake: git clean -dxff lan mbukak npm install maneh ô yen ora ana kesalahan lan mung bebaya katon, coba gunakake npm audit fix õ yen sampeyan ora bisa mbukak ZAP, pindhah menyang file src-script/zap-start.js ö Ganti
÷ const {spawn} = mbutuhake('cross-spawn') kanggo const {spawn} = mbutuhake('child_process') ø Run npm lan mbukak zap. Referensi:
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)
P: Aku entuk kesalahan "sqlite3_node" ora ditemokake utawa padha.

9/35

FAQ
A: Mbangun maneh bindings sqlite3 native. Kanggo ndandani iki ing umume kasus, mbukak:
nginstal npm
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Yen isih ora didandani, tindakake:
rm -rf node_modules banjur coba printah ing ndhuwur maneh. Kadhangkala nganyarke npm sampeyan uga nggawe bedane:
npm nginstal -g npm
P: Aku entuk kesalahan "Versi N-API saka conto Node iki yaiku 1. Modul iki ndhukung versi N-API 3. Instance Node iki ora bisa mbukak modul iki."
A: Nganyarke versi simpul sampeyan. Solusi kanggo iki dibahas ing thread Stack Overflow iki: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
P: PC pangembanganku ora bisa digunakake karo ZAP amarga alasan apa wae. Bisa nggunakake wadhah docker?
A: Ya sampeyan bisa. TBD.
P: Kepiye cara mbukak ZAP ing VSCode?
A: Yen sampeyan VSCode ing dalan sampeyan ketik repo zap lan ketik kode. Iki bakal mbukak ZAP ing VSCode. Kanggo mbukak ZAP ing mode debug, pilih ruang kerja ZAP banjur klik lambang Run ing toolbar sisih kiwa. Sampeyan bakal duwe sawetara opsi kanggo milih saka mbukak ZAP, pilih Node.js Debug Terminal . Iki bakal mbukak jendhela terminal saka ngendi sampeyan bisa ngetik npm run zap , sing bakal masang debugger lan mbukak ZAP kaya biasane saka baris perintah. Sugeng, sampeyan saiki kudu ndeleng ZAP mlaku ing debugger. Sampeyan bisa nyetel breakpoints ing VSCode kaya ing IDE liyane.
P: Tes unit UI gagal karo sawetara kesalahan ing kanvas sing ora dibangun kanggo versi simpul sing bener. Apa sing kudu dak lakoni?
A: Yen sampeyan ndeleng kesalahan ing ngisor iki:
FAIL test/ui.test.js Test suite gagal mbukak Modul 'canvas.node' dikompilasi marang versi Node.js sing beda nggunakake NODE_MODULE_VERSION 80. Versi Node.js iki mbutuhake NODE_MODULE_VERSION 72. Coba kompilasi maneh utawa instal maneh modul (contone, `n`pmn mbangun maneh `` utawa`n`pmn nggunakake ``npmn`mbangun maneh).
ing Object. (node_modules/canvas/lib/bindings.js:3 18)
banjur mbukak: npm rebuild canvas –update-binary

10/35

Dasar ZAP

ZCL/Data-Model ZAP Fundamentals
Bagean iki ngemot informasi kanggo pangguna ZAP anyar. Klik ing lambang tutorial ing pojok tengen ndhuwur ZAP UI, kang nuduhake carane nggawe konfigurasi ZAP. Tutorial bakal nuntun sampeyan ing ngisor iki: Nggawe endpoint Pilih jinis piranti Konfigurasi kluster Konfigurasi atribut Konfigurasi printah Kanggo referensi rinci, deleng Zigbee Cluster Configurator Guide

11/35

Pandhuan Pangguna ZAP
Pandhuan Pangguna ZAP
Pandhuan Pangguna ZAP
Bagean ing pandhuan iki nyedhiyakake rincian liyane babagan macem-macem fitur sing diwenehake dening ZAP.

12/35

XML khusus

Nambahake Custom XML saka ZAP UI
Klik ing lambang "Ekstensi" ing ZAP UI. Klik tombol tambah "+" kanggo milih xml khusus file Kluster khusus, atribut, printah, lsp kudu ditampilake ing UI ZAP yen xml khusus wis ditambahake.
Nggawe XML adat dhewe ing Zigbee
Bagean nuduhake carane nggawe kluster adat dhewe lan ngluwihi kluster standar sing ana karo atribut khusus lan printah kanggo Zigbee.
Kluster Spesifik Produsen ing Zigbee
Sampeyan bisa nambah klompok khusus pabrikan menyang pro standarfile. We nyedhiyani mantanample iki ing ngisor iki. Kanggo nindakake iki, sampeyan kudu netepi rong kewajiban:
ID kluster kudu ana ing kisaran khusus pabrikan, 0xfc00 - 0xffff. Dhéfinisi kluster kudu nyakup kode pabrikan sing bakal ditrapake kanggo ALL atribut lan prentah ing kluster kasebut lan kudu diwenehake nalika ngirim lan nampa prentah lan sesambungan karo atribut. Example:

Sample Kluster Spesifik Mfg Umum Kluster iki nyedhiyakake exampbabagan carane Framework Aplikasi bisa ditambahake kanggo kalebu klompok khusus pabrikan.
0xFC00
ember sampatribute
ember sampatribut 2

A sample printah produsen-tartamtu ing sample pabrikan-tartamtu
kluster.

Perintah Khusus Produsen ing Kluster Zigbee Standar
Sampeyan bisa nambah printah dhewe menyang kluster Zigbee standar kanthi syarat ing ngisor iki:
Printah khusus pabrikan sampeyan bisa nggunakake id printah ing kisaran id printah, 0x00 – 0xff. Sampeyan uga kudu nyedhiyani kode Produsèn kanggo printah supaya bisa dibedakake saka printah liyane ing kluster lan ditangani jumbuh. Example saka ngluwihi kluster On / Off karo printah manufaktur:

13/35

XML khusus
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition" optional="true" manufacturerCode="0 1002"> Prentah klien sing mateni piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificOnWithTransition" optional="true" manufacturerCode="0 1002"> Prentah klien sing nguripake piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificToggleWithTransition" optional="true" manufacturerCode="0 1002"> Prentah klien sing ngowahi piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificOnWithTransition2″ opsional=”true” ProdusenCode=”0 1049″> Prentah klien sing nguripake piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificToggleWithTransition2″ opsional = "bener"
Kode pabrik = ”0 1049″> Prentah klien sing ngowahi piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.

Atribut Khusus Produsen ing Kluster Zigbee Standar
Sampeyan bisa nambah atribut dhewe menyang kluster Zigbee standar kanthi syarat ing ngisor iki:
Atribut khusus pabrikan sampeyan bisa nggunakake id atribut ing kisaran id atribut, 0x0000 – 0xffff. Sampeyan uga kudu menehi kode pabrikan kanggo atribut kasebut supaya bisa dibedakake karo atribut liyane ing kluster lan ditangani kanthi tepat. Example saka ngluwihi kluster On/Off kanthi atribut manufaktur:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″
maks = "0xFFFF" bisa ditulis = "bener" standar = "0 0000" opsional = "bener" Kode pabrik = "0 1002"> Sample Mfg Atribut Spesifik: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG.ample Mfg Atribut Spesifik: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG.ample Mfg Atribut Spesifik: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG.ample Mfg Atribut Spesifik: 0 0001 0 1040
Nggawe XML adat dhewe ing Matter
Bagean nuduhake carane nggawe kluster adat dhewe lan ngluwihi kluster standar ana karo atribut khusus lan printah kanggo Matter.
Kluster Spesifik Produsen ing Materi
Sampeyan bisa nambah klompok khusus pabrikan ing Matter. We nyedhiyani mantanample iki ing ngisor iki.
Iki 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 khusus
Ing ngisor iki example, kombinasi ID vendor (Test Produsen ID) 0xFFF1 lan ID kluster 0xFC20 asil ing value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Example:
Umum Samplan MEI 0xFFF1FC20 SAMPLE_MEI_CLUSTER Sampkluster le MEI nampilake ekstensi produsen kluster FlipFlop
Response kanggo AddArguments sing ngasilake jumlah. Printah sing njupuk rong argumen uint8 lan ngasilake jumlahe. Printah prasaja tanpa paramèter lan tanpa nanggepi.
Atribut Khusus Produsen ing Kluster Materi Standar
Sampeyan bisa nambah atribut khusus pabrikan menyang kluster Matter standar kanthi syarat ing ngisor iki:
Kluster kasebut kudu ditemtokake -
e xte nd ed > ">
Kode atribut kasebut minangka kombinasi 32-bit saka kode pabrikan lan id kanggo atribut kasebut. 16 bit sing paling penting yaiku kode pabrikan. Jangkoan kanggo kode pabrikan tes yaiku 0xFFF1 - 0xFFF4. 16 bit sing paling penting yaiku ID atribut. Kisaran kanggo atribut non-global yaiku 0x0000 – 0x4FFF.
Example saka ngluwihi klaster On/Off Matter kanthi atribut khusus pabrikan:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″
max = "0xFFFF" bisa ditulis = "bener" standar = "0 0000" opsional = "bener">Sample Mfg Atribut Spesifik 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″
max = "0xFFFF" bisa ditulis = "bener" standar = "0 0000" opsional = "bener">Sample Mfg Atribut Spesifik 4
Prentah Khusus Produsen ing Kluster Materi Standar
Sampeyan bisa nambah prentah khusus pabrikan menyang kluster Matter standar kanthi syarat ing ngisor iki:
Kluster kasebut kudu ditemtokake -
e xte nd ed > ">
Kode printah kasebut minangka kombinasi 32-bit saka kode pabrikan lan id kanggo printah kasebut. 16 bit sing paling penting yaiku kode pabrikan. Kisaran kanggo kode pabrikan tes yaiku 0xFFF1 - 0xFFF4. 16 bit sing paling penting yaiku ID perintah. Jangkoan kanggo printah non-global yaiku 0x0000 – 0x00FF.
Example saka ngluwihi kluster On/Off Matter kanthi kluster khusus pabrikan:

15/35

XML khusus

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ opsional=”true”> Prentah klien sing nguripake piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ optional=”true”>
Prentah klien sing ngowahi piranti kanthi transisi sing diwenehake dening wektu transisi ing Ember Sample atribut wektu transisi.

16/35

XML khusus Tags kanggo Zigbee

Dokumen ing ngisor iki ngomong babagan saben xml tags digandhengake karo Zigbee.
Saben xml file kadhaptar antarane configurator tags:

Jinis data bisa ditetepake ing configurator tag. Zigbee saiki ndhukung definisi bitmaps, enums, integers, strings utawa structs. Sadurunge nemtokake jinis liyane, priksa manawa sampeyan mriksa kabeh jinis atom sing wis ditemtokake ing types.xml lan kabeh jinis non-atom sing ditetepake ing xml liyane. files. Sampeyan bisa nemtokake kaya ing ngisor iki:
Bitmap: jeneng: jeneng jinis bitmap. jinis: Bitmap karo ukuran antarane 8-64 bit bisa ditetepake, kabeh kudu kelipatan 8. Saben bitmap bisa duwe sawetara kothak karo jeneng lan topeng gadhah. contone:

“`
Enum: jeneng: jeneng jinis enum. jinis: Enum karo ukuran antarane 8-64 bit bisa ditetepake, kabeh kudu kelipatan 8. Saben enum bisa duwe sawetara item karo jeneng lan nilai gadhah. contone:

Integer: Jinis integer wis ditetepake miturut jinis atom sing ana ing types.xml. Ukurane bisa saka 8-64 bit lan bisa ditandatangani utawa ora ditandatangani. contone:

String: Jinis string wis ditetepake miturut jinis atom sing ana ing types.xml. Jinis senar saiki kalebu senar oktet, senar char, senar oktet dawa lan senar dawa umpamane:

Struct: jeneng: jeneng jinis struct. Saben struct bisa duwe sawetara item karo jeneng lan jinis gadhah. Jinis kasebut bisa dadi jinis sing wis ditemtokake miturut jinis data. contone:

17/35

XML khusus Tags kanggo Zigbee

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

Cluster Custom bisa ditetepake ing configurator tag. jeneng: jeneng domain kluster: domain kluster. Kluster kasebut bakal katon ing UI ZAP ing domain iki. gambaran: Descirption kode cluster: kode cluster nemtokake: cluster nemtokake kang digunakake dening generator kode kanggo netepake cluster ing cara tartamtu manufacturerCode: Digunakake kanggo netepake klompok tartamtu Manufaktur. Iki kudu antarane 0xfc00 - 0xffff. Kode pabrikan kanggo kluster kudu ditetepake kaya ing ngisor iki:

Kluster manufaktur kanthi otomatis nggawe atribut lan prentah ing ngisor iki saka kode pabrikan sing padha kajaba kanthi jelas nampilake kode pabrikan. introducedIn: Digunakake kanggo nemtokake versi spek ing kluster kasebut. Iki digunakake dening generator kode kanggo nambah logika tambahan. removedIn: Digunakake kanggo nemtokake versi spek ing ngendi kluster dibusak. Iki digunakake dening generator kode kanggo nambah logika tambahan. singleton (boolean): Digunakake kanggo nemtokake kluster minangka singleton supaya mung ana siji conto kluster sing dienggo bareng ing titik pungkasan. atribut: nemtokake atribut kanggo jeneng cluster: Jeneng atribut kasebut ing antarane atribut tag.
jeneng atribut
sisih (klien / server): Sisih kluster sing digandhengake karo atribut kasebut. kode: kode atribut kode produsen: Iki bisa digunakake kanggo netepake atribut khusus Produsèn njaba specification zigbee kasebut dening xml standar. nemtokake: nemtokake atribut sing digunakake dening generator kode kanggo nemtokake atribut kanthi cara tartamtu. min: Nilai minimal sing diidini kanggo atribut maksimal: Nilai maksimal sing diidini kanggo atribut sing bisa ditulis: Apa nilai atribut bisa ditulis utawa ora. Iki bisa digunakake kanggo nyegah atribut saka diowahi kanthi nulis printah. opsional (boolean): Digunakake kanggo nemtokake apa atribut iku opsional utawa ora kanggo kluster. min: Nilai minimal sing diijini kanggo atribut nalika iku jinis integer, enum utawa bitmap. max: Maksimum diijini Nilai kanggo ngubungake nalika iku integer, enum utawa bitmap jinis dawa: Digunakake kanggo nemtokake dawa maksimum atribut nalika iku saka jinis senar. minLength: Digunakake kanggo nemtokake dawa minimal atribut nalika jinis string. reportable (boolean): Ngandhani yen atribut bisa dilaporake utawa ora isNullable (boolean): Ngidini nilai null kanggo atribut kasebut. array(boolean): Digunakake kanggo ngumumake atribut saka jinis array. introducedIn: Digunakake kanggo nemtokake versi spek ing ngendi atribut kasebut dikenalake. Iki digunakake dening generator kode kanggo nambah logika tambahan. removeIn: Digunakake kanggo nemtokake versi spek sing atribut kasebut dibusak. Iki digunakake dening generator kode kanggo nambah logika tambahan. printah: nemtokake printah kanggo jeneng cluster: Jeneng printah.

kode: kode printah

18/35

XML khusus Tags kanggo Zigbee
kode pabrikan: Iki bisa digunakake kanggo netepake printah tartamtu Produsèn njaba specification zigbee kasebut dening xml standar. katrangan: katrangan sumber printah (klien / server): sumber printah. opsional (boolean): Digunakake kanggo nemtokake manawa prentah iku opsional utawa ora kanggo kluster. introducedIn: Digunakake kanggo nemtokake versi spek ing printah kasebut. Iki digunakake dening generator kode kanggo nambah logika tambahan. removeIn: Digunakake kanggo nemtokake versi spek sing printah dibusak. Iki digunakake dening generator kode kanggo nambah logika tambahan. argumen perintah:
Saben printah bisa duwe sakumpulan argumen printah jeneng: jeneng jinis argumen perintah: jinis argumen perintah sing bisa dadi salah sawijining jinis sing kasebut ing xml. min: Nilai minimal sing diijini kanggo argumentasi nalika jinis integer, enum utawa bitmap. max: Maksimum diijini Nilai kanggo bantahan nalika iku integer, enum utawa bitmap jinis dawa: Digunakake kanggo nemtokake dawa maksimum allowable kanggo bantahan printah nalika iku jinis string. minLength: Digunakake kanggo nemtokake dawa minimal sing diijini kanggo argumen printah nalika jinis string. array(boolean): Kanggo nemtokake manawa argumen printah saka jinis array. presentIf(string): Iki bisa dadi senar kondisional saka operasi logis adhedhasar bantahan printah liyane ngendi sampeyan bisa nyana argumen printah yen string kondisional ngevaluasi bener. contone:

Cathetan: Ing kene status minangka jeneng argumen perintah liyane. opsional (boolean): Digunakake kanggo nemtokake argumen perintah minangka opsional. countArg: Digunakake nalika argumen printah saka jinis array. Iki digunakake kanggo nyebutake argumen perintah liyane sing nuduhake ukuran array kanggo argumen iki.

introducedIn: Digunakake kanggo nemtokake versi spek ing ngendi argumen perintah kasebut dikenalake. Iki digunakake dening generator kode kanggo nambah logika tambahan. removeIn: Digunakake kanggo nemtokake versi spek ing ngendi argumen perintah dibusak. Iki digunakake dening generator kode kanggo nambah logika tambahan. Cluster Extension bisa ditetepake ing configurator tag. Ekstensi klaster digunakake kanggo ngluwihi kluster standar kanthi atribut manufaktur lan printah, contone

19/35

XML khusus Tags kanggo Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG.ample Mfg Atribut Spesifik: 0 0000 0 1002AMPLE_MFG.ample Mfg Atribut Spesifik: 0 0000 0 1049AMPLE_MFG.ample Mfg Atribut Spesifik: 0 0001 0 1002AMPLE_MFG.ample Mfg Atribut Spesifik: 0 0001 0 1040ampleMfgSpecificOffWithTransition" optional="true" manufacturerCode="0 1002"> Prentah klien sing mateni piranti kanthi transisi sing diwenehake
dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificOnWithTransition" optional="true" manufacturerCode="0 1002"> Printah klien sing nguripake piranti kanthi transisi diwenehi
dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificToggleWithTransition" optional="true" manufacturerCode="0 1002"> Prentah klien sing ngowahi piranti kanthi transisi sing diwenehake
dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificOnWithTransition2″ opsional=”true” ProdusenCode=”0 1049″> Printah klien sing nguripake piranti kanthi transisi diwenehi
dening wektu transisi ing Ember Sample atribut wektu transisi.ampleMfgSpecificToggleWithTransition2″ optional=”true” manufacturerCode=”0 1049″> Prentah klien sing ngowahi piranti kanthi transisi sing diwenehake
dening wektu transisi ing Ember Sample atribut wektu transisi.

20/35

Multiple Jinis Piranti Saben Endpoint

Iki minangka fitur mung Matter ing ngendi pangguna bisa milih luwih saka siji jinis piranti saben titik pungkasan. Penambahan sawetara jinis piranti aaa bakal nambah konfigurasi kluster ing jinis piranti menyang konfigurasi titik pungkasan.

21/35

Multiple Jinis Piranti Saben Endpoint

Gambar ing ndhuwur nuduhake yen endpoint 1 duwe luwih saka siji jinis piranti sing dipilih. "Piranti Utama" nuduhake jinis piranti utama sing bakal digandhengake karo titik pungkasan. Jinis piranti utama tansah ana ing indeks 0 saka dhaptar jinis piranti sing dipilih supaya milih jinis piranti utama sing beda bakal ngganti urutan jinis piranti sing dipilih. Pilihan jinis piranti uga duwe watesan adhedhasar Spesifikasi Model Data. ZAP nglindhungi pangguna saka milih kombinasi jinis piranti sing ora bener ing titik pungkasan nggunakake kendala kasebut.

22/35

Kaca Fitur Jinis Piranti Matter
Kaca Fitur Jinis Piranti Matter
Kaca Fitur Jinis Piranti Matter
ZAP ndhukung visualisasi lan ngowahi fitur Matter ing kaca fitur jinis piranti. Mung fitur jinis piranti sing ditemtokake ing matter-devices.xml ing repositori CHIP sing bakal ditampilake.

Navigasi menyang Kaca Fitur
ò Bukak ZAP ing Matter nganggo Matter SDK sing paling anyar. ó Gawe titik pungkasan nganggo jinis piranti Matter. ô Klik tombol Fitur Tipe Piranti ing tengah ndhuwur kluster view. Elinga yen tombol iki mung kasedhiya ing ZAP
konfigurasi kanggo Matter lan nalika data conformance ana ing Matter SDK. Ngeklik tombol iki bakal mbukak gambar ing ndhuwur.
Kesesuaian
Conformance nemtokake opsional lan ketergantungan kanggo atribut, printah, acara, lan jinis data. Iki nemtokake manawa ana unsur wajib, opsional, utawa ora didhukung miturut konfigurasi ZAP tartamtu.
Kesesuaian fitur jinis piranti luwih diutamakake tinimbang kesesuaian fitur kluster. Kanggo exampNanging, fitur Cahya nduweni kesesuaian opsional ing kluster On / Off nanging diumumake minangka prentah ing jinis piranti On / Off Light sing kalebu kluster On / Off. Nggawe titik pungkasan nganggo jinis piranti Cahya On / Off bakal nuduhake fitur Cahya minangka prentah ing kaca fitur.
Fitur Toggling
Ing kaca fitur, sawise sampeyan ngeklik tombol pilihan kanggo ngaktifake utawa mateni fitur, ZAP bakal:
Nganyari unsur sing gegandhengan (atribut, printah, acara) kanggo mbenerake kesesuaian, lan nampilake dialog sing nuduhake owah-owahan.

23/35

Matter Device Type Feature Page Nganyari bit fitur ing atribut featureMap saka kluster sing gegandhengan

Aktifake Dialog Fitur

Pateni Dialog Fitur

Toggling dipateni kanggo sawetara fitur nalika kesesuaian nduweni nilai sing ora dingerteni utawa wangun t sing saiki ora didhukung. Ing ac se iki, ZAP bakal nuduhake bebaya ing kabar ap ne.
a Wa Element Conform nce rnings

Nalika sampeyan ngalih unsur, ZAP bisa nampilake bebaya kepatuhan piranti lan bebaya kepatuhan. Yen negara unsur ora cocog karo conformance samesthine, ZAP bakal nampilake lambang bebaya lan log bebaya ing kabar ap ne. Exampbebaya kepatuhan lan kepatuhan sing ditampilake kanggo unsur:

24/35

Kabar
Kabar
Kabar
Bagean ing ngisor iki nemtokake cara kabar diwenehake marang pangguna ZAP ing UI.
Notifikasi Paket
Kabar paket minangka bebaya utawa pesen kesalahan sing ana gandhengane karo paket tartamtu sing dimuat menyang ZAP. Kanggo exampNanging, ing gambar ing ngisor iki, ngeklik lambang bebaya ing kolom status bakal nggawa sampeyan menyang dialog sing nuduhake kabeh kabar kanggo paket kasebut.

25/35

Kabar
Kabar Sesi
Kabar sesi yaiku bebaya utawa pesen kesalahan sing ana gandhengane karo sesi pangguna. Bebaya / kesalahan iki bisa dideleng kanthi ngeklik tombol Kabar ing toolbar ing ndhuwur ZAP UI. Kanggo exampNanging, gambar ing ngisor iki nuduhake kaca kabar sesi sawise isc file wis dimuat menyang ZAP.

26/35

Data-Model/ZCL Kepatuhan Spesifikasi
Data-Model/ZCL Kepatuhan Spesifikasi
Model Data lan Kepatuhan Spesifikasi ZCL
Fitur ing ZAP iki mbantu pangguna ndeleng kegagalan kepatuhan kanggo Model Data utawa ZCL karo konfigurasi ZAP sing wis ana. Pesen peringatan kanggo kegagalan kepatuhan bakal katon ing panel Notifikasi ing UI ZAP lan uga bakal mlebu ing konsol nalika mbukak ZAP liwat CLI. Fitur kepatuhan saiki menehi bebaya kanggo kepatuhan jinis piranti lan kepatuhan kluster ing titik pungkasan.
Bebaya Kepatuhan ing UI ZAP
Nalika pangguna mbukak .zap file nggunakake ZAP UI, dheweke bakal weruh bebaya ing panel kabar ing ZAP UI kanggo kabeh kegagalan kepatuhan. Kanggo example, gambar ing ngisor iki nuduhake kaca kabar sesi sawise .zap a file dibukak karo masalah kepatuhan.

Pesen kepatuhan bakal ilang yen masalah wis dirampungake nggunakake UI ZAP supaya sampeyan bisa nglacak mung masalah kepatuhan sing isih ana. Bebaya anyar uga bakal katon kanggo kepatuhan yen pangguna mateni unsur wajib (kluster / prentah / atribut) konfigurasi. Kabar kepatuhan spesifikasi bakal tansah nglacak kegagalan apa wae sing ditindakake ing konfigurasi ZAP, nanging elinga yen bebaya sing katon nalika mbukak .zap. file luwih njlimet babagan kenapa gagal kepatuhan yen dibandhingake karo bebaya sing katon nalika sesambungan karo UI. Iki kanthi desain lan mriksa kepatuhan lengkap ditindakake nalika mbukak .zap file.
Bebaya Kepatuhan ing Konsol

27/35

Data-Model/ZCL Kepatuhan Spesifikasi
Nalika pangguna mbukak .zap file nggunakake UI dewekan ZAP utawa ZAP CLI padha bakal weruh bebaya mlebu ing console / terminal kanggo kabeh gagal selaras. Kanggo example, gambar ing ngisor iki nuduhake bebaya kabar sesi ing console / terminal sawise .zap a file dibukak karo masalah kepatuhan.

28/35

Kontrol Akses

Fitur Kontrol Akses
ZAP ndhukung kontrol akses ing kabeh entitas ZCL. Iku mudhun kanggo implementasine saka SDK kanggo peta fitur-fitur kasebut menyang fitur SDK kontrol akses sing dibutuhake lan didhukung. ZAP umume nyedhiyakake model data lan mekanisme kanggo encode ing meta-info files lan propagate data kasebut menyang cithakan generasi, tanpa menehi makna tartamtu kanggo titik data.
Syarat Dasar
Kontrol akses ZAP nemtokake telung istilah dhasar, kaya ing ngisor iki: ò operasi : ditetepake minangka soko sing bisa ditindakake. Example: maca, nulis, ngajak. ó peran: ditetepake minangka hak istimewa saka aktor. Kayata "View hak istimewa", "Peran administratif", lan putra ing. O modifiers: ditetepake minangka kahanan kontrol akses khusus, kayata data sensitif kain utawa data scoped kain. Istilah dhasar ditetepake ing XML metadata ing sisih ndhuwur tag . Ing ngisor iki minangka mantanampDhéfinisi basis kontrol akses:
<role type=”viewDeskripsi =View hak istimewa"/>
Mantan ikiample nemtokake telung operasi, maca, nulis lan nimbali, loro modifiers lan papat peran.
Akses Triplets
Saben kondisi akses individu bisa ditetepake kanthi triplet akses ing XML. Triplet akses minangka kombinasi saka operasi, peran lan modifier. Padha opsional, supaya sampeyan mung bisa duwe siji iki. Bagean triplet sing ilang umume tegese permissivenes, sing spesifik kanggo implementasine kanggo SDK sing diwenehake. Entitas sing nemtokake akses kasebut bisa duwe siji utawa luwih triplet akses. Ing ngisor iki minangka mantanample:
ing0
Iki minangka definisi atribut sing nduweni triplet akses, nyatakake ngidini operasi nulis kanthi peran ngatur, kanthi modifier kain-scoped diterapake.
Idin Default

29/35

Kontrol Akses
Entitas ZCL bisa nemtokake ijin dhewe-dhewe. Nanging, ana uga definisi global ijin standar kanggo
diwenehi jinis. Iki dianggep kanggo entitas tartamtu, kajaba menehi ijin tartamtu dhewe.
Ijin standar diumumake liwat a tag ing tingkat ndhuwur XML file. Example:
aa a<ccess op="invoke"/> a a aa <ccess op=”re d”/> a<ccess op=”write”/> a aa aa <ccess op="re d" role="view”/> aa <ccess op="write" role="oper te"/> a
Helpers Cithakan
Pembantu cithakan dhasar sing digunakake yaiku {{#access}} ... {{/access}} iterator. Iterator iki ngulang kabeh triplet akses sing diwenehake.
Ndhukung rong pilihan ing ngisor iki:
entity = "atribut / printah / acara" - yen entitas ora bisa ditemtokake saka konteks, iki nyetel jinis entitas. includeDefault = "bener / salah" - nemtokake yen nilai standar kalebu utawa ora. Ing ngisor iki minangka mantanample:
{{#zcl_clusters}}
a Kluster: {{n me}} [{{kode}}] a {{#zcl_ ttributes}} aa – ttribute: {{n me}} [{{kode}}] aa {{# ccess entity=” ttribute”}}
O a RM a M * p: {{oper tion}} / ole: {{peran}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{kode}}] aa {{} *# c entitas p: {{oper tion}} / ole: {{peran}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – acara: {{n me}} [{{kode}}] a {{# ccess entity=”acara”}} O a RM a M * p: {{oper tion}} / ole: {{peran}} / odifier: {{ ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Bukak aplikasi ZAP for Matter utawa Zigbee
Bukak aplikasi ZAP for Matter utawa Zigbee
Bukak ZAP kanggo Matter utawa Aplikasi Zigbee
Bagean ing ngisor iki nggambarake peluncuran ZAP ing mode mandiri kanthi metadata khusus Matter utawa Zigbee. Ide iki kanggo miwiti ZAP kanthi argumen sing bener sing ana gandhengane karo metadata XML (kluster lan definisi jinis piranti miturut spesifikasi CSA) lan template generasi, sing digunakake kanggo ngasilake kode sing cocog.
Bukak ZAP karo Matter
Skrip ing ngisor iki njupuk metadata sing bener saka Matter SDK nalika mbukak ZAP. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Cathetan: Sampeyan uga bisa njupuk pendekatan Zigbee ing ngisor iki kanggo miwiti ZAP ing Matter.
Bukak ZAP karo Zigbee
Printah ing ngisor iki mbukak ZAP kanthi spesifikasi ZCL lan template generasi saka SDK.
[zap-path] -z [sdk-path]/gsdk/app/zcl/zcl-zap.json -g [sdk-path]/gsdk/protocol/zigbee/app/framework/gen-template/gen-templates.json
zap-path: Iki minangka path menyang sumber ZAP utawa eksekusi sdk-path: Iki minangka path menyang SDK
Mbukak ZAP tanpa Metadata
Elinga yen nalika mbukak ZAP langsung liwat eksekusi utawa saka sumber nggunakake npm run zap sampeyan mbukak ZAP karo metadata test kanggo Matter / Zigbee dibangun ing ZAP lan dudu metadata nyata saka Matter lan Zigbee SDKs kasebut ing ndhuwur. Mula, elinga nggawe konfigurasi ZAP kanthi nggunakake metadata SDK lan ora mbukak ZAP langsung nganggo metadata tes sing dibangun.

31/35

Ngasilake kode kanggo Matter utawa Zigbee

Ngasilake Kode kanggo Matter, Zigbee utawa Custom SDK
Bagean ing ngisor iki nerangake carane nggawe kode nggunakake ZAP.
Gawe Kode Nggunakake ZAP UI
Bukak ZAP UI miturut pandhuan ing Launching ZAP for Matter utawa Zigbee lan klik tombol Generate ing garis menu ndhuwur.
Gawe Kode tanpa UI
Pandhuan ing ngisor iki nyedhiyakake macem-macem cara ngasilake kode liwat CLI tanpa mbukak UI ZAP.
Ngasilake Kode saka Sumber ZAP
Jalanake perintah ing ngisor iki kanggo ngasilake kode nggunakake ZAP saka sumber: 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
Ngasilake Kode saka ZAP Executable
Jalanake perintah ing ngisor iki kanggo ngasilake kode nggunakake ZAP sing bisa dieksekusi: [zap-path] generate –genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp
Ngasilake Kode saka ZAP CLI Executable
Jalanake perintah ing ngisor iki kanggo ngasilake kode nggunakake ZAP CLI Executable: [zap-cli-path] generate –genResultFile –stateDirectory ~/.zap/gen -z ./zcl-builtin/silabs/zcl.json -g ./test/gen-template/zigbee/gen-
templates.json -i ./test/resource/three-endpoint-device.zap -o ./tmp

32/35

Nganyari ZAP ing Studio

Nganyari ZAP
Nganyari ZAP ing Simplicity Studio
Mekanisme iki bisa digunakake nalika nggarap ekstensi Matter utawa Zigbee saka rilis Silicon Labs SDK. ZAP bisa dianyari ing Simplicity Studio tanpa release Simplicity Studio kanthi ngundhuh eksekusi ZAP paling anyar (dianjurake) utawa narik paling anyar saka sumber ZAP kaya sing ditampilake ing Pandhuan Instalasi ZAP. Sawise sampeyan duwe ZAP paling anyar adhedhasar OS sing saiki digunakake, sampeyan bisa nganyari ZAP ing Studio minangka paket adaptor. Tindakake pandhuan ing ngisor iki sawise ndownload ZAP paling anyar:
Pindhah menyang Simplicity Studio banjur pilih Preferensi > Simplicity Studio > Adapter Packs. Klik Tambah… lan telusuri menyang folder ZAP sing ditambahi sing diundhuh banjur klik Pilih Folder . Klik Aplikasi lan Tutup banjur ZAP sing mentas ditambahake bakal digunakake kapan wae .zap file dibukak.
Cathetan: Kadhangkala bisa uga ana conto ZAP lawas sing wis mlaku sanajan wis nganyari menyang ZAP paling anyar. Priksa manawa kanggo mungkasi kabeh kedadeyan ZAP sing wis ana supaya ZAP sing mentas dijupuk digunakake tinimbang conto lawas, sing isih bisa digunakake ing latar mburi.
Nganyari ZAP kanggo Matter Development ing Github
Nalika nggarap repo Matter utawa Matter-Silicon Labs ing Github, atur variabel lingkungan babagan ZAP kanggo nggawe / ngasilake konfigurasi ZAP anyar utawa ngasilake maneh s sing wis ana.ample konfigurasi ZAP sawise nglamar owah-owahan kanggo wong-wong mau. Setel ZAP_DEVELOPMENT_PATH menyang ZAP saka sumber kanthi narik paling anyar utawa setel ZAP_INSTALLATION_PATH dadi ZAP eksekusi sing diundhuh pungkasan ing direktori lokal. Elinga yen ZAP_DEVELOPMENT_PATH lan ZAP_INSTALLATION_PATH disetel, ZAP_DEVELOPMENT_PATH digunakake.
Ing ngisor iki sing examples sing nuduhake variabel lingkungan ing ndhuwur digunakake:
Bukak ZAP nggunakake spesifikasi Matter Regenerating kabeh sample konfigurasi ZAP kanggo aplikasi Matter
Cathetan: Nalika nggunakake eksekusi ZAP, priksa manawa sampeyan nggunakake rilis resmi sajrone rilis saben wengi supaya luwih stabil. Delengen
Ngundhuh ZAP Executable ing Pandhuan Instalasi ZAP

33/35

Multi-protokol bebarengan antarane Zigbee lan Matter
Multi-protokol bebarengan antarane Zigbee lan Matter
MCoanttceurrrent Multi-protokol antarane Zigbee lan
ZAP bisa digunakake kanggo ngatur konfigurasi ZCL (Zigbee) lan Data-Model (Matter) ing aplikasi multi-protokol kanggo Zigbee lan Matter. ZAP ngidini sampeyan nggawe titik pungkasan kanggo Zigbee lan Matter kanthi jelas ing konfigurasi sing padha file. Yen titik pungkasan Zigbee lan Matter ana ing Identifier titik pungkasan sing padha (kanggo example, LO Dimmable Light ing endpoint Id 1 lan Matter Dimmable Light ing conto liyane saka endpoint 1), ZAP ngurusi sinkronisasi atribut umum ing atribut Matter lan Zigbee. Priksa manawa atribut sing diselarasake duwe jinis data sing padha. Atribut umum antarane Zigbee lan Matter ditetepake liwat a file disebut multi-protocol.json . Pangguna bisa ngubungake loro kluster ing Zigbee lan Matter bebarengan karo atribut sing cocog nggunakake kode kluster lan atribut. Iki file bisa ditemokaké ing [SDKPath]/app/zcl/multi-protocol.json. Iki file wis dianyari karo pesawat tartamtu saka klompok lan atribut kanggo miwiti, nanging pangguna bisa nganyari iki file kaya sing dibutuhake lan ZAP bakal ngurus sinkronisasi konfigurasi atribut ing Zigbee lan Matter kanggo pengenal endpoint umum.
Sampeyan uga bisa nemokake tutorial ZAP ing aplikasi multi-protokol Zigbee lan Matter ing kaca tutorial. Tutorial iki bakal nuntun sampeyan liwat proses nggawe aplikasi multi-protokol. Tutorial iki mung kasedhiya nalika sampeyan mbukak aplikasi multi-protokol sing wis ana lan bisa ditemokake kaya sing ditampilake ing gambar ing ngisor iki:

34/35

Integrasi SLC CLI karo ZAP
Integrasi SLC CLI karo ZAP
Integrasi SLC CLI karo ZAP
Tindakake langkah iki kanggo nggabungake SLC CLI karo ZAP: ò Instal SLC CLI kanthi nuruti instruksi instalasi ing Simplicity Studio 5 User Guide. ó Instal ZAP kanthi nuruti instruksi ing Pandhuan Instalasi ZAP. ô Kanggo nggabungake SLC CLI karo ZAP, tambahake variabel lingkungan STUDIO_ADAPTER_PACK_PATH sing nuduhake aplikasi ZAP
direktori. õ Elinga miwiti maneh SLC CLI Daemon sawise langkah 3. ö Proyek apa wae sing nggunakake ZAP saiki bakal nggunakake jalur sing ditetepake ing langkah 3 nalika digawe saka SLC CLI. Mangga deleng SLC CLI
Panggunaan kanggo instruksi babagan nggunakake SLC CLI kanggo proyek sampeyan.

35/35

Dokumen / Sumber Daya

SILICON LABS ZAP Ngembangake Kanthi Silicon Labs [pdf] Manual Pamilik
ZAP Ngembangake Kanthi Silicon Labs, ZAP, Ngembangake Kanthi Silicon Labs, Silicon Labs, Labs

Referensi

Manual pangguna

ZAP Ngembangake Kanthi Silicon Labs

Spesifikasi

Pandhuan Panggunaan Produk

Pitakonan

Ngembangake karo Silicon Labs ZAP

ZAP Miwiti

Instalasi ZAP

Dasar ZAP

XML khusus

XML khusus Tags kanggo Zigbee

Multiple Jinis Piranti Saben Endpoint

Kontrol Akses

Ngasilake kode kanggo Matter utawa Zigbee

Nganyari ZAP ing Studio

Dokumen / Sumber Daya

Referensi

Ninggalake komentar

Batal balesan