GitHub/hon
3
0
Fork 0
Code Issues 33 Pull Requests 2 Packages Projects Releases 69 Wiki Activity
c78aeb1fbb
hon/README.md
Andre Basche 135d6cafed Update to for hacs default integration
2023-04-02 02:44:13 +02:00

3.3 KiB
Raw Blame History

Haier hOn

hacs_badge

Home Assistant integration for Haier hOn: support for Haier/Candy/Hoover home appliances like washing machines. ## Supported Appliances - Washing Machine - Tumble Dryer

Installation

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

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

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

Configuration

Open your Home Assistant instance and start setting up a new integration.

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! #### Add appliances or additional attributes 1. Install pyhOn commandline $ pip install pyhOn 2. Use the commandline 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

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.

Tested Devices

  • Haier WD90-B14TEAM5
  • Haier HD80-A3959

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.