oyvindwe / connectlife-ha

ConnectLife integration for Home Assistant
GNU General Public License v3.0
62 stars 24 forks source link

ConnectLife

ConnectLife integration for Home Assistant

BuyMeCoffee

Installation

You can install using HACS or download.

HACS

If you have HACS installed, add this repository (oyvindwe/connectlife-ha) as a custom repository of type "Integration".

See https://hacs.xyz/docs/faq/custom_repositories/

Download

Download the connectlife directory and place in your <config>/custom_components/.

After installing, you need to restart Home Assistant.

Finally, add "ConnectLife" as an integration in the UI, and provide the username and password for your ConnectLife account.

You device and all their status values should show up.

Supported ConnectLife devices

Any unknown device will show up as sensors with names based on their properties. As there are a lot of exposed sensors, all unknown sensors are hidden by default. Access the device or entity list to view sensors and change visibility.

Known devices

Device name Device type Device type code Device feature code
AP10TW1RLR-N Air conditioner 006 200
Air conditioner 006 201
Dehumidifier 007 400
Dehumidifier 007 406
Air conditioner 009 100
Air conditioner 009 104
Air conditioner 009 106
Air conditioner 009 109
Air conditioner 009 117
Air conditioner 009 128
Air conditioner 009 129
W-DW50/60-22 Dishwasher 015 000
Heat pump 016 502
Induction hob 020 63c45b513e1a4bf7
Oven 023 295608422d362be1
Refrigerator 026 1b0610z0049j
DPNA83W Tumble dryer 032 000

Please, please, please contribute PRs with mapping files for your devices!

Supported Home Assistant entities

ConnectLife properties can be mapped to any of these entity types:

Disable beeping

Some devices will beep on every configuration change. To disable this, go to the ConnectLife integration and click "Configure" → "Configure a device" and select the device you want to disable beeping for.

Service to set property values on sensors

Entity service connectlife.set_value can be used to set values. Use with caution, as there is no validation if property is writeable or that the value is legal to set.

  1. The service can be accessed from Developer tools - Services.
  2. Search for service name "ConnectLife: Set value"
  3. Select entity as target.
  4. Enter value
  5. Call service.

It is possible to guard against set_value by setting read_only: true in the data dictionary on the sensor, e.g.

  - property: f_status 
    sensor:
      read_only: true

Issues

Climate entities

Please ignore the following warning in the log:

Entity None (<class 'custom_components.connectlife.climate.ConnectLifeClimate'>) implements HVACMode(s): auto, off and therefore implicitly supports the turn_on/turn_off methods without setting the proper ClimateEntityFeature. Please report it to the author of the 'connectlife' custom integration

Missing features:

Heat pump entities

Missing features:

Login

You have to create a ConnectLife account with username/password. SSO using other identity providers is not supported. Appliances can be shared with multiple accounts, so this should not be a blocker. See https://github.com/oyvindwe/connectlife-ha/issues/99 for more info.

Note that users at least in Russia and China can't log in using this integration. See discussion in https://github.com/bilan/connectlife-api-connector/issues/25