This is an old revision of the document!
Table of Contents
Setup:n tekeminen IoT_GURUuun
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
IoT_GURU parametrien tekeminen Mitsurunneriin
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'
IoT_GURU toiminna testaaminen
⇒ 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
Konfigurointi useammalle loggerille (Mitsurunnerille)
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ö ....