Laitteiden hallinta

Mikä on MQTT?

MQTT on kevyt viestintäprotokolla, jota käytetään laitteiden väliseen kommunikointiin. Optimaatti käyttää MQTT:tä laitteiden ohjaamiseen ja tilan seuraamiseen.

Ennen kuin aloitat (tärkeä checklist)

• -Varmista, että laite on kotiverkossa ja pääset sen web-käyttöliittymään (IP-osoite).
• -Hae Optimaatista MQTT-tunnukset: host, portti, käyttäjätunnus ja salasana.
• -Käytä aina täsmälleen Optimaatin näyttämiä arvoja (kirjoitusvirheet ovat yleisin syy ongelmiin).
• -Jos laitteessa on TLS/SSL -asetus, pidä se päällä ja käytä Optimaatin ohjeistamaa porttia.
• -Aloita yhdellä laitteella, varmista että se näkyy ja reagoi, ja lisää vasta sitten seuraavat.

TLS/SSL ja portit (miksi ne ovat tärkeitä)

Monissa MQTT-asennuksissa yhteys kannattaa salata (TLS/SSL). Jos TLS on päällä, käytä TLS-porttia. Jos TLS on pois päältä mutta yrität yhdistää TLS-porttiin (tai päinvastoin), yhteys ei muodostu. Käytä aina Optimaatin MQTT-tunnukset -sivun arvoja ja ohjeita.

MQTT-asetusten tekeminen (web-käyttöliittymä)

1. Avaa laitteen (esim. Shelly) web-käyttöliittymä selaimessa sen IP-osoitteella
2. Mene Settings → Advanced → MQTT (tai vastaavaan MQTT-asetusnäkymään)
3. Ota MQTT käyttöön (Enable MQTT)
4. Varmista TLS/SSL-asetus (jos laitteessa on valinta). Yleensä TLS pidetään päällä, ja portti valitaan sen mukaisesti.
5. Avaa Optimaatti-sovelluksessa "MQTT-tunnukset" -sivu
6. Kopioi palvelimen osoite (host), portti, käyttäjätunnus ja salasana Optimaatista
7. Liitä arvot laitteen MQTT-asetuksiin täsmälleen samoina
8. Tallenna asetukset ja käynnistä laite uudelleen, jos käyttöliittymä sitä ehdottaa

Host, portti, käyttäjätunnus ja salasana haetaan aina Optimaatin "MQTT-tunnukset" -sivulta.
Älä käytä kiinteitä esimerkkiarvoja (kuten mqtt.yourdomain.fi), vaan aina järjestelmän näyttämiä arvoja.

Yleisimmät MQTT-kentät ja mitä ne tarkoittavat

• -Host: MQTT-palvelimen osoite. Kopioi sellaisenaan Optimaatista.
• -Port: TLS ja non-TLS ovat eri portteja. Väärä portti = ei yhteyttä.
• -Username/Password: käyttäjäkohtaiset tunnukset. Väärä salasana = “not authorized”.
• -Client ID: jos laite sallii muokkauksen, pidä uniikkina. Sama clientId kahdella laitteella aiheuttaa yhteyden katkeilua.
• -Keepalive: jos laite tukee, pidä oletus (liian pieni voi lisätä katkeilua huonossa verkossa).

Shelly-laitteen käyttöönotto ilman Shelly Appia

