IoT-Guru on maksuton mqtt-pohjainen palvelu, jonne Mitsurunner oletusarvoisesti raportoi tilatietonsa (ulkolämpö, kennolämpö, deltaT, jne) ja josta voit Web-selaimella tarkastella kunkin raportoidun parametrin nykytilaa ja historia-kuvaajaa. Mitsurunnerin toiminnalle raportointi ei ole pakollista, 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 tälle ei ole ohjeita täällä.)

Mene osoitteeseen https://iotguru.live/

Luo itsellesi Account,

• tuon alle DEVICE esim. “wemos”
• tuon alle NODE esim. “mitsu”
  • tuon alle tarvittava määrä FIEDejä, 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

Editoi platform.yaml tiedostoa: mqtt:

broker: 195.201.219.208 <== IoT-GURUn osoite
id: mqtt_client
username: jGwFuf8I4spe***AddcR6w <== kopio IoT_GURU your accout 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 valmiit mqtt-stringit IoT-GURU sivuilta

# 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 edellä määrittelit 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 lataa Mirsurunner-ohjelma laitteellesi Windows ruudulle tulevassa logissa pitäisi näkyä

Connecting to MQTT
MQTT Connected!

ja määrittelemäsi “kenno”, “ulko” ja “delta” lämpötilat päivittyvät IoT_GURUun

Jos edellä määrittelit IoT_Guruun lisäFIELDit

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

Mitsurunner ohjeissa on neuvottu IoT-Guru konfigurointi ja IoT-Guru parametrien määrittely platform.yaml-koodiin. Tuo 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 omaa yksilöllistä tunnusta. =⇒ Jokaiselle IoT-Guruun liitettävälle laitteille on IoT-Guruun määriteltävä oma “Device” ja allamainitut IoT-Gurun määrittelemät parametrit on määriteltävä (=kopioitava IoT-Gurusta) liitettävälle laitteelle.

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

Raportoitavat kohteet määritellään IoT-Gurussa “Device”/“Node”/“Field” rakenteilla Mitsurunner-ohjeessa (yksi Mitsurunner) on neuvottu allaoleva 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äinollen IoT-Guru rakenne voidaan tehdä myös niin että yhden “Device”n alle ei määritellä mitään ja kaikki raoprtointi 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ö
....