Caruna
Yhdistetty Caruna Oy:n asiakastili - suomalainen sähkön SIIRTOVERKKOYHTIÖ (ei myyjä kuten Helen) - joka raportoi oman sähkönkulutuksesi vain luku -antureina - kirjautuneena samalla Caruna Plus -sähköpostiosoitteella ja salasanalla, jota jo käytät Carunan omalla verkkosivulla tai sovelluksessa.
Yhdistäminen
Laitteet ja palvelut > Caruna > "+ Add account" kysyy suoraan Caruna Plus (plus.caruna.fi) -sähköpostiosoitteesi ja salasanasi - ei OAuth-suostumusnäyttöä eikä luotavia sovellustunnistetietoja, koska Carunalla 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). Caruna 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 Carunalta koko
aikaväliltä 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 Caruna-rajapinta - se on oikea (joskin epävirallinen) selainkirjautumisvuo, joka on käänteismallinnettu Caruna Plussaa vasten. Jos Caruna joskus muuttaa kirjautumissivuaan, tämä integraatio saattaa tarvita päivityksen ennen kuin se taas toimii. Hyvä tietää myös: ainakin yksi tähän samaan käänteismallinnettuun rajapintaan perustuva yhteisöprojekti on raportoinut ajoittain epäuskottavan suuria kulutuslukemia - Athena hylkää varmuuden vuoksi jokaisen yksittäisen tuntilukeman, joka ylittää 100 kWh (kaukana siitä, mihin todellisen asuinkiinteistön liittymän pääsulake edes taipuisi), mutta jos omat lukemasi silti näyttävät oudoilta, kyse on tämän rajapinnan tunnetusta avoimesta kysymyksestä, ei välttämättä Athenan omasta virheestä.