MQTT v3 -connector
Julkaise laitteiden ja strategioiden reaaliaikaiset tiedot omalle MQTT-brokerillesi ja vastaanota sen kautta komentoja.
→ Yleiskatsaus
MQTT v3 -connector yhdistää ohjaimen asiakkaana valitsemaasi MQTT-brokeriin, esimerkiksi rakennusautomaatiojärjestelmän, SCADA-järjestelmän tai kotiautomaatioalustan brokeriin. Ohjain julkaisee sitten kaikkien laitteiden ja strategioiden reaaliaikaiset arvot, sähkön hinnat ja keep-alive-viestin, ja se kuuntelee komentoja, kuten laitteiden asetusarvoja, strategioiden päälle- ja poiskytkentää, External EMS -aikatauluja ja verkkoliitynnän asetuksia.
Connector on pois päältä, kunnes syötät arvon Host. Se on riippumaton Reduxi Cloud -yhteydestä; molemmat voivat toimia samaan aikaan.
Kuka tahansa, joka voi julkaista brokerillasi ohjaimen komento-topiceihin, voi muuttaa laitteiden asetusarvoja, kytkeä strategioita pois päältä, muuttaa verkkorajoja ja käynnistää ohjaimen uudelleen. Käytä brokeria, jossa on käyttäjän todennus, anna ohjaimelle oma tili ja salli kirjoitusoikeus topiceihin controllers/<Unit ID>/…/set ja controllers/<Unit ID>/commands/… vain luotetuille asiakkaille.
1 Yhteyden muodostaminen brokeriin
2 Parametrit
Status
| Parametri | Mitä se tekee | Yksikkö / oletus |
|---|---|---|
| Client | MQTT-asiakastunnus, jota ohjain käyttää. Se on ohjaimen Unit ID, ja se muodostaa myös jokaisen topicin alun: controllers/<Unit ID>/…. Vain luku. |
teksti |
| Host | Broker, johon tallennettu kokoonpano osoittaa. Tyhjä = connector pois päältä. Vain luku. | teksti |
| Connected | Vihreä valintamerkki = yhteys brokeriin muodostettu; punainen rasti = ei yhteyttä. Vain luku. | — |
| Päivityskuvake | Lukee tilan uudelleen. | — |
Mqtt connection
| Parametri | Mitä se tekee | Yksikkö / oletus |
|---|---|---|
| Host | Brokerin isäntänimi tai IP-osoite. Jätä tyhjäksi, kun haluat kytkeä connectorin pois päältä. | teksti · tyhjä = pois päältä |
| Port | Brokerin TCP-portti. | luku · oletus 1883 |
| Username | Käyttäjätunnus brokerilla. Valinnainen. | teksti |
| Password | Salasana brokerilla. Käytetään vain yhdessä kentän Username kanssa. Kenttä näyttää salasanan selkotekstinä. | teksti |
| Use SSL | Yes avaa yhteyden TLS-salauksella. Jos et ole koskaan asettanut sitä, se kytkeytyy päälle automaattisesti, kun palvelimen CA-ketju tai asiakasvarmenne on tallennettu. | Yes / No · oletus No |
| Verify server cert | Yes tarkistaa brokerin varmenteen kentän Server CA chain mukaan (tai ohjaimen sisäänrakennettujen luotettujen varmentajien mukaan, jos ketjua ei ole ladattu). No hyväksyy minkä tahansa varmenteen: yhteys on salattu, mutta ohjain ei tarkista, kenen kanssa se keskustelee. Käytetään vain, kun Use SSL = Yes. | Yes / No · oletus No |
| Server CA chain (PEM format) | Brokerin varmenteen allekirjoittaneen varmentajan varmenne (varmenneketju). Napsauta Choose File ja valitse PEM-tiedosto. Kun se on tallennettu, kentässä näkyy sen sijaan Download-painike. | PEM-tiedosto |
| Client public certificate (PEM format) | Ohjaimen oma asiakasvarmenne brokereille, jotka todentavat asiakkaat varmenteella (molemminpuolinen TLS). Tarvitsee vastaavan yksityisen avaimen. | PEM-tiedosto |
| Client private key (PEM format) | Asiakasvarmenteen yksityinen avain. | PEM-tiedosto |
Asiakkaan yksityinen avain ja brokerin salasana antavat pääsyn brokeriisi. Säilytä tiedostot turvallisessa paikassa, älä lähetä niitä sähköpostilla äläkä jätä kopioita jaetuille tietokoneille. Kuka tahansa, jolla on pääsy tähän Configurator-sivuun, voi ladata tallennetut varmenteet ja nähdä salasanan.
Tallennetusta varmenteesta näkyy vain Download-painike. Jos haluat ladata toisen, napsauta Clear connection configuration ja syötä sitten koko yhteys uudelleen uusilla tiedostoilla.
Additional topics
| Parametri | Mitä se tekee | Yksikkö / oletus |
|---|---|---|
| Name or path | Julkaistava topic suhteessa polkuun controllers/<Unit ID>/. Esimerkiksi site/name julkaistaan muodossa controllers/<Unit ID>/site/name. Rivit, joilla nimi on tyhjä, ohitetaan. |
teksti |
| Payload | Kiinteä teksti, joka julkaistaan kyseisessä topicissa. | teksti |
| Add | Lisää tyhjän rivin. | — |
| Roskakorikuvake | Poistaa rivin. Tulee voimaan, kun napsautat Save. | — |
Lisätopicit julkaistaan yhdessä ohjaimen metatietojen kanssa: aina kun connector muodostaa yhteyden brokeriin ja aina kun broker lähettää viestin commands/refresh.
Julkaisu ja painikkeet
| Parametri | Mitä se tekee | Yksikkö / oletus |
|---|---|---|
| Readout interval | Kuinka usein ohjain julkaisee jokaisen laitteen lukeman ja asetusarvon sekä jokaisen strategian lukeman, tilan ja parametriarvot. Pienemmät arvot antavat tuoreempaa dataa mutta lisäävät liikennettä. | s · tyhjä = 60 s · vähintään 0,25 s |
| Tallenna | Tallentaa asetukset ja käynnistää connectorin uudelleen. Kirjataan kohtaan Audit log merkinnällä CONNECTOR_EDIT. |
— |
| Clear connection configuration | Vahvistuksen Are you sure to clear MQTT settings? (Yes / Cancel) jälkeen poistaa isännän, portin, käyttäjätunnuksen, salasanan, SSL-asetukset ja kaikki varmenteet. Connector kytkeytyy pois päältä. Asetukset Readout interval ja Additional topics säilyvät. | — |
Toiminnon Clear connection configuration jälkeen ohjain ei enää julkaise dataa eikä vastaanota komentoja MQTT:n kautta. Järjestelmä, joka tukeutuu dataan tai lähettää External EMS -aikatauluja, lakkaa vastaanottamasta tai toimittamasta niitä. Sinun on syötettävä salasana uudelleen ja ladattava varmenteet uudelleen, jotta yhteys muodostuu taas.
3 Topicit
Kaikki topicit alkavat polulla controllers/<Unit ID>/. Ohjain julkaisee QoS 0 -tasolla ilman retain-lippua ja tilaa komento-topicit QoS 1 -tasolla. Sisältö on JSON-muodossa tai pelkkinä arvoina; täydet sisältömuodot ovat tukikeskuksen artikkelissa "Reduxi Controller - MQTT API".
Ohjaimen julkaisemat:
| Topic | Sisältö | Milloin |
|---|---|---|
identifier |
Ohjaimen tunnistetiedot (unit ID, versiot, …) | Yhteyden muodostuessa ja viestillä commands/refresh
|
settings/interval/readout, settings/interval/keepAlive
|
Nykyiset aikavälit millisekunteina | Yhteyden muodostuessa ja päivityksen yhteydessä |
devices/list, devices/types, devices/<id>/info
|
Määritetyt laitteet ja niiden tyypit | Yhteyden muodostuessa ja päivityksen yhteydessä |
strategies/list, strategies/types, strategies/<id>/info, strategies/<id>/parameters/list, strategies/<id>/parameters/<id>/info
|
Määritetyt strategiat ja niiden parametrit | Yhteyden muodostuessa ja päivityksen yhteydessä |
<additional topic> |
Sisältö kohdasta Additional topics | Yhteyden muodostuessa ja päivityksen yhteydessä |
devices/<id>/readout |
Laitteen reaaliaikaiset arvot | Jokaisella lukuvälillä |
devices/<id>/setpoint |
Laitteen nykyinen asetusarvo | Jokaisella lukuvälillä |
strategies/<id>/active, strategies/<id>/readout, strategies/<id>/parameters/<id>/value
|
Strategian päälle/pois, reaaliaikaiset arvot, parametriarvot | Jokaisella lukuvälillä |
prices |
Sähkön hinnat tälle päivälle ja huomiselle | Yhteyden muodostuessa, hintojen muuttuessa ja viestillä prices/refresh
|
strategies/<id>/externalEMS/<type> |
Tallennettu External EMS -aikataulu (battery, evse, hvac, pv) |
Viestillä …/externalEMS/<type>/refresh
|
keepAlive |
Nykyinen aika (Unix ms) | Jokaisella keep-alive-välillä, oletus 60 s |
Komennot, jotka ohjain hyväksyy:
| Topic | Vaikutus |
|---|---|
commands/refresh |
Julkaisee metatieto-topicit uudelleen. |
commands/reboot |
Käynnistää ohjaimen uudelleen noin 5 sekunnin kuluttua. |
prices/refresh |
Julkaisee topicin prices uudelleen. |
settings/interval/readout/set |
Muuttaa lukuvälin (ms) ja tallentaa sen. |
settings/interval/keepAlive/set |
Muuttaa keep-alive-välin (ms) ja tallentaa sen. |
devices/<id>/setpoint/set |
Asettaa laitteen asetusarvon. |
strategies/<id>/parameters/<id>/value/set |
Asettaa strategian parametrin. |
strategies/<id>/active/set |
Kytkee strategian päälle tai pois. |
strategies/<id>/externalEMS/<type>/set |
Lataa External EMS -aikataulun kohteille battery, evse, hvac tai pv. Ohitetaan, ellei strategialla ole optimointitilaa External EMS. |
strategies/<id>/externalEMS/<type>/refresh |
Julkaisee tallennetun External EMS -aikataulun. |
settings/grid/set |
Muuttaa verkkoliitynnän asetuksia (sijainti, sulakkeet, tuonti- ja vientiraja), halutessa myös valituissa strategioissa. |
settings/grid/set ylikirjoittaa kohdan Settings → Grid arvot ja pyydettäessä strategioiden rajat – sama vaikutus kuin Grid-asetussivun tallentamisella. devices/<id>/setpoint/set kirjoittaa asetusarvon suoraan laitteelle. Älä lähetä asetusarvoja laitteelle, jota myös strategia ohjaa, tai ne ylikirjoittavat toisensa.
4 Vianmääritys
| Oire | Mitä tarkistaa |
|---|---|
| Connected pysyy punaisena | Host ja Port ovat oikein; ohjain tavoittaa brokerin (TCP port test brokerin isännällä ja portilla); käyttäjätunnus ja salasana; TLS:n kanssa CA-ketju vastaa brokerin varmennetta, tai kokeile arvoa Verify server cert = No ongelman rajaamiseksi. |
| Yhteys on muodostettu, mutta brokerilla ei ole dataa | Tilaa controllers/# ja tarkista arvo Client: topicit käyttävät Unit ID:tä täsmälleen siinä näkyvässä muodossa. |
| Komennoilla ei ole vaikutusta | Niitä lähettävällä asiakkaalla on julkaisuoikeus brokerilla; topicissa on oikea laitteen tai strategian ID (katso devices/list, strategies/list). |
5 Tarkistuslista
- Host ja Port vastaavat brokeria, ja Connected näyttää vihreän valintamerkin päivityksen jälkeen.
- Tuotantokohteissa: Use SSL = Yes, CA-ketju on ladattu ja Verify server cert = Yes.
- Data saapuu polun
controllers/<Unit ID>/alle määritetyllä Readout interval -välillä. - Kirjoitusoikeus komento-topiceihin on rajattu luotetuille asiakkaille brokerilla.
- Varmennetiedostot ja salasanat säilytetään turvallisesti ohjaimen ulkopuolella.