ecodan-ha-local

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.

Controls implemented

• Manage Zone 1 climate. Temperature set point. Actual temperature.
• Heat pump mode selector. You can select the working mode (heat and cool): Space room temperature, Flow temperature or Compensation curve.
• Manage water boiler. Configure temperature set point and its modes (eco or normal).
• Control to boost DHW.
• Control to turn ON and turn OFF ecodan.
• Control to set point zone flow temperature target.

Sensors information retreived

• Defrost mode
• Compressor frequency
• Pump flow rate
• Boost DHW mode
• Output power
• Legionella prevention temperature setting
• Zone 1 room temperature
• Zone 1 flow temperature target
• Zone 2 room temperature
• Zone 2 flow temperature target
• Dhw current temperature
• Dhw temperature target
• Dhw temperature drop
• Outside temperature
• Heat pump feed temperature
• Heat pump return temperature
• Boiler flow temperature
• Boiler return temperature
• Power mode
• Operation mode
• DHW mode
• Heating/Cooling working mode
• Heating consumed energy
• Heating delivered energy
• DHW consumed energy
• DHW delivered energy
• COP of space heating
• COP of DHW

Diagnostic sensors retreived

• Heat pump connection state
• Wifi RSSI
• Wifi SSID
• IP address
• MAC address

Hardware Dependencies

• ESP32-compatible development board (I'm using a LOLIN S2 Mini)
  • Will almost certainly exceed the memory budgets on an ESP8266, as I've not been super careful about memory usage.
• CN105 female connector + pigtails, as described here.
  • Note: The software is configured to use Serial UART1 on the ESP32, explicitly labelled TX/RX pins on a pinout will usually be pre-assigned to UART0.

ESP32 Boards tested

• LOLIN S2 Mini
• WROOM-32

Library Dependencies

The esp32 board package from the Arduino IDE "Boards Manager":

• esp32 v3.0.2

Should be installed via the Arduino IDE "Library Manager":

• ArduinoJson v7.0.3
• Seeed_Arduino_mbedtls v3.0.1
• MQTT v2.5.2

First Time Setup

• Clone this repository and build with the Arduino IDE
• Flash the image to the ESP32 board
• Take the board out of firmware update mode, and it should broadcast a wireless network called ecodan_ha_local, connect to this network
• Configure the device to match your setup (see Software Configuration)

Deploying Updates

After initial flashing + configuration is completed, it's possible to update the firmware over your WiFi network by:

• Building the firmware binary with: Sketch > Export Compiled Binary
• Visit the configuration page for your device, by default this will be: http://ecodan-ha-local/configuration
• Scroll down to the Firmware Update section at the bottom of the configuration page
• Select the firmware binary which should be inside a folder such as build\esp32.esp32.esp32s2\ecodan-ha-local.ino.bin under Sketch > Show Sketch Folder
• Hit the "Update" button, the firmware update should proceed, and load back to the home page when completed

Software Configuration

Device Password

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

Serial Rx Port

The GPIO pin number which should be used for Serial data receive.

Default	Required
27	Yes

Serial Tx Port

The GPIO pin number which should be used for Serial data transmit.

Default	Required
26	Yes

Status LED Port

The GPIO pin number which should be used for the status LED. The following flashing patterns are possible:

• 2 short flashes, followed by one long flash: Serial connection to the Heat Pump has not been established.
• Steady long flashes: Network connection to the MQTT server has not been established
• Constantly lit: Status is OK

Default	Required
LED_BUILTIN	No

Heat Pump Configuration

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

Device Unique Identifier

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 Serial Packets

Dump packets sent to/received from the heat pump to the diagnostic log window on the Diagnostics page.

Default	Required
Off	No

WiFi SSID

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

WiFi Password

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

Auto-Reset WiFi Settings

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

Hostname

The network hostname the device will use to identify itself.

Default	Required
ecodan_ha_local	No

MQTT Server

The IP address or hostname of the MQTT server on your local network.

Default	Required
""	No

MQTT Port

The port on which your MQTT server is listening.

Default	Required
1883	No

MQTT User

The username which should be used when connecting to the specified MQTT Server.

Default	Required
""	No

MQTT Password

The password for the given MQTT User.

Default	Required
""	No

MQTT Topic

The topic value which the server should use to filter messages related to this heat pump.

Default	Required
ecodan_hp	Yes

See Also

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:

• https://github.com/m000c400/Mitsubishi-CN105-Protocol-Decode
• https://github.com/BartGijsbers/CN105Gateway
• https://github.com/gysmo38/mitsubishi2MQTT