DIVUS-VISION-logo......

DIVUS VISION API Software

DIVUS-VISION-API-Software-PRODOTT

Speċifikazzjonijiet

  • Prodott: DIVUS VISION API
  • Manifattur: DIVUS GmbH
  • Verżjoni: 1.00 REV0 1 – 20240528
  • Post: Pillhof 51, Eppan (BZ), l-Italja

Informazzjoni dwar il-Prodott

L-API DIVUS VISION hija għodda ta 'softwer iddisinjata għall-interfacing mas-sistemi DIVUS VISION. Jippermetti lill-utenti jaċċessaw u jikkontrollaw diversi elementi fis-sistema billi jużaw protokolli MQTT.

FAQ

Q: Nista' nuża l-API DIVUS VISION mingħajr għarfien minn qabel tat-teknoloġija tal-PC jew tal-awtomazzjoni?

A: Il-manwal huwa mfassal apposta għal utenti b'għarfien preċedenti f'dawn l-oqsma biex jiġi żgurat użu effiċjenti tal-API.

INFORMAZZJONI ĠENERALI

  • DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – L-Italja

L-istruzzjonijiet tat-tħaddim, il-manwali u s-softwer huma protetti bid-drittijiet tal-awtur. Id-drittijiet kollha riżervati. L-ikkuppjar, id-duplikazzjoni, it-traduzzjoni, it-traduzzjoni sħiħa jew parzjali mhix permessa. Eċċezzjoni tapplika għall-ħolqien ta' kopja ta' backup tas-softwer għall-użu personali.
Il-manwal huwa soġġett għal bidla mingħajr avviż. Ma nistgħux niggarantixxu li d-dejta li tinsab f'dan id-dokument u fuq il-midja tal-ħażna fornuta hija ħielsa minn żbalji u korretta. Suġġerimenti għal titjib kif ukoll ħjiel dwar żbalji huma dejjem milqugħa. Il-ftehimiet japplikaw ukoll għall-annessi speċifiċi għal dan il-manwal. Id-denominazzjonijiet f'dan id-dokument jistgħu jkunu trademarks li l-użu tagħhom minn partijiet terzi għall-iskopijiet tagħhom stess jista' jikser id-drittijiet tas-sidien tagħhom. Istruzzjonijiet għall-utent: Jekk jogħġbok aqra dan il-manwal qabel tużah għall-ewwel darba u żommu f'post sigur għal referenza futura. Grupp fil-mira: Il-manwal huwa miktub għal utenti b'għarfien preċedenti tat-teknoloġija tal-PC u l-awtomazzjoni.

KONVENZJONIJIET TA' PREŻENTAZZJONIDIVUS-VISION-API -Software-fig (1)

Introduzzjoni

INTRODUZZJONI ĠENERALI

Dan il-manwal jiddeskrivi l-API VISION (Application Programming Interface) – interface li permezz tiegħu VISION tista’ tiġi indirizzata u kkontrollata minn sistemi esterni.
F'termini prattiċi, dan ifisser li tista 'tuża sistemi bħal

biex jikkontrollaw l-elementi ġestiti minn VISION jew jaqraw l-istatus tagħhom. L-aċċess u l-komunikazzjoni jsiru permezz tal-protokoll MQTT, li juża l-hekk imsejħa suġġetti biex jindirizza funzjonijiet individwali jew settijiet ta’ funzjonijiet jew biex jiġi infurmat dwar bidliet fihom. Għal dan il-għan jintuża server MQTT (sensar), li jieħu ħsieb is-sigurtà u l-ġestjoni/distribuzzjoni tal-messaġġi lill-parteċipanti. F'dan il-każ, is-server MQTT jinsab direttament fuq id-DIVUS KNX IQ u huwa kkonfigurat apposta għal dan il-għan. Għalkemm l-API VISION tista 'tintuża wkoll mingħajr għarfien ta' programmar, din il-funzjonalità hija adattata għal utenti avvanzati.

PREKWIŻITI

