Valpas-projektin vaatimusmäärittely

Transkriptio

1 Valpas-projektin vaatimusmäärittely Dokumentin historia Versio Päiväys Muokkaaja Kuvaus Hyväksytty Rönkkö Kirsi Päivitetty käyttötapausten, vaatimusten yms. statukset Rönkkö Kirsi Hiottu käyttätapausta K Rönkkö Kirsi Poistettu kaikki teksti joka viittaa releiden käyttöön tämän projektin aikana. Muokattu käyttötapaukset I2:sta vastaaviksi Rönkkö Kirsi Päivitetty käyttötapausten, vaatimusten yms. statukset ajatasaisiksi Rönkkö Kirsi Korjattu katselmoinnissa löytyneet virheet Rönkkö Kirsi Ajantasaistettu teksti kauttaaltaan vastaamaan paremmin nykyistä käsitystä projektista Pete Lyly Rönkkö Kirsi Lisätty käyttötapauskuvauksia Rönkkö Kirsi Lisätty selitykset prioriteetteihin ja statuksiin Pete Lyly Rönkkö Kirsi Kuvattu muutosprosessi ja viimeistelty dokumenttia Rönkkö Kirsi Lisätty puuttuva kuva ja siihen liittyvä teksti Rönkkö Kirsi Lisätty hyväksyntäkenttä asian tullessa pian ajankohtaiseksi ja lisätty muutostenhallinta kohta Rönkkö Kirsi Kirjoitettu tekstiä ja lisätty kuvia eri kohtiin.

2 Sisällys 1. Dokumentin tarkoitus Liiketoimintatavoitteet Sovellusalueen pääkäsitteet Systeemikuvaus Projektiin liittyvät tietoliikenneyhteydet Käyttäjäryhmät Vaatimukset Käyttötapaukset Käyttötapauskuvaukset Rajoitukset Ratkaisuehdotukset ten muutosprosessi Termit ja lyhenteet Referenssit Liitteet...A Liite 1: Toiminnalliset vaatimukset...a Liite 2: Ei-toiminnalliset vaatimukset...f Liite 3: Rajoitukset...H

3 1. Dokumentin tarkoitus Tämä dokumentin tarkoitus on kuvata Valpas-järjestelmään ja Valvotut liittymät -projektiin kohdistuvat vaatimukset. Dokumentin lukijaryhmät on kuvattu alla taulukossa 1. Taulukko 1: Lukijaryhmät Lukijaryhmä Lukemisen syy Käyttäjät ja asiakas Palautteen antaminen vaatimuksista Kehittäjät Järjestelmän toiminnallisuuksien ja ominaisuuksien ymmärtäminen Testaaja Järjestelmän testaaminen vaatimuksia vasten Käyttöoppaan kirjoittajat Materiaalin hankinta opasta varten Projektiryhmä ten seuranta Mentor Arvosanan määrittäminen 2. Liiketoimintatavoitteet Suomessa on Virve-niminen TETRA-verkko, jonka asiakaskunta on hyvin rajattu. Laissa määritellään, keille kaikille Virven palveluita voidaan tarjota. Tästä syystä kasvumahdollisuudet tavanomaisilla keinoilla ovat hyvin rajalliset. Lisäpalveluiden kehittäminen olemassa olevaan verkkoon on ainoa mahdollisuus lisätulojen saamiseksi. Jotta lisäpalveluita voitaisiin kehittää, tulee niiden toimivuutta ensin testata. Tämän projektin tarkoitus on luoda testijärjestelmä, jonka avulla voidaan tutkia TETRA-verkon soveltuvuutta erilaisten laitteiden ja valvomoiden väliseksi yhteyskanavaksi. Päätavoite on selvittää, soveltuuko TETRA-verkon yli oleva radioyhteys korvaamaan nykyisin käytössä olevan teleoperaattorien tarjoaman kiinteän kaapeliyhteyden. Mikäli päätavoite ei täyty, oletetaan testijärjestelmän pystyvän kuitenkin osoittamaan, että radioyhteys TETRA-verkossa on huomattavasti luotettavampi kuin teleoperaattoreiden tarjoama vaihtoehto ja saavutettavuudeltaan Suomen paras. Mikäli testijärjestelmän avulla pystytään todentamaan järjestelmän paremmuus, asiakas olettaa noin 50% kasvua Virve-liittymien määrään. Lisäksi järjestelmälle on kysyntää, sillä tällä hetkellä käytettävissä olevat yhteyskanavat eivät täytä vakuutusyhtiöiden ja viranomaisten asettamia määräyksiä palohälyttimien ja hätäkeskuksen väliselle yhteyslinjalle. TUKES on tiedottanut aiheesta ja peräänkuuluttanut kaikkia alalla toimivia tahoja tekemään voitavansa tilanteen korjaamiseksi. 3. Sovellusalueen pääkäsitteet Sovellusalueen pääkäsitteet on kuvattu alla olevassa kuvassa. Erilaisista valvottavista laitteista on tunnistettu kaksi selkeästi toisistaan poikkeavaa laiteryhmää: ohjattavat ja itseohjaavat laitteet. Käytännössä ohjattavaa laitetta vastaa esimerkiksi palohälytin ja itseohjaavaa laitetta esimerkiksi poiju. Kuvassa esiintyvät käsitteet on määritelty tarkemmin kuvan alla olevassa taulukossa. Muita projektissa käytettäviä termejä löytyy kappaleesta 11. Termit ja lyhenteet. 1

4 Kuva 1: Sovellusalueen pääkäsitteet. Taulukko 2: Sovellusalueen pääkäsitteet Käsite Kuvaus Anturi Erilaisia antureita, jotka mittaavat erilaisia tilanteita ja raportoivat tilanteista ilmoitinkeskukselle, esimerkiksi paloanturi. Asiakas Valvotun laitteen omistaja. Hätäkeskus Suomessa toimivat hätäkeskukset, jotka ottavat vastaan esimerkiksi palovaroituksia. Huoltoyhtiö Jokaisen anturin/sensorin ja ilmoitinkeskuksen toiminnasta vastaa ainakin yksi huoltoyhtiö, jonka tehtäviin kuuluu pitää sensorit ja ilmoitinkeskukset toimintakuntoisina. Ilmoitinkeskus Yhdessä talossa kaikki erilaiset anturit/sensorit on yhdistetty ilmoitinkeskukseen, joka kerää tiedot kootusti ja tarvittaessa lähettää hälytyksen hätäkeskukseen. Liittymä Valvottu laite on yhteydessä muuhun maailmaan jonkin liittymän avulla. Nykyisin liittymä on jonkinlainen Internet-liittymä, projektissa on tarkoitus käyttää TETRA-verkon puhelinliittymää. Merenkulkulaitos Taho, joka huolehtii merellä olevista poijuista. Heidän tehtävänään on huolehtia, että poijut ovat paikoillaan ja että niiden akku riittää tarvittavien valojen ylläpitoon. Operaattori Ilmoitinkeskuksen ja hätäkeskuksen välisen yhteyden tarjoaa aina jokin operaattori. Projektin tapauksessa kyse on aina viranomaisverkon operaattorista, Suomessa Virve. Valvottu laite Laite, jonka toimintakunnosta halutaan tietoa. Lisäksi halutaan tietää, onko yhteys valvottuun laitteeseen toiminnassa vai ei. Katso myös ilmoitinkeskus. Yhteyslinja Linja/tie, jota pitkin tieto hälytyksistä kulkee ilmoitinkeskuksen ja valvovan tahon väliä. Nykyisin kiinteä tietoliikenneyhteys, projektin tapauksessa TETRA-verkko. 4. Systeemikuvaus Järjestelmän toiminnallisuutta on esitelty kuvassa 2 seuraavalla sivulla. Normaalisti käyttötapausdiagrammeja käytetään määrittelemään lähinnä käyttäjän ja järjestelmän vuorovaikutusta, mutta projektin tapauksessa toiminnallisuus tapahtuu pääosin muiden laitteiden kanssa ja järjestelmässä toteutettavien osien kesken, joten kuvaamme enemmän sitä. Kuvassa 2 oleva punainen viiva erottaa toisistaan projektissa toteutettavan järjestelmän sen ulkopuolisista liitännöistä. Viivan yläpuolella on kuvattu projektin piiriin kuuluva järjestelmä. Viivan alapuolella on muut projektiin vaikuttavat laitteet ja järjestelmät. Valpas-projekti koostuu kolmesta erillisestä osasta, jotka voivat pyöriä eri koneilla. Projektin puitteissa rakennetaan prototyyppi varsinaiselle Valppaalle, Ilmo-simulaattori ja näiden kahden 2

