Таҳияи ZAP бо дастури соҳиби Silicon Labs

Оғози ZAP
- Барои оғози кор бо ZAP, ин қадамҳоро иҷро кунед:
  - Барномаи иҷрошавандаи ZAP аз анбори расмӣ зеркашӣ кунед.
  - Бо истифода аз фармони npm install вобастагиҳоро насб кунед.
  - Барои насби мушаххаси Windows, ба дастури насби ZAP барои Windows OS муроҷиат кунед.
Рушди Zigbee
- Агар шумо барномаҳои Zigbee таҳия карда бошед:
  - Simplicity Studio, ки дорои ZAP ва дигар асбобҳои заруриро дар бар мегирад, истифода баред.

Инкишофи материя
- Агар шумо барномаҳои Matter таҳия карда бошед:
  - Имконот истифодаи Simplicity Studio ё дастрасӣ ба анбори Silicon Labs ё CSA Github-ро дар бар мегиранд.
  - Агар лозим бошад, ба дастурҳои навсозии ZAP берун аз давраи нашри Simplicity Studio муроҷиат кунед.

Саволҳо

Савол: Версияҳои гуногуни бинарҳои ZAP кадомҳоянд?
- A: Ду версияи дастрас мавҷуд аст - Нашри расмӣ бо сохторҳои тасдиқшуда ва пеш аз нашр бо хусусиятҳои навтарин.

Савол: Чӣ бояд кард, агар ман ҳангоми насбкунӣ бо мушкилоти тартиб додани китобхонаи ватанӣ дучор шавам?
- A: Барои ҳалли чунин мушкилот ба маълумоти FAQ дар бораи скриптҳои платформаи мушаххас муроҷиат кунед.

