Table of Contents
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:
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
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
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
esphome run mitsurunner.yaml
. 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
esphome run --no-logs mitsurunner.yaml
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
esphome run --no-logs mitsurunner.yaml