Kif spjegat fil-manwal tal-VISION, l-utent tal-API għandu awtomatikament l-ewwel jiġi attivat sabiex ikun jista’ jużah l-aċċess tal-API jaħdem biss bl-użu tad-dejta tal-awtentikazzjoni tal-utenti tal-Api. Safejn huma kkonċernati d-drittijiet tal-utent, l-attivazzjoni għal din il-funzjonalità tista’ mbagħad tiġi kkonfigurata jew fuq l-elementi kollha jew fuq l-elementi individwali. Ara Kap.0. Naturalment, għandek bżonn ukoll proġett VISION li fih l-elementi li trid tikkontrolla minn barra huma kkonfigurati bis-sħiħ u l-konnessjoni magħhom tkun ġiet ittestjata b'suċċess. Biex ikunu jistgħu jindirizzaw elementi individwali permezz tal-API, l-ID tal-element tagħhom irid ikun magħruf: dan jidher fil-qiegħ tal-formola tas-settings tal-element

SIGURTÀ

Għal raġunijiet ta' sigurtà, l-aċċess għall-API huwa possibbli biss lokalment (jiġifieri mhux permezz tal-cloud). Ir-riskju tas-sigurtà meta jiġi attivat l-aċċess API huwa għalhekk baxx. Madankollu, elementi rilevanti għas-sigurtà m'għandhomx ikunu attivati ​​jew miċħuda b'mod espliċitu għall-aċċess API.

L-MQTT U IT-TERMINI TAGĦHA – SPJEGAZZJONI QOSOR

  • DIVUS-VISION-API -Software-fig (2)Fl-MQTT, ir-rwol ta 'ġestjoni ċentralizzata u distribuzzjoni tal-messaġġi kollha huwa dak tas-sensar. Għalkemm is-server MQTT u s-sensar MQTT mhumiex sinonimi (server huwa terminu usa 'għal rwol li l-klijenti MQTT jistgħu wkoll ikollhom), is-sensar huwa dejjem maħsub f'dan il-manwal meta jissemma s-server MQTT. Id-DIVUS KNX IQ innifsu għandu r-rwol ta' broker MQTT / server MQTT fil-kuntest ta' dan il-manwal.
  • DIVUS-VISION-API -Software-fig (3)Server MQTT juża l-hekk imsejħa suġġetti: struttura ġerarkika li biha d-dejta tiġi kategorizzata, ġestita u ppubblikata.
  • DIVUS-VISION-API -Software-fig (4)Il-pubblikazzjoni għandha l-għan primarju li tagħmel id-dejta disponibbli għal parteċipanti oħra permezz ta’ suġġetti. Jekk trid tibdel valur, tikteb fuq is-suġġett mixtieq flimkien mal-bidla fil-valur mixtieq, billi tuża wkoll azzjoni ta 'pubblikazzjoni. L-apparat fil-mira jew is-server MQTT jaqra l-bidla mixtieqa li taffettwaha u jadottaha kif xieraq. Biex tiċċekkja li l-bidla ġiet applikata, tista 'tfittex fis-suġġett f'ħin reali sottoskritt biex tara jekk il-bidla hijiex riflessa hemmhekk - jekk kollox ikun marret tajjeb.
  • DIVUS-VISION-API -Software-fig (5)Il-klijenti jagħżlu s-suġġetti li jinteressawhom: dan jissejjaħ abbonament. Kull darba li valur jinbidel fi/taħt suġġett, il-klijenti kollha sottoskritti jiġu infurmati – jiġifieri mingħajr ma jkollhom għalfejn jistaqsu b’mod espliċitu jekk xi ħaġa nbidlitx jew x’inhu l-valur attwali.
  • DIVUS-VISION-API -Software-fig (6)Tista' tiftaħ (jew tindirizza) kanal ta' komunikazzjoni separat mas-server MQTT billi ddaħħal kwalunkwe string unika msejħa client_id f'suġġett. Il-client_id għandu jintuża fis-suġġett biex jipproċessa l-valuri. Dan iservi biex jidentifika l-oriġini ta 'kull bidla, jgħin bi kwalunkwe żball u ma jaffettwax lill-klijenti l-oħra, peress li r-risposti korrispondenti mis-server, inklużi kwalunkwe kodiċi ta' żball u messaġġi, jilħqu wkoll is-suġġett biss bl-istess client_id (u għalhekk biss dak il-klijent). Il-client_id hija sekwenza ta' karattri unika li tikkonsisti fi kwalunkwe kombinazzjoni tal-karattri 0-9, az, AZ, “-“, “_”.
  • DIVUS-VISION-API -Software-fig (7)B'mod ġenerali, is-suġġetti tas-sottoskrizzjoni tas-server MQTT tad-DIVUS KNX IQ fihom l-istatus tal-kelma prinċipali, filwaqt li s-suġġetti tal-pubblikazzjoni fihom it-talba tal-kelma prinċipali. Dawk bi status jiġu aġġornati awtomatikament hekk kif ikun hemm bidla fil-valur estern jew hekk kif bidla fil-valur tkun ġiet mitluba mill-klijent innifsu permezz ta' pubblikazzjoni u tkun ġiet applikata b'suċċess. Dawk għall-pubblikazzjoni huma aktar maqsuma f'dawk tat-tip (request/)get u dawk tat-tip (request/)set.
  • DIVUS-VISION-API -Software-fig (8)Bidliet fil-valur u parametri oħra fakultattivi huma miżjuda mas-suġġett bl-hekk imsejħa payload. Il-parametri tal-elementi individwali (element-id, isem, tip, funzjonijiet)

