DIVUS-VISION-suaicheantas ......

Bathar-bog DIVUS VISION API

DIVUS-VISION-API-Bathar-bog-PRODUCT

Sònrachaidhean

  • Bathar: DIVUS VISION API
  • Dèanadair: DIVUS GmbH
  • Tionndadh: 1.00 REV0 1 - 20240528
  • Àite: Pillhof 51, Eppan (BZ), an Eadailt

Fiosrachadh toraidh

Tha an DIVUS VISION API na inneal bathar-bog a chaidh a dhealbhadh airson eadar-aghaidh le siostaman DIVUS VISION. Leigidh e le luchd-cleachdaidh faighinn gu agus smachd a chumail air diofar eileamaidean taobh a-staigh an t-siostam a’ cleachdadh protocolaidhean MQTT.

Ceistean Cumanta

C: An urrainn dhomh an API DIVUS VISION a chleachdadh gun eòlas ro-làimh air PC no teicneòlas fèin-ghluasaid?

F: Tha an leabhar-làimhe air a dhealbhadh airson luchd-cleachdaidh le eòlas roimhe seo anns na raointean sin gus dèanamh cinnteach gum bi an API air a chleachdadh gu h-èifeachdach.

FIOSRACHADH CHOITCHEANN

  • DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - an Eadailt

Tha stiùireadh obrachaidh, leabhraichean-làimhe agus bathar-bog air an dìon le dlighe-sgrìobhaidh. Gach còir glèidhte. Chan eil leth-bhreac, dùblachadh, eadar-theangachadh, eadar-theangachadh gu h-iomlan no ann am pàirt ceadaichte. Tha eisgeachd a’ buntainn ri cruthachadh leth-bhreac cùl-taic den bhathar-bog airson a chleachdadh gu pearsanta.
Tha an leabhar-làimhe fo ùmhlachd atharrachadh gun rabhadh. Chan urrainn dhuinn gealltainn gu bheil an dàta anns an sgrìobhainn seo agus air na meadhanan stòraidh a chaidh a thoirt seachad saor bho mhearachdan agus ceart. Tha fàilte an-còmhnaidh air molaidhean airson leasachaidhean a bharrachd air molaidhean mu mhearachdan. Tha na cùmhnantan cuideachd a’ buntainn ris na h-eàrr-ràdhan sònraichte don leabhar-làimhe seo. Faodaidh na sònrachaidhean san sgrìobhainn seo a bhith nan comharran-malairt agus dh’ fhaodadh an cleachdadh le treas phàrtaidhean airson an adhbharan fhèin briseadh air còraichean an luchd-seilbh. Stiùireadh cleachdaiche: Feuch an leugh thu an leabhar-làimhe seo mus cleachd thu e airson a’ chiad uair agus cùm e ann an àite sàbhailte airson fiosrachadh san àm ri teachd. Buidheann targaid: Tha an leabhar-làimhe air a sgrìobhadh airson luchd-cleachdaidh le eòlas roimhe air PC agus teicneòlas fèin-ghluasaid.

COINNICHEAN TIOMNAIDHDIVUS-VISION-API - Bathar-bog-fig (1)

Ro-ràdh

RO-RÀDH COITCHEANN

Tha an leabhar-làimhe seo a’ toirt cunntas air VISION API (Eadar-aghaidh Prògramadh Iarrtais) - eadar-aghaidh tron ​​​​urrainnear dèiligeadh ri VISION agus smachd a chumail air bho shiostaman a-muigh.
Gu practaigeach, tha seo a’ ciallachadh gun urrainn dhut siostaman leithid