5 tallentamia tietoja vertaileva Vertailija. Kuva 2: Projektissa vaikuttavat osat Valpas Valppaan on tarkoitus olla järjestelmä, jonka alaisuuteen määritellään erilaisia ilmoitinlaitteita, joiden toimintakuntoa ja yhteyslinjan tilaa Valpas tarkkailee. Tärkein näistä on yhteyslinjan toimimisen tarkistaminen. Tämä on tärkeää, esimerkiksi siksi, että vanhainkodeissa olevien paloilmoittimien linjojen tulee olla yhdistetty hätäkeskukseen, ja mikäli linja ei ole toiminnassa, täytyy jonkun mennä fyysisesti vahtimaan ilmoitinlaitetta mahdollisten hälytysten varalta, kunnes linja toimii taas. Yhteyslinjan toimimisen varmistamiseen vaikuttaa laitteen tyyppi. Kuten aikaisemmin on todettu, valvottavia laitteita on kahdenlaisia: ohjattavia ja itseohjaavia. Ohjattavia laitteita ja yhteyslinjan tilaa niihin Valppaan tule tarkistaa säännöllisin väliajoin lähettämällä laitteelle viesti. Viestin lähetys onnistuu EPA:n avulla. Linjantestausviesti ei sisällä mitään varsinaista tietoa, eikä siihen odoteta vastausviestiä. Tieto viestin perillemenosta saadaan 3

6 välitystietojen avulla, jotka saadaan viestin lähettämisen yhteydessä. Itseohjaavien laitteiden suurin ero ohjattaviin nähden on se, etteivät laitteet ole verkossa koko ajan. Syy tähän on useimmissa tapauksissa se, ettei laite ole yhteydessä verkkovirtaan, vaan toimii akuilla. Tällöin laite säästää akkujaan ja tulee säännöllisin väliajoin verkkoon ja raportoi tiedon tilastaan. Valppaan tulee vain valvoa, että tieto laitteelta tulee määräajoin. Lisäksi Valpasta voidaan pyytää tarkistamaan, että laite itsessään toimii moitteettomasti. Useimmiten laitetta testataan vain silloin, kun käyttäjä itse niin pyytää Valppaan käyttöliittymän avulla, mutta on myös mahdollista säätää testit tehtäväksi automaattisesti tietyin väliajoin. Erilaisia testejä ovat hälytystestaus, anturitestaus ja uusimmissa laitteissa hyvinvointitestaus. Hälytystestauksessa laitetta pyydetään tekemään hallittu hälytys, johon vastauksena odotetaan hälytysviestiä kyseiseltä laitteelta. Anturitestauksessa testataan ilmoittimeen liitetyt anturit, jotka ovat esimerkiksi rakennuksen eri kerroksissa. Vastauksena odotetaan anturihälytysviestiä kyseiseltä laitteelta. Hyvinvointitestauksessa laite tekee sofistikoituneempia testauksia ja raportoi näistä kertomalla, että kaikki on kunnossa, vikaa havaittu tai havaittiin jotain ongelmia, jotka eivät kuitenkaan ylitä vikatilannetta vastaavaa toleranssia. Viestejä on selvennetty alla olevassa taulukossa. Taulukko 3: Lähetettävät testausviestit ja niiden vasteet Testi Positiiviset vasteet Negatiiviset vasteet Testaa hälytys Hälytys Ei viestiä Testaa anturit Anturihälytys Ei viestiä Testaa hyvinvointi Anturihälytys Ei viestiä Ei toleranssissa Linjan toiminnan ja laitteen toiminnan lisäksi Valpas saattaa saada laitteilta hälytys- ja huoltoviestejä koska tahansa. Laiteen havaitessa hätätilanteen laite lähettää viestin, jonka Valpas saa. Saman viestin pitäisi päätyä ainakin palohälyttimien tapauksessa myös Hätäkeskuksille, mutta Valppaan tehtävä on varmistaa hälytysten perillemeno tiedottamalla havainnosta laitetta valvovalle taholle. Laite saattaa myös havaita itse vioittumisen tai yhteyden katkeamisen anturiin, jolloin laite lähettää viestin Valppaalle. Tällöin Valpas välittää tiedot edelleen laitetta huoltavalle yhtiölle. Tarkempia tietoja viestien lähetykseen liittyen löytyy käyttötapauskuvauksista K07 ja K08 sekä liitteiden 1 ja 2 vaatimuksista. Ilmo-simulaatori Ilmo-simulaattorin tehtävä on simuloida valvottavia laitteita. Nimitys viittaa palohälyttimien tapaukseen, jossa hälyttimet on yhdistetty ilmoitinkeskukseen, joka vastaa valvottua laitetta. Simulaattorin tulee toimia sekä ohjattavana että itseohjaavana laitteena. Lisäksi Simulaattori voidaan asettaa simuloimaan laitetta, jolla kaikki on kunnossa, tai laitetta, jolla satunnaisesti ilmenee ongelmia. Simulaattori on testijärjestelmässä kiinnitetty puhelimeen sarjaportin kautta voidakseen lähettää ja vastaanottaa viestejä. Testijärjestelmän tulee tallentaa tiedot kaikista saapuneista viesteistä, jotta niitä voidaan verrata Valppaan lähettämiin viesteihin ja näiden avulla arvioida TETRA-verkon luotettavuutta. Tulevaisuudessa yhteytenä käytetään puhelimessa olevaa releohjausta, koska laitteissa ei välttämättä ole riittävää logiikkaa käyttämään puhelimen AT-rajapintaa, jolla kommunikointi sarjaportin kautta tapahtuu. 4

7 Analysaattori Analysaattori on oleellinen osa testijärjestelmää. Analysaattorin tehtävänä on analysoida Valppaan lähettämiä ja saamia viestejä Ilmo-simulaattoreiden lähettämiin ja vastaanottamiin viesteihin. Analysaattorin tehtävä on verrata tallennettuja tietoja, joista etsitään poikkeamia ja vääristymiä Valppaan ja Ilmo-simulaattoreiden tiedoissa. Näin pystytään keräämään tietoa TETRA-verkon luotettavuudesta ja virheiden pysyvyydestä. Analysaattorin tulee esittää löydetyt poikkeamat aikajanalla virheiden suhteena kaikkiin viesteihin Projektiin liittyvät tietoliikenneyhteydet Projektissa joudumme miettimään monia erilaisia tietoliikenneyhteyksiä ja niiden toimivuutta. Kuva 3 esittelee tulevasta tuotteesta löytyvät tietoliikenneyhteydet. Nämä joudutaan myös projektissa ottamaan tavalla tai toisella huomioon. Tarkempi selitys erilaisista tietoliikenneyhteyksistä löytyy alkaa seuraavalta sivulta. Kuva 3: Projektiin vaikuttavat tietoliikenneyhteydet Yhteys 1 EPA:n ja Valppaan välinen yhteys toimii TCP/IP:n yli. Valpas huomaa ongelmat tällä linjalla esimerkiksi siitä, etteivät viestit mene perille. Yhteys 2 Valppaan ja ylläpitäjän tai asiakkaan välillä on myös yhteys Internetin välityksellä. Yhteys perustuu http-protokollaan, jolloin Valpas havaitsee erilaiset http-kyselyt, joista yhteyden voidaan päätellä olevan kunnossa. 5