«`

View Fullscreen

Silicon Labs ZAP
Silicon Labs ZAP

Таҳия бо Silicon Labs ZAP

Сар кардани кор
ZAP аз нав оғоз меёбадview Насби ZAP Насбкунии ZAP Windows FAQ
Асосҳои ZAP Асосҳои
Дастури корбар Дастури истифодабарандаи ZAPview Хусусияти XML XML фармоишӣ Tags барои Zigbee Намудҳои сершумори дастгоҳҳо дар як нуқтаи ниҳоӣ Намуди дастгоҳ Хусусият Саҳифа Огоҳиҳо Модели маълумот/ Мушаххасоти ZCL Мутобиқати назорати дастрасӣ Оғоз кардани ZAP барои замимаҳои Matter ё Zigbee Ташкили код барои Matter ё Zigbee Навсозии ZAP дар Studio Протоколи бисёрҷонибаи ҳамзамон байни Zigbee ва Matter Интегратсияи SLC CLI бо Z

1/35

Таҳия бо Silicon Labs ZAP
Таҳия бо Silicon Labs ZAP
ЗАП
ZAP як муҳаррики тавлиди коди умумӣ ва интерфейси корбар барои барномаҳо ва китобхонаҳо дар асоси Китобхонаи кластери Zigbee аз Zigbee ё модели маълумот аз Matter мебошад. Мушаххасот аз ҷониби Alliance Standards Connectivity таҳия шудааст. ZAP ба шумо имкон медиҳад, ки амалҳои зеринро иҷро кунед:
Дар асоси мушаххасоти ZCL/Data-Model тавлиди фармоишии SDK-и ҳама артефактҳои глобалиро (константҳо, намудҳо, ID-ҳо ва ғайра) иҷро кунед. Насли фармоишии SDK-и ҳама артефактҳои конфигуратсияи аз ҷониби корбар интихобшуда (конфигуратсияи барнома, конфигуратсияи нуқтаи ниҳоӣ ва ғайра) дар асоси мушаххасоти ZCL/Data-Model ва конфигуратсияи барномаи аз ҷониби муштарӣ пешниҳодшударо иҷро кунед. Барои корбари ниҳоӣ барои интихоби конфигуратсияи мушаххаси барнома (нуқтаҳои ниҳоӣ, кластерҳо, атрибутҳо, фармонҳо ва ғайра) UI таъмин кунед.

Мундариҷаи ин бахшҳо тавсиф мекунад, ки чӣ гуна таҳияи замимаҳои Zigbee ва Matter тавассути конфигуратсияи қабатҳои ZCL (Zigbee) ё Модели маълумот (Материя) бо истифода аз ZAP.

2/35

Оғози ZAP

Оғози ZAP
Оғози кор бо ZAP
Ин бахшҳо усулҳои гуногуни эҷоди замимаҳои Zigbee ва Matter-ро тавсиф мекунанд. Аҳамият диҳед, ки Simplicity Studio роҳи эҷоди замимаҳои Zigbee ва Matter-и шуморо аз охир то ба охир пешкаш мекунад, ки дар он ҳама асбобҳо дар якҷоягӣ бо Simplicity Studio (аз ҷумла ZAP) пешакӣ насб карда шудаанд. Шумо инчунин метавонед тасмим гиред, ки роҳҳои дигари эҷоди замимаҳои худро, ки дар ин ҷо тавсиф шудааст, омӯзед.
Рушди Zigbee
Таҳиягарони замимаҳои Zigbee метавонанд замимаҳои худро бо истифода аз Simplicity Studio созанд, ки аллакай дорои ZAP ва дигар абзорҳоест, ки ба шумо аз охири то ба охир сохтани замимаи шумо кӯмак мерасонанд.
Инкишофи материя
Таҳиягарони замимаи Matter метавонанд бо истифода аз усулҳои зерин замимаҳои худро созанд: Simplicity Studio: Ба он ZAP ва дигар абзорҳо дохил мешаванд, ки барои сохтани барномаи Matter лозиманд. Github (Labs Silicon) Github (CSA)
Эзоҳ: Барои навсозии ZAP берун аз давраи нашри Simplicity Studio, ба навсозии ZAP дар Simplicity Studio ва дастури насби ZAP нигаред.

3/35

Насби ZAP

Фаслҳои зерин насби ZAP ва тарзи навсозии ZAP дар Simplicity Studio IDE-ро тавсиф мекунанд.
Зеркашии файли иҷрошавандаи ZAP тавсия дода мешавад)
Ин роҳи тавсияшудаи оғози кор бо ZAP аст. Шумо метавонед навтарин бинарҳои ZAP аз аа https://github.com/project-chip/zp/releses. Бинарҳои пешакӣ сохташуда дар ду версияи гуногун меоянд.
Нашри расмӣ: Сохтаҳои тасдиқшуда бо сюитаҳои санҷишии Matter ва Zigbee. Формати номи нашр vYYYY.DD.MM аст. Пеш аз нашр: Бо навтарин хусусиятҳо ва ислоҳи хатогиҳо сохта мешаванд, аммо ин сохтмонҳо бо сюитҳои санҷишии Matter ва Zigbee тасдиқ карда намешаванд. Формати номи нашр vYYYY.DD.MM-шабона аст.
Насб кардани ZAP аз манбаъ
Дастурҳои асосӣ барои насб кардани ZAP
Азбаски ин барномаи node.js аст, ба шумо муҳити гиреҳ насбшуда лозим аст. Беҳтарин роҳи ин зеркашӣ кардани насби охирини гиреҳ аст, ки гиреҳ ва npm-ро дар бар мегирад. Агар шумо версияи кӯҳнаи гиреҳро дар истгоҳи кории худ насб карда бошед, он метавонад боиси мушкилот гардад, алахусус агар он хеле кӯҳна бошад. Боварӣ ҳосил кунед, ки шумо версияи охирини гиреҳи v16.x-ро бо npm, ки дохил карда шудааст, доред. node -version -ро иҷро кунед, то тафтиш кунед, ки кадом версия гирифта шудааст. v18.x тавсия дода мешавад. Пас аз он ки шумо версияи дилхоҳи гиреҳро доред, шумо метавонед амалҳои зеринро иҷро кунед:
Вобастагиҳоро насб кунед
Барои насб кардани вобастагӣ фармонҳои зеринро истифода баред:

npm насб кунед
Эзоҳ: Барои насби ZAP-и мушаххаси Windows, нигаред ба Насби ZAP барои Windows OS Дар ин лаҳза дучор шудан ба мушкилоти таҳрири китобхонаи ватанӣ маъмул нест. Барои платформаҳои гуногун скриптҳои гуногуни src-script/install-* мавҷуданд. Маълумоти FAQ-ро дар бораи он, ки кадом скриптро дар платформаҳои гуногун иҷро кардан лозим аст, бубинед ва сипас npm install -ро дубора иҷро кунед.
Барномаро оғоз кунед
Барои оғоз кардани барнома фармонҳои зеринро истифода баред:

npm run zap
Front-End-ро дар реҷаи рушд оғоз кунед
Бозсозии коди гарм, гузоришдиҳии хатогиҳо ва ғайраҳоро дастгирӣ мекунад. Фармонҳои зеринро барои оғози кор дар таҳия истифода баред
режим:
квазар дев -м электрон
or

4/35

ZAP Insta дар ҳама ҷо
npm рун электрон-дев

5/35

Насби ZAP Windows
Насби ZAP Windows
Насби ZAP барои OS Windows
1. Windows Powershell
Дар сатри ҷустуҷӯи мизи корӣ, Windows Powershell-ро ворид кунед ва ҳамчун администратор иҷро кунед. Ҳамаи фармонҳои зеринро дар дохили Powershell иҷро кунед.
2. Шоколад
Аз. насб кунед https://chocolatey.org/install. Санҷед, ки оё бо фармонҳои зерин дуруст насб шудааст:
чоко -в
Бастаи pkgconfiglite -ро бо фармонҳои зерин насб кунед:
choco насб кардани pkgconfiglite
3. Node-ро насб кунед
Барои насб кардан фармонҳои зеринро иҷро кунед:
choco насб кардани nodejs-lts
*Барои гузаштани санҷиши санҷиши версия, версия бояд 18 бошад, пас аз насб, бо node -v санҷед *Агар шумо аллакай Node насб карда бошед ва дар баъзе санҷишҳои шабеҳе, ки Node пайдо карда нашавад, ноком шавад, Node-ро бо шоколад дубора насб кунед.
4. Дастурҳои асосиро барои насб кардани ZAP иҷро кунед
Дастурҳои насби ZAP-ро аз манбаъ дар насби ZAP иҷро кунед. Ҳангоми риояи дастурҳои асосӣ оид ба насби ZAP аз хатогиҳои зерин ва роҳҳои ҳалли онҳо эҳтиёт шавед:
sqlite3
Ҳангоми иҷро кардани ZAP (масалан, npm run zap ), агар шумо дар равзанаи поп-ап хато дар бораи sqlite3.node бинед, иҷро кунед:
npm аз нав сохтани sqlite3
электрон-созанда
Ҳангоми анҷом додани насби npm, дар пас аз насб, агар дар фармони зерин хатогӣ ба вуҷуд ояд, ки ба electron-builder install-appdeps , npx electronics-rebuild canvas ноком шуд ё node-pre-gyp , версияи canvas бо Windows мувофиқ нест ва хатои насбкунӣ боиси нокомии иҷрои ZAP нахоҳад шуд. node-canvas дар ҳоли ҳозир кор карда истодааст ва масъала дар ояндаи наздик ҳал хоҳад шуд.
"postinstall": "electron-builder install-app-deps && husky install && npm rebuild canvas -update-binary && npm run version-stamp”

6/35

Насби ZAP Windows
Канвас
Агар санҷиши иҷроиши npm аз сабаби хатогӣ ноком шавад, Suite Test иҷро карда натавонист. Модули '../build/Release/canvas.node' ё ёфт нашуд
zapnode_modulescanvasbuildReleasecanvas.node барномаи дурусти Win32 нест. , канвасро ба таври зерин барқарор кунед:
npm rebuild canvas -update-binary
index.html ё дигар масъалаҳои серверро гиред
Агар санҷиши иҷроиши npm аз сабаби хато ноком шавад, дархости index.html бо коди ҳолати 404 дар санҷишҳои воҳид ё доштани сервер ноком шуд
мушкилоти пайвастшавӣ дар санҷишҳои e2e-ci, фармонҳои зеринро иҷро кунед:
npm иҷро кунед
Дигар
Санҷед, ки оё версияи гиреҳ v18 аст ва кӯшиш кунед, ки онро бо Chocolatey насб кунед.

7/35

Саволҳои зиёд такрормешуда
Саволҳои зиёд такрормешуда
Саволҳои зуд-зуд додашаванда
Савол: Чӣ тавр UI-ро дар реҷаи рушд оғоз кардан мумкин аст? Ҷавоб: Шумо метавонед UI-ро дар реҷаи таҳия оғоз кунед, ки дар натиҷа танзимоти зерин мешавад:
Сервери ҷудогонаи таҳияи квазари HTTP, ки дар бандари 8080 ZAP дубора навсозӣ мекунад, ки дар порти 9070 Chrome ё браузери дигар кор мекунад, мустақилона кор мекунад Барои ворид шудан ба ин танзимот, дастурҳои зерро иҷро кунед. ò Аввалан, сервери таҳияи ZAP-ро, ки дар порти 9070 оғоз мешавад, иҷро кунед.
npm run zap-devserver ó Баъдан, сервери таҳияи квазарро, ки дар порти 8080 оғоз мешавад, иҷро кунед.
quasar dev ô Браузери худро нишон диҳед ё якеро бар зидди мувофиқ иҷро кунед URL бо далели restPort:
google-chrome http://localhost:8080/?restPort=9070

Савол: Ин корро дар Mac/Linux OS чӣ гуна кардан мумкин аст? A:
npm install барои зеркашии ҳама бастаҳои вобастагии зарурӣ истифода мешавад. Агар шумо хатогиҳои марбут ба node-gyp ва китобхонаҳои маҳаллӣ, ба монанди pixman ва ғайраро бинед, шумо вобастагиҳои модариро барои қонеъ кардани тартиб додани дунарҳои гиреҳи қаблан сохтанашуда барои баъзе омезиши платформаҳо ва версияҳо намебинед. Npm дар абр пайваста рӯйхати бинарҳои додашударо нав мекунад, аз ин рӯ мумкин аст, ки шумо онҳоро хуб интихоб кунед, аммо агар ин тавр накунед, ин дастурҳо барои платформаҳои гуногун мебошанд:
Fedora Core бо dnf:
dnf насб кардани pixman-devel Cairo-devel pango-devel libjpeg-devel giflib-devel
ё скриптро иҷро кунед:
src-script/install-packages-fedora
Ubuntu бо apt-get:
apt-get update apt-get install –fix-missing libpixman-1-dev libcairo-dev libsdl-pango-dev libjpeg-dev libgif-dev
ё скриптро иҷро кунед:

8/35

Саволҳои зиёд такрормешуда
src-script/install-packages-ubuntu
OSX дар Mac бо Homebrew brew:
brew install pkg-config Cairo pango libpng jpeg giflib librsvg
ё скриптро иҷро кунед:
src-script/install-packages-osx
Савол: Ин корро дар ОС Windows чӣ гуна кардан мумкин аст?
Ҷавоб: Боварӣ ҳосил кунед, ки он ҳамеша нав аст ва ҳеҷ гуна тағйироте, ки содир нашудаанд, вуҷуд надорад. Маслиҳат: git pull, git status & git stash дӯстони шумо ҳастанд. Шумо бояд Chocolately-ро истифода баред, то Zap дар Windows OS кор кунад. Боварӣ ҳосил кунед, ки бастаи pkgconfiglite -ро зеркашӣ кунед.
choco насб кардани pkgconfiglite
Агар шумо бо Қоҳира мушкилот дошта бошед, масаланample агар шумо дар бораи cairo.h хатое пайдо кунед: Чунин нест file ё директория, амалҳои зеринро иҷро кунед: ò Санҷед, ки компютери шумо 32 ё 64 бит аст. ó Вобаста ба ин, бастаи мувофиқро аз ин сайт зеркашӣ кунед
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:
Танзимоти пешрафтаи системаро клик кунед. Дар ҷадвали пешрафта, тағирёбандаҳои муҳити атрофро клик кунед. Дар бахши Тағйирёбандаҳои система тағирёбандаи муҳити PATH-ро пайдо кунед ва онро интихоб кунед. Таҳрирро клик кунед ва ба он C:/GTK илова кунед. Агар тағирёбандаи муҳити PATH мавҷуд набошад, Навро клик кунед. Агар jpeglib.h пайдо нашавад, амалҳои зеринро санҷед: ò Дар терминал, иҷро кунед: choco install libjpeg-turbo ó Боварӣ ҳосил кунед, ки он бо истифода аз он пок аст: git clean -dxff ва npm насбкуниро дубора иҷро кунед ô агар ягон хатогӣ рух надиҳад ва танҳо огоҳиҳо пайдо шаванд, кӯшиш кунед, ки npm audit fix õ -ро истифода баред, агар шумо ZAP-ро иҷро карда наметавонед, file src-script/zap-start.js ö Тағйир
÷ const { spawn } = require('cross-spawn') to const { spawn } = require('child_process') ø npm-ро иҷро кунед ва zap-ро иҷро кунед. Иқтибосҳо:
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)
Савол: Ман хатогие мегирам "sqlite3_node" ёфт нашуд ё шабеҳ.

9/35

Саволҳои зиёд такрормешуда
A: Пайвасткуниҳои аслии sqlite3-и худро аз нав созед. Барои ислоҳ кардани ин дар аксари ҳолатҳо, иҷро кунед:
npm насб кунед
./node_modules/.bin/electron-rebuild -w sqlite3 -p
Агар он то ҳол ислоҳ нашавад, амалҳои зеринро иҷро кунед:
rm -rf node_modules ва сипас фармонҳои дар боло зикршударо дубора санҷед. Баъзан такмил додани npm-и шумо низ фарқият меорад:
npm насб кунед -g npm
Савол: Ман хато мегирам "Нусхаи N-API-и ин мисоли Node 1 аст. Ин модул версияи N-API 3-ро дастгирӣ мекунад. Ин мисоли гиреҳ наметавонад ин модулро иҷро кунад."
A: Версияи гиреҳи худро навсозӣ кунед. Ҳалли ин дар ин риштаи Stack Overflow баррасӣ мешавад: https://stackoverflow.com/questions/60620327/the-n-apiversion-of-this-node-instance-is-1-this-module-supports-n-api-version
Савол: Компютери таҳияи ман бо ҳар сабаб бо ZAP кор намекунад. Оё ман метавонам контейнери докерро истифода барам?
A: Бале шумо метавонед. ТБД.
Савол: Чӣ тавр ман ZAP-ро дар дохили VSCode иҷро мекунам?
A: Агар шумо VSCode дар роҳи худ ворид кунед zap repo ва рамзи ворид кунед. Ин ZAP-ро дар VSCode мекушояд. Барои иҷро кардани ZAP дар реҷаи дебаг, фазои кории ZAP-ро интихоб кунед ва тасвири Иҷро карданро дар панели асбобҳои дасти чап клик кунед. Шумо якчанд имконот доред, ки барои иҷро кардани ZAP интихоб кунед, Node.js Debug Terminal -ро интихоб кунед. Ин равзанаи терминалро мекушояд, ки аз он шумо метавонед npm run zap -ро ворид кунед, ки ислоҳкунандаро замима мекунад ва ZAP-ро тавре, ки одатан аз сатри фармон иҷро мекунед, иҷро мекунад. Табрикот, шумо бояд ҳоло бубинед, ки ZAP дар ислоҳкунанда кор мекунад. Шумо метавонед нуқтаҳои танаффусро дар VSCode тавре муқаррар кунед, ки дар ҳама гуна IDE-и дигар.
Савол: Санҷиши воҳиди UI бо баъзе хатогиҳо дар атрофи канвас, ки барои версияи дурусти гиреҳ сохта нашудааст, ноком мешавад. Ман чӣ кор кунам?
A: Агар шумо хатои зеринро бинед:
FAIL test/ui.test.js Маҷмӯаи санҷишӣ иҷро нашуд Модули 'canvas.node' бар зидди версияи дигари Node.js бо истифода аз NODE_MODULE_VERSION 80 тартиб дода шуд. Ин версияи Node.js NODE_MODULE_VERSION 72-ро талаб мекунад. Лутфан кӯшиш кунед, ки модулро аз нав тартиб диҳед ё бо истифода аз нав насб кунед `npm насб`).
дар Объект. (node_modules/canvas/lib/bindings.js:3 18)
пас иҷро кунед: npm rebuild canvas -update-binary

10/35

Асосҳои ZAP

Асосҳои ZCL/Data-Model ZAP
Ин бахш маълумотро барои корбарони нави ZAP дар бар мегирад. Тасвири дастурро дар кунҷи рости болоии ZAP UI клик кунед, ки чӣ тавр сохтани конфигуратсияи ZAP-ро нишон медиҳад. Дарсӣ ба шумо дар роҳи зерин роҳнамоӣ мекунад: Эҷоди нуқтаи ниҳоӣ Намуди дастгоҳро интихоб кунед Кластерро танзим кунед Аттрибутро танзим кунед Фармонро танзим кунед Барои маълумотномаи муфассал ба Дастури конфигуратори Cluster Zigbee нигаред.

11/35

Дастури истифодабарандаи ZAP
Дастури истифодабарандаи ZAP
Дастури истифодабарандаи ZAP
Фаслҳои зери ин дастур дар бораи хусусиятҳои гуногуни аз ҷониби ZAP пешниҳодшуда тафсилоти бештар медиҳанд.

12/35

XML фармоишӣ

Илова кардани XML фармоишӣ аз ZAP UI
Тасвири "Extensions" -ро дар ZAP UI клик кунед. Барои интихоби xml фармоишӣ тугмаи "+" -ро клик кунед file Пас аз илова кардани xml фармоишӣ кластерҳои фармоишӣ, атрибутҳо, фармонҳо ва ғайра бояд дар ZAP UI пайдо шаванд.
Эҷоди XML фармоишии шахсии худ дар Zigbee
Дар ин бахш нишон медиҳад, ки чӣ тавр сохтани кластерҳои фармоишии худ ва васеъ кардани кластерҳои стандартии мавҷуда бо атрибутҳо ва фармонҳои фармоишӣ барои Zigbee.
Кластерҳои мушаххаси истеҳсолкунанда дар Zigbee
Шумо метавонед кластерҳои мушаххаси истеҳсолкунандаро ба профессионали стандартӣ илова кунедfile. Мо як собиқро пешниҳод мекунемampаз ин дар поён. Барои ин, шумо бояд ду ӯҳдадориро иҷро кунед:
ID кластер БОЯД дар диапазони мушаххаси истеҳсолкунанда бошад, 0xfc00 - 0xffff. Таърифи кластер бояд рамзи истеҳсолкунандаро дар бар гирад, ки ба ҲАМАИ атрибутҳо ва фармонҳои дохили он кластер татбиқ карда мешавад ва ҳангоми фиристодан ва қабули фармонҳо ва ҳамкорӣ бо атрибутҳо таъмин карда мешавад. Мисолampле:

Сample Mfg кластери мушаххас Генерал Ин кластер собиқро таъмин мекунадample дар бораи он, ки чӣ тавр чаҳорчӯбаи барномаро метавон васеъ кард, то кластерҳои мушаххаси истеҳсолкунандаро дар бар гирад.
0xFC00
амбер сampатрибут
амбер сampсифат 2

А сample фармони мушаххаси истеҳсолкунанда дар доираи сampба истеҳсолкунанда хос аст
кластер.

Фармонҳои мушаххаси истеҳсолкунанда дар кластери стандартии Zigbee
Шумо метавонед фармонҳои шахсии худро ба ҳама гуна кластери стандартии Zigbee бо талаботи зерин илова кунед:
Фармонҳои мушаххаси истеҳсолкунандаи шумо метавонанд ягон ID фармонро дар доираи id фармон, 0x00 - 0xff истифода баранд. Шумо инчунин бояд рамзи истеҳсолкунандаро барои фармон пешниҳод кунед, то он аз дигар фармонҳои кластер фарқ кунад ва ба таври мувофиқ идора карда шавад. Мисолampвасеъ кардани кластери фурӯзон/хомӯш бо фармонҳои истеҳсолӣ:

13/35

XML фармоишӣ
<command source=”client” code=”0 0006″ name=”SampleMfgSpecificOffWithTransition” ихтиёрӣ=”ҳақиқӣ” истеҳсолкунандаКоде=”0 1002″> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, хомӯш мекунадampатрибути вақти гузариш.ampleMfgSpecificOnWithTransition” ихтиёрӣ=”ҳақиқӣ” истеҳсолкунандаКоде=”0 1002″> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, фаъол мекунадampатрибути вақти гузариш.ampleMfgSpecificToggleWithTransition" ихтиёрӣ = "ҳақиқӣ" productionCode ="0 1002"> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, иваз мекунадampатрибути вақти гузариш.ampleMfgSpecificOnWithTransition2″ ихтиёрӣ="true" manufacturerCode=”0 1049″> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, фаъол мекунадampатрибути вақти гузариш.ampleMfgSpecificToggleWithTransition2″ ихтиёрӣ = "ҳақиқӣ"
Коди истеҳсолкунанда =”0 1049″> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, иваз мекунадampатрибути вақти гузариш.

Хусусиятҳои мушаххаси истеҳсолкунанда дар кластери стандартии Zigbee
Шумо метавонед атрибутҳои худро ба ҳама гуна кластери стандартии Zigbee бо талаботи зерин илова кунед:
Аттрибутҳои мушаххаси истеҳсолкунандаи шумо метавонанд ҳама гуна id аттрибутиро дар доираи ID аттрибутӣ, 0x0000 – 0xffff истифода баранд. Шумо инчунин бояд рамзи истеҳсолкунандаро барои атрибут пешниҳод кунед, то он аз дигар атрибутҳои кластер фарқ кунад ва ба таври мувофиқ коркард карда шавад. Мисолampвасеъ кардани кластери фурӯзон/хомӯш бо атрибутҳои истеҳсолӣ:
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″
max=”0xFFFF” навишташаванда=”ҳақиқӣ” пешфарз=”0 0000″ ихтиёрӣ=“ҳақиқӣ” истеҳсолкунандаКоде=”0 1002″>Sample Mfg Хусусияти мушаххас: 0 0000 0 1002
<attribute side=”server” code=”0 0000″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ ихтиёрӣ=”true” manufacturerCode=”0 1049″>Sample Mfg Хусусияти мушаххас: 0 0000 0 1049
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 00″ ихтиёрӣ=”true” manufacturerCode=”0 1002″>Sample Mfg Хусусияти мушаххас: 0 0001 0 1002
<attribute side=”server” code=”0 0001″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ ихтиёрӣ=”true” manufacturerCode=”0 1049″>Sample Mfg Хусусияти мушаххас: 0 0001 0 1040
Эҷоди XML фармоишии худ дар Matter
Ин бахш нишон медиҳад, ки чӣ тавр сохтани кластерҳои фармоишии худ ва васеъ кардани кластерҳои стандартии мавҷуда бо атрибутҳо ва фармонҳои фармоишӣ барои Matter.
Кластерҳои мушаххаси истеҳсолкунанда дар материя
Шумо метавонед кластерҳои мушаххаси истеҳсолкунандаро ба Matter илова кунед. Мо як собиқро пешниҳод мекунемampаз ин дар поён.
Ин 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 фармоишӣ
Дар мисоли зеринample, омезиши ID фурӯшанда (Идентификатсияи истеҳсолкунандаи санҷиш) 0xFFF1 ва ID кластери 0xFC20 боиси value of 0xFFF1FC20. The commands and attributes within this cluster will adopt the same Manufacturer ID. Exampле:
Генерал Сample MEI 0xFFF1FC20 СAMPLE_MEI_CLUSTER Сample MEI кластери васеъшавии истеҳсолкунандаи кластерро намоиш медиҳад Шиппак
Ҷавоб барои AddArguments, ки маблағро бармегардонад. Фармоне, ки ду далели uint8 мегирад ва маблағи онҳоро бармегардонад. Фармони оддӣ бе ягон параметр ва бе ҷавоб.
Хусусиятҳои хоси истеҳсолкунанда дар кластерҳои стандартии материя
Шумо метавонед атрибутҳои мушаххаси истеҳсолкунандаро ба ҳама гуна кластери стандартии Matter бо талаботи зерин илова кунед:
Барои кластер, ки хусусиятҳое, ки ба онҳо илова карда мешаванд, бояд муайян карда шаванд -
e xte nd ed > “>
Рамзи атрибут маҷмӯи 32-битии рамзи истеҳсолкунанда ва id барои атрибут мебошад. Муҳимтарин 16 бит рамзи истеҳсолкунанда мебошанд. Диапазон барои кодҳои истеҳсолкунандаи санҷиш 0xFFF1 - 0xFFF4 аст. Камтарин 16 бит идентификатсияи атрибутӣ мебошанд. Диапазони атрибутҳои ғайриглобалӣ 0x0000 - 0x4FFF аст.
Example аз васеъ кардани кластери фурӯзон/хомӯш бо хусусиятҳои истеҳсолӣ:
<attribute side=”server” code=”0xFFF0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″
max=”0xFFFF” навишташаванда=”ҳақиқӣ” пешфарз=”0 0000″ ихтиёрӣ=”true”>Sample Mfg Хусусияти мушаххаси 2AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″
max=”0xFFFF” навишташаванда=”ҳақиқӣ” пешфарз=”0 0000″ ихтиёрӣ=”true”>Sample Mfg Хусусияти мушаххаси 4
Фармонҳои мушаххаси истеҳсолкунанда дар кластерҳои стандартӣ
Шумо метавонед фармонҳои мушаххаси истеҳсолкунандаро ба ҳама кластери стандартии Matter бо талаботи зерин илова кунед:
Барои кластере, ки фармонҳое, ки ба онҳо дода мешаванд, бояд муайян карда шаванд -
e xte nd ed > “>
Рамзи фармон маҷмӯи 32-битии рамзи истеҳсолкунанда ва id барои фармон мебошад. Муҳимтарин 16 бит рамзи истеҳсолкунанда мебошанд. Диапазон барои кодҳои истеҳсолкунандаи санҷиш 0xFFF1 - 0xFFF4 аст. Камтарин 16 бит ID фармон мебошанд. Диапазони фармонҳои ғайриглобалӣ 0x0000 - 0x00FF аст.
Example аз васеъ кардани кластери Фаъол / Хомӯш бо кластерҳои мушаххаси истеҳсолот:

15/35

XML фармоишӣ

<command source=”client” code=”0xFFF10000″ name=”SampleMfgSpecificOnWithTransition2″ ихтиёрӣ ="true"> Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, фаъол мекунадampатрибути вақти гузариш.
<command source=”client” code=”0xFFF10001″ name=”SampleMfgSpecificToggleWithTransition2″ ихтиёрӣ ="true">
Фармони муштарӣ, ки дастгоҳро бо гузарише, ки бо вақти гузариш дар Ember S дода мешавад, иваз мекунадampатрибути вақти гузариш.

16/35

XML фармоишӣ Tags барои Zigbee

Ҳуҷҷати зерин дар бораи ҳар як xml сӯҳбат мекунад tags бо Zigbee алоқаманд аст.
Ҳар як xml file дар байни конфигуратор номбар шудааст tags:

Намудҳои маълумотро дар конфигуратор муайян кардан мумкин аст tag. Zigbee айни замон таърифи харитаҳо, рақамҳо, ададҳои бутун, сатрҳо ё сохторҳоро дастгирӣ мекунад. Пеш аз муайян кардани намудҳои бештар, боварӣ ҳосил кунед, ки ҳамаи навъҳои атомии дар type.xml муайяншударо тафтиш кунед ва ҳама намудҳои ғайриатомии дар xml дигар муайяншударо тафтиш кунед. fileс. Шумо метавонед онҳоро ба таври зерин муайян кунед:
Bitmap: ном: номи навъи харитаи бит. навъи: Харитаи Bitmap бо андозаи байни 8-64 бит метавонад муайян карда шавад, ки ҳамаи онҳо бояд чандкарата 8 бошад. Ҳар як bitmap метавонад дорои якчанд майдонҳои бо ном ва ниқоби бо он алоқаманд. масалан:

«`
Enum: ном: номи навъи enum. навъи: Enum бо андозаи байни 8-64 бит метавонад муайян карда шавад, ки ҳамаи онҳо бояд чандкарата 8 бошад. Ҳар як enum метавонад ҷузъҳои сершумор бо ном ва арзиши марбут ба он дошта бошад. масалан:

