Differences

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

--- fi:instructions_sw [2024/04/03 10:07] – 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"
-Asenna ESPHome-kehitysympäristö Windows-koneelle
+====== 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".
+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.
-Testaa kokoamasi laite "hw_check"-ohjelmalla: https://github.com/VeliML/MitsuRunner/blob/main/hw_check/hw_check.yaml
+**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
-  * Talleta "hw_check.yaml"-tiedosto haluamaasi työhakemistoon
+**2.secrets.yaml / screts_sa.yaml**
-  * Muokkaa tiedostoon kotiverkkosi WiFi-parametrit sekä OTI password
+   *WiFi-SSID ja password
-  * Tarkista että lämpöantureiden ja rele-ohjauksen PIN-määritykset vastaavat tekemääsi kytkentää
+   *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
-  * Kytke kokoamasi laite USB-liitännällä Windows-koneeseesi
+**4. constants.h**
-  * Avaa Windows-komentokehote, siirry työhakemistoon (komento "cd" ja kansion polku). Anna komento "esphome hw_check.yaml run"
+ tiedosto määrittelee Mitsurunnerin toimintaparametreja (ajastimia, lämpötila-rajoja). Yleensä oletusarvot toimivat hyvin, mutta tarvittaessa niitä voi myös muuttaa.
-Jos käännös menee OK, ohjelma kysyy lataustapaa (USB vai OTI). Valitse USB.
-=> koodi asennetaan laitteelle USB:n kautta
-!! Jos lataus ei onnistu tarkista että Windows-koneellesi on asennettu USB-ohjain WeMos_D1:lle
+====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.
-HW_check'in asennuksen jälkeen tarkasta:
+Toiminnan tarkistaminen:
-  * Rele naksuu (0.5 sek ON 5 sek välein)
+  *  Tarkista trace-logista
-  * Tietokoneen ruudulle tulostuu logi josta näkyy
+    * Mitsurunner on kytkeytynyt kotiverkkoosi
-  ** Laite on kytkeytynyt kotiverkkoosi
+    * DS18B20-lämpötila-antureiden lämpötilat ovat oikein
-  ** DS18B20 lämpötila-antureiden ID-tunnukset - kirjaa ylös, tarvitset näitä myöhemmin - ja mitatut lämpötilat
+    * Mitsurunner on kytkeytynyt MQTT-serveriin (jos MQTT on käytössä)
-  * Testaa myös OTI-päivitys antamalla "esphome mitsurunner.yaml run" uudelleen, mutta valitse nyt lataustavaksi OTI
+    * 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.
-====== ESPHome asennusohje (Linux) ======
+====Ohjelman kääntäminen, lataaminen ja testaaminen HomeAssistant ESPHome_Builder-työkalulla===
-Linux-käyttäjänä osaat varmasti hakea itse ohjeet internetistä ;) \\
-Ohje ESPhomen asennukseen: https://esphome.io/guides/installing_esphome.html#linux
-Katso muut ohjeet yltä.
-----
+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.
-====== MitsuRunner-ohjelmiston asennusohje Wemos D1 Mini laitteeseen======
+) Tee **HomeAssistant/esphome** hakemistoon uusi hakemisto **mitsu**
-  * Hae Mitsurunner ohjelma osoitteesta https://github.com/VeliML/MitsuRunner/tree/separate_dallas_config , 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