Differences

This shows you the differences between two versions of the page.

--- fi:iot_guru [2023/01/18 22:52] – created puu
+++ fi:iot_guru [2025/03/28 17:55] (current) – 84.248.112.152
@@ Line 1: / Line 1: @@
-===== Setup:n tekeminen IoT_GURUuun =====
+====== 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,
+Luo itsellesi Account painamalla ylhäältä Sign up.
   * tuon alle DEVICE esim. "wemos"
    * tuon alle NODE esim. "mitsu"
-    * tuon alle tarvittava määrä FIEDejä, esim. "ulko", "kenno", "delta"
+    * 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
+olevat määritteet, jotka voit kopioida platform.yaml-tiedostoon al
+===== IoT-GURU asetusten määrittäminen Mitsurunneriin =====
+**Secrets.yaml**-tiedostssa valitse IoT_Guru MQTT-serveri käyttöön poistamalla #-merkit IoT-Guru MQTT määritysrivien alusta ja päivitä MQTT username, client_id ja password
+  mqtt:
+      broker:  iotguru.cloud <== IoT-GURUn osoite
+      id: mqtt_client
+      username: kopio IoT-GURU Your Account -sivulta löytyvä SHORT IDENTIFIER
+      client_id: kopioi IoT-GURU DEVICE/Device Details -sivulta löytyvä DEVICE SHORT IDENTIFIER
+      password: kopioi IoT-GURU DEVICE/Device Details -sivulta löytyvä DEVICE KEY
+** Secrets.yaml**-tiedostossa voit myös ottaa käyttöön web_serverin poistamalla #-merkit rivien web_server: ja port: 80 edestä. Tällöin voit nähdä Mitsurunnerin tilan kirjautumalla selaimella Mitsurunnerin IP_osoitteeseen.
-===== IoT_GURU parametrien tekeminen Mitsurunneriin =====
+**Platform_wemos.yaml / Platform_elite.yaml** tiedostoon päivitä MQTT-topic osuus kopioimalla IoT-GURU-sivuilta käyttämäsi MQTT-topicit. Jätä käyttämättömät topicit muuttamatta.
-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_heatexchanger: 'IoT-GURU DEVICE/NODE/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_outdoor: 'IoT-GURU DEVICE/NODE/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'
+  topic_delta: 'IoT-GURU DEVICE/NODE/FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän
+  topic_rssi 'IoT-GURU DEVICE/NODE/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_outdoor_errors: 'IoT-GURU DEVICE/NODE/FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän
-  topic_rssi: 'kopio IoT_GURU "mitsu"NODE-"delta"-FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän'
+  topic_exchanger_errors: 'IoT-GURU DEVICE/NODE/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_outdoor_errors: 'IoT-GURU DEVICE/NODE/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"'
+  topic_outdoor_raw: '"pub/uuu/ccc/nnn/outdoor_raw_temperature"'
+  topic_state: 'IoT-GURU DEVICE/NODE/FIELD/Help-välilehdeltä GENERIC MQTT TOPIC string tähän
+  topic_excess_timer_state: '"pub/uuu/ccc/nnn/excess_timer_state"'
 => ovat siis muotoa: /uuu/ccc/nnn/field-name/ , jossa uuu = user_id, ccc = client_id, nnn = node_short_identifier
@@ Line 43: / Line 53: @@
 topic_outdoor: 'pub/jGwFuf8I4spe***AddcR6w/p5NVA6zTBfP***CQMvoR7A/itRVfK2hvdO-yHJgNOcR7A/ulko'
-===== IoT_GURU toiminna testaaminen =====
+===== IoT-GURUn testaaminen =====
-=> Käännä ja lataa Mirsurunner-ohjelma laitteellesi
+NOTE: IoT-Guru ei tue MQTT_trace-logia (=trace logi näkyy ainoastaan USB-yhteydellä). Turhan kuormituksen välttämiseski on MQTT-login lähetys poistettu. Ohjelma kannatta kääntää komennolla
-Windows ruudulle tulevassa logissa pitäisi näkyä
+  esphome run --no-logs mitsurunner.yaml
-  Connecting to MQTT
+Tällöin flashayksen jälkeen ei ruudulle tule Python-poikkeamailmoituksia.
-  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
+=> Käännä ja lähetä Mirsurunner-ohjelma laitteellesi.
-  "rssi" = WiFi-signaalin taso
+    * jos laite on liitetty USB-yhteydellä voit trace-logsta nähdä MQTT-yhteyden tilan
-  "outdoor_errors" = outdoor-anturin lukuvirheet
+    * jos olet ottanut WEB-serverin käyttöön voit kirjautua selaimella Mitsurunnerin IP-osoitteeseen ja nähdä sieltä MQTT-yhteyden tilan
-  "exchanger_errors" = exchanger-anturin lukuvirheet
+    * tarkista IoT-Gurusta että määrittelemäsi Topicit päivittyvät
-  "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.
+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 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.
+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
@@ Line 67: / Line 74: @@
-Raportoitavat kohteet määritellään IoT-Gurussa "Device"/"Node"/"Field" rakenteilla
+Raportoitavat kohteet määritetään IoT-Gurussa "Device"/"Node"/"Field" -rakenteilla. Mitsurunner-ohjeessa (yksi Mitsurunner) on neuvottu rakenne:
-Mitsurunner-ohjeessa (yksi Mitsurunner) on neuvottu allaoleva rakenne
 <code>
 Device: Mitsurunner1
@@ Line 77: / Line 83: @@
 </code>
-Usemman laitteen tapauksessa täytyy jokaiselle laitteele määritellä oma "Device" IoT-Guruun.
+Usemman laitteen tapauksessa täytyy jokaiselle laitteele määritellä oma "Device" IoT-Guruun:
 <code>
 Device: Mitsurunner2
@@ Line 92: / Line 98: @@
 )
 </code>
-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)
+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>