8 Yhteys 3 Valppaan ja huoltoyhtiöiden välillä voi olla monenlaisia yhteyksiä. Yhteys voi olla esimerkiksi sähköpostin tai SMS-viestien varassa. Valppaan tehtävä on valvoa tätä yhteyttä kuittausviestien avulla. Yhteys 4 EPAn ja TETRA-verkon yhteys on EPA:n valvoma. EPA huolehtii TCS-aseman vaihdosta, mikäli yhteys ei toimi. Lisäksi Valpas voi viestejä hakiessaan pyytää EPAlta tietoa myös sen käyttämän TCS-aseman tilasta, mikä kertoo EPA:n yhteydestä TETRA-verkkoon. Yhteys 5 Yhteys TETRA-puhelimen ja -verkon välillä on radioyhteys. Tämän yhteyden ja yhteyden numero 4 toimivuutta Valppas valvoo pääasiallisena tehtävänään. Linjavika on tilanne, jossa viesti ei kulje näiden kahden välillä. Yhteys 6 Ilmoitinkeskus on yhteydessä TETRA-puhelimeen puhelimen relekytkennän kautta. Kun Valpas pyytää laitetta testaamaan itsensä, eikä laitteelta tule minkäänlaista vastausviestiä, on mahdollista, että tämä linja ei toimi (toinen vaihtoehto on, että ilmoitinkeskus on rikki eikä toimi oikein käskyn saatuaan). Yhteys 7 Ilmoitinkeskuksen ja antureiden välinen yhteys on ilmoitinkeskuksen aika-ajoin testaama. Valpas voi havaita ongelmat tässä yhteydessä laitteen itsensä lähettämän huoltoviestin avulla tai jos laite anturitestauspyynnön jälkeen ei lähetä vastausta Valppaalle. 5. Käyttäjäryhmät Projektin tuotoksen käyttäjinä toimii lähinnä vain verkon toimivuuden testaamisesta kiinnostuneet henkilöt. Tämä on hyvin rajallinen määrä ihmisiä. Lopputuotteessa olevia käyttäjäryhmiä onkin sitten huomattavasti enemmän. Molemmista tilanteista koottu käyttäjien ryhmittely on esitetty taulukossa 3. Taulukko 4: Käyttäjäryhmät Käyttäjäryhmä Kuvaus Käyttäjien määrä Testaaja TETRA-verkon soveltuvuuden testausta suorittavat henkilöt n. 5 Ylläpitäjä Eri hätäkeskuksissa toimivat järjestelmän ylläpitäjät ja heidän n. 30 varahenkilönsä, sekä operaattorin asettamat ylläpitäjät Asiakkaat Erilaiset isojen ja julkisten talojen omistajat tai hallinnoijat, joiden satoja vastuulla talojen paloilmoittimet ovat Huoltoyhtiön työntekijät Saavat tietoa vikatilanteista, jotka heidän pitäisi korjata satoja Hätäkeskuksen Ottavat vastaan hätäilmoituksia ja tietoja siitä, ettei laite- n. 800 työntekijät Operaattorin työntekijät /linjavikoja ole korjattu (kuitattu huoltoviestiä saaduksi) Nämä saavat tiedon linjavioista ja heidän tehtäviinsä kuuluu korjata verkossa olevat toimintavirheet n. 15 6

9 6. Vaatimukset Tässä dokumentissa käytetyt prioriteetit on selvitetty seuraavassa taulukossa tärkeysjärjestyksessään. Taulukko 5: Projektissa käytetyt prioriteetit ja niiden selitykset Kuvaus Pakollinen Järjestelmän käyttö ilman tällä prioriteetilla varustetun vaatimuksen täyttämistä ei ole mahdollista tarkoitukseen, johon järjestelmä on tilattu. Tarpeellinen Järjestelmän käytön kannalta ei ole aivan välttämätöntä, että tällä prioriteetilla varustettu vaatimus on toteutettu, mutta se lisää huomattavasti järjestelmän käytön mielekkyyttä. Hyödyllinen Nämä ovat hyviä ominaisuuksia, joista on apua tai hyötyä, mutta eivät ole millään tavalla tärkeitä järjestelmän käyttämisen tai käyttötarkoituksen kannalta. ten yhteydessä olevat statukset on selvitetty seuraavassa taulukossa. Taulukko 6: Projektissa käytetyt statukset ja niiden selitykset Kuvaus Ehdotettu tällä statuksella on vain kirjattu ylös. Hyväksytty Tällä statuksella olevat vaatimukset on hyväksytty toteutettavaksi kuluvassa iteraatiossa ja niiden toteuttamiseen on varattu resurssit. Toteutettu Tarkoittaa, että vaatimus on toteutettu, mutta sitä ei ole vielä testattu, jolloin sitä ei vielä voida mainostaa olevaksi. Tällä statuksella olevat vaatimus on läpäissyt testin hyväksytysti ja sen toimivuuteen voidaan siten luottaa. Hylätty on jostain syystä havaittu tarpeettomaksi, jolloin sitä ei aiota missään vaiheessa toteuttaa. Itse vaatimukset on esitetty liitetiedostoissa: Liite 1: Toiminnalliset vaatimukset ja Liite 2: Eitoiminnalliset vaatimukset 7. Käyttötapaukset Taulukko 7: Käyttötapaukset kuvaa projektiin liittyvät käyttötapaukset. Käyttötapaukset on selitetty käyttötapauskuvauksina seuraavalta sivulta alkaen. Taulukko 7: Käyttötapaukset Nimi K01 Valvotun liittymän lisäys järjestelmään K02 Järjestelmässä olevan valvotun liittymän tietojen muokkaaminen K03 Valvotun liittymän poistaminen järjestelmästä K04 Ilmo-simulaattori simuloi ohjattavaa laitetta K05 Ilmo-simulaattori simuloi itseohjaavaa laitetta K06 Vertaillaan Ilmo-simulaattorien ja Valppaan tallentamia tietoja K07 Valpas huolehtii hälytysviestistä K08 Valpas huolehtii huoltoviestistä K09 Valpas tarkastelee linjan toimivuutta K10 Järjestelmään lisätään asiakas K11 Järjestelmään tallennetun asiakkaan tietoja muokataan K12 Asiakas poistetaan järjestelmästä K13 Käyttäjä tarkastelee laitteiden toimintatilannetta K14 Valpas tarkistaa laitteen toimintakunnon K15 Valpas ilmoittaa linjaviasta K16 Valpas ilmoittaa linjavian korjautuneen 7

10 7.1. Käyttötapauskuvaukset Tässä kappaleessa kuvataan tarkemmin eri käyttötapaukset. Valvotun liittymän lisäys järjestelmään K01 Käyttäjä Valpas on käynnissä ja käyttäjä on kirjautunut sisään Valppaan WWW-sivuihin ja on alkusivulla. 1. Käyttäjä painaa "Lisää laite" -nappulaa. 2. Valpas lataa käyttäjälle sivun, johon voi syöttää kaikki laitteeseen liittyvät tiedot. 3. Käyttäjä kirjaa syöttää sivun kenttiin tiedot laitteen nimestä (mahdollisesti katuosoite), TETRA-verkon osoitteesta ja linjan tarkistusvälistä. 4. Käyttäjä tarkistaa tiedot ja painaa sitten "Lisää" -nappulaa. 5. Valpas kertoo käyttäjälle, että laite on lisätty järjestelmään. 6. Käyttäjä päätyy takaisin alkusivulle. 4.a. Käyttäjä ei haluakaan lisätä laitetta ja painaa "Peruuta" -nappulaa. 1. Käyttäjä päätyy takaisin alkusivulle. 5.a. Valpas havaitsee, ettei kaikkia tarvittavia tietoja ole syötetty. 1. Valpas näyttää käyttäjälle virheilmoituksen pyytäen käyttäjää syöttämään puuttuvat tiedot. 5.b. Valpas havaitsee, että samalla TETRA-osoitteella oleva laite on jo järjestelmässä. 1. Valpas näyttää käyttäjälle virheilmoituksen pyytäen käyttäjää peruuttamaan tai vaihtamaan TETRA-osoitteen. Käyttäjä voi selata muita Valppaan WWW-sivuja. Tarpeellinen T01, T02, T03, T04, T11, T12, T13, T14, T22, T24, T25, T26, T27, T31, T35, E06, E11, E12, E13, R01, R02 Versio 1 8

