DIVUS VISION API Software
Litlhaloso
- Sehlahisoa: DIVUS VISION API
- Moetsi: DIVUS GmbH
- Phetolelo: 1.00 REV0 1 - 20240528
- Sebaka: Pillhof 51, Eppan (BZ), Italy
Tlhahisoleseding ya Sehlahiswa
DIVUS VISION API ke sesebelisoa sa software se etselitsoeng ho hokahana le litsamaiso tsa DIVUS VISION. E lumella basebelisi ho fihlella le ho laola likarolo tse fapaneng ka har'a sistimi ba sebelisa liprothokholo tsa MQTT.
LBH
P: Na nka sebelisa DIVUS VISION API ntle le tsebo ea pele ea PC kapa theknoloji ea boiketsetso?
A: Bukana e etselitsoe basebelisi ba nang le tsebo ea pele libakeng tsena ho netefatsa ts'ebeliso e ntle ea API.
LINTLHA TSE AKARETSANG
- DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – Italy
Litaelo tsa ts'ebetso, libuka le software li sirelelitsoe ke litokelo tsa molao. Litokelo tsohle li sirelelitsoe. Ho kopitsa, ho qopitsa, ho fetolela, ho fetolela ka botlalo kapa ka karolo e itseng ha ho lumelloe. Mokhelo o sebetsa ho thehoeng ha kopi ea backup ea software bakeng sa ts'ebeliso ea motho ka mong.
Bukana e ka fetoha ntle le tsebiso. Re ke ke ra tiisa hore lintlha tse teng tokomaneng ena le mecheng ea litaba ea polokelo e fanoeng ha li na liphoso ebile li nepahetse. Litlhahiso tsa ntlafatso hammoho le likeletso mabapi le liphoso lia amoheloa. Litumellano li boetse li sebetsa ho lihlomathiso tse khethehileng tsa bukana ena. Mabitso a tokomaneng ena e kanna ea ba matšoao ao tšebeliso ea ona ke batho ba boraro molemong oa bona e ka hatakelang litokelo tsa beng ba ona. Litaelo tsa mosebelisi: Ka kopo bala bukana ena pele u e sebelisa khetlo la pele 'me u e boloke sebakeng se bolokehileng bakeng sa tšebeliso ea nako e tlang. Sehlopha sa sepheo: Bukana e ngoletsoe basebelisi ba nang le tsebo ea pele ea PC le theknoloji ea automation.
EKETSO LIKOPANO
Selelekela
KAKARETSO SELELE
Bukana ena e hlalosa VISION API (Application Programming Interface) - sebopeho seo VISION e ka sebetsanang le sona le ho laoloa ho tsoa lits'ebetsong tsa kantle.
Ka mantsoe a sebetsang, sena se bolela hore u ka sebelisa litsamaiso tse kang
- MQTT Explorer (https://www.microsoft.com/store/… - bakeng sa tlhahlobo),
- Mothusi oa Lehae (https://www.home-assistant.io/) kapa
- Node-RED (https://nodered.org/)
ho laola lintho tse laoloang ke PONO kapa ho bala boemo ba tsona. Phihlello le puisano li etsahala ka protocol ea MQTT, e sebelisang seo ho thoeng ke lihlooho ho sebetsana le mesebetsi kapa lihlopha tsa mesebetsi kapa ho tsebisoa ka liphetoho ho tsona. Seva ea MQTT (broker) e sebelisetsoa morero ona, e sebetsanang le ts'ireletso le tsamaiso / kabo ea melaetsa ho barupeluoa. Tabeng ena, seva sa MQTT se fumaneha ka kotloloho ho DIVUS KNX IQ 'me e hlophisitsoe ka ho khetheha molemong ona. Le hoja VISION API e ka boela ea sebelisoa ntle le tsebo ea lenaneo, ts'ebetso ena e loketse basebelisi ba tsoetseng pele.
LITS'ELISITSOE
Joalo ka ha ho hlalositsoe bukeng ea VISION, mosebelisi oa API o tlameha ho qala ka ho qala e le hore a tsebe ho e sebelisa phihlello ea API e sebetsa feela ka ho sebelisa data ea netefatso ea basebelisi ba Api. Mabapi le litokelo tsa mosebelisi, ts'ebetso ea ts'ebetso ena e ka hlophisoa ho tsohle kapa ho likarolo tsa motho ka mong. Sheba Khaolo.0. Ehlile, o boetse o hloka projeke ea VISION eo ho eona likarolo tseo u batlang ho li laola ho tsoa kantle li hlophisoa ka botlalo mme khokahano ho tsona e lekoa ka katleho. Ho khona ho sebetsana le likarolo ka bomong ka API, ID ea bona ea element e tlameha ho tsejoa: sena se bonts'oa ka tlase ho foromo ea litlhophiso tsa element.
TS'IRELETSO
Ka mabaka a ts'ireletso, phihlello ea API e fumaneha sebakeng sa heno feela (e seng ka leru). Kotsi ea ts'ireletso ha o bula phihlello ea API e tlase. Leha ho le joalo, likarolo tse amanang le ts'ireletso ha lia lokela ho lumelloa kapa ho haneloa ka ho hlaka bakeng sa phihlello ea API.
MQTT LE MELAO EA YONA – TLHALOSO E KGUTSWANA
Ho MQTT, karolo ea tsamaiso e bohareng le kabo ea melaetsa eohle ke ea morekisi. Le hoja seva sa MQTT le MQTT broker e se li-synonyms (seva ke lentsoe le pharaletseng bakeng sa karolo eo bareki ba MQTT le bona ba ka e bapalang), broker e lula e boleloa bukeng ena ha ho boleloa seva sa MQTT. DIVUS KNX IQ ka boeona e bapala karolo ea MQTT broker / MQTT ho latela moelelo oa buka ena.
Seva ea MQTT e sebelisa seo ho thoeng ke lihlooho: sebopeho sa hierarchical eo data e arotsoeng ka eona, e laoloang le ho phatlalatsoa.
Phatlalatso e na le sepheo sa mantlha sa ho etsa hore barupeluoa ba bang ba fumane lintlha ka lihlooho. Haeba u batla ho fetola boleng, u ngolla sehlooho se lakatsehang hammoho le phetoho ea boleng bo lakatsehang, hape u sebelisa ketso ea khatiso. Sesebelisoa se shebiloeng kapa seva sa MQTT se bala phetoho e lakatsehang e e amang mme e e amohela ka nepo. Ho hlahloba hore na phetoho e sebelisitsoe, u ka sheba sehloohong se ngolisitsoeng sa nako ea sebele ho bona hore na phetoho e bonahala moo - haeba tsohle li tsamaile hantle.
Bareki ba khetha lihlooho tse ba khahlang: sena se bitsoa ho ngolisa. Nako le nako ha boleng bo fetoha ho / ka tlase ho sehlooho, bareki bohle ba ngolisitsoeng ba tsebisoa - ke hore ntle le ho botsa ka ho hlaka hore na ho na le ntho e fetohileng kapa hore na boleng ba hona joale ke bofe.
O ka bula (kapa aterese) mocha oa puisano o arohaneng le seva sa MQTT ka ho kenya khoele efe kapa efe e ikhethang e bitsoang client_id sehloohong. The client_id e tlameha ho sebelisoa sehloohong ho sebetsana le litekanyetso. Sena se thusa ho tseba tšimoloho ea phetoho e 'ngoe le e' ngoe, se thusa ka liphoso leha e le life 'me ha se ame bareki ba bang, kaha likarabo tse lumellanang le seva, ho kenyelletsa le likhoutu tsa phoso le melaetsa, le tsona li fihlella sehlooho feela ka client_id e tšoanang ('me kahoo feela moreki eo). Client_id ke thapo e ikhethang e nang le motsoako ofe kapa ofe oa litlhaku 0-9, az, AZ, “-“, “_”.
Ka kakaretso, lihlooho tsa ho ngolisa tsa MQTT seva sa DIVUS KNX IQ li na le boemo ba mantsoe a sehlooho, ha lihlooho tsa khatiso li na le kopo ea mantsoe a sehlooho. Ba nang le boemo ba ntlafatsoa ka mokhoa o ikemetseng hang ha ho e-na le phetoho ea boleng ba ka ntle kapa hang ha phetoho ea boleng e kōptjoa ke mofani ka boeena ka khatiso mme e sebelisitsoe ka katleho. Tseo tsa khatiso li arotsoe hape ka mofuta oa (kopo/) fumana le tsa mofuta (kopo/) sete.
Liphetoho tsa boleng le likarolo tse ling tsa boikhethelo li eketsoa sehloohong ka seo ho thoeng ke moputso. Litekanyetso tsa likarolo tsa motho ka mong (element-id, lebitso, mofuta, mesebetsi)
Phapang e kholo lipakeng tsa MQTT le mofuta oa khale oa li-client-server, moo moreki a kopang ebe o fetola data, e thehiloe mehopolong ea ho ngolisa le ho phatlalatsa. Barupeluoa ba ka phatlalatsa data, ba etsa hore e fumanehe ho ba bang, bao haeba ba thahasella ba ka ingolisang ho eona. Meaho ena e etsa hore ho khonehe ho fokotsa phapanyetsano ea data le ho boloka bohle ba nang le thahasello ho fihlela joale. Lintlha tse ling mabapi le lintlha tse mona: le liparamente tse khethehileng (uuid, filters) li tla sebelisoa mona. Leha ho na le likhetho tse 'maloa, moputso o bonts'oa o hlophisitsoe joalo ka JSON bukeng ena. JSON e sebelisa li-brackets le li-commas ho emela lintlha tsa sebopeho leha e le sefe 'me kahoo e fokotsa boholo ba lipakete tsa data tse lokelang ho fetisoa. Lintlha tse ling mabapi le meroalo ea meputso li ka fumanoa hamorao bukeng ea tataiso.
Bakeng sa merero e khethehileng, hoa khoneha ho sefa ho latela mofuta oa ts'ebetso, mohlala, ho sebetsana le li-switches tsa 1-bit feela. The filters parameter ho payload e sebelisetsoa morero ona. Ho sefa hona joale ho khoneha feela ka mofuta oa ts'ebetso.
Ho khona ho sebetsana le likarolo ka bomong, ID ea bona ea element ea hlokahala. Sena se ka fumanoa ho PONO ho menu ea thepa ea element kapa se ka baloa ka kotloloho ho tsoa ho data e bonts'itsoeng ka pele ho ntho e ngoe le e ngoe e fumanehang ho ngoliso e akaretsang ea MQTT Explorer (lintlha tse teng li thathamisitsoe ka alfabeta ka ID ea element).
Litlhophiso bakeng sa phihlello ea API
HO HLOKA PONO EA HO FIHLELA MOSEBETSI API
Ho PONO e le molaoli, e-ea ho Configuration - User / API Access Management, tobetsa ho Basebedisi / API ho fihlella le ho tobetsa ka ho le letona ho API User (kapa tobetsa le ho tšoara) ho bula fensetere ea ho hlophisa. Ha u le moo u tla fumana liparamente tsena le data
- Dumella (lebokose la ho hlahloba)
- Mosebelisi o bulela mona pele. Tlhōrō e koetsoe
- Username
- Khoele ena ea hlokahala bakeng sa phihlello ka API - e kopitse ho tloha mona
- Password
- Khoele ena ea hlokahala bakeng sa phihlello ka API - e kopitse ho tloha mona
- Litumello
- Litokelo tsa kamehla tsa ho bala le ho ngola boleng ba likarolo tsa PONO li ka hlalosoa mona, ke hore, se hlalosoang mona se sebetsa ho likarolo tsohle tse teng le tse tlang. Haeba u batla feela ho lumella ho fihlella likarolo tsa motho ka mong, ha ua lokela ho fetola litokelo tsena tsa kamehla
LITUMELO LINTLHA TSA MOTHO KA MONG
Ho kgothaletswa hore o se ke wa fana ka phihlello ya API ho projeke kaofela, empa feela ho likarolo tse lakatsehang. Tsoela pele ka tsela e latelang
- kena ho VISION joalo ka molaoli
- khetha ntho eo u e batlang ebe u bula li-menu tsa eona (tobetsa ka ho le letona kapa u 'ne u tobetse, ebe Litlhophiso)
- tlas'a lethathamo la Kakaretso - Litumello, kenya tšebetsong "Fetola litumello tsa kamehla" ebe u ea ho ntho e nyane ea Litumello, e bonts'ang matrix a tumello.
- kenya tshebetsong tumello ea ho laola mona, eo hape e nolofalletsang ho view tumello ka kotloloho. Haeba u batla feela ho bala data ka phihlello ea API, ho lekane ho thusa view tumello.
- pheta mokhoa o ts'oanang bakeng sa likarolo tsohle tseo u batlang ho li fumana
Khokahano ka MQTT
LIEKETSENG
Joalo ka mohlalaample, re tla bontša phihlello ka MQTT API ea DIVUS KNX IQ ka software e batlang e le bonolo, e sa lefelloeng e bitsoang MQTT Explorer (sheba khaolo ea 1.1), e fumanehang bakeng sa Windows, Mac le Linux. Tsebo ea mantlha le boiphihlelo ka MQTT li boleloa.
DATA E HLOKAHALA KHOPO
Joalokaha ho boletsoe pejana (sheba karolo ea 2.1), lebitso la mosebelisi le password ea mosebelisi oa API lia hlokahala. Ho feta monaview ea data eohle e lokelang ho bokelloa pele khokahano e thehoa:
- Username Bala leqepheng la lintlha tsa mosebelisi oa API
- Password Bala leqepheng la lintlha tsa mosebelisi oa API
- Aterese ea IP Bala ka har'a li-setting tsa sebui tlasa General - Network - Ethernet (kapa ka Synchronizer)
- Port 8884 (boema-kepe bona bo boloketsoe morero ona)
KHOKANO EA PELE LE MQTT EXPLORER LE KAKAKARETSO SUBSCRIBE
Ka tloaelo, MQTT e khetholla lipakeng tsa mesebetsi e ingolisang le ho e phatlalatsa. MQTT Explorer e nolofatsa sena ka ho ingolisa ho lihlooho tsohle tse fumanehang (sehlooho #) ha khokahano ea pele e etsoa. Ka lebaka leo, sefate se lebisang linthong tsohle tse teng (ke hore, phihlello ea mosebelisi oa API) e ka bonoa ka kotloloho karolong e ka letsohong le letšehali la fensetere ea MQTT Explorer kamora khokahano e atlehileng. Ho kenya lihlooho tse ling tsa ho ngolisa kapa ho nkela # sebaka ka sehlooho se ikhethileng, e ea ho E tsoetseng pele ka fensetere ea khokahano. Sehlooho se bontšitsoeng ka holimo ka ho le letona se shebahala tjena:
moo 7f4x0607849x444xxx256573x3x9x983 e leng lebitso la mosebelisi la API le lethathamo la_lintho le nang le likarolo tsohle tse teng.Sehlooho sena se lula se le teng, ke hore, liphetoho tsa bohlokoa li bonahala moo ka nako ea sebele. Haeba u batla feela ho ingolisa ho likarolo ka bomong, kenya ID ea element ea ntho eo u e batlang kamora objects_list/.
Tlhokomeliso: Mofuta ona oa ho ngolisa o batla o lumellana le maikutlo a ka morao ho liaterese tsa maikutlo tsa KNX; e bonts'a boemo ba hajoale ba lielemente mme e ka sebelisoa ho lekola hore na liphetoho tse lakatsehang li sebelisitsoe ka katleho. Haeba u batla feela ho bala data empa u sa e fetole, mofuta ona oa ho ngolisa o lekane.
Ntho e le 'ngoe e bonolo e shebahala tjena ho JSON notation
Tlhokomeliso: Litekanyetso tsohle li na le syntax e bontšitsoeng ka holimo mohlala {"value": "1" } e le tlhahiso ea lihlooho tse ngolisoang, ha boleng bo ngotsoe ka ho toba mokotleng oa moputso ho fetola boleng (ke hore bakeng sa lihlooho tsa phatlalatso) - li-brackets le “boleng” ba siilwe mohlala, “offoff”: “1”.
Litaelo tse tsoetseng pele
LIEKETSENG
Ho na le mefuta e 3 ea lihlooho ka kakaretso:
- Ngolisa lihlooho ho bona likarolo tse fumanehang le ho fumana liphetoho tsa nako ea nnete
- Ngolisa lihlooho ho fumana likarabo ho (bareki ) phatlalatsa likopo
- Phatlalatsa (li)hlooho ho fumana kapa ho seta likarolo ka boleng ba tsona
Hamorao re tla bua ka mefuta ena re sebelisa linomoro tse bontšitsoeng mona (mohlala, lihlooho tsa mofuta oa 1, 2, 3). Lintlha tse ling likarolong tse latelang le ho khao. 4.2.
Ngolisa LIHLOOHO HO BONA LITLHAKISO TSE FUMANEHANG LE HO FUMANA LIPHETOHO TSA BOHLOKOA KA NAKO EA SEBELE.
Tsena li se li hlalositsoe
Ngolisa LIHLOOHO HO FUMANA LIKARABO TSA LIKOPO TSA KHATLISISO EA CLIENT
Lihlooho tsa mofuta ona ke boikhethelo. E lumella ho
- bula mocha oa puisano o ikhethileng le seva sa MQTT ka ho sebelisa client_id e sa reroang. Tse ling ka seo ho chap. 4.2.2
- fumana sephetho sa likopo tsa phatlalatso ho sehlooho se lumellanang sa ngoliso: katleho kapa ho hloleha ka khoutu ea phoso le molaetsa.
Ho na le lihlooho tse fapaneng ho fumana likarabo ho fumana kapa ho seta litaelo tsa phatlalatso. Phapang e tsamaellanang ho Hang ha u fumana lihlooho tse hlokahalang bakeng sa tsamaiso ea hau ka ho toba, u ka nka qeto ea ho tlosa mohato ona 'me u sebelise lihlooho tsa khatiso ka ho toba.
PHATALATSA LIHLOOHO HO FUMANA KAPA HO BEHELA LINTHO KA MELAO EA TSONA
Lihlooho tsena li sebelisa tsela e tšoanang le ea ho ngolisa - phetoho feela ke lentsoe "kopo" sebakeng sa "boemo" bo sebelisoang ho ngolisa. Litsela tse felletseng tsa lihlooho li bonts'oa hamorao ho khao. 4.2.2\ Sehlooho sa ho fumana se tla kopa ho bala likarolo le boleng ba seva sa MQTT. Lekhetho le ka sebelisoa ho sefa ho ipapisitsoe le mofuta oa ts'ebetso ea likarolo. Sehlooho se behiloeng se tla kopa ho fetola likarolo tse ling tsa ntho, joalo ka ha ho hlalositsoe moroalo oa eona oa moputso.
SEHLOOHO SA LITAELO LE LIKARABELO TSE TOPANANG
TLHALOSO KHUTSANE
Litaelo tsohle tse rometsoeng ho seva sa MQTT li na le karolo e tšoanang ea pele, e leng:
TLHALOSO TLHALOSO
Lihlooho tsa nako ea sebele (mofuta oa 1) li tla ba le sehlomathiso se akaretsang (sheba ka holimo) ebe se lateloa ke
or
Bakeng sa litaelo tse behiloeng, ho hlakile hore moputso o bapala karolo ea mantlha kaha o tla ba le liphetoho tse lakatsehang (ke hore, boleng bo fetotsoeng bakeng sa mesebetsi ea element). Tlhokomeliso: Le ka mohla u se ke ua sebelisa khetho ea ho boloka litaelo tsa mofuta oa 3 kaha e ka baka mathata ka lehlakoreng la KNX.
EXAMPLE: PHATLALATSA BAKENG SA FETOHA BOHLOKOA(LI-)
Taba e bonolo ka ho fetisisa ke ho batla ho fetola boleng ba e 'ngoe ea lintlha tse bontšitsoeng ke kakaretso subscribe .
Ka kakaretso, ho fetola / ho fetola mosebetsi oa PONO ka MQTT ho na le mehato e 3, eseng kaofela ha eona e hlokahalang ka ho feletseng, empa leha ho le joalo re khothalletsa ho e phethahatsa joalokaha ho hlalositsoe.
- Sehlooho se nang le mosebetsi oo re batlang ho o hlophisa se ngolisoa ho sebelisoa client_id e tloaelehileng
- Sehlooho sa ho hlophisoa se phatlalalitsoe hammoho le mojaro oa moputso le liphetoho tse lakatsehang ho sebelisoa client_id e khethiloeng ho 1.
- Ho hlahloba, joale u ka bona karabo sehloohong (1.) - ke hore na (2.) e sebelitse kapa che
- Ka kakaretso ho ingolisa, moo litekanyetso tsohle li nchafatsoang ha liphetoho li etsoa, u ka bona liphetoho tse lakatsehang tsa boleng haeba tsohle li tsamaile hantle.
Mehato ea ho etsa sena ke:
- khetha client_id mohlala "Divus" 'me ue kenye tseleng ka mor'a lebitso la mosebelisi la API
Ena ke sehlooho se felletseng sa ho ingolisa ho kanale ea hau ea puisano le seva sa MQTT. Sena se bolella seva moo u lebeletseng likarabo tsa liphetoho tseo u batlang ho li romela. Hlokomela boemo/seta karolo e hlalosang a. hore ke sehlooho sa peeletso le b. hore e tla fumana likarabo ho beha litaelo tsa mofuta. - Sehlooho sa phatlalatso se tla tšoana ntle le ho fetola mantsoe a bohlokoa a kopo ea boemo
- seo phetoho e lokelang ho ba le sona se ngotsoe mokotleng oa moputso. Li-ex ke tsenaamples.
- Ho tima ntho e nang le ts'ebetso ea ho tima / ho tima (1 bit):
- Ho bulela element e nang le ts'ebetso ea ho tima / ho tima (1 bit). Ntle le moo, haeba litaelo tse 'maloa tse joalo li qalisoa ho tsoa ho moreki a le mong, paramethara ea uuid ("ID e ikhethang", hangata ke khoele ea 128-bit e hlophisitsoeng joalo ka 8-4-4-4-12 linomoro tsa hex) e ka sebelisoa ho abela karabo ho potso e lumellanang, kaha parameter ena - haeba e le teng potsong - e ka boela ea fumanoa karabong.
- Ho bulela le ho beha khanya ea dimmer ho 50%
- Karabo ea sehlooho se bontšitsoeng le ho ngolisoa ka holimo (mokoloto oa eona, ho nepahala) ke hore,ample.
Karabo e ka holimo ke example ha ho na le mojaro o nepahetseng, leha elemente e sena tšebetso ea ho fifala. Haeba ho na le mathata a tebileng a etsang hore mojaro oa moputso o se ke oa hlalosoa ka nepo, karabelo e tla shebahala tjena (mohlala):
bakeng sa tlhaloso ea likhoutu tsa liphoso le melaetsa empa ka kakaretso, joalo ka http, likhoutu tse 200 ke likarabo tse ntle ha 400 e le mpe.
- Ho tima ntho e nang le ts'ebetso ea ho tima / ho tima (1 bit):
EXAMPLE: PHATLALATSA BAKENG SA HO FETOHA LINTHO TSE MANGATA LITABA
Mokhoa ona o tšoana le o bontšitsoeng pele ho fetola ntho e le 'ngoe. Phapang ke hore u siea element_id lihloohong ebe u bontša sete ea element_ids ka pel'a data e ka hare ho payload. Sheba syntax le sebopeho se ka tlase.
SEFA KA MOFUTA OA MOSEBETSI HO LIPOTSO
Li-filters paramethara tse lefang li lumella feela mesebetsi e lakatsehang ea element hore e rarolloe. Ts'ebetso ea ho tima / ho tima ea switch kapa dimmer e bitsoa "offoff", bakeng sa mohlalaample, mme filthara e tsamaellanang e hlalosoa ka tsela ena:
Joale karabo e shebahala tjena, bakeng sa mohlalaample
Bracket e sekwere e bontša hore o ka sefa ka mesebetsi e mengata, mohlala
e fana ka karabo e kang ena:
Sehlomathiso
LIPHOSO LITSELA
Liphoso puisanong ea MQTT li baka khoutu ea linomoro. Tafole e latelang e thusa ho e senya.
LITŠOANTŠISO MOLEFO
Lekhetho le tšehetsa li-parameter tse fapaneng ho latela moelelo oa taba. Tafole e latelang e bontša hore na ke li-parameter life tse ka hlahang lihloohong life
TLHOKOMELO LINTLHA
- TLHOKOMELISO 1.00
Litaba:
• Khatiso ea pele
Litokomane / Lisebelisoa
![]() |
DIVUS VISION API Software [pdf] Bukana ea Mosebelisi VISION API Software, API Software, Software |
![]() |
DIVUS Vision API Software [pdf] Bukana ea Mosebelisi Vision API Software, Vision, API Software, Software |