Skip to content

Latest commit

 

History

History
148 lines (121 loc) · 4.44 KB

README.md

File metadata and controls

148 lines (121 loc) · 4.44 KB
Raw

Connectlife API proxy / MQTT Home Assistant integration

aarch64-shield amd64-shield armv6-shield armv7-shield i386-shield

The add-on utilizes the API acquired through reverse engineering from the Connectlife mobile app to control AC devices and integrates seamlessly with Home Assistant through MQTT, leveraging its discovery feature.

The reason for the add-on was the lack of official support for device integration.

I welcome pull requests, bug reports, and feature requests. Please feel free to submit them in the issues section.

Install in Home Assistant with Supervisor

ha_badge

  1. Make sure your Connectlife appliances are online.
  2. In Supervisor, navidate to the Add-on Store.
  3. From the overflow menu, select "Repositories".
  4. Add https://github.com/bilan/home-assistant-addons/.
  5. Wait for Add-on to appear or click "Reload" in the same overflow menu.
  6. Install / build thhe add-on.
  7. Turn on the add-on watchdog - Connectlife API is not stable and sometimes times out.
  8. In the Configuration section, fill in the necessary fields. If you leave the fields blank, the add-on will attempt to fetch MQTT credentials from the Supervisor API.

Run as independent docker container without HA/Supervisor

Build image

docker build . --build-arg='BUILD_FROM=alpine:3.19' -t ha-connectlife-addon

Run HTTP API and MQTT client both

docker run -it \
-p 8000:8000 \
-e CONNECTLIFE_LOGIN=connectlife-login-email \
-e CONNECTLIFE_PASSWORD=your-password \
-e LOG_LEVEL=info \
-e MQTT_HOST=host \
-e MQTT_USER=login  \
-e MQTT_PASSWORD=mqtt-pass  \
-e MQTT_PORT=1883 \
-e MQTT_SSL=false \
ha-connectlife-addon /bin/ash -c '/usr/bin/supervisord -c /home/app/docker-files/supervisord.conf'

HTTP API only

docker run -it \
-p 8000:8000 \
-e CONNECTLIFE_LOGIN=connectlife-login-email \
-e CONNECTLIFE_PASSWORD=your-password \
-e LOG_LEVEL=info \
ha-connectlife-addon /bin/ash -c 'php artisan serve --port=8000 --host=0.0.0.0'

MQTT client only

docker run -it \
-p 8000:8000 \
-e CONNECTLIFE_LOGIN=connectlife-login-email \
-e CONNECTLIFE_PASSWORD=your-password \
-e LOG_LEVEL=info \
-e MQTT_HOST=host \
-e MQTT_USER=login  \
-e MQTT_PASSWORD=mqtt-pass  \
-e MQTT_PORT=1883 \
-e MQTT_SSL=false \
ha-connectlife-addon /bin/ash -c 'php artisan app:mqtt-loop'

API endpoints

  • GET /api/devices

    example: curl -v http://0.0.0.0:8000/api/devices

  • POST /api/devices/{DEVICE_ID}

    example: curl -v http://0.0.0.0:8000/api/devices/pu12345 -d '{"t_temp":32}' -H "Content-Type: application/json"

Air Conditioner properties

Values for my personal split air conditioner (deviceFeatureCode 117, deviceTypeCode 009)

Property Description Type Example
t_power on / off uint 0 - off, 1 - on
t_temp temperature uint 21
t_beep buzzer uint 0, 1
t_work_mode mode uint 3
t_tms ?
t_swing_direction horizontal swing
t_swing_angle vertical swing
t_temp_type temp unit string "0" - fahr, "1" - celsius
t_fan_speed fan speed uint 0
t_fan_mute silence mode uint 0, 1
t_super fast mode uint 0,1
t_eco eco mode uint 0,1

t_work_mode

  • 0 - fan only
  • 1 - heat
  • 2 - cool
  • 3 - dry
  • 4 - auto

t_fan_speed

  • 0 - auto
  • 5 - super low
  • 6 - low
  • 7 - medium
  • 8 - high
  • 9 - super high

t_swing_direction

  • 0 - straight
  • 1 - right
  • 2 - both sides
  • 3 - swing
  • 4 - left

t_swing_angle

  • 0 - swing
  • 2 -> 7 - from bottom to top

Useful links