Differences

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

--- fi:instructions_sw [2024/08/02 16:58] – 84.248.96.53
+++ fi:instructions_sw [2025/03/09 15:34] (current) – 84.248.112.152
@@ Line 1: / Line 1: @@
-<abh ====== 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
-Jos käytät Wemos-platformia:
+**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/tree/separate_dallas_config/hw_check
+**1.platform_wemos.yaml / platform_elite.yaml**
+   *DS18B20-antureiden IDt
+   *käytetyt GPIO-nastat (DS18B20 1-wire ja releohjaus)
+   *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
-  * 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 , 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