1. Kytke Shelly virtaan (asennus tehty pätevän sähköasentajan toimesta)
2. Odota, että Shelly luo oman WiFi-verkon (esim. "shellyplus1-XXXXXX")
3. Yhdistä puhelimella tai tietokoneella tähän Shellyn WiFi-verkkoon
4. Avaa selain ja mene osoitteeseen http://192.168.33.1
5. Valitse Shellyn käyttöliittymässä oma kotiverkkosi (SSID) ja syötä sen salasana
6. Tallenna asetukset – Shelly liittyy nyt kotisi WiFi-verkkoon
7. Etsi Shellyn IP-osoite kotireitittimen laitelistasta ja avaa laitteen web-käyttöliittymä selaimessa (esim. http://192.168.1.123)
8. Mene laitteen MQTT-asetuksiin (Settings → Advanced → MQTT)
9. Ota MQTT käyttöön ja syötä Optimaatin "MQTT-tunnukset" -sivulta kopioidut host, portti, käyttäjänimi ja salasana
10. Tallenna asetukset ja odota, että laite ilmestyy Optimaatin Laitteet-näkymään automaattisesti

Mistä saan MQTT-tunnukset?

MQTT-tunnukset löydät Optimaatti-dashboardista kohdasta "Asetukset" → "MQTT-tunnukset". Jokaisella käyttäjällä on omat tunnuksensa.

Pikapolku: “Haluan vain saada yhden laitteen näkyviin nopeasti”

1. Hae MQTT-tunnukset Optimaatista (host/port/user/password).
2. Avaa Shellyn web-UI (IP-osoite) ja ota MQTT käyttöön.
3. Syötä tunnukset, tallenna ja odota 10–60 sekuntia.
4. Avaa Optimaatin Laitteet-sivu ja tarkista että laite ilmestyy listaan.
5. Jos ei ilmesty: tarkista TLS/portti ja käyttäjätunnus/salasana (yleisin syy).

Miten laitteet ilmestyvät järjestelmään?

Kun Shelly-laite on konfiguroitu käyttämään MQTT:tä, se ilmoittaa automaattisesti olemassaolostaan. Optimaatti havaitsee laitteen ja lisää sen dashboardiin muutamassa sekunnissa.

Mitä tietoja laite lähettää?

• -Laitteen malli (esim. Shelly Plus 1PM)
• -MAC-osoite
• -IP-osoite
• -Firmware-versio
• -Kanavien määrä
• -Tila (päällä/pois)
• -Tehonkulutus (jos tuettu)

Jos mallia ei tunnisteta automaattisesti

Jos laitteen mallia ei tunnisteta automaattisesti, voit asettaa mallin laitteen tietojen muokkaussivulla. Malli on tärkeä, koska sen perusteella määräytyy laitteen ulostulojen (kanavien) määrä. Jos laitteessa on useampi ulostulo, ne voidaan määritellä ja nimetä yksitellen.

Laitteen metatiedot: laitetyyppi, käyttötarkoitus ja mittaus

Kun laite on löytynyt järjestelmään, kannattaa avata laitteen muokkaus ja täyttää tärkeimmät metatiedot. Ne vaikuttavat siihen, missä näkymissä laite näkyy ja miten raportit lasketaan.

• -Laitetyyppi: vaikuttaa mm. kanavien/lähtöjen määrään ja siihen, miten laitetta ohjataan.
• -Käyttötarkoitus: auttaa järjestelmää tulkitsemaan laitetta (esim. Lämmitys vs Valaistus vs Pistorasia/relay).
• -Tukee energiamittausta: jos laite lähettää energiamittauksia, se voidaan ottaa mukaan Kustannusanalyysiin.
• -Tämä laite on lämmitin + Nimellisteho (W): käytetään lämmityskustannusten ennustamiseen (ja auttaa myös lämmityslaitteiden tunnistuksessa).
• -Lämpötila-anturi: voit liittää erillisen anturin lämmityslaitteelle (hyödyttää mm. Away-kattavuusraporttia).

Laitteen nimeäminen

Voit nimetä laitteet uudelleen dashboardissa. Klikkaa laitteen nimeä ja kirjoita uusi nimi. Tämä helpottaa laitteiden tunnistamista.

Huoneiden ja ryhmien luominen

Järjestä laitteet huoneisiin ja valoryhmiin. Avaa Optimaatin Huoneet-näkymä, luo uusi huone ja lisää siihen laitteita. Huoneen sisällä voit luoda valoryhmiä (esim. "Olohuoneen valot") ja lisätä niihin yhden tai useamman huoneen laitteen.

Sensorit ja valoryhmien ohjaus

1. Avaa haluamasi huoneen sivu Huoneet-näkymästä.
2. Luo tarvittaessa uusi valoryhmä (esim. "Käytävän valot") ja lisää siihen huoneen valolaitteet.
3. Lisää huoneeseen sensori (esim. liiketunnistin) ja valitse, mihin laitteeseen ja tuloon sensorin tieto tulee.
4. Yhdistä sensori valoryhmään, jota sen halutaan ohjaavan.
5. Kun sensorit ja valoryhmät on kytketty, voit käyttää niitä yhdessä sääntöjen kanssa automaattiseen valaistuksen ohjaukseen.

Manuaalinen ohjaus

Voit ohjata laitteita manuaalisesti dashboardista riippumatta säännöistä. Klikkaa laitteen kytkin-painiketta päällä/pois-tilan vaihtamiseksi.

Laitetyyppi ja käyttötarkoitus (miksi ne pitää täyttää)

1. Avaa laite Laitteet-näkymästä ja siirry muokkaamaan laitteen tietoja
2. Valitse "Laitetyyppi" (jos se puuttuu). Tämä kertoo Optimaatille mm. kuinka monta lähtöä laitteessa on ja miten ohjaus kohdistuu.
3. Valitse "Käyttötarkoitus" (esim. Lämmitys, Valaistus, Ilmanvaihto, Pistorasia/relay). Tämä helpottaa automaatioiden ja ryhmittelyn toimintaa.

Tehonmittaus / energiamittaus

Jos laite tukee energiamittausta (esim. PM-mallit), ruksaa "Tukee energiamittausta". Tämä vaikuttaa suoraan Kustannusanalyysiin: vain energiamittauslaitteet näkyvät analyysissä ja raporteissa.

Lämmityslaite ja nimellisteho (W)

Jos laite ohjaa lämmitystä, merkitse "Tämä laite on lämmitin" ja syötä "Nimellisteho (W)". Nimellistehoa käytetään lämmityskustannusten ennustamiseen. Jos et tiedä tarkkaa arvoa, katso laitteen/kuorman tyyppikilpeä tai sähköasennuksen dokumentaatiota.

Lämpötila-anturin liittäminen laitteelle

Jos lämmityslaitteella ei ole omaa lämpötilalukemaa, voit liittää erillisen anturilaitteen. Tämä parantaa lämpötilaan perustuvien sääntöjen tulkintaa ja näkyy myös Away-kattavuusraportissa.

Mikä on demolaitteet-toiminto?

Demolaitteet ovat virtuaalisia Shelly-laitteita, joilla voit kokeilla Optimaattia ilman että yksikään oikea laite kytkeytyy päälle tai pois. Ne käyttävät oikeita spot-hintoja ja samoja sääntöjä/MPC-laskentaa kuin oikeat laitteet.

Näin lisäät demolaitteen

1. Kirjaudu Optimaattiin ja avaa Kojelauta-näkymä.
2. Etsi kojelaudalta kortti "Lisää demolaite" (demo-opas).
3. Valitse alasvetovalikosta demolaitteen tyyppi (esim. Shelly 1PM demo, Shelly 2PM demo tai anturilaite demo).
4. Paina painiketta "Lisää demolaite".
5. Avaa Laitteet-näkymä – uusi demolaitteesi näkyy listassa DEMO-merkinnällä, ja sille voi luoda samoja sääntöjä kuin oikeille laitteille.

Demolaitteiden rajoitukset

• -Demolaitteet eivät koskaan ohjaa fyysistä relettä tai lämmitystä – ne ovat täysin virtuaalisia.
• -Voit luoda rajatun määrän demolaitteita (esim. muutaman laitteen), jolloin näkymä pysyy selkeänä.
• -Tarvittaessa voit nollata koko demoympäristön kojelaudan "Nollaa demoympäristö"-painikkeella ja aloittaa alusta.

Laite ei ilmesty järjestelmään

• -Tarkista että MQTT on otettu käyttöön laitteessa
• -Varmista että host on oikein (kopioitu Optimaatista, ei kirjoitusvirheitä)
• -Tarkista portti (TLS vs non-TLS) ja että TLS/SSL-asetus vastaa porttia
• -Tarkista käyttäjätunnus ja salasana (kopioi uudelleen Optimaatista)
• -Varmista että laite on online kotiverkossa ja pääsee internetiin
• -Odota 1–2 min ja päivitä Laitteet-näkymä
• -Jos sama laite näkyy kahdesti tai katoaa: tarkista ettei toisella laitteella ole sama clientId

Laite näkyy offline-tilassa

• -Tarkista laitteen internet-yhteys
• -Varmista että MQTT-palvelin on tavoitettavissa
• -Käynnistä laite uudelleen
• -Tarkista että MQTT-salasana ei ole vanhentunut
• -Tarkista että reititin ei blokkaa ulospäin meneviä yhteyksiä (palomuuri/vanhemmat asetukset)

Laite ei reagoi komentoihin

• -Tarkista että laite on online-tilassa
• -Varmista että sinulla on oikeudet ohjata laitetta
• -Kokeile manuaalista ohjausta laitteen web-käyttöliittymästä
• -Tarkista että laitteen firmware on ajan tasalla
• -Jos ohjaat usean kanavan laitetta (esim. 2PM/Pro): varmista että ohjaus kohdistuu oikeaan kanavaan

Jos ongelma jatkuu

Jos yllä olevat kohdat on tarkistettu ja laite ei edelleenkään ilmesty tai pysyy offline-tilassa, siirry vianmäärityssivulle. Sieltä löytyy tarkempi päätöspuu ja tarkistuslista.