Differences

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

--- fi:instructions_sw [2024/08/02 18:59] – 84.248.96.53
+++ fi:instructions_sw [2025/11/27 19:16] (current) – FEDCBA 84.248.101.39
@@ Line 1: / Line 1: @@
- ====== ESPHome-asennusohje (Windows) ======
+ftermit:
+Windowsin komentokehoite = macilla "terminal"
-NOTE: Mitsurunner versiot alkaen versiosta "Compatibility with ESPHome 2024.6.6 and later" ovat yhteensopiva uusien ESPHome versioiden kanssa mutta eivät käänny vanhemmilla ESPHome versioilla. Uusimman ESPHome version saat asennettua Windows komentokehotteella "pip3 install esphome -U".
+====== Asenna ESPHome ======
+  * ESPHome käyttää Python'ia, joten ensin tarvittaessa lataa ja asenna osoitteesta https://python.org/
+  * "komentokehote" ja asenna ESPHome antamalla komento: <code>pip3 install esphome</code>
+  * ESPhome asentuu, asennuksessa mahdollisesti tulevista WARNINGeista ei tarvitse välittää.
+  * Nyt kehitysympäristö on koneellasi ja voit sulkea "komentokehotteen".
-Asenna ESPHome-kehitysympäristö Windows-koneelle
+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>
+Ohje ESPhomen asennukseen: https://esphome.io/guides/installing_esphome.html
-  * ESPHome käyttää Python'ia, joten lataa ja asenna tarvittaessa osoitteesta https://python.org/
-  * Avaa Windowsin "komentokehote" ja asenna ESPHome antamalla komento: pip3 install esphome
 Lisäohjeita täältä: https://www.esphome.io/guides/getting_started_hassio.html
