IoT-anturin liitoksessa yhdistät anturin kentät oikean laitteen eli Spotin attribuutteihin. Valittu anturityyppi määrittää kohdistettavat kentät, ja DevEUI yksilöi anturin. Tarkista sekä Spotti että anturin tunniste huolellisesti ennen liittämistä.

Tämä ohje koskee selainkäyttöliittymää.

Liittämisen edellytykset

IoT-integraation pitää olla sallittu organisaatiolle ja otettu käyttöön. Käyttöönotossa luodaan integraatiotili, jonka olemassaolosta Spotin IoT-toimintojen näkyminen riippuu. Pyydä pääkäyttäjää tarkistamaan käyttöönotto, jos toiminto puuttuu. Katso myös integraation käyttöönoton edellytykset.

Sinulla pitää olla oikeus nähdä Spotti sekä muokkausoikeus sen kansioon. Pelkkä Spotin tietojen katseluoikeus ei riitä anturin liittämiseen, kohdistusten muokkaamiseen tai liitoksen poistamiseen.

Tarvittavien attribuuttien pitää löytyä juuri tältä Spotilta. Anturityypin kentät määräävät, mitä attribuutteja voit valita. Jos tyyppi tarvitsee tagin, liitä tagi Spottiin ja tallenna se ennen anturin liittämistä. Tagin numero ja anturin DevEUI ovat eri tunnisteita. Tagin liittäminen on kuvattu omassa ohjeessaan.

Avaa liittämislomake

  1. Avaa selaimen valikosta Kohteet ja laitteet → Kohteet, laitteet, kalusto ja valitse Taulukkonäkymä.
  2. Hae Spotti Nimi-sarakkeen hakukentästä ja napsauta sen nimeä. Tarkista myös kansio, jotta valitset oikean laitteen. Lisää hakemisesta on ohjeessa Spotin tietojen haku selaimessa.
  3. Avaa Spotin tietojen Perustiedot-välilehti. Valitse sen yläosasta, Nimi-kentän vierestä, Liitä IoT-sensori.

Jos Spotilla on jo liitos, painikkeen tilalla näkyy Liitetty IoT-sensori sekä anturityyppi ja DevEUI. Muokkaa tällöin nykyistä liitosta jäljempänä kuvatulla tavalla.

Valitse anturityyppi ja kohdista kentät

  1. Valitse anturityyppi Valitse sensori -luettelosta. Valinta tuo lomakkeelle kyseisen tyypin kentät. Jos vaihdat tyyppiä ennen tallentamista, kohdistuskentät muodostetaan uudelleen ja attribuutit pitää valita uudelleen.
  2. Syötä anturin DevEUI. Lomake hyväksyy täsmälleen 16 merkkiä: numerot 0–9 ja kirjaimet A–Z tai a–z. Välilyönnit ja välimerkit eivät kelpaa. Kopioi tunniste anturin tiedoista; lomakkeen hyväksymä muoto ei yksin varmista, että tunniste kuuluu oikealle anturille.
  3. Valitse jokaisen anturikentän kohdalla Valitse attribuutti -kentästä oikea Spotin attribuutti.
  4. Tarkista tyyppi, DevEUI ja kaikki kohdistukset. Valitse liittämislomakkeen alareunasta Liitä IoT-sensori.

Kaikkien anturityypin kohdistuskenttien pitää olla täytettyjä. Tekstityyppisen anturikentän kohteeksi voi valita teksti- tai numeroattribuutin. Numerotyyppisen anturikentän kohteeksi voi valita vain numeroattribuutin. Esimerkiksi numeerinen lämpötilakenttä tarvitsee Spotilta numeroattribuutin, joka on tarkoitettu lämpötilalle. Tarkista myös, että kentän merkitys ja mahdollinen yksikkö vastaavat anturin tietoa.

Tagia käyttävä kenttä saa automaattisesti Spotin tagin sisäisen tunnisteen. Kohdistus on lukittu, eikä siihen valita mittausattribuuttia tai syötetä tagiin painettua numeroa. Jos Spotilta puuttuu tagi, tagia vaativaa anturityyppiä ei voi valita.

Jos sopivaa attribuuttia ei näy, tarkista, että se on lisätty Spotille ja sen tyyppi sopii anturikenttään. Täydennä ja tallenna Spotin tiedot ensin, avaa Spotti uudelleen ja aloita liittäminen vasta sen jälkeen. Attribuuttien määrittelyä käsittelee attribuuttien luomisen ohje.

