Tugurium - käyttöohjeet

Käyttö selaimella

Tugurium kerää, prosessoi ja visualisoi dataa käyttäjän sensoreista, kytkimistä ja kameroista.

Kytketyt sensorit voivat mitata esimerkiksi lämpötiloja, liikettä, tuulen nopeutta ja sademääriä. Sensorit lähettävät mittaustuloksia serverille graphql api:n kautta. Sensorien lähettämät mittaustulokset tallennetaan pysyvästi.

Kytkimet voivat olla suoraan integroituna serveriin, tai jos ne ovat erillisiä ne voivat pollata uutta kytkimen asentoa serveriltä graphql api:n kautta tasaisin väliajoin. Serverille on tallennettu vain kytkimen nykyinen asento ja viimeinen komento.

Kamerat lähettävät kuvan serverille jpg muodossa. Serverillä on tallennettuna vain viimeiseksi lähetetty kuva.

Kirjautuminen

Sovellukseen tulee kirjautua valmiiksi luodolla käyttäjätunnuksella ja salasanalla. Admin käyttäjällä on laajemmat oikeudet kuin tavallisilla käyttäjillä. Admin käyttäjän oletussalasana asetetaan serverin asennuksen yhteydessä.

Kirjautumisen jälkeen sovelluksen navigaatio on yläpalkissa, josta käyttäjää voi valita haluamansa sivun.

Sensorit

Kirjautumisen jälkeen aukeaa automaattisesti välilehti ’Sensorit’. Tässä listassa näkyvät kaikki asennetut sensorit, niiden viimeisin mittaustulos ja tieto koska tämä mittaus on tehty.

Aikasarjat

Tällä välilehdellä käyttäjä voi tutkia sensorien mittaustuloksia määrittelemällään aikaperiodilla. Aikaperiodi valitaan alasvetovalikosta ’ajanjakso’.

Käyttäjä voi myös valita miten mittauspisteitä yhdistetään. Oletusarvona on ’tunti’, joka tarkoittaa sitä, että saman tunnin aikana tulleet useammat mittaustulokset yhdistetään yhdeksi mittaukseksi. Vaihtoehto ’päivä’ on vastaava, mutta kaikki yhden vuorokauden mittauspisteet niputetaan yhdeksi. Lisäksi käyttäjä voi valita että yhdistämistä ei tehdä ollenkaan. Tämä voi kuitenkin potentiaalisesti tuoda sovellukseen huomattavaa hitautta, jos sensorista tulee mittaustuloksia tiheällä frekvenssillä.

Lopuksi käyttäjä voi valita yhden tai useamman sensorin, joiden mittaukset otetaan mukaan kuvaajaan. Kun sensorit on valittu, näytetään käyttäjälle graafi mittaustuloksista määritellyllä ajanjaksolla.

Graafia voi zoomata hiiren rullapainikkeella. Zoomattu osuus koko ajanjaksosta näkyy graafin alapuolella, jonka harmaa alue on zoomattuna. Zoomattua kohtaa voi siirtää tarttumalla hiirellä harmaaseen kohtaan ja liikuttelemalla sitä. Yksittäisten mittauspisteiden arvo tulee näkyviin kun hiiren siirtää kuvaajan kyseisen kohdan päälle.

Vuosivertailu

Tällä välilehdellä käyttäjä voi verrata sensoreiden mittaustuloksia eri vuosien välillä. Ensimmäiseksi käyttäjän tulee valita sensori, jonka mittauksia halutaan tarkastella. Tämän jälkeen käyttäjä valitsee yhdistetäänkö tulokset päivittäin vai kuukausittain. Yhden vuorokauden/kuukauden mittaustulokset yhdistetään siis yhdeksi mittauspisteeksi. Lopuksi käyttäjä valitsee yhden tai useamman tarkasteltavan vuoden. Käyttäjä voi myös valita kuvaajaan kaikkien vuosien keskiarvon.

Graafi on interaktiivinen kuten ’Aikasarjat’ kohdassa esiteltiin.

Kamerat

