Haier hOn

Home Assistant integration for Haier hOn: support for Haier/Candy/Hoover home appliances like washing machines.

Supported Appliances

Tumble Dryer
Washer Dryer
Washing Machine
Oven

Installation

Method 1:

Method 2: HACS > Integrations > Add Integration > Haier hOn > Install

Method 3: Manually copy hon folder from latest release to config/custom_components folder.

Restart Home Assistant

Configuration

Method 1:

Method 2: Settings > Devices & Services > Add Integration > Haier hOn
If the integration is not in the list, you need to clear the browser cache.

Contribute

Any kind of contribution is welcome!

Add appliances or additional attributes

Install pyhOn
```
 $ pip install pyhOn
```

Use the commandline tool to read out all appliance data from your account

$ pyhOn
User for hOn account: user.name@example.com
Password for hOn account: ********
========== WM - Washing Machine ==========
commands:
  pauseProgram: pauseProgram command
  resumeProgram: resumeProgram command
  startProgram: startProgram command
  stopProgram: stopProgram command
data:
  actualWeight: 0
  airWashTempLevel: 0
  airWashTime: 0
  antiAllergyStatus: 0
  ...

Fork this repository and clone it to your local machine

Add the keys of the attributes you'd like to have as EntityDescription into this Repository
Example: Add pause button

BUTTONS: dict[str, tuple[ButtonEntityDescription, ...]] = {
    "WM": (                        # WM is the applianceTypeName
        ButtonEntityDescription(
            key="pauseProgram",    # key from pyhOn
            name="Pause Program",  # name in home assistant
            icon="mdi:pause",      # icon in home assistant
            ...
        ),
    ...

Create a pull request

Tips and Tricks

If you want to have some states humanreadable, have a look at the translation_key parameter of the EntityDescription.
If you need to implement some more logic, create a pull request to the underlying library. There we collect special requirements in the appliances directory.
Use pyhOn's translate command to read out the official translations

Tested Devices

Haier WD90-B14TEAM5
Haier HD80-A3959
Haier HWO60SM2F3XH
Hoover H-WASH 500

About this Repo

The existing integrations missed some features from the app I liked to have in HomeAssistant. I tried to create a pull request, but in the structures of these existing repos, I find it hard to fit in my needs, so I basically rewrote everything. I moved the api related stuff into the package pyhOn.

4 KiB Raw Blame History