smachd a chumail air na h-eileamaidean air an riaghladh le VISION no an inbhe aca a leughadh. Bidh ruigsinneachd agus conaltradh a’ tachairt tro phròtacal MQTT, a bhios a’ cleachdadh cuspairean ris an canar gus dèiligeadh ri gnìomhan fa leth no seataichean de dhleastanasan no gus fios fhaighinn mu atharrachaidhean orra. Bithear a’ cleachdadh frithealaiche MQTT (broker) airson an adhbhair seo, a bhios a’ làimhseachadh tèarainteachd agus a’ riaghladh/sgaoileadh theachdaireachdan dha na com-pàirtichean. Anns a 'chùis seo, tha am frithealaiche MQTT suidhichte gu dìreach air an DIVUS KNX IQ agus tha e air a dhealbhadh gu sònraichte airson an adhbhair seo. Ged a ghabhas an VISION API a chleachdadh cuideachd gun eòlas air prògramadh, tha an gnìomh seo freagarrach airson luchd-cleachdaidh adhartach.

ROIMH-RADH

Mar a chaidh a mhìneachadh ann an leabhar-làimhe VISION, feumaidh an neach-cleachdaidh API a bhith air a chuir an gnìomh an-toiseach gus a bhith comasach air a chleachdadh chan eil ruigsinneachd API ag obair ach a’ cleachdadh dàta dearbhaidh luchd-cleachdaidh Api. A thaobh còraichean luchd-cleachdaidh, faodar an gnìomh airson a’ ghnìomhachd seo a rèiteachadh an dàrna cuid air a h-uile càil no air eileamaidean fa leth. Faic Caib.0. Gu dearbh, feumaidh tu cuideachd pròiseact VISION anns a bheil na h-eileamaidean a tha thu airson smachd a chumail air an taobh a-muigh air an làn rèiteachadh agus an ceangal riutha air a dhearbhadh gu soirbheachail. Airson a bhith comasach air dèiligeadh ri eileamaidean fa leth tron ​​​​API, feumaidh fios a bhith agad air an ID eileamaid aca: tha seo ri fhaicinn aig bonn foirm roghainnean an eileamaid

SEACHDAIN

Airson adhbharan tèarainteachd, chan eil ruigsinneachd API comasach ach gu h-ionadail (ie chan ann tron ​​​​sgòth). Mar sin tha an cunnart tèarainteachd nuair a thèid ruigsinneachd API a chuir an gnìomh ìosal. Ach a dh’ aindeoin sin, cha bu chòir eileamaidean co-cheangailte ri tèarainteachd a bhith air an comasachadh no air an diùltadh gu sònraichte airson ruigsinneachd API.

