syssi / xiaomi_airconditioningcompanion

Xiaomi Mi and Aqara Air Conditioning Companion integration for Home Assistant
Apache License 2.0
401 stars 94 forks source link
acpartner airconditioning aqara custom-component hacktoberfest home-assistant infrared xiaomi

Xiaomi Mi and Aqara Air Conditioning Companion

GitHub actions GitHub stars GitHub forks GitHub watchers "Buy Me A Coffee"

This is a custom component for home assistant to integrate the Xiaomi Mi and Aqara Air Conditioning Companion:

Model ID Model number Product name Shape
acpartner.v1 KTBL01LM Aqara Air Conditioning Companion square
acaprtner.v2 KTBL02LM Xiaomi Mi Air Conditioner Companion round
acpartner.v3 KTBL11LM Aqara Air Conditioning Companion square

Unsupported devices: lumi.acpartner.mcn02

Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.

Credits: Thanks to Rytilahti for all the work.

Features

Install

You can install this custom component by adding this repository (https://github.com/syssi/xiaomi_airconditioningcompanion) to HACS in the settings menu of HACS first. You will find the custom component in the integration menu afterwards, look for 'Xiaomi Mi and Aqara Air Conditioning Companion Integration'. Alternatively, you can install it manually by copying the custom_component folder to your Home Assistant configuration folder.

Setup

# configuration.yaml

climate:
  - platform: xiaomi_miio_airconditioningcompanion
    name: Aqara Air Conditioning Companion
    host: 192.168.130.71
    token: b7c4a758c251955d2c24b1d9e41ce47d
    target_sensor: sensor.temperature_158d0001f53706
    scan_interval: 60

climate entity

Debugging

If the custom component doesn't work out of the box for your device please update your configuration to enable a higher log level:

# configuration.yaml

logger:
  default: warn
  logs:
    custom_components.xiaomi_miio_airconditioningcompanion: debug
    miio: debug

Platform services

Service xiaomi_miio_airconditioningcompanion.climate_learn_command

Capture an infrared command.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.
slot yes Storage slot. Defaults to slot ID 30.
timeout yes Capturing timeout. Defaults to 10 seconds.

Service xiaomi_miio_airconditioningcompanion.climate_send_command

Send captured infrared command or device configuration.

Service data attribute Optional Description
entity_id no Only act on a specific Xiaomi miIO fan entity.
command no Infrared command. Must start with FE or 01.