Шумораи бутун: Навъҳои бутун аллакай дар зери намудҳои атомӣ, ки дар type.xml мавҷуданд, муайян карда шудаанд. Андозаи онҳо метавонад аз 8-64 бит бошад ва мумкин аст имзо ё имзонашуда бошад. масалан:

Сатр: Навъҳои сатр аллакай дар зери намудҳои атомӣ, ки дар type.xml мавҷуданд, муайян карда шудаанд. Намудҳои сатри ҷории сатри октет, сатри чар, сатри октети дароз ва сатри дарози чарро дар бар мегиранд, масалан:

Сохтор: ном: номи навъи сохтор. Ҳар як сохтор метавонад дорои якчанд ҷузъ бо ном ва навъи бо он алоқаманд бошад. Навъ метавонад ҳама гуна намудҳои пешакӣ муайяншуда дар доираи намудҳои додаҳо бошад. масалан:

17/35

XML фармоишӣ Tags барои Zigbee

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

Кластерҳои фармоиширо дар дохили конфигуратор муайян кардан мумкин аст tag. ном: номи домени кластер: домени кластер. Кластер дар ZAP UI зери ин домен пайдо мешавад. тавсиф: Тавсифи рамзи кластер: рамзи кластер муайян кунед: кластер муайян кунед, ки онро генератори код барои муайян кардани кластер бо роҳи муайян истифода мебарад. Ин бояд дар байни 0xfc00 - 0xffff бошад. Рамзи истеҳсолкунандаи кластер бояд ба таври зерин муайян карда шавад:

