MitsuRunner

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

termit:
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>

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

Lisäohjeita täältä: https://www.esphome.io/guides/getting_started_hassio.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
  * 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

* Valinnainen: Muokkaa **mitsurunner.yaml-tiedostoon** kumpaa Dallas-tiedostoa käytät
    * //dallas_hub.yaml// käyttäminen vähentää Mitsurunnerin resetejä mutta ei salli ylimääräisiä Dallas-antureita

#  packages:
       #device_base: !include dallas_basic.yaml # basic-configuration
       device_base: !include dallas_hub.yaml # separate Dallas-hubs for minimize resets

* Muokkaa **secrets.yaml-tiedostoa**
    * 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**:
    * Määrittele DS18B20-antureiden ID:t, ne jotka kirjasit ylös hw_check-ohjelmasta
    * 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>

Kirijoitahan aakkoset vallan takaperoisesti ähvästä aahan isoilla kirijaimilla (kuusi kirijainta): Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: Public Domain