MQTT AGUS NA teirmichean aige - Mìneachadh goirid

  • DIVUS-VISION-API - Bathar-bog-fig (2)Ann am MQTT, is e àite a’ bhròcair a tha ann an riaghladh agus cuairteachadh meadhanaichte gach teachdaireachd. Ged nach eil frithealaiche MQTT agus broker MQTT nan co-fhaclan (tha frithealaiche na theirm nas fharsainge airson àite a dh’ fhaodas teachdaichean MQTT a chluich cuideachd), tha am broker an-còmhnaidh air a chiallachadh san leabhar-làimhe seo nuair a thèid iomradh a thoirt air frithealaiche MQTT. Bidh an DIVUS KNX IQ fhèin a’ cluich pàirt broker MQTT / frithealaiche MQTT ann an co-theacsa an leabhar-làimhe seo.
  • DIVUS-VISION-API - Bathar-bog-fig (3)Bidh frithealaiche MQTT a’ cleachdadh cuspairean ris an canar: structar rangachd leis a bheil dàta air a sheòrsachadh, air a riaghladh agus air fhoillseachadh.
  • DIVUS-VISION-API - Bathar-bog-fig (4)Tha prìomh amas aig foillseachadh dàta a thoirt do chom-pàirtichean eile tro chuspairean. Ma tha thu airson luach atharrachadh, bidh thu a’ sgrìobhadh chun chuspair a tha thu ag iarraidh còmhla ris an atharrachadh luach a tha thu ag iarraidh, a’ cleachdadh gnìomh foillseachaidh cuideachd. Bidh an inneal targaid no am frithealaiche MQTT a 'leughadh an atharrachaidh a tha a dhìth a bheir buaidh air agus a' gabhail ris a rèir sin. Gus dèanamh cinnteach gun deach an t-atharrachadh a chuir an sàs, faodaidh tu coimhead anns a’ chuspair fo-sgrìobhadh fìor-ùine gus faicinn a bheil an t-atharrachadh ri fhaicinn an sin - ma tha a h-uile càil air obrachadh a-mach gu math.
  • DIVUS-VISION-API - Bathar-bog-fig (5)Bidh luchd-dèiligidh a’ taghadh nan cuspairean anns a bheil ùidh aca: canar fo-sgrìobhadh ris an seo. Gach uair a dh’ atharraicheas luach ann an / fo chuspair, thèid fios a chur chun a h-uile neach-dèiligidh fo-sgrìobhadh - ie gun a bhith a’ faighneachd gu soilleir a bheil rudeigin air atharrachadh no dè an luach a th’ ann an-dràsta.
  • DIVUS-VISION-API - Bathar-bog-fig (6)Faodaidh tu sianal conaltraidh fa leth fhosgladh (no seòladh) leis an t-seirbheisiche MQTT le bhith a’ dol a-steach do shreang sònraichte sam bith ris an canar client_id ann an cuspair. Feumar an client_id a chleachdadh sa chuspair gus luachan a phròiseasadh. Bidh seo a’ comharrachadh tùs gach atharrachaidh, a’ cuideachadh le mearachdan sam bith agus chan eil e a’ toirt buaidh air na teachdaichean eile, leis gu bheil na freagairtean co-fhreagarrach bhon fhrithealaiche, a’ toirt a-steach còdan mearachd agus teachdaireachdan sam bith, cuideachd a’ ruighinn a’ chuspair leis an aon client_id (agus mar sin a-mhàin). an neach-dèiligidh sin). Tha an client_id na shreang caractar sònraichte anns a bheil measgachadh sam bith de na caractaran 0-9, az, AZ, “-“, “_”.
  • DIVUS-VISION-API - Bathar-bog-fig (7)San fharsaingeachd, tha inbhe prìomh fhacal anns na cuspairean fo-sgrìobhaidh aig frithealaiche MQTT an DIVUS KNX IQ, agus tha an t-iarrtas prìomh fhacal anns na cuspairean foillseachaidh. Bidh an fheadhainn le inbhe air an ùrachadh gu fèin-ghluasadach cho luath ‘s a bhios atharrachadh luach taobh a-muigh ann no cho luath‘ s a bhios an neach-dèiligidh fhèin air atharrachadh luach iarraidh tro fhoillseachadh agus air a chuir an sàs gu soirbheachail. Tha an fheadhainn airson foillseachaidh air an roinn nas fhaide a-steach don fheadhainn de sheòrsa (iarrtas /) faighinn agus an fheadhainn de sheòrsa (iarrtas /) seata.
  • DIVUS-VISION-API - Bathar-bog-fig (8)Bithear a’ cur atharrachaidhean luach agus crìochan roghainneil eile ris a’ chuspair leis an uallach pàighidh ris an canar. Paramadairean nan eileamaidean fa leth (eileamaid-id, ainm, seòrsa, gnìomhan)

