Konektor MQTT v3
Objavljajte podatke naprav in strategij v živo v lasten posrednik MQTT in iz njega sprejemajte ukaze.
→ Pregled
Konektor MQTT v3 poveže krmilnik kot odjemalca s posrednikom MQTT (broker), ki ga izberete, na primer s posrednikom sistema za upravljanje stavbe, sistema SCADA ali platforme za pametni dom. Krmilnik nato objavlja trenutne vrednosti vseh naprav in strategij, cene električne energije in sporočilo keep-alive, hkrati pa posluša ukaze, kot so nastavljene vrednosti naprav, vklop/izklop strategij, urniki External EMS in nastavitve omrežja.
Konektor je izklopljen, dokler ne boste vnesli polja Host. Je neodvisen od povezave z oblakom Reduxi Cloud; obe lahko delujeta hkrati.
Vsak, ki lahko objavlja v ukazne teme krmilnika na vašem posredniku, lahko spremeni nastavljene vrednosti naprav, izklopi strategije, spremeni omejitve omrežja in znova zažene krmilnik. Uporabite posrednika z overjanjem uporabnikov, krmilniku dodelite lasten račun in pravico pisanja v controllers/<Unit ID>/…/set in controllers/<Unit ID>/commands/… dodelite samo zaupanja vrednim odjemalcem.
1 Povezava s posrednikom
2 Parametri
Status
| Parameter | Kaj naredi | Enota / privzeto |
|---|---|---|
| Client | ID odjemalca MQTT, ki ga uporablja krmilnik. To je Unit ID krmilnika, ki tvori tudi vsako temo: controllers/<Unit ID>/…. Samo za branje. |
besedilo |
| Host | Posrednik, na katerega kaže shranjena konfiguracija. Prazno = konektor izklopljen. Samo za branje. | besedilo |
| Connected | Zelena kljukica = povezan s posrednikom; rdeč križec = ni povezan. Samo za branje. | — |
| Ikona za osvežitev | Znova prebere stanje. | — |
Mqtt connection
| Parameter | Kaj naredi | Enota / privzeto |
|---|---|---|
| Host | Ime gostitelja ali naslov IP posrednika. Za izklop konektorja pustite prazno. | besedilo · prazno = izklopljeno |
| Port | Vrata TCP posrednika. | število · privzeto 1883 |
| Username | Uporabniško ime na posredniku. Neobvezno. | besedilo |
| Password | Geslo na posredniku. Uporablja se samo skupaj z Username. Polje prikazuje geslo v navadnem besedilu. | besedilo |
| Use SSL | Yes odpre povezavo s šifriranjem TLS. Če te nastavitve nikoli niste nastavili, se samodejno vklopi, ko sta shranjena veriga CA strežnika ali certifikat odjemalca. | Yes / No · privzeto No |
| Verify server cert | Yes preveri certifikat posrednika glede na Server CA chain (ali glede na vgrajene zaupanja vredne overitelje krmilnika, če veriga ni naložena). No sprejme vsak certifikat: povezava je šifrirana, vendar krmilnik ne preveri, s kom komunicira. Uporablja se samo pri Use SSL = Yes. | Yes / No · privzeto No |
| Server CA chain (PEM format) | Certifikat (veriga) overitelja, ki je podpisal certifikat posrednika. Kliknite Choose File in izberite datoteko PEM. Ko je shranjena, polje namesto tega prikazuje gumb Download. | datoteka PEM |
| Client public certificate (PEM format) | Lastni certifikat odjemalca krmilnika za posrednike, ki odjemalce overjajo s certifikatom (vzajemni TLS). Potrebuje ustrezen zasebni ključ. | datoteka PEM |
| Client private key (PEM format) | Zasebni ključ certifikata odjemalca. | datoteka PEM |
Zasebni ključ odjemalca in geslo posrednika omogočata dostop do vašega posrednika. Datoteke hranite na varnem, ne pošiljajte jih po e-pošti in ne puščajte kopij na skupnih računalnikih. Vsak, ki ima dostop do te strani v orodju Configurator, lahko prenese shranjene certifikate in vidi geslo.
Shranjen certifikat prikazuje samo gumb Download. Če želite naložiti drugega, kliknite Clear connection configuration in nato znova vnesite celotno povezavo z novimi datotekami.
Additional topics
| Parameter | Kaj naredi | Enota / privzeto |
|---|---|---|
| Name or path | Tema za objavo, relativno glede na controllers/<Unit ID>/. Na primer site/name se objavi kot controllers/<Unit ID>/site/name. Vrstice s praznim imenom se preskočijo. |
besedilo |
| Payload | Stalno besedilo, objavljeno v tej temi. | besedilo |
| Add | Doda prazno vrstico. | — |
| Ikona koša | Odstrani vrstico. Začne veljati po Save. | — |
Dodatne teme se objavijo skupaj z metapodatki krmilnika: ob vsaki vzpostavitvi povezave konektorja s posrednikom in ob vsakem ukazu commands/refresh, ki ga pošlje posrednik.
Objavljanje in gumbi
| Parameter | Kaj naredi | Enota / privzeto |
|---|---|---|
| Readout interval | Kako pogosto krmilnik objavlja odčitek in nastavljeno vrednost vsake naprave ter odčitek, stanje in vrednosti parametrov vsake strategije. Nižje vrednosti dajejo svežejše podatke, a več prometa. | s · prazno = 60 s · najmanj 0,25 s |
| Shranjevanje | Shrani nastavitve in znova zažene konektor. Zabeleženo v Audit log kot CONNECTOR_EDIT. |
— |
| Clear connection configuration | Po potrditvi Are you sure to clear MQTT settings? (Yes / Cancel) izbriše gostitelja, vrata, uporabniško ime, geslo, nastavitve SSL in vse certifikate. Konektor se izklopi. Readout interval in Additional topics ostaneta. | — |
Po Clear connection configuration krmilnik prek MQTT ne objavlja več podatkov in ne sprejema ukazov. Sistem, ki se zanaša na podatke ali pošilja urnike External EMS, jih preneha prejemati oziroma dostavljati. Za ponovno povezavo morate znova vnesti geslo in naložiti certifikate.
3 Teme
Vse teme se začnejo s controllers/<Unit ID>/. Krmilnik objavlja s QoS 0 in brez zastavice retain, na ukazne teme pa je naročen s QoS 1. Vsebina so JSON ali navadne vrednosti; popolne oblike vsebine so v članku centra za pomoč »Reduxi Controller - MQTT API«.
Objavlja krmilnik:
| Tema | Vsebina | Kdaj |
|---|---|---|
identifier |
Identifikacija krmilnika (Unit ID, različice, …) | Ob vzpostavitvi povezave in ob commands/refresh
|
settings/interval/readout, settings/interval/keepAlive
|
Trenutni intervali v ms | Ob vzpostavitvi povezave in ob osvežitvi |
devices/list, devices/types, devices/<id>/info
|
Konfigurirane naprave in njihove vrste | Ob vzpostavitvi povezave in ob osvežitvi |
strategies/list, strategies/types, strategies/<id>/info, strategies/<id>/parameters/list, strategies/<id>/parameters/<id>/info
|
Konfigurirane strategije in njihovi parametri | Ob vzpostavitvi povezave in ob osvežitvi |
<additional topic> |
Vsebina iz Additional topics | Ob vzpostavitvi povezave in ob osvežitvi |
devices/<id>/readout |
Trenutne vrednosti naprave | Ob vsakem intervalu branja |
devices/<id>/setpoint |
Trenutna nastavljena vrednost naprave | Ob vsakem intervalu branja |
strategies/<id>/active, strategies/<id>/readout, strategies/<id>/parameters/<id>/value
|
Vklop/izklop strategije, trenutne vrednosti, vrednosti parametrov | Ob vsakem intervalu branja |
prices |
Cene električne energije za danes in jutri | Ob vzpostavitvi povezave, ob spremembi cen in ob prices/refresh
|
strategies/<id>/externalEMS/<type> |
Shranjeni urnik External EMS (battery, evse, hvac, pv) |
Ob …/externalEMS/<type>/refresh
|
keepAlive |
Trenutni čas (Unix ms) | Ob vsakem intervalu keep-alive, privzeto 60 s |
Ukazi, ki jih krmilnik sprejema:
| Tema | Učinek |
|---|---|
commands/refresh |
Znova objavi teme z metapodatki. |
commands/reboot |
Znova zažene krmilnik približno 5 s pozneje. |
prices/refresh |
Znova objavi prices. |
settings/interval/readout/set |
Spremeni interval branja (ms) in ga shrani. |
settings/interval/keepAlive/set |
Spremeni interval keep-alive (ms) in ga shrani. |
devices/<id>/setpoint/set |
Nastavi nastavljeno vrednost naprave. |
strategies/<id>/parameters/<id>/value/set |
Nastavi parameter strategije. |
strategies/<id>/active/set |
Vklopi ali izklopi strategijo. |
strategies/<id>/externalEMS/<type>/set |
Naloži urnik External EMS za battery, evse, hvac ali pv. Prezre se, razen če ima strategija način optimizacije External EMS. |
strategies/<id>/externalEMS/<type>/refresh |
Objavi shranjeni urnik External EMS. |
settings/grid/set |
Spremeni nastavitve omrežja (lokacija, varovalke, omejitev odjema in oddaje), po izbiri tudi v izbranih strategijah. |
settings/grid/set prepiše vrednosti na strani Settings → Grid in, če je zahtevano, omejitve strategij; učinek je enak kot pri shranjevanju strani Grid. devices/<id>/setpoint/set zapiše nastavljeno vrednost neposredno v napravo. Nastavljenih vrednosti ne pošiljajte za napravo, ki jo upravlja tudi strategija, sicer se bosta medsebojno prepisovali.
4 Odpravljanje težav
| Znak | Kaj preveriti |
|---|---|
| Connected ostaja rdeč | Host in Port sta pravilna; krmilnik doseže posrednika (TCP port test na gostitelju in vratih posrednika); uporabniško ime in geslo; pri TLS veriga CA ustreza certifikatu posrednika, ali pa za zožitev težave poskusite z Verify server cert = No. |
| Povezan, a na posredniku ni podatkov | Naročite se na controllers/# in preverite vrednost Client: teme uporabljajo Unit ID natanko tako, kot je prikazan tam. |
| Ukazi nimajo učinka | Odjemalec, ki jih pošilja, ima pravice objavljanja na posredniku; tema uporablja pravilen ID naprave ali strategije (glejte devices/list, strategies/list). |
5 Kontrolni seznam
- Host in Port ustrezata posredniku, Connected pa po osvežitvi prikazuje zeleno kljukico.
- Na produkcijskih lokacijah: Use SSL = Yes, veriga CA je naložena in Verify server cert = Yes.
- Podatki prihajajo v
controllers/<Unit ID>/v nastavljenem Readout interval. - Pravica pisanja v ukazne teme je omejena na zaupanja vredne odjemalce na posredniku.
- Datoteke s certifikati in gesla so shranjeni varno zunaj krmilnika.