Home

Awesome

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 IDModel numberProduct nameShape
acpartner.v1KTBL01LMAqara Air Conditioning Companionsquare
acaprtner.v2KTBL02LMXiaomi Mi Air Conditioner Companionround
acpartner.v3KTBL11LMAqara Air Conditioning Companionsquare

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 attributeOptionalDescription
entity_idnoOnly act on a specific Xiaomi miIO fan entity.
slotyesStorage slot. Defaults to slot ID 30.
timeoutyesCapturing timeout. Defaults to 10 seconds.

Service xiaomi_miio_airconditioningcompanion.climate_send_command

Send captured infrared command or device configuration.

Service data attributeOptionalDescription
entity_idnoOnly act on a specific Xiaomi miIO fan entity.
commandnoInfrared command. Must start with FE or 01.