Home Assistant Modbus TCP -energiamittarin asennusopas

Home Assistant Modbus TCP -energiamittarin integraatio

Modbus TCP on yksi nopeimmista tavoista yhdistää energiamittari Home Assistantiin. Se toimii paikallisessa verkossa eikä riipu internetyhteydestä, ja se soveltuu reaaliaikaiseen tehonseurantaan, aurinkoylijäämäautomaatioon, kuormanohjaukseen sekä Home Assistantin Energy Dashboardiin.

Kaikki nykyiset IAMMETER-energiamittarit tukevat Modbus TCP:tä. Voit integroida ne Home Assistantiin kahdella tavalla:

1. IAMMETER HACS Modbus -integraatio — käyttöliittymäkonfiguraatio, automaattisesti luodut entiteetit ja säädettävä skannausväli.
2. Home Assistantin sisäänrakennettu Modbus-integraatio — YAML-konfiguraatio, jolla voit ohjata rekistereitä ja antureita suoraan.

Tämä opas selittää erot ja auttaa valitsemaan oikean menetelmän.

HACS Modbus vai Home Assistantin sisäänrakennettu Modbus?

Molemmat menetelmät lukevat samaa paikallista Modbus TCP -dataa mittarista. Suurin ero on siinä, miten Home Assistantin entiteetit määritetään.

Useimmille käyttäjille HACS Modbus -integraatio on yksinkertaisempi vaihtoehto. Käytä Home Assistantin sisäänrakennettua Modbus-integraatiota, kun tarvitset mukautetun rekisteriluettelon, entiteettien nimeämiskäytännön, skaalaussäännön tai kyselyvälin yksittäisille antureille.

Jos et tarvitse nopeita päivityksiä, vertaa HTTP- ja MQTT-vaihtoehtoja Home Assistant -energiamittarin integraation yleiskatsauksessa.

Ennen aloittamista

Tarvitset:

• IAMMETER-energiamittarin, joka on yhdistetty samaan lähiverkkoon Home Assistantin kanssa;
• mittarin paikallisen IP-osoitteen;
• TCP-portin 502, jonka on oltava avoinna Home Assistantin ja mittarin välillä;
• ajantasaisen mittarin laiteohjelmistoversion;
• HACS:n asennettuna, jos valitset IAMMETER HACS -integraation.

On hyvä idea varata mittarin IP-osoite reitittimessä. Muuttuva DHCP-osoite on yleinen syy sille, että toimiva Modbus-integraatio lakkaa myöhemmin toimimasta.

Menetelmä 1: IAMMETER Modbusin määritys HACS:n kautta

IAMMETER HACS Modbus -integraatio on suunniteltu käyttäjille, jotka haluavat nopeaa paikallista dataa ilman jokaisen rekisterin manuaalista määrittelyä YAML:ssä.

Vaihe 1: Asenna integraatio

1. Avaa HACS Home Assistantissa.
2. Hae IamMeter Modbus.
3. Asenna uusin julkaisu.
4. Käynnistä Home Assistant uudelleen, jos järjestelmä kehottaa.

Projektin ja julkaisujen tiedot:

• IAMMETER HACS Modbus -säilö
• IAMMETER HACS Modbus -julkaisut

Käytä uusinta saatavilla olevaa julkaisua. Päivitetty integraatio tukee skannausväliasetusta, ja se välitetään DataUpdateCoordinatorille.

Vaihe 2: Lisää mittari Home Assistantiin

1. Siirry kohtaan Asetukset → Laitteet ja palvelut.
2. Valitse Lisää integraatio.
3. Hae IamMeter Modbus.
4. Syötä mittarin IP-osoite ja Modbus TCP -portti.
5. Valitse sopiva mittarityyppi tai vaihekonfiguraatio.
6. Aseta skannausväli tai pidä oletusarvo 3 sekuntia.
7. Lähetä lomake ja varmista, että laite ja entiteetit on luotu.

Integraatio luo eri määrän entiteettejä yksivaiheisille, kaksikanavaisille ja kolmivaiheisille mittareille. Lyhyempi entiteettiluettelo ei tarkoita, että yksivaiheisen mallin Home Assistant -tuki olisi rajoitettu.

Vaihe 3: Tarkista entiteetit