Кластери истеҳсолӣ ба таври худкор атрибутҳо ва фармонҳои зери он як рамзи истеҳсолкунандаро месозад, агар онҳо рамзи истеҳсолкунандаро ба таври возеҳ номбар накунанд. presentedIn: Барои муайян кардани версияи мушаххасе, ки дар он кластер ҷорӣ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. removeIn: Барои муайян кардани версияи мушаххасе, ки дар он кластер хориҷ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. singleton(boolean): Барои муайян кардани кластер ҳамчун синглтон истифода мешавад, то ки танҳо як мисоли он кластер дар тамоми нуқтаҳо тақсим карда шавад. атрибут: атрибутро барои номи кластер муайян мекунад: Номи атрибут дар байни атрибут зикр шудааст tag.
номи атрибут
тараф (мизоҷ/сервер): паҳлӯи кластер, ки атрибут низ бо он алоқаманд аст. код: Рамзи истеҳсолкунандаи атрибут: Ин метавонад барои муайян кардани атрибути мушаххаси истеҳсолкунанда берун аз мушаххасоти зигбие, ки дар xml стандартӣ зикр шудааст, истифода шавад. муайян кардан: аттрибут муайян кардан, ки онро тавлидкунандаи код барои муайян кардани атрибут бо роҳи муайян истифода мебарад. Навъи аттрибутӣ, ки метавонад яке аз намудҳои додаҳои дар пешфарз xml зикршуда бошад: арзиши пешфарз барои атрибут. min: Қимати ҳадди ақали иҷозатдодашуда барои атрибут макс: Арзиши максималии иҷозатдодашудаи аттрибутӣ навишташаванда: Қимати аттрибутӣ навиштан мумкин аст ё не. Ин метавонад барои пешгирӣ кардани тағир додани атрибут тавассути фармонҳои навиштан истифода шавад. ихтиёрӣ (boolean): Барои муайян кардани он, ки атрибут барои кластер ихтиёрӣ аст ё не. min: Қимати ҳадди ақали иҷозатдодашуда барои атрибут, вақте ки он як адади бутун, рақамгузорӣ ё навъи bitmap аст. макс: Қимати максималии иҷозатдодашуда барои атрибут, вақте ки он як адади бутун, рақам ё дарозии навъи bitmap аст: Барои муайян кардани дарозии максималии атрибут ҳангоми сатри навъи он истифода мешавад. minLength: Барои муайян кардани дарозии ҳадди ақали атрибут ҳангоми сатри навъи он истифода мешавад. reportable(boolean): Мегӯяд, ки оё атрибут гузоришшаванда аст ё не. массив (логӣ): Барои эълон кардани атрибути навъи массив истифода мешавад. presentedIn: Барои муайян кардани версияи мушаххасе, ки дар он атрибут ҷорӣ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. RemoveIn: Барои муайян кардани версияи мушаххасе, ки дар он атрибут хориҷ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. фармон: фармонро барои номи кластер муайян кунед: Номи фармон.

