https://github.com/oyvindwe/connectlife-ha
ConnectLife integration for Home Assistant
https://github.com/oyvindwe/connectlife-ha
connectlife hacs hacs-integration home-assistant homeassistant
Last synced: 25 days ago
JSON representation
ConnectLife integration for Home Assistant
- Host: GitHub
- URL: https://github.com/oyvindwe/connectlife-ha
- Owner: oyvindwe
- License: gpl-3.0
- Created: 2024-05-07T06:20:14.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T19:00:32.000Z (2 months ago)
- Last Synced: 2025-03-29T05:01:45.680Z (about 1 month ago)
- Topics: connectlife, hacs, hacs-integration, home-assistant, homeassistant
- Language: Python
- Homepage:
- Size: 373 KB
- Stars: 93
- Watchers: 7
- Forks: 38
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ConnectLife
ConnectLife integration for Home Assistant
[](https://www.buymeacoffee.com/oyvindwev)
## 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 `/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 | 008 | 301 |
| | Air conditioner | 008 | 304 |
| | 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 |
| | Hood | 012 | 000 |
| W-DW50/60-22 | Dishwasher | 015 | 000 |
| Gorenje GS673B60W | Dishwasher | 015 | dishwasher-50.2f |
| W-DW50/60-22 | Dishwasher | 015 | dishwasher-60.2f |
| | Dishwasher | 015 | dishwasher-60.3 |
| | Heat pump | 016 | 502 |
| | Induction hob | 020 | 63c45b513e1a4bf7 |
| | Oven | 023 | 295608422d362be1 |
| WDSE1214-EVAJMW | Washing machine | 025 | 1wj120261v0w |
| WFSE1214-MVW002 | Washing machine | 025 | 1wj120389v0b |
| WF3S1114-LVW004 | Washing machine | 025 | 1wj105246v0w |
| RS818N4TIE1 | Refrigerator | 026 | 1b0628z0146j |
| | Refrigerator | 026 | 1b0610z0049j |
| DH3S802BW3 | Tumble dryer | 030 | 1wk080066v0w |
| DH5S102BW | Tumble dryer | 030 | 1wk100028v0w |
| DHSE10 | Tumble dryer | 030 | 1wk100130v0f |
| DPNA83W | Tumble dryer | 032 | 000 |
Please, please, please contribute PRs with [mapping files](custom_components/connectlife/data_dictionaries) for your devices!
## Supported Home Assistant entities
ConnectLife properties can be mapped to any of these entity types:
- [Binary sensor](https://developers.home-assistant.io/docs/core/entity/binary-sensor)
- [Climate](https://developers.home-assistant.io/docs/core/entity/climate)
- [Humidifier](https://developers.home-assistant.io/docs/core/entity/humidifier)
- [Number](https://developers.home-assistant.io/docs/core/entity/number)
- [Select](https://developers.home-assistant.io/docs/core/entity/select)
- [Sensor](https://developers.home-assistant.io/docs/core/entity/sensor)
- [Switch](https://developers.home-assistant.io/docs/core/entity/switch)
- [Water heater](https://developers.home-assistant.io/docs/core/entity/water-heater)
## Disable beeping
Some devices will beep on every configuration change. To disable this, go to the
[ConnectLife integration](https://my.home-assistant.io/redirect/integration/?domain=connectlife)
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](https://my.home-assistant.io/redirect/developer_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.
```yaml
- property: f_status
sensor:
read_only: true
```
## Issues
### Climate entities
Please ignore the following warning in the log:
```
Entity None () 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:
- Setting `target_temperature_high`/`target_temperature_low`
### Heat pump entities
Missing features:
- Setting state except to off/one defined state
- Setting `target_temperature_high`/`target_temperature_low`
### Login
You have to create a ConnectLife account with username/password. SSO using other identity providers is not supported (See https://github.com/oyvindwe/connectlife-ha/issues/99).
To work around this issue, you can do the following:
1. In the ConnectLife mobile app, create a new account using an email and password (needs to be a different email to your SSO account as that is now occupied by that SSO).
2. Still in the mobile app, switch accounts back to your SSO account, go to the device/s you have already setup in your SSO account, select them 1 by 1, scrolling to the bottom to get to the "Share Device" option and adding your new email to the shared accounts list.
3. In the connectlife-ha integration within Home Assistant, use the email and password from the new account you set up, which will now have the device(s) shared with it.
4. Forget your new email version of your account exists, you don't have to accept device shares or use that account for any other reason.
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