Id-differenza ewlenija bejn l-MQTT u l-mudell klassiku tal-klijent-server, fejn il-klijent jitlob u mbagħad jibdel id-dejta, hija ċċentrata fuq il-kunċetti ta’ abbonament u pubblikazzjoni. Il-parteċipanti jistgħu jippubblikaw data, u jagħmluha disponibbli għal oħrajn, li jekk ikunu interessati jistgħu jissottoskrivu magħha. Din l-arkitettura tagħmilha possibbli li jiġi minimizzat l-iskambju tad-dejta u xorta jżomm lill-partijiet interessati kollha aġġornati. Aktar dwar id-dettalji hawn: u parametri speċjali (uuid, filtri) għandhom jintużaw hawn. Għalkemm hemm diversi għażliet, il-payload tidher ifformattjata bħala JSON f'dan il-manwal. JSON juża parentesi u virgoli biex jirrappreżenta data ta 'kwalunkwe struttura u b'hekk jimminimizza d-daqs tal-pakketti tad-data li għandhom jiġu trażmessi. Aktar dettalji dwar it-tagħbijiet jistgħu jinstabu aktar tard fil-manwal.

  • DIVUS-VISION-API -Software-fig (9)Għal skopijiet speċjali, huwa possibbli li tiġi ffiltrata skont it-tip ta' funzjoni, eż. li jiġu indirizzati biss mixgħul/mitfi jiġifieri swiċċijiet ta' 1-bit. Il-parametru tal-filtri fil-payload jintuża għal dan il-għan. L-iffiltrar bħalissa huwa possibbli biss skont it-tip ta' funzjoni.
  • DIVUS-VISION-API -Software-fig (10)Biex ikunu jistgħu jindirizzaw elementi individwali, l-ID tal-element tagħhom hija meħtieġa. Dan jista 'jinstab fil-VIŻJONI fil-menu tal-proprjetajiet tal-element jew jista' jinqara wkoll direttament mid-dejta li tintwera quddiem kull element disponibbli fis-sottoskrizzjoni ġenerali tal-MQTT Explorer (l-elementi hemm huma elenkati alfabetikament skont l-ID tal-element).

DIVUS-VISION-API -Software-fig (11)

Konfigurazzjoni għall-aċċess API

KONFIGURAZZJONI TAL-VIŻJONI GĦALL-AĊĊESS TAL-UTENTI API

