Mitsubishi ECHONET Climate Component for Home Assistant
A Home Assistant custom component for use with ECHONET enabled Mitsubishi HVAC systems using the MAC-568IF-E WiFi Adaptor. This custom component makes use of the 'mitsubishi_echonet' Python library also written by yours truly: (https://github.com/scottyphillips/mitsubishi_echonet)
This component will set up the climate platform.
Current working systems:
Based upon feedback this custom component works on the following Mitsubishi HVAC systems all equipped with the MAC-568IF-E WiFi Adaptor: MSZ-GE42VAD MSZ-GE24VAD MSZ-GL50VGD MSZ-GL35VGD PEA-RP140GAA
Installation - Enable ECHONET protocol
This Custom Component makes use of the official Mitsubishi MAC-568IF-E WiFi Adaptor. Other adaptors (indeed other vendors!) may work, but they must support the 'ECHONET lite' protocol.
From the official Mitsubishi AU/NZ Wifi App, you will need to enable the 'ECHONET lite' protocol under the 'edit unit' settings.
Installation - Home Assistant
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
- If you do not have a
custom_componentsdirectory (folder) there, you need to create it.
- In the
custom_componentsdirectory (folder) create a new folder called
- Download all the files from the
custom_components/mitsubishi/directory (folder) in this repository.
- Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
climate:to your HA configuration as per the example below.
Using your HA configuration directory (folder) as a starting point you should now also have this:
custom_components/mitsubishi/__init__.py custom_components/mitsubishi/climate.py custom_components/mitsubishi/manifest.json
climate: - platform: mitsubishi ip_address: 18.104.22.168
||IP Address for the HVAC system.|
||Friendly name for the HVAC system|
||Configuration for the
Configuration options for
||Fine tune fan settings.|
Fine tuning fan settings.
Optionally, you can also specify what fan settings work with your specific HVAC system. If no fan speeds are configured, the system will default to 'low' and 'medium-high'. Just delete the ones you don't need. A bit of trial and error might be required here.
climate: - platform: mitsubishi ip_address: 192.168.1.6 name: "mitsubishi_ducted" fan_modes: - 'minimum' - 'low' - 'medium-low' - 'medium' - 'medium-high' - 'high' - 'very-high' - 'max'
Comments and suggestions are welcome!
Thanks to Dick Swart and Alfie Gerner who have both contributed code and great ideas in support of this project.
Thanks to Jeffro Carr who inspired me to write my own native Python ECHONET library for Home Assistant. I could not get his Node JS Docker container to work properly on Hass.io :-) Some ideas in his own repo got implemented in my own code. (https://github.com/jethrocarr/echonetlite-hvac-mqtt-service.git)
Also big thanks to Futomi Hatano for open sourcing a high quality and extremely well documented ECHONET Lite library in Node JS that formed the basis of my reverse engineering efforts. (https://github.com/futomi/node-echonet-lite)
This application is licensed under an MIT license, refer to LICENSE for details.