Lähetä Home Assistantin energiadatan pilveen | IAMMETER-Link

Lähetä Home Assistantin energiadatan pilveen IAMMETER-Linkillä

Jos invertteri, sähkömittari, akkujärjestelmä tai muu energialaite tarjoaa jo sensorientiteettejä Home Assistantissa, IAMMETER-Link voi lähettää nämä arvot IAMMETERin virtuaalimittariin pilvikojelautoja, etäkäyttöä ja energia-analyysiä varten.

Tämä tekee Home Assistantista yhteensopivuussillan:

Energialaite → Home Assistantin entiteetit → IAMMETER-Link → virtuaalimittari → IAMMETER Cloud

Lähdelaitteen ei tarvitse olla IAMMETER-mittari. Se voi olla mikä tahansa laite, jonka Home Assistant jo integroi, kunhan sen entiteetit tarjoavat kelvollisia ja oikein skaalattuja energiamittauksia.

IAMMETER-Link on hyödyllinen, kun haluat yhdistää Home Assistantin laajan laiteyhteensopivuuden IAMMETER Cloudin energia- ja aurinkosähkön seurantapalveluihin.

Mitä IAMMETER-Link tekee—ja mitä se ei tee

IAMMETER-Link lukee valitut entiteetit Home Assistantista ja lähettää niiden senhetkiset arvot IAMMETERin virtuaalimittariin.

Se voi kartoittaa esimerkiksi seuraavia arvoja:

• jännite (V);
• virta (A);
• pätöteho (W);
• tuotu energia (kWh);
• viety energia (kWh);
• akun varaustila, jos määritetty tietomalli tukee sitä.

Se ei:

• lue IAMMETER-laitemittaria suoraan HTTP-, Modbus- tai MQTT-yhteydellä;
• luo puuttuvia energiamittauksia aiheeseen liittymättömästä tehoentiteetistä;
• muuta IAMMETER Cloudia täysin paikalliseksi palveluksi;
• korvaa lähdelaitteen alkuperäistä Home Assistant -integraatiota.

Jos haluat tuoda IAMMETER-laitemittarin Home Assistantiin, käytä Home Assistant -energiamittarin integraatio-opasta. IAMMETER-Link lähettää dataa vastakkaiseen suuntaan.

Milloin pilvipohjainen energianseuranta Home Assistantin kautta on hyödyllistä

Kolmannen osapuolen invertteri on jo Home Assistantissa

Monet invertterit tarjoavat jo tuotantotehon ja kumulatiivisen energian Home Assistant -integraation kautta. IAMMETER-Link voi kartoittaa nämä entiteetit virtuaalimittariin, jolloin invertteridataa voidaan tarkastella IAMMETER Cloudissa ilman, että datansiirtoa varten tarvitaan toista fyysistä mittaria.

Verkko- ja invertteridata tulevat eri integraatioista

Esimerkiksi:

• IAMMETER-mittari valvoo verkon tuontia/vientiä;
• kolmannen osapuolen invertteri-integraatio tarjoaa aurinkosähkön tuotannon Home Assistantissa;
• IAMMETER-Link lähettää invertterientiteetit virtuaalimittarina;
• IAMMETER Cloud näyttää verkko- ja invertteripuolen datan aurinkosähkön seurannan työnkulussa.

Tämä on erityisen hyödyllistä, kun yksi alusta ei tue natiivisti kaikkia invertterimerkkejä.

Etä- tai monipaikkakäyttö vaaditaan

Home Assistant voi pysyä paikallisena integraatiokeskuksena jokaisessa asennuksessa, kun taas valitut energiamittaukset lähetetään IAMMETER Cloudiin etäkojelautoja ja pitkäaikaisempaa analyysiä varten.

Tarkka sivuston ja virtuaalimittarin rakenne tulisi suunnitella ennen käyttöönottoa. Älä kartoita useita erillisiä järjestelmiä samaan virtuaalimittarin sarjanumeroon.

Vaatimukset

Varmista ennen asennusta, että sinulla on:

• toimiva Home Assistant -asennus;
• vakaat lähdeentiteetit vaadittuja mittauksia varten;
• internetyhteys Home Assistantista IAMMETER Cloudiin;
• IAMMETER Cloud -tili;
• IAMMETERin virtuaalimittarin sarjanumero;
• HACS, ellet valitse manuaalista mukautetun komponentin asennusta.

IAMMETER-Linkin säilö:

• GitHub-säilö
• Nykyinen julkaisu v1.1.1

Julkaisu v1.1.1 sisältää optimoidun lähetyslogiikan ja varaustilan (state of charge) käsittelyn.

Lähetysväli: Basic ja Pro

Lähetysväli riippuu IAMMETER Cloudin palvelutasosta:

IAMMETER-Link on tarkoitettu pilviraportointiin ja etävalvontaan, ei sekuntitason ohjaussilmukoihin. Pidä nopeat automaatiot Home Assistantissa käyttämällä alkuperäisiä paikallisia entiteettejä.

