DIVUS-VISION-logo......

Meddalwedd API DIVUS VISION

DIVUS-VISION-API-Meddalwedd-CYNNYRCH

Manylebau

  • Cynnyrch: DIVUS VISION API
  • Gwneuthurwr: DIVUS GmbH
  • Fersiwn: 1.00 REV0 1 – 20240528
  • Lleoliad: Pillhof 51, Eppan (BZ), yr Eidal

Gwybodaeth Cynnyrch

Offeryn meddalwedd yw'r DIVUS VISION API a ddyluniwyd ar gyfer rhyngwynebu â systemau DIVUS VISION. Mae'n galluogi defnyddwyr i gyrchu a rheoli amrywiol elfennau o fewn y system gan ddefnyddio protocolau MQTT.

FAQ

C: A allaf ddefnyddio'r API DIVUS VISION heb wybodaeth flaenorol am gyfrifiadur personol neu dechnoleg awtomeiddio?

A: Mae'r llawlyfr wedi'i deilwra ar gyfer defnyddwyr sydd â gwybodaeth flaenorol yn y meysydd hyn i sicrhau defnydd effeithlon o'r API.

GWYBODAETH GYFFREDINOL

  • DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – Yr Eidal

Mae cyfarwyddiadau gweithredu, llawlyfrau a meddalwedd yn cael eu diogelu gan hawlfraint. Cedwir pob hawl. Ni chaniateir copïo, dyblygu, cyfieithu, cyfieithu yn gyfan gwbl nac yn rhannol. Mae eithriad yn berthnasol i greu copi wrth gefn o'r feddalwedd at ddefnydd personol.
Gall y llawlyfr newid heb rybudd. Ni allwn warantu bod y data a gynhwysir yn y ddogfen hon ac ar y cyfrwng storio a ddarparwyd yn rhydd o wallau ac yn gywir. Mae croeso bob amser i awgrymiadau ar gyfer gwelliannau yn ogystal ag awgrymiadau ar gamgymeriadau. Mae'r cytundebau hefyd yn berthnasol i'r atodiadau penodol i'r llawlyfr hwn. Gall y dynodiadau yn y ddogfen hon fod yn nodau masnach y gallai eu defnyddio gan drydydd partïon at eu dibenion eu hunain darfu ar hawliau eu perchnogion. Cyfarwyddiadau defnyddiwr: Darllenwch y llawlyfr hwn cyn ei ddefnyddio am y tro cyntaf a'i gadw mewn lle diogel i gyfeirio ato yn y dyfodol. Grŵp targed: Mae'r llawlyfr wedi'i ysgrifennu ar gyfer defnyddwyr sydd â gwybodaeth flaenorol am gyfrifiaduron personol a thechnoleg awtomeiddio.

CONTENTIONS CYFLWYNODIVUS-VISION-API - Meddalwedd-ffig (1)

Rhagymadrodd

RHAGARWEINIAD CYFFREDINOL

Mae'r llawlyfr hwn yn disgrifio'r API VISION (Rhyngwyneb Rhaglennu Cymhwysiad) - rhyngwyneb y gellir ei ddefnyddio i fynd i'r afael â VISION a'i reoli o systemau allanol.
Yn ymarferol, mae hyn yn golygu y gallwch ddefnyddio systemau fel

i reoli'r elfennau a reolir gan VISION neu ddarllen eu statws. Mae mynediad a chyfathrebu yn digwydd trwy'r protocol MQTT, sy'n defnyddio'r hyn a elwir yn bynciau i fynd i'r afael â swyddogaethau unigol neu setiau o swyddogaethau neu i gael gwybod am newidiadau iddynt. Defnyddir gweinydd MQTT (brocer) at y diben hwn, sy'n ymdrin â diogelwch a rheoli/dosbarthu negeseuon i'r cyfranogwyr. Yn yr achos hwn, mae'r gweinydd MQTT wedi'i leoli'n uniongyrchol ar y DIVUS KNX IQ ac mae wedi'i ffurfweddu'n arbennig at y diben hwn. Er y gellir defnyddio'r API VISION hefyd heb wybodaeth raglennu, mae'r swyddogaeth hon yn addas ar gyfer defnyddwyr uwch.

RHAGOFYNION

