Differences

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

--- fi:instructions_sw [2025/01/12 10:19] – siistimistä 2a0e:4005:1002:ffff:185:40:4:29
+++ fi:instructions_sw [2025/03/09 15:34] (current) – 84.248.112.152
@@ Line 1: / Line 1: @@
-termit:
+ftermit:
 Windowsin komentokehoite = macilla "terminal"
@@ Line 35: / Line 35: @@
 ====== MitsuRunner-ohjelman asennus ======
 Lataa Mitsurunner osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
-Pura paketti haluamaasi kansioon
+Pura paketti haluamaasi kansioon.
-Valinnainen: Muokkaa **mitsurunner.yaml-tiedostoon** kumpaa Dallas-tiedostoa käytät
+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ä "#".
-  * //dallas_hub.yaml// käyttäminen vähentää Mitsurunnerin resetejä mutta ei salli ylimääräisiä Dallas-antureita
-  #  packages:
+Alla esimerkkejä:
-    #device_base: !include dallas_basic.yaml # basic-configuration
-    device_base: !include dallas_hub.yaml # separate Dallas-hubs for minimize resets
-Muokkaa **secrets.yaml-tiedostoa**
+**a) mitsu_conf.yaml for Wemos-Mitsurunner with IoT-Guru**
-  * Määrittele wifi-verkkosi parametrit **ssid** ja **password**
+   <<: !include platform_wemos.yaml             ## Update file!
-  * Määrittele Manual_ip-asetukset:
+   packages:
-    * **static_ip**: (ip-osoite, jolla laite kytkeytyy kotiverkkoon)
+     wifi_base: !include secrets.yaml           ## Update file!
-    * **gateway**: (ip-osoite jolla kotiverkkosi kytkeytyy kotiverkon ulkoverkkoon)
+     dallas_base: !include dallas_hub.yaml
-      * näet kotiverkkosi käyttämän Gateway-ip:n Windows-komentokehotteella "ipconfig"
+     mqtt_base: !include mqtt_Guru.yaml         ## Update file!
-   * Määrittele haluamasi **OTA-password**
+     core_base: !include mitsurunner.yaml
-   * Valinnainen: Ota käyttöön web-serveri poistamalla #-merkit rivien alusta (rivit web_server: ja port: 80)
+   esphome:
-   * Valinnainen: Määrittele MQTT-server-yhteys jos käytät **IoT-Gurua**, katso ohje https://mitsurunner.com/doku.php?id=fi:iot_guru
+     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
-Muokkaa **platform_wemos.yaml-tiedostoa**:
+**Päivittä parametrit käyttämiisi tiedostihin**
-  * Määrittele DS18B20-antureiden ID:t, ne jotka kirjasit ylös hw_check-ohjelmasta
+Tarkempia ohjeita parametrien päivitykseen on kussakin päivitettävässä tiedostossa.
-  * 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:
+**1.platform_wemos.yaml / platform_elite.yaml**
-  * Kun olet jo ajanut hw_checkin niin voit päivittää tai asentaa uuden version joko USB-johdon tai wifin yli
+   *DS18B20-antureiden IDt
-  * 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.
+   *käytetyt GPIO-nastat (DS18B20 1-wire ja releohjaus)
-  * 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>
+   *HomeAssistanttia käytettäessä ota käyttöön HomeAssistant api
+   *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 (joko ESPHome-näytöltä tai Web-selaimelta) että
+  *  Tarkista trace-logista
     * 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
+    * 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:
+) Käännä koodi valitsemalla yläkulmasta **install**  -->  **Manual download**   -->  avautuu ikkuna jossa näet käännöksen etenemisen.
+Jos/kun käännös menee virheittä talleta muodostunut **mitsurunner.bin** tiedosto ja sulje ikkuna
+) Valitse //ESPHome/Device// sivulla **Mitsurunner/Edit**
+    * valitse uudestaan oikeasta yläkulmasta **install**
+    * 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**
+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.
+Seuraavat lataukset voit tehdä OTA-yhteydellä
+ESPHome/Device **Mitsurunner"/Edit**  **install** ==> **Wirelessly**
-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>