# Pörssärin ohjesivusto Pörssäri on helppokäyttöinen ohjauspalvelu kodin sähkölaitteiden ohjaukseen pörssisähkön hinnan, ulkolämpötilaennusteen sekä aurinkopaneeleiden tuotantoennusteen perusteella. Sähkön day-ahead -hintatiedot ovat NordPoolin omistamaa lisenssinalaista dataa, ja niiden uudelleenjakaminen ilman asianmukaista lisenssiä on kielletty. Pörssäri on selvittänyt yhdessä NordPoolin kanssa, että palvelu nykymuodossaan on vaatimusten mukainen, ja sitä voidaan ilmaispalveluna tarjota ilman hintatietojen uudelleenjakamislisenssiä. Pörssärin käyttöönotto onnistuu helpoiten Shelly-älyreleen avulla. Luotettavia suomalaisia verkkokauppoja Shellyn hankintaan ovat esimerkiksi [Nurkan Takaa -verkkokauppa](https://verkkokauppa.nurkantakaa.fi/) sekä [Shellykauppa.fi](https://shellykauppa.fi). Edellämainitut kauppiaat tarjoavat myös apua oikean Shelly-releen valintaan, ja skriptien esiasennus on myös osin mahdollista ostaa tuotteen mukana. Kokonaan asennusvalmiin ratkaisun tarjoaa esimerkiksi [Energiavahti Oy](https://evlammittaa.fi/tuote/shelly-ohjauspaketti-asennettuna/). Yhteensopivia malleja Pörssärin kanssa ovat kaikki Shelly Plus, Shelly Pro, Shelly Pro3EM + Addon ja Shelly Gen3- ja Gen4-sarjan releet mistä löytyy tuki skriptiohjaukselle. Kontaktoriohjaukseen PM-mallit eivät ole suositeltavia. Lisäksi tarvitset sähköasentajan kytkemään Shellyn paikalleen mikäli et ostanut asennusvalmista ratkaisua releitä hankkiessa. Shellyn lisäksi tällä hetkellä tuettuna on Home Assistant sekä Raspberry Pico W -releohjaus Micropython-pohjaisella järjestelmällä. Ulkoisista ohjauspalveluista tuettuina on ilmalämpöpumpun ohjaus Sensibo-ohjauslaitetta hyödyntäen sekä Themo-lattialämmitystermostaattien ohjaus. # Miten Pörssäri toimii? Pörssäri ohjaa kodin sähkölaitteita päälle ja pois älyreleiden avustuksella. Palvelinkyselyn perusteella asiakaslaite saa taustapalvelimelta käyttäjäasetusten, sähkön hintatietojen sekä mahdollisen sääennusteen ja aurinkoennusteen perusteella lasketun päällä/pois -ohjaustiedon. Ohjaustieto lähetetään laitteeseen: * aina asiakaslaitteen käynnistyessä * kun käyttäjäasetuksia muutetaan * mikäli edellisestä ohjaustiedon lähettämisestä on kulunut yli tunti aikaa. Tavanomaisiin ns. pilvipalveluihin tai muihin Shellyn ohjausskripteihin verrattuna Pörssärin ohjaus ei vaadi jatkuvaa internet-yhteyttä. Ohjaustieto talletetaan paikalliseen muistiin aina koko sähkön hintatietojen ajaksi, eli vähintään kuluvan vuorokauden loppuun saakka. Käyttäjäasetuksia voidaan muuttaa mistä tahansa sijainnista internet-yhteyden välityksellä. Pörssärin kautta ei kuitenkaan ole pääsyä käyttäjän kotiverkkoon, sillä ohjaustieto palautetaan vastauksena ohjauslaitteen suorittamaan kyselyyn. Pörssäri ei tarvitse toimiakseen Shellyn Cloud -ominaisuutta, mutta sen käytölle ei myöskään ole mitään estettä.
Pörssärin etuna on helppokäyttöinen asetusten muokkaus. Käyttäjän ei tarvitse tehdä muutoksia Pörssärin Shelly-ohjelmakirjaston kautta haettuun valmiiseen ohjelmakoodiin. Lisäksi asetukset ovat tallessa taustapalvelimella mikäli ohjausohjelma päivitetään, tai ohjauslaite syystä tai toisesta vioittuu ja joudutaan vaihtamaan uuteen. Mikäli käytössä olisi skriptiohjaus missä asetukset on tallennettuna skriptin joukkoon, tulisi käyttäjäasetukset tehdä päivityksen yhteydessä aina uudelleen. # Miten Pörssärillä voi ohjata kodin sähkölaitteita? Yksinkertaisimmillaan Pörssärin ohjausehdoissa voidaan määrittää sähkölaitteelle, esimerkiksi lämminvesivaraajalle, vuorokauden sisällä haluttu tuntimäärä minkä laite on kytkettynä päälle. Pörssäri katkoo ohjauskontaktorin kautta tulevaa sähkönsyöttöä esimerkiksi aiemman yösähköohjauksen rinnalle asennetun Shellyn avulla. Ohjaus on mahdollista valita vain osalle vuorokaudesta, eli mahdollisuus on esimerkiksi sähköauton latauslaitteen ohjaukseen siten, että yöaikaan etsitään aina haluttu määrä edullsimpia tunteja. Tämä sopii erityisesti lataushybridien kanssa, jotka vaativat latausta käytännössä joka yö. Ohjaus on mahdollista aktivoida myös sähkön hintatietojen perusteella. Myös hintatieto-ohjaus voidaan asettaa vain osaan vuorokauden tunneista. Lämmityksen ohjaus ulkolämpötilaennusteeseen perustuen arvioi talon lämmitysenergian tarpeen 3-12h jaksolle, ja kytkee tarvittavan määrän 15 minuutin ohjausjaksoja päälle jotta talon lämmitystarve tulee täytetyksi. Vaikka et ohjaisi varsinaista päälämmityslaitetta Pörssärillä, voit silti ohjata "varajärjestelmät" (esimerkiksi oljykattilan sähkövastus, sähköpatterit/lattialämmitys ilmalämpöpumpun yhteydessä) päälle vain tarpeen mukaan. Pörssäri mahdollistaa myös kiinteistöön asennetun aurinkovoimalan hyödyntämisen ohjausten laskennassa. Pörssäri ei pyri käyttämään joka päivä kaikkea tuotettua aurinkosähköä itse, vaan aurinkoennusteen sekä sähkönhinnan perusteella arvioidaan kannattaako sähkölaitteita kytkeä päälle edullisen sähkönhinnan aikaan, oman sähköntuotannon ollessa parhaimmillaan vai jokin yhdistemä näiden väliltä. # Miten sähkön siirtohinta huomioidaan? Käyttäjä voi määrittää Pörssärin sivustolla sähkön siirtohinnan, sähköveron sekä pörssisähkön marginaalin. Tällaisessa tilanteessa ohjaukset tehdään käyttäjän kokonaishintaan perustuen. Kokonaishinnan käyttö on tarpeen tilanteissa missä sähkön siirtohinta vaihtelee, eli käytössä on joko aikatariffi tai kausitariffi. Tällaisessa tilanteessa kokonaishinnaltaan edullisempia tunteja saattaa olla myös kalliimman siirtohinnan aikana. # Muita kysymyksiä ja vastauksia ### Onko Pörssäri luotettava palvelu? Pörssäri on harrastepohjalta rakennettu palvelu, joka on ensisijaisesti tehty omiin käyttötarpeisiin. Emme lupaa suoraa asiakastukea, mutta ongelmatilanteita pyritään mahdollisuuksien mukaan ratkaisemaan yhteistyössä käyttäjien kanssa. Ongelmatilanteiden varalle sivustolta löytyy yhteydenottolomake, ja lisäksi tukea voi pyytää sähköpostitse osoitteesta info(at)porssari.fi. Pörssäri on käyttäjälle maksuton kaikkien käytettävissä olevien ominaisuuksien osalta nyt ja aina tulevaisuudessa. ### Mistä sähkön hintatiedot haetaan? Pörssäri hakee sähkön Spot-hintatiedot ensisijaisesti ENTSO-E -rajapinnasta. Varapalveluna käytetään Eleringin tarjoamaa rajapintaa. ### Miksi Pörssärissä ei näytetä sähkön hintatietoja? Sähkön hintatietoja ei näytetä käyttäjälle, koska NordPoolin lisenssiehdot kieltävät hintatietojen uudelleenjulkaisun ilman tuhansia euroja maksavaa vuosilisenssiä. NordPool on antanut Pörssäri-palvelulle hyväksynnän hintatietojen käsittelyyn ilman lisenssiä sillä ehdolla, että käyttäjällä ei ole pääsyä hintatietoihin. Emme pystyisi tarjoamaan ilmaispalvelua ilman NordPoolin hyväksyntää lisenssittömälle hintatietojen käytölle. ### Miksi Pörssäriin täytyy rekisteröityä? Haluamme tarjota varmatoimisen ohjausratkaisun kaikille käyttäjille. Rekisteröinnin avulla saamme sekä tallennettua käyttäjäkohtaiset asetukset että hallittua Pörssärin palvelinkuormaa. Lisäksi rekisteröitymisen yhteydessä annettu sähköpostiosoite toimii tiedotuskanavana palveluun liittyvistä asioista. Rekisteröityminen on maksutonta, sen voi tehdä halutessaan myös anonyymisti ja rekisteröityneiden käyttäjien tietoja ei luovuteta eteenpäin eikä käytetä mainontaan tai muihinkaan Pörssärin toimintaan liittymättömiin tarkoituksiin. ### Voinko testata palvelun käyttöä? Pörssäri-sivustolle rekisteröityminen on maksutonta. Voit vapaasti kokeilla Pörssäri-palvelua haluamasi ajan. Mikäli et halua jatkaa palvelun käyttöä, voit pyytää käyttäjätilisi poistamista sivuston palautelomakkeen kautta. ### Tarvitseeko minun käyttää Shelly Cloud -palvelua? Pörssäri ei tarvitse eikä halua saada käyttöoikeutta käyttäjän Shelly Cloud -palveluun. Shelly-relettä ei ole myöskään välttämätöntä lisätä Cloud-palveluun ollenkaan releohjauksen käyttöönottamiseksi. ### Voinko käyttää Shelly-relettä muuhun kuin Pörssäriin? Pörssärin ohjausohjelma huomioi toiminnassaan ainoastaan ne Shellyn kanavat, joiden tila on Pörssärin asetuksissa jokin muu kuin "ei käytössä". Voit siis käyttää osaa ohjauskanavista Shelly-releessä muihin tarkoituksiin, eikä Pörssärin ohjausohjelma ohjaa näitä kanavia. Mikäli huomaat lyhyen kokeilun jälkeen, että Pörssäri ei ole sopiva omiin käyttötarpeisiisi, on Shelly-releille tarjolla useita muitakin kolmannen osapuolen pörssisähköohjauspalveluita. Lisäksi Shelly-relettä on mahdollista käyttää esimerkiksi ohjelmoitavana kellokytkimenä sellaisenaan. ### Onko Pörssärin käyttö maksullista? Pörssärin käyttö on nyt ja tulevaisuudessa maksutonta. Kyseessä on harrastepohjalta ylläpidettävä palvelu, ja mikäli palvelinkapasiteetti alkaisi loppumaan, rajoitamme uusien käyttäjien määrää. ### Onko Pörssärin käyttö turvallista? Sivuston ja laitetietokannan hallinnassa käytetään parhaita mahdollisia tietoturvakäytäntöjä. Ylläpitäjien käyttäjätilit on suojattu 2-vaiheisella tunnistautumisella. Myös käyttäjien on mahdollista ottaa käyttäjäprofiilin asetuksissa 2-vaiheinen tunnistautuminen itselleen käyttöön Google Authenticator -sovellukseen perustuen. Pörssärin asetushallinta sekä käyttäjänhallinta perustuvat turvalliseen avoimen lähdekoodin Joomla-sisällönhallintajärjestelmän uusimpaan versioon. Palvelimelta ei ole yhteyttä käyttäjän kotiverkossa oleviin laitteisiin suoraan, vaan ne hakevat ohjaustiedon REST-json -rajapintaa käyttäen. Ulkoisten ohjauspalvelinten käyttäjätunnukset, salasanat ja api-tunnisteet säilytetään Pörssärin ohjaustietokannassa vahvasti salattuina. ### Mitä tietoja minusta kerätään? Pörssäri kerää käyttäjältä rekisteröityessä pakollisina tietoina sähköpostiosoitteen, sekä lisäksi käyttäjä voi lisätä oman nimensä palveluun. Älykkään lämmityslaiteohjauksen ja aurinkosähköennusteen käyttämiseksi käyttäjän tulee syöttää ohjattavan kiinteistön sijaintitiedot paikallisen sääennustedatan hakemisen mahdollistamiseksi. Käyttäjätiedot ja ohjaustiedot sijaitsevat toisistaan erillisissä tietokannoissa eikä ohjaustietokannassa säilytetä käyttäjän tunnistetietoja. Shelly-laitteen tunnisteena käytetään automaattisesti Shellyn laitetunnistetta. Kyselyn suorittavan laitteen julkinen ip-osoite tallennetaan tietokantaan ja sitä käytetään palvelinkyselyiden määrän hallinnassa. Mikäli käytössä on Telegram-yhteysvahti, käyttäjän Telegram-palveluun tallentama etunimi tallennetaan tietokantaan. ### Saako palvelua käyttää VPN-yhteyden tai välityspalvelimen kautta? Käyttöehdoissamme ei kielletä palvelun käyttöä VPN-yhteyden tai välityspalvelimen välityksellä. Palvelinyhteyksien sallimisessa saattaa olla maakohtaisia rajoituksia ja samasta IP-osoitteesta tulevia kyselyitä rajoitetaan aikakohtaisesti. Huomioithan tämän mikäli käytät julkista VPN-osoitetta. ### Ylläpidetäänkö Pörssäriä pitkäaikaisesti? Pörssäri-palvelu tulee olemaan käytettävissä pitkäaikaisesti sivuston omistajien omien laitteiden hallinnan vuoksi. Mikäli tulevaisuudessa Pörssärin aktiivinen ylläpito päättyisi, tultaisiin sekä ohjauslogiikkaan liittyvät palvelintiedostot että kattava dokumentaatio ohjauslogiikasta mukaanlukien tietokantaparametrien käyttö jakamaan sekä Github- että Confluence-palveluiden kautta julkisesti saataville. Ohjausrajapinta perustuu php-pohjaiseen järjestelmään sekä sql-tietokantaan, joten se on tarvittaessa helposti pystytettävissä esimerkiksi omalle kotipalvelimelle. Asetusten muuttamiseen ei tällaisessa tilanteessa tarvita myöskään www-pohjaista käyttöliittymää, vaan muutokset voidaan tehdä myös suoraan tietokantaan. # Kuinka pääsen alkuun? Pörssärin ohjausasetusten teko on kaksivaiheinen toimenpide mihin kuuluu * Ohjauslaitteiden lisääminen sivustolle * Ohjattavan kiinteistön (yksi tai useampi) luonti sivustolle {% hint style="info" %} Voit aluksi liittää sivustolle ohjauslaitteesi, tarkemmat ohjeet tämän lisäämiseksi löytyy osiosta [Ohjauslaitteiden käyttöönotto](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-kaeyttoeoenotto). {% endhint %} # Kiinteistön lisääminen sekä asetukset Ohjausasetusten lisääminen aloitetaan lisäämällä käyttäjätunnukselle kiinteistö Ohjausasetukset-osiossa. Kiinteistön pääsulakekoko valitaan sähköliittymän mittarikeskuksen pääsulakekoon perusteella. Mikäli sinulla on tarkoitus hyödyntää aurinkosähköohjausta tai ulkolämpötilaennusteen perusteella laskettavaa ohjausta, kannatta jo tässä vaiheessa lisätä kiinteistön sijaintikoordinaatit. Koordinaatit löytää esimerkiksi Google Maps -palvelun avulla. Kun olet lisännyt kiinteistön, voit halutessasi lisätä mukautetut hinta-asetukset. Mikäli sinulla on käytössä kiinteä sähkön siirtotariffi, ei mukautettuja hinta-asetuksia ole välttämätöntä käyttää. Tällöin sähkön tuntihintana käytetään verollista spot-hintaa ilman myyjäyhtiön marginaalia. Mikäli sinulla on käytössä vaihtuva tariffi, esimerkiksi aikasähkö tai kausisähkö, on hyödyllistä syöttää omat hinta-asetukset. Tällöin ohjausasetuksissa käytetään sähkön kokonaishintaa, mikä on hyvä huomioida hintarajoja asetettaessa. Mikäli käytössäsi on aurinkovoimala ja haluat käyttää aurinkosähköennusteeseen perustuvaa ohjausta, voi lisätä kiinteistöön Aurinkosähköjärjestelmiä. Jokaisen paneelikentän voi syöttää erillisenä aurinkovoimalana jolloin päästään parhaaseen ennustetarkkuuteen. # Kiinteistön ohjausasetukset Varsinaisia ohjausasetuksia pääset tekemään kiinteistölle valitsemalla "Ohjausasetukset". Mikäli kyseessä on uusi kiinteistö, tulee ensimmäiseksi luoda kiinteistölle "Rakennus". Rakennus kuvastaa erillisiä ryhmäkeskuksia, jollaisia voi olla esimerkiksi päärakennus sekä autotalli. Mikäli kiinteistölläsi on vain yksi mittauskeskus, luodaan kiinteistöön vain yksi rakennus. Kun olet luonut rakennuksen, pääset luomaan varsinaisia ohjauskuormia. Mikäli haluat yksinkertaisen tuntimäärään perustuvan lämminvesivaraajan ohjauksen, onnistuu tämä helpoiten "Lämmitysasetukset" -osiossa. Kyseisestä osiosta pääset myös luomaan[ lämmitysjärjestelmiä joiden päälläoloaika vaihtelee ulkolämpötilaennusteen mukaan](/sivuston-ohjeet/laemmityksen-ohjaus). Osiossa "Muut ohjausasetukset" pääset luomaan ohjausehtoja tuntimäärän perusteella, sähkön hintatietojen perusteella sekä aktivoimaan aurinkosähköennustetta hyödyntävän ohjausmuodon. # Ohjauslaiteliitokset Jotta saat ohjausasetukset välittymään ohjattavaan laitteeseen, tulee edellä lisättyyn ohjauskuormaan tehdä ns. ohjauslaiteliitos. Mikäli et ole lisännyt ohjauslaitetta vielä sivustolle, tulee se tehdä viimeistään tässä vaiheessa "Ohjauslaitteet" -osiossa. Kun olet lisännyt ohjauslaitteen sivustolle, pääset ohjauskuorman asetuksista lisäämään ohjauslaiteliitoksen. Kyseisellä lomakkeella valittavissa ovat sellaiset ohjauslaitteen ohjauskanavat **jotka eivät ole liitettynä mihinkään ohjauskuormaan**. Ohjauslaiteliitosta tehdessä asetetaan ohjattavan kuorman nimellisteho mitä hyödynnetään tulevaisuudessa Pörssärin kuormanohjauksessa. Ohjaustavaksi voit valita joko normaalin ohjauksen (rele kytketään päälle kun ohjattava kuorma halutaan päälle) tai käänteisen ohjauksen (rele kytketään päälle kun ohjattava kuorma halutaan pois päältä, esim. lämmityseston aktivointi maalämpöpumpussa). # Aurinkosähkön käyttö Pörssäri tarjoaa mahdollisuuden aurinkosähkön tuottoennusteen hyödyntämiseen ohjattavien laitteiden ohjauksessa. Ohjauslogiikka pyrkii huolehtimaan siitä, että vuorokauden sisällä sähkön kokonaiskustannus on käyttäjälle mahdollisimman edullinen. Aurinkosähköennuste haetaan forecast.solar -palvelusta käyttäjän syöttämien koordinaattien mukaisesti. Aurinkoennuste päivitetään kuluvaa vuorokautta seuraavasta päivästä eteenpäin jotta jo toteutettuihin ohjauksiin ei tulisi muutoksia aurinkoennusteen päivittyessä. Ohjauskuorman asetuksissa halutaan haluttu tuntimäärä vuorokaudessa aurinkosähköä hyödyntävälle ohjaukselle. Kyseinen tuntimäärä kytketään aina vuorokauden sisällä päälle aurinkoennusteesta huolimatta. Mikäli aurinkopaneelit eivät tuota ollenkaan, kytketään vuorokauden edullisimmat tunnit päälle. Aurinkosähköohjaus vaatii toimiakseen kiinteistöön lisätyt aurinkovoimalat. Lisäksi hintalaskennan onnistumiseksi on tärkeää lisätä kiinteistölle mukautetut hinta-asetukset sähkön kokonaishinnan laskemista varten. # 1. Aurinkovoimalan lisääminen Aurinkovoimalat lisätään kiinteistölistauksen kautta valitsemalla halutun kiinteistön kohdalta "Aurinkovoimalat". Huomioithan, että kiinteistön sijaintiasetukset täytyy olla aktivoituna jotta aurinkovoimalat pääsee lisäämään. Kiinteistön pohjakulutus tarkoittaa ns. jatkuvaa kulutusta, mikä talossa on vuorokauden ympäri. Tähän syötetty arvo parantaa aurinkoennusteen hyödyntämisen tarkkuutta. Lisäksi aurinkovoimalan asetuksiin lisätään myytävän sähkön siirtotariffi (huomioi siirtotariffissa oikea yksikkö, tyypillisesti enimmillään 0,5snt/kWh) Aurinkovoimala lisätään "Lisää aurinkovoimala" -painikkeesta. Kiinteistöön on mahdollista lisätä useampi aurinkovoimala mikäli katolla on esimerkiksi vastakkaisiin ilmansuuntiin asennettuja paneeleita. Tämä parantaa ennusteen tarkkuutta kun jokainen paneelikenttä lisätään omaksi voimalakseen. # 2. Aurinkosähkön hyödyntäminen Kun kiinteistöön on lisätty aurinkovoimala onnistuneesti, voidaan ohjauskuorma-asetuksissa aktivoida aurinkosähkön käyttö. Tällöin laitteen ohjaukset muodostetaan vuorokauden aurinkoennuste huomioiden. {% hint style="info" %} Pörssäri valitsee automaattisesti edullisimmat tunnit perustuen aurinkosähköennusteeseen sekä käyttäjän hinta-asetuksiin. Kanava-asetuksissa asetettu tuntimäärä kytketään joka vuorokausi päälle huolimatta siitä tuottaako oma aurinkovoimala sähköä vai ei. {% endhint %} Asetusten tallennuksen jälkeen kyseinen ohjauskuorma huomioi aurinkoennusteen ohjauksessa, ja pyrkii hyödyntämään omaa aurinkovoimalaa mahdollisimman tehokkaasti! # Lämmityksen ohjaus Pörssäri tarjoaa mahdollisuuden talon lämmitysjärjestelmien ohjaukseen sääennustetietojen perusteella haetun ennusteen sekä pörssisähköhintojen perusteella. Järjestelmä arvioi talon lämmitystarpeen käyttäjäasetuksen perusteella 3-12 tunnin jaksoissa, ja jakaa lämmitystarpeen mukaiset 15 minuutin lämmitysjaksot kyseisen jakson edullisimmille ajanjaksoille. # Toimintaperiaate Pörssäri arvioi kiinteistön päivittäisen lämmitystarpeen talon vuosikulutuksen sekä yr.no -rajapinnasta haetun ulkolämpötilaennusteen perusteella. Koska lämmitys arvioidaan koko kiinteistölle, on tärkeää lisätä järjestelmään myös sellaiset käytössä olevat lämmitysjärjestelmät mitä Pörssäri ei ohjaa. Lisäksi talon energiantarve on tärkeää arvioida mahdollisimman oikein. {% hint style="info" %} Mikäli talossa on käytössä lämpöpumppu, ei sähkönkulutus vastaa talon lämmitysenergian tarvetta. Motivan sivuilta löytyy laskuri talon lämmitystarpeen arvioon neliömäärän, huonekorkeuden, henkilömäärän sekä rakennuksen sijainnin perusteella. (Kohta 1. Rakennuksen tiedot) {% endhint %} ### Lämmitystarpeen hienosäätö Mikäli ohjatut lämmitysjärjestelmät lämmittävät tasaisesti liikaa tai liian vähän, voit hienosäätää lämmitystarvetta lomakevalinnalla "Rakennuksen lämmitystarpeen hienosäätö". Mikäli talo lisääntyy/vähenee liikaa ulkolämpötilan laskiessa mutta on noin 0-asteen ulkolämmössä oikein, voidaan lämmitystarpeen muutosta hienosäätää valinnalla "Lämmitystarpeen muutoksen hienosäätö". ### Erilaiset lämmitysjärjestelmät Kiinteistöön on mahdollista lisätä tyypiltään kolmea erilaista lämmitysjärjestelmää. Nämä ovat "Päälämmitysjärjestelmä", "Avustava lisälämmitysjärjestelmä" sekä "Mukavuuslämmitysjärjestelmä". #### Päälämmitysjärjestelmä (lasketaan lämmitystarpeen perusteella) Kiinteistön päälämmitysjärjestelmäksi lisätään lämmityslaite/lämmityslaitteet, joiden halutaan tekevän pääosa lämmityksestä. Tällainen järjestelmä on esimerkiksi kiinteistön vesikiertoisen lämmityksen lämmönlähde, ilmalämpöpumppu tai suoran sähkölämmityksen ollessa kyseessä jokainen lämmityspiiri tai seinäpatteri joko yhteenlaskettuna tai erikseen. {% hint style="info" %} Mikäli talossa on vain yksi lämmitysjärjestelmä (seinäpatterit, lämpöpumppu vesikiertoisella lämmönjaolla, sähköinen lattialämmitys), sinun tarvitsee lisätä ainoastaan päälämmitysjärjestelmä. Voit lisätä jokaisen lämmityselementin joko omana yksikkönä tai vaihtoehtoisesti laskea niiden tehon yhteen, ja lisätä kaikki laitteet yhtenä järjestelmänä. {% endhint %} #### Avustava lisälämmitysjärjestelmä (lasketaan lämmitystarpeen perusteella) Mikäli kiinteistön päälämmityslähteenä on esimerkiksi ilmalämpöpumppu, voidaan muut lämmitysjärjestelmät (sähköpatterit/sähköinen lattialämmitys) lisätä Pörssäriin avustavana lisälämmitysjärjestelmänä. Voit määrittää avustavalle lisälämmitysjärjestelmälle minimäärän lämmitystarpeesta. Tämä tulee kysymykseen tilanteessa, missä halutaan esimerkiksi aina pieni määrä lämmitystä esimerkiksi lattialämmityksellä, mutta ilmalämpöpumppu hoitaa lämmityksestä pääosan. Mikäli et määritä avustavalle lisälämmitysjärjestelmälle minimimäärää kytketään se päälle ainoastaan tilanteessa, missä päälämmitysjärjestelmän lämmitysteho ei riitä täyttämään lämmitysjakson tarvetta kokonaisuudessaan. Lisälämmitysteho kytketään päälle jakson edullisimpiin tunteihin. {% hint style="info" %} Mikäli et ohjaa päälämmönlähteenä olevaa lämpöpumppua Pörssärillä, mutta haluat silti automaattisen ohjauksen lisälämmönlähteisiin, tulee lämpöpumppu kuitenkin lisätä päälämmitysjärjestelmäksi oikean lämmitysmäärän arvioimista varten. {% endhint %} #### Mukavuuslämmitysjärjestelmä (ei vaikuta kiinteistön lämmitystarpeen arviointiin) Mikäli haluat määrittää itse lämmityksen päälläolotunnit eri lämpötilapisteissä, voit lisätä lämmityslaitteen "Mukavuuslämmitysjärjestelmänä". Tällöin vuorokauden tarvittava lämmitystuntimäärä arvioidaan lisättyjen lämpötilapisteiden tuntimäärästä ennustetun keskilämpötilan perusteella. Lämmitysjärjestelmän asetuksissa tulee lisätä vähintään kaksi lämpötilapistettä . Mukavuuslämmitysjärjestelmiä ei oteta huomioon pää- ja avustavan lisälämmitysjärjestelmän päälläolon arvioinnissa. Voit lisäksi määrittää jakson keskilämpötilan mikä alapuolella mukavuuslämmitysjärjestelmä on aktiivinen. {% hint style="info" %} Mukavuuslämmitysjärjestelmän lämmitystarve arvioidaan annettujen pisteiden vuorokauden kytkentätuntien perusteella. Mikäli esimerkiksi 0 asteessa tarve on 4h ja -10 asteessa 8h, lasketaan -5 asteessa päälläolotarpeeksi 6h. Voit valita järjestelmän asetuksissa kuinka monen tunnin jaksoihin päälläolotunnit jaetaan, tuolloin vuorokausitarpeen mukainen lämmitysmäärä jaetaan tasan kyseisiin aikaperiodeihin. {% endhint %} # 1. Lämmitysasetusten aktivointi Löydät rakennuksen lämmitysasetukset, kun olet ensin lisännyt käyttäjätilillesi kiinteistön ja kiinteistöön rakennuksen. Tämän jälkeen rakennuslistauksen jokaisessa rakennuksessa erikseen löytyy painike "Lämmitysasetukset". Lämmitysasetusten käyttö vaatii, että kyseiseen kiinteistöön on kiinteistön asetuksissa lisätty koordinaatit. Lämmitysasetuksista löytyy erikseen osio "Lämmitysjärjestelmät". Kun valitset painikkeen "Aktivoi lämmitysasetukset", pääset lisäämään lämmitysjärjestelmiä. Päälämmitysjärjestelmät sekä avustava lisälämmitysjärjestelmät lisätään osioon "Automatisoitu lämmitystarpeen laskenta". Kyseisessä osiossa pääset lisäämään kiinteistön vuosilämmitystarpeen sekä tekemään hienosäätöasetuksia. Mukavuuslämmitysjärjestelmät, eli lämpötilapisteiden mukaan asetettujen tuntimäärien mukaan säätyvät lämmitysjärjestelmät pääsee lisäämään ilman automatisoidun laskennan lisäämistä. Jokaiselle mukavuuslämmitysjärjestelmälle määritetään omana asetuksena lämmitysperiodin pituus (=moneenko osaan vuorokausi jaetaan), minimipäälläoloaika sekä lämmitystuntimäärä eri lämpötilapisteissä. Järjestelmään tulee lisätä vähintään kaksi lämpötilapistettä. {% hint style="info" %} Kun olet lisännyt lämmitysjärjestelmän, tulee jokin ohjauslaitteen ohjauskanava liittää kyseisen järjestelmän ohjauslaitteeksi. Ohjauslaiteasetuksista ei toistaiseksi pääse suoraan lämmitysjärjestelmän asetuksiin, vaan niihin tulee siirtyä aina reittiä Ohjausasetukset -> Lämmitysasetukset. {% endhint %} # 2. Lämmitysjärjestelmän lisääminen Automatisoidun lämmitystarpeen laskenta perustuu rakennuksen vuosilämmitystarpeeseen. Laskennan onnistumiseksi tarvitaan tietoon järjestelmän lämmitysteho. Toistaiseksi Pörssäri ei tue muuttuvaa lämmitystehoa (ILP/VILP). Mikäli haluat mieluummin määrittää itse tarvittavan lämmitystuntien määrän eri ulkolämpötiloissa, onnistuu kyseinen ohjaus "Mukavuuslämmitysjärjestelmän" avulla. Saman lämmitysjärjestelmän asetuksiin voi liittää useamman ohjauslaitteen. Myös Sensibo- sekä Themo-ohjaukset on mahdollista laittaa seuraamaan lämmitysohjausasetuksia. # 3. Ohjauslaiteliitos Ohjauslaiteliitoksen asetuksissa voidaan asettaa lämmityslaitteen ottoteho verkosta. Tämä on eri asia kuin laitteen lämmitysteho, ja toistaiseksi kyseinen asetus ei ole välttämätön. Ohjattavan laitteen ottotehoa hyödynnetään jatkossa kiinteistön kuormanohjauksessa. # Ohjauslaitteiden käyttöönotto {% content-ref url="/pages/7Kk886iOffAHm5GjkDPK" %} [Home Assistant -ohjauksen lisääminen](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-kaeyttoeoenotto/home-assistant-ohjauksen-lisaeaeminen) {% endcontent-ref %} {% content-ref url="/pages/dfhgdyE2sGy2bSubbzHL" %} [Shelly-ohjauksen lisääminen](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-kaeyttoeoenotto/shelly-ohjauksen-lisaeaeminen) {% endcontent-ref %} # Home Assistant -ohjauksen lisääminen Tämän oppaan avulla saat lisättyä Home Assistant -ohjauksen Pörssärin sivustolle. Home Assistant -ohjaus toimii yaml-tiedoston avulla luotaviin paikallisiin sensoreihin perustuen. Ohjaustieto tallennetaan Home Assistantiin koko hintatietojen saatavuusajaksi. Tarvitset Home Assistantissa asetustiedostojen muokkaamiseen sopivan lisäosan. Yksi helppokäyttöinen editori on Studio Code Server -lisäosa mitä käytetään myös tämän oppaan esimerkeissä. # 1. Siirtyminen laitehallinnan kautta uuden laitteen lisäyslomakkeelle Siirry Pörssäri-sivuston laitehallintaan valitsemalla valikosta "Ohjaus - Omat laitteet" tai vaihtoehtoisesti siirry sivulle "Ohjaus" ja valitse sivun alusta "Siirry laitehallintaan". Kun olet siirtynyt laitehallintaan sinulle näytetään joko ilmoitus "Laitetietokannasta ei löydy lisättyjä laitteita..." tai vaihtoehtoisesti aiemmin lisätyt laitteet. Sivun alareunassa on painike "Lisää uusi laite". Tästä painamalla pääset uuden laitteen lisäyslomakkeelle.
# 2. Lisää Home Assistant laitehallintaan Nimeä lisättävä laite ja valitse laitteen lisäys-lomakkeella laitteen tyypiksi Home Assistant. Tämän jälkeen paina "Lisää laite", minkä jälkeen saat ilmoituksen laitteen lisäämisestä ja palaat Pörssäri-sivuston laitehallintaan. Laitehallinnassa on nyt lisättynä laite "Home Assistant". Järjestelmä on antanut laitteelle yksilöllisen laitetunnuksen "HAXXXXXXXXX". Tämä laitetunnus lisätään jatkossa Home Assistantin laitetunnus-sensoriin. # 3. Lisää yaml-tiedosto Home Assistantiin Siirry sivustolle ja lisää Pörssäri Home Assistantiin sivuston ohjeiden mukaisesti. # 4. Valmista tuli! Kun olet lisännyt Pörssärin ohjaussensorit Home Assistantiin ohjeen mukaisesti, alkaa ohjaus välittömästi toimimaan. Merkkinä toimivasta ohjauksesta laitteen "Nähty viimeksi" -arvo päivittyy parin minuutin sisällä vastaamaan lähes nykyhetkeä aktiivisen yhteyden merkiksi. # Shelly-ohjauksen lisääminen Tämän oppaan avulla saat lisättyä laitteesi Pörssäri-tilille. Yhdistä ensin Shelly-rele kotiverkkoosi. Voit tehdä sen joko Shelly Smart Control -sovelluksella tai suoraan Shellyn luoman langattoman verkon kautta. Kun olet saanut laitteen lisättyä verkkoon, liity tietokoneella/mobiililaitteella samaan langattomaan verkkoon kuin mihin Shelly on yhdistetty. Oppaan läpikäymiseksi sinulla tulee olla tiedossa Shellyn ns. IP-osoite omassa kotiverkossa sekä Shellyn laitetunnus. {% content-ref url="/pages/M5umYcyfbVG43zLQrh7t" %} [Laitteen lisääminen Pörssäri-sivustolle](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-kaeyttoeoenotto/shelly-ohjauksen-lisaeaeminen/laitteen-lisaeaeminen-poerssaeri-sivustolle) {% endcontent-ref %} {% content-ref url="/pages/yQzuceieSnUuQqWA7wbU" %} [Ohjausskriptin lisääminen Shelly-laitteeseen](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-kaeyttoeoenotto/shelly-ohjauksen-lisaeaeminen/ohjausskriptin-lisaeaeminen-shelly-laitteeseen) {% endcontent-ref %} # Laitteen lisääminen Pörssäri-sivustolle Tämän oppaan avulla saat liitettyä laitteen omalle Pörssäri-tilillesi. # 1. Siirtyminen laitehallintaan Siirry Pörssäri-sivuston laitehallintaan valitsemalla valikosta "Ohjauslaitteet".
# 2. Siirtyminen uuden laitteen lisäyslomakkeelle Mikäli sinulla ei ole aiempia lisättyjä laitteita, laitehallinnassa näytetään ilmoitus "Ei lisättyjä ohjauslaitteita" Mikäli sinulla on aiemmin lisättyjä laitteita, ne näkyvät laitehallinnassa listattuna laite kerrallaan. Sivun yläreunassa on painike "Lisää ohjauslaite". Tästä painamalla pääset uuden laitteen lisäyslomakkeelle.
# 3. Uuden laitteen lisäyslomake Täytä lomakkeeseen laitteesi tiedot. * Laitteen nimi on valittavissa vapaasti. Erikoismerkkien käyttöä ei kuitenkaan tueta. * Tunnisteeksi laitetaan Shellyn 12-merkkinen laitetunniste (Device Id). Tunnus tulee syöttää sivustolle isoja kirjaimia ja numeroita käyttäen huolimatta siitä, että Shelly Smart Control -sovelluksessa kirjaimet on pienellä. * Laitetunniste löytyy joko Shellyn web-käyttöliittymän alareunasta tai vaihtoehtoisesti Shelly Smart Control -sovelluksesta menemällä kyseisen Shellyn asetusvalikkoon ja valitsemalla sieltä "Device information". * Laitteen tyypiksi valitaan Shelly. * Kanavamääräksi valitaan ohjattavien kanavien lukumäärä. Pörssäriin kannattaa lisätä kaikki Shellyn kanavat vaikka osaa kanavista käytettäisiin muuten kuin Pörssärin ohjaamana. Pörssäri ei ohjaa sellaisia kanavioa joiden tila asetuksissa on "Ei käytössä". Lopuksi paina lomakkeen alareunasta "Lisää laite".
# 4. Valmista tuli! Tallennuksen jälkeen palataan Ohjauslaitteet-näkymään missä näytetään ilmoitus onnistuneesta laitelisäyksestä. Juuri lisäämäsi laite näkyy nyt laitelistauksessa. Mikäli olet jo ottanut Shelly-skriptin käyttöön laitteessa, päivittyy "Viimeksi nähty" -arvo viiden minuutin sisällä aktiivisen yhteyden merkiksi. Huomaathan, että sivu selaimessa on kuitenkin päivitettävä muutoksen näkemiseksi. Tarvittaessa voit lisätä tilillesi toisen laitteen listauksen alla olevasta "Lisää ohjauslaite" -painikkeesta. Ennenkuin siirryt tekemään laitteesi asetuksia, lisää ohjausohjelma Shelly-releeseen ja tarkista, että yhteys Shellyn ja Pörssärin palvelimen välillä toimii (Viimeksi nähty -aikaleima päivittyy).
# Ohjausskriptin lisääminen Shelly-laitteeseen Tämän oppaan avulla saat lisättyä ohjausskriptin Shelly-releeseen. # 1. Siirtyminen skriptivalikkoon {% hint style="info" %} Ohjausskriptin lisääminen ei toistaiseksi onnistu Smart Control -mobiilisovelluksella, mutta Shelly-releen ip-osoitteen löydät Smart Control -sovelluksen verkkoasetuksista, tyypillisesti Wi-Fi 1. Osoite on yleensä muotoa 192.168.x.x. {% endhint %} Mene joko mobiililaitteen tai tietokoneen web-selaimella Shelly-laitteesi ohjausliittymään kirjoittamalla osoitteeksi Shelly-releesi ip-osoite. Avaa laitteen asetusvalikko ja valitse sieltä vaihtoehto "< > Scripts" {% hint style="info" %} Skriptin lisäämiseen ei tule käyttää Shellyn tukiaseman kautta avattua käyttöliittymää osoitteessa 192.168.33.1, koska Shelly ei jaa internet-yhteyttä tukiaseman kautta eteenpäin. Skriptikirjaston avaaminen vaatii internet-yhteyden myös laitteeseen mistä asetuksia tehdään. {% endhint %}
# 2. Shellyn skriptivalikko Selaimessa aukeaa tyhjä skriptivalikko. Siirry lisäämään Pörssärin ohjausskriptit valitsemalla oikeasta yläreunasta "Library". Tarvittaessa saat alareunasta otettua talteen Shellyn laitetunnuksen. {% hint style="info" %} Mikäli sinulla on aikaisempia ohjausskriptejä käytössä, huomioi laitteen rajallinen muistikapasiteetti ja vaihda tulevasta Monitor-skriptistä valvottavan skriptin id vastaamaan Pörssärin ohjausskriptiä. Ohje on kirjoitettu tilanteeseen missä laitteessa ei ole aikaisemmin lisättyjä ohjausskriptejä. {% endhint %}
# 3. Ohjelmakirjaston asetukset Library-painikkeesta aukeaa Shellyn ohjelmakirjasto. Mikäli kirjasto ei aukea, Shellyn internet-yhteydessä on ongelma. Ohjausohjelman lisäys ei onnistu ennen kuin internet-yhteys toimii. Listattuna tässä vaiheessa näkyvät Shellyn omasta ohjelmakirjastosta löytyvät ohjelmakoodit. Paina yläreunan painikkeesta "Configure URL", mistä aukeaa painikkeen alapuolelle osoitekenttä. Oletuksena on Shelly-ohjelmakirjaston osoite, eli "....". Tämän osoitteen saat aina palautettua takaisin kentän alapuolella näkyvästä Default-painikkeesta. Poista kentästä alkuperäinen osoite, ja liitä siihen alla oleva Pörssärin ohjelmakirjaston osoite (paina linkkiä pitkään ja valitse "kopioi linkki" minkä jälkeen voit liittää sen ohjelmakirjaston asetuksissa): {% hint style="info" %} Shellyn laiteohjelmistoversio tulee olla vähintään 1.0.2, päivitä tarvittaessa laiteohjelmisto ensin viimeisimpään versioon. Linkki kirjastoon: {% endhint %} {% hint style="info" %} Mikäli kirjasto ei aukea varmista, että olet Shellyn asetusliittymässä wifi-verkon ip-osoitteen kautta. Shellyn tukiaseman kautta (osoitteesta 192.168.33.1) skriptikirjasto ei lataudu, koska asetuksia tekevällä laitteella ei ole pääsyä internetiin. {% endhint %} Lopuksi sinulla pitäisi olla seuraavanlainen näkymä. Paina "Save" jolloin ohjelmakirjasto päivittyy näyttäen Pörssärin ohjelmakoodit.
# 4. Ohjausohjelman tallennus ohjelmakirjastosta Skriptivalikkoon on nyt päivitetty Pörssärin ohjausohjelmakoodit. Sinun tarvitsee lisätä laitteeseen sekä ohjausohjelma että valvontaohjelma. {% hint style="info" %} Ohjausohjelma lisätään laitteeseen vain kerran vaikka laitteessa olisi useampia ohjattavia kanavia. Pörssäri ohjaa samalla ohjelmalla kaikkia laitteen kanavia. On tärkeää lisätä ohjelmat tämän ohjeen mukaisessa järjestyksessä jotta valvontaohjelma toimii oikein. {% endhint %} Paina ohjausohjelman (Porssari main script) alla olevaa painiketta "Insert code". Ohjausohjelma aukeaa muokkausnäkymään. Älä tee mitään muutoksia Pörssärin ohjelmakoodeihin. Tarkoitus on ainoastaan tallentaa ne laitteeseen. Tallenna ohjausohjelma laitteeseen painamalla "Save". Voit lisäksi jo tässä vaiheessa käynnistää ohjausohjelman painamalla "Start".'
# 5. Valvontaohjelman tallennus ohjelmakirjastosta Kun olet lisännyt ohjausohjelman onnistuneesti, avaa vielä ohjelmakirjasto uudelleen painikkeesta "Library" ja tee sama toimenpide myös valvontaohjelmalle. (Porssari script monitoring). Valvontaohjelma on sama kaikille Shellyn laiteohjelmistoversioille. # 6. Ohjelmien aktivointi sekä käynnistäminen Valvontaohjelman tallentamisen lisäksi palaat takaisin skriptivalikkoon. Mikäli käynnistit skriptit jo tallentamisen yhteydessä sinun tarvitsee vain aktivoida skriptit oikealla olevasta liukusäätimestä. Mikäli et vielä käynnistänyt skriptejä, paina skriptin nimen edessä olevaa "play"-kuvaketta. Kun olet aktivoinut ohjelmakoodit onnistuneesti, molempien rivien lopussa olevat liukusäätimet näkyvät sinisenä ja ohjelman nimen edessä näkyy käynnissä olevan skriptin merkkinä "pause"-kuvake.
# 7. Valmista tuli! Seuraavaksi voit siirtyä tekemään laitteesi asetuksia Pörssäri-sivustolle. Kun olet luonut sivustolle ohjauskuorman ja liittänyt Shellyn jonkin ohjauskanavan kuorman ohjauslaitteeksi, saa laite ohjaustiedot noin viiden minuutin kuluessa tallennuksesta. Kun ohjelmakoodi on onnistuneesti asennettu Shellyyn ja laitteen jokin ohjauskanava liitetty olemassaolevaan ohjauskuormaan, voit todentaa yhteyden toimivuuden laitelistauksen Nähty viimeksi -tiedosta. Ajan pitäisi päivittyä viimeistään viiden minuutin sisällä ohjausasetuksen tallennuksesta. {% hint style="info" %} Mikäli aikaleima ei päivity, varmista, että olet syöttänyt laitetunnuksen laitehallinnassa oikein sekä laitteen jokin kanavista on liitetty olemassaolevaan ohjauskuormaan. Varmista lisäksi, että molemmat ohjelmakoodit on skriptivalikossa sekä käynnistetty "play"-valintaa painamalla että kytketty aktiiviseksi. {% endhint %} Mikäli aikaleima ei edelleenkään päivity, ota yhteyttä sivuston palautelomakkeella, niin selvitämme mistä ongelma mahdollisesti johtuu. Liitä yhteydenottoon Shellyn laitetunnus. # Ohjauslaitteiden päivitys {% content-ref url="/pages/xlwui7fxQmfFZfTsA5W5" %} [Shelly-ohjausskriptin päivitys](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-paeivitys/shelly-ohjausskriptin-paeivitys) {% endcontent-ref %} # Shelly-ohjausskriptin päivitys Oppaan tekstit ja kuvat koottu yhdessä yhteisön jäsenen apua käyttäen. Tämän ohjeen avulla saat Shelly-ohjausskriptin päivitettyä uusimpaan tarjolla olevaan ohjelmaversioon. Päivityksen yhteydessä ohjausasetukset säilyvät palvelimella muuttumattomina, ja Shelly jatkaa ohjausten mukaista toimintaa välittömästi päivityksen jälkeen. Siirry oppaan ensimmäiselle sivulle tästä: {% content-ref url="/pages/ZmBM9gypxmZjNQ018xhc" %} [1. Vanhan skriptin poistaminen](/ohjauslaitteiden-ohjeet/ohjauslaitteiden-paeivitys/shelly-ohjausskriptin-paeivitys/1.-vanhan-skriptin-poistaminen) {% endcontent-ref %} #### Pikaohje päivitykseen: 1. Poista Shellyn skriptikirjastosta sekä aiempi ohjausskripti sekä valvontaskripti. 2. Päivitä Shellyn laiteohjelmisto uusimpaan tarjolla olevaan versioon. Shelly käynnistyy uudelleen laiteohjelmiston päivityksen yhteyessä. 3. Mikäli Shellyssä on jo käytössä uusin laiteohjelmisto, käynnistä Shelly tässä vaiheessa uudelleen. 4. Päivitä tarvittaessa Shellyn ohjelmakirjaston osoite uuden laiteohjelmiston vaatimaan kirjastoon (). 5. Lataa ja tallenna kirjastosta ensin ohjausskripti ja sen jälkeen valvontaskripti. 6. Käynnistä ja aktivoi molemmat kirjastosta haetut skriptit. # 1. Vanhan skriptin poistaminen Mene joko mobiililaitteen tai tietokoneen web-selaimella Shelly-laitteesi ohjausliittymään kirjoittamalla osoitteeksi Shelly-releesi ip-osoite. Osoitteen löydät helpoiten Shelly Smart Control –puhelinsovelluksesta laitteen asetuksista. Huomaa, että päästäksesi asetusliittymään laitteen täytyy olla samassa wifi-verkossa Shelly-releen kanssa.
Päästyäsi laitteen asetusliittymään avaa laitteen asetusvalikko ja valitse sieltä vaihtoehto "< > Scripts".
Avaa molemmat skriptit yksi kerrallaan klikkaamalla skriptin nimestä, ja poista ne valitsemalla avautuvasta muokkausnäkymästä "Delete". Kun molemmat skriptit on poistettu, voit jatkaa eteenpäin.
# 2. Shellyn laiteohjelmiston päivitys Kun olet poistanut molemmat skriptit, siirry vasemman reunan valikosta osioon "Settings" ja etsi sieltä kohta "Firmware". Avaa kyseinen valikko, ja mikäli Shelly tarjoaa laiteohjelmiston päivitystä, asenna uusin laiteohjelmisto. Mikäli saat avautuvassa päivitysikkunassa ilmoituksen *"You are using X.X.X (latest) version of the firmware. **Check again."*** ei laiteohjelmistoa tarvitse päivittää. Mikäli laiteohjelmistoa ei tarvitse päivittää, käynnistä Shelly uudelleen valitsemalla edellisestä asetusvalikosta "Reboot device".
# 3. Ohjelmakirjaston avaaminen Uudelleenkäynnistyksen jälkeen siirry takaisin skriptivalikkoon mistä aikaisemmin poistettiin vanhat ohjausskriptit. Avaa skriptisivun yläreunasta "Library".
{% hint style="info" %} Mikäli sinulle aukeaa Shellyn ohjelmakirjasto tai sinulla on ollut aikaisemmin käytössä Pörssärin vanha ohjelmakirjasto, täytyy kirjaston osoite päivittää. Valitse "Configure URL" ja liitä avautuvaan osoitekenttään seuraava osoite: {% endhint %} Skriptikirjaston osoitteen tallentamisen jälkeen sinulla pitäisi olla edessäsi seuraavanlainen näkymä.
# 4. Uuden ohjausskriptin lisääminen Lisää ensin “Pörssärin ohjausskripti” painamalla kirjastosta “Insert Code”. Tallenna skripti avautuvasta ikkunasta painamalla “Save”. Tämän jälkeen palaa takaisin skriptivalikkoon vasemman reunan valikosta (<> Scripts), ja tee sama toimenpide valvontaskriptille (Insert Code --> Save). Valvontaskriptin oikean toiminnan takaamiseksi on tärkeää lisätä skriptit tässä järjestyksessä. Kun olet saanut myös valvontaskriptin tallennettua, palaa takaisin skriptivalikkoon vasemman reunan valikosta (<> Scripts).
# 5. Käynnistä ja aktivoi skriptit Käynnistä ja aktivoi molemmat skriptit skriptivalikosta. Käynnistäminen ("play-kuvake") käynnistää skriptit heti minkä jälkeen skriptin edessä oleva "play-kuvake" vaihtuu "pause-kuvakkeeksi. Aktivoiminen (oikean puoleinen nappi) asettaa skriptin käynnistymään automaattisesti Shellyn käynnistyessä uudelleen. Kun olet käynnistänyt ja aktivoinut skriptit, valikon pitäisi näyttää tältä:
# 6. Valmista tuli Nyt olet onnistuneesti sekä päivittänyt Shellyn laiteohjelmiston uusimpaan versioon että päivittänyt Pörssärin ohjausohjelmiston laitteeseen. Voit vielä todentaa ohjauksen virheettömän toiminnan vierailemalla ohjaussivustolla osoitteessa . Aktiivisen ohjauksen merkkinä Laitehallinnan Viimeksi nähty -aikaleima päivittyy jatkuvasti vastaamaan noin 5 minuutin sisään nykyhetkeä. # Ohjauslaitteen yhteysvahti Pörssäri-sivustolla on mahdollista ottaa käyttöön yhteysvahti, mikä ilmoittaa käyttäjälle mikäli ohjauslaite ei ole yhteydessä palvelimelle käyttäjän määrittelemän ajan sisällä. Normaalitilanteessa laite on yhteydessä palvelimelle noin kahden minuutin välein. Ohjauslaitetta ole välttämätöntä uudelleenkäynnistää heti yhteyskatkoilmoituksen saatuaan mikäli on todennettavissa, että ongelma on laitteen verkkoyhteydessä. Ohjaustieto tallennetaan paikallisesti yleensä niin pitkälle kun hintatietoa on NordPoolista saatavilla, ja Pörssärin laiteohjelma uudelleenkäynnistää laitteen automaattisesti kun ohjaustietoa tulevaisuuteen ei ole enää paikallisesti tallennettuna. Oletusasetus yhteysvahdin reagointiin on 30 minuuttia, mutta se on käyttäjän toimesta muutettavissa välille 5-120 minuuttia. [Telegram-yhteysvahdin käyttöönotto](/yhteysvahti/ohjauslaitteen-yhteysvahti/telegram-yhteysvahdin-kaeyttoeoenotto) # Telegram-yhteysvahdin käyttöönotto Pörssäri tarjoaa mahdollisuuden saada viestillä tieto Telegram -viestisovellukseen kun ohjauslaitteen internet-yhteys katkeaa tai siihen tulee muu ohjauskyselyn estävä toimintahäiriö. Tässä oppaassa neuvotaan kuinka kyseisen ominaisuuden saa käyttöön mobiililaitteessa. # 1. Yhteysvahdin avaaminen Telegram-sovellukseen Siirry mobiililaitteesi web-selaimella osoitteeseen . Mikäli laitteessasi ei ole vielä Telegram-sovellusta asennettuna, voit siirtyä mobiililaitteesi sovelluskauppaan valitsemalla "Download". Kun olet saanut asennettua Telegram-sovelluksen, siirry uudelleen web-selaimella edellä olevan linkin osoitteeseen. Mikäli sinulla on jo Telegram-viestisovellus puhelimessasi asennettuna, valitse sivulla olevasta painikkeesta "Send message" minkä jälkeen sinulta kysytään vielä vahvistus "Avataanko Telegram-apissa". Vastaa tähän "Avaa" minkä jälkeen siirryt Telegram-sovellukseen seuraavanlaiseen näkymään.
# 2. Yhteysvahdin käynnistäminen Paina alareunassa olevaa Käynnistä-painiketta minkä jälkeen keskusteluikkunaan saapuu seuraavanlainen viesti.
# 3. Käyttäjätunnuksen lisääminen Kerro yhteysvahdille käyttäjätunnuksesi lähettämällä chattiin viesti Käyttäjä *pörssärin käyttäjätunnus* tervetuloviestin ohjeen mukaisesti. Mikäli olet tehnyt sivustolle käyttäjätunnuksen missä on välilyönti, ei tunnuksen lisääminen onnistu. Ole yhteydessä sivuston palautelomakkeen kautta, jotta käyttäjätunnuksesi voidaan muuttaa yhteysvahtia tukevaan muotoon {% hint style="info" %} Esimerkkiviesti: Käyttäjä tero\_testaaja {% endhint %} Kun olet lähettänyt edellämainitun viestin, saat vahvistuksen mikäli kyseisellä käyttäjällä löytyy laitteita Pörssärin laitehallinnasta. Mikäli et saa vahvistusta lisätystä käyttäjästä varmista, että sinulla on laite lisättynä Pörssärin laitehallintaan ja kirjoitit käyttäjätunnuksen viestiin oikein.
# 4. Yhteysvahdin aktivointi omalle laitteelle Kun olet saanut käyttäjätunnuksen lisättyä onnistuneesti, voit lisätä omalle laitteellesi aktiivisen hälytyksen. Lisättävän laitteen omistajan tulee olla sama kuin edellisessä vaiheessa lisätty käyttäjä. Lähetä keskusteluun viesti Lisää yhteyskatko laitetunnus missä "laitetunnus" on korvattu haluamasi laitteen tunnisteella. {% hint style="info" %} Esimerkkiviesti: Lisää yhteyskatko HA12345678 {% endhint %} Yhteyskatkohälytyksen oletusraja on 60 minuuttia, ja sitä ei ole normaalitilanteessa tarvetta lyhentää, koska Pörssäri toimii aina vähintään vuorokauden loppuun saakka ilman internet-yhteyttä. Halutessasi voit kuitenkin asettaa haluamasi hälytysrajan välille 5 - 120 minuuttia kirjoittamalla viestin loppuun "Xmin", missä X on haluamasi yhteystauon kesto. {% hint style="info" %} Esimerkkiviesti: Lisää yhteyskatko HA12345678 30min {% endhint %} Viestin lähetettyäsi sinulle saapuu vahvistus "Hälytys lisätty". Mikäli et saa vahvistusta tarkista, että syötit laitetunnisteen oikein.
# 5. Valmista tuli Nyt olet onnistuneesti lisännyt laitteellesi yhteysvahdin. Yhteysvahdin toiminta on hyvä kertaalleen varmistaa laittamalla Shellystä skriptiohjaus tauolle. Huomaathan tauottaa myös ns. vahtiskriptin, muuten ohjaus kytketään takaisin päälle noin 5min kuluessa tauottamisesta. Saat seuraavanlaisen viestin kun määrittämäsi aika on kulunut laitteen edellisestä palvelinkyselystä. Mikäli et määrittänyt aikarajaa, saat hälytyksen 60 minuutin kuluttua.
Yhteyden palautuessa saat seuraavanlaisen ilmoituksen.
Mikäli et yhteysvahdin toimintaa testatessa saa hälytysviestiä, ja sivuston laitehallinnassa Viimeksi nähty -aikaleima on yli määrittämäsi yhteyskatkon ajan menneisyydessä, ota yhteyttä sivuston palautelomakkeella ja kerro samassa yhteydessä myös laitetunnuksesi. # Rajapintakuvaus ## Versio 2 (current) Pörssärin rajapinta on HTTP GET osoitteeseen **, neljällä pakollisella parametrillä: * device\_mac: laitteen MAC-osoite isoilla kirjaimilla ja ilman muita merkkejä, esim A1B2C3D4E5F6 * last\_request: edellisen JSON-ohjaustiedon aikaleima (UNIX-timestamp -muodossa, 0 mikäli ohjaustietoa ei ole tallennettu laitteeseen) * client: käyttäjön skriptin nimi ja versio * json\_version=2 : käytä API versio 2:ta Eli esimerkiksi: * Mikäli last\_request -parametri on alle tunti nykyhetkestä taaksepäin, palvelin vastaa http-koodilla 304 * Mikäli device\_mac -parametrin mukaista laitetta ei löydy tietokannasta, palvelin vastaa http-koodilla 400 * Mikäli samalla device\_mac -parametrilla kysytään alle 10 sekunnin kuluessa edellisestä kyselystä, palvelin vastaa http-koodilla 425 * Mikäli samalla device\_mac -parametrilla kysytään yli 60 kertaa tunnin kuluessa, palvelin vastaa http-koodilla 429 Muussa tapauksessa palvelin vastaa JSON-objektilla: ```json { "metadata": { "mac": "A1B2C3D4E5F6", "channels": "1", "fetch_url": "https://api.porssari.fi/getcontrols.php", "timestamp": "1702821684", "timestamp_offset": "7200", "valid_until": "1702940100" }, "controls": [ { "id": "1", "name": "examplename", "updated": "1702708849", "state": "0", "schedules": [ { "timestamp": "1702850368", "state": "1" }, { "timestamp": "1702853976", "state": "0" }, { "timestamp": "1702857522", "state": "1" }, { "timestamp": "1702875674", "state": "0" }, { "timestamp": "1702936868", "state": "1" } ] } ] } ``` ## ## Versio 1 (legacy) Legacy-rajapinta vastaa ohjaustilan tuntitasolla. Mikäli käytössä on ohjaustila mikä annetaan 15min resoluutiolla (esimerkiksi lämmitysohjaus), rajapinta palauttaa tunnin arvoksi kyseisen tunnint ensimmäisen 15 minuutin ajanjakson ohjaustilan. Lähtökohtaisesti Pörssärin rajapinta on HTTP GET osoitteeseen **, kolmella pakollisella parametrillä: * device\_mac: laitteen MAC-osoite isoilla kirjaimilla ja ilman muita merkkejä, esim A1B2C3D4E5F6 * last\_request: edellisen JSON-ohjaustiedon aikaleima (UNIX-timestamp -muodossa, 0 mikäli ohjaustietoa ei ole tallennettuna laitteeseen) * client: käyttäjön skriptin nimi ja versio Eli esimerkiksi: * Mikäli last\_request -parametri on alle tunti nykyhetkestä taaksepäin, palvelin vastaa http-koodilla 304 * Mikäli device\_mac -parametrin mukaista laitetta ei löydy tietokannasta, palvelin vastaa http-koodilla 400 * Mikäli samalla device\_mac -parametrilla kysytään alle 10 sekunnin kuluessa edellisestä kyselystä, palvelin vastaa http-koodilla 425 * Mikäli samalla device\_mac -parametrilla kysytään yli 60 kertaa tunnin kuluessa, palvelin vastaa http-koodilla 429 Palvelin vastaa tavallisesti JSON objektilla: ```json { "Metadata": { "Mac": "A1B2C3D4E5F6", "Channels": "1", "Fetch_url": "https://api.porssari.fi/getcontrols.php", "Date": "2023-12-16", "Time": "21:26:00", "Timestamp": "1702754760", "Timestamp_offset": "7200", "Hours_count": 24, }, "Channel1": { "21": "1", "22": "1", "23": "1", "0": "0", "1": "1", "2": "1", "3": "1", "4": "1", "5": "1", "6": "1", "7": "0", "8": "0", "9": "0", "10": "0", "11": "0", "12": "0", "13": "0", "14": "0", "15": "0", "16": "0", "17": "0", "18": "0", "19": "0", "20": "0", }, } ``` Tässä esimerkissä kanavien lukumäärä on yksi. Kellonajat ovan suomen aikaa paitsi Timestamp joka UTC ja johon voi lisätä Timestamp\_offset että on suomen ajassa.