Page locked

This page is currently locked for editing by another user. You have to wait until this user finishes editing or the lock expires.
Currently locked by: 216.73.216.113
Lock expires at: 2025/06/23 13:37 (10 min)
This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
termit:
Windowsin komentokehoite = macilla "terminal"

====== 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

Lisäohjeita täältä: https://www.esphome.io/guides/getting_started_hassio.html

====== USB-serial-ajurin asennus ======
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

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:
  * Kun olet jo ajanut hw_checkin niin 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>