Integraatiot ja automaatio

Home Assistant

Pörssisähkön hinta Home Assistantiin: hinta nyt, päivän halvimmat tunnit, huomisen hinnat, valmiit automaatiot ja oma hintakortti. Asennus HACSilla, ilman API-avainta.

Avaa HACSissa GitHub: integraatio Keskustelu HA-foorumilla

Mitä saat

Osa	Mitä se tekee
`sensor.sahkon_hinta_nyt`	Pörssisähkön hinta nyt (snt/kWh, sis. ALV 25,5 %). Attribuuteissa tämän päivän ja huomisen hinnat, päivän alin, keskihinta ja ylin sekä halvin 3 tunnin jakso.
`binary_sensor.sahko_halpaa`	Päällä (on) vuorokauden halvimpina tunteina – oletuksena 4 tuntia, määrän voi valita itse.
Blueprint: halvimmat tunnit	Kytkee laitteen (varaaja, latauslaite, lattialämmitys) päälle halvimpina tunteina ja muuten pois.
Blueprint: hintailmoitus	Ilmoitus puhelimeen, kun hinta alittaa tai ylittää valitsemasi rajan.
Hintakortti	Valmis kortti kojelaudalle: hinta nyt, hintataso, tämän päivän ja huomisen pylväskaavio sekä hälytysten ja ohjausten luonti suoraan kortista.

Ei API-avainta, ei rekisteröitymistä eikä maksuja. Hinnat tulevat tämän palvelun rajapinnasta (ENTSO-E / Nord Pool day-ahead, 15 minuutin tarkkuus).

Valitse asennustapa

Suositus

A: HACS-integraatio

Integraatio löytyy HACSin hausta nimellä Sähkön hinta nyt, joten asennus onnistuu muutamalla klikkauksella ilman YAMLia. Halvimpien tuntien määrää voi muuttaa myöhemmin integraation Määritä-painikkeesta.

Avaa HACSissa Lisää integraatio

B: YAML-paketti

Jos et käytä HACSia: kopioi alla oleva paketti tiedostoon config/packages/sahkon_hinta_nyt.yaml ja käynnistä Home Assistant uudelleen. Käyttää Home Assistantin omaa REST-integraatiota.

Näytä YAML-paketti

Käytä joko A:ta tai B:tä, älä molempia – ne luovat samat anturit.

Hintakortti kojelaudalle

Sähkön hinta -kortti Home Assistantissa: hinta nyt, hintataso ja tämän päivän hinnat pylväinä

Kortti näyttää hinnan nyt, hintatason, tämän päivän ja huomisen hinnat pylväinä (negatiiviset hinnat nollaviivan alla), halvimman 3 tunnin jakson sekä päivän alimman, keskimääräisen ja ylimmän hinnan. Ylläpitäjä voi luoda kortista suoraan hintailmoituksen, laiteohjauksen halvimmille tunneille tai tallentaa laitteiden tilan sceneksi. Kaikki kortin luomat asiat ovat tavallisia Home Assistantin automaatioita tai scenejä (merkitty ⚡), joten niitä voi muokata myöhemmin asetuksista.

Kortti asentuu HACS-integraation mukana (versiosta 1.3.0 alkaen): erillistä asennusta, tiedostojen kopiointia tai resurssin lisäämistä ei tarvita. Kun integraatio on lisätty, päivitä selain ja lisää kojelautaan kortti Sähkön hinta.

Avaa HACSissa Kortin ohje GitHubissa

Valmiit automaatiot (blueprintit)

Tuo blueprint yhdellä klikkauksella ja valitse laite – YAMLia ei tarvita.

Tuo: halvimmat tunnit → laite päälle Tuo: hintailmoitus

Avoin lähdekoodi

Integraatio, blueprintit ja kortti ovat avointa lähdekoodia (MIT-lisenssi) GitHubissa: sahkon-hinta-nyt-ha. Virheilmoitukset ja kehitysideat voi jättää GitHubin Issues-osioon.

Kysymyksiä, kokemuksia ja käyttöesimerkkejä voi jakaa Home Assistant Community -foorumin keskustelussa: Finnish spot electricity price (pörssisähkö). Sieltä löytyy myös muiden käyttäjien vinkkejä.

Näin otat sen käyttöön

Avaa HACS ja hae Sähkön hinta nyt (tai paina yllä olevaa Avaa HACSissa -painiketta). Jos integraatio ei vielä näy haussa, lisää se kohdasta ⋮ → Custom repositories osoitteella https://github.com/sahkonhintanyt-ha/sahkon-hinta-nyt-ha tyypillä Integration.
Valitse Download ja käynnistä Home Assistant uudelleen.
Asetukset → Laitteet ja palvelut → Lisää integraatio → Sähkön hinta nyt. Valitse halvimpien tuntien määrä (oletus 4).
Hintakortti tulee integraation mukana: päivitä selain ja lisää kojelautaan kortti Sähkön hinta. Valinnaisesti: tuo blueprintit.

Koodi: YAML-paketti (vaihtoehto B)

# 1) configuration.yaml – ota paketit käyttöön (jos ei jo ole):
#    homeassistant:
#      packages: !include_dir_named packages
#
# 2) Tallenna tämä tiedostoksi config/packages/sahkon_hinta_nyt.yaml
#    ja käynnistä Home Assistant uudelleen.
rest:
  - resource: https://api.xn--shknhintanyt-gcb8w.org/v1/ha?zone=FI
    scan_interval: 300
    sensor:
      - name: "Sähkön hinta nyt"
        unique_id: sahkon_hinta_nyt
        unit_of_measurement: "snt/kWh"
        state_class: measurement
        icon: mdi:flash
        value_template: "{{ value_json.state }}"
        json_attributes_path: "$.attributes"
        json_attributes:
          - level
          - min
          - max
          - average
          - cheapest_3h_start
          - cheapest_3h_avg
          - tomorrow_valid
          - raw_today
          - raw_tomorrow
  - resource: https://api.xn--shknhintanyt-gcb8w.org/v1/is-cheap?zone=FI&hours=4
    scan_interval: 300
    binary_sensor:
      - name: "Sähkö halpaa"
        unique_id: sahko_halpaa
        icon: mdi:piggy-bank
        value_template: "{{ value_json.cheap }}"

Koodi: Hintakortti (Lovelace)

type: custom:sahkon-hinta-card
entity: sensor.sahkon_hinta_nyt
# valinnaiset:
# name: Sähkön hinta nyt
# cheap_entity: binary_sensor.sahko_halpaa
# thresholds: [5, 10, 15]     # halpa / normaali / kallis, snt/kWh
# show_actions: true          # Ilmoitus / Ohjaus / Scene -painikkeet
# show_source: true
# time_zone: Europe/Helsinki

Koodi: Automaatio YAMLilla

# Esimerkki: lämminvesivaraaja päälle halvimpina tunteina
automation:
  - alias: "Varaaja halvimpina tunteina"
    trigger:
      - platform: state
        entity_id: binary_sensor.sahko_halpaa
    action:
      - service: "switch.turn_{{ 'on' if trigger.to_state.state == 'on' else 'off' }}"
        target:
          entity_id: switch.lamminvesivaraaja

Koodi: ApexCharts-kaavio

# Pylväskaavio ApexChartsilla (vaatii HACSista apexcharts-cardin)
type: custom:apexcharts-card
header:
  show: true
  title: Sähkön hinta
graph_span: 2d
span:
  start: day
now:
  show: true
series:
  - entity: sensor.sahkon_hinta_nyt
    type: column
    data_generator: |
      return [...entity.attributes.raw_today, ...entity.attributes.raw_tomorrow]
        .map((p) => [new Date(p.start).getTime(), p.value]);

Mihin tätä voi käyttää?

Lämminvesivaraaja lämpenee vain vuorokauden halvimpina tunteina.
Sähköauton lataus alkaa, kun hinta laskee valitun rajan alle.
Ilmoitus puhelimeen, kun huomisen hinnat julkaistaan tai hinta on negatiivinen.
Kojelaudalla näkyy tämän päivän ja huomisen hintakäyrä sekä halvimmat tunnit.

