Cozify HAN Home Assistant HACS integraatio – virittelystä oikeaan integraatioon

Edellisessä kirjoituksessani näytin, miten Cozify HANin saa yhdistettyä Home Assistantiin REST-antureiden ja configuration.yaml-tiedoston muokkaamisen kautta. Tapa toimii, mutta vaatii käsin kirjoitettua YAMLia, ja jokainen uusi anturi piti lisätä manuaalisesti. Palaute oli selkeä: "Toimii, mutta eikö tätä voisi tehdä helpommin?"

Nyt voi. Cozify HAN:lle on julkaistu virallinen Home Assistant -integraatio, joka asentuu HACS:in kautta muutamalla klikkauksella. Ei YAMLia, ei REST-kyselyitä käsin, ei koodaamista – pelkkä IP-osoite (ja HACS asennettuna) riittää.

Mikä muuttui?

Aiemmin käyttäjän piti itse:

• Selvittää REST API:n osoitteet ja vastausformaatti
• Kirjoittaa configuration.yaml:iin jokainen anturi erikseen
• Huolehtia poll-intervalleista ja template-parsinnasta
• Päivittää konfiguraatiota manuaalisesti, jos API muuttui

Uusi integraatio hoitaa tämän kaiken automaattisesti. Asennat integraation, syötät HANin IP-osoitteen, ja kaikki anturit ilmestyvät Home Assistantiin valmiina.

Mitä integraatiolla saa?

Kaikki oleellinen data tulee suoraan käyttöön:

• Reaaliaikainen kokonaisteho ja vaihekohtaiset tehot (L1, L2, L3)
• Jännite ja virta jokaiselle vaiheelle erikseen
• Reaktiivinen teho (VAr) – tärkeää erityisesti teollisuus- ja B2B-käytössä
• Tarkempaa tietoa HAN laitteen asetuksista, sekä jopa sähkömittarista
• Kumulatiivinen energiadata – tuonti ja vienti suoraan Home Assistantin Energy Dashboard -näkymään
• Kaikki anturit nimetään automaattisesti ja ovat heti käytettävissä automaatioissa, dashboardeissa ja Energy-paneelissa.

Asennus – alle 5 minuuttia

Vaihe 1: Asenna HACS:in kautta

• Avaa Home Assistant ja mene HACS → Integrations
• Kirjoita "Cozify" ja klikkaa etsi
• Etsi "Cozify HAN" listasta ja klikkaa Download
• Käynnistä Home Assistant uudelleen

Vaihe 2: Ota integraatio käyttöön

• Mene Settings → Devices & services
• Klikkaa Add integration
• Hae "Cozify HAN"
• Syötä Cozify HANin IP-osoite (esim. 192.168.1.10) ja klikkaa Submit

Siinä se. Anturit ilmestyvät automaattisesti.

Sähkön hintaseuranta reaaliajassa

Integraation luoma sensor.cozify_han_power_total -anturi mahdollistaa sähkökustannusten laskemisen reaaliajassa. Suosittelen käyttämään Home Assistantin Riemann sum integral -anturia, joka muuntaa hetkellisen hinnan (c/h) kumulatiiviseksi kulutukseksi (c). Tämän päälle Utility Meter -apuri seuraa kulutusta päivä-, viikko- ja kuukausitasolla.

Yhdistettynä spot-hintatietoon (esim. Nordpool-integraatiolla) voit rakentaa automaation, joka ohjaa kuormia hinnan perusteella – ja näet tulokset suoraan Energy Dashboard -näkymässä.

Valmiit automaatiopohjat – Blueprintit

Integraation mukana tulee valmiita Blueprint-automaatiopohjia, joilla pääsee nopeasti alkuun:

• Ylivirtavaroitus: Hälyttää, kun jonkin vaiheen virta ylittää asetetun rajan. Tuo Blueprint: https://github.com/cozify/han-home-assistant/blob/main/blueprints/overcurrent_notification.yaml
• Kokonaistehon varoitus: Hälyttää, kun kokonaisteho ylittää asetetun rajan. Tuo Blueprint: https://github.com/cozify/han-home-assistant/blob/main/blueprints/total_power_notification.yaml

Blueprintit tuodaan Home Assistantiin polusta Settings → Automation & scenes → Blueprints → Import Blueprint. Syötä yllä oleva osoite, ja pohja on käytössä.

Käytännön esimerkki: Ylikuormitussuoja Shellyn kanssa

Edellisessä blogissa käsittelin configuration.yaml-pohjaista toteutusta. Nyt sama onnistuu siistimmin suoraan integraation antureilla. Perusidea on sama: kun jonkin vaiheen virta ylittää esimerkiksi 20 ampeerin rajan, ei-kriittinen kuorma katkaistaan automaattisesti.

Koska integraatio luo valmiit vaihekohtaiset virta-anturit (esim. sensor.cozify_han_current_l1), automaation voi rakentaa suoraan Home Assistantin käyttöliittymässä ilman YAML-muokkausta.

Entä configuration.yaml – voiko sitä vielä käyttää?

Kyllä voi. REST API ei katoa mihinkään, ja vanhat configuration.yaml-asetukset toimivat edelleen. Mutta uusi integraatio on suositeltu tapa: se on helpompi asentaa, päivittyy automaattisesti ja seuraa Home Assistantin parhaita käytäntöjä antureiden rekisteröinnissä.

Jos sinulla on jo toimiva YAML-konfiguraatio, voit silti siirtyä integraatioon. Poista vanhat REST-anturit configuration.yaml:sta, asenna integraatio, ja tarkista että automaatiot viittaavat uusiin entity-nimiin.

Muistilista

• HAN/P1-data päivittyy 10 sekunnin välein – tämä on mittarin rajoitus, ei integraation.
• WiFi kuuluvuus: Jos sähkökaappi on metallia, ulkoinen RP-SMA-antenni tai Ethernet-yhteys saattaa olla suositeltavaa.
• Tähti GitHubiin Jos integraatio on hyödyllinen, käy antamassa tähti repositorioon osoitteessa github.com/cozify/han-home-assistant. Tähtiä tarvitaan, jotta integraatio voidaan tulevaisuudessa sisällyttää suoraan Home Assistantin viralliseen integraaltiovalikoimaan – ilman HACS-vaihetta.
• Bugit ja ideat: Tämä on yhteisövetoinen integraatio, ja palaute ohjaa kehitystä.

Kiitos lukemisesta
Jaa kokemuksesi ja palautteesi osoitteeseen info@cozify.fi

 

Jukka Talja
Cozify, Head of Sales