• ESPHome käyttää Python'ia, joten ensin tarvittaessa lataa ja asenna osoitteesta https://python.org/
• “komentokehote” ja asenna ESPHome antamalla komento:

  pip3 install esphome

• 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

pip3 install esphome -U

Ohje ESPhomen asennukseen: https://esphome.io/guides/installing_esphome.html

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

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.

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 lisäämällä/poistamalla rivin alun kommenttimerkkejä “#” tai poistamalla tarpeettomat rivit.

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.

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

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

• Kytke Mitsurunner USB-johdolla, käännä ja asenna Mitsurunner koodi laitteesesi komennolla

  esphome run mitsu_conf.yaml

  . Ohjelman käynnistyttyä trace-log tulostuu näytölle.

Toiminnan tarkistaminen:

• Tarkista trace-logista
  • Mitsurunner on kytkeytynyt kotiverkkoosi
  • DS18B20-lämpötila-antureiden lämpötilat ovat oikein
  • Mitsurunner on kytkeytynyt MQTT-serveriin (jos MQTT on käytössä)
  • 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.

Mitsurunner ohjelmiston voi kääntää ja ladata myös HomeAssistant ESPHome_Builder-työkalulla Tähän on useita tapoja, alla kuvattu yksi suuoraviivainen tapa.Tällä tavalla tehdyn Mitsurunner-ohjelman voi ladata OTA:na ESPTool:lla tehdyn version päälle ilman USB-latausta.

1) Tee HomeAssistant/esphome hakemistoon uusi hakemisto mitsu

2) Kopio mitsu_conf.yaml hakemistossa määritellyt tiedostot HomeAssistant/esphome/mitsu hakemistoon

3) Editoi mitsu_conf.yaml tiedostoa määrittelemällä hakemisto missä tiedostot sijaitsevat.

 <<: !include mitsu/platform_wemos.yaml
 packages:
   wifi_base: !include mitsu/secrets.yaml                   ## WifI needed
   dallas_base: !include mitsu/dallas_hub.yaml              ## 
   mqtt_base: !include mitsu/mqtt_disabled.yaml                  ## NOTE! This must be included if MQTT is not used 
   core_base: !include mitsu/mitsurunner.yaml                     ## MUST be included
 esphome:  
   includes:
     - mitsu/constants.h
     - mitsu/state.h
  

4) Lisää editoimasi mitsu_conf.yaml tiedosto HomeAssitant/esphome hakemistoon.

5) Avaa HomeAssistant ESPHome Builder, siellä näkyy nyt “Device” nimellä mitsu_conf Valitse edit, näet “mitsu_conf.yaml” tiedoston sisällön, ensimmäisellä kerralla lataus tehdään USB:n kautta seuraavasti:

6) Käännä koodi valitsemalla yläkulmasta install –> Manual download –> avautuu ikkuna jossa näet käänöksen etenemisen Jos/kun käännös menee virheittä talleta muodostunut mitsurunner.bin tiedosto ja sulje ikkuna

7) 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ä trace_log tiedot

Seuraavat lataukset voit tehdä OTA-yhteydellä ESPHome/Device Mitsurunner“/Edit install =⇒ Wirelessly