Välilehdellä näkyvät kaikki serveriin yhdistetyt kamerat, niiden lähettämä viimeisin kuva ja sen aikaleima. Kun kuvaa painaa, tulee näkyviin kuva täydellä resoluutiolla. Tästä pääse takaisin painamalla ‘takaisin’ nappia.

Kytkimet

Välilehdellä luetellaan kaikki serverin kytkimet. Siinä näkyy myös kytkimen tila ja viimeisen aikaleima. Kytkimen tilaa voi vaihtaa painammalla sinistä/harmaata komento -napia. Kytkimen tila päivittyy kun kytkin on tosiasiassa vaihtanut tilaansa.

Komentojen antaminen on mahdollista vain admin käyttäjälle. Tavalliselle käyttäjälle ei näy kommennon antamisen painikkeita.

Tilastoja

Välilehti näyttää luettelon kaikista sensoreista, niiden mittauspisteiden lukumäristä ja päivästä jolloin ensimmäinen mittaus on tallennettu.

Lisäksi välilehdellä voi valita sensorin jonka osalta näytetään graafi mittauspisteiden lukumäärästä vuorokaudessa. Graafi on interaktiivinen kuten ’Aikasarjat’ kohdassa esiteltiin.

Uusi mittaus

Välilehti näkyy vain admin käyttäjäjälle. Tällä voidaan manuaalisesti syöttää mittaustulos serverille. Ensin valitaan sensori jolla mittaustulos kirjataan. Tämän jälkeen syötetään mittaustulos (desimaaliluku) ja painetaan lisää.

Asetukset

Välilehdellä voi käyttäjä vaihtaa salasanansa. Kaikki käyttäjät neäkevän myös listan käyttäjistä, sensoreista, kameroista ja kytkimistä. Admin käyttäjä voi myös lisätä, päivittää ja poistaa näitä (admin käyttäjää ei voi poistaa). Admin käyttäjä näkee myös tokenin jonka avulla sensorit, kytkimet ja kamerat tunnistautuvat lähettäessään tai kysellessään dataa.

Poistaminen tapahtuu painamalla punaista ‘poista’ tekstiä. Ennen poistoa sovellus kysyy varmistusta popup-ikkunassa. Kun sensori poistetaan, niin samalla poistetaan kaikki sen tuotttamat mittauspisteet.

Päivittäminen tapahtuu painamalla ‘päivitä’ tekstiä. Tällöin tulee näkyviin popup-ikkuna, jossa tietoja voi päivittää. Lopuksi painetaan ‘päivitä tiedot’ nappia. Lisääminen tapahtuu vastaavalla tavalla painamalla ‘lisää uuusi’ nappia.

Sensorin koontimetodi: Koontimetodilla tarkoitetaan menetelmää, jolla mittauspisteitä yhdistetään tunneittain, päivittäin tai kuukausittain. Tässä on kaksi vaihtoehtoa: summa (SUM) tai keskiarvo (AVG). Keskiarvo soveltuu esimerkiksi lämpötiloille, jossa päivän lämpötila on päivän kaikkien mittauspisteiden keskiarvo. Summa soveltuu esimerkiksi sademäärälle: vuorokauden sademäärä on tuntikohtaisten sademäärien summa.

Kytkimen komentotiedosto: Kytkin voi olla osa serveriä tai erillinen. Mikäli kytkintä hallitsee serveri, voidaan määrittää serverillä oleva tiedosto jonka välilytksellä kytkimen asennon muuttaminen tapahtuu. Kytkimelle annetaan komento ON kirjoittamalla tiedostoon merkki ‘1’ ja OFF kirjoittamalla tiedostoon ‘0’. Mikäli asetuksissa ei kytkimelle ole määritelty tiedoston nimeä, oletetaan että kytkin pollaa komentoa serveriltä tasaisin väliajoin.

Käyttö mobiilissa

Sovellusta voi käyttää mobiiliversiossa vastaavalla tavalla kuin selaimessakin. Tähän on kuitenkin muutamia poikkeuksia: