IoT-Guru on maksuton pilvipalvelu, jonne Mitsurunner oletusarvoisesti raportoi MQTT:llä tilatietonsa (ulkolämpö, kennolämpö, deltaT, jne). Voit nettiselaimella tarkastella kunkin raportoidun parametrin nykytilaa ja historia-kuvaajaa. Iotguru ei ole pakollinen mutta erittäin suositeltavaa, sillä tuota kautta voit seurata lämpöpumppusi toimintaa ja varmistaa että kennon sulatus toimii suunnitellulla tavalla.

Alla ohjeet raportoinnin ja seurannan aktivoimiseen IoT-Gurussa.

(IoT-Gurun sijasta voit käyttää raportointiin jotakin muuta mqtt-palvelinta, mutta niille ei ohjeita täällä.)

Mene osoitteeseen https://iotguru.live/

Luo itsellesi Account painamalla ylhäältä Sign up.

• tuon alle DEVICE esim. “wemos”
• tuon alle NODE esim. “mitsu”
  • tuon alle tarvittava määrä FIELDejä, esim. “ulko”, “kenno”, “delta”
• Mitsurunner toiminnan seuraamista auttaa jos määrittelet myös FIELDit “rssi”, “outerror”, “heatexcherror”,“state”

FIELD-välilehden help-osiosta kohdasta GENERIC MQTT TOPIC löydät tyyppiä

"pub/jGwFuf8I***N2hAddcR6w/p5NVA6zTB***hNCQMvoR7A/itRVfK2***O-yHJgNOcR7A/ulko"

olevat määritteet, jotka voit kopioida platform.yaml-tiedostoon allakuvatusti

Muokkaa platform.yaml-tiedostoa: mqtt:

broker: 195.201.219.208 <== IoT-GURUn osoite
id: mqtt_client
username: jGwFuf8I4spe***AddcR6w <== kopio IoT-GURU Your Account -sivulta löytyvä SHORT IDENTIFIER
client_id: p5NVA6zTBfP***CQMvoR7A <== kopio IoT-GURU "wemos"DEVICE/Device Details -sivulta löytyvä DEVICE SHORT IDENTIFIER
password: h06UcwI2-dAp***4ZvVEVA <== kopio IoT-GURU "wemos"DEVICE/Device Details -sivulta löytyvä DEVICE KEY

Kopio IoT-GURU-sivuilta valmiit MQTT-stringit:

# MQTT topics. These are inside single quotes
topic_heatexchanger: 'kopio IoT-GURU "mitsu"NODE-"kenno"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän
topic_outdoor: 'kopio IoT-GURU "mitsu"NODE-"ulko"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
topic_delta: 'kopio IoT-GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'

Jos määrittelit aiemmin IoT-Guruun lisäFIELDit, tee vastaavat lisäykset myös platform.yaml-tiedostoon

topic_rssi: 'kopio IoT_GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
topic_outdoor_errors: 'kopio IoT-GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
topic_exchanger_errors: kopio IoT-GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
topic_outdoor_errors: 'kopio IoT-GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
# MQTT topics. Notice that these are inside both single and double quotes:
topic_state: '"kopio IoT-GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän"'

⇒ ovat siis muotoa: /uuu/ccc/nnn/field-name/ , jossa uuu = user_id, ccc = client_id, nnn = node_short_identifier esim: topic_heatexcharger: 'pub/jGwFuf8I4spe*AddcR6w/p5NVA6zTBfP*CQMvoR7A/itRVfK2hvdO-yHJgNOcR7A/kenno' topic_outdoor: 'pub/jGwFuf8I4spe*AddcR6w/p5NVA6zTBfP*CQMvoR7A/itRVfK2hvdO-yHJgNOcR7A/ulko'

⇒ Käännä ja lähetä Mirsurunner-ohjelma laitteellesi Windows-ruudulle tulevassa logissa pitäisi näkyä

Connecting to MQTT
MQTT Connected!

Toimii - määrittelemäsi “kenno”, “ulko” ja “delta” lämpötilojen päivittyvät IoT-GURUun. Tarkista vielä Iot-gurusta.

Jos edellä määrittelit IoT-Guruun lisäFIELDit

"rssi" = WiFi-signaalin taso
"outdoor_errors" = outdoor-anturin lukuvirheet
"exchanger_errors" = exchanger-anturin lukuvirheet
"state" = Mitsurunnerin tilakoneen tila

Mitsurunner ohjeissa on neuvottu IoT-Guru-konfigurointi ja IoT-Guru-parametrien määrittely platform.yaml-koodiin. Ohje ei kuitenkaan kerro mitä pitää tehdä jos aiot laittaa useampia Mitsurunnereita (tai loggereita tai mqtt_client'eja) lähettämään/pyytämään tietoja IoT-Guruun. On huomioitava että mqtt-protokolla vaatii jokaiselle yhteyttä muodostavalle laitteelle oman yksilöllisen tunnuksen =⇒ Jokaiselle IoT-Guruun liitettävälle laitteelle on luotava IoT-Gurussa oma “Device” ja alla mainitut IoT-Gurun parametrit tulee kopioida IoT-Gurusta liitettävälle laitteelle.

• user short identifier =⇒ User name
• device short identifier =⇒ Client_id
• device key =⇒ Password

Raportoitavat kohteet määritetään IoT-Gurussa “Device”/“Node”/“Field” -rakenteilla. Mitsurunner-ohjeessa (yksi Mitsurunner) on neuvottu rakenne:

Device: Mitsurunner1
..Node: Alakerta
....Field: Delta
....Field: Ulkolämpö
.........

Usemman laitteen tapauksessa täytyy jokaiselle laitteele määritellä oma “Device” IoT-Guruun:

Device: Mitsurunner2
..Node: Yläkerta
....Field: Delta
....Field: Ulkolämpö
.........

(
Device: Logger1:
..Node: Kylpyhuone
....Field: Lämpö
....Field: Kosteus
)

IoT-Guru sallii raporttien lähettämisen myös toiselle “Device”:lle. Näin ollen IoT-Guru-rakenne voidaan tehdä myös niin että yhden “Device”:n alle ei määritellä mitään ja kaikki raportointi tehdään toiselle “Device”:lle - graafien selaaminen vaatii tällöin vähemmän klikkauksia.

Device: Mitsurunner1

Device: Mitsurunner2
..Node: Alakerta
....Field: Delta
....Field: Ulkolämpö
.......
..Node: Yläkerta
....Field: Delta
....Field: Ulkolämpö
....