11 Järjestelmässä olevan valvotun liittymän tietojen muokkaaminen K02 Käyttäjä Valpas on käynnissä ja käyttäjä on kirjautunut sisään Valppaan WWW-sivuihin ja on alkusivulla. 1. Käyttäjä selaa listaa laitteista ja painaa haluamansa laitteen perässä olevaa "Muokkaa tietoja" -nappulaa. 2. Valpas lataa käyttäjälle sivun, joka vastaa käyttötapauksessa K01 kuvattua laitteen lisäyssivua, johon järjestelmään kirjatut tiedot on täytetty. 3. Käyttäjä muokkaa haluamiaan kohtia 4. Käyttäjä painaa jälkeen "Tallenna" -nappulaa. 5. Valpas kertoo käyttäjälle, että laitteen tietoja on muutettu. 6. Käyttäjä päätyy takaisin alkusivulle. 4.a. Käyttäjä ei haluakaan muuttaa laiteen tietoja ja painaa "Peruuta" -nappulaa. 1. Käyttäjä päätyy takaisin alkusivulle. 5.a. Valpas havaitsee, ettei kaikkia tarvittavia tietoja ole syötetty. 1. Valpas näyttää käyttäjälle virheilmoituksen pyytäen käyttäjää syöttämään puuttuvat tiedot. 5.b. Valpas havaitsee, että muutettu TETRA-osoitte on jo jonkin toisen laitteen käytössä. 1. Valpas näyttää käyttäjälle virheilmoituksen pyytäen käyttäjää peruuttamaan tai vaihtamaan TETRA-osoitteen. Käyttäjä voi selata muita Valppaan WWW-sivuja. Tarpeellinen T01, T02, T03, T04, T11, T12, T13, T14, T22, T24, T25, T26, T27, T31, T35, E06, E11, E12, E13, R01, R02 Versio 1 Valvotun liittymän poistaminen järjestelmästä Versio 1 K03 Käyttäjä Valpas on käynnissä ja käyttäjä on kirjautunut sisään Valppaan WWW-sivuihin ja on alkusivulla. 1. Käyttäjä selaa listaa laitteista ja painaa haluamansa laitteen perässä olevaa "Poista laite" nappulaa. 2. Valpas varmistaa, että käyttäjä todella haluaa poistaa laitteen järjestelmästä. 3. Käyttäjä vahvistaa poiston. 4. Valpas kertoo käyttäjälle, että laite on poistettu järjestelmästä. 5. Käyttäjä päätyy takaisin alkusivulle. 3.a. Käyttäjä ei haluakaan poistaa laitetta ja painaa "Peruuta" -nappulaa. 1. Käyttäjä päätyy takaisin alkusivulle. Käyttäjä voi selata muita Valppaan WWW-sivuja. Tarpeellinen T24, T25, E06, E11, E12, E13, R01, R02 9

12 Ilmo-simulaattori simuloi ohjattavaa laitetta Versio 2 K04 Ilmo-simulaattori Ilmo-simulaattori on käynnistetty passiiviseen tilaan. 1. Simulaattori saa viestin puhelimen avulla. 2. Simulaattori tallentaa saapuneet viestit. 2a. Simulaattori tulkitsee viestin käskyksi toteuttaa hallittu hälytys. 1. Simulaattori valitsee totteleeko käskyä 1b. Jos ei, palaa normaaliin toimintaan. 2. Simulaattori lähettää viestin, joka vastaa yleishälytystä. 3. Simulaattori palaa normaaliin toimintaan. 2b. Simulaattori tulkitsee viestin käskyksi suorittaa anturien testaus. 1. Simulaattori valitsee totteleeko käskyä 1a. Jos ei, palaa normaaliin toimintaan. 2. Simulaattori lähettää viestin, joka vastaa anturihälytystä. 3. Simulaattori palaa normaaliin toimintaan. 2c. Simulaattori tulkitsee viestin kehottavan tekemään hyvinvointitestin. 1. Simulaattori valitsee totteleeko käskyä 1a. Jos ei, palaa normaaliin toimintaan. 2. Simulaattori lähettää viestin, joka vastaa viestiä "anturihälytys". 2a. Satunnaisesti simulaattori lähettää "anturihälytys-viestin sijasta "ei toleranssissa" -viestin. 2b. Satunnaisesti simulaattori jättää viestin kokonaan lähettämättä. 3. Simulaattori palaa normaaliin toimintaan. * Simulaattori päättää satunnaisesti simuloida hälyttimien laukeamista. 1. Simulaattori lähettää viestin, joka vastaa hälytystä. 2. Simulaattori palaa normaaliin toimintaan. * Simulaattori päättää satunnaisesti simuloida havaittua huollon tarvetta. 1. Simulaattori lähettää viestin, joka vastaa huoltoviestiä 2. Simulaattori palaa normaaliin toimintaan. Ilmo-simulaattori voidaan sammuttaa hallitusti. Pakollinen T05, T06, T07, E01, E 14, R03, R05 Ilmo-simulaattori simuloi itseohjaavaa laitetta K05 Ilmo-simulaattori Ilmo-simulaattori on käynnistetty aktiiviseen tilaan. 1. Simulaattori lähettää LIP-protokollan mukaisen viestin puhelimen avustuksella Valppaan osoitteeseen. 2. Simulaattori lähettää puhelimen avulla Valppaalle viestin, jonka sisältö on "anturihälytys". 3. Simulaattori odottaa määritellyn ajan ja jatkaa taas kohdasta 1. 1a. Satunnaisesti simulaattori valitsee, ettei lähetä viestiä, vaan siirtyy suoraan kohtaan 3. 2a. Satunnaisesti simulaattori lähettääkin viestin "ei toleranssissa" anturihälytyksen sijasta. 2b. Satunnaisesti simulaattori päättää jättää viestin lähettämisen ja siirtyy suoraan kohtaan 3. Versio 2 Ilmo-simulaattori voidaan sammuttaa hallitusti. Pakollinen T05, T06, T07, E01, E09, E 14, R03, R05 10

13 Vertaillaan Ilmo-simulaattorien ja Valppaan tallentamia tietoja Versio 2 Valpas huolehtii hälytysviestistä Versio 2 K06 Analysoija Valpasta ja Ilmo-simulaattoreita on käytetty yhdessä jonkin aikaa ja niiden tallentamat tiedot ovat saatavilla. 1. Käyttäjä syöttää Valppaan ja Ilmo-simulaattoreiden tallentamat tiedot Analysoijalle. 2. Analysoija vertaa Valppaan ja Ilmo-simulaattoreiden tallentamia tietoja saaduista ja lähetetyistä viesteistä. 3. Analysoija tallettaa kaikista viesteistä tiedon siitä, että vastaavatko EPA:lta saadut tiedot simulaattorilla olevia tietoja. 4. Analysoija esittää tiedot käyttäjälle aikajanalla muodossa epäonnistuneiden viestien määrä / kaikki viestit. 5. Analysoija raportoi löytämänsä poikkeavuudet käyttäjälle. 2.a. Analysaattori huomaa, ettei luettuihin tiedostoihin kuulu lainkaan samalla aikavälillä olevaa tietoa. 1. Analysaattori huomauttaa käyttäjälle, ettei tietoja voida analysoida, koska ne eivät ole lainkaan samalta aikaväliltä, ja pyytää käyttäjää vaihtamaan tiedostoja tai lataamaan lisätiedostoja. 2.b. Analysaattori huomaa, ettei syötetyissä tiedostoissa ole Valppaan tietoja. 1. Analysaattori huomauttaa käyttäjälle, että Valppaan tiedot puuttuvat ja pyytää käyttäjää lataamaan Valppaan tiedot sisältävän tiedoston. 2.c. Analysaattori huomaa, ettei syötetyissä tiedostoissa ole yhdenkään Ilmo-simulaattorin tietoja. 1. Analysaattori huomauttaa käyttäjälle, että Ilmo-simulaattoreiden tiedot puuttuvat ja pyytää käyttäjää lataamaan Ilmo-simulaattorien tietoja sisältäviä tiedostoja. Käyttäjä voi tutkia tietoja tai ladata lisää tiedostoja tai vaihtaa analysoitavia tietoja. Pakollinen T05, T06, T07, T08, T36, T37, T38, T39, T40, T41, T42, R03 K07 Valpas Valpas on hakenut viestejä EPA:lta (K09 kohta 1.) ja havainnut viestin olevan hälytysviesti. 1. Valpas tallentaa tiedon laitteen hälytyksestä. 2. Valpas välittää tiedon hälytyksestä kaikille auki oleville www-yhteyksille. 2.a. Valpas havaitsee, ettei yhteydessä oleva sivu liity mitenkään huollon tarpeessa olevaan laitteeseen. 1. Valpas jättää tiedon välittämättä kyseiselle yhteydelle. Valpas palaa normaaliin toimintaansa ja voidaan sammuttaa hallitusti. Pakollinen T09, T11, T21, T22, T23, R03 11