Fil-VIŻJONI bħala amministratur, mur Konfigurazzjoni – Ġestjoni tal-Aċċess tal-Utent/API, ikklikkja fuq Utenti/aċċess tal-API u kklikkja bil-lemin fuq Utent tal-API (jew agħfas u żomm) biex tiftaħ it-tieqa tal-editjar. Hemmhekk issib dawn il-parametri u d-data

  • Ippermetti (checkbox)
    • L-utent huwa l-ewwel attivat hawn. Default huwa diżattivat
  • Isem tal-utent
    • Din is-sekwenza hija meħtieġa għall-aċċess permezz tal-API – ikkopjaha minn hawn
  • Password
    • Din is-sekwenza hija meħtieġa għall-aċċess permezz tal-API – ikkopjaha minn hawn
  • Permessi
    • Id-drittijiet awtomatiċi għall-qari u l-kitba tal-valuri tal-elementi VISION jistgħu jiġu definiti hawn, jiġifieri dak li huwa definit hawn japplika għall-elementi kollha eżistenti u futuri. Jekk trid tippermetti biss aċċess għal elementi individwali, m'għandekx tibdel dawn id-drittijiet awtomatiċi

PERMESSI FUQ ELEMENTI INDIVIDWALI

Huwa rakkomandat li ma tagħtix aċċess API għall-proġett kollu, iżda biss għall-elementi mixtieqa. Ipproċedi kif ġej

  1. idħol f'VISION bħala amministratur
  2. agħżel l-element mixtieq u iftaħ il-menu tas-settings tiegħu (ikklikkja bil-lemin jew żomm ippressat, imbagħad Settings)
  3. taħt l-entrata tal-menu Ġenerali - Permessi, attiva "Ibdel il-permessi default" u mbagħad mur fis-sub-oġġett Permessi, li turi l-matriċi tal-permessi.DIVUS-VISION-API -Software-fig (12)
  4. jattiva l-permess tal-kontroll hawn, li jippermetti wkoll il- view permess direttament. Jekk trid taqra d-dejta biss permezz tal-aċċess API, huwa biżżejjed li tippermetti l- view permess.
  5. irrepeti l-istess proċedura għall-elementi kollha li trid taċċessa

Konnessjoni permezz tal-MQTT

INTRODUZZJONI

Bħala example, aħna ser nuru aċċess permezz tal-API MQTT tad-DIVUS KNX IQ b'softwer relattivament sempliċi u ħieles imsejjaħ MQTT Explorer (ara kap. 1.1), li huwa disponibbli għall-Windows, Mac u Linux. Għarfien bażiku u esperjenza bl-MQTT huma implikati.

DEJTA MEĦTIEĠA GĦALL-KONESSION

Kif issemma qabel (ara t-taqsima 2.1), l-isem tal-utent u l-password tal-utent tal-API huma meħtieġa. Hawnhekk hawn fuqview tad-dejta kollha li trid tinġabar qabel ma tiġi stabbilita konnessjoni:

  • Username Aqra fuq il-paġna tad-dettall tal-utent tal-API
  • Password Aqra fuq il-paġna tad-dettall tal-utent tal-API
  • Indirizz IP Aqra fis-settings tal-lanċjar taħt Ġenerali – Netwerk – Ethernet (jew permezz ta’ Synchronizer)
  • Port 8884 (dan il-port huwa riżervat għal dan il-għan)

L-EWWEL KONNESSJONI MAL-MQTT EXPLORER U SUBSCRIBE ĠENERALI

