Haier hOn

Home Assistant integration for Haier's mobile app hOn based on pyhOn.

Takedown Story

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:

• Timeline of events
• Takedown FAQs
• Main discussion
• Summary video
• Haier's Statement

Supported Appliances

Click to expand...

Installation

Method 1:

Method 2: HACS > Integrations > Add Integration > Haier hOn > Install

Method 3: Manually copy hon folder from latest release to config/custom_components folder.

Restart Home Assistant

Configuration

Method 1:

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:

• 🇸🇦 Arabic
• 🇧🇬 Bulgarian
• 🇨🇳 Chinese
• 🇭🇷 Croatian
• 🇨🇿 Czech
• 🇩🇰 Danish
• 🇳🇱 Dutch
• 🇬🇧 English
• 🇫🇮 Finnish
• 🇫🇷 French
• 🇩🇪 German
• 🇬🇷 Greek
• 🇮🇱 Hebrew
• 🇭🇺 Hungarian
• 🇮🇹 Italian
• 🇳🇴 Norwegian
• 🇵🇱 Polish
• 🇵🇹 Portuguese
• 🇷🇴 Romanian
• 🇷🇺 Russian
• 🇷🇸 Serbian
• 🇸🇰 Slovak
• 🇸🇮 Slovenian
• 🇿🇦 Southern Ndebele
• 🇪🇸 Spanish
• 🇸🇪 Swedish
• 🇹🇷 Turkish
• 🇺🇦 Ukrainian

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.
The apps on this (incomplete) list have been requested so far:

Contribute

Any kind of contribution is welcome!

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

3. Install pyhOn

   $ pip install pyhOn

4. Use the command line 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
     ...

5. Fork this repository and clone it to your local machine
6. 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
               ...
           ),
       ...

7. 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.
• Use pyhOn's translate command to read out the official translations

Special Thanks

• to @alexandre-leites, @MiguelAngelLV and @drudgebg for contributing early to this project and adding new integrations.
• to gvigroux/hon, signalize/hon-app-research and 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! ☕

Don't forget to star the repository if you found it useful! ⭐