14 Valpas huolehtii huoltoviestistä Versio 2 Valpas tarkastelee linjan toimivuutta Versio 2 K08 Valpas Valpas on hakenut viestejä EPA:lta (K09 kohta 1.) ja havainnut viestin olevan huoltoviesti tai havainnut ettei laite ole toiminut toimintokuntotestissä (K14). 1. Valpas tallentaa tiedon laitteen huollon tarpeesta. 2. Valpas välittää tiedon huoltotarpeesta kaikille auki oleville WWW-yhteyksille. 2.a. Valpas havaitsee, ettei yhteydessä oleva sivu liity mitenkään huollon tarpeessa olevaan laitteeseen. 1. Valpas jättää tiedon välittämättä kyseiselle yhteydelle. Valpas palaa normaaliin toimintaansa ja voidaan sammuttaa hallitusti. Pakollinen T09, T12, T13, T14, T15, T16, T21, T22, T23, T29, T30, R03 K09 Valpas Valpas on käynnistetty ja Ilmo-simulaattorit on käynnistetty Valppaaseen tallennettujen tietojen mukaisesti. 1. Valpas hakee EPA:lta itselleen tulleet viestit. 2. Valpas tutkii viestin. 3. Valpas etsii tallentamistaan tiedoista laitteet, joiden linjan toimivuuden tutkimisesta on kulunut aika, joka vastaa laitteelle määriteltyä linjantarkistusväliä. 4. Valpas lähettää viestin laitteelle EPA:n välityksellä. 5. Valpas hakee EPA:lle saapuneet kuittaukset viestien perillemenosta. 6. Valpas tallentaa tiedon "linja kunnossa" ja havainnon ajan jokaiselle laitteelle. 1a. Valpas ei saa yhteyttä EPA:an 1. Valpas tallentaa tiedon EPA:n toimimattomuudesta. 2a. Valpas huomaa viestin olevan hälytysviesti, siirry käyttötapaukseen K07. 2b. Valpas huomaa viestin olevan huoltoviesti, siirry käyttötapaukseen K08. 2c. Valpas havaitsee viestin olevan LIP-protokollan mukainen paikkatietoviesti. 1. Valpas tallentaa "linja kunnossa" -tiedon lähettäneelle itseohjautuvalle laitteelle. 1a. Jos aikaisempi tieto oli linjavika, suorita käyttötapaus K16. 3a. Valpas huomaa, että laiteen kohdalla linjan toimivuutta tarkastellaan laitteelta päin tulevien viestien avulla, eikä viestiä lähettämällä. 1. Valpas tutkii, onko laitteen "linja kunnossa" -tieto tullut linjantarkistusvälin aikana. 1a. Jos on, Valpas siirtyy seuraavaan laitteeseen. 1b. Jos ei, suorita käyttötapaus K15 4a. Valpas ei saa yhteyttä EPA:n 1. Valpas tallentaa tiedon EPA:n toimimattomuudesta ja siirtyy kohtaan 1. 4b. Valpas havaitsee, ettei laitteeseen ole oltu yhteydessä aiemmin. 1. Valpas pyytää myös laitteen sijaintitiedot itselleen. 6a. Mikäli aikaisempi tieto oli linjavika, suorita käyttötapaus K16. 6b. Valpas huomaa, että perillemenotiedot olivat negatiiviset, suorita käyttötapaus K15. Valpas ja Ilmo-simulaattorit voidaan sammuttaa hallitusti. Pakollinen T01, T02, T04, T05, T06, T07, T09, T10, T32, T33, T34, E03, E04, E05, E08, E10, R03 12

15 Järjestelmään lisätään asiakas K10 Ylläpitäjä Hyödyllinen Ehdotettu T22, T23, T24, T25, T27, E06, E11, E12, E13, R01, R02 Versio 0.5 Järjestelmään tallennetun asiakkaan tietoja muokataan K11 Ylläpitäjä Hyödyllinen Ehdotettu T22, T23, T24, T25, T27, E06, E11, E12, E13, R01, R02 Versio 0.5 Asiakas poistetaan järjestelmästä K12 Ylläpitäjä Hyödyllinen Ehdotettu T24, T25, E06, E11, E12, E13, R01, R02 Versio

16 Käyttäjä tarkastelee laitteiden toimintatilannetta Versio 1 K13 Käyttäjä Käyttäjä on Valppaan WWW-sivustolla. 1. Käyttäjä kirjautuu sisään järjestelmään syöttäen käyttäjätunnuksensa ja salasanan. 2. Valpas tarkistaa käyttäjän syöttämät tiedot ja havaitsee ne oikeellisiksi. 3. Valpas lataa käyttäjälle alkusivun, jolla listataan kaikki järjestelmään syötetyt laitteet sekä esitetään niiden tila (Linja kunnossa/poikki, laite kunnossa/huollon tarpeessa). 4. Käyttäjä selaa laitteiden listaa. 5. Käyttäjä kirjautuu ulos järjestelmästä. 2.a. Valpas havaitsee, että tunnus ja salasana eivät täsmää. 1. Valpas näyttää käyttäjälle virheilmoituksen ja pyytää käyttäjää syöttämään tiedot uudestaan. 4.a. Käyttäjä voi myös suorittaa käyttötapaukset K01, K02, K03. 4.b. Sivu päivittyy, laitteiden tilan muututtua käyttötapauksien K07, K08, K15 ja K16 mukaan. Käyttäjä voi siirtyä muille sivuille ja lisätä/muokata/poistaa laitteita sivustolla. Tarpeellinen T22, T23, T24, T25, T26, T28, E06, E07, R02 Valpas tarkistaa laitteen toimintakunnon K14 Valpas Valpas on saanut käyttäjältä pyynnön testata laitteen toimintakuntoa tai havainnut, että laitetta testataan automaattisesti määräajoin, joka on umpeutunut. Testauksen laatu on määritelty käyttäjän viestissä tai automatisoidun testauksen tiedoissa. 1. Valpas lähettää laitteelle viestin, jolla pyytää tätä tekemään määritellyn testin. 2. Valpas saa EPA:lta kuittauksen viestin perille menosta. 3. Valpas odottaa määritellyn ajan hälytys- tai kuittausviestiä. 4. Valpas saa laitteelta hälytys- tai kuittausviestin. 2a. Kuittaus kertookin, ettei viesti ole mennyt perille, suorita käyttötapaus K15. 3a. Määritelty odotusaika kuluu umpeen ennen kuin Valpas saa hälytys- tai kuittausviestiä, suorita käyttötapaus K08. Versio 1 Valpas voidaan sammuttaa hallitusti. Pakollinen T03, T05, T06, T07, T09, T31, T34, T35, E03, E05, E08, R03 14

