The easiest option is to use a custom pcb by @fonkse
@fonkse created a pcb + wires and it is basically plug and play. This is the recommended hardware setup for proxy.
Select the esp32s3-proxy2.yaml
as configuration in ecodan-esphome.yaml
. Build and flash the firmware.
This guide is written for those with no experience of ESPHome and assumes only a basic understanding of Home Assistant.
Used abbreviations: FTC Flow Temperature Controller (main controller normally fitted on the inside unit)
- The cable needs to be connected to the main board of the heat pump within the inside unit. Before opening the unit ensure that there is no power going into the unit (turn off circuit breakers).
- Connect the cable from the heatpump to the port labeled 'INT' (disconnect melcloud wifi adapter from the main board if it was connected). Connect the melcloud wifi adapter to the 'EXT' port.
-
If the Atom is pre-flashed, you are basically done. Close the unit and restore the power. The Atom will go into WiFi hotspot mode to allow you to connect it to your home network. See https://esphome.io/components/captive_portal.html for details.
-
Now go to Home Assistant. With the Atom on your WiFI network it will appear as a new device and can be added in the usual way.
If you want to do flash it yourself, install the ESPHome integration as an addon in home assistant. Choose new device, press continue, give it a name, for example ecodan-esphome, choose for example esp32-s3. DO NOT CHOOSE ENCRYPTION-KEY (skip) You need to fill in (wifi) secrets (in the upper right corner of the esphome dashboard). Example of the code is here:
# Your Wi-Fi SSID and password
wifi_ssid: "wifi network id"
wifi_password: "wifi password"
And click save.
Now go to the new device and choose EDIT.
Copy the raw code from githubs ecodan-esphome.yaml into this new device and overwrite ALL existing code.
Instead of the esp32s3.yaml
Fill in esp32s3-proxy2.yaml
as configuration in ecodan-esphome.yaml
.
Example packages code with esp32s3-proxy2.yaml:
packages:
remote_package:
url: https://github.com/gekkekoe/esphome-ecodan-hp/
ref: main
refresh: always
files: [
confs/base.yaml, # required
confs/esp32s3-proxy2.yaml, # confs/esp32.yaml, for regular board
confs/zone1.yaml,
## enable if you want to use zone 2
#confs/zone2.yaml,
## enable label language file
confs/ecodan-labels-en.yaml,
#confs/ecodan-labels-nl.yaml,
#confs/ecodan-labels-it.yaml,
#confs/ecodan-labels-fr.yaml,
#confs/ecodan-labels-es.yaml
confs/server-control.yaml,
#confs/debug.yaml,
## enable this to monitor WiFi status with ESP in-built LED
#confs/status_led.yaml,
## enable this to monitor status with custom led colors, uses https://github.com/esphome/esphome/pull/5814
#confs/status_led_rgb.yaml,
confs/wifi.yaml
]
Click save and install. Choose manual and the code will be compiled to a ecodan-heatpump.bin. Choose Factory format when compiling is finished. You can then flash the .bin file, for the first time, by using an usb 'c' cable connected to the Atom S3 lite. (need to power off the heatpump again and remove the m5stack proxy to flash it) Flash the atom connected to a usb cable by using: https://web.esphome.io/?dashboard_install Click connect and choose the correct com port. And then click install. Next time, the firmware can be updated by wifi directly, from within esphome, as it detects the device is already setup in your network, with the same code.