Hyvä tietää

Anturit päivittyvät 5 minuutin välein; tiheämpi päivitys ei tuo uutta tietoa, koska hinta vaihtuu 15 minuutin välein.
Hinnat sisältävät ALV:n 25,5 %. Marginaali, sähkövero ja siirto eivät ole mukana.
Jos anturi näyttää ”unavailable”, tarkista Asetukset → Järjestelmä → Lokit. YAML-paketissa yleisin syy on sisennysvirhe.
Hintakortti tulee HACS-integraation mukana ja lisätään kojelaudan resursseihin automaattisesti. YAML-paketin kanssa kortti lisätään käsin (ks. kysymykset alla).

Usein kysyttyä: Home Assistant

Pitääkö asentaa sekä HACS-integraatio että YAML-paketti?

Ei. Valitse toinen: HACS-integraatio (helpoin) tai YAML-paketti. Molemmat luovat samat anturit, joten yhdessä ne menisivät päällekkäin.

Voinko muuttaa halvimpien tuntien määrää?

Voit. HACS-integraatiossa valitse integraation Määritä-painike, YAML-paketissa muuta osoitteen hours-arvo (esim. hours=6).

Mistä hintakortin saa?

Kortti tulee HACS-integraation mukana versiosta 1.3.0 alkaen, ja integraatio lisää sen kojelaudan resursseihin automaattisesti. Jos käytät YAML-pakettia, kopioi sahkon-hinta-card.js osoitteesta https://github.com/sahkonhintanyt-ha/sahkon-hinta-card kansioon config/www ja lisää resurssi /local/sahkon-hinta-card.js (JavaScript-moduuli).

Asensin kortin aiemmin erikseen. Mitä teen?

Päivitä integraatio HACSissa versioon 1.3.0 tai uudempaan, käynnistä Home Assistant uudelleen ja poista vanha kortin resurssi (/local/sahkon-hinta-card.js tai HACSin erillinen Sähkön hinta card). Kortti toimii, vaikka vanha resurssi jäisi paikalleen.

Tarvitaanko ApexCharts-korttia?

Ei. Oma hintakortti näyttää pylväskaavion ilman lisäosia. ApexCharts-esimerkki on vaihtoehto niille, jotka käyttävät sitä jo muuten.

Onko integraatio avointa lähdekoodia?

Kyllä. Koodi on GitHubissa MIT-lisenssillä, ja virheilmoitukset voi tehdä GitHubin Issues-osioon. Kysymyksiä voi esittää myös Home Assistant Community -foorumin keskustelussa: https://community.home-assistant.io/t/finnish-spot-electricity-price-porssisahko-cheapest-hours-switch-price-alert/1027594

Maksaako rajapinnan käyttö jotain?

Ei. Rajapinta on maksuton eikä vaadi rekisteröitymistä tai API-avainta. Pyydämme vain mainitsemaan lähteen linkillä, jos näytät hintoja julkisesti.

Kuinka usein hinnat päivittyvät?

Pörssihinnat ovat 15 minuutin jaksoissa. Rajapinta tarkistaa uudet tiedot viiden minuutin välein, ja huomisen hinnat tulevat yleensä noin klo 14.15 Suomen aikaa.

Rajapinnat

Hinta nyt (JSON)/v1/now?zone=FI

Hinta nyt (pelkkä luku)/v1/now.txt?zone=FI

Onko nyt halpaa? (on/off)/v1/is-cheap.txt?zone=FI&hours=4

Halvin 3 tunnin jakso/v1/cheapest?zone=FI&hours=3

Home Assistant -muoto/v1/ha?zone=FI

Päivän hinnat vartteina/v1/prices?zone=FI&day=today

Base: https://api.xn--shknhintanyt-gcb8w.org · CORS · JSON · Lähde: ENTSO-E / Nord Pool day-ahead

← Kaikki integraatiot