Tha am prìomh eadar-dhealachadh eadar MQTT agus am modail clasaigeach frithealaiche teachdaiche, far a bheil an neach-dèiligidh ag iarraidh agus an uairsin ag atharrachadh dàta, stèidhichte air bun-bheachdan ballrachd agus foillseachadh. Faodaidh com-pàirtichean dàta fhoillseachadh, ga thoirt do dhaoine eile, a dh’ fhaodadh ballrachd a ghabhail ann ma tha ùidh aca. Tha an ailtireachd seo ga dhèanamh comasach iomlaid dàta a lughdachadh agus cumail suas ris a h-uile duine le ùidh sa chùis. Barrachd mun fhiosrachadh an seo: agus tha paramadairean sònraichte (uuid, sìoltachain) gu bhith air an cleachdadh an seo. Ged a tha grunn roghainnean ann, tha an t-uallach pàighidh air a shealltainn ann an cruth mar JSON san leabhar-làimhe seo. Bidh JSON a’ cleachdadh camagan agus cromagan gus dàta de structar sam bith a riochdachadh agus mar sin a’ lughdachadh meud nam pacaidean dàta a thèid a ghluasad. Gheibhear barrachd fiosrachaidh mu luchdan pàighidh nas fhaide air adhart san leabhar-làimhe.

  • DIVUS-VISION-API - Bathar-bog-fig (9)Airson adhbharan sònraichte, tha e comasach sìoladh a rèir an seòrsa gnìomh, me gus dèiligeadh ri dìreach air / dheth ie suidsichean 1-bit. Tha am paramadair sìoltachain san eallach pàighidh air a chleachdadh airson an adhbhar seo. Chan eil sìoladh comasach an-dràsta ach a rèir seòrsa gnìomh.
  • DIVUS-VISION-API - Bathar-bog-fig (10)Airson a bhith comasach air dèiligeadh ri eileamaidean fa leth, tha feum air an eileamaid ID aca. Gheibhear seo ann an VISION anns a’ chlàr feartan eileamaid no faodar a leughadh gu dìreach bhon dàta a tha air a thaisbeanadh air beulaibh gach eileamaid a tha ri fhaighinn anns an fho-sgrìobhadh coitcheann den MQTT Explorer (tha eileamaidean ann air an liostadh a rèir na h-aibideil a rèir ID eileamaid).

DIVUS-VISION-API - Bathar-bog-fig (11)

Rèiteachadh airson ruigsinneachd API

A’ rèiteachadh Lèirsinn AIRSON ruigsinn cleachdaiche API

Ann an Lèirsinn mar rianadair, rachaibh gu Configuration - Cleachdaiche / Riaghladh Ruigsinneachd API, cliog air Luchd-cleachdaidh / ruigsinneachd API agus cliog deas air API Cleachdaiche (no brùth is gleidh) gus an uinneag deasachaidh fhosgladh. An sin gheibh thu na paramadairean agus an dàta sin

  • Dèan comas (bogsa-dearbhaidh)
    • Tha an cleachdaiche air a chomasachadh an seo an toiseach. Tha an suidheachadh bunaiteach à comas
  • Ainm-cleachdaidh
    • Tha feum air an t-sreang seo airson faighinn a-steach tro API - dèan lethbhreac dheth às an seo
  • Facal-faire
    • Tha feum air an t-sreang seo airson faighinn a-steach tro API - dèan lethbhreac dheth às an seo
  • Ceadan
    • Faodar na còraichean bunaiteach airson leughadh agus sgrìobhadh luachan nan eileamaidean VISION a mhìneachadh an seo, ie tha na tha air a mhìneachadh an seo a’ buntainn ris a h-uile eileamaid a tha ann agus san àm ri teachd. Mura h-eil thu airson ach cothrom fhaighinn air eileamaidean fa leth, cha bu chòir dhut na còraichean bunaiteach sin atharrachadh

EADAR-MHINEACHADH AIR EILEANAN AONAIR

Thathas a’ moladh nach toir thu cothrom API air a’ phròiseact gu lèir, ach a-mhàin do na h-eileamaidean a tha thu ag iarraidh. Lean air adhart mar a leanas

  1. log a-steach gu VISION mar rianadair
  2. tagh an eileamaid a tha thu ag iarraidh agus fosgail a chlàr roghainnean (cliog deas no cùm air a bhrùthadh, an uairsin Settings)
  3. fon inntrig clàr Coitcheann - Ceadan, cuir an gnìomh “Sguab às na ceadan bunaiteach" agus an uairsin rachaibh chun fho-chuspair Ceadan, a sheallas am matrix ceadan.DIVUS-VISION-API - Bathar-bog-fig (12)
  4. cuir an gnìomh an cead smachd an seo, a bheir comas don view cead gu dìreach. Mura h-eil thu airson ach dàta a leughadh tron ​​​​ruigsinneachd API, tha e gu leòr gus an view cead.
  5. cuir a-rithist an aon dòigh-obrach airson na h-eileamaidean uile a tha thu airson faighinn a-steach

