MQTT-tiedonsiirto (MQTT-gateway)

Wattery Link toimii MQTT-gatewayna: se lukee siihen liitetyt energiamittarit ja julkaisee niiden lukemat MQTT-välittäjälle (broker). Mittarilukemat ja MQTT-tiedonsiirto ovat paikallisen latauksen ohella Linkin päätoimintoja. Linkin asetussivulla MQTT-tiedonsiirto löytyy kohdasta Send readings to MQTT.

MQTT-tiedonsiirto toimii sekä RS485-mittarien että lähiverkon kautta luettavien mittarien kanssa. Latauksen määrittäminen on valinnaista, joten Linkiä voi käyttää myös pelkkään mittarien etäluentaan.

Mitä Link lähettää

Link julkaisee lähetysvälin mukaan yhden viestin, jossa ovat kaikkien mittarien lukemat. Jokaisen mittarin lukemat on merkitty mittarin Slave ID:llä. Viestissä on sen lähetysaika, ja jokaisella mittarilla on lisäksi oma lukuaikansa. Kun mittareita on paljon, lukuajat voivat poiketa toisistaan muutamia sekunteja.

Tieto	Yksikkö
Mittarimallin koodi	–
Virta vaiheittain (L1, L2, L3)	A
Pätöteho vaiheittain (L1, L2, L3)	kW
Jännite vaiheittain (L1, L2, L3)	V
Otettu pätöenergia, mittarin kertynyt kokonaislukema	kWh
Aikaleimat	Unix-aika sekunteina

Jännite ja energia julkaistaan vain, jos mittarimallin rekisterikartta sisältää ne ja mittari vastaa niihin. Virrat ja tehot julkaistaan silloinkin, kun jännite tai energia puuttuu. Jos jännitettä ei saada luettua, myös energia jätetään pois. GARO Entity Balance raportoi vain vaihevirrat.

Puuttuva tieto ei ole nolla

Puuttuva jännite- tai energiatieto ei tarkoita nollaa. Tarkista mittarimallin tukemat mittaukset ennen kuin etsit vikaa puuttuvasta tiedosta.

Mittarin virhe

Jos määritettyä mittaria ei saada luettua, viestissä on sen kohdalla virhe lukemien sijaan. Näin viallinen mittari erottuu mittarista, jota ei ole määritetty. Virhe kertoo syyn:

Syy	Ensimmäinen tarkistus
Mittari ei vastaa virran tai tehon lukuun	Slave ID, kytkentä ja RS485-asetukset
Mittari vastasi, mutta ei kaikkien kolmen vaiheen tietoja	Mallivalinta ja saadut lukemat
Mittarimallia ei löydy rekisterikartasta	Ajantasainen tuettujen mallien luettelo
Verkkomittarin osoite tai salasana puuttuu tai on väärä, tai mittarin lukeminen verkon kautta epäonnistuu tai aikakatkaistaan	Mittarin osoite, salasana ja verkkoyhteys

Laitteen tila

Link pitää MQTT-välittäjällä pysyvää tilaviestiä, josta näkee:

• onko Link verkossa
• Linkin ohjelmistoversion ja toimitusasetusten palautusversion
• kohteen tiedot: kohteen nimen ja osoitteen sekä asentajan nimen ja sähköpostiosoitteen.

Jos Link putoaa verkosta, välittäjä julkaisee tilaksi "offline" samoilla kohdetiedoilla. Näin yhteyskatkon aikana tiedetään, mistä kohteesta on kyse ja keneen voi ottaa yhteyttä.

Watteryn komennot

Wattery lähettää Linkille etähallintakomentoja MQTT:n kautta, ja Link vastaa niihin samaa reittiä. Komennot vaativat toimivan yhteyden välittäjään. Jos Watteryn etätuki (Allow remote support) kytketään pois, myös Watteryn MQTT-komennot pysähtyvät. Lukemat lähetetään silti.

Asetukset

Avaa Meters & data → Send readings to MQTT → Broker settings. Toimitettaessa asetukset voivat olla valmiiksi määritetyt Watteryn palvelulle.

Kenttä	Merkitys
Broker host	MQTT-välittäjän palvelinnimi tai osoite.
Port	Välittäjän kuunteluportti, 1–65535. Käytä palvelulle annettua arvoa.
Use TLS	Aina käytössä. Välittäjän varmenne ja nimi tarkistetaan. Salaamatonta MQTT:tä ei tueta.
Topic	Perusaihe. Lukemat, laitteen tila ja komennot käyttävät tätä perusaihetta.
Username / Password	MQTT-tunnukset. Tallennettua salasanaa ei näytetä. Tyhjä salasanakenttä säilyttää tallennetun salasanan, kun yhteyden muut tiedot pysyvät samoina.
Wattery Link client ID	Linkin MQTT-tunnus. Näkyy asetussivun yläreunassa nimellä Device ID.
Send interval (seconds)	Kuinka usein kaikkien mittarien lukemat julkaistaan. Vähintään 1 sekunti.

