Differences

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

--- fi:instructions_sw [2025/01/12 09:59] – tarkennuksia 2605:6400:30:f4ae:8f7b:cc6e:d1d7:b978
+++ fi:instructions_sw [2025/11/27 19:16] (current) – FEDCBA 84.248.101.39
@@ Line 1: / Line 1: @@
-termit:
+ftermit:
 Windowsin komentokehoite = macilla "terminal"
 ====== Asenna ESPHome ======
   * ESPHome käyttää Python'ia, joten ensin tarvittaessa lataa ja asenna osoitteesta https://python.org/
-  * Avaa "komentokehote" ja asenna ESPHome antamalla komento: <code>pip3 install esphome</code>
+  * "komentokehote" ja asenna ESPHome antamalla komento: <code>pip3 install esphome</code>
+  * ESPhome asentuu, asennuksessa mahdollisesti tulevista WARNINGeista ei tarvitse välittää.
-ESPhome asentuu, asennuksessa mahdollisesti tulevista WARNINGeista ei tarvitse välittää.
+  * Nyt kehitysympäristö on koneellasi ja voit sulkea "komentokehotteen".
-Nyt kehitysympäristö on koneellasi ja voit sulkea "komentokehotteen".
 HUOM: Mitsurunner alkaen versiosta "Compatibility with ESPHome 2024.6.6 and later" on yhteensopiva uusien ESPHome-versioiden kanssa mutta ei toimi vanhemmilla ESPHome-versioilla. Uusimman ESPHome-version saat asennettua komentokehotteella <code>pip3 install esphome -U</code>
@@ Line 14: / Line 13: @@
 Lisäohjeita täältä: https://www.esphome.io/guides/getting_started_hassio.html
+====== USB-serial-ajurin asennus ======
+Asenna käyttämäsi alustan USB-serial-ajuri.
+Esimerkeksi Wemos D1 mini käyttää CH340-piiriä, jonka ajurin saa valmistajan sivuilta
+  * windows https://www.wch-ic.com/downloads/CH341SER_ZIP.html
+  * mac https://www.wch-ic.com/downloads/CH341SER_MAC_ZIP.html
 ====== Laitteiston testaus - HW_check ======
-  * Asenna käyttämäsi alustan USB-serial-ajuri. Esimerkeksi Wemos D1 mini käyttää CH340-piiriä, jonka ajurin saa valmistajan sivuilta
-    * windows https://www.wch-ic.com/downloads/CH341SER_ZIP.html
-    * mac https://www.wch-ic.com/downloads/CH341SER_MAC_ZIP.html
   * Lataa Mitsurunnerin koodi https://github.com/VeliML/MitsuRunner , paina "CODE" ja sitten "Download ZIP"
   * Pura paketti haluamaasi kansioon
@@ Line 31: / Line 34: @@
 ====== MitsuRunner-ohjelman asennus ======