код: рамзи фармон

18/35

XML фармоишӣ Tags барои Zigbee
рамзи истеҳсолкунанда: Ин метавонад барои муайян кардани фармони мушаххаси истеҳсолкунанда берун аз мушаххасоти зигбие, ки дар xml стандартӣ зикр шудааст, истифода шавад. тавсиф: тавсифи манбаи фармон (мизоҷ/сервер): манбаи фармон. ихтиёрӣ (boolean): Барои муайян кардани он, ки фармон барои кластер ихтиёрӣ аст ё не. presentedIn: Барои муайян кардани версияи мушаххасе, ки дар он фармон ҷорӣ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. removeIn: Барои муайян кардани версияи мушаххасе, ки дар он фармон хориҷ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. далелҳои фармон:
Ҳар як фармон метавонад маҷмӯи аргументҳои фармонро дошта бошад, ки ном дорад: номи навъи аргументи фармон: навъи аргументи фармон, ки метавонад яке аз намудҳои дар xml зикршуда бошад. min: Қимати ҳадди ақали иҷозатдодашудаи аргумент, вақте ки он як адади бутун, рақамгузорӣ ё навъи bitmap аст. макс: Қимати максималии иҷозатдодашуда барои аргумент, вақте ки он адади бутун, рақамгузорӣ ё дарозии навъи bitmap аст: Барои муайян кардани дарозии ҳадди иҷозатдода барои аргументи фармон, вақте ки он сатри навъи аст, истифода мешавад. minLength: Барои муайян кардани ҳадди ақали дарозии иҷозат барои далели фармон, вақте ки он аз навъи сатр аст, истифода мешавад. array(boolean): Барои муайян кардани он, ки далели фармон аз навъи массив аст. presentIf(string): Ин метавонад як сатри шартии амалҳои мантиқӣ дар асоси дигар далелҳои фармон бошад, ки дар он шумо метавонед далели фармонро интизор шавед, агар сатри шартӣ ҳақиқӣ арзёбӣ шавад. масалан:

Эзоҳ: Дар ин ҷо вазъият номи дигари далели фармон аст. ихтиёрӣ (boolean): Барои муайян кардани далели фармон ҳамчун ихтиёрӣ истифода мешавад. countArg: Истифода бурда мешавад, вақте ки аргументи фармон аз навъи массив бошад. Ин барои зикр кардани далели дигари фармон, ки андозаи массивро барои ин далел ифода мекунад, истифода мешавад.

presentedIn: Барои муайян кардани версияи мушаххасе, ки дар он далели фармон ҷорӣ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. removeIn: Барои муайян кардани версияи мушаххасе, ки дар он далели фармон хориҷ карда шудааст, истифода мешавад. Ин аз ҷониби генератори код барои илова кардани мантиқи иловагӣ истифода мешавад. Васеъкунии кластерро дар конфигуратор муайян кардан мумкин аст tag. Васеъкунии кластер барои васеъ кардани кластери стандартӣ бо атрибутҳо ва фармонҳои истеҳсолӣ истифода мешавад, масалан

19/35

XML фармоишӣ Tags барои Zigbee
<attribute side=”server” code=”0 0006″ define=”SAMPLE_MFG_SPECIFIC_TRANSITION_TIME” type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ ихтиёрӣ=”true” manufacturerCode=”0 1002″>Sample Mfg Хусусияти мушаххас: 0 0000 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_2″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ ихтиёрӣ=”true” manufacturerCode=”0 1049″>Sample Mfg Хусусияти мушаххас: 0 0000 0 1049AMPLE_MFG_SPECIFIC_TRANSITION_TIME_3″ type=”INT8U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 00″ ихтиёрӣ=”true” manufacturerCode=”0 1002″>Sample Mfg Хусусияти мушаххас: 0 0001 0 1002AMPLE_MFG_SPECIFIC_TRANSITION_TIME_4″ type=”INT16U” min=”0 0000″ max=”0xFFFF” writable=”true” default=”0 0000″ ихтиёрӣ=”true” manufacturerCode=”0 1049″>Sample Mfg Хусусияти мушаххас: 0 0001 0 1040ampleMfgSpecificOffWithTransition” ихтиёрӣ=”ҳақиқӣ” истеҳсолкунандаКоде=”0 1002″> Фармони муштарӣ, ки дастгоҳро бо гузариши додашуда хомӯш мекунад
бо вақти гузариш дар Ember Sampатрибути вақти гузариш.ampleMfgSpecificOnWithTransition” ихтиёрӣ=”ҳақиқӣ” истеҳсолкунандаКоде=”0 1002″> Фармони муштарӣ, ки дастгоҳро бо гузариши додашуда фаъол мекунад
бо вақти гузариш дар Ember Sampатрибути вақти гузариш.ampleMfgSpecificToggleWithTransition" ихтиёрӣ = "ҳақиқӣ" productionCode ="0 1002"> Фармони муштарӣ, ки дастгоҳро бо гузариши додашуда иваз мекунад
бо вақти гузариш дар Ember Sampатрибути вақти гузариш.ampleMfgSpecificOnWithTransition2″ ихтиёрӣ="true" manufacturerCode=”0 1049″> Фармони муштарӣ, ки дастгоҳро бо гузариши додашуда фаъол мекунад
бо вақти гузариш дар Ember Sampатрибути вақти гузариш.ampleMfgSpecificToggleWithTransition2″ ихтиёрӣ="true" manufacturerCode=”0 1049″> Фармони муштарӣ, ки дастгоҳро бо гузариши додашуда иваз мекунад
бо вақти гузариш дар Ember Sampатрибути вақти гузариш.

20/35

Якчанд намуди дастгоҳҳо дар як нуқтаи ниҳоӣ

Ин хусусият танҳо барои масъала аст, ки дар он корбар метавонад дар як нуқтаи ниҳоӣ зиёда аз як навъи дастгоҳро интихоб кунад. Илова кардани намудҳои гуногуни дастгоҳи aaa конфигуратсияҳои кластерро дар дохили намудҳои дастгоҳ ба конфигуратсияи нуқтаи ниҳоӣ илова мекунад.

21/35

Якчанд намуди дастгоҳҳо дар як нуқтаи ниҳоӣ

Тасвири боло нишон медиҳад, ки нуқтаи ниҳоии 1 зиёда аз як намуди дастгоҳ интихоб шудааст. "Дастгоҳи ибтидоӣ" навъи асосии дастгоҳро нишон медиҳад, ки нуқтаи ниҳоӣ бо он алоқаманд хоҳад буд. Навъи асосии дастгоҳ ҳамеша дар шохиси 0-и рӯйхати навъҳои дастгоҳи интихобшуда мавҷуд аст, аз ин рӯ интихоби навъи дигари дастгоҳи ибтидоӣ тартиби навъҳои дастгоҳи интихобшударо тағир медиҳад. Интихоби навъи дастгоҳ инчунин маҳдудиятҳо дар асоси Мушаххасоти модели маълумот доранд. ZAP корбаронро аз интихоби маҷмӯи нодурусти намудҳои дастгоҳ дар нуқтаи ниҳоӣ бо истифода аз ин маҳдудиятҳо муҳофизат мекунад.

22/35

Саҳифаи хусусияти навъи дастгоҳ
Саҳифаи хусусияти навъи дастгоҳ
Саҳифаи хусусияти навъи дастгоҳ
ZAP визуализатсия ва иваз кардани хусусиятҳои Matterро дар саҳифаи хусусияти навъи дастгоҳ дастгирӣ мекунад. Танҳо хусусиятҳои навъи дастгоҳ, ки дар matter-devices.xml дар анбори CHIP нишон дода шудаанд, намоиш дода мешаванд.

Гузариш ба Саҳифаи Хусусият
ò ZAP дар Matter бо SDK-и муосири Matter -ро оғоз кунед. ó Бо навъи дастгоҳи Matter нуқтаи ниҳоӣ созед. ô Тугмаи Хусусиятҳои навъи дастгоҳро дар миёнаи болои кластер клик кунед view. Дар хотир доред, ки ин тугма танҳо дар ZAP дастрас аст
конфигуратсияҳо барои Matter ва вақте ки маълумоти мувофиқат дар Matter SDK мавҷуд аст. Бо пахш кардани ин тугма тасвири боло кушода мешавад.
Мутобиқат
Мутобиқат ихтиёрӣ ва вобастаиро барои атрибутҳо, фармонҳо, рӯйдодҳо ва намудҳои додаҳо муайян мекунад. Он муайян мекунад, ки оё унсур дар конфигуратсияҳои муайяни ZAP ҳатмӣ, ихтиёрӣ ё дастгирӣ намешавад.
Мутобиқати хусусияти навъи дастгоҳ аз мутобиқати хусусияти кластер бартарӣ дорад. Барои мисолample, хусусияти равшанӣ дар кластери фурӯзон/хомӯш мувофиқати ихтиёрӣ дорад, аммо дар навъи дастгоҳи фурӯзон/хомӯш, ки кластери фурӯзон/хомӯшро дар бар мегирад, ҳатмӣ эълон шудааст. Эҷоди нуқтаи ниҳоӣ бо навъи дастгоҳи фурӯзон/хомӯшкунӣ хусусияти равшаниро ҳамчун ҳатмӣ дар саҳифаи хусусият нишон медиҳад.
Гузариши хусусият
Дар саҳифаи хусусият, пас аз пахш кардани тугмаи гузариш барои фаъол ё ғайрифаъол кардани хусусият, ZAP:
Унсурҳои алоқамандро (атрибутҳо, фармонҳо, рӯйдодҳо) навсозӣ кунед, то мувофиқатро ислоҳ кунед ва муколамаеро нишон диҳед, ки тағиротро нишон медиҳад.

23/35

Материя Саҳифаи Хусусияти Навъи дастгоҳ Битҳои хусусиятро дар атрибути featureMap кластери алоқаманд навсозӣ кунед

Муколамаи хусусиятҳоро фаъол созед

Муколамаи хусусиятҳоро ғайрифаъол кунед

Гузариш барои баъзе хусусиятҳо ғайрифаъол аст, вақте ки мутобиқати онҳо арзиши номаълум ё шакли t-и ҳозир дастгирӣ намешавад. Дар ин ҳолат, ZAP дар огоҳинома огоҳиҳоро нишон медиҳад.
Мутобиқати элементҳои Wa

Вақте ки шумо ягон элементро иваз мекунед, ZAP метавонад ҳам огоҳиҳои мутобиқати дастгоҳ ва ҳам огоҳиҳои мутобиқатро нишон диҳад. Агар ҳолати элемент ба мувофиқати пешбинишуда мувофиқат накунад, ZAP тасвири огоҳиро намоиш медиҳад ва огоҳиро дар огоҳинома сабт мекунад. Мисолample аз огоҳиҳои мувофиқат ва мувофиқат, ки барои элемент нишон дода шудаанд:

24/35

Огоҳиномаҳо
Огоҳиномаҳо
Огоҳиномаҳо
Қисми зерин муайян мекунад, ки чӣ гуна огоҳиҳо ба корбарони ZAP дар UI дода мешаванд.
Огоҳиномаҳои баста
Огоҳиҳои бастаҳо огоҳиҳо ё паёмҳои хатогӣ мебошанд, ки барои ҳама бастаи мушаххасе, ки ба ZAP бор карда шудаанд, алоқаманданд. Барои мисолample, дар тасвирҳои зер, пахш кардани тасвири огоҳӣ дар зери сутуни вазъият шуморо ба муколамае мебарад, ки ҳама огоҳиномаҳоро барои ин баста нишон медиҳад.

25/35

Огоҳиномаҳо
Огоҳиномаҳои сессия
Огоҳиҳои ҷаласа ин огоҳиҳо ё паёмҳои хатогӣ мебошанд, ки бо ҷаласаи корбар алоқаманданд. Ин огоҳиҳо/хатоҳоро тавассути пахш кардани тугмаи Огоҳиҳо дар панели асбобҳо дар болои UI ZAP дидан мумкин аст. Барои мисолample, тасвири зер саҳифаи огоҳиҳои ҷаласаро пас аз isc нишон медиҳад file ба ZAP бор карда шуд.

26/35

Мутобиқати мушаххасоти маълумот-модели/ZCL
Мутобиқати мушаххасоти маълумот-модели/ZCL
Мутобиқати модели маълумот ва мушаххасоти ZCL
Ин хусусият дар ZAP ба корбарон кӯмак мекунад, ки нокомии мутобиқатро барои модели додаҳо ё ZCL бо конфигуратсияҳои мавҷудаи ZAP-и худ бубинанд. Паёмҳои огоҳкунанда дар бораи нокомии мувофиқат дар панели Огоҳиҳо дар UI ZAP пайдо мешаванд ва инчунин ҳангоми иҷро кардани ZAP тавассути CLI ба консол ворид карда мешаванд. Хусусияти мувофиқат дар айни замон огоҳиҳоро барои мутобиқати навъи дастгоҳ ва мутобиқати кластер дар нуқтаи ниҳоӣ таъмин мекунад.
Огоҳӣ оид ба мувофиқат дар UI ZAP
Вақте ки корбар .zap -ро мекушояд file бо истифода аз UI ZAP онҳо дар панели огоҳиномаҳои ZAP UI огоҳиҳоро барои ҳама нокомии мутобиқат хоҳанд дид. Барои мисолample, тасвири зер саҳифаи огоҳиномаҳои ҷаласаро пас аз .zap нишон медиҳад file бо масъалахои риоя кардан кушода шуд.

Паёмҳои мувофиқат пас аз ҳалли мушкилот бо истифода аз UI ZAP рафъ мешаванд, то шумо метавонед танҳо масъалаҳои боқимондаи мувофиқатро пайгирӣ кунед. Огоҳиҳои нав инчунин барои мувофиқат нишон дода мешаванд, агар корбар унсурҳои ҳатмии конфигуратсияро (кластер/фармонҳо/атрибутҳо) ғайрифаъол кунад. Огоҳиҳо оид ба мувофиқати мушаххасот ҳамеша хатогиҳоеро, ки ба конфигуратсияи ZAP ворид карда мешаванд, пайгирӣ мекунанд, аммо қайд кунед, ки огоҳиҳое, ки ҳангоми кушодани .zap пайдо мешаванд file дар муқоиса бо огоҳиҳое, ки ҳангоми муошират бо UI пайдо мешаванд, дар бораи он, ки чаро он мувофиқат накардааст, муфассалтар аст. Ин аз рӯи тарҳ аст ва санҷиши пурраи мувофиқат ҳангоми кушодани .zap анҷом дода мешавад file.
Огоҳӣ оид ба мувофиқат дар консол