Ceangal tro MQTT

RO-RÀDH

Mar example, seallaidh sinn ruigsinneachd tro API MQTT den DIVUS KNX IQ le bathar-bog an ìre mhath sìmplidh an-asgaidh ris an canar MQTT Explorer (faic caibideil 1.1), a tha ri fhaighinn airson Windows, Mac agus Linux. Tha eòlas agus eòlas bunaiteach le MQTT ri thuigsinn.

DÀTA AIRSON AN T-SLIGHE

Mar a chaidh ainmeachadh roimhe (faic earrann 2.1), tha feum air ainm-cleachdaidh agus facal-faire neach-cleachdaidh API. Seo an còrrview den dàta gu lèir a dh'fheumar a chruinneachadh mus tèid ceangal a stèidheachadh:

  • Ainm-cleachdaidh Leugh a-mach air duilleag mion-fhiosrachaidh cleachdaiche API
  • Facal-faire Leugh a-mach air duilleag mion-fhiosrachaidh neach-cleachdaidh API
  • Seòladh IP Leugh a-mach anns na roghainnean lannsair fo Coitcheann - Lìonra - Ethernet (no tro Synchronizer)
  • Port 8884 (tha am port seo glèidhte airson an adhbhair seo)

A’ CHIAD cheangail ri MQTT EXPLORER AGUS FO-SCRIBE coitcheann