-  * Lataa Mitsurunner osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
+Lataa Mitsurunner osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
-  * Pura paketti haluamaasi kansioon
+Pura paketti haluamaasi kansioon.
+Editoi ladatusta paketissa olevaa **//mitsu_conf.yaml//** -tiedostoa vastaamaan haluamaasi Mitsurunner-kokoonpanoa (HW-platform ja raportointitapa). Voit tehdä sen joko poistamalla tarpeettomat rivit tai lisäämällä/poistamalla rivin alun kommenttimerkkejä "#".
+Alla esimerkkejä:
+**a) mitsu_conf.yaml for Wemos-Mitsurunner with IoT-Guru**
+   <<: !include platform_wemos.yaml             ## Update file!
+   packages:
+     wifi_base: !include secrets.yaml           ## Update file!
+     dallas_base: !include dallas_hub.yaml
+     mqtt_base: !include mqtt_Guru.yaml         ## Update file!
+     core_base: !include mitsurunner.yaml
+   esphome:
+     includes:
+       - constants.h
+       - state.h
+**b) mitsu_conf.yaml for Sonoff_Elite-Mitsurunner with  HomeAssistant**
+   <<: !include platform_elite.yaml             ## Update file!
+   packages:
+     wifi_base: !include secrets.yaml           ## Update file!
+     dallas_base: !include dallas_hub.yaml
+     mqtt_base: !include mqtt_disabled.yaml
+     core_base: !include mitsurunner.yaml
+   esphome:
+     includes:
+       - constants.h
+       - state.h
+**c) mitsu_conf.yaml for Wemos-Mitsurunner without WiFi-connention**
+   <<: !include platform_wemos.yaml             		## Update file!
+   packages:
+     wifi_base: !include secrets_sa.yaml        		## Update file!
+     dallas_base: !include dallas_hub_status_Led.yaml     ## On-boad LED blinks regularly when the device is working properly.
+     mqtt_base: !include mqtt_disabled.yaml
+     core_base: !include mitsurunner.yaml
+   esphome:
+     includes:
+       - constants.h
+       - state.h
+**Päivittä parametrit käyttämiisi tiedostihin**
+Tarkempia ohjeita parametrien päivitykseen on kussakin päivitettävässä tiedostossa.
+**1.platform_wemos.yaml / platform_elite.yaml**
+   *DS18B20-antureiden IDt
+   *käytetyt GPIO-nastat (DS18B20 1-wire ja releohjaus)
+   *HomeAssistant_API käytettäessä ota käyttöön HomeAssistant api. (jos käytät HA:ta MQTT:n kautta konfiguroi vain MQTT, ei HA_APIa)
+   *lisäämällä kommenttimerkki "#" rivin  //"level: INFO"// alkuun tarkempaa trace-data, saattaa olla avuksi Mitsurunnerin asennusvaiheessa
+**2.secrets.yaml / screts_sa.yaml**
+   *WiFi-SSID ja password
+   *manual_ip osoite (jos poistat manual_ip määritysrivit käytetään dynaamista IP-osoitetta)
+**3.mqtt_Guru.yaml / mqtt_local.yaml**
+   *username, client_id, password
+   *prefix
+**4. constants.h**
+ tiedosto määrittelee Mitsurunnerin toimintaparametreja (ajastimia, lämpötila-rajoja). Yleensä oletusarvot toimivat hyvin, mutta tarvittaessa niitä voi myös muuttaa.
+====Ohjelman kääntäminen, lataaminen ja testaaminen ESPTool-työkalulla====
+  * Kytke Mitsurunner USB-johdolla, käännä ja asenna Mitsurunner koodi laitteesesi komennolla <code>esphome run mitsu_conf.yaml</code>. Ohjelman käynnistyttyä trace-log tulostuu näytölle.
+Toiminnan tarkistaminen:
+  *  Tarkista trace-logista
+    * Mitsurunner on kytkeytynyt kotiverkkoosi
+    * DS18B20-lämpötila-antureiden lämpötilat ovat oikein
+    * Mitsurunner on kytkeytynyt MQTT-serveriin (jos MQTT on käytössä)
+    * Määrittelemäsi tiedot päivittyvät MQTT-serverille
+  * Jos käytät IoT-Gurua ilman USB-yhteyttä trace-log ei tulostu näytölle. Voit kuitenkin nähdä login menemällä selaimella Mitsurunnerin IP-osoitteeseen.
+====Ohjelman kääntäminen, lataaminen ja testaaminen HomeAssistant ESPHome_Builder-työkalulla===
+Mitsurunner ohjelmiston voi kääntää ja ladata myös //HomeAssistant ESPHome_Builder//-työkalulla
+Tähän on useita tapoja, alla on kuvattu yksi suoraviivainen tapa. Tällä tavalla tehdyn Mitsurunner-ohjelman voi ladata OTA:na ESPTool:lla tehdyn version päälle ilman USB-latausta.
+) Tee **HomeAssistant/esphome** hakemistoon uusi hakemisto **mitsu**
+) Kopio **mitsu_conf.yaml** hakemistossa määritellyt tiedostot **HomeAssistant/esphome/mitsu** hakemistoon
+) Editoi **mitsu_conf.yaml** tiedostoa määrittelemällä hakemisto missä tiedostot sijaitsevat.
+   <<: !include mitsu/platform_wemos.yaml
+   packages:
+     wifi_base: !include mitsu/secrets.yaml
+     dallas_base: !include mitsu/dallas_hub.yaml
+     mqtt_base: !include mitsu/mqtt_disabled.yaml
+     core_base: !include mitsu/mitsurunner.yaml
+   esphome:
+     includes:
+       - mitsu/constants.h
+       - mitsu/state.h
+) Lisää editoimasi **mitsu_conf.yaml** tiedosto **HomeAssitant/esphome** hakemistoon.
+) Avaa //HomeAssistant ESPHome Builder//, siellä näkyy nyt "Device" nimellä **mitsu_conf**
+Valitse **edit**, näet "mitsu_conf.yaml" tiedoston sisällön, ensimmäisellä kerralla lataus tehdään USB:n kautta seuraavasti:
-  * Valinnainen: Muokkaa **mitsurunner.yaml-tiedostoon** kumpaa Dallas-tiedostoa käytät
+) Käännä koodi valitsemalla yläkulmasta **install**  -->  **Manual download**   -->  avautuu ikkuna jossa näet käännöksen etenemisen.
-    * //dallas_hub.yaml// käyttäminen vähentää Mitsurunnerin resetejä mutta ei salli ylimääräisiä Dallas-antureita
+Jos/kun käännös menee virheittä talleta muodostunut **mitsurunner.bin** tiedosto ja sulje ikkuna
-    #  packages:
+) Valitse //ESPHome/Device// sivulla **Mitsurunner/Edit**
-       #device_base: !include dallas_basic.yaml # basic-configuration
+    * valitse uudestaan oikeasta yläkulmasta **install**
-       device_base: !include dallas_hub.yaml # separate Dallas-hubs for minimize resets
+    * valitse **Plug into this computer**
+    * valitse **Open ESPHome Web**
+    * valitse **Connect**
+    * valitse **USB-portti**
+    * valitse **Muodosta yhteys**
+    * valitse **Install**
+    * valitse aiemmin tallettamasi **mitsurunner.bin** tiedosto
+    * valitse **Install**
-  * Muokkaa **secrets.yaml-tiedostoa**
+Mitsurunner ohjelmisto on nyt ladattu ja Mitsurunneri pitäisi toimia. ESPHome/Device** Mitsurunner/logs** valinnalla näet Mitsurunnerin lähettämät trace_log tiedot.
-    * Määrittele wifi-verkkosi parametrit **ssid** ja **password**
-    * Määrittele Manual_ip-asetukset:
-      * **static_ip**: (ip-osoite, jolla laite kytkeytyy kotiverkkoon)
-      * **gateway**: (ip-osoite jolla kotiverkkosi kytkeytyy kotiverkon ulkoverkkoon)
-        * näet kotiverkkosi käyttämän Gateway-ip:n Windows-komentokehotteella "ipconfig"
-     * Määrittele haluamasi **OTA-password**
-     * Valinnainen: Ota käyttöön web-serveri poistamalla #-merkit rivien alusta (rivit web_server: ja port: 80)
-     * Valinnainen: Määrittele MQTT-server-yhteys jos käytät **IoT-Gurua**, katso ohje https://mitsurunner.com/doku.php?id=fi:iot_guru
-  * Muokkaa **platform_wemos.yaml-tiedostoa**:
+Seuraavat lataukset voit tehdä OTA-yhteydellä
-    * Määrittele DS18B20-antureiden ID:t, ne jotka kirjasit ylös hw_check-ohjelmasta
+ESPHome/Device **Mitsurunner"/Edit**  **install** ==> **Wirelessly**
-    * Tarkista ja tarvittaessa muuta lämpöantureiden ja rele-ohjauksen PIN-määrittelyt vastaamaan kytkentääsi
-    * Valinnainen: Määrittele MQTT-topicit jos käytät **IoT-Gurua**, katso ohje https://mitsurunner.com/doku.php?id=fi:iot_guru
-  * Ohjelman kääntäminen ja lataaminen:
-    * Voit päivittää tai asentaa uuden version joko USB-johdon tai wifin yli
-    * Jos Mitsurunner on kytketty USB-johdolla: käännä ja asenna Mitsurunner koodi laitteesesi komennolla <code>esphome run mitsurunner.yaml</code>. Ohjelman käynnistyttyä trace-log tulostuu näytölle.
-    * Jos käytät wifi- eli OTA-yhteyttä ja IoT-Gurua ei trace-log tulostu näytölle. Voit kuitenkin nähdä login menemällä selaimella Mitsurunnerin IP-osoitteeseen. Turhien ESPHome-virheilmoitusten välttämiseksi ohjelma kannatta kääntää komennolla.
-      <code>esphome run --no-logs mitsurunner.yaml</code>
-  * Toiminnan tarkistaminen:
-    *  Tarkista trace-logista (joko ESPHome-näytöltä tai Web-selaimelta) että
-      * Mitsurunner on kytkeytynyt kotiverkkoosi
-      * Mitsurunner on kytkeytynyt MQTT-serveriin
-      * DS18B20-lämpötila-antureiden lämpötilat ovat oikein
-    * Tarkista että määrittelemäsi topicit päivittyvät IoT-Guruun
-NOTE1: Voit testata mitsurunnerin toimintaa ilman IoT-Gurua ja saat trace-login näkyviin OTA-yhteydellä editoimalla **secrets.yaml-tiedostoa**
-    * poista IoT-Guru MQTT-serveri käytöstä lisäämällä #-merkit IoT-Guru MQTT -määritysrivien alkuun
-    * ota käyttöön test.mosquitto.org-MQTT-serveri poistamalla #-merkit testserverin määritysrivien alusta
-NOTE2: Latauksen jälkeen Wemos D1 Mini saattaa joskus jäädä "boot-loop" -tilaan jossa ohjelma ei käynnisty ja trace-logiin tuleen jatkuvasti virheilmoituksia. Kokeile poistaa työhakemistosta .esphome- ja .gitignore-tiedostot ja tämän jälkeen aja jälleen <code>esphome run --no-logs mitsurunner.yaml</code>