17 Valpas ilmoittaa linjaviasta Versio 1 K15 Valpas Valpas on havainnut, ettei viesti laitteelle mene perille käyttötapauksen K09 mukaan. 1. Valpas tallentaa tiedon laitteen linjaviasta. 2. Valpas välittää tiedon linjaviasta kaikille auki oleville WWW-yhteyksille. 2.a. Valpas havaitsee, ettei yhteydessä oleva sivu liity mitenkään kyseessä olevaan laitteeseen. 1. Valpas jättää tiedon välittämättä kyseiselle yhteydelle. Valpas palaa normaaliin toimintaansa ja voidaan sammuttaa hallitusti. Pakollinen T17, T18, T19, T20, T22, T23, R03 Valpas ilmoittaa linjavian korjautuneen Versio 1 8. Rajoitukset K16 Valpas Valpas on aiemmin havainnut, etteivät viestit mene laitteelle perille ja havaitsee nyt viestin taas menevän perille. 1. Valpas tallentaa tiedon linjavian korjaantumisesta. 2. Valpas välittää tiedon linjavian loppumisesta kaikille auki oleville WWW-yhteyksille. 2.a. Valpas havaitsee, ettei yhteydessä oleva sivu liity mitenkään kyseessä olevaan laitteeseen. 1. Valpas jättää tiedon välittämättä kyseiselle yhteydelle. Valpas palaa normaaliin toimintaansa ja voidaan sammuttaa hallitusti. Pakollinen T20, R03 Liite 3: Rajoitukset kuvaa asiakkaan esittämät rajoituksen projektissa toteutettavalle järjestelmälle. 9. Ratkaisuehdotukset Alla on kuvattu vaatimusmäärittelyä tehdessä syntyneitä ideoita erilaisiin ongelmakohtiin. Taulukko 8: Tähän mennessä kertyneet ratkaisuehdotukset Versio Ehdotus Lähde Perustelu Käyttötapaus I01 1 Laitetaan tiedot lähetetyistä ja vastaanotetuista viesteistä debugmoodissa Log4J:n logiin talteen Kirsi Rönkkö Tällöin toiminnallisuutta ei tarvitse varsinaisessa versiossa poistaa ja se voidaan tarvittaessa saada uudestaan käyttöön. Tarpeellinen K04, K05, K06, K07, K08, K09, K14 15

18 10. ten muutosprosessi Koska tässä dokumentissa esiintyviin vaatimuksiin voi ilmaantua muutoksia, uusia vaatimuksia voi ilmestyä tai voidaan huomata, että jokin vaatimus on tarpeeton, tarvitaan säännöt, joilla muutoksia vaatimuksiin hallitaan. Tässä kappaleessa on kuvattu tavat, joilla muutoksia tehdään. Mikäli joku haluaa ehdottaa muutosta vaatimuksiin (niiden sisältöön), tulee hänen lähestyä aiheesta Kirsi Rönkköä. Kirsin tehtävä on hankkia kaikki tarpeellinen tieto muutokseen liittyen. Tämän jälkeen projektin johtoryhmän seuraavassa kokouksessa käsitellään aihe ja päätetään muutoksen tekemisestä tai tekemättä jättämisestä. Tarvittaessa otetaan yhteyttä asiakkaan edustajaan ja tiedustellaan hänen mielipidettään. Mikäli muutos koskee vaatimuksen statusta, tullaan neuvottelemaan aina myös asiakkaan kanssa. Asiakkaan kanssa yhteistyötä tehden päätetään jo toteutettavaksi suunniteltujen vaatimusten hyllyttämisestä ja uusien muutosten asettamisesta toteutettaviksi. Päätöksen teon jälkeen saman päivän aikana korjataan myös muutokset tähän dokumenttiin. 11. Termit ja lyhenteet Taulukko 9: Lista tärkeistä termeistä ja lyhenteistä. Termi/Lyhenne Selitys EPA Edusta palvelin, TETRA-verkon reunalla oleva palvelin, joka tarjoaa TETRA-verkon palveluita helpommin käytettävällä tavalla sovelluksille. Downlink Se kanava, jota pitkin viesti kulkee Valppaalta puhelimelle. Ilmoitinkeskus Rakennuksessa oleva keskus, johon kaikki rakennuksessa olevat hälytinanturit/sensorit on kytketty. Itseohjaava laite Laite, joka omalla toiminnallaan testaa linjan toimivuutta (laite itse on aktiivinen linjavian suhteen). Laitetyyppi Joukko samaan tarkoitukseen tehtyjä laitteita. Esimerkiksi palohälytin ja poiju ovat laitetyyppejä. Laitemalli Joukko samaan tarkoitukseen tehtyjä laitteita, jotka toimivat samalla tavalla ja ovat saman valmistajan tekemiä. Linjavika Vika yhteydessä Valppaan ja puhelimen välillä. MTT Mobile Telematics Terminal. Indagon Oy:n kehittämä laite, joka osaa kertoa koordinaatit paikasta, jossa laite sijaitsee. Ohjattava laite Laite, jonka kohdalla linjavikaa testataan lähettämällä laitteelle viesti (laite itse on passiivinen linjavian suhteen). Ryhmäosoite TETRA-verkon "puhelinnumero", jonka vastaanottajana on useampia tahoja samaan aikaan. SDS TETRA-verkon vastine SMS-viestille. SDS-viestejä on useampia tyyppejä, joista kolmella on kiinteä pituus ja neljäs on vaihtelevan pituinen. TETRA Terrestial Trunked Radio. Omanlaisensa radiopuhelinverkko, jota useimmiten käytetään viranomaistarkoituksiin. TMR880 Nokian puhelinmalli TETRA-verkkoon. Uplink Se kanava, jota pitkin viesti kulkee puhelimelta Valppaalle. Valpas Toteutettava järjestelmä (ValvontaPalvelinSysteemi). Valvottava Yksittäinen laite, jota Valpas valvoo. objekti Virve Suomen viranomaisverkko. Toimii TETRA-järjestelmällä. Yksilöosoite Vastaa TETRA-verkossa tavallista puhelinnumeroa. (K)loc (Kilo) Lines Of Code, koodirivien määrä (tuhansissa). SEPA (Software Engineering Practice), kurssin vaatima selvitys käytettävästä menetelmästä. 16

19 12. Referenssit Alla olevassa taulukossa on lueteltu ne artikkelit ja raportit, joista on kerätty materiaalia tätä dokumenttia varten. Taulukko 10: Lista käytetyistä lähdemateriaaleista. Dokumentin nimi Indagon Valvottuliittymä tutkimussuunnitelma Indagon Oy:n TEKES-hakemus toiselle TETRA-verkossa olevalle sovellukselle Tiehallinnon Liikenteen automaattisten mittapisteiden (LAM) tiedon siirtäminen TETRA-teknologian avulla EPA WSDL-rajapintakuvaus Kuvaus Kuvaus tutkimuskohteen tavoitteista ja toteutuksesta. Kuvaa yritystä ja toimintamallia TETRA-verkossa. Kuvaa toisen mahdollisen TETRA-verkkoon liitettävän sovelluksen järkevyyttä, kustannuksia ja toiminta varmuutta. Kertoo kuinka EPA:n tarjoamaa palvelua voidaan käyttää ja mitä kaikkea sen avulla voidaan saavuttaa. 17

20 Liite 1: Toiminnalliset vaatimukset 13. Liitteet Liite 1: Toiminnalliset vaatimukset Ver Ominaisuus Lähde Perustelu Käyttötapauskuvaus T01 1 Liittymän Jokaiselle laitteelle tulee voida Pete Lyly Poijuissa ei ole varaa Pakollinen K01, K02, K09 valvonta määritellä aikaväli 10 sekunnin ja vuoden väliltä, kuinka usein linjan toiminta Valppaan ja laitteen välillä tarkistetaan. pitää akkuja koko ajan päällä, jolloin ei voida tietää koska ne ovat päällä. Tällöin laite itse huolehtii viestien lähettämisestä T02 1 Liittymän valvonta Eri laitetyypeille voidaan valita linjan toiminnan testaustapa. Yleisimmässä tapauksessa Valpas pollaa linjaa. Toisessa tapauksessa laite lähettää Markus Maanoja Pakollinen K01, K02, K09 T03 T31 T35 T04 A 2 Laitteen toiminnan testaaminen 1 Laitteen toiminnan testaaminen 1 Laitteen toiminnan testaaminen 2 Linjatoiminnan testaaminen säännöllisesti viestin Valppaalle. Jos laiteen toimintatila tarkistetaan automaattisesti, tulee laitteelle voida määritellä kuinka usein linjan testauksen yhteydessä laitteelle lähetetään pyyntö suorittaa anturi-, huolto- tai hyvinvointitesti. Arvot voivat vaihdella joka kerran ja joka kymmenennen kerran välillä. Jokaisen laitteen kohdalla voidaan määritellä testataanko laitteen toimintakuntoa automaattisesti vai manuaalisesti. Manuaalinen testaus on oletusarvo. Jokaiselle laitteelle voidaan määrittää aika, jonka sisällä laitteen tulee vastata sille lähetettyihin testausviesteihin. Oletuksena tämä arvo on 10 minuuttia. Jokaisen laitteen kohdalla tulee voida määritellä tarkastetaanko linjan toimivuus EPA:n statusviestien pohjalta vai siten, että laite lähettää määräajoin viestin Valppaalle. Mikko Weckström Pakollinen ilman rajoituksia kerroille K01, K02, K14 Pete Lyly Pakollinen K01, K02, K14 Pete Lyly Pakollinen ilman oletusarvoa K01, K02, K14 Pete Lyly Tarpeellinen Hylätty K01, K02, K09

