2023-03-05 20:16:09 +00:00
# Haier hOn
2023-03-06 17:40:30 +00:00
[](https://github.com/hacs/integration)
Home Assistant component supporting devices of Haier's mobile app **hOn** .
2023-03-05 00:22:05 +00:00
2023-03-21 21:28:08 +00:00
## Supported Appliances
- Washing Machine
- Tumble Dryer
2023-03-05 00:22:05 +00:00
## Installation
2023-03-05 20:16:09 +00:00
#### Installing via HACS
1. You need to have installed [HACS ](https://hacs.xyz/ )
2023-03-05 00:22:05 +00:00
2. Go to HACS->Integrations
2023-03-06 12:41:58 +00:00
3. Add this repo (`https://github.com/Andre0512/hon.git`) into your HACS custom repositories
2023-03-05 00:22:05 +00:00
4. Search for Haier hOn and Download it
5. Restart your HomeAssistant
6. Go to Settings->Devices & Services
7. Shift reload your browser
8. Click Add Integration
9. Search for Haier hOn
10. Type your username used in the hOn App and hit submit
2023-03-06 17:40:30 +00:00
## Contribute
Any kind of contribution is welcome!
#### Add appliances or additional attributes
1. Install [pyhOn ](https://github.com/Andre0512/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 ](https://github.com/Andre0512/hon/pulls )
#### 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.
2023-03-05 00:22:05 +00:00
## Tested Devices
2023-03-21 21:28:08 +00:00
- Haier WD90-B14TEAM5
- Haier HD80-A3959
2023-03-05 00:22:05 +00:00
## 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 ](https://github.com/Andre0512/pyhOn ).
