Helen
Yhdistetty Helen Oy:n asiakastili, joka raportoi oman sähkönkulutuksesi vain luku -antureina - kirjautuneena samalla Oma Helen -käyttäjätunnuksella ja salasanalla, jota jo käytät Helenin omalla verkkosivulla tai sovelluksessa.
Yhdistäminen
Laitteet ja palvelut > Helen > "+ Add account" kysyy suoraan Oma Helen (oma.helen.fi) -käyttäjätunnuksesi ja salasanasi - ei OAuth-suostumusnäyttöä eikä luotavia sovellustunnistetietoja, koska Helenillä ei ole julkista rajapintaa tähän; Athena kirjautuu samalla tavalla kuin verkkosivu itse.
Entiteetit
Neljä vain luku -anturia, kilowattitunteina: today_consumption,
yesterday_consumption, month_consumption ja
daily_consumption (sama tämän päivän kokonaiskulutus uudelleen, mutta juuri se
anturi, jonka historiaan alla oleva "Täytä historiatiedot" kirjoittaa - joten sitä seuraava
Kaavio- tai Tilastokortti näyttää yhtenäisen sarjan pelkän tilin yhdistämisen jälkeen kertyneen
sijaan). Helen mittaa ja raportoi kulutuksen korkeintaan muutaman kerran päivässä, joten
taustasilmukka tarkistaa uudet luvut 3 tunnin välein jatkuvan kyselyn sijaan. Toimii
Ohjauspaneelin korttien,
Historian ja
Automaatioiden kanssa tarkalleen kuten mikä tahansa
muu integraatio - mitään ohjattavaa ei ole, joten se ei koskaan näy Toiminto-solmun kohteena,
vain tilalähteenä.
Historiatietojen täyttö
Tilin Kulutus-kortin valikossa on "Täytä historiatiedot" -toiminto - valitse alkupäivä (enintään
365 päivää taaksepäin), ja Athena hakee päivittäisen kulutuksesi suoraan Heleniltä koko
aikaväliltä yhdellä pyynnöllä ja lisää sen daily_consumption-anturin historiaan. Jo
olemassa olevan historian kattamat päivät ohitetaan automaattisesti, joten toiminnon
uudelleenajaminen (tai aikavälin myöhempi laajentaminen) ei koskaan laske samaa päivää kahteen
kertaan.
Tämä ei ole julkinen, dokumentoitu Helen-rajapinta - se on oikea (joskin epävirallinen) selainkirjautumisvuo, joka on käänteismallinnettu Oma Heleniä vasten. Jos Helen joskus muuttaa kirjautumissivuaan, tämä integraatio saattaa tarvita päivityksen ennen kuin se taas toimii.