hOn/README.md

867 lines
36 KiB
Markdown
Raw Normal View History

2023-03-05 21:16:09 +01:00
# Haier hOn
2023-10-12 22:35:55 +02:00
[![hacs_badge](https://img.shields.io/badge/hacs-Default-41BDF5.svg)](https://hacs.xyz)
[![GitHub](https://img.shields.io/github/license/Andre0512/hon?color=red)](https://github.com/Andre0512/hon/blob/main/LICENSE)
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/Andre0512/hon/python_check.yml?branch=main&label=checks)](https://github.com/Andre0512/hon/actions/workflows/python_check.yml)
[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-donate-orange.svg)](https://www.buymeacoffee.com/andre0512)
2023-04-10 18:50:51 +02:00
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/Andre0512/hon?color=green)](https://github.com/Andre0512/hon/releases/latest)
2023-10-06 18:18:45 +02:00
[![GitHub all releases](https://img.shields.io/github/downloads/Andre0512/hon/latest/total?color=blue&label=downloads)](https://tooomm.github.io/github-release-stats/?username=Andre0512&repository=hon)
[![GitHub all releases](https://img.shields.io/github/downloads/Andre0512/hon/total?color=blue&label=total%20downloads)](https://tooomm.github.io/github-release-stats/?username=Andre0512&repository=hon)
2023-09-29 18:55:02 +02:00
---
2023-06-12 01:30:43 +02:00
Home Assistant integration for [Haier's mobile app hOn](https://hon-smarthome.com/) based on [pyhOn](https://github.com/Andre0512/pyhon).
2023-04-16 23:35:43 +02:00
2023-09-29 18:55:02 +02:00
---
2024-01-24 22:16:32 +01:00
2024-03-17 21:52:54 +01:00
[![Supported Languages](https://img.shields.io/badge/Languages-28-royalblue)](https://github.com/Andre0512/hon#supported-languages)
2023-09-29 18:55:02 +02:00
[![Supported Appliances](https://img.shields.io/badge/Appliances-11-forestgreen)](https://github.com/Andre0512/hon#supported-appliances)
2024-03-17 21:20:39 +01:00
[![Supported Models](https://img.shields.io/badge/Models-134-yellowgreen)](https://github.com/Andre0512/hon#supported-appliances)
2024-02-02 22:34:04 +01:00
[![Supported Entities](https://img.shields.io/badge/Entities-320-crimson)](https://github.com/Andre0512/hon#supported-appliances)
2024-01-24 22:16:32 +01:00
## Takedown Story
2024-02-02 18:51:47 +01:00
Haier sent a takedown notice and threatened legal action. The community started a big riot and called for a Haier boycott, the repository was forked over 2000+ times to make the code undeletable. Haier starts a dialog to find a joint solution. Read all about it here:
2024-01-24 22:16:32 +01:00
- [Timeline of events](https://github.com/Andre0512/hon/blob/main/takedown_timeline.md)
- [Takedown FAQs](https://github.com/Andre0512/hon/blob/main/takedown_faq.md)
- [Main discussion](https://github.com/Andre0512/hon/issues/147)
- [Summary video](https://www.youtube.com/watch?v=ayG7o74kdbc)
2024-02-02 18:51:47 +01:00
- [Haier's Statement](https://github.com/Andre0512/hon/issues/147#issuecomment-1923622715)
2023-09-29 18:55:02 +02:00
2023-03-21 22:28:08 +01:00
## Supported Appliances
2023-10-03 18:35:52 +02:00
_Click to expand..._
<details>
2023-11-20 23:38:43 +01:00
<summary>Air Conditioner</summary>
### Air Conditioner Example
![Air Conditioner](assets/example_ac.png)
### Supported Air Conditioner models
Support has been confirmed for these **22 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
#### Haier
- AD105S2SM3FA
- AD71S2SM3FA(H)
- AS07TS4HRA-M
- AS07TS5HRA
- AS09TS4HRA-M
- AS25PBAHRA
- AS25S2SF1FA
- AS25TADHRA-2
- AS25TEDHRA(M1)
- AS25THMHRA-C
- AS25XCAHRA
- AS35PBAHRA
- AS35S2SF1FA
- AS35S2SF2FA-3
- AS35TADHRA-2
- AS35TAMHRA-C
- AS35TEDHRA(M1)
- AS35XCAHRA
- AS50S2SF1FA
- AS50S2SF2FA-1
- AS50XCAHR
#### Candy
- CY-12TAIN
### Air Conditioner Entities
2023-05-10 18:13:05 +02:00
#### Controls
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-28 07:50:59 +02:00
| 10° Heating | `heat-wave` | `switch` | `10degreeHeatingStatus` |
| Air Conditioner | `air-conditioner` | `climate` | `settings` |
2023-05-28 07:50:59 +02:00
| Echo | `account-voice` | `switch` | `echoStatus` |
2023-07-10 00:27:37 +02:00
| Eco Mode | `sprout` | `switch` | `ecoMode` |
2023-05-17 00:01:33 +02:00
| Eco Pilot | `run` | `select` | `settings.humanSensingStatus` |
| Fan Direction Horizontal | `fan` | `select` | `settings.windDirectionHorizontal` |
| Fan Direction Vertical | `fan` | `select` | `settings.windDirectionVertical` |
2023-05-28 07:50:59 +02:00
| Health Mode | `medication-outline` | `switch` | `healthMode` |
2023-06-22 13:31:26 +02:00
| Night Mode | `bed` | `switch` | `silentSleepStatus` |
2023-05-28 07:50:59 +02:00
| Rapid Mode | `run-fast` | `switch` | `rapidMode` |
| Screen Display | `monitor-small` | `switch` | `screenDisplayStatus` |
| Self Cleaning | `air-filter` | `switch` | `selfCleaningStatus` |
| Self Cleaning 56 | `air-filter` | `switch` | `selfCleaning56Status` |
2023-06-22 13:31:26 +02:00
| Silent Mode | `volume-off` | `switch` | `muteStatus` |
2023-05-17 00:01:33 +02:00
| Target Temperature | `thermometer` | `number` | `settings.tempSel` |
#### Sensors
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-17 00:01:33 +02:00
| Air Temperature Outdoor | `thermometer` | `sensor` | `tempAirOutdoor` |
| Ch2O Cleaning | | `binary_sensor` | `ch2oCleaningStatus` |
| Coiler Temperature Indoor | `thermometer` | `sensor` | `tempCoilerIndoor` |
| Coiler Temperature Outside | `thermometer` | `sensor` | `tempCoilerOutdoor` |
| Defrost Temperature Outdoor | `thermometer` | `sensor` | `tempDefrostOutdoor` |
| Filter Replacement | | `binary_sensor` | `filterChangeStatusLocal` |
| In Air Temperature Outdoor | `thermometer` | `sensor` | `tempInAirOutdoor` |
| Indoor Temperature | `thermometer` | `sensor` | `tempIndoor` |
| Machine Status | `information` | `sensor` | `machMode` |
2023-05-17 00:01:33 +02:00
| Outdoor Temperature | `thermometer` | `sensor` | `tempOutdoor` |
| Program | | `select` | `startProgram.program` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-05-17 00:01:33 +02:00
| Selected Temperature | `thermometer` | `sensor` | `tempSel` |
2023-04-26 23:57:44 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Air Purifier</summary>
### Air Purifier Example
![Air Purifier](assets/example_ap.png)
### Supported Air Purifier models
Support has been confirmed for these **4 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
#### Hoover
- HHP30C011
- HHP50CA001
- HHP50CA011
- HHP70CAH011
### Air Purifier Entities
2023-06-21 00:59:00 +02:00
#### Controls
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-10 00:27:37 +02:00
| Aroma Time Off | `scent-off` | `number` | `settings.aromaTimeOff` |
| Aroma Time On | `scent` | `number` | `settings.aromaTimeOn` |
| Diffuser Level | `air-purifier` | `select` | `settings.aromaStatus` |
2023-06-30 19:40:30 +02:00
| Light status | | `light` | `settings.lightStatus` |
2023-07-01 17:09:53 +02:00
| Lock Status | | `lock` | `lockStatus` |
2023-07-10 00:27:37 +02:00
| Mode | `play` | `select` | `settings.machMode` |
| Pollen Level | `flower-pollen` | `number` | `settings.pollenLevel` |
| Touch Tone | `account-voice` | `switch` | `touchToneStatus` |
2023-06-21 00:59:00 +02:00
#### Sensors
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Air Quality | `weather-dust` | `sensor` | `airQuality` |
2023-06-21 00:59:00 +02:00
| CO Level | | `sensor` | `coLevel` |
| Error | `math-log` | `sensor` | `errors` |
| Humidity | | `sensor` | `humidityIndoor` |
| Main Filter Status | `air-filter` | `sensor` | `mainFilterStatus` |
2023-06-21 00:59:00 +02:00
| On | `power-cycle` | `binary_sensor` | `attributes.parameters.onOffStatus` |
2023-07-01 01:45:32 +02:00
| PM 10 | | `sensor` | `pm10ValueIndoor` |
| PM 2.5 | | `sensor` | `pm2p5ValueIndoor` |
| Pre Filter Status | `air-filter` | `sensor` | `preFilterStatus` |
2023-06-21 00:59:00 +02:00
| Temperature | | `sensor` | `temp` |
| Total Work Time | | `sensor` | `totalWorkTime` |
| VOC | | `sensor` | `vocValueIndoor` |
| Wind Speed | `fan` | `sensor` | `windSpeed` |
2023-06-21 00:59:00 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Dish Washer</summary>
### Dish Washer Example
![Dish Washer](assets/example_dw.png)
### Supported Dish Washer models
2024-03-17 21:20:39 +01:00
Support has been confirmed for these **7 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
- XIB 3B2SFS-80
2024-03-17 21:20:39 +01:00
- XIB 5C1S3FS
2023-11-20 23:38:43 +01:00
- XIB 6B2D3FB
#### Hoover
- HDPN 4S603PW/E
- HFB 5B2D3FW
- HFB 6B2S3FX
2024-01-11 02:12:07 +01:00
#### Candy
- CF 3C7L0X
2023-11-20 23:38:43 +01:00
### Dish Washer Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-28 07:50:59 +02:00
| Buzzer Disabled | `volume-off` | `switch` | `buzzerDisabled` |
2023-04-24 21:38:05 +02:00
| Dish Washer | `dishwasher` | `switch` | `startProgram` / `stopProgram` |
2024-02-02 22:34:04 +01:00
| Light status | | `light` | `settings.lightStatus` |
| Water hard | `water` | `number` | `settings.waterHard` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| 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` |
| 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` |
2023-05-14 03:17:58 +02:00
| Remaining Time | `timer` | `select` | `startProgram.remainingTime` |
2024-02-02 22:34:04 +01:00
| Tab Status | `silverware-clean` | `switch` | `startProgram.tabStatus` |
2023-05-14 03:17:58 +02:00
| Temperature | `thermometer` | `select` | `startProgram.temp` |
2023-04-24 21:38:05 +02:00
| Three in One | `numeric-3-box-outline` | `switch` | `startProgram.threeInOne` |
| Water hard | `water` | `number` | `startProgram.waterHard` |
2023-04-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | | `binary_sensor` | `attributes.lastConnEvent.category` |
| Door | | `binary_sensor` | `doorStatus` |
| Error | `math-log` | `sensor` | `errors` |
| Machine Status | `information` | `sensor` | `machMode` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| 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-17 23:18:27 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Hood</summary>
### Supported Hood models
Support has been confirmed for these **1 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
#### Haier
- HADG6DS46BWIFI
### Hood Entities
2023-05-30 05:33:11 +02:00
#### Controls
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-12 00:20:35 +02:00
| Hood | `hvac` | `switch` | `startProgram` / `stopProgram` |
| Light status | | `light` | `settings.lightStatus` |
2023-06-09 05:56:52 +02:00
| Wind Speed | | `fan` | `settings.windSpeed` |
2023-05-30 05:33:11 +02:00
#### Sensors
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Delay time | `clock-start` | `sensor` | `delayTime` |
| Delay time status | `clock-start` | `sensor` | `delayTimeStatus` |
| Errors | `alert-circle` | `sensor` | `errors` |
| Filter Cleaning Alarm Status | | `sensor` | `filterCleaningAlarmStatus` |
| Filter Cleaning Status | | `sensor` | `filterCleaningStatus` |
| Last Work Time | `clock-start` | `sensor` | `lastWorkTime` |
| Light Status | `lightbulb` | `sensor` | `lightStatus` |
| Mach Mode | | `sensor` | `machMode` |
| On / Off Status | `lightbulb` | `sensor` | `onOffStatus` |
| Quick Delay Time Status | | `sensor` | `quickDelayTimeStatus` |
| RGB Light Color | `lightbulb` | `sensor` | `rgbLightColors` |
| RGB Light Status | `lightbulb` | `sensor` | `rgbLightStatus` |
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Induction Hob</summary>
### Supported Induction Hob models
2024-01-11 02:12:07 +01:00
Support has been confirmed for these **3 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
- HA2MTSJ68MC
2024-01-11 02:12:07 +01:00
- HAIDSJ63MC
2023-11-20 23:38:43 +01:00
#### Candy
- CIS633SCTTWIFI
### Induction Hob Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Start Program | `pot-steam` | `button` | `startProgram` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Power Management | `timelapse` | `number` | `startProgram.powerManagement` |
| Program | | `select` | `startProgram.program` |
| Temperature | `thermometer` | `number` | `startProgram.temp` |
2023-04-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| 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` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Temperature | `thermometer` | `sensor` | `temp` |
2023-04-17 23:18:27 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Oven</summary>
### Oven Example
![Oven](assets/example_ov.png)
### Supported Oven models
Support has been confirmed for these **2 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
#### Haier
- HWO60SM2F3XH
#### Hoover
- HSOT3161WG
### Oven Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-28 17:38:56 +02:00
| Oven | `thermometer` | `climate` | `settings.tempSel` |
2023-07-01 01:45:32 +02:00
| Oven | `toaster-oven` | `switch` | `startProgram` / `stopProgram` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| 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-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Connection | `wifi` | `binary_sensor` | `attributes.lastConnEvent.category` |
| On | `power-cycle` | `binary_sensor` | `attributes.parameters.onOffStatus` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Start Time | `clock-start` | `sensor` | `delayTime` |
| Temperature | `thermometer` | `sensor` | `temp` |
| Temperature Selected | `thermometer` | `sensor` | `tempSel` |
2023-04-17 23:18:27 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Fridge</summary>
### Fridge Example
![Fridge](assets/example_ref.png)
### Supported Fridge models
2024-01-11 02:12:07 +01:00
Support has been confirmed for these **11 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
2024-01-11 02:12:07 +01:00
- HDPW5620ANPD
- HBW5519ECM
- HDW5620CNPK
2023-11-20 23:38:43 +01:00
- HFW7720ENMB
- HFW7819EWMP
- HSW59F18EIPT
- HTW5620DNMG
2024-01-11 02:12:07 +01:00
#### Hoover
- HOCE7620DX
2023-11-20 23:38:43 +01:00
#### Candy
- CE4T620EB
- CCE4T620EWU
- CCE4T618EW
### Fridge Entities
#### Controls
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-28 07:50:59 +02:00
| Auto-Set Mode | `thermometer-auto` | `switch` | `intelligenceMode` |
| Freezer | `snowflake-thermometer` | `climate` | `settings.tempSelZ2` |
2023-05-17 00:01:33 +02:00
| Freezer Temperature | `thermometer` | `number` | `settings.tempSelZ2` |
2023-05-28 07:50:59 +02:00
| Fridge | `thermometer` | `climate` | `settings.tempSelZ1` |
2023-05-17 00:01:33 +02:00
| Fridge Temperature | `thermometer` | `number` | `settings.tempSelZ1` |
2023-11-20 17:35:58 +01:00
| MyZone | `thermometer` | `climate` | `settings.tempSelZ3` |
| MyZone Temperature | `thermometer` | `number` | `settings.tempSelZ3` |
2023-05-21 20:51:20 +02:00
| Program Start | `play` | `button` | `startProgram` |
| Program Stop | `stop` | `button` | `stopProgram` |
| Super Cool | `snowflake` | `switch` | `quickModeZ1` |
| Super Freeze | `snowflake-variant` | `switch` | `quickModeZ2` |
2023-05-10 18:13:05 +02:00
#### Configs
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Program | | `select` | `startProgram.program` |
2023-05-21 20:51:20 +02:00
| Zone | `radiobox-marked` | `select` | `startProgram.zone` |
2023-05-10 18:13:05 +02:00
#### Sensors
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Auto-Set Mode | `thermometer-auto` | `binary_sensor` | `intelligenceMode` |
| Door1 Status Freezer | `fridge-bottom` | `binary_sensor` | `doorStatusZ2` |
| Door1 Status Fridge | `fridge-top` | `binary_sensor` | `doorStatusZ1` |
| Door2 Status Freezer | `fridge-bottom` | `binary_sensor` | `door2StatusZ2` |
| Door2 Status Fridge | `fridge-top` | `binary_sensor` | `door2StatusZ1` |
2023-05-21 20:51:20 +02:00
| Error | `math-log` | `sensor` | `errors` |
2023-05-15 00:38:41 +02:00
| Holiday Mode | `palm-tree` | `binary_sensor` | `holidayMode` |
| Humidity Level | `water-outline` | `sensor` | `humidityLevel` |
2023-05-10 18:13:05 +02:00
| Room Humidity | `water-percent` | `sensor` | `humidityEnv` |
| Room Temperature | `home-thermometer-outline` | `sensor` | `tempEnv` |
| Super Cool | `snowflake` | `binary_sensor` | `quickModeZ1` |
| Super Freeze | `snowflake-variant` | `binary_sensor` | `quickModeZ2` |
| Temperature Freezer | `snowflake-thermometer` | `sensor` | `tempZ2` |
| Temperature Fridge | `thermometer` | `sensor` | `tempZ1` |
2023-05-10 18:13:05 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Tumble Dryer</summary>
### Tumble Dryer Example
![Tumble Dryer](assets/example_td.png)
### Supported Tumble Dryer models
2024-01-11 02:12:07 +01:00
Support has been confirmed for these **22 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
- HD80-A3959
- HD90-A3TEAM5
- HD90-A2959
- HD90-A2959S
- HD90-A3959
#### Hoover
- HLE H8A2TE-S
- HLE H9A2TCE-80
- HLE C10DCE-80
- NDE H10A2TCE-80
- NDE H10RA2TCE-80
- NDE H9A2TSBEXS-S
- NDP H9A3TCBEXS-S
2024-01-11 02:12:07 +01:00
- NDP4 H7A2TCBEX-S
- NDPEH9A3TCBEXS-S
2023-11-20 23:38:43 +01:00
#### Candy
- BCTDH7A1TE
- CSOE C10DE-80
- CSOE C10TREX-47
2024-01-11 02:12:07 +01:00
- CSOE H10A2DE-S
2023-11-20 23:38:43 +01:00
- CSOE H9A2DE-S
- ROE H9A2TCE-80
- ROE H9A3TCEX-S
- ROE H10A2TCE-07
### Tumble Dryer Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Pause Tumble Dryer | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Tumble Dryer | `tumble-dryer` | `switch` | `startProgram` / `stopProgram` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-10 00:27:37 +02:00
| Anti-Crease | `iron` | `switch` | `startProgram.antiCreaseTime` |
| Anti-Crease | `iron` | `switch` | `startProgram.anticrease` |
2023-04-24 21:38:05 +02:00
| 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` |
| Program | | `select` | `startProgram.program` |
2023-09-29 17:24:21 +02:00
| Sterilization | `lotion-plus` | `switch` | `startProgram.sterilizationStatus` |
2023-04-24 21:38:05 +02:00
| Temperature level | `thermometer` | `number` | `startProgram.tempLevel` |
2023-09-29 17:24:21 +02:00
| Tumbling | `refresh-circle` | `switch` | `startProgram.tumblingStatus` |
2023-04-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-10 00:27:37 +02:00
| Anti-Crease | `iron` | `binary_sensor` | `anticrease` |
2023-04-24 21:38:05 +02:00
| 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` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Start Time | `clock-start` | `sensor` | `delayTime` |
| Temperature level | `thermometer` | `sensor` | `tempLevel` |
2023-04-17 23:18:27 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Wine Cellar</summary>
### Wine Cellar Example
![Wine Cellar](assets/example_wc.png)
### Supported Wine Cellar models
2024-02-02 22:34:04 +01:00
Support has been confirmed for these **3 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
- HWS247FDU1
- HWS42GDAU1
2024-02-02 22:34:04 +01:00
- HWS77GDAU1
2023-11-20 23:38:43 +01:00
### Wine Cellar Entities
2023-06-10 06:44:19 +02:00
#### Controls
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-06-30 19:40:30 +02:00
| Light | | `light` | `settings.lightStatus` |
2023-06-10 06:44:19 +02:00
| Sabbath Mode | `palm-tree` | `switch` | `sabbathStatus` |
| Wine Cellar | `thermometer` | `climate` | `settings.tempSel` |
| Wine Cellar | `thermometer` | `climate` | `settings.tempSelZ2` |
#### Sensors
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Error | `math-log` | `sensor` | `errors` |
| Humidity | `water-percent` | `sensor` | `humidityZ1` |
| Humidity 2 | `water-percent` | `sensor` | `humidityZ2` |
| Program | `play` | `sensor` | `programName` |
| Room Temperature | `home-thermometer-outline` | `sensor` | `tempEnv` |
| Selected Temperature | `thermometer` | `sensor` | `tempSel` |
| Selected Temperature 2 | `thermometer` | `sensor` | `tempSelZ2` |
| Temperature | `thermometer` | `sensor` | `temp` |
| Temperature 2 | `thermometer` | `sensor` | `tempZ2` |
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Washer Dryer</summary>
### Washer Dryer Example
![Washer Dryer](assets/example_wd.png)
### Supported Washer Dryer models
2024-01-11 02:12:07 +01:00
Support has been confirmed for these **15 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
- HWD100-B14978
- HWD100-B14979
- HWD100-B14959U1
- HWD80-B14979U1
#### Hoover
2024-01-11 02:12:07 +01:00
- H7D 4128MBC-S
2023-11-20 23:38:43 +01:00
- HD 4106AMC/1-80
- HD 485AMBB/1-S
- HD 495AMC/1-S
- HDB 5106AMC/1-80
2024-01-11 02:12:07 +01:00
- HDD4106AMBCR-80
2023-11-20 23:38:43 +01:00
- HDQ 496AMBS/1-S
- HDP 4149AMBC/1-S
- HWPS4954DAMR-11
#### Candy
- RPW41066BWMR/1-S
- RPW4966BWMR/1-S
### Washer Dryer Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-09-29 17:24:21 +02:00
| Auto Dose Detergent | `cup` | `switch` | `autoDetergentStatus` |
| Auto Dose Softener | `teddy-bear` | `switch` | `autoSoftenerStatus` |
2023-05-07 16:39:45 +02:00
| Pause Washer Dryer | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Washer Dryer | `washing-machine` | `switch` | `startProgram` / `stopProgram` |
2023-09-29 17:24:21 +02:00
| Water hard | `water` | `number` | `settings.waterHard` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-05-07 16:39:45 +02:00
| Acqua Plus | `water-plus` | `switch` | `startProgram.acquaplus` |
2023-07-10 00:27:37 +02:00
| Anti-Crease | `iron` | `switch` | `startProgram.anticrease` |
2023-09-29 17:24:21 +02:00
| Anti-Crease | `iron` | `switch` | `startProgram.antiCreaseTime` |
2023-05-13 01:20:02 +02:00
| Auto Dose Detergent | `cup` | `switch` | `startProgram.autoDetergentStatus` |
| Auto Dose Softener | `teddy-bear` | `switch` | `startProgram.autoSoftenerStatus` |
2023-05-07 16:39:45 +02:00
| Delay Status | `timer-check` | `switch` | `startProgram.delayStatus` |
2023-04-24 21:38:05 +02:00
| Delay Time | `timer-plus` | `number` | `startProgram.delayTime` |
2023-07-10 00:48:57 +02:00
| Dirty level | `liquid-spot` | `select` | `startProgram.dirtyLevel` |
2023-05-07 16:39:45 +02:00
| Dry Time | | `number` | `startProgram.dryTime` |
| Dry Time | `timer` | `select` | `startProgram.dryTimeMM` |
| Dry level | `hair-dryer` | `select` | `startProgram.dryLevel` |
| Extra Rinse 1 | `numeric-1-box-multiple-outline` | `switch` | `startProgram.extraRinse1` |
| Extra Rinse 2 | `numeric-2-box-multiple-outline` | `switch` | `startProgram.extraRinse2` |
| Extra Rinse 3 | `numeric-3-box-multiple-outline` | `switch` | `startProgram.extraRinse3` |
| Good Night | `weather-night` | `switch` | `startProgram.goodNight` |
2023-07-10 01:00:30 +02:00
| Hygiene | `lotion-plus` | `switch` | `startProgram.hygiene` |
2023-05-13 01:20:02 +02:00
| Keep Fresh | `refresh-circle` | `switch` | `startProgram.permanentPressStatus` |
2023-05-07 16:39:45 +02:00
| Main Wash Time | `clock-start` | `number` | `startProgram.mainWashTime` |
2023-09-29 17:24:21 +02:00
| Prewash | `tshirt-crew` | `switch` | `startProgram.prewash` |
2023-04-24 21:38:05 +02:00
| Program | | `select` | `startProgram.program` |
2023-05-07 16:39:45 +02:00
| Rinse Iterations | `rotate-right` | `number` | `startProgram.rinseIterations` |
| Soak Prewash Selection | `tshirt-crew` | `switch` | `startProgram.haier_SoakPrewashSelection` |
| Spin speed | `numeric` | `select` | `startProgram.spinSpeed` |
2023-10-02 03:33:45 +02:00
| Stain Type | `liquid-spot` | `select` | `startProgram.extendedStainType` |
2023-07-10 00:27:37 +02:00
| Steam level | `weather-dust` | `select` | `startProgram.steamLevel` |
2023-09-29 17:24:21 +02:00
| Sterilization | `lotion-plus` | `switch` | `startProgram.sterilizationStatus` |
2023-05-07 16:39:45 +02:00
| Temperature | `thermometer` | `select` | `startProgram.temp` |
| Temperature level | `thermometer` | `number` | `startProgram.tempLevel` |
2023-09-29 17:24:21 +02:00
| Tumbling | `refresh-circle` | `switch` | `startProgram.tumblingStatus` |
2023-05-07 16:39:45 +02:00
| Water hard | `water` | `number` | `startProgram.waterHard` |
| lang | | `number` | `startProgram.lang` |
2023-04-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-10 00:27:37 +02:00
| Acqua Plus | `water-plus` | `binary_sensor` | `acquaplus` |
| Anti-Crease | `iron` | `binary_sensor` | `anticrease` |
2023-04-24 21:38:05 +02:00
| Current Electricity Used | `lightning-bolt` | `sensor` | `currentElectricityUsed` |
2023-05-08 19:39:52 +02:00
| Current Temperature | `thermometer` | `sensor` | `temp` |
2023-04-24 21:38:05 +02:00
| Current Water Used | `water` | `sensor` | `currentWaterUsed` |
2023-07-10 00:48:57 +02:00
| Dirty level | `liquid-spot` | `sensor` | `dirtyLevel` |
2023-05-07 16:39:45 +02:00
| Door | | `binary_sensor` | `doorStatus` |
| Door Lock | | `binary_sensor` | `doorLockStatus` |
2023-04-24 21:38:05 +02:00
| Dry level | `hair-dryer` | `sensor` | `dryLevel` |
2023-05-07 16:39:45 +02:00
| Error | `math-log` | `sensor` | `errors` |
2023-07-10 00:27:37 +02:00
| Extra Rinse 1 | `numeric-1-box-multiple-outline` | `binary_sensor` | `extraRinse1` |
| Extra Rinse 2 | `numeric-2-box-multiple-outline` | `binary_sensor` | `extraRinse2` |
| Extra Rinse 3 | `numeric-3-box-multiple-outline` | `binary_sensor` | `extraRinse3` |
| Good Night Mode | `weather-night` | `binary_sensor` | `goodNight` |
2023-04-24 21:38:05 +02:00
| Machine Status | `information` | `sensor` | `machMode` |
2023-07-10 00:27:37 +02:00
| Pre Wash | `tshirt-crew` | `binary_sensor` | `prewash` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.lastConnEvent.category` |
2023-05-07 16:39:45 +02:00
| Spin Speed | `speedometer` | `sensor` | `spinSpeed` |
2023-10-02 03:33:45 +02:00
| Stain Type | `liquid-spot` | `sensor` | `stainType` |
2023-05-07 16:39:45 +02:00
| Start Time | `clock-start` | `sensor` | `delayTime` |
2023-07-10 00:27:37 +02:00
| Steam level | `weather-dust` | `sensor` | `steamLevel` |
2023-05-07 16:39:45 +02:00
| Temperature level | `thermometer` | `sensor` | `tempLevel` |
2023-04-24 21:38:05 +02:00
| Total Power | | `sensor` | `totalElectricityUsed` |
| Total Wash Cycle | `counter` | `sensor` | `totalWashCycle` |
| Total Water | | `sensor` | `totalWaterUsed` |
2023-04-17 23:18:27 +02:00
2023-11-20 23:38:43 +01:00
</details>
<details>
<summary>Washing Machine</summary>
### Washing Machine Example
![Washing Machine](assets/example_wm.png)
### Supported Washing Machine models
2024-03-17 21:20:39 +01:00
Support has been confirmed for these **44 models**, but many more will work. Please add already supported devices [with this form to complete the list](https://forms.gle/bTSD8qFotdZFytbf8).
2023-11-20 23:38:43 +01:00
#### Haier
2024-02-02 22:34:04 +01:00
- HW80-B1439N
2023-11-20 23:38:43 +01:00
- HW80-B14959TU1
- HW80-B14959S8U1S
- HW80-B14979TU1
2024-01-11 02:12:07 +01:00
- HW90-B145XLINEDE
2023-11-20 23:38:43 +01:00
- HW90-B14959U1
- HW90-B14959S8U1
2024-01-11 02:12:07 +01:00
- HW90-B14TEAM5
2024-03-17 21:20:39 +01:00
- HW90-BD14979U1
2023-11-20 23:38:43 +01:00
- HW90G-BD14979UD
- HW100-B14959U1
- HW110-14979
#### Hoover
2024-03-17 21:20:39 +01:00
- H3WOSQ495TA4-84
2024-02-02 22:34:04 +01:00
- H5WPB4 27BC8/1-S
2023-11-20 23:38:43 +01:00
- H5WPB447AMBC/1-S
- H7W 412MBCR-80
2024-01-11 02:12:07 +01:00
- H7W 610AMBC-80
2023-11-20 23:38:43 +01:00
- H7W4 48MBC-S
- HLWPS495TAMBE-11
2024-01-11 02:12:07 +01:00
- HPS484DAMB7/1-11
2023-11-20 23:38:43 +01:00
- HW 28AMBS/1-S
- HW 410AMBCB/1-80
- HW 411AMBCB/1-80
2023-11-21 02:32:53 +01:00
- HW 48AMC/1-S
2023-11-20 23:38:43 +01:00
- HW 49AMC/1-80
- HW 68AMC/1-80
- HW4 37AMBS/1-S
- HW4 37XMBB/1-S
- HWB 410AMC/1-80
- HWB 414AMC/1-80
- HWE 49AMBS/1-S
- HWP 48AMBCR/1-S
2024-03-17 21:20:39 +01:00
- HWP 49AMBCR/1-S
2024-01-11 02:12:07 +01:00
- HWP 610AMBC/1-S
2023-11-20 23:38:43 +01:00
- HWPD 69AMBC/1-S
- HWPDQ49AMBC/1-S
- HWPD 610AMBC/1-S
#### Candy
- CO4 107T1/2-07
- CBWO49TWME-S
- RO14126DWMST-S
- RO441286DWMC4-07
- RO4H7A2TEX-S
- ROW42646DWMC-07
- RP 696BWMRR/1-S
### Washing Machine Entities
2023-04-16 23:35:43 +02:00
#### Controls
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-09-29 17:24:21 +02:00
| Auto Dose Detergent | `cup` | `switch` | `autoDetergentStatus` |
| Auto Dose Softener | `teddy-bear` | `switch` | `autoSoftenerStatus` |
2023-04-24 21:38:05 +02:00
| Pause Washing Machine | `pause` | `switch` | `pauseProgram` / `resumeProgram` |
| Washing Machine | `washing-machine` | `switch` | `startProgram` / `stopProgram` |
2023-09-29 17:24:21 +02:00
| Water hard | `water` | `number` | `settings.waterHard` |
2023-04-16 23:35:43 +02:00
#### Configs
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
| Acqua Plus | `water-plus` | `switch` | `startProgram.acquaplus` |
2023-09-29 17:24:21 +02:00
| Anti-Crease | `iron` | `switch` | `startProgram.anticrease` |
2023-05-13 01:20:02 +02:00
| Auto Dose Detergent | `cup` | `switch` | `startProgram.autoDetergentStatus` |
| Auto Dose Softener | `teddy-bear` | `switch` | `startProgram.autoSoftenerStatus` |
2023-04-24 21:38:05 +02:00
| Delay Status | `timer-check` | `switch` | `startProgram.delayStatus` |
| Delay Time | `timer-plus` | `number` | `startProgram.delayTime` |
2023-07-10 00:48:57 +02:00
| Dirty level | `liquid-spot` | `select` | `startProgram.dirtyLevel` |
| Extra Rinse 1 | `numeric-1-box-multiple-outline` | `switch` | `startProgram.extraRinse1` |
| Extra Rinse 2 | `numeric-2-box-multiple-outline` | `switch` | `startProgram.extraRinse2` |
| Extra Rinse 3 | `numeric-3-box-multiple-outline` | `switch` | `startProgram.extraRinse3` |
| Good Night | `weather-night` | `switch` | `startProgram.goodNight` |
2023-07-10 01:00:30 +02:00
| Hygiene | `lotion-plus` | `switch` | `startProgram.hygiene` |
2023-05-13 01:20:02 +02:00
| Keep Fresh | `refresh-circle` | `switch` | `startProgram.permanentPressStatus` |
2023-04-24 21:38:05 +02:00
| Main Wash Time | `clock-start` | `number` | `startProgram.mainWashTime` |
2023-09-29 17:24:21 +02:00
| Prewash | `tshirt-crew` | `switch` | `startProgram.prewash` |
2023-04-24 21:38:05 +02:00
| Program | | `select` | `startProgram.program` |
| Rinse Iterations | `rotate-right` | `number` | `startProgram.rinseIterations` |
| Soak Prewash Selection | `tshirt-crew` | `switch` | `startProgram.haier_SoakPrewashSelection` |
| Spin speed | `numeric` | `select` | `startProgram.spinSpeed` |
2023-10-02 03:33:45 +02:00
| Stain Type | `liquid-spot` | `select` | `startProgram.extendedStainType` |
2023-07-10 00:27:37 +02:00
| Steam level | `weather-dust` | `select` | `startProgram.steamLevel` |
2023-04-24 21:38:05 +02:00
| Temperature | `thermometer` | `select` | `startProgram.temp` |
| Water hard | `water` | `number` | `startProgram.waterHard` |
| lang | | `number` | `startProgram.lang` |
2023-04-16 23:35:43 +02:00
#### Sensors
2023-04-24 21:38:05 +02:00
| Name | Icon | Entity | Key |
| --- | --- | --- | --- |
2023-07-10 00:27:37 +02:00
| Acqua Plus | `water-plus` | `binary_sensor` | `acquaplus` |
2023-04-24 21:38:05 +02:00
| Current Electricity Used | `lightning-bolt` | `sensor` | `currentElectricityUsed` |
2023-05-08 19:39:52 +02:00
| Current Temperature | `thermometer` | `sensor` | `temp` |
2023-04-24 21:38:05 +02:00
| Current Water Used | `water` | `sensor` | `currentWaterUsed` |
2023-07-10 00:48:57 +02:00
| Dirty level | `liquid-spot` | `sensor` | `dirtyLevel` |
2023-04-24 21:38:05 +02:00
| Door | | `binary_sensor` | `doorStatus` |
| Door Lock | | `binary_sensor` | `doorLockStatus` |
| Error | `math-log` | `sensor` | `errors` |
2023-07-10 00:27:37 +02:00
| Extra Rinse 1 | `numeric-1-box-multiple-outline` | `binary_sensor` | `extraRinse1` |
| Extra Rinse 2 | `numeric-2-box-multiple-outline` | `binary_sensor` | `extraRinse2` |
| Extra Rinse 3 | `numeric-3-box-multiple-outline` | `binary_sensor` | `extraRinse3` |
| Good Night Mode | `weather-night` | `binary_sensor` | `goodNight` |
2023-04-24 21:38:05 +02:00
| Machine Status | `information` | `sensor` | `machMode` |
2023-07-10 00:27:37 +02:00
| Pre Wash | `tshirt-crew` | `binary_sensor` | `prewash` |
2023-05-29 19:07:52 +02:00
| Program | `play` | `sensor` | `programName` |
2023-04-24 21:38:05 +02:00
| Program Phase | `washing-machine` | `sensor` | `prPhase` |
| Remaining Time | `timer` | `sensor` | `remainingTimeMM` |
| Remote Control | `remote` | `binary_sensor` | `attributes.lastConnEvent.category` |
| Spin Speed | `speedometer` | `sensor` | `spinSpeed` |
2023-10-02 03:33:45 +02:00
| Stain Type | `liquid-spot` | `sensor` | `stainType` |
2023-07-10 00:27:37 +02:00
| Steam level | `weather-dust` | `sensor` | `steamLevel` |
2023-04-24 21:38:05 +02:00
| Total Power | | `sensor` | `totalElectricityUsed` |
| Total Wash Cycle | `counter` | `sensor` | `totalWashCycle` |
| Total Water | | `sensor` | `totalWaterUsed` |
2023-11-20 23:38:43 +01:00
</details>
## Installation
**Method 1:** [![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Andre0512&repository=hon&category=integration)
**Method 2:** [HACS](https://hacs.xyz/) > Integrations > Add Integration > **Haier hOn** > Install
**Method 3:** Manually copy `hon` folder from [latest release](https://github.com/Andre0512/hon/releases/latest) to `config/custom_components` folder.
_Restart Home Assistant_
## Configuration
**Method 1**: [![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=hon)
**Method 2**: Settings > Devices & Services > Add Integration > **Haier hOn**
_If the integration is not in the list, you need to clear the browser cache._
## Supported Languages
Translation of internal names like programs are available for all languages which are official supported by the hOn app:
2024-03-17 21:52:54 +01:00
* 🇸🇦 Arabic
* 🇧🇬 Bulgarian
2023-11-20 23:38:43 +01:00
* 🇨🇳 Chinese
* 🇭🇷 Croatian
* 🇨🇿 Czech
2024-03-17 21:52:54 +01:00
* 🇩🇰 Danish
2023-11-20 23:38:43 +01:00
* 🇳🇱 Dutch
* 🇬🇧 English
2024-03-17 21:52:54 +01:00
* 🇫🇮 Finnish
2023-11-20 23:38:43 +01:00
* 🇫🇷 French
* 🇩🇪 German
* 🇬🇷 Greek
* 🇮🇱 Hebrew
2024-03-17 21:52:54 +01:00
* 🇭🇺 Hungarian
2023-11-20 23:38:43 +01:00
* 🇮🇹 Italian
2024-03-17 21:52:54 +01:00
* 🇳🇴 Norwegian
2023-11-20 23:38:43 +01:00
* 🇵🇱 Polish
* 🇵🇹 Portuguese
* 🇷🇴 Romanian
* 🇷🇺 Russian
* 🇷🇸 Serbian
* 🇸🇰 Slovak
* 🇸🇮 Slovenian
2024-03-17 21:52:54 +01:00
* 🇿🇦 Southern Ndebele
2023-11-20 23:38:43 +01:00
* 🇪🇸 Spanish
2024-03-17 21:52:54 +01:00
* 🇸🇪 Swedish
2023-11-20 23:38:43 +01:00
* 🇹🇷 Turkish
2024-03-17 21:52:54 +01:00
* 🇺🇦 Ukrainian
2023-11-20 23:38:43 +01:00
## Compatibility
Haier offers different apps for different markets. Some appliances are compatible with more than one app. This integration only supports appliances that can be controlled via hOn. Please download the hOn app and check compatibility before you open an issue.
2023-11-20 23:38:43 +01:00
The apps on this (incomplete) list have been requested so far:
| App | Main Market | Supported | Alternative |
|-----------------|---------------|-----------------------------------------|---------------------------------------------------------------------------------|
| Haier hOn | Europe | :heavy_check_mark: | |
| Candy simply-Fi | Europe | :grey_question: (only newer appliances) | [ofalvai/home-assistant-candy](https://github.com/ofalvai/home-assistant-candy) |
| Hoover Wizard | Europe | :grey_question: (only newer appliances) | |
| Haier Uhome | China | :x: | [banto6/haier](https://github.com/banto6/haier) |
| Haier U+ | China | :x: | |
| GE SmartHQ | North America | :x: | [simbaja/ha_gehome](https://github.com/simbaja/ha_gehome) |
| Haier Evo | Russia | :x: | |
## Contribute
Any kind of contribution is welcome!
| Please add your appliances data to our [hon-test-data collection](https://github.com/Andre0512/hon-test-data). <br/>This helps us to develop new features and not to break compatibility in newer versions. |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
### 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 button under diagnostics which can be used to log all info of your appliance.
1. Press the button to create a notification
2. Open home assistant notifications and copy the message (Crtl+A, Ctrl+C)
### Add appliances or additional attributes
1. Install [pyhOn](https://github.com/Andre0512/pyhOn)
```commandline
$ pip install pyhOn
```
2. Use the command line 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.
- Use [pyhOn's translate command](https://github.com/Andre0512/pyhOn#translation) to read out the official translations
## Special Thanks
- to [@alexandre-leites](https://github.com/alexandre-leites), [@MiguelAngelLV](https://github.com/MiguelAngelLV) and [@drudgebg](https://github.com/drudgebg) for contributing early to this project and adding new integrations.
- to [gvigroux/hon](https://github.com/gvigroux/hon), [signalize/hon-app-research](https://github.com/signalize/hon-app-research) and [slegars56/hon](https://github.com/slegars56/hon) for inspiring me to do this integration and for doing pioneer work on the hOn api.
- to everyone who contributed, created an issue, gave this repo a star, and used this integration.
- to the patience of my girlfriend as I work on this integration.
## Support
If you find this project helpful and would like to support its development, you can buy me a coffee! ☕
[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/andre0512)
Don't forget to star the repository if you found it useful! ⭐