27/35

Мутобиқати мушаххасоти маълумот-модели/ZCL
Вақте ки корбар .zap -ро мекушояд file бо истифода аз UI мустақили ZAP ё ZAP CLI онҳо огоҳиҳоеро мебинанд, ки дар консол/терминал барои ҳама нокомии мувофиқат ворид шудаанд. Барои мисолample, тасвири зер огоҳиҳои огоҳии сессияро дар консол/терминал пас аз .zap нишон медиҳад. file бо масъалахои риоя кардан кушода шуд.

28/35

Назорати дастрасӣ

Хусусиятҳои назорати дастрасӣ
ZAP назорати дастрасиро дар ҳама объектҳои ZCL дастгирӣ мекунад. Татбиқи SDK барои харитаи ин хусусиятҳо бо хусусиятҳои зарурии назорати дастрасии SDK вобаста аст. ZAP одатан модели додаҳо ва механизми рамзгузории онро дар мета-маълумот пешниҳод мекунад files ва ин маълумотро ба қолибҳои насл бе додани маънои мушаххас ба нуқтаҳои додаҳо паҳн кунед.
Шартҳои асосӣ
Назорати дастрасии ZAP се истилоҳи асосиро ба таври зерин муайян мекунад: ò амалиёт: ҳамчун чизе муайян карда мешавад, ки иҷрошаванда аст. Мисолample: хондан, навиштан, даъват кардан. ó нақш: ҳамчун имтиёзи актёр муайян карда мешавад. Ба мисли "View имтиёз», «Рақши маъмурӣ» ва писар оид ба. Тағирдиҳандаҳои ô: ҳамчун шартҳои махсуси назорати дастрасӣ, ба монанди маълумоти ҳассос ба матоъ ё маълумоти фарогирии матоъ муайян карда мешаванд. Шартҳои асосӣ дар метамаълумоти XML дар зери боло муайян карда шудаанд tag . Дар зер як собиқ астampТаърифҳои асосии истилоҳи назорати дастрасӣ:
<role type=”view" тавсиф = "View имтиёз»/>
Ин собикample се амалиётро муайян мекунад, хондан, навиштан ва даъват кардан, ду тағирдиҳанда ва чаҳор нақш.
Дастрасӣ ба Triplets
Ҳар як ҳолати дастрасии инфиродӣ метавонад бо сегонаи дастрасӣ дар XML муайян карда шавад. Триплети дастрасӣ маҷмӯи амалиёт, нақш ва тағирдиҳанда мебошад. Онҳо ихтиёрӣ мебошанд, бинобар ин шумо метавонед танҳо яке аз онҳоро дошта бошед. Қисми ғоибшудаи сегона умуман маънои иҷозатдиҳандаро дорад, ки барои татбиқи SDK-и додашуда хос аст. Объект, ки дастрасии онро муайян мекунад, метавонад як ё якчанд сегонаи дастрасӣ дошта бошад. Дар зер як собиқ астampле:
дар 0
Ин таърифи атрибутест, ки сегонаи дастрасӣ дорад ва эълом мекунад, ки он имкон медиҳад, ки амалиёти навиштан аз рӯи нақши идоракунӣ бо тағирдиҳандаи матоъ истифода шавад.
Иҷозатҳои пешфарз

29/35