Normalment, l-MQTT tiddistingwi bejn l-attivitajiet abbona u tippubblika. MQTT Explorer jissimplifika dan billi jissottoskrivi awtomatikament għas-suġġetti kollha disponibbli (suġġett #) meta ssir l-ewwel konnessjoni. Bħala riżultat, is-siġra li twassal għall-elementi kollha disponibbli (jiġifieri aċċess għall-utent API mogħti) tista 'tidher direttament fiż-żona tax-xellug tat-tieqa tal-MQTT Explorer wara konnessjoni b'suċċess. Biex tidħol aktar suġġetti ta' abbonament jew biex tissostitwixxi l-# b'suġġett aktar speċifiku, mur Avvanzat fit-tieqa tal-konnessjoni. Is-suġġett muri fuq il-lemin ta 'fuq jidher xi ħaġa bħal din:DIVUS-VISION-API -Software-fig (13)

fejn 7f4x0607849x444xxx256573x3x9x983 huwa l-isem tal-utent tal-API u objects_list fih l-elementi kollha disponibbli. Dan is-suġġett dejjem jinżamm aġġornat jiġifieri kwalunkwe bidla fil-valur hija riflessa hemmhekk f'ħin reali. Jekk trid tabbona biss għal elementi individwali, daħħal l-ID tal-element tal-element mixtieq wara objects_list/.

Nota: Dan it-tip ta' abbonament jikkorrispondi bejn wieħed u ieħor mal-loġika wara l-indirizzi ta' feedback KNX; juri l-istatus attwali tal-elementi u jista' jintuża biex jiċċekkja jekk il-bidliet mixtieqa ġewx applikati b'suċċess. Jekk trid taqra d-dejta biss iżda ma tbiddilhiex, dan it-tip ta' abbonament huwa biżżejjed.

Element sempliċi wieħed jidher xi ħaġa bħal din fin-notazzjoni JSONDIVUS-VISION-API -Software-fig (14)

Nota: Il-valuri kollha għandhom is-sintassi murija hawn fuq eż. { “valur”: “1” } bħala l-output tas-suġġetti ta’ sottoskrizzjoni, filwaqt li l-valur jinkiteb direttament fil-payload biex jibdel valur (jiġifieri għal suġġetti ta’ pubblikazzjoni) – il-parentesi u “valur” jitħallew barra eż. “onoff”: “1”.

Kmandi avvanzati

INTRODUZZJONI

Hemm 3 tipi ta’ suġġetti b’mod ġenerali:

  1. Abbona suġġett(i) biex tara l-elementi disponibbli u biex tikseb bidliet fil-valur f'ħin reali
  2. Abbona suġġett(i) biex tikseb it-tweġibiet għal (il-klijenti ) jippubblikaw talbiet
  3. Ippubblika suġġett(i) biex tikseb jew tissettja elementi bil-valuri tagħhom

Aktar tard ser nirreferu għal dawn it-tipi billi tuża n-numerazzjoni murija hawn (eż. suġġetti tat-tip 1, 2, 3). Aktar dettalji fit-taqsimiet li ġejjin u fil-kap. 4.2.

ABBONI SUĠĠETTI BIEX TARA L-ELEMENTI DISPONIBBLI U BIEX JIKSEB BIDLIET FIL-VALUR F’ĦIN REALI

Dawn diġà ġew deskritti

ABBONI SUĠĠETTI BIEX JIKSEB IT-TWEĠIBIET GĦAT-TALBIET TAL-PUBBLIKAZZJONI TAL-KLIJENT

Dan it-tip ta 'suġġetti huwa fakultattiv. Jippermetti li

  • tiftaħ kanal ta 'komunikazzjoni uniku mas-server MQTT billi tuża client_id arbitrarju. Aktar dwar dan fil-kap. 4.2.2
  • tikseb ir-riżultat ta 'tippubblika talbiet dwar is-suġġett korrispondenti abbonament: suċċess jew falliment b'kodiċi ta' żball u messaġġ.

Hemm suġġetti differenti biex tikseb tweġibiet biex tikseb jew biex jiġu stabbiliti kmandi tal-pubblikazzjoni. Id-differenza korrispondenti fiDIVUS-VISION-API -Software-fig (15) Ladarba tikseb is-suġġetti meħtieġa għas-sistema tiegħek dritti, tista 'tiddeċiedi li tneħħi dan il-pass u tuża direttament is-suġġetti tal-pubblikazzjoni.

 IPPUBBLIKA SUĠĠETTI BIEX JIKSEB JEW BIEX JISTISSAW ELEMENTI BIL-VALURI TAGĦHOM

Dawn is-suġġetti jużaw mogħdija simili għal dawk għall-abbonament - l-unika bidla hija l-kelma "talba" minflok l-"istatus" użat biex jissottoskrivi. Il-mogħdijiet kompluti tas-suġġett jintwerew aktar tard fil-kap. 4.2.2\ Suġġett get se jitlob li taqra l-elementi u l-valuri tas-server MQTT. It-tagħbija tista 'tintuża biex tiffiltra abbażi tat-tip ta' funzjoni tal-elementi. Suġġett stabbilit se jitlob li jinbidlu xi partijiet ta 'element, kif iddettaljat fit-tagħbija tiegħu.

PREFISS GĦALL-KMANDI U RISPOSTI KORISPONDENTI

 SPJEGAZZJONI QASIRA

Il-kmandi kollha li jintbagħtu lis-server MQTT għandhom parti inizjali komuni, jiġifieri:

DIVUS-VISION-API -Software-fig (16)

SPJEGAZZJONI DETTALJATA

Is-suġġetti f'ħin reali (tip 1) se jkollhom il-prefiss ġenerali (ara hawn fuq) imbagħad segwit minn

DIVUS-VISION-API -Software-fig (17)

orDIVUS-VISION-API -Software-fig (18)

Għall-kmandi stabbiliti, il-payload ovvjament għandha r-rwol ewlieni peress li se jkun fiha l-bidliet mixtieqa (jiġifieri valuri mibdula għall-funzjonijiet tal-element). Twissija: Qatt tuża l-għażla retain fil-kmandi tat-tip 3 tiegħek peress li tista' tikkawża problemi fuq in-naħa KNX.

EXAMPLE: PUBBLIKA GĦALL-BIDLA TAL-VALUR(I) TA' ELEMENT WIEĦED

L-aktar każ sempliċi huwa li trid tibdel il-valur ta 'wieħed mill-elementi murija mill-abbonament ġenerali.
B'mod ġenerali, il-bidla/bdil ta' funzjoni tal-VISION permezz tal-MQTT tikkonsisti fi 3 passi, li mhux kollha huma assolutament meħtieġa, iżda madankollu nirrakkomandaw li jitwettqu kif deskritt.

  1. Is-suġġett li fih il-funzjoni li rridu neditjaw huwa sottoskritt bl-użu ta' client_id personalizzat
  2. Is-suġġett għall-editjar huwa ppubblikat flimkien mat-tagħbija bil-bidliet mixtieqa bl-użu tal-client_id magħżul f'1.
  3. Biex tiċċekkja, tista' mbagħad tara t-tweġiba fis-suġġett (1.) – jiġifieri jekk (2.) ħadimx jew le
  4. Fl-abbonament ġenerali, fejn il-valuri kollha huma aġġornati meta jsiru l-bidliet, tista 'tara l-bidla(jiet) tal-valur mixtieq jekk kollox ikun ħadem tajjeb.

Il-passi biex tagħmel dan huma:

  1. agħżel client_id eż. “Divus” u daħħalha fil-mogħdija wara l-isem tal-utent tal-APIDIVUS-VISION-API -Software-fig (19)
    Dan huwa s-suġġett sħiħ għall-abbonament għall-kanal ta 'komunikazzjoni tiegħek stess mas-server MQTT. Dan jgħid lis-server fejn tistenna t-tweġibiet għall-bidliet li biħsiebek tibgħat. Innota l-istatus/sett parti li tiddefinixxi a. li hija suġġett ta' abbonament u b. li se tikseb it-tweġibiet biex tissettja kmandi tat-tip.
  2. Is-suġġett tal-pubblikazzjoni se jkun l-istess ħlief għall-bidla tal-kliem kjavi tat-talba għall-istatusDIVUS-VISION-API -Software-fig (20)
  3. fiex għandha tikkonsisti l-bidla hija miktuba fit-tagħbija. Hawn xi examples.
    • It-tifi ta' element li għandu l-funzjoni mixgħul/mitfi (bit 1):DIVUS-VISION-API -Software-fig (21)
    • Tixgħel element li għandu l-funzjoni mixgħul/mitfi (1 bit). Barra minn hekk, jekk diversi kmandi bħal dawn jinbdew mill-istess klijent, il-parametru uuid ("ID uniku", normalment huwa string ta '128-bit ifformattjat bħala 8-4-4-4-12 ċifri hex) jista' jintuża biex jassenja l- tweġiba għall-mistoqsija korrispondenti, peress li dan il-parametru – jekk preżenti fil-mistoqsija – jista’ jinstab ukoll fir-rispons.DIVUS-VISION-API -Software-fig (22)
    • Tixgħel u tissettja l-luminożità ta 'dimmer għal 50%DIVUS-VISION-API -Software-fig (23)
    • It-tweġiba għas-suġġett muri u sottoskritt hawn fuq (it-tagħbija tagħha, biex tkun preċiża) hija mbagħad, per example.DIVUS-VISION-API -Software-fig (24)
      Ir-rispons t'hawn fuq huwa example fil-każ ta 'tagħbija korretta, għalkemm l-element m'għandux funzjoni ta' dimming. Jekk ikun hemm problemi aktar serji li jwasslu biex it-tagħbija ma tiġix interpretata b'mod korrett, ir-rispons jidher bħal dan (eż.):DIVUS-VISION-API -Software-fig (25)
      għal spjegazzjoni tal-kodiċijiet tal-iżball u l-messaġġi iżda b'mod ġenerali, bħal għal http, 200 kodiċi huma tweġibiet pożittivi filwaqt li 400 huma negattivi.

EXAMPLE: IPPUBBLIKA GĦALL-BIDLA TAL-VALURI TA' ELEMENTI MULTIPLI

Il-proċedura hija simili għal dik murija qabel biex tbiddel element wieħed. Id-differenza hija li tħalli barra l-element_id mis-suġġetti u mbagħad tindika s-sett ta 'element_ids quddiem id-dejta ġewwa l-payload. Ara s-sintassi u l-istruttura hawn taħt.DIVUS-VISION-API -Software-fig (26)

Iffiltra SKOND TIP TA' FUNZJONI FI MISTOQSIJIET

Il-parametru tal-filtri fil-payload jippermetti biss li tiġi indirizzata l-funzjoni(jiet) mixtieqa ta' element. Il-funzjoni mixgħul/mitfi ta 'swiċċ jew dimmer tissejjaħ "onoff", pereżempjuample, u l-filtru korrispondenti huwa definit b'dan il-mod:DIVUS-VISION-API -Software-fig (27)

It-tweġiba mbagħad tidher bħal din, pereżempjuampleDIVUS-VISION-API -Software-fig (28)DIVUS-VISION-API -Software-fig (29)

Il-parentesi kwadra tindika li tista' wkoll tiffiltra b'diversi funzjonijiet, eżDIVUS-VISION-API -Software-fig (30)

twassal għal tweġiba bħal din:DIVUS-VISION-API -Software-fig (31)

Appendiċi

KODIĊIJIET TA 'ŻBALL

Żbalji fil-komunikazzjoni MQTT jirriżultaw f'kodiċi numeriku. It-tabella li ġejja tgħin biex tkisser.DIVUS-VISION-API -Software-fig (32)

PARAMETRI TAT-TAGĦBIJA

It-tagħbija tappoġġja parametri differenti skont il-kuntest. It-tabella li ġejja turi liema parametri jistgħu jseħħu f'liema suġġetti

DIVUS-VISION-API -Software-fig (33) DIVUS-VISION-API -Software-fig (34) DIVUS-VISION-API -Software-fig (35)

NOTI TAL-VERŻJONI

  • VERŻJONI 1.00

Aħbarijiet:

• L-ewwel pubblikazzjoni

Dokumenti / Riżorsi

DIVUS VISION API Software [pdfManwal tal-Utent
VIŻJONI API Software, API Software, Software
DIVUS Vision API Software [pdfGwida għall-Utent
Viżjoni API Software, Viżjoni, API Software, Software

Referenzi

Ħalli kumment

L-indirizz elettroniku tiegħek mhux se jiġi ppubblikat. L-oqsma meħtieġa huma mmarkati *