21 Liite 1: Toiminnalliset vaatimukset Ver Ominaisuus Lähde Perustelu Käyttötapauskuvaus T32 1 Linjatoiminnan Ensimmäisen linjan testausviestin Pete Lyly Hyödyllinen Ehdotettu K09 testaaminen jälkeen Valpas tarkistaa, minkä T33 1 Linjatoiminnan testaaminen tukiaseman alueella laite sijaitsee. Saman tukiaseman alueella sijaitsevien laitteiden linjojen testausviestit hajautetaan eri sekunneille. T05 1 Verkon testaus Ilmo-simulaattorin ja Valppaan tallentamista tiedoista pitää selvittää TETRA-verkon ja/tai EPA:n aiheuttamien virheiden määrä. T06 1 Verkon testaus Valppaan ja Ilmo-simulaattorin tulee kummankin tallentaa tiedot lähetetyistä ja vastaanotetuista viesteistä/tiedoista. T07 1 Verkon testaus Kaikki viestit tulee varustaa aikaleimoin. T08 1 Verkon testaus Ilmo-simulaattorin tulee tallentaa tieto omasta paikastaan vähintään 10 sekunnin välein. T09 T10 T11 T12 1 Vikatilanteen tunnistus 1 Vikatilanteen tunnistus 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys Valppaan tulee tunnistaa huolto- ja hätäviestit. Valppaan tulee tunnistaa linjavikatilanne. Hätäviesteille tulee voida määritellä maksimissaan 5 eri vastaanottajaa. Huoltoviesteille tulee voida määritellä maksimissaan 5 eri vastaanottajaa, joilla ei välttämättä ole mitään tekemistä hätäviestien vastaanottajien kanssa. Pete Lyly Hyödyllinen Ehdotettu K09 Pete Lyly Markus Maanoja Indagon Valvottuliittymä tutkimussuunnitelma Markus Maanoja Pete Lyly Pete Lyly Järjestelmän tarkoitus on myös testata olemassa olevan verkon luotettavuutta Tällöin voidaan verrata viestien perillemenoa Voidaan tutkia viestien välitysaikoja ja virheiden tapahtuma-aikoja Tällöin voidaan havaita miltä alueita viestit eivät kulje Tulevassa järjestelmässä nämä tiedot käsitellään eri tavalla (ne mm. lähetetään eri paikkoihin) Tämä on järjestelmän pääkäyttökohde. Lisäksi tämä tapaus käsitellään eri tavalla kuin huolto- ja hätäviestit, jotka tulevat valvotulta liittymältä Pakollinen Toteutettu K04, K05, K06, K09, K14 Pakollinen K04, K05, K06, K09, K14 Pakollinen K04, K05, K06, K09, K14 Hyödyllinen Hylätty K06 Pakollinen K07, K08, K09, K14 Pakollinen K09 Pete Lyly Tarpeellinen Ehdotettu K01, K02, K07 Pete Lyly Tarpeellinen Ehdotettu K01, K02, K08 B

22 Liite 1: Toiminnalliset vaatimukset Ver Ominaisuus Lähde Perustelu Käyttötapauskuvaus T13 1 Viestien Huoltoviesteille määritellyille Pete Lyly Hyödyllinen Ehdotettu K01, K02, K08 edelleenvälitys vastaanottajille tulee voida määrittää järjestys, jossa heitä halutaan lähestyä. T14 1 Viestien Huoltoviesteille tulee voida määritellä Pete Lyly Hyödyllinen Ehdotettu K01, K02, K08 T15 T16 T17 T18 T19 T20 T21 T29 edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys 1 Viestien edelleenvälitys kuittausaika. Huoltoviesti lähetetään ensin järjestyksessä ensimmäiselle vastaanottajalle. Mikäli viestiä ei kuitata saaduksi määriteltynä kuittausaikana, viesti lähetetään seuraavalle vaihtoehdolle ja odotus toistetaan. Jos kukaan laitteen huoltoketjussa ei kuittaa huoltoviestiä annetussa ajassa, tulee tilanteesta lähettää tiedonanto taholle, joka on sama kuin linjavikaviestien vastaanottaja. Linjavioille tulee voida määritellä kuittausaika. Linjavika ilmoitetaan taholle, joka on kaikilla laitteilla sama (operaattori). Kaikista järjestelmässä ilmenevistä linjavioista lähetetään tieto myös samalle taholle, jolle laitteen hätäviestit menevät. Jos linjavikaa ei kuitata määritellyssä ajassa, tulee tilanteesta lähettää tiedonanto taholle, joka on sama kuin laitteen hätäviestin vastaanottaja. Standardien ilmoitusten (hätä/huolto) jälkeen laite voi lähettää laitekohtaista lisäinformaatiota, joka Valppaan tulee välittää edelleen samalle taholle kuin standardiviestikin. Huoltoviesti tulee lähettää heti laitteelle määritellylle asiakkaalle. Pete Lyly Hyödyllinen Ehdotettu K08 Pete Lyly Hyödyllinen Ehdotettu K08 Pete Lyly Hyödyllinen Ehdotettu K15 Pete Lyly Hyödyllinen Ehdotettu K15 Pete Lyly Hyödyllinen Ehdotettu K15 Pete Lyly Tarpeellinen Ehdotettu K15, K16 Pete Lyly Hyödyllinen Ehdotettu K07, K08 Pete Lyly Hyödyllinen Ehdotettu K08 C

23 Liite 1: Toiminnalliset vaatimukset Ver Ominaisuus Lähde Perustelu Käyttötapauskuvaus T30 1 Viestien Mikäli ensimmäinen huoltoviestin saaja Pete Lyly Hyödyllinen Ehdotettu K08 edelleenvälitys ja asiakas ovat samat, tulee T22 T23 T24 T25 T26 T27 T28 T34 T36 T37 1 Viestien edelleenlähetys 1 Viestien edelleenlähetys huoltotiedote lähettää vain kerran. Järjestelmään tulee voida liittää erilaisia tapoja viestien edelleenlähetys- ja kuittaustavoiksi (Esimerkiksi sähköposti ja SMS-viestit). Jokaiselle vastaanottajalle tulee voida määrittää tapa, jolla hän haluaa ottaa viestit vastaan Valppaalta (katso myös vaatimus 21). 1 Turvallisuus WWW-pohjaiseen käyttöliittymään pääsee käsiksi vain oikealla käyttäjätunnus/salasanaparilla. 1 Järjestelmään kirjautuminen 1 Asetusten muokkaus 1 Asetusten muokkaus 1 Laitteen toiminnan tarkastelu 1 Järjestelmän asetukset 1 Analysoitavien tiedostojen avaus 1 Tietojen analysointi WWW-käyttöliittymään tulee voida kirjautua sekä admin- että asiakasoikeuksilla. Jokaisen laitteen tietoihin voidaan kirjata laitteeseen liittyvä asiakas. Jokaiselle järjestelmään kirjatulle asiakkaalle voidaan määritellä oletusarvot laitteiden hätäviestien vastaanottajaksi ja huoltoviestien vastaanottoketjuksi. Järjestelmän tulee tarjota ulkoinen rajapinta, johon liittymällä asiakas pystyy seuraamaan laitteidensa tilaa. EPA:lle yhdellä kerralla välitettäväksi annettavien viestien yläraja tulee olla määriteltävissä. Analysaattorille voidaan syöttää useita tiedostoja eri hakemistoista analysoitavaksi Analysattorin tulee laskea kaikkien lähetettyjen viestien yhteismäärä Markus Maanoja Hyödyllinen Ehdotettu K01, K02, K07, K08, K10, K11, K13, K15 Pete Lyly Hyödyllinen Ehdotettu K07, K08, K10, K11, K13, K15 Pete Lyly Viranomaisverkossa tietoturvaan pitää kiinnittää erityistä huomiota Tarpeellinen K01, K02, K03, K10, K11, K12, K13 Pete Lyly Hyödyllinen Ehdotettu K01, K02, K03, K10, K11, K12, K13 Pete Lyly Hyödyllinen Ehdotettu K01, K02, K13 Pete Lyly Hyödyllinen Ehdotettu K01, K02, K10, K11 Mikko Weckström Järjestelmän halutaan tulevaisuudessa toimivan yhteen esimerkiksi Leaderin kanssa Tarpeellinen Ehdotettu K13 Pete Lyly Pakollinen Ehdotettu K09, K14 Kirsi Rönkkö Pakollinen K06 Mikko Weckström Tarpeellinen Toteutettu K06 D

