Haier hOn

Home Assistant component supporting devices of Haier's mobile app hOn.

Installation

Installing via HACS

You need to have installed HACS
Go to HACS->Integrations
Add this repo (https://github.com/Andre0512/hon.git) into your HACS custom repositories
Search for Haier hOn and Download it
Restart your HomeAssistant
Go to Settings->Devices & Services
Shift reload your browser
Click Add Integration
Search for Haier hOn
Type your username used in the hOn App and hit submit

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.

Supported Appliances

Washing Machine

Tested Devices

Haier WD90

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.

2.8 KiB Raw Blame History