Avaa IAMMETER-laite kohdassa Asetukset → Laitteet ja palvelut. Mallista riippuen käytettävissä olevat entiteetit voivat sisältää:

• jännitettä;
• virtaa;
• pätötehoa;
• tehokerrointa;
• tuotua energiaa;
• vietyä energiaa;
• loistehoa tai loistehoenergiaa, jos sovellettava mittari ja rekisterisarja tarjoavat ne.

Tuodun ja viedyn energian entiteetit käyttävät kWh-yksikköä ja sisältävät Energy Dashboardin vaatimat Home Assistant -energiametatiedot.

Vaihe 4: Valitse sopiva skannausväli

Oletusskannausväli on 3 sekuntia. Se on käytännöllinen lähtökohta reaaliaikaisille kojelaudoille ja tehoperusteisille automaatioille.

Suositellut lähtökohdat:

Yhden sekunnin asetus on kyselypyyntö, ei takuu siitä, että jokainen Home Assistant -kojetaulu päivittyy näkyvästi kerran sekunnissa. Verkon viive, rekisterien määrä, recorder-kuormitus ja käyttöliittymän päivityskäyttäytyminen vaikuttavat myös tulokseen.

Vältä tarpeetonta aggressiivista kyselyä. Useimpien automaatioiden kannalta vakaa 2–5 sekunnin päivitys on hyödyllisempi kuin lyhin mahdollinen väli.

Menetelmä 2: Home Assistantin sisäänrakennetun Modbus-integraation käyttö

Home Assistant sisältää vakio-Modbus-integraation. Tämä menetelmä toimii täysin paikallisesti eikä vaadi HACS:ia, mutta yhteys ja anturit määritellään YAML:ssä.

Seuraava esimerkki lukee jännitteen ja pätötehon yksivaiheisesta mittarista:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

Korvaa 192.168.1.6 mittarin todellisella IP-osoitteella. Tarkista sovellettava rekisterikartta ennen kuin lisäät lisää antureita:

• IAMMETER Modbus TCP -rekisterikartta
• Home Assistantin Modbus-dokumentaatio

Yleiset IAMMETER Modbus -rekisterit

Seuraavat osoitteet havainnollistavat vakio-vaihelohkoja, joita yleiset IAMMETER-mittarit käyttävät. Käytä aina ajantasaista rekisteridokumentaatiota ensisijaisena lähteenä.

Käytä kunkin rekisterin dokumentoitua skaalausta, tarkkuutta ja sanajärjestystä. Älä päättele energian skaalausta jännite-esimerkistä.

YAML:n muokkaamisen jälkeen:

1. suorita Home Assistantin konfiguraatiotarkistus;
2. käynnistä Home Assistant uudelleen;
3. avaa Kehitystyökalut → Tilat;
4. varmista, että uusilla entiteeteillä on järkevät arvot ja yksiköt.

Tuodun ja viedyn energian lisääminen Energy Dashboardiin

Home Assistantin Energy Dashboard tarvitsee kumulatiivisia energiaentiteettejä, ei hetkellistä tehoa.

Manuaalisesti määritettyä Modbus-energia-anturia varten lisää asianmukaiset metatiedot:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Siirry sitten kohtaan Asetukset → Hallintapaneelit → Energia ja valitse tuotu energia -entiteetti verkonkulutukseksi ja viety energia -entiteetti verkkoon palautukseksi.

Älä valitse watteina mitattua pätötehoentiteettiä Energy Dashboardin energiakenttään. Teho näyttää hetkellisen nopeuden; tuotu/viety kWh tallentaa kumulatiivisen energian.

Tuetut IAMMETER-mallit

Kaikki nykyiset IAMMETER-energiamittarit tukevat sekä HACS Modbus - että Home Assistantin sisäänrakennettua Modbus-integraatiota.

WEM3046T ja WEM3046TE mittaavat ulkoisen virtamuuntajan 5 A:n toisiolähdön. Jotta ensiöpuolen todellinen virta, teho ja energia saadaan, on käytettävä oikeaa CT-suhdetta. Tämä on 5 A CT -mittausjärjestelmän ominaisuus, ei Home Assistant- tai Modbus-yhteensopivuusrajoitus.