24 Liite 1: Toiminnalliset vaatimukset Ver Ominaisuus Lähde Perustelu Käyttötapauskuvaus T38 1 Tietojen Analysaattorin tulee laskea lähetettyjen Mikko Weckström Pakollinen Toteutettu K06 analysointi ja vastaanotettujen viestien suhde T39 1 Tietojen Analysaattorin tulee laskea kuinka Mikko Weckström Pakollinen Toteutettu K06 analysointi monta kertaa Valpas huomasi linjavika tilanteen T40 1 Tietojen Analysaattorin tulee laskea aika joka Pete Lyly Tarpeellinen K06 T41 T42 analysointi 1 Tietojen analysointi 1 Tietojen analysointi kuluu virhetilanteesta palautumiseen Virhetilanteiden toipumisaika tulee kuvata toipumisaika x-akselilla, y- akselilla vikojen määrä Linjavikojen kuvaamiseen tulee x- akselilla olla aika ja y-akselilla virheiden suhteellinen määrä Mikko Weckström Tarpeellinen K06 Mikko Weckström Tarpeellinen K06 E

25 Liite 2: Ei-toiminnalliset vaatimukset Liite 2: Ei-toiminnalliset vaatimukset Ver Lähde Perustelu Käyttötapauskuvaus E01 1 Järjestelmän tulee toimia yhteen Markus Maanoja Tämä on yleisin tällä hetkellä Pakollinen K04, K05 ainakin TMR880-puhelimen kanssa. käytössä oleva TETRA-puhelin E02 1 Testijärjestelmän arkkitehtuurissa Markus Mikkolainen Voi olla jo tämän projektin Tarpeellinen Toteutettu tulee mahdollisimman pitkälle huomioida tulevan tuotteen asettamat vaatimukset. tehtävä kehittää testiversiosta toimivaa järjestelmää E03 1 Lopullisen järjestelmän tulee Markus Maanoja Tarpeellinen Toteutettu K09, K14 pahimmassa tapauksessa pystyä valvomaan laitetta 100 sekunnin välein. E04 1 Valpas kuuntelee viestejä myös ryhmäosoitteisiin. Pete Lyly Tällöin tieto menee myös muille tahoille, jolloin Valpas ei ole ainoa joka saa tiedon, jos Tarpeellinen K09 E05 1 Valpas lähettää viestejä yksilöosoitteisiin. E06 1 WWW-tietoliikenne tulee suojata ainakin SSL-tason salauksella. E07 1 Ulkoinen rajapinta erilaisille sovelluksille on toteutettu XMLmuodossa. E08 1 Kaikki pollaustapahtumat tallennetaan tietokantaan. E09 1 Laitteen paikkatiedon laskemiseen käytetään MTT100AS-laitetta. E10 1 Simulaatiossa Valppaan tulee varmistaa viestien perillemeno vain ja ainoastaan EPA:n tarjoaman viestistatuksen mukaan. Pete Lyly Pete Lyly Indagon Valvottuliittymä tutkimussuunnitelma Indagon Valvottuliittymä tutkimussuunnitelma Indagon Valvottuliittymä tutkimussuunnitelma asiat eivät toimi Jos viesti lähetetään ryhmäosoitteeseen, ei saada tietää, minne kaikkialle viesti meni perille ja minne ei TETRA-verkossa tietosuoja on tärkeää Tällöin voidaan analysoida liittymän luotettavuutta Tarpeellinen K09, K14 Tarpeellinen Ehdotettu K01, K02, K03, K10, K11, K12, K13 Tarpeellinen Ehdotettu K13 Tarpeellinen Toteutettu K09, K14 Hyödyllinen Hylätty K05 Pete Lyly Hyödyllinen K09 F

26 Liite 2: Ei-toiminnalliset vaatimukset Ver Lähde Perustelu Käyttötapauskuvaus E11 2 Kaikki säädöt Valppaan toimintaan pitää pystyä suorittamaan WWWkäyttöliittymän kautta. Markus Mikkolainen Käyttäjällä ei välttämättä ole oikeuksia palvelinkoneeseen ja/tai teknistä ymmärtämystä ini-tiedostoihin tms. Hyödyllinen ilman kuittausajan määrittelymahdollisuutta K01, K02, K03, K10, K11, K12 E12 E13 E14 2 WWW-käyttöliittymään kirjautuneen henkilön pitää voida nähdä ja saada muokata kaikkia järjestelmässä olevia tietoja. 1 Asiakasoikeuksilla WWWkäyttöliittymään kirjautunut henkilö saa nähdä ja muokata vain niitä tietoja, jotka liittyvät kyseiseen käyttäjään. 1 Simulaattorin käynnistyksen yhteydessä voidaan määritellä, kommunikoiko simulaattori puhelimen kanssa vain ATrajapinnan komentojen avulla vai myös releiden avulla. Kirsi Rönkkö Hyödyllinen K01, K02, K03, K10, K11, K12 Pete Lyly Tarpeellinen Ehdotettu K01, K02, K03, K10, K11, K12 Pete Lyly Kaikissa puhelimissa, jotka saadaan testilaitteistoksi, ei välttämättä ole releiden kytkentämahdollisuutta Pakollinen Hylätty K04, K05 G

27 Liite 3: Rajoitukset Liite 3: Rajoitukset Versio Rajoitus Lähde R01 1 Tietokantana käytetään PostgreSQL:ää Markus Mikkolainen R02 1 WWW-palvelimena käytetään Jettyä Markus Mikkolainen R03 1 Ohjelman sisäisen tilan ja siellä tapahtuvien Markus asioiden raportoimisen tulee tapahtua Log4J:llä Mikkolainen R04 1 Järjestelmän tulee toimia ainakin LINUX-koneilla Markus Maanoja R05 2 Ilmo-simulaattorin tulee pyöriä relepalikan Kirsi Rönkkö välityksellä puhelimeen kiinnitetyllä kannettavalla tietokoneella, joka ei välttämättä ole yhteydessä verkkoon Perustelu Käyttötapauskuvaus Tämä on yrityksessä käytössä ja Pakollinen K01, K02, K03, K10, K11, tuttu K12 Tämä on yrityksessä käytössä ja Hyödyllinen Hylätty K01, K02, K03, K10, K11, tuttu K12, K13 Tämä on yrityksessä käytössä ja Pakollinen K04, K05, K06, K07, K08, tuttu K09, K14, K15, K16 Tarpeellinen Asiakas halusi liikuteltavan järjestelmän, jolla voidaan testata myös verkon katvealueita Tarpeellinen Hylätty K04, K05 H