-=> ESPhome asentuu (asennuksessa mahdollisesti tulevista WARNINGeista ei tarvitse välittää)
+====== USB-serial-ajurin asennus ======
-Nyt kehitysympäristö on koneellasi ja voit sulkea "komentokehotteen".
+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 ======
+  * Lataa Mitsurunnerin koodi https://github.com/VeliML/MitsuRunner , paina "CODE" ja sitten "Download ZIP"
+  * Pura paketti haluamaasi kansioon
+  * Muokkaa tiedostoa hw_check.yaml esim. Muistio- tai Textedit-ohjelmalla, vaihda "dallas_pin" ja "relay_pin" vastaamaan käyttämiäsi GPIO-pinnejä
+  * Kytke kokoamasi laite USB-johdolla tietokoneeseesi
+  * Avaa komentokehote. Siirry kansioon komennolla "cd kansion polku" esim. "cd /home/users/velho/mitsurunner"). Anna komento "esphome hw_check.yaml run"
+  * Jos käännös menee OK ja Wemos on kytketty USB-porttiin ohjelma latautuu ja käynnistyy
+  * Rele naksuu (0,5s ON 5s välein)
+  * Tietokoneen ruudulle tulostuu logi josta näkyy DS18B20-lämpötila-antureiden ID-tunnukset. Kopioi id:t talteen, tarvitset niitä myöhemmin.
+====== MitsuRunner-ohjelman asennus ======
+Lataa Mitsurunner osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
+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.
-====== ESPHome asennusohje (Linux) ======
+**1.platform_wemos.yaml / platform_elite.yaml**
-Linux-käyttäjänä osaat varmasti hakea itse ohjeet internetistä ;) \\
+   *DS18B20-antureiden IDt
-Ohje ESPhomen asennukseen: https://esphome.io/guides/installing_esphome.html#linux
+   *käytetyt GPIO-nastat (DS18B20 1-wire ja releohjaus)
-Katso muut ohjeet yltä.
+   *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.
- ====== Mitsurunner/Wemos laitteiston testaus ======
+====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.
-  * Hae Mitsurunner ohjelma osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
+Toiminnan tarkistaminen:
-    * => Pakattu Mitsurunner-paketti latautuu koneellesi
+  *  Tarkista trace-logista
-  * Pura paketti haluamaasi työhakemistoon
+    * Mitsurunner on kytkeytynyt kotiverkkoosi
-  * Tiedostossa hw_check.yaml editoi "dallas_pin" ja "relay_pin" vastaamaan käyttämiäsi GPIO_pinnejä
+    * DS18B20-lämpötila-antureiden lämpötilat ovat oikein
-  * Kytke kokoamasi laite USB-liitännällä Windows-koneeseesi
+    * Mitsurunner on kytkeytynyt MQTT-serveriin (jos MQTT on käytössä)
-  * Avaa Windows-komentokehote, siirry työhakemistoon (komento "cd" ja kansion polku). Anna komento "esphome hw_check.yaml run"
+    * Määrittelemäsi tiedot päivittyvät MQTT-serverille
-Jos käännös menee OK ja Wemos on kytketty USB-porttiin ohjelma latautuu ja käynnistyy
-  * Rele naksuu (0.5 sek ON 5 sek välein)
+  * 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.
-  * Tietokoneen ruudulle tulostuu logi josta näkyy DS18B20 lämpötila-antureiden ID-tunnukset
-  * Editoi logissa näkyvät DS18B20 antureiden ID:t hw_check.yaml tiedostoon kohtiin dallas_a ja dallas_b
-  * Käännä ja lataa hw_check uudelleen
-  * Nyt logissa pitäisi näkyä myös DS18B20 antureiden lämpötilat
-----
+====Ohjelman kääntäminen, lataaminen ja testaaminen HomeAssistant ESPHome_Builder-työkalulla===
-====== MitsuRunner-ohjelmiston asennusohje Wemos D1 Mini laitteeseen======
+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.
-NOTE: Mitsurunner versiot alkaen versiosta "Compatibility with ESPHome 2024.6.6 and later" ovat yhteensopiva uusien ESPHome versioiden kanssa mutta eivät käänny vanhemmilla ESPHome versioilla. Uusimman ESPHome version saat asennettua Windows komentokehotteella "pip3 install esphome -U".
+) Tee **HomeAssistant/esphome** hakemistoon uusi hakemisto **mitsu**
-  * Hae Mitsurunner ohjelma osoitteesta https://github.com/VeliML/MitsuRunner , valitse siltä "CODE" valinnan alta "Download ZIP"
+) Kopio **mitsu_conf.yaml** hakemistossa määritellyt tiedostot **HomeAssistant/esphome/mitsu** hakemistoon
-    * => Pakattu Mitsurunner-paketti latautuu koneellesi
-  * Pura paketti haluamaasi työhakemistoon
+) Editoi **mitsu_conf.yaml** tiedostoa määrittelemällä hakemisto missä tiedostot sijaitsevat.
-  * Editoi **mitsurunner.yaml** tiedostoa valitsemalla kumpaa Dallas-tiedostoa käytät
-      * //dallas_hub.yaml// käyttäminen vähentää mitsurunner resetejä mutta ei salli ylimääräisiä Dallas-antureita
+   <<: !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
-    #  packages:
+) Lisää editoimasi **mitsu_conf.yaml** tiedosto **HomeAssitant/esphome** hakemistoon.
-       #device_base: !include dallas_basic.yaml # basic-configuration
-       device_base: !include dallas_hub.yaml # separate Dallas-hubs for minimize resets
-  * Editoi **secrets.yaml**-tiedostoa
+) Avaa //HomeAssistant ESPHome Builder//, siellä näkyy nyt "Device" nimellä **mitsu_conf**
-    * Määrittele wifi-verkkosi parametrit "ssid" ja "password"
+Valitse **edit**, näet "mitsu_conf.yaml" tiedoston sisällön, ensimmäisellä kerralla lataus tehdään USB:n kautta seuraavasti:
-    * 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
-     * Ota käyttöön web-serveri poistamalla #-merkit rivien alusta (rivit web_server: ja port: 80)
-     * Määrittele MQTT-server yhteys, jos käytät **IoT-Guru**a katso ohjeet https://mitsurunner.com/doku.php?id=fi:iot_guru
-   *
-  * Editoi **platform_wemos.yaml**-tiedostoa:
-    * Määrittele DS18B20-antureiden ID:t (jotka kirjasit ylös hw_check-ohjelmaa käyttäessäsi)
-    * Tarkista ja tarvittaessa muuta lämpöantureiden ja rele-ohjauksen PIN-määrittelyt vastaamaan kytkentääsi
-    * Määrittele MQTT-topicit, jos käytät **IoT-Guru**a katso ohjeet https://mitsurunner.com/doku.php?id=fi:iot_guru
-  * Ohjelman kääntäminen ja lataaminen:
+) Käännä koodi valitsemalla yläkulmasta **install**  -->  **Manual download**   -->  avautuu ikkuna jossa näet käännöksen etenemisen.
-    * Jos Mitsurunner on kytketty USB_kaapelilla käännä ja asenna Mitsurunner koodi laitteesesi komennolla "esphome run mitsurunner.yaml". Ohjelman käynnistyttyä trace-log tulostuu USB-yhteyden kautta näytölle
+Jos/kun käännös menee virheittä talleta muodostunut **mitsurunner.bin** tiedosto ja sulje ikkuna
-    * Jos käytät OTA-yhteyttä ja IoT-Gurua trace-log ei tulostu näytölle. Voit kuitenkin nähdä login menemällä selaimella mitsurunnerin IP-osoitteeseen. Turhien ESPHome-poikkeamailmoitusten välttämiseksi ohjelma kannatta kääntää komennolla.
-      esphome run --no-logs mitsurunner.yaml
+) 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.
-  * Toiminnan todentamien:
+Seuraavat lataukset voit tehdä OTA-yhteydellä
-    *  Tarkista trace-logista (joko ESPHome-näytöltä tai Web-selaimelta)
+ESPHome/Device **Mitsurunner"/Edit**  **install** ==> **Wirelessly**
-      * 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 korjata tilanne poistamalla työhakemistosta .esphome- ja .gitignore-tiedostot ja tämän jälkeen kääntämällä ja lataamalla mitsurunner.yaml uudestaan