ESP32 compatible program for local monitoring of Mitsubishi Ecodan Air to Water heat pumps with automatic discovery in HomeAssistant.
Uses the CN105 connector on the Cased Flow Temp Controller (FTC6 in my setup) to do basic control.
Space room temperature
, Flow temperature
or Compensation curve
.
The esp32 board package from the Arduino IDE "Boards Manager":
Should be installed via the Arduino IDE "Library Manager":
ecodan_ha_local
, connect to this networkAfter initial flashing + configuration is completed, it's possible to update the firmware over your WiFi network by:
Sketch > Export Compiled Binary
build\esp32.esp32.esp32s2\ecodan-ha-local.ino.bin
under Sketch > Show Sketch Folder
Setting a device password will cause the web interface to require the password to be specified each time the board is booted, or the client's browser cookies are cleared.
It's strongly recommended to enable this setting in case the device falls back to broadcasting an open access point, as it will retain other configuration values (MQTT passwords, server, Wifi SSID/Password) which may then be readable by anyone.
Default | Required |
---|---|
"" |
No |
The GPIO pin number which should be used for Serial data receive.
Default | Required |
---|---|
27 | Yes |
The GPIO pin number which should be used for Serial data transmit.
Default | Required |
---|---|
26 | Yes |
The GPIO pin number which should be used for the status LED. The following flashing patterns are possible:
Default | Required |
---|---|
LED_BUILTIN | No |
Some parameters of your Mitsubishi Ecodan HVAC | Parameter | Description | Default |
---|---|---|---|
Cool enabled |
Check this option if your ecodan has cool working mode. Enable setting cool mode from Home Assistant | False |
Parameter | Description | Default |
---|---|---|
Unique Id |
Identifier to be used in Home Assistant sensors for this device. It should be unique for each Ecodan HVAC in the network. | False (It uses MAC address by default) |
Changing the default value can be used to replace the ESP device without having to reconfigure the entities in Home Assistant or the software reading the MQTT messages and writing the values in influxdb.
Dump packets sent to/received from the heat pump to the diagnostic log window on the Diagnostics page.
Default | Required |
---|---|
Off | No |
The SSID of the WiFi network which you'd like the device to connect to. When the diagnostics page is loaded, the device will automatically initiate a scan for available WiFi networks and populate the menu when it completes.
Note: If this setting or "WiFi Password" are unset, the device will continue to boot into a captive portal access point.
Default | Required |
---|---|
"" |
Yes |
The passphrase/password which should be used when connecting to the previously specified WiFi SSID.
Note: If this setting or "WiFi SSID" are unset, the device will continue to boot into a captive portal access point.
Default | Required |
---|---|
"" |
Yes |
Some parameters of your Mitsubishi Ecodan HVAC | Description | Default |
---|---|---|
Check this option to fall back to broadcasting a "captive portal" WiFi access point if the network connection is lost for a long time (~20 mins). Intended to avoid the need for physically accessing the ESP32 if (e.g. a router is replaced, and the SSID / password are different). If a device password is set, a device password will be required to connect to the captive port access point. | False |
The network hostname the device will use to identify itself.
Default | Required |
---|---|
ecodan_ha_local |
No |
The IP address or hostname of the MQTT server on your local network.
Default | Required |
---|---|
"" |
No |
The port on which your MQTT server is listening.
Default | Required |
---|---|
1883 | No |
The username which should be used when connecting to the specified MQTT Server.
Default | Required |
---|---|
"" |
No |
The password for the given MQTT User.
Default | Required |
---|---|
"" |
No |
The topic value which the server should use to filter messages related to this heat pump.
Default | Required |
---|---|
ecodan_hp |
Yes |
There are a number of existing solutions for connecting to Mitsubish heat pump models via the CN105 connector, I wouldn't have been able to put this together without work already done here: