MQTT v3 konektor
Objavljujte podatke uživo o uređajima i strategijama na sopstveni MQTT broker i prihvatajte komande sa njega.
→ Pregled
Konektor MQTT v3 povezuje kontroler kao klijent sa MQTT brokerom koji izaberete, na primer sa brokerom sistema za upravljanje zgradom, SCADA sistema ili platforme za automatizaciju doma. Kontroler zatim objavljuje vrednosti uživo svih uređaja i strategija, cene električne energije i keep-alive poruku, i osluškuje komande kao što su zadate vrednosti uređaja, uključivanje i isključivanje strategija, External EMS rasporedi i podešavanja električne mreže.
Konektor je isključen dok ne unesete Host. Nezavisan je od veze sa Reduxi Cloud; oba mogu raditi istovremeno.
Svako ko može da objavljuje na komandne topice kontrolera na vašem brokeru može da menja zadate vrednosti uređaja, isključuje strategije, menja ograničenja mreže i ponovo pokreće kontroler. Koristite broker sa autentifikacijom korisnika, dajte kontroleru sopstveni nalog i dozvolite pristup za pisanje na controllers/<Unit ID>/…/set i controllers/<Unit ID>/commands/… samo pouzdanim klijentima.
1 Povezivanje sa brokerom
2 Parametri
Stanje
| Parametar | Šta radi | Jedinica / podrazumevano |
|---|---|---|
| Client | ID MQTT klijenta koji kontroler koristi. To je Unit ID kontrolera i čini deo svakog topica: controllers/<Unit ID>/…. Samo za čitanje. |
tekst |
| Host | Broker na koji pokazuje sačuvana konfiguracija. Prazno = konektor je isključen. Samo za čitanje. | tekst |
| Connected | Zelena kvačica = povezano sa brokerom; crveni krstić = nije povezano. Samo za čitanje. | — |
| Ikona za osvežavanje | Ponovo čita stanje. | — |
Mqtt connection
| Parametar | Šta radi | Jedinica / podrazumevano |
|---|---|---|
| Host | Naziv hosta ili IP adresa brokera. Ostavite prazno da biste isključili konektor. | tekst · prazno = isključeno |
| Port | TCP port brokera. | broj · podrazumevano 1883 |
| Username | Korisničko ime na brokeru. Opcionalno. | tekst |
| Password | Lozinka na brokeru. Koristi se samo zajedno sa poljem Username. Polje prikazuje lozinku kao običan tekst. | tekst |
| Use SSL | Yes otvara vezu sa TLS šifrovanjem. Ako ga nikada niste podesili, uključuje se automatski kada su sačuvani lanac CA servera ili klijentski sertifikat. | Yes / No · podrazumevano No |
| Verify server cert | Yes proverava sertifikat brokera u odnosu na Server CA chain (ili u odnosu na ugrađene pouzdane autoritete kontrolera ako lanac nije otpremljen). No prihvata bilo koji sertifikat: veza je šifrovana, ali kontroler ne proverava sa kim komunicira. Koristi se samo kada je Use SSL = Yes. | Yes / No · podrazumevano No |
| Server CA chain (PEM format) | Sertifikat (lanac) autoriteta koji je potpisao sertifikat brokera. Kliknite na Choose File i izaberite PEM datoteku. Kada je sačuvan, polje umesto toga prikazuje dugme Download. | PEM datoteka |
| Client public certificate (PEM format) | Sopstveni klijentski sertifikat kontrolera, za brokere koji autentifikuju klijente pomoću sertifikata (mutual TLS). Potreban je odgovarajući privatni ključ. | PEM datoteka |
| Client private key (PEM format) | Privatni ključ klijentskog sertifikata. | PEM datoteka |
Privatni ključ klijenta i lozinka brokera daju pristup vašem brokeru. Čuvajte datoteke na bezbednom mestu, ne šaljite ih e-poštom i ne ostavljajte kopije na zajedničkim računarima. Svako ko ima pristup ovoj stranici u programu Configurator može da preuzme sačuvane sertifikate i vidi lozinku.
Sačuvani sertifikat prikazuje samo dugme Download. Da biste otpremili drugi, kliknite na Clear connection configuration, a zatim ponovo unesite celu konfiguraciju veze sa novim datotekama.
Additional topics
| Parametar | Šta radi | Jedinica / podrazumevano |
|---|---|---|
| Name or path | Topic koji se objavljuje, u odnosu na controllers/<Unit ID>/. Na primer, site/name se objavljuje kao controllers/<Unit ID>/site/name. Redovi sa praznim nazivom se preskaču. |
tekst |
| Payload | Fiksni tekst koji se objavljuje na tom topicu. | tekst |
| Add | Dodaje prazan red. | — |
| Ikona korpe za otpatke | Uklanja red. Stupa na snagu nakon Save. | — |
Dodatni topici se objavljuju zajedno sa metapodacima kontrolera: svaki put kada se konektor poveže sa brokerom i svaki put kada broker pošalje commands/refresh.
Objavljivanje i dugmad
| Parametar | Šta radi | Jedinica / podrazumevano |
|---|---|---|
| Readout interval | Koliko često kontroler objavljuje očitavanje i zadatu vrednost svakog uređaja, kao i očitavanje, stanje i vrednosti parametara svake strategije. Manje vrednosti daju svežije podatke, ali više saobraćaja. | s · prazno = 60 s · minimum 0,25 s |
| Sačuvajte | Čuva podešavanja i ponovo pokreće konektor. Beleži se u Audit log kao CONNECTOR_EDIT. |
— |
| Clear connection configuration | Nakon potvrde Are you sure to clear MQTT settings? (Yes / Cancel) briše host, port, korisničko ime, lozinku, SSL podešavanja i sve sertifikate. Konektor se isključuje. Readout interval i Additional topics se zadržavaju. | — |
Nakon Clear connection configuration kontroler više ne objavljuje podatke niti prihvata komande preko MQTT-a. Sistem koji se oslanja na podatke ili šalje External EMS rasporede prestaje da ih prima ili isporučuje. Da biste se ponovo povezali, morate ponovo da unesete lozinku i otpremite sertifikate.
3 Topici
Svi topici počinju sa controllers/<Unit ID>/. Kontroler objavljuje sa QoS 0 i bez retain oznake, a na komandne topice se pretplaćuje sa QoS 1. Payload je JSON ili obične vrednosti; potpuni formati payloada nalaze se u članku centra za pomoć "Reduxi Controller - MQTT API".
Objavljuje kontroler:
| Topic | Sadržaj | Kada |
|---|---|---|
identifier |
Identifikacija kontrolera (unit ID, verzije, …) | Pri povezivanju i na commands/refresh
|
settings/interval/readout, settings/interval/keepAlive
|
Trenutni intervali u ms | Pri povezivanju i pri osvežavanju |
devices/list, devices/types, devices/<id>/info
|
Podešeni uređaji i njihovi tipovi | Pri povezivanju i pri osvežavanju |
strategies/list, strategies/types, strategies/<id>/info, strategies/<id>/parameters/list, strategies/<id>/parameters/<id>/info
|
Podešene strategije i njihovi parametri | Pri povezivanju i pri osvežavanju |
<additional topic> |
Payload iz odeljka Additional topics | Pri povezivanju i pri osvežavanju |
devices/<id>/readout |
Vrednosti uređaja uživo | Na svaki interval očitavanja |
devices/<id>/setpoint |
Trenutna zadata vrednost uređaja | Na svaki interval očitavanja |
strategies/<id>/active, strategies/<id>/readout, strategies/<id>/parameters/<id>/value
|
Uključenost strategije, vrednosti uživo, vrednosti parametara | Na svaki interval očitavanja |
prices |
Cene električne energije za danas i sutra | Pri povezivanju, kada se cene promene, i na prices/refresh
|
strategies/<id>/externalEMS/<type> |
Sačuvani External EMS raspored (battery, evse, hvac, pv) |
Na …/externalEMS/<type>/refresh
|
keepAlive |
Trenutno vreme (Unix ms) | Na svaki keep-alive interval, podrazumevano 60 s |
Komande koje kontroler prihvata:
| Topic | Dejstvo |
|---|---|
commands/refresh |
Ponovo objavljuje topice sa metapodacima. |
commands/reboot |
Ponovo pokreće kontroler oko 5 s kasnije. |
prices/refresh |
Ponovo objavljuje prices. |
settings/interval/readout/set |
Menja interval očitavanja (ms) i čuva ga. |
settings/interval/keepAlive/set |
Menja keep-alive interval (ms) i čuva ga. |
devices/<id>/setpoint/set |
Postavlja zadatu vrednost uređaja. |
strategies/<id>/parameters/<id>/value/set |
Postavlja parametar strategije. |
strategies/<id>/active/set |
Uključuje ili isključuje strategiju. |
strategies/<id>/externalEMS/<type>/set |
Učitava External EMS raspored za battery, evse, hvac ili pv. Zanemaruje se osim ako strategija ima režim optimizacije External EMS. |
strategies/<id>/externalEMS/<type>/refresh |
Objavljuje sačuvani External EMS raspored. |
settings/grid/set |
Menja podešavanja električne mreže (lokacija, osigurači, ograničenje uvoza i izvoza), opciono i u izabranim strategijama. |
settings/grid/set prepisuje vrednosti na stranici Settings → Grid i, ako je zatraženo, ograničenja strategija — isti efekat kao čuvanje stranice Grid settings. devices/<id>/setpoint/set upisuje zadatu vrednost direktno u uređaj. Ne šaljite zadate vrednosti za uređaj kojim upravlja i strategija, jer će se one međusobno prepisivati.
4 Česti problemi
| Simptom | Šta proveriti |
|---|---|
| Connected ostaje crveno | Host i Port su ispravni; kontroler može da dopre do brokera (TCP port test na hostu i portu brokera); korisničko ime i lozinka; kod TLS-a, lanac CA odgovara sertifikatu brokera, ili probajte Verify server cert = No da biste suzili problem. |
| Povezano, ali nema podataka na brokeru | Pretplatite se na controllers/# i proverite vrednost Client: topici koriste Unit ID tačno onako kako je tamo prikazan. |
| Komande nemaju efekta | Klijent koji ih šalje ima pravo objavljivanja na brokeru; topic koristi ispravan ID uređaja ili strategije (pogledajte devices/list, strategies/list). |
5 Kontrolna lista
- Host i Port odgovaraju brokeru, a Connected prikazuje zelenu kvačicu nakon osvežavanja.
- Na produkcionim lokacijama: Use SSL = Yes, lanac CA je otpremljen i Verify server cert = Yes.
- Podaci stižu pod
controllers/<Unit ID>/u podešenom intervalu Readout interval. - Pristup za pisanje na komandne topice ograničen je na pouzdane klijente na brokeru.
- Datoteke sertifikata i lozinke bezbedno su čuvane izvan kontrolera.