2023-03-06 01:46:09 +05:30
# Haier hOn
2023-04-10 22:20:51 +05:30
[](https://hacs.xyz)
[](https://github.com/Andre0512/hon/releases/latest)
2023-04-19 03:20:27 +05:30
[](https://github.com/Andre0512/hon/blob/main/LICENSE)
[](https://tooomm.github.io/github-release-stats/?username=Andre0512& repository=hon)
2023-04-02 06:13:20 +05:30
Home Assistant integration for Haier hOn: support for Haier/Candy/Hoover home appliances like washing machines.
2023-04-17 03:05:43 +05:30
2023-03-22 02:58:08 +05:30
## Supported Appliances
2023-04-17 03:05:43 +05:30
- [Washing Machine ](https://github.com/Andre0512/hon#washing-machine )
- [Tumble Dryer ](https://github.com/Andre0512/hon#tumble-dryer )
- [Washer Dryer ](https://github.com/Andre0512/hon#washer-dryer )
- [Oven ](https://github.com/Andre0512/hon#oven )
- [Hob ](https://github.com/Andre0512/hon#hob )
- [Dish Washer ](https://github.com/Andre0512/hon#dish-washer )
2023-05-07 04:22:54 +05:30
- [Air conditioner ](https://github.com/Andre0512/hon#air-conditioner ) [BETA]
2023-04-12 01:38:47 +05:30
2023-03-05 05:52:05 +05:30
## Installation
2023-04-08 09:45:33 +05:30
**Method 1:** [](https://my.home-assistant.io/redirect/hacs_repository/?owner=Andre0512& repository=hon& category=integration)
2023-04-02 06:13:20 +05:30
2023-04-08 09:45:33 +05:30
**Method 2:** [HACS ](https://hacs.xyz/ ) > Integrations > Add Integration > **Haier hOn** > Install
2023-04-02 06:13:20 +05:30
2023-04-08 09:45:33 +05:30
**Method 3:** Manually copy `hon` folder from [latest release ](https://github.com/Andre0512/hon/releases/latest ) to `config/custom_components` folder.
2023-04-02 06:13:20 +05:30
2023-04-10 11:47:27 +05:30
_Restart Home Assistant_
2023-04-02 06:13:20 +05:30
## Configuration
2023-04-08 09:45:33 +05:30
**Method 1**: [](https://my.home-assistant.io/redirect/config_flow_start/?domain=hon)
2023-04-02 06:13:20 +05:30
2023-04-08 09:45:33 +05:30
**Method 2**: Settings > Devices & Services > Add Integration > **Haier hOn**
_If the integration is not in the list, you need to clear the browser cache._
2023-03-05 05:52:05 +05:30
2023-03-06 23:10:30 +05:30
## Contribute
Any kind of contribution is welcome!
2023-04-12 01:38:47 +05:30
### Read out device data
If you want to make a request for adding new appliances or additional attributes and don't want to use the command line, here is how you can read out your device data.
For every device exists a hidden button which can be used to log all info of your appliance.
1. Enable the "Log Device Info" button
_This button can be found in the diagnostic section of your device or in the entity overview if "show disabled entities" is enabled._
2. Press the button
3. Go to Settings > System > Logs, click _load full logs_ and scroll down
_The formatting is messy if you not load full logs_
4. Here you can find all data which can be read out via the api
```yaml
data:
appliance:
applianceId: 12-34-56-78-90-ab#2022-10-25T19:47:11Z
applianceModelId: 1569
...
```
5. Copy this data and create a [new issue ](https://github.com/Andre0512/hon/issues/new ) with your request
### Add appliances or additional attributes
2023-03-06 23:10:30 +05:30
1. Install [pyhOn ](https://github.com/Andre0512/pyhOn )
```commandline
$ pip install pyhOn
```
2023-04-12 01:38:47 +05:30
2. Use the command line tool to read out all appliance data from your account
2023-03-06 23:10:30 +05:30
```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
2023-04-10 11:47:27 +05:30
- If you want to have some states humanreadable, have a look at the `translation_key` parameter of the `EntityDescription` .
2023-03-06 23:10:30 +05:30
- 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-04-11 04:33:54 +05:30
- Use [pyhOn's translate command ](https://github.com/Andre0512/pyhOn#translation ) to read out the official translations
2023-03-06 23:10:30 +05:30
2023-03-05 05:52:05 +05:30
## Tested Devices
2023-03-22 02:58:08 +05:30
- Haier WD90-B14TEAM5
- Haier HD80-A3959
2023-04-08 09:45:33 +05:30
- Haier HWO60SM2F3XH
- Hoover H-WASH 500
2023-04-19 21:17:05 +05:30
- Candy CIS633SCTTWIFI
- Haier XIB 3B2SFS-80
- Haier XIB 6B2D3FB
2023-03-05 05:52:05 +05:30
2023-04-23 01:03:49 +05:30
## Supported Languages
Translation of internal names like programs are available for all languages which are official supported by the hOn app:
2023-04-23 01:22:49 +05:30
* 🇨🇳 Chinese
* 🇭🇷 Croatian
* 🇨🇿 Czech
* 🇳🇱 Dutch
* 🇬🇧 English
* 🇫🇷 French
* 🇩🇪 German
* 🇬🇷 Greek
* 🇮🇱 Hebrew
* 🇮🇹 Italian
* 🇵🇱 Polish
* 🇵🇹 Portuguese
* 🇷🇴 Romanian
* 🇷🇺 Russian
* 🇷🇸 Serbian
* 🇸🇰 Slovak
* 🇸🇮 Slovenian
* 🇪🇸 Spanish
* 🇹🇷 Turkish
2023-04-23 01:03:49 +05:30
2023-03-05 05:52:05 +05:30
## 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 ).
2023-04-17 03:05:43 +05:30
## Appliance Features
2023-04-18 02:48:27 +05:30
2023-04-27 03:27:44 +05:30
### Air conditioner
#### Configs
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| 10° Heating | | `switch` | `startProgram.10degreeHeatingStatus` |
| Echo | | `switch` | `startProgram.echoStatus` |
| Eco Mode | | `switch` | `startProgram.ecoMode` |
| Eco Pilot | | `select` | `startProgram.humanSensingStatus` |
| Health Mode | | `switch` | `startProgram.healthMode` |
| Mute | | `switch` | `startProgram.muteStatus` |
| Program | | `select` | `startProgram.program` |
| Rapid Mode | | `switch` | `startProgram.rapidMode` |
| Screen Display | | `switch` | `startProgram.screenDisplayStatus` |
| Self Cleaning | | `switch` | `startProgram.selfCleaningStatus` |
| Self Cleaning 56 | | `switch` | `startProgram.selfCleaning56Status` |
| Silent Sleep | | `switch` | `startProgram.silentSleepStatus` |
| Target Temperature | `thermometer` | `number` | `startProgram.tempSel` |
2023-04-17 03:05:43 +05:30
### Dish washer
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Dish Washer | `dishwasher` | `switch` | `startProgram` / `stopProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Add Dish | `silverware-fork-knife` | `switch` | `startProgram.addDish` |
| Delay time | `timer-plus` | `number` | `startProgram.delayTime` |
| Eco Express | `sprout` | `switch` | `startProgram.ecoExpress` |
| Eco Index | `sprout` | `sensor` | `startProgram.ecoIndex` |
| Energy Label | `lightning-bolt-circle` | `sensor` | `startProgram.energyLabel` |
| Extra Dry | `hair-dryer` | `switch` | `startProgram.extraDry` |
| Half Load | `fraction-one-half` | `switch` | `startProgram.halfLoad` |
| Open Door | `door-open` | `switch` | `startProgram.openDoor` |
| Program | | `select` | `startProgram.program` |
| Temperature | `thermometer` | `sensor` | `startProgram.temp` |
| Three in One | `numeric-3-box-outline` | `switch` | `startProgram.threeInOne` |
| Time | `timer` | `sensor` | `startProgram.remainingTime` |
| Water Efficiency | `water` | `sensor` | `startProgram.waterEfficiency` |
| Water Saving | `water-percent` | `sensor` | `startProgram.waterSaving` |
| Water hard | `water` | `number` | `startProgram.waterHard` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | | `binary_sensor` | `attributes.lastConnEvent.category` |
| Door | | `binary_sensor` | `doorStatus` |
| Error | `math-log` | `sensor` | `errors` |
| Machine Status | `information` | `sensor` | `machMode` |
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Rinse Aid | `spray-bottle` | `binary_sensor` | `rinseAidStatus` |
| Salt | `shaker-outline` | `binary_sensor` | `saltStatus` |
2023-04-18 02:48:27 +05:30
2023-04-17 03:05:43 +05:30
### Hob
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Start Program | `pot-steam` | `button` | `startProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Power Management | `timelapse` | `number` | `startProgram.powerManagement` |
| Program | | `select` | `startProgram.program` |
| Temperature | `thermometer` | `number` | `startProgram.temp` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | `wifi` | `binary_sensor` | `attributes.lastConnEvent.category` |
| Error | `math-log` | `sensor` | `errors` |
| Hob Lock | | `binary_sensor` | `hobLockStatus` |
| Hot Status | | `binary_sensor` | `hotStatus` |
| On | `power-cycle` | `binary_sensor` | `attributes.parameters.onOffStatus` |
| Pan Status | `pot-mix` | `binary_sensor` | `panStatus` |
| Power | `lightning-bolt` | `sensor` | `power` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.parameters.remoteCtrValid` |
| Temperature | `thermometer` | `sensor` | `temp` |
2023-04-18 02:48:27 +05:30
2023-04-17 03:05:43 +05:30
### Oven
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Oven | `toaster-oven` | `switch` | `startProgram` / `stopProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Delay time | `timer-plus` | `number` | `startProgram.delayTime` |
| Preheat | `thermometer-chevron-up` | `switch` | `startProgram.preheatStatus` |
| Program | | `select` | `startProgram.program` |
| Program Duration | `timelapse` | `number` | `startProgram.prTime` |
| Target Temperature | `thermometer` | `number` | `startProgram.tempSel` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | `wifi` | `binary_sensor` | `attributes.lastConnEvent.category` |
| On | `power-cycle` | `binary_sensor` | `attributes.parameters.onOffStatus` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.parameters.remoteCtrValid` |
| Start Time | `clock-start` | `sensor` | `delayTime` |
| Temperature | `thermometer` | `sensor` | `temp` |
| Temperature Selected | `thermometer` | `sensor` | `tempSel` |
2023-04-18 02:48:27 +05:30
2023-04-17 03:05:43 +05:30
### Tumble dryer
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Pause Tumble Dryer | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Tumble Dryer | `tumble-dryer` | `switch` | `startProgram` / `stopProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Anti-Crease | `timer` | `switch` | `startProgram.antiCreaseTime` |
| Anti-Crease | `timer` | `switch` | `startProgram.anticrease` |
| Delay time | `timer-plus` | `number` | `startProgram.delayTime` |
| Dry Time | | `number` | `startProgram.dryTime` |
| Dry Time | `timer` | `select` | `startProgram.dryTimeMM` |
| Dry level | `hair-dryer` | `select` | `startProgram.dryLevel` |
| Energy Label | `lightning-bolt-circle` | `sensor` | `startProgram.energyLabel` |
| Program | | `select` | `startProgram.program` |
2023-05-07 05:40:30 +05:30
| Steam Type | `weather-dust` | `sensor` | `steamType` |
| Steam level | `smoke` | `sensor` | `steamLevel` |
2023-04-25 01:08:05 +05:30
| Sterilization | `clock-start` | `switch` | `startProgram.sterilizationStatus` |
| Suggested Load | `weight-kilogram` | `sensor` | `startProgram.suggestedLoadD` |
| Temperature level | `thermometer` | `number` | `startProgram.tempLevel` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | | `binary_sensor` | `attributes.lastConnEvent.category` |
| Door | | `binary_sensor` | `doorStatus` |
| Dry level | `hair-dryer` | `sensor` | `dryLevel` |
| Error | `math-log` | `sensor` | `errors` |
| Machine Status | `information` | `sensor` | `machMode` |
| Program | `tumble-dryer` | `sensor` | `prCode` |
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Start Time | `clock-start` | `sensor` | `delayTime` |
| Temperature level | `thermometer` | `sensor` | `tempLevel` |
2023-04-18 02:48:27 +05:30
2023-04-17 03:05:43 +05:30
### Washer dryer
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Pause Washing Machine | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Washing Machine | `washing-machine` | `switch` | `startProgram` / `stopProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Delay Time | `timer-plus` | `number` | `startProgram.delayTime` |
| Program | | `select` | `startProgram.program` |
| Suggested weight | `weight-kilogram` | `sensor` | `startProgram.weight` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Acqua Plus | | `binary_sensor` | `acquaplus` |
| Anti-Crease | | `binary_sensor` | `anticrease` |
| Current Electricity Used | `lightning-bolt` | `sensor` | `currentElectricityUsed` |
| Current Program | `tumble-dryer` | `sensor` | `prCode` |
| Current Temperature | `thermometer` | `sensor` | `temp` |
| Current Water Used | `water` | `sensor` | `currentWaterUsed` |
| Dirt level | `liquid-spot` | `sensor` | `dirtyLevel` |
| Dry level | `hair-dryer` | `sensor` | `dryLevel` |
| Extra Rinse 1 | | `binary_sensor` | `extraRinse1` |
| Extra Rinse 2 | | `binary_sensor` | `extraRinse2` |
| Extra Rinse 3 | | `binary_sensor` | `extraRinse3` |
| Good Night Mode | | `binary_sensor` | `goodNight` |
| Machine Status | `information` | `sensor` | `machMode` |
| Pre Wash | | `binary_sensor` | `startProgram.prewash` |
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.lastConnEvent.category` |
| Spin Speed | `fast-forward-outline` | `sensor` | `spinSpeed` |
| Steam level | `smoke` | `sensor` | `steamLevel` |
| Total Power | | `sensor` | `totalElectricityUsed` |
| Total Wash Cycle | `counter` | `sensor` | `totalWashCycle` |
| Total Water | | `sensor` | `totalWaterUsed` |
2023-04-18 02:48:27 +05:30
2023-04-17 03:05:43 +05:30
### Washing machine
#### Controls
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Pause Washing Machine | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Washing Machine | `washing-machine` | `switch` | `startProgram` / `stopProgram` |
2023-04-17 03:05:43 +05:30
#### Configs
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-07 05:40:30 +05:30
| Acqua Plus | `water-plus` | `switch` | `startProgram.acquaplus` |
| Auto Dose | `cup` | `switch` | `startProgram.autoDetergentStatus` |
2023-04-25 01:08:05 +05:30
| Delay Status | `timer-check` | `switch` | `startProgram.delayStatus` |
| Delay Time | `timer-plus` | `number` | `startProgram.delayTime` |
| Energy Label | `lightning-bolt-circle` | `sensor` | `startProgram.energyLabel` |
2023-05-07 05:40:30 +05:30
| Extra Rinse 1 | `numeric-1-box-multiple-outline` | `switch` | `extraRinse1` |
| Extra Rinse 2 | `numeric-2-box-multiple-outline` | `switch` | `extraRinse2` |
| Extra Rinse 3 | `numeric-3-box-multiple-outline` | `switch` | `extraRinse3` |
| Good Night | `weather-night` | `switch` | `goodNight` |
2023-04-25 01:08:05 +05:30
| Keep Fresh | `refresh-circle` | `switch` | `startProgram.autoSoftenerStatus` |
| Liquid Detergent Dose | `cup-water` | `sensor` | `startProgram.liquidDetergentDose` |
| Main Wash Time | `clock-start` | `number` | `startProgram.mainWashTime` |
| Powder Detergent Dose | `cup` | `sensor` | `startProgram.powderDetergentDose` |
| Program | | `select` | `startProgram.program` |
2023-05-07 04:22:54 +05:30
| Remaining Time | `timer` | `sensor` | `startProgram.remainingTime` |
2023-04-25 01:08:05 +05:30
| Rinse Iterations | `rotate-right` | `number` | `startProgram.rinseIterations` |
| Soak Prewash Selection | `tshirt-crew` | `switch` | `startProgram.haier_SoakPrewashSelection` |
| Spin speed | `numeric` | `select` | `startProgram.spinSpeed` |
2023-05-07 05:40:30 +05:30
| Steam Level | `weather-dust` | `number` | `startProgram.steamLevel` |
| Suggested Load | `weight-kilogram` | `sensor` | `startProgram.suggestedLoadW` |
2023-04-25 01:08:05 +05:30
| Suggested weight | `weight-kilogram` | `sensor` | `startProgram.weight` |
| Temperature | `thermometer` | `select` | `startProgram.temp` |
2023-05-07 05:40:30 +05:30
| Water hard | `water` | `number` | `startProgram.waterHard` |
| lang | | `number` | `startProgram.lang` |
2023-04-17 03:05:43 +05:30
#### Sensors
2023-04-25 01:08:05 +05:30
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Current Electricity Used | `lightning-bolt` | `sensor` | `currentElectricityUsed` |
| Current Water Used | `water` | `sensor` | `currentWaterUsed` |
2023-05-07 05:40:30 +05:30
| Dirt level | `liquid-spot` | `sensor` | `dirtyLevel` |
2023-04-25 01:08:05 +05:30
| Door | | `binary_sensor` | `doorStatus` |
| Door Lock | | `binary_sensor` | `doorLockStatus` |
| Error | `math-log` | `sensor` | `errors` |
| Machine Status | `information` | `sensor` | `machMode` |
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.lastConnEvent.category` |
| Spin Speed | `speedometer` | `sensor` | `spinSpeed` |
| Total Power | | `sensor` | `totalElectricityUsed` |
| Total Wash Cycle | `counter` | `sensor` | `totalWashCycle` |
| Total Water | | `sensor` | `totalWaterUsed` |
