Differences

This shows you the differences between two versions of the page.

--- en:instructions_sw [2024/02/20 19:08] – Added English Translation thingwizard
+++ en:instructions_sw [2025/03/21 13:56] (current) – HomeAssistant ESPHome_Builder added 84.248.112.152
@@ Line 42: / Line 42: @@
 ====== 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.
-  * Download the Mitsurunner program from https://github.com/VeliML/MitsuRunner, select "CODE," and then "Download ZIP"
+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.
-    * ⇒ The packaged Mitsurunner package will downloaded to your machine
-  * Extract the package to your desired directory (e.g., Runner)
-  * Edit the secrets.yaml file
-        * Define your WiFi network parameters "ssid" and "password"
-        * Define Manual_ip settings:
-          * static_ip: (the IP address your device will use to connect to your home network)
-          * gateway: (the IP address through which your home network connects to the outside network)
-          * You can find your home network's Gateway IP in the Windows Command Prompt using "ipconfig"
-        * Define your desired OTA password
-  * Edit the platform.yaml file:
-        * Define the IDs of DS18B20 sensors (which you noted down when using the hw_check program)
-        * Check and, if necessary, modify the pin definitions for temperature sensors and relay control to match your wiring
-  * Compile and install the Mitsurunner code on your device with the command "esphome run mitsurunner.yaml"
-Check: A log will be printed to the Windows screen showing:
+Some examples:
-  * That Mitsurunner is connected to your home network
-  * the temperatures of DS18B20 temperature sensors
+**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.
+====Compiling, uploading and testing the program with the HomeAssistant ESPHome_Builder tool====
+Mitsurunner software can also be compiled and uploaded with //HomeAssistant ESPHome_Builder// tool
+There are several ways to do this, one straightforward way is described below. Mitsurunner program created in this way can be uploaded as OTA over the version created with ESPTool without USB upload.
+) Create a new directory **mitsu** in the **HomeAssistant/esphome** directory
+) Copy the files defined in **mitsu_conf.yaml** directory to the **HomeAssistant/esphome/mitsu** directory
+) Edit **mitsu_conf.yaml** file by specifying the directory where the files are located.
+     <<: !include mitsu/platform_wemos.yaml
+     packages:
+     wifi_base: !include mitsu/secrets.yaml
+     dallas_base: !include mitsu/dallas_hub.yaml
+     mqtt_base: !include mitsu/mqtt_disabled.yaml
+     core_base: !include mitsu/mitsurunner.yaml
+     esphome:
+     includes:
+     - mitsu/constants.h
+     - mitsu/state.h
+) Add the **mitsu_conf.yaml** file you edited to the **HomeAssistant/esphome** directory.
+) Open //HomeAssistant ESPHome Builder//, there you will now see "Device" as **mitsu_conf**
+Select **edit**, you will see the contents of the "mitsu_conf.yaml" file, the first time the download is done via USB as follows:
+) Compile the code by selecting **install** --> **Manual download** --> a window will open where you can see the progress of the compilation.
+If/when the translation goes without errors, save the generated **mitsurunner.bin** file and close the window
+) Select //ESPHome/Device// on the **Mitsurunner/Edit**
+    * select **install** again in the upper right corner
+    * select **Plug into this computer**
+    * select **Open ESPHome Web**
+    * select **Connect**
+    * select **USB port**
+    * select **Establish connection**
+    * select **Install**
+    * select the previously saved **mitsurunner.bin** file
+    * select **Install**
+Mitsurunner software is now downloaded and Mitsurunner should work. By selecting ESPHome/Device** Mitsurunner/logs** you can see the trace_log data sent by Mitsurunner.
+You can do the following downloads via OTA connection
+ESPHome/Device **Mitsurunner"/Edit** **install** ==> **Wirelessly**