Fel yr eglurwyd yn y llawlyfr VISION, yn ddiofyn rhaid i'r defnyddiwr API gael ei actifadu yn gyntaf er mwyn gallu ei ddefnyddio, dim ond gan ddefnyddio data dilysu defnyddwyr Api y mae mynediad API yn gweithio. Cyn belled ag y mae hawliau defnyddwyr yn y cwestiwn, yna gellir ffurfweddu'r actifadu ar gyfer y swyddogaeth hon naill ai ar bob un neu ar elfennau unigol. Gwel Chap.0. Wrth gwrs, mae angen prosiect VISION arnoch hefyd lle mae'r elfennau rydych chi am eu rheoli o'r tu allan wedi'u ffurfweddu'n llawn ac mae'r cysylltiad â nhw wedi'i brofi'n llwyddiannus. Er mwyn gallu mynd i'r afael ag elfennau unigol trwy'r API, rhaid bod yn hysbys eu ID elfen: dangosir hwn ar waelod ffurflen gosodiadau'r elfen

DIOGELWCH

Am resymau diogelwch, dim ond yn lleol y mae mynediad API yn bosibl (hy nid trwy'r cwmwl). Felly mae'r risg diogelwch wrth actifadu mynediad API yn isel. Serch hynny, ni ddylai elfennau sy'n berthnasol i ddiogelwch gael eu galluogi na'u gwrthod yn benodol ar gyfer mynediad API.

MQTT A'I THERMAU – ESBONIAD BYR

  • DIVUS-VISION-API - Meddalwedd-ffig (2)Yn MQTT, rôl y brocer yw rheoli a dosbarthu'r holl negeseuon yn ganolog. Er nad yw gweinydd MQTT a brocer MQTT yn gyfystyron (mae gweinydd yn derm ehangach ar gyfer rôl y gall cleientiaid MQTT ei chwarae hefyd), mae'r brocer bob amser yn cael ei olygu yn y llawlyfr hwn pan grybwyllir gweinydd MQTT. Mae'r DIVUS KNX IQ ei hun yn chwarae rôl brocer MQTT / gweinydd MQTT yng nghyd-destun y llawlyfr hwn.
  • DIVUS-VISION-API - Meddalwedd-ffig (3)Mae gweinydd MQTT yn defnyddio'r hyn a elwir yn bynciau: strwythur hierarchaidd ar gyfer categoreiddio, rheoli a chyhoeddi data.
  • DIVUS-VISION-API - Meddalwedd-ffig (4)Prif nod cyhoeddi yw sicrhau bod data ar gael i gyfranogwyr eraill trwy bynciau. Os ydych chi am newid gwerth, rydych chi'n ysgrifennu at y pwnc a ddymunir ynghyd â'r newid gwerth dymunol, gan ddefnyddio gweithred cyhoeddi hefyd. Mae'r ddyfais darged neu'r gweinydd MQTT yn darllen y newid a ddymunir sy'n effeithio arno ac yn ei fabwysiadu yn unol â hynny. I wirio bod y newid wedi'i gymhwyso, gallwch edrych yn y pwnc amser real tanysgrifiedig i weld a yw'r newid yn cael ei adlewyrchu yno - os yw popeth wedi gweithio'n iawn.
  • DIVUS-VISION-API - Meddalwedd-ffig (5)Mae cleientiaid yn dewis y pynciau sydd o ddiddordeb iddynt: gelwir hyn yn danysgrifio. Bob tro y mae gwerth yn newid o fewn/o dan bwnc, hysbysir pob cleient sydd wedi tanysgrifio – hy heb orfod gofyn yn benodol a oes rhywbeth wedi newid neu beth yw ei werth presennol.
  • DIVUS-VISION-API - Meddalwedd-ffig (6)Gallwch agor (neu fynd i'r afael â) sianel gyfathrebu ar wahân gyda'r gweinydd MQTT trwy nodi unrhyw linyn unigryw o'r enw client_id mewn pwnc. Rhaid defnyddio'r client_id yn y pwnc i brosesu gwerthoedd. Mae hyn yn nodi tarddiad pob newid, yn helpu gydag unrhyw wallau ac nid yw'n effeithio ar y cleientiaid eraill, gan fod yr ymatebion cyfatebol gan y gweinydd, gan gynnwys unrhyw godau gwall a negeseuon, hefyd yn cyrraedd y pwnc gyda'r un client_id yn unig (ac felly yn unig y cleient hwnnw). Mae'r client_id yn llinyn cymeriad unigryw sy'n cynnwys unrhyw gyfuniad o'r cymeriadau 0-9, az, AZ, “-“, “_”.
  • DIVUS-VISION-API - Meddalwedd-ffig (7)Yn gyffredinol, mae pynciau tanysgrifio gweinydd MQTT y DIVUS KNX IQ yn cynnwys y statws allweddair, tra bod y pynciau cyhoeddi yn cynnwys y cais allweddair. Mae'r rhai sydd â statws yn cael eu diweddaru'n awtomatig cyn gynted ag y bydd newid gwerth allanol neu cyn gynted ag y bydd y cleient ei hun wedi gofyn am newid gwerth trwy gyhoeddiad ac wedi'i gymhwyso'n llwyddiannus. Rhennir y rhai ar gyfer cyhoeddi ymhellach yn rhai o'r math (cais/)cael a'r rhai o'r math (cais/)set.
  • DIVUS-VISION-API - Meddalwedd-ffig (8)Mae newidiadau gwerth a pharamedrau dewisol eraill yn cael eu hychwanegu at y pwnc gyda'r llwyth tâl fel y'i gelwir. Paramedrau'r elfennau unigol (elfen-id, enw, math, ffwythiannau)

Mae'r prif wahaniaeth rhwng MQTT a'r model cleient-gweinydd clasurol, lle mae'r cleient yn gofyn am ddata ac yna'n ei newid, yn canolbwyntio ar y cysyniadau o danysgrifio a chyhoeddi. Gall cyfranogwyr gyhoeddi data, gan sicrhau ei fod ar gael i eraill, a all, os oes ganddynt ddiddordeb, danysgrifio iddo. Mae'r bensaernïaeth hon yn ei gwneud hi'n bosibl lleihau cyfnewid data a pharhau i roi'r wybodaeth ddiweddaraf i bawb sydd â diddordeb. Mwy am y manylion yma: a pharamedrau arbennig (uuid, hidlwyr) i'w defnyddio yma. Er bod sawl opsiwn, dangosir y llwyth tâl wedi'i fformatio fel JSON yn y llawlyfr hwn. Mae JSON yn defnyddio cromfachau a choma i gynrychioli data o unrhyw strwythur ac felly'n lleihau maint y pecynnau data sydd i'w trosglwyddo. Ceir rhagor o fanylion am lwythi tâl yn ddiweddarach yn y llawlyfr.

  • DIVUS-VISION-API - Meddalwedd-ffig (9)At ddibenion arbennig, mae'n bosibl hidlo yn ôl y math o swyddogaeth, ee i fynd i'r afael yn unig ymlaen / i ffwrdd hy switshis 1-did. Defnyddir y paramedr hidlwyr yn y llwyth tâl at y diben hwn. Dim ond yn ôl math o swyddogaeth y mae hidlo'n bosibl ar hyn o bryd.
  • DIVUS-VISION-API - Meddalwedd-ffig (10)Er mwyn gallu mynd i'r afael ag elfennau unigol, mae angen eu ID elfen. Gellir dod o hyd i hwn yn VISION yn y ddewislen priodweddau elfen neu gellir ei ddarllen hefyd yn uniongyrchol o'r data sy'n cael ei arddangos o flaen pob elfen sydd ar gael yn y tanysgrifiad cyffredinol o'r MQTT Explorer (mae elfennau yno wedi'u rhestru yn nhrefn yr wyddor yn ôl ID elfen).

DIVUS-VISION-API - Meddalwedd-ffig (11)

Ffurfweddiad ar gyfer mynediad API

Ffurfweddu GWELEDIGAETH AR GYFER MYNEDIAD I DDEFNYDDWYR API

Yn VISION fel gweinyddwr, ewch i Ffurfweddu - Rheoli Mynediad Defnyddiwr / API, cliciwch ar Mynediad Defnyddwyr / API a de-gliciwch ar API Defnyddiwr (neu pwyswch a dal) i agor y ffenestr olygu. Yma fe welwch y paramedrau a'r data hyn

  • Galluogi (blwch ticio)
    • Mae'r defnyddiwr yn cael ei alluogi gyntaf yma. Mae'r rhagosodiad wedi'i analluogi
  • Enw defnyddiwr
    • Mae angen y llinyn hwn ar gyfer mynediad trwy API - copïwch ef o'r fan hon
  • Cyfrinair
    • Mae angen y llinyn hwn ar gyfer mynediad trwy API - copïwch ef o'r fan hon
  • Caniatadau
    • Gellir diffinio'r hawliau rhagosodedig ar gyfer darllen ac ysgrifennu gwerthoedd yr elfennau GWELEDIGAETH yma, hy mae'r hyn a ddiffinnir yma yn berthnasol i'r holl elfennau presennol ac yn y dyfodol. Os mai dim ond i ganiatáu mynediad i elfennau unigol yr ydych am, ni ddylech newid yr hawliau rhagosodedig hyn

CANIATÂDAU AR ELFENNAU UNIGOL

Argymhellir nad ydych yn caniatáu mynediad API i'r prosiect cyfan, ond dim ond i'r elfennau dymunol. Ewch ymlaen fel a ganlyn

  1. mewngofnodwch i VISION fel gweinyddwr
  2. dewiswch yr elfen a ddymunir ac agorwch ei ddewislen gosodiadau (cliciwch ar y dde neu daliwch i bwyso, yna Gosodiadau)
  3. o dan y cofnod dewislen Cyffredinol - Caniatâd, actifadwch “Diystyru caniatâd diofyn” ac yna ewch i'r is-eitem Caniatâd, sy'n dangos y matrics caniatâd.DIVUS-VISION-API - Meddalwedd-ffig (12)
  4. actifadu'r caniatâd rheoli yma, sydd hefyd yn galluogi'r view caniatâd yn uniongyrchol. Os ydych chi eisiau darllen data trwy'r mynediad API yn unig, mae'n ddigon i alluogi'r view caniatad.
  5. ailadrodd yr un drefn ar gyfer yr holl elfennau yr ydych am gael mynediad iddynt

Cysylltiad trwy MQTT

RHAGARWEINIAD

Fel cynample, byddwn yn dangos mynediad trwy'r API MQTT o'r DIVUS KNX IQ gyda meddalwedd cymharol syml, rhad ac am ddim o'r enw MQTT Explorer (gweler pennod 1.1), sydd ar gael ar gyfer Windows, Mac a Linux. Awgrymir gwybodaeth a phrofiad sylfaenol gyda MQTT.

DATA ANGENRHEIDIOL AR GYFER Y CYSYLLTIAD

Fel y soniwyd yn gynharach (gweler adran 2.1), mae angen enw defnyddiwr a chyfrinair defnyddiwr API. Dyma drosoddview o’r holl ddata y mae’n rhaid ei gasglu cyn sefydlu cysylltiad:

  • Enw Defnyddiwr Darllenwch allan ar dudalen fanylion y defnyddiwr API
  • Cyfrinair Darllenwch allan ar dudalen fanylion y defnyddiwr API
  • Cyfeiriad IP Darllenwch allan yn y gosodiadau lansiwr o dan Cyffredinol – Rhwydwaith – Ethernet (neu drwy Synchronizer)
  • Porthladd 8884 (mae'r porthladd hwn wedi'i gadw at y diben hwn)

CYSYLLTIAD CYNTAF GYDA MQTT EXPLORER A TANYSGRIFIAD CYFFREDINOL

Fel arfer, mae MQTT yn gwahaniaethu rhwng y gweithgareddau tanysgrifio a chyhoeddi. Mae MQTT Explorer yn symleiddio hyn trwy danysgrifio'n awtomatig i'r holl bynciau sydd ar gael (pwnc #) pan wneir y cysylltiad cyntaf. O ganlyniad, gellir gweld y goeden sy'n arwain at yr holl elfennau sydd ar gael (hy mynediad defnyddiwr API a roddwyd) yn uniongyrchol yn rhan chwith ffenestr MQTT Explorer ar ôl cysylltiad llwyddiannus. I fynd i mewn i bynciau tanysgrifio pellach neu i ddisodli'r # â phwnc mwy penodol, ewch i Uwch yn y ffenestr cysylltiad. Mae'r pwnc a ddangosir ar y dde uchaf yn edrych rhywbeth fel hyn:DIVUS-VISION-API - Meddalwedd-ffig (13)

lle mae 7f4x0607849x444xxx256573x3x9x983 yn enw defnyddiwr API ac mae object_list yn cynnwys yr holl elfennau sydd ar gael. Mae'r pwnc hwn bob amser yn cael ei gadw'n gyfredol hy mae unrhyw newidiadau gwerth yn cael eu hadlewyrchu yno mewn amser real. Os ydych chi eisiau tanysgrifio i elfennau unigol yn unig, rhowch ID elfen yr elfen ddymunol ar ôl gwrthrychau_list/.

Nodyn: Mae'r math hwn o danysgrifio yn cyfateb yn fras i'r rhesymeg y tu ôl i'r cyfeiriadau adborth KNX; mae'n dangos statws cyfredol yr elfennau a gellir ei ddefnyddio i wirio a yw'r newidiadau dymunol wedi'u cymhwyso'n llwyddiannus. Os ydych chi eisiau darllen data yn uchel ond heb ei newid, mae'r math hwn o danysgrifio yn ddigon .

Mae un elfen syml yn edrych rhywbeth fel hyn yn nodiant JSONDIVUS-VISION-API - Meddalwedd-ffig (14)

Nodyn: Mae gan bob gwerth y gystrawen a ddangosir uchod ee { “gwerth”: “1” } fel allbwn y testunau tanysgrifio, tra bod y gwerth wedi'i ysgrifennu'n uniongyrchol yn y llwyth tâl i newid gwerth (hy ar gyfer testunau cyhoeddi) - y cromfachau a hepgorir “gwerth” ee “onoff”: “1”.

Advanced commands

RHAGARWEINIAD

Mae yna 3 math o bwnc yn gyffredinol:

  1. Tanysgrifiwch bwnc(pynciau) i weld yr elfennau sydd ar gael ac i gael newidiadau gwerth amser real
  2. Tanysgrifiwch bwnc(au) i gael yr atebion i (the clients ) cyhoeddi ceisiadau
  3. Cyhoeddi testun(au) i gael neu i osod elfennau gyda'u gwerthoedd

Byddwn yn cyfeirio yn ddiweddarach at y mathau hyn gan ddefnyddio'r rhifau a ddangosir yma (ee testunau math 1, 2, 3). Mwy o fanylion yn yr adrannau canlynol ac ym mhennod. 4.2.

TANYSGRIFWCH BYNCIAU I WELD YR ELFENNAU SYDD AR GAEL AC I GAEL NEWIDIADAU GWERTH AMSER Real

Disgrifiwyd y rhain eisoes

TANYSGRIFWCH BYNCIAU I GAEL YR ATEBION I GEISIADAU CYHOEDDI'R CLEIENTIAID

Mae'r math hwn o bynciau yn ddewisol. Mae'n caniatáu i

  • agor sianel gyfathrebu unigryw gyda'r gweinydd MQTT trwy ddefnyddio client_id mympwyol. Mwy am hynny yn pen. 4.2.2
  • cael canlyniad ceisiadau cyhoeddi ar y pwnc tanysgrifio cyfatebol: llwyddiant neu fethiant gyda chod gwall a neges.

Mae yna wahanol bynciau i gael atebion i gael neu i osod gorchmynion cyhoeddi. Y gwahaniaeth cyfatebol ynDIVUS-VISION-API - Meddalwedd-ffig (15) Unwaith y byddwch yn cael y pynciau sydd eu hangen ar gyfer eich system yn syth, efallai y byddwch yn penderfynu dileu'r cam hwn a defnyddio pynciau cyhoeddi yn uniongyrchol.

 CYHOEDDI TESTUNAU I'W CAEL NEU GOSOD ELFENNAU GYDA EU GWERTHOEDD

Mae’r pynciau hyn yn defnyddio llwybr tebyg i’r rhai ar gyfer tanysgrifio – yr unig newid yw’r gair “cais” yn lle’r “statws” a ddefnyddir i danysgrifio. Dangosir llwybrau pwnc cyflawn yn ddiweddarach yn y pen. 4.2.2\ Bydd pwnc cael yn gofyn am ddarllen elfennau a gwerthoedd y gweinydd MQTT. Gellir defnyddio'r llwyth tâl i hidlo yn seiliedig ar fath swyddogaeth yr elfennau. Bydd pwnc gosod yn gofyn am newid rhai rhannau o elfen, fel y manylir yn ei lwyth cyflog.

RHAGAIR AM ORCHYMYNAU AC YMATEBION CYFATEBOL

 ESBONIAD BYR

Mae gan bob gorchymyn a anfonir at y gweinydd MQTT ran gychwynnol gyffredin, sef:

DIVUS-VISION-API - Meddalwedd-ffig (16)

DETAILED EXPLANATION

Bydd gan y pynciau amser real (math 1) y rhagddodiad cyffredinol (gweler uchod) ac yna

DIVUS-VISION-API - Meddalwedd-ffig (17)

orDIVUS-VISION-API - Meddalwedd-ffig (18)

Ar gyfer gorchmynion gosod, mae'r llwyth tâl yn amlwg yn chwarae'r brif rôl gan y bydd yn cynnwys y newidiadau dymunol (hy newid yng ngwerth swyddogaethau'r elfen). A Rhybudd: Peidiwch byth â defnyddio'r opsiwn cadw yn eich gorchmynion math 3 gan y gallai achosi problemau ar yr ochr KNX.

EXAMPLE: CYHOEDDI AR GYFER NEWID GWERTH(AU) UN ELFEN

Yr achos symlaf yw bod eisiau newid gwerth un o'r elfennau a ddangosir gan y tanysgrifiad cyffredinol .
Yn gyffredinol, mae newid/newid swyddogaeth VISION trwy MQTT yn cynnwys 3 cham, ac nid yw pob un ohonynt yn gwbl angenrheidiol, ond rydym serch hynny yn argymell eu cyflawni fel y disgrifir.

  1. Mae'r pwnc sy'n cynnwys y swyddogaeth rydym am ei olygu wedi'i danysgrifio gan ddefnyddio client_id wedi'i deilwra
  2. Cyhoeddir y pwnc ar gyfer golygu ynghyd â'r llwyth tâl gyda'r newidiadau dymunol gan ddefnyddio'r client_id a ddewiswyd yn 1.
  3. I wirio, gallwch weld yr ateb yn nhestun (1.) – hy a oedd (2.) wedi gweithio ai peidio
  4. Yn y tanysgrifiad cyffredinol, lle mae'r holl werthoedd yn cael eu diweddaru pan wneir newidiadau, gallwch weld y newid(iadau) gwerth dymunol os yw popeth wedi gweithio'n iawn.

The steps to do this are:

  1. dewiswch client_id ee “Divus” a'i fewnosod yn y llwybr ar ôl enw defnyddiwr yr APIDIVUS-VISION-API - Meddalwedd-ffig (19)
    Dyma'r pwnc cyflawn ar gyfer tanysgrifio i'ch sianel gyfathrebu eich hun gyda'r gweinydd MQTT. Mae hyn yn dweud wrth y gweinydd ble rydych chi'n disgwyl yr ymatebion i'r newidiadau rydych chi'n bwriadu eu hanfon. Sylwch ar y rhan statws/set sy'n diffinio a. ei fod yn bwnc tanysgrifio a b. y bydd yn cael yr atebion i osod gorchmynion math.
  2. Bydd y pwnc cyhoeddi yr un fath ac eithrio ar gyfer newid y geiriau allweddol cais statwsDIVUS-VISION-API - Meddalwedd-ffig (20)
  3. mae'r hyn y dylai'r newid ei gynnwys wedi'i ysgrifennu yn y llwyth tâl. Dyma rai o gynamples.
    • Diffodd elfen sydd â'r swyddogaeth ymlaen/diffodd (1 did):DIVUS-VISION-API - Meddalwedd-ffig (21)
    • Troi elfen ymlaen sydd â'r ffwythiant ymlaen/diffodd (1 did). Yn ogystal, os yw nifer o orchmynion o'r fath yn cael eu cychwyn gan yr un cleient, mae'r paramedr uuid (“ID unigryw”, fel arfer yn llinyn 128-did wedi'i fformatio fel hecs 8-4-4-4-12 digid) i aseinio'r ymateb i’r ymholiad cyfatebol, gan fod y paramedr hwn – os yw’n bresennol yn yr ymholiad – hefyd i’w weld yn yr ymateb.DIVUS-VISION-API - Meddalwedd-ffig (22)
    • Troi ymlaen a gosod disgleirdeb pylu i 50%DIVUS-VISION-API - Meddalwedd-ffig (23)
    • Yr ateb wedyn i'r pwnc a ddangosir ac y tanysgrifir iddo uchod (ei lwyth cyflog, i fod yn fanwl gywir) yw, ar gyfer example.DIVUS-VISION-API - Meddalwedd-ffig (24)
      Mae'r ymateb uchod yn gynample yn achos llwyth tâl cywir, er nad oes gan yr elfen unrhyw swyddogaeth pylu. Os oes problemau mwy difrifol yn arwain at beidio â dehongli'r llwyth tâl yn gywir, bydd yr ymateb yn edrych fel hyn (ee):DIVUS-VISION-API - Meddalwedd-ffig (25)
      am esboniad o'r codau gwall a'r negeseuon ond yn gyffredinol, fel http, mae 200 o godau yn atebion cadarnhaol tra bod 400 yn negyddol.

EXAMPLE: CYHOEDDI AM NEWID GWERTHOEDD ELFENNAU LLUOSOG

Mae'r weithdrefn yn debyg i'r un a ddangosir o'r blaen i newid un elfen. Y gwahaniaeth yw eich bod yn hepgor yr element_id o'r pynciau ac yna'n nodi'r set o element_ids o flaen y data y tu mewn i'r llwyth tâl. Gweler y gystrawen a'r strwythur isod.DIVUS-VISION-API - Meddalwedd-ffig (26)

hidlwch YN ÔL SWYDDOGAETH MATH MEWN YMHOLIADAU

Mae'r paramedr hidlwyr yn y llwyth tâl yn caniatáu mynd i'r afael â swyddogaeth(au) dymunol elfen yn unig. Gelwir swyddogaeth ymlaen/diffodd switsh neu pylu yn “onoff”, ar gyfer example, a diffinnir yr hidlydd cyfatebol fel hyn:DIVUS-VISION-API - Meddalwedd-ffig (27)

Mae'r ateb wedyn yn edrych fel hyn, ar gyfer exampleDIVUS-VISION-API - Meddalwedd-ffig (28)DIVUS-VISION-API - Meddalwedd-ffig (29)

Mae'r braced sgwâr yn nodi y gallwch chi hefyd hidlo yn ôl sawl swyddogaeth, eeDIVUS-VISION-API - Meddalwedd-ffig (30)

yn arwain at ateb fel hyn:DIVUS-VISION-API - Meddalwedd-ffig (31)

Atodiad

CODAU GWALL

Mae gwallau mewn cyfathrebu MQTT yn arwain at god rhifiadol. Mae'r tabl canlynol yn helpu i'w dorri i lawr.DIVUS-VISION-API - Meddalwedd-ffig (32)

PARAMEDWYR Y TALAETH

Mae'r llwyth tâl yn cefnogi gwahanol baramedrau yn dibynnu ar y cyd-destun. Mae'r tabl canlynol yn dangos pa baramedrau all ddigwydd ym mha bynciau

DIVUS-VISION-API - Meddalwedd-ffig (33) DIVUS-VISION-API - Meddalwedd-ffig (34) DIVUS-VISION-API - Meddalwedd-ffig (35)

VERSION NOTES

  • FERSIWN 1.00

Newyddion:

• Cyhoeddiad cyntaf

Dogfennau / Adnoddau

Meddalwedd API DIVUS VISION [pdfLlawlyfr Defnyddiwr
Meddalwedd API VISION, Meddalwedd API, Meddalwedd
Meddalwedd API DIVUS Vision [pdfCanllaw Defnyddiwr
Meddalwedd API Vision, Vision, Meddalwedd API, Meddalwedd

Cyfeiriadau

Gadael sylw

Ni fydd eich cyfeiriad e-bost yn cael ei gyhoeddi. Mae meysydd gofynnol wedi'u marcio *