.github/workflows | ||
custom_components/hon | ||
.gitignore | ||
hacs.json | ||
LICENSE | ||
README.md |
Haier hOn
Home Assistant component supporting devices of Haier’s mobile app hOn.
Supported Appliances
- Washing Machine
- Tumble Dryer
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 1. Install pyhOn
commandline $ pip install pyhOn
2. Use the commandline
tool to read out all appliance data from your account
commandline $ 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 ...
3. Fork this repository and clone it to your local machine 4. Add the
keys of the attributes you’d like to have as
EntityDescription
into this Repository
Example: Add pause button
python 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 ... ), ...
5. Create a pull
request
Tips and Tricks
- If you want to have some states humanreadable, have a look at the
translation_key
parameter of theEntityDescription
- 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.
Tested Devices
- Haier WD90-B14TEAM5
- Haier HD80-A3959
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.