Mar as trice, bidh MQTT a’ dèanamh eadar-dhealachadh eadar na gnìomhan fo-sgrìobhadh agus foillseachadh. Bidh MQTT Explorer a’ sìmpleachadh seo le bhith a’ fo-sgrìobhadh gu fèin-ghluasadach airson a h-uile cuspair a tha ri fhaighinn (cuspair #) nuair a thèid a’ chiad cheangal a dhèanamh. Mar thoradh air an sin, chithear a’ chraobh a tha a’ leantainn gu na h-eileamaidean uile a tha rim faighinn (ie ruigsinneachd cleachdaiche API air a bhuileachadh) gu dìreach air taobh clì uinneag MQTT Explorer às deidh ceangal soirbheachail. Gus barrachd chuspairean fo-sgrìobhaidh a chuir a-steach no gus cuspair nas sònraichte a chuir na àite, rachaibh gu Advanced san uinneag ceangail. Tha an cuspair a chithear gu h-àrd air an làimh dheis a’ coimhead rudeigin mar seo:DIVUS-VISION-API - Bathar-bog-fig (13)

far a bheil 7f4x0607849x444xxx256573x3x9x983 mar ainm-cleachdaidh an API agus tha na h-eileamaidean a tha rim faighinn anns a’ chuspair seo an-còmhnaidh. Mura h-eil thu airson ach fo-sgrìobhadh do eileamaidean fa leth, cuir a-steach ID eileamaid na h-eileamaid a tha thu ag iarraidh às deidh object_list/.

Nota: Tha an seòrsa ballrachd seo gu ìre mhòr a’ freagairt ris an reusanachadh air cùl seòlaidhean fios-air-ais KNX; tha e a’ sealltainn inbhe làithreach nan eileamaidean agus faodar a chleachdadh gus dèanamh cinnteach an deach na h-atharrachaidhean a tha thu ag iarraidh a chuir an sàs gu soirbheachail. Ma tha thu dìreach airson dàta a leughadh a-mach ach nach atharraich thu e, tha an seòrsa ballrachd seo gu leòr.

Tha aon eileamaid shìmplidh a’ coimhead rudeigin mar seo ann an comharradh JSONDIVUS-VISION-API - Bathar-bog-fig (14)

Nota: Tha an co-chòrdadh gu h-àrd aig a h-uile luach me { “value”: “1” } mar thoradh nan cuspairean ballrachd, fhad ‘s a tha an luach sgrìobhte gu dìreach san eallach pàighidh gus luach atharrachadh (ie airson cuspairean foillsichte) - na camagan agus tha “value” air am fàgail air falbh me “onoff”: “1”.

Òrdughan adhartach

RO-RÀDH

Tha 3 seòrsa de chuspairean ann san fharsaingeachd:

  1. Subscribe cuspair(ean) gus na h-eileamaidean a tha rim faighinn fhaicinn agus gus atharrachaidhean luach fìor-ùine fhaighinn
  2. Subscribe cuspair(ean) gus na freagairtean fhaighinn gu (an luchd-dèiligidh ) iarrtasan fhoillseachadh
  3. Foillsich cuspair(ean) gus eileamaidean fhaighinn no a shuidheachadh leis na luachan aca

Bheir sinn iomradh nas fhaide air adhart air na seòrsaichean sin leis an àireamhachadh a chithear an seo (me cuspairean seòrsa 1, 2, 3). Tuilleadh mion-fhiosrachaidh anns na h-earrannan a leanas agus ann an caibideil. 4.2.

Fo-sgrìobh cuspairean gus na h-eileamaidean a tha rim faighinn fhaicinn agus gus atharraichean luach fìor-ùine fhaighinn

Chaidh iad sin a mhìneachadh mar-thà

SUBSCRIBE CUSPAIREAN GU FREAGAIRTEAN GU IARRTASAN FHOILLSEACHADH AN CLIANACH

Tha an seòrsa cuspairean seo roghainneil. Tha e a 'ceadachadh

  • fosgail sianal conaltraidh sònraichte leis an t-seirbheisiche MQTT le bhith a’ cleachdadh client_id neo-riaghailteach. Tuilleadh mu dheidhinn sin ann an caib. 4.2.2
  • faigh toradh iarrtasan foillsichte air a’ chuspair ballrachd co-fhreagarrach: soirbheachas no fàilligeadh le còd mearachd agus teachdaireachd.

Tha diofar chuspairean ann airson freagairtean fhaighinn airson òrdughan foillseachaidh fhaighinn no a shuidheachadh. An eadar-dhealachadh co-fhreagarrach ann anDIVUS-VISION-API - Bathar-bog-fig (15) Cho luath ‘s a gheibh thu na cuspairean a tha a dhìth airson an t-siostam agad gu dìreach, faodaidh tu co-dhùnadh an ceum seo a thoirt air falbh agus cuspairean foillseachaidh a chleachdadh gu dìreach.

 FHOILLSEACHADH CUSPAIREAN AIRSON FAIGHINN NO GU EILEANAN A SHEACHADADH AIRSON AN LUACHDAN

Bidh na cuspairean sin a’ cleachdadh slighe coltach ris an fheadhainn airson fo-sgrìobhadh - is e an aon atharrachadh am facal “iarrtas” an àite an “inbhe” a thathas a’ cleachdadh airson ballrachd. Tha slighean cuspair iomlan air an sealltainn nas fhaide air adhart sa chaibideil. 4.2.2\ Iarraidh cuspair faigh eileamaidean agus luachan an fhrithealaiche MQTT a leughadh. Faodar an t-uallach pàighidh a chleachdadh airson sìoladh a rèir seòrsa gnìomh nan eileamaidean. Iarraidh cuspair suidhichte pàirtean de eileamaid atharrachadh, mar a tha air a mhìneachadh san uallach pàighidh aige.

ROIMH-RADH AIRSON ORDAN AGUS FREAGAIRTEAN CO-FHREAGAIRTEACH

 Mìneachadh Giorra

Tha pàirt tùsail cumanta aig a h-uile òrdugh a thèid a chuir chun t-seirbheisiche MQTT, is iad sin:

DIVUS-VISION-API - Bathar-bog-fig (16)

MÍNeachadh FEAR-CIUIL

Bidh an ro-leasachan coitcheann aig na cuspairean fìor-ùine (seòrsa 1) (faic gu h-àrd) agus an uairsin

DIVUS-VISION-API - Bathar-bog-fig (17)

orDIVUS-VISION-API - Bathar-bog-fig (18)

Airson òrdughan suidhichte, tha e follaiseach gur e an t-uallach pàighidh am prìomh dhleastanas oir bidh na h-atharrachaidhean a thathar ag iarraidh ann (ie luachan atharraichte airson gnìomhan an eileamaid). Rabhadh: Na cleachd an roghainn gleidhidh anns na h-òrdughan seòrsa 3 agad gu bràth oir dh’ fhaodadh e cùisean adhbhrachadh air taobh KNX.

EXAMPLE: FOILLSEACHADH AIRSON LUACH(ean) EILEANACH SINGAL atharrachadh

Is e a’ chùis as sìmplidh a bhith ag iarraidh luach aon de na h-eileamaidean a tha air an sealltainn leis an fho-sgrìobhadh coitcheann atharrachadh.
San fharsaingeachd, tha 3 ceumannan ag atharrachadh / ag atharrachadh gnìomh Lèirsinn tro MQTT, agus chan eil iad uile gu tur riatanach, ach tha sinn a’ moladh a bhith gan coileanadh mar a chaidh a mhìneachadh.

  1. Tha an cuspair anns a bheil an gnìomh a tha sinn airson a dheasachadh fo-sgrìobhadh a’ cleachdadh custom client_id
  2. Tha an cuspair airson deasachadh air fhoillseachadh còmhla ris an uallach pàighidh leis na h-atharrachaidhean a thathar ag iarraidh a’ cleachdadh an client_id a chaidh a thaghadh ann an 1.
  3. Airson dearbhadh, chì thu an fhreagairt ann an cuspair (1.) – ie co-dhiù an robh (2.) ag obair no nach robh
  4. Anns an fho-sgrìobhadh coitcheann, far a bheil na luachan uile air an ùrachadh nuair a thèid atharrachaidhean a dhèanamh, chì thu an t-atharrachadh / na h-atharrachaidhean luach a tha thu ag iarraidh ma tha a h-uile càil air obrachadh a-mach gu math.

Is iad na ceumannan airson seo a dhèanamh:

  1. tagh client_id me “Divus” agus cuir a-steach e san t-slighe às deidh ainm-cleachdaidh APIDIVUS-VISION-API - Bathar-bog-fig (19)
    Is e seo an cuspair iomlan airson fo-sgrìobhadh don t-sianal conaltraidh agad fhèin leis an t-seirbheisiche MQTT. Innsidh seo don fhrithealaiche far a bheil dùil agad ri freagairtean nan atharraichean a tha thu am beachd a chur. Mothaich am pàirt inbhe/seata a tha a’ mìneachadh a. gur e cuspair ballrachd a th’ ann agus b. gum faigh e na freagairtean airson òrdughan seòrsa suidhichte.
  2. Bidh an cuspair foillseachaidh an aon rud ach a-mhàin airson na prìomh fhaclan iarrtas inbhe atharrachadhDIVUS-VISION-API - Bathar-bog-fig (20)
  3. tha na bu chòir a bhith san atharrachadh sgrìobhte san uallach pàighidh. Seo cuid de na examples.
    • Cuir dheth eileamaid aig a bheil an gnìomh air / dheth (1 bit):DIVUS-VISION-API - Bathar-bog-fig (21)
    • Ag atharrachadh eileamaid aig a bheil an gnìomh air / dheth (1 bit). A bharrachd air an sin, ma thèid grunn òrdughan mar sin a thòiseachadh bhon aon neach-dèiligidh, is e am paramadair uuid (“ID sònraichte”, mar as trice sreang 128-bit ann an cruth hex 8-4-4-4-12) a chleachdadh gus an sònrachadh freagairt don cheist fhreagarrach, oir gheibhear am paramadair seo – ma tha e an làthair sa cheist – san fhreagairt cuideachd.DIVUS-VISION-API - Bathar-bog-fig (22)
    • A’ tionndadh air agus a’ suidheachadh soilleireachd dimmer gu 50%DIVUS-VISION-API - Bathar-bog-fig (23)
    • Is e am freagairt don chuspair a tha air a thaisbeanadh agus air a bheil ballrachd gu h-àrd (an uallach pàighidh aige, a bhith mionaideach) an uairsin, airson example.DIVUS-VISION-API - Bathar-bog-fig (24)
      Tha am freagairt gu h-àrd mar example ann an cùis uallach pàighidh ceart, ged nach eil gnìomh lasachaidh aig an eileamaid. Ma tha duilgheadasan nas miosa ann a dh’ adhbhraich nach tèid an uallach pàighidh a mhìneachadh gu ceart, seallaidh an fhreagairt mar seo (me):DIVUS-VISION-API - Bathar-bog-fig (25)
      airson mìneachadh air na còdan mearachd agus teachdaireachdan ach san fharsaingeachd, mar airson http, tha 200 còd nam freagairtean dearbhach agus tha 400 àicheil.

EXAMPLE: FOILLSEACHADH AIRSON LUACHDAN MU EILEANAN ATHARRACHADH

Tha an dòigh-obrach coltach ris an fhear a chaidh a shealltainn roimhe gus aon eileamaid atharrachadh. Is e an t-eadar-dhealachadh gu bheil thu a 'fàgail an element_id air falbh bho na cuspairean agus an uairsin a' comharrachadh an t-seata de element_ids air beulaibh an dàta taobh a-staigh an luchd pàighidh. Faic an co-chòrdadh agus an structar gu h-ìosal.DIVUS-VISION-API - Bathar-bog-fig (26)

FILTE A-STEACH A-STEACH AN T-SAOGHAL ANN AN CEISTEAN

Leigidh am paramadair sìoltachain san eallach pàighidh a-mhàin dèiligeadh ris a’ ghnìomh / na gnìomhan a tha thu ag iarraidh de eileamaid. Canar “onoff” ris a’ ghnìomh air / dheth suidse no dimmer, airson example, agus tha an sìoltachan co-fhreagarrach air a mhìneachadh san dòigh seo:DIVUS-VISION-API - Bathar-bog-fig (27)

Tha am freagairt an uairsin a’ coimhead mar seo, airson exampleDIVUS-VISION-API - Bathar-bog-fig (28)DIVUS-VISION-API - Bathar-bog-fig (29)

Tha an camagan ceàrnagach a’ nochdadh gun urrainn dhut sìoladh le grunn ghnìomhan cuideachd, meDIVUS-VISION-API - Bathar-bog-fig (30)

a’ leantainn gu freagairt mar seo:DIVUS-VISION-API - Bathar-bog-fig (31)

Pàipear-taice

CODAN ERROR

Bidh mearachdan ann an conaltradh MQTT a’ leantainn gu còd àireamhach. Tha an clàr a leanas a’ cuideachadh le bhith ga bhriseadh sìos.DIVUS-VISION-API - Bathar-bog-fig (32)

PARAMAID NA TALLA

Bidh an t-uallach pàighidh a’ toirt taic do dhiofar pharaimearan a rèir a’ cho-theacsa. Tha an clàr a leanas a’ sealltainn dè na crìochan a dh’ fhaodadh tachairt anns na cuspairean

DIVUS-VISION-API - Bathar-bog-fig (33) DIVUS-VISION-API - Bathar-bog-fig (34) DIVUS-VISION-API - Bathar-bog-fig (35)

NOTAICHEAN VERSION

  • TIONNDADH 1.00

Naidheachdan:

• A' chiad fhoillseachadh

Sgrìobhainnean/Goireasan

Bathar-bog DIVUS VISION API [pdfLeabhar-làimhe an neach-cleachdaidh
Bathar-bog VISION API, bathar-bog API, bathar-bog
Bathar-bog DIVUS Vision API [pdfStiùireadh Cleachdaiche
Bathar-bog Vision API, Vision, Bathar-bog API, Bathar-bog

Iomraidhean

Fàg beachd

Cha tèid do sheòladh puist-d fhoillseachadh. Tha raointean riatanach air an comharrachadh *