Varmista liitoksen tallentuminen

Onnistuneen tallennuksen jälkeen liittämislomake sulkeutuu ja saat onnistumisilmoituksen. Sulje Spotin tiedot ja avaa sama Spotti uudelleen: tallennuksen jälkeen IoT-tietojen alue voi jäädä piiloon nykyisessä näkymässä.

Tarkista Perustiedot-välilehden Liitetty IoT-sensori -tiedosta anturityyppi ja DevEUI. Avaa tiedon vieressä olevasta kynäkuvakkeesta liitoksen lomake ja tarkista myös tallennetut attribuuttikohdistukset.

Tallennettu liitos ei yksin osoita, että anturi on lähettänyt uuden mittauksen tai että Spotin attribuutti on päivittynyt. Liittämislomake ei näytä mittausarvoja eikä niiden mittausajankohtaa. Älä tulkitse Spotilla jo olevaa arvoa uudeksi mittaukseksi pelkän onnistumisilmoituksen perusteella.

Muuta kohdistuksia tai vaihda anturi

Avaa Liitetty IoT-sensori -tiedon vieressä oleva kynäkuvake. Voit muuttaa attribuuttikohdistuksia ja tallentaa ne lomakkeen Tallenna-painikkeella. Anturityyppi ja DevEUI ovat tässä lomakkeessa lukittuja. Tagikentän kohdistus pysyy automaattisena.

Anturin vaihtaminen tai väärän DevEUI:n korjaaminen edellyttää vanhan liitoksen poistamista ja uuden liittämistä:

  1. Tarkista muokkauslomakkeesta nykyisen anturin DevEUI ja varmista, että olet oikealla Spotilla.
  2. Valitse lomakkeen alareunasta Poista ja hyväksy poistovahvistus.
  3. Onnistuneen poistamisen jälkeen sulje Spotin tiedot ja avaa ne uudelleen. Tarkista, että vanha liitos on poistunut.
  4. Valitse Liitä IoT-sensori ja määritä uusi anturi sekä sen kohdistukset.

Poistaminen poistaa Spotillasta anturin liitostiedon. Se ei poista itse Spottia, sen attribuutteja tai niihin tallennettuja arvoja eikä nollaa niitä. Poisto lähettää myös poistopyynnöt ulkoiseen integraatiopalveluun. Tästä toiminnosta ei voi päätellä fyysisen anturin sammumista tai kaikkien ulkoisten tietojen ja mittausten poistumista.

Tarkista Lora-verkon tiedot

Valitse Perustiedot-välilehdellä liitetyn anturin tiedon vierestä Lora-verkon tiedot. Taulukko haetaan kyseisen DevEUI:n perusteella.

Luettu-sarake näyttää verkkotietueen aikaleiman. LrrRSSI esitetään dBm-yksikössä ja LrrSNR dB-yksikössä. Nämä ovat radioyhteyden tietoja, eivät esimerkiksi anturin mittaama lämpötila tai kosteus. Taulukossa näkyy myös muita teknisiä verkkotietoja.

Verkkotietueen aikaleima ei varmista kohdistetun attribuutin päivittymistä eikä sen arvon tuoreutta. Näkymä ei myöskään kerro, kuinka usein mittaukset päivittyvät. Jos tarvitset varmistuksen mittausten saapumisesta, pyydä pääkäyttäjää tai Spotillan yhteyshenkilöä tarkistamaan kyseisen anturin tiedonsiirto.

Jos liittäminen tai poistaminen epäonnistuu

Painike tai kynäkuvake puuttuu. Tarkista pääkäyttäjältä IoT-integraation käyttöönotto, integraatiotilin olemassaolo ja muokkausoikeus Spotin kansioon.

Lomake ei hyväksy tallennusta. Tarkista anturityypin valinta, DevEUI:n 16 merkin muoto ja kaikki attribuuttikohdistukset. Tagia vaativalle tyypille pitää olla tallennettu tagi.

Palvelu ilmoittaa virheestä. Liittäminen ja poistaminen tarvitsevat myös ulkoisen integraatiopalvelun onnistuneen vastauksen. Avaa Spotin tiedot uudelleen ja tarkista nykyinen liitos ennen uutta yritystä. Virheilmoitus ei yksin varmista, ettei jokin käsittelyn vaihe olisi jo onnistunut. Anna selvitystä varten oikean Spotin tiedot, anturin DevEUI ja virheilmoitus.