Назорати дастрасӣ
Ташкилотҳои ZCL метавонанд иҷозатҳои инфиродии худро муайян кунанд. Аммо, инчунин таърифи глобалии иҷозатҳои пешфарз барои
намудхои додашуда. Инҳо барои субъекти додашуда тахмин карда мешаванд, ба истиснои ҳолатҳое, ки он ягон иҷозати мушаххаси худро пешниҳод накунад.
Иҷозатҳои пешфарз тавассути a tag дар сатҳи болоии XML file. Мисолampле:
аа a< ccess op="invoke"/> a а aa < ccess op=”re d”/> a< ccess op=”write”/> a аа aa <ccess op = "re d" нақши ="view”/> aa < ccess op=”write” role=”oper te”/> a
Ёрдамчиёни Шаблон
Ёрдамчии асосии шаблон барои истифода итератори {{#access}} … {{/access}} мебошад. Ин итератор тамоми сегонаҳои дастрасии додашударо такрор мекунад.
Он ду имконоти зеринро дастгирӣ мекунад:
entity = "attribute/command/event" - агар объектро аз контекст муайян кардан ғайриимкон бошад, ин навъи объектро муқаррар мекунад. includeDefault = "true/false" - муайян мекунад, ки оё арзишҳои пешфарз дохил карда шудаанд ё не. Дар зер як собиқ астampле:
{{#zcl_clusters}}
a Кластер: {{n me}} [{{code}}] a {{#zcl_ ttributes}} aa – атрибут: {{n me}} [{{code}}] aa {{# ccess entity=” аттрибут”}}
O a RM a M * p: {{opertion}} / ole: {{rol}} / odifier: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_ ttributes}} a {{#zcl_comm nds}} aa – comm nd: {{n me}} [{{code}}} [{{code}}} ccess a RM a M * p: {{амалиёт}} / оле: {{рол}} / муайянкунанда: {{ ccess odifier}} a{{/ ccess}} a {{/zcl_comm nds}}
{{#zcl_events}}
a – ҳодиса: {{n me}} [{{code}}] a {{# ccess entity=”event”}} O a RM a M * p: {{opertion}} / ole: {{rol}} / odifier: {{ ccess odifier}} a{{/ ccess}}
{{/zcl_events}}
{{/zcl_clusters}}

30/35

Оғози ZAP барои барномаҳои Matter ё Zigbee
Оғози ZAP барои барномаҳои Matter ё Zigbee
Оғози ZAP барои барномаҳои Matter ё Zigbee
Фаслҳои зерин оғоз кардани ZAP-ро дар ҳолати мустақил бо метамаълумоти мушаххаси Matter ё Zigbee тавсиф мекунанд. Идеяи оғоз кардани ZAP бо далелҳои дурусти марбут ба метамаълумоти XML (кластерҳо ва таърифҳои намудҳои дастгоҳ мувофиқи мушаххасоти CSA) ва қолабҳои тавлид, ки барои тавлиди рамзи мувофиқ истифода мешаванд, иборат аст.
Оғози ZAP бо Matter
Скрипти зерин ҳангоми оғози ZAP метамаълумоти дурустро аз Matter SDK мегирад. https://github.com/project-chip/connectedhomeip/blob/master/scripts/tools/zap/run_zaptool.sh Эзоҳ: Шумо инчунин метавонед ба равиши зерини Zigbee барои оғози ZAP дар Matter муроҷиат кунед.
Оғози ZAP бо Zigbee
Фармони зерин ZAP-ро бо мушаххасоти ZCL ва қолабҳои тавлид аз 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: Ин роҳ ба манбаи ZAP ё sdk-роҳи иҷрошаванда аст: Ин роҳ ба SDK аст
Оғози ZAP бе метамаълумот
Дар хотир доред, ки ҳангоми оғози ZAP мустақиман тавассути файли иҷрошаванда ё аз манбаъ бо истифода аз npm run zap шумо ZAP-ро бо метамаълумотҳои санҷишӣ барои Matter/Zigbee дар дохили ZAP сохташуда оғоз мекунед, на метамаълумоти воқеии аз Matter ва Zigbee SDK-ҳои дар боло зикршуда. Аз ин рӯ, фаромӯш накунед, ки конфигуратсияҳои ZAP-и худро бо истифода аз метамаълумоти SDK эҷод кунед, на бо кушодани ZAP мустақиман бо метамаълумоти дарунсохташуда.

31/35

Эҷоди код барои Matter ё Zigbee

Эҷоди код барои материя, Zigbee ё SDK фармоишӣ
Фаслҳои зерин чӣ гуна эҷод кардани кодро бо истифода аз ZAP тавсиф мекунанд.
Эҷоди код бо истифода аз ZAP UI
ZAP UI-ро мувофиқи дастурҳо дар Launching ZAP for Matter ё Zigbee оғоз кунед ва тугмаи тавлидро дар сатри менюи боло пахш кунед.
Бе интерфейси интерфейси код тавлид кунед
Дастурҳои зерин роҳҳои гуногуни тавлиди кодро тавассути CLI бидуни оғоз кардани UI ZAP пешниҳод мекунанд.
Эҷоди код аз манбаи ZAP
Барои тавлиди код бо истифода аз ZAP аз манбаъ фармони зеринро иҷро кунед: 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
Эҷоди код аз ZAP Executable
Фармони зеринро барои тавлиди код бо истифода аз иҷрошавандаи ZAP иҷро кунед: [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
Эҷоди код аз ZAP CLI Executable
Фармони зеринро барои тавлиди код бо истифода аз ZAP CLI Executable иҷро кунед: [zap-cli-path]gener –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

Навсозии ZAP дар Studio

Навсозии ZAP
Навсозии ZAP дар Studio Simplyity
Ин механизмро ҳангоми кор бо васеъшавии Matter ё Zigbee аз релизҳои Silicon Labs SDK истифода бурдан мумкин аст. ZAP-ро дар дохили Simplicity Studio бидуни нашри Simplicity Studio тавассути зеркашии файли охирини иҷрошавандаи ZAP (тавсия дода мешавад) ё гирифтани навтарин аз манбаи ZAP тавре ки дар Дастури насби ZAP нишон дода шудааст, навсозӣ кардан мумкин аст. Пас аз он ки шумо ZAP-и навтаринро дар асоси OS-и ҳозира истифодашавандаатон доред, шумо метавонед ZAP-ро дар дохили Studio ҳамчун бастаи адаптер навсозӣ кунед. Пас аз зеркашии охирини ZAP, дастурҳои зеринро иҷро кунед:
Ба Студияи Simplicity равед ва Preferences > Simplicity Studio > Packs Adapter-ро интихоб кунед. Иловаи…-ро клик кунед ва ба папкаи васеъшудаи ZAP, ки шумо зеркашӣ кардаед, паймоиш кунед ва Папкаро интихоб кунед. Apply and Close-ро клик кунед ва он гоҳ ZAP-и нав иловашуда ҳар вақте ки .zap истифода мешавад file кушода мешавад.
Эзоҳ: Баъзан мумкин аст, ки ҳатто пас аз навсозӣ ба ZAP навтарин ҳолатҳои кӯҳнаи ZAP аллакай кор мекунанд. Боварӣ ҳосил кунед, ки ҳама намунаҳои мавҷудаи ZAP-ро ба итмом расонед, ки ZAP-и нав гирифташуда ба ҷои намунаи кӯҳна, ки ҳоло ҳам дар замина кор мекунад, истифода шавад.
Навсозии ZAP барои рушди материя дар Github
Ҳангоми кор бо репоҳои Matter ё Matter-Silicon Labs дар Github, тағирёбандаҳои муҳити зистро нисбат ба ZAP насб кунед, то конфигуратсияҳои нави ZAP-ро эҷод/таҷдид кунед ё аз нав тавлид кардани s-ҳои мавҷудаampконфигуратсияҳои ZAP пас аз ворид кардани тағирот ба онҳо. ZAP_DEVELOPMENT_PATH-ро ба ZAP аз манбаъ тавассути кашидани навтарин ё ZAP_INSTALLATION_PATH-ро ба ZAP иҷрошавандае, ки шумо дар феҳристи маҳаллии худ охирин бор кардаед, насб кунед. Дар хотир доред, ки вақте ҳам ZAP_DEVELOPMENT_PATH ва ҳам ZAP_INSTALLATION_PATH муқаррар карда шудаанд, ZAP_DEVELOPMENT_PATH истифода мешавад.
Қуйидагилар собиқamples, ки тағирёбандаҳои муҳити болоро дар истифода нишон медиҳанд:
Оғози ZAP бо истифода аз мушаххасоти Matter Барқарорсозии ҳама сampконфигуратсияҳои ZAP барои барномаҳои Matter
Эзоҳ: Ҳангоми истифодаи файлҳои иҷрошавандаи ZAP, боварӣ ҳосил кунед, ки шумо барои устувории бештар версияи расмиро дар як версияи шабона истифода мебаред. Бинед
Зеркашии файли иҷрошавандаи ZAP дар дастури насби ZAP

33/35

Протоколи бисёрҷонибаи ҳамзамон байни Zigbee ва Matter
Протоколи бисёрҷонибаи ҳамзамон байни Zigbee ва Matter
MCoanttceurrent Мулти-протоколи байни Zigbee ва
ZAP метавонад барои танзим кардани конфигуратсияҳои ZCL (Zigbee) ва Data-Model (Matter) дар як барномаи бисёрпротоколӣ барои Zigbee ва Matter истифода шавад. ZAP ба шумо имкон медиҳад, ки дар як конфигуратсия нуқтаҳои ниҳоӣ барои Zigbee ва Matter эҷод кунед file. Агар нуқтаҳои ниҳоии Zigbee ва Matter дар ҳамон як идентификатори ниҳоӣ бошанд (масаланample, LO Light Dimmable дар нуқтаи ниҳоии Id 1 ва Light Matter Dimmable дар мисоли дигари нуқтаи ниҳоии 1), ZAP барои ҳамоҳангсозии атрибутҳои умумӣ дар атрибутҳои Matter ва Zigbee ғамхорӣ мекунад. Боварӣ ҳосил кунед, ки атрибутҳои ҳамоҳангшуда як навъи маълумот доранд. Хусусиятҳои умумии байни Zigbee ва Matter тавассути а муқаррар карда мешаванд file multi-protocol.json номида мешавад. Истифодабаранда метавонад ҳар ду кластерро дар саросари Zigbee ва Matter бо атрибутҳои мувофиқи онҳо бо истифода аз рамзҳои кластер ва атрибутҳо пайваст кунад. Ин file дар [SDKPath]/app/zcl/multi-protocol.json пайдо кардан мумкин аст. Ин file барои оғоз бо маҷмӯи муайяни кластерҳо ва атрибутҳо навсозӣ шудааст, аммо корбар метавонад онро навсозӣ кунад file мувофиқи талабот ва ZAP ҳамоҳангсозии конфигуратсияи атрибутҳоро дар байни Zigbee ва Matter барои идентификаторҳои умумии нуқтаи ниҳоӣ ғамхорӣ мекунад.
Шумо инчунин метавонед як дастури ZAP-ро дар ҳама гуна замимаи бисёрпротоколии Zigbee ва Matter дар саҳифаи дарсӣ пайдо кунед. Ин дастур ба шумо дар раванди эҷоди барномаҳои бисёрпротоколӣ роҳнамоӣ мекунад. Ин дастур танҳо вақте дастрас аст, ки шумо як барномаи бисёрпротоколии мавҷударо кушоед ва онро тавре ки дар тасвири зер нишон дода шудааст, пайдо кардан мумкин аст:

34/35

Интегратсияи SLC CLI бо ZAP
Интегратсияи SLC CLI бо ZAP
Интегратсияи SLC CLI бо ZAP
Барои ҳамгироии SLC CLI бо ZAP ин қадамҳоро иҷро кунед: ò SLC CLI-ро бо риояи дастурҳои насбкунӣ дар дастури корбари Simplicity Studio 5 насб кунед. ó ZAP-ро бо риояи дастурҳои Дастури насби ZAP насб кунед. ô Барои ҳамгироии SLC CLI бо ZAP, як тағирёбандаи муҳити STUDIO_ADAPTER_PACK_PATH илова кунед, ки ба барномаи ZAP ишора мекунад
директория. õ Дар хотир доред, ки SLC CLI Daemon-ро пас аз қадами 3 бозоғоз намоед. ö Ҳама лоиҳае, ки ZAP-ро истифода мебарад, ҳоло роҳи дар қадами 3 муайяншударо ҳангоми тавлиди SLC CLI истифода мебарад. Лутфан ба SLC CLI муроҷиат кунед
Истифода барои дастурҳо оид ба истифодаи SLC CLI барои лоиҳаҳои худ.

35/35

Ҳуҷҷатҳо / Сарчашмаҳо

SILICON LABS ZAP бо Silicon Labs таҳия карда мешавад [pdf] Дастури соҳиби
ZAP бо лабораторияҳои силикон таҳия карда мешавад, ZAP, бо лабораторияҳои силикон таҳия мешавад, лабораторияҳои кремний, лабораторияҳо

Иқтибосҳо

Дастури корбар

ZAP бо Labs Silicon таҳия карда мешавад

Мушаххасоти

Дастурҳои истифодаи маҳсулот

Саволҳо

Таҳия бо Silicon Labs ZAP

Оғози ZAP

Насби ZAP

Асосҳои ZAP

XML фармоишӣ

XML фармоишӣ Tags барои Zigbee

Якчанд намуди дастгоҳҳо дар як нуқтаи ниҳоӣ

Назорати дастрасӣ

Эҷоди код барои Matter ё Zigbee

Навсозии ZAP дар Studio

Ҳуҷҷатҳо / Сарчашмаҳо

Иқтибосҳо

Назари худро гузоред

Ҷавобро бекор кунед