Esimerkiksi:

• käytä paikallista Modbus- tai MQTT-tehoentiteettiä 2–5 sekunnin automaatioon;
• käytä IAMMETER-Linkiä 1–5 minuutin pilvipäivityksiin ja analyysiin.

Vaihe 1: Asenna IAMMETER-Link

Asentaminen HACS:n avulla

1. Varmista, että HACS on asennettu.
2. Lisää https://github.com/lewei50/ha_iammeter_link Integraationa HACS:n mukautettuihin säilöihin, jos se ei ole jo saatavilla.
3. Etsi ja asenna IAMMETER-Link.
4. Käynnistä Home Assistant uudelleen tarvittaessa.

Lisää integraatio

Siirry kohtaan:

Asetukset → Laitteet ja palvelut → Lisää integraatio

Etsi IAMMETER-Link ja käynnistä määritysvelho.

Vaihe 2: Kirjaudu sisään ja valitse virtuaalimittari

Anna IAMMETER Cloud -tilisi tiedot asennuksen aikana. Jos sinulla ei ole tiliä, seuraa määritysvelhon tarjoamaa rekisteröitymisvaihtoehtoa.

Jos tilillä on jo käytettävissä oleva virtuaalimittari, valitse sen sarjanumero. Muussa tapauksessa pyydä tai luo sopiva virtuaalimittari käytettävissä olevan IAMMETER Cloud -työnkulun kautta.

Käsittele virtuaalimittarin sarjanumeroa tämän datavirran kohde-identiteettinä. Vältä määrittämästä useita lähetysasiakkaita kirjoittamaan eri järjestelmiä samaan virtuaalimittariin.

Vaihe 3: Valitse yksivaiheinen tai kolmivaiheinen

Valitse rakenne, joka vastaa lähdedataa:

• Single Phase yhdelle jännite-, virta-, teho-, tuonti-kWh- ja vienti-kWh-ryhmälle;
• Three Phase erillisille A-, B- ja C-entiteettikartoituksille.

Kolmivaihedatassa määrittele kunkin vaiheen rooli ja kartoitus huolellisesti. IAMMETER Cloud käyttää tätä rakennetta näyttäessään ja analysoidessaan lähetettyjä arvoja.

Älä valitse kolmivaiheista pelkästään siksi, että Home Assistantissa on useita sensoreita. Entiteettien on vastattava vastaavia sähkövaiheita tai mittauskanavia.

Vaihe 4: Kartoita Home Assistantin entiteetit

IAMMETER-Link kartoittaa Home Assistantin entiteettitunnukset virtuaalimittarin kenttiin.

Yksivaiheinen kartoitus

Kolmivaiheinen kartoitus

Kartoita samat kentät erikseen vaiheille A, B ja C.

Käyttämättömän kentän arvoksi voidaan asettaa 0. Jos kenttä on kuitenkin kartoitettu entiteettiin eikä sitä voida lukea oikein ajonaikaisesti, lähetysprosessi voi pysähtyä. Kartoita vain entiteettejä, joiden on todettu olevan vakaita.

Vahvista jokainen entiteetti ennen kartoitusta

Avaa Kehittäjätyökalut → Tilat Home Assistantissa ja varmista:

1. entiteetti on olemassa;
2. sen tila on numeerinen;
3. yksikkö on oikea;
4. arvon etumerkki on odotettu;
5. se pysyy saatavilla Home Assistantin uudelleenkäynnistyksen jälkeen;
6. kumulatiivinen energia ei käyttäydy kuin hetkellinen teho.

Tehon on oltava watteina

Jos lähde ilmoittaa kW, luo sopiva muunnettu sensori tai käytä oikein skaalattua entiteettiä ennen kartoitusta. Älä merkitse kW-arvoa W:ksi kertomatta sitä luvulla 1 000.

Energian on oltava kumulatiivista kWh:ta

Tuonti- ja vientikentissä tulisi normaalisti käyttää kumulatiivisia kWh-entiteettejä. Päivittäinen energiasensori, joka nollautuu keskiyöllä, eroaa semantiikaltaan koko käyttöiän kokonaismäärästä ja voi vääristää pilvianalyysiä, jos sitä käsitellään kokonaisenergiana.

Vahvista tuonnin/viennin suunta

Eri integraatiot käyttävät termejä kuten import, kulutus, syöttö, paluu, vienti, ostettu tai myyty. Varmista, mitä suuntaa kukin entiteetti edustaa ennen kartoitusta.

Älä keksi mittauksia, joita ei ole saatavilla

Jos invertteri-integraatio tarjoaa aurinkosähkön tuotannon mutta ei verkon tuontia/vientiä, kartoita käytettävissä olevat tuotantokentät sopivaan virtuaalimittarin rooliin. Älä käytä samaa tehoentiteettiä sekä tuotantona että verkkotehona pelkästään täyttääksesi kaikki kentät.

Vaihe 5: Varmista lähetetty data IAMMETER Cloudissa

Kun määritys on valmis, odota kyseisen Basic- tai Pro-tason lähetysväli ja avaa sitten IAMMETER Cloud.

Tarkista:

• virtuaalimittari on online-tilassa;
• jännitteen, virran ja tehon suuruudet ovat järkeviä;
• tuonti ja vienti eivät ole vaihtuneet keskenään;
• vaiheet A/B/C näkyvät odotetussa järjestyksessä;
• kumulatiivinen energia kasvaa oikein;
• aikaleimat päivittyvät edelleen;
• aurinkosähkö- tai kuormituskaaviot vastaavat lähde-Home Assistantin historiaa.

Vertaa useita aikaleimoja Home Assistantin ja IAMMETER Cloudin välillä ennen kuin luotat raportteihin.

Esimerkki aurinkosähkön seurannasta

Oletetaan, että asennuksessa on:

• IAMMETERin kolmivaihemittari mittaamassa verkkoa;
• kolmivaiheinen invertteri, joka on jo integroitu Home Assistantiin;
• ei suoraa tuettua datayhteyttä kyseisen invertterin ja IAMMETER Cloudin välillä.

IAMMETER-Link voi lähettää invertterin Home Assistant -teho- ja energiaentiteetit kolmivaiheiseen virtuaalimittariin. IAMMETER Cloud voi sitten käyttää:

• fyysistä mittaria verkkovuorovaikutukseen;
• virtuaalimittaria invertterin tuotantoon;
• molempia datalähteitä laajemmassa aurinkosähkön seurantanäkymässä.

Katso IAMMETERin aurinkosähkön seurantaratkaisu ja Home Assistant -aurinkosähkön seuranta liittyvistä käyttötapauksista.

Vianmääritys

Asennuksen jälkeen ei näy dataa

• Varmista, että Home Assistantilla on internetyhteys.
• Tarkista IAMMETER Cloud -tili ja virtuaalimittarin sarjanumero.
• Odota koko Basic- tai Pro-tason lähetysväli.
• Tarkista Home Assistantin lokit IAMMETER-Linkin virheiden varalta.
• Varmista, että jokainen kartoitettu entiteetti on olemassa ja palauttaa numeerisen arvon.

Lähetys pysähtyy normaalin toiminnan jälkeen

• Etsi kartoitettu entiteetti, joka on muuttunut unknown- tai unavailable-tilaan.
• Tarkista, onko integraatiopäivitys nimennyt entiteettitunnuksen uudelleen.
• Varmista, että mallisensori (template sensor) tuottaa edelleen numeron.
• Tarkista todennus- ja verkkovirheet.
• Päivitä uusimpaan IAMMETER-Link-julkaisuun.

Arvot ovat 1 000 kertaa liian suuria tai pieniä

• Tarkista W vs. kW.
• Tarkista kWh vs. Wh.
• Tarkista mahdollinen Home Assistantissa käytetty mallimuunnos (template conversion).
• Varmista ulkoiset CT-suhteet lähdemittausjärjestelmässä.

Tuonti ja vienti ovat vaihtuneet keskenään

• Tarkista lähdeintegraation nimeämiskäytäntö.
• Vertaa arvoa silloin, kun kohde selvästi tuo verkosta tai vie verkkoon.
• Korjaa entiteettikartoitus sen sijaan, että kompensoit pilviraporteissa.

Kolmivaihekaaviot näyttävät virheellisiltä

• Varmista A/B/C-kartoitus ja vaiheroolit.
• Varmista, että jokainen entiteetti kuuluu aiottuun vaiheeseen.
• Älä sekoita kokonaistehoa vaihekohtaisiin kenttiin.

Paikallinen ohjaus ja pilviraportointi tulisi pitää erillään

IAMMETER-Link on riippuvainen Home Assistantista, internetyhteydestä ja IAMMETER Cloudista. Sen ei tulisi olla takaisinkytkentäpolku turvallisuuskriittisille tai sekuntitason automaatioille.

Käytä paikallisia Home Assistant -entiteettejä:

• releohjaukseen;
• aurinkosähkön ylijäämän kytkentään;
• EV-latauspäätöksiin;
• hälytyksiin, jotka vaativat välitöntä reagointia.

Käytä IAMMETER-Linkiä ja IAMMETER Cloudia:

• etänäkyvyyteen;
• pitkäaikaisempiin kojelautoihin;
• sähkökustannus- ja energia-analyysiin;
• valittujen energialähteiden yhdistämiseen;
• monipaikkaiseen toiminnan tarkasteluun.

Aiheeseen liittyvät oppaat

• IAMMETER-Linkin GitHub-säilö
• IAMMETER-Link v1.1.1
• IAMMETERin virtuaalimittari
• IAMMETER Cloud
• Vertaa Home Assistant -energiamittari-integraatioita
• Home Assistant -integraatiomatriisi

Päivitetty: 22. heinäkuuta 2026.