MitsuRunner

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

====== Software installation manual ======

The MitsuRunner source code can be downloaded here: https://github.com/VeliML/MitsuRunner/

====== ESPHome Installation Guide (Windows) ======
Install ESPHome Development Environment on a Windows Machine
  * ESPHome uses Python, so download and install if necessary from https://python.org/
  * Open the Windows "Command Prompt" and install ESPHome by entering the command: pip3 install esphome
Additional instructions can be found here: https://www.esphome.io/guides/getting_started_hassio.html

⇒ ESPHome will be installed (you can ignore any WARNINGs that may occur during installation). Now the development environment is on your machine, and you can close the "Command Prompt."

Test your assembled device with the "hw_check" program: https://github.com/VeliML/MitsuRunner/blob/main/hw_check/hw_check.yaml

* Save the "hw_check.yaml" file to your desired directory (e.g., Runner)
  * Edit the file with your home network's WiFi parameters and OTI password
  * Ensure that the pin configurations for temperature sensors and relay control match your wiring

* Connect your assembled device to your Windows machine via USB
  * Open the Windows Command Prompt, navigate to the "Runner" directory (using the "cd" command and the directory path). Enter the command "esphome hw_check.yaml run"
If the compilation is successful, the program will ask for the upload method (USB or OTI). Choose USB. ⇒ the code will be uploaded to the device via USB.

!! If the upload fails, make sure that the USB driver for WeMos_D1 is installed on your Windows machine.

After installing HW_check, check:

* The relay clicks (0.5 sec ON every 5 sec)
  * The computer screen displays a log showing:
    * The device is connected to your home network
    * DS18B20 temperature sensor IDs - make a note of these, you will need them later - and the measured temperatures
  * Also, test the OTI update by entering "esphome mitsurunner.yaml run" again, but this time select OTI as the upload method.

----

====== ESPHome Installation Guide (Linux) ======
As a Linux user, you probably know how to find the instructions yourself on the internet ;)

Instructions for installing ESPHome: https://esphome.io/guides/installing_esphome.html#linux
Check the other instructions above.

----

====== MitsuRunner Software Installation Guide ======
Download Mitsurunner from https://github.com/VeliML/MitsuRunner , select “Download ZIP” under “CODE” Extract the package to a folder of your choice.

Edit //mitsu_conf.yaml// to match your Mitsurunner configuration (HW platform and reporting method). You can do this either by deleting unnecessary lines or by adding/removing comment characters “#” at the beginning of the line.

Some examples:

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

**Update the parameters to the files you are using**
Detailed instructions for updating the parameters in each file.

**1.platform_wemos.yaml / platform_elite.yaml**
   *DS18B20 sensor IDs
   *Used GPIO pins (DS18B20 1-wire and relay control)
   *When using HomeAssistant, enable the HomeAssistant api
   *Add a comment “#” to the beginning of the “level: INFO” line for more detailed trace data, this may be helpful during the Mitsurunner installation process

**2.secrets.yaml / screts_sa.yaml**
   *WiFi-SSID and password
   *manual_ip address (if you remove all manual_ip configuration lines, a dynamic IP address is used)

**3.mqtt_Guru.yaml / mqtt_local.yaml**
   *username, client_id, password
   *prefix

**4. constants.h**

file defines the operating parameters of Mitsurunner (timers, temperature limits). Usually the default values work well, but you can also modify those if necessary.

===========================================

==== Compiling, downloading and testing the program with ESPTool ====
  * Connect Mitsurunner with a USB cable, compile code and install binar to the device with the command <code>esphome run mitsu_conf.yaml</code>
program starts, trace-log is printed on the screen. From trace-log check:

* Mitsurunner is connected to your home network
     * The temperatures of the DS18B20 sensors are correct
     * Mitsurunner is connected to the MQTT server (if MQTT is enabled)
     * The information you have specified is updated to the MQTT server
  * If you use IoT-Guru without a USB connection, the trace-log will not be printed on the screen. However, you can see the log by going to the Mitsurunner IP address in a browser.

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