unixko / MitsuCon

Mitsubishi Heat Pump Controller for Home Assistant
Apache License 2.0
68 stars 12 forks source link

MitsuCon

Mitsubishi Heat Pump (Air Conditioner) Controller for Home Assistant

*New version with hvac_action. Plase increase PubSubClient.h MQTT_MAX_PACKET_SIZE to 2048.

Wemos D1 Mini Adapter

Build ESP-8266 device to interface between Mitsubishi Electric heat pump and Home Assistant. This code utilizes Home Assistant native MQTT HVAC component with MQTT discovery feature so it should be compatible with future Home Assistant updates and will be added to Home Assistant automatically without any configuration.

Hardware

The easiest way to buid a controller is to use Wemos D1 mini board since it already has 5V pin. Only board V2 is working out of box, not current board V3. Notice the big shield on board when you place order.

wemos

A connector to CN105 port on heat pump is JST PAP-05V-S.

Build a code

Using Arduino IDE to modify configuration and complie file for your hardware.

Arduino IDE 1.8.10 ArduinoJson 6.12.0 PubSubClient 2.7.0

Edit file Arduino\libraries\PubSubClient\PubSubClient.h MQTT_MAX_PACKET_SIZE to 2048.

Tested on Wemos D1 mini board with Home Assistant 0.96 and Mosquitto broker add-on 5.0.

Known Issues

Classic Code

The Classic folder is a code proven to working well on Home Assistant < 0.100.0. It has 2 parts:

Chris Davis has a very detailed instruction blog:

https://chrdavis.github.io/hacking-a-mitsubishi-heat-pump-Part-1/

https://chrdavis.github.io/hacking-a-mitsubishi-heat-pump-Part-2/

Other Projects

Interesting projects developed with different design choices:

WiFi manager and web interface https://github.com/gysmo38/mitsubishi2MQTT

Enhanced WiFi manager, web interface and mroe functions https://github.com/dzungpv/mitsubishi2MQTT

Added Platform IO, Added SSL, Added an RGB LED https://github.com/SittingDuc/MitsuCon

Credits

Thanks to all contributors especially:

*Mitsubishi means Mitsubishi Electric, not Mitsubishi Heavy Industries.