Dear User,

We are writing to inform you that we have discovered two Home Assistant integration plug-ins developed by you ( https://github.com/Andre0512/hon and https://github.com/Andre0512/pyhOn ) that are in violation of our terms of service. Specifically, the plug-ins are using our services in an unauthorized manner which is causing significant economic harm to our Company. We take the protection of our intellectual property very seriously and demand that you immediately cease and desist all illegal activities related to the development and distribution of these plug-ins. We also request that you remove the plug-ins from all stores and code hosting platforms where they are currently available. Please be advised that we will take all necessary legal action to protect our interests if you fail to comply with this notice. We reserve the right to pursue all available remedies, including but not limited to monetary damages, injunctive relief, and attorney's fees. We strongly urge you to take immediate action to rectify this situation and avoid any further legal action. If you have any questions or concerns, please do not hesitate to contact us.

Haier Europe Security and Governance Department

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

Click to expand...

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

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.

Translation of internal names like programs are available for all languages which are official supported by the hOn app:

• 🇨🇳 Chinese
• 🇭🇷 Croatian
• 🇨🇿 Czech
• 🇳🇱 Dutch
• 🇬🇧 English
• 🇫🇷 French
• 🇩🇪 German
• 🇬🇷 Greek
• 🇮🇱 Hebrew
• 🇮🇹 Italian
• 🇵🇱 Polish
• 🇵🇹 Portuguese
• 🇷🇴 Romanian
• 🇷🇺 Russian
• 🇷🇸 Serbian
• 🇸🇰 Slovak
• 🇸🇮 Slovenian
• 🇪🇸 Spanish
• 🇹🇷 Turkish

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 compatibilty before you open an issue.
The apps on this (incomplete) list have been requested so far:

Any kind of contribution is welcome!

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)

1. Install pyhOn

    $ pip install pyhOn
   

2. 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
     ...
   

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

   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

• 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

• 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.

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! ⭐