Skip to content

Latest commit

 

History

History
139 lines (113 loc) · 4.86 KB

README.md

File metadata and controls

139 lines (113 loc) · 4.86 KB
Raw

Mitsubishi ECHONET Climate Component for Home Assistant

GitHub Release License hacs Project Maintenance BuyMeCoffee

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:

  • GE Series
    • MSZ-GE42VAD
    • MSZ-GE24VAD
    • MSZ-GL50VGD
    • MSZ-GL35VGD
  • AP Series
    • MSZ-AP22VGD
    • MSZ-AP25VGD
    • MSZ-AP50VGD
  • Ducted
    • 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.

echonet

Installation - Home Assistant

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called mitsubishi.
  4. Download all the files from the custom_components/mitsubishi/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. Add 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

Example configuration.yaml

climate:
  - platform: mitsubishi
    ip_address: 1.2.3.4

Configuration options

Key Type Required Description
ip_address string True IP Address for the HVAC system.
name string False Friendly name for the HVAC system
climate list False Configuration for the climate platform.

Configuration options for climate list

Key Type Required Default Description
fan_modes list False True 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: 1.2.3.4
    name: "mitsubishi_ducted"
    fan_modes:
      - 'minimum'
      - 'low'
      - 'medium-low'
      - 'medium'
      - 'medium-high'
      - 'high'
      - 'very-high'
      - 'max'

sensor:
  - platform: mitsubishi
    ip_address: 1.2.3.4
    name: "mitsubishi_ducted"

Comments and suggestions are welcome!

Thanks

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)

License

This application is licensed under an MIT license, refer to LICENSE for details.