MitsuRunner

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== MitsuRunner & IoT-GURU ======
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ä.)

===== Setup:n tekeminen IoT-GURUun =====

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

===== IoT-GURU asetusten määrittäminen Mitsurunneriin =====

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'

===== IoT-GURUn testaaminen =====

=> 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

===== Konfigurointi useammalle loggerille (Mitsurunnerille) =====

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:
<code>
Device: Mitsurunner1
..Node: Alakerta
....Field: Delta
....Field: Ulkolämpö
.........
</code>

Usemman laitteen tapauksessa täytyy jokaiselle laitteele määritellä oma "Device" IoT-Guruun:
<code>
Device: Mitsurunner2
..Node: Yläkerta
....Field: Delta
....Field: Ulkolämpö
.........

(
Device: Logger1:
..Node: Kylpyhuone
....Field: Lämpö
....Field: Kosteus
)
</code>
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.

<code>
Device: Mitsurunner1

Device: Mitsurunner2
..Node: Alakerta
....Field: Delta
....Field: Ulkolämpö
.......
..Node: Yläkerta
....Field: Delta
....Field: Ulkolämpö
....
</code>

Kirijoitahan aakkoset vallan takaperoisesti ähvästä aahan isoilla kirijaimilla (kuusi kirijainta): Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: Public Domain