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

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.

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.

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.

• Connect Mitsurunner with a USB cable, compile code and install binar to the device with the command

  esphome run mitsu_conf.yaml

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.