Voivatko Modbus ja IAMMETER Cloud toimia samanaikaisesti?

Kyllä. Home Assistant lukee Modbus TCP:tä paikallisesti, kun mittari voi jatkaa tietojen lähettämistä IAMMETER Cloudiin. Sinun ei tarvitse vaihtaa mittaria MQTT-lähetystilaan käyttääksesi Modbusia.

Tämä antaa kaksi toisiaan täydentävää näkymää:

• nopean paikallisen datan ja automaatiot Home Assistantissa;
• pitkäaikaiset raportit, sähkökustannusanalyysit, aurinkoanalyysit ja etäkäytön IAMMETER Cloudissa.

Vältä useita korkeataajuisia Modbus-asiakkaita

Käytä yhtä aktiivista Modbus TCP -kyselyasiakasta mittaria kohden turvallisena käyttöönottomallina. Älä määritä Home Assistantia, Node-RED:iä, PLC:tä ja toista loggeria kysymään samaa mittaria itsenäisesti korkealla taajuudella.

Jos useat järjestelmät tarvitsevat samoja reaaliaikaisia mittauksia, anna yhden järjestelmän lukea Modbus ja jakaa data edelleen tai käytä MQTT-arkkitehtuuria, jossa useat kuluttajat tilaavat brokerilta.

Vianmääritys

Home Assistant ei voi muodostaa yhteyttä porttiin 502

• Varmista, että Home Assistant ja mittari ovat samassa tavoitettavassa verkossa.
• Tarkista mittarin IP-osoite ja varaa se reitittimessä.
• Tarkista, ettei palomuuri tai VLAN-sääntö estä TCP-porttia 502.
• Varmista, ettei toinen Modbus-asiakas pidä yhteyttä hallussaan tai avaa sitä toistuvasti uudelleen.

Entiteetit eivät ole käytettävissä tai arvot eivät muutu

• Varmista valittu mittari-/vaihetyyppi HACS-integraatiossa.
• Tarkista YAML:ssä slave-tunnus, rekisteriosoite, tietotyyppi, skaalaus ja sanajärjestys.
• Suurenna skannausväliä väliaikaisesti sulkeaksesi pois liian aggressiivisen kyselyn.
• Käynnistä integraatio uudelleen mittarin IP-osoitteen vaihtamisen jälkeen.

Arvot ovat epäuskottavan korkeita tai matalia

• Tarkista rekisterin skaalaus ja tietotyyppi.
• Varmista WEM3046T/WEM3046TE-mallien ulkoinen CT-suhde.
• Varmista, että entiteetti vastaa odotettua vaihetta tai mittauskanavaa.

Energiaentiteetit eivät näy Energy Dashboardissa

• Käytä kumulatiivista tuotua/vietyä energiaa kWh-yksiköissä.
• Varmista device_class: energy.
• Varmista state_class: total_increasing.
• Älä käytä watteina ilmaistua tehoentiteettiä.

Rakenna automaatioita reaaliaikaisella tehodatalla

Kun Modbus-entiteetit toimivat, Home Assistant voi käyttää pätötehoa tai verkkoon syötettyä tehoa muiden laitteiden ohjaamiseen. Esimerkkejä:

• ohjaa relettä reaaliaikaisella Modbus-tehodatalla;
• lataa sähköautoa, kun aurinkosähkön vienti ylittää kynnyksen;
• lämmitä vettä käytettävissä olevalla aurinkoylijäämällä;
• ilmoita käyttäjälle, kun kotitalouden kulutus ylittää rajan;
• vähennä ohjattavaa kuormaa ennen kalliin huippuhintaisen sähkön tuontia.

Pidä integraatio-oppaan painopiste ensin luotettavan datan varmistamisessa. Lisää ohjauslogiikka vasta, kun olet tarkistanut etumerkkikäytännön, yksiköt, päivitysvälin ja toiminnan, kun mittari ei ole käytettävissä.

Aiheeseen liittyvät Home Assistant -oppaat

• Vertaa kaikkia IAMMETER–Home Assistant -integraatiomenetelmiä
• Määritä energiamittari MQTT-palvelimen kanssa
• Home Assistantin MQTT Discovery energiamittarille
• Home Assistantin aurinkoenergian seuranta
• Home Assistant ja Grafana