UNIDIRECTIONAL MIRROR from https://github.com/Andre0512/hon.
Go to file
2023-04-12 23:58:10 +02:00
.github/workflows Try to fix login issues #11 2023-04-10 20:35:22 +02:00
custom_components/hon Clean up sessions correct, fixes #19 2023-04-12 19:28:04 +02:00
.gitignore More functions 2023-03-03 19:11:33 +01:00
hacs.json Use info.md for hacs 2023-04-10 08:17:27 +02:00
info.md Add useful links 2023-04-12 23:58:10 +02:00
LICENSE Update README, add license 2023-03-05 01:22:20 +01:00
README.md Read out device data via ui 2023-04-11 22:08:47 +02:00

Haier hOn

hacs_badge GitHub release (latest by date) GitHub Home Assistant installs
Home Assistant integration for Haier hOn: support for Haier/Candy/Hoover home appliances like washing machines. ## Supported Appliances - Tumble Dryer - Washer Dryer - Washing Machine - Oven

Installation

Method 1: Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

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: Open your Home Assistant instance and start setting up a new integration.

Method 2: Settings > Devices & Services > Add Integration > Haier hOn
If the integration is not in the list, you need to clear the browser cache.

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 dont 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 with your request

Add appliances or additional attributes

  1. Install 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 youd 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

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 pyhOns translate command to read out the official translations

Tested Devices

  • Haier WD90-B14TEAM5
  • Haier HD80-A3959
  • Haier HWO60SM2F3XH
  • Hoover H-WASH 500

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.