ECHONETLite Platform Custom Component for Home Assistant

(日本語)

A Home Assistant custom component for use with ECHONETLite compatible devices. This custom component makes use of the 'pychonet' Python3 library also maintained by this author. (https://github.com/scottyphillips/pychonet)

This component will set up the climate, fan, sensor, select and switch platforms.

Current working systems:

Based upon feedback this custom component works with the following compatible ECHONETLite Devices:

Mitsubishi MAC-568IF-E WiFi Adaptor connected to the following systems:
- GE Series
  - MSZ-GE42VAD
  - MSZ-GE24VAD
  - MSZ-GL71VGD
  - MSZ-GL50VGD
  - MSZ-GL35VGD
  - MSZ-GL25VGD
- AP Series
  - MSZ-AP22VGD
  - MSZ-AP25VGD
  - MSZ-AP50VGD
- LN Series
  - MSZ-LN25VG2
  - MSZ-LN35VG2
  - MSZ-LN50VG2
- Ducted
  - PEA-M100GAA
  - PEA-RP140GAA
Mitsubishi HM-W002-AC WiFi Adaptor connected to the following systems:
- JXV Series
  - MSZ-JXV4018S
Mitsubishi MAC-578IF2-E WiFi Adaptor connected to the following systems:
- AP Series
  - MSZ-AP22VGD
  - MSZ-AP35VGD
  - MSZ-AP50VGD
- Ducted
  - PEAD-RP71
'MoekadenRoom' ECHONETLite Simulator: https://github.com/SonyCSL/MoekadenRoom
- Home Air Conditioner
- Lighting
- Electric blind
- Lock Sensor
- Thermometer
- Smart meter
Sharp
- Air Conditioners
  - AY-J22H
  - AY-L40P
- Air Purifier
  - KI-HS70
Panasonic
- Air Conditioners
  - CS-221DJ
- IP/JEM-A conversion adapter
  - HF-JA2-W
Koizumi
- Lighting system AE50264E bridge (https://www.koizumi-lt.co.jp/product/jyutaku/tree/ )
Rinnai Hot water system (ECHONETLite enabled models)
- Switch entities to enable various hot water settings.
- Input entity to configure Hot Water Timers can be configured by using a template and a Service Call.
Daikin
- Air Conditioners
  - ECHONETLite enabled HVAC models.
OMRON Home Solar Power Generation
- Full support for Home Assistant Energy Dashboard including solar production and grid consumption.
- Loads of interesting sensors.
Low voltage smart meter (B route service)
- Require Wi-SUN <-> Ethernet/Wifi bridge
  - nao-pon/python-echonet-lite
  - etc.

Installation - Enable ECHONET protocol

This Custom Component was originally designed for the Mitsubishi MAC-568IF-E WiFi Adaptor, a basic guide for enabling ECHONETlite is provided below.

From the official Mitsubishi AU/NZ Wifi App, you will need to enable the 'ECHONET lite' protocol under the 'edit unit' settings.

Many other products will work using this custom-component, but they must correctly support the 'ECHONET lite' protocol. The author cannot assist with enabling ECHONET Lite for other vendor products.

Installation

Install using HACS

Look up 'ECHONETLite Platform' in integrations
Click 'Download', leave the version be and click 'Download' again.
Restart Home Assistant

Install manually

Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
If you do not have a custom_components directory (folder) there, you need to create it.
In the custom_components directory (folder) create a new folder called echonetlite.
Download all the files from the custom_components/echonetlite/ directory (folder) in this repository.
Place the files you downloaded in the new directory (folder) you created.
Restart Home Assistant and clear your browser cache

Setup

In Home Assistant, go to Settings -> Devices & Services -> ADD INTEGRATION.
Select the 'ECHONET Lite' integration. Enter the IP address of the HVAC unit in the host field, and give the platform a name.
Platform will automatically configure any supported platforms e.g. climate, sensor, switch, fan, select.
If you have additional devices to configure then repeat step 1.

Configuring Options for Fan and swing mode settings for supported HVAC and Air Purifiers.

Once you have added the integration, you can go back to configuration -> integrations Under your ECHONETLite device click 'configure'. Fine tune your required fan and swing mode settings. The integration will be able to determine what settings are supported for your system in question. NOTE: Selecting which specific options are suitable is a 'trial and error' process as ECHONETLite does not provide a means of returning permittted values for these settings.

As soon as you configure your options and save, the settings will take effect.

Hall of Fame

Thanks Naoki Sawada for creating the switch entity and creating the custom service call framework.

Thanks to Jason Nader for all the quality of life updates to the codebase and doco.

Thanks to khcnz (Karl Chaffey) and gvs for helping refector the old code and contributing to testing.

Thanks to Dick Swart, Masaki Tagawa, Paul, khcnz, Kolodnerd, and Alfie Gerner for each contributing code updates to to the original 'mitsubishi_hass' and therefore this custom component.

Thanks to Jeffro Carr who inspired me to write my own native Python ECHONET library for Home Assistant. Some ideas in his own repo got implemented in my own code. (https://github.com/jethrocarr/echonetlite-hvac-mqtt-service.git)

Thanks to Futomi Hatano for open sourcing a high quality and well documented ECHONET Lite library in Node JS that formed the basis of the 'Pychonet' library. (https://github.com/futomi/node-echonet-lite)

License

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

leonunix / echonetlite_homeassistant