Tallenna asetukset painikkeella Save changes. Sama painike tallentaa samalla kohteen tiedot, mittariluettelon ja uudelleenkäynnistyksen ajastuksen, joten tarkista kaikki muutokset ennen tallennusta. Odota onnistumisilmoitusta: kentässä näkyvä arvo ei yksin tarkoita, että se on tallennettu.

Uusi palvelin vaatii salasanan

Jos muutat palvelinta, porttia tai käyttäjänimeä, anna myös uuden yhteyden salasana. Peitetty tai tyhjä salasanakenttä ei varmista, että uudet tunnukset tallentuvat.

Kohteen tiedot

Täytä Overview-sivulla kentät Site name, Site address, Installer name ja Installer email. Kuhunkin kenttään mahtuu 120 merkkiä. Tiedot julkaistaan laitteen tilaviestissä. Jätä tuntemattomat tiedot tyhjiksi.

Yhteyden testaaminen

1. Tarkista MQTT-kentät, paina Save changes ja odota onnistumisilmoitusta.
2. Paina Test MQTT. Link lähettää yhden testiviestin tallennetuilla asetuksilla.
3. Lue tulos. Jos testi epäonnistuu, tarkista verkkoyhteys, palvelin, TLS-portti, tunnukset ja aiheen käyttöoikeudet.
4. Varmista koko tiedonsiirtoketju: testaa jokainen mittari sen rivin Test-painikkeella ja tarkista, että mittarien lukemat saapuvat vastaanottavaan järjestelmään.

Tarkistus	Mitä se varmistaa
Mittarin Test	Lukee mittarin heti rivin asetuksilla. Ei tallenna eikä julkaise lukemaa.
Test MQTT	Lähettää testiviestin tallennetuilla MQTT-asetuksilla. Ei lue mittaria.

Onnistunut Test MQTT ei varmista, että mittarit on määritetty oikein tai että lukemat ovat oikeita.

Tiedonsiirron kytkeminen pois

Kytkin Connect to the broker sulkee MQTT-yhteyden kokonaan. Kun se on pois päältä:

• Link ei lähetä lukemia, tilaa eikä päivitystarkistuksia
• Wattery ei voi lähettää laitteelle komentoja
• ohjelmistopäivityksiä ei voi tarkistaa painikkeella Check firmware update.

Mittareita luetaan silti kuormanhallintaa ja asetussivua varten. Asetus säilyy uudelleenkäynnistysten ja päivitysten jälkeen.

Lukemia ei julkaista myöskään silloin, kun Link on otettu käyttöön ilman verkkoyhteyttä (Use without internet). Katso Verkkoyhteydet.

Palautus toimitusasetuksiin palauttaa välittäjän asetukset ja Connect to the broker -kytkimen toimitushetken tilaan. Katso Salasanat ja palautus.

Välittäjän vaihtaminen

Palvelimen, aiheen tai tunnusten muuttaminen voi katkaista Watteryn automaattisen etähallinnan.

Watteryn etätuki ja MQTT ovat erillisiä yhteyksiä. Etätuki voi näyttää toimivalta, vaikka komennot ja lukemat eivät pääse välittäjälle, joten toimiva etätuki ei varmista MQTT-tiedonsiirtoa.

Vianetsintä

Oire	Tarkistus
Mittarin Test onnistuu, mutta lukemat eivät saavu	Tallenna mittariluettelo. Tarkista verkkoyhteys ja tallennetut MQTT-asetukset, paina Test MQTT ja tarkista sitten, saapuvatko mittarin lukemat vastaanottavaan järjestelmään.
Test MQTT epäonnistuu	Tarkista yhteys, palvelin, TLS-portti, käyttäjänimi, salasana ja aiheen käyttöoikeudet. Tallenna muutokset ennen uutta testiä.
Etätuki toimii, mutta komennot eivät	Etätuki ja MQTT ovat erillisiä. Tarkista välittäjä, tunnukset ja perusaihe. Etätuen kytkeminen pois pysäyttää myös MQTT-komennot.
Jännite tai energia puuttuu	Tiedot ovat valinnaisia. Tarkista, tukeeko mittarimalli niitä ja vastaavatko rekisterit. Virrat ja tehot julkaistaan silti.
Mittarin kohdalla on virhe	Katso Mittarin virhe.

Kirjaa asennuksen luovutuksessa MQTT-palvelin, perusaihe ja lähetysväli sekä se, että Test MQTT onnistui, tai että Link on käytössä ilman internetiä.