• Stars
    star
    374
  • Rank 114,070 (Top 3 %)
  • Language
    Python
  • License
    Apache License 2.0
  • Created over 6 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Xiaomi Mi and Aqara Air Conditioning Companion integration for Home Assistant

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

  • Power (on, off)
  • Operation Mode (Heat, Cool, Auto, Dehumidify, Ventilate)
  • Fan Speed (Low, Medium, High, Auto)
  • Swing Mode (On, Off)
  • Target Temperature
  • Capture and replay infrared commands
  • Attributes
    • ac_model
    • ac_power (on, off)
    • load_power (Wh)
    • operation_mode
    • fan_speed
    • swing_mode

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.

More Repositories

1

xiaomi_airpurifier

Xiaomi Mi Air Purifier and Xiaomi Mi Air Humidifier integration for Home Assistant
Python
406
star
2

xiaomi_fan

Xiaomi Mi Smart Fan integration for Home Assistant
Python
330
star
3

esphome-jk-bms

ESPHome component to monitor and control a Jikong Battery Management System (JK-BMS) via UART-TTL or BLE
C++
181
star
4

xiaomi_cooker

Xiaomi Mi Electric Rice Cooker integration for Home Assistant
Python
123
star
5

esphome-yeelight-ceiling-light

ESPHome custom firmware for some Yeelight Ceiling Lights
C++
101
star
6

xiaomi_raw

Custom component for Home Assistant to faciliate the reverse engeneering of Xiaomi MiIO devices
Python
93
star
7

esphome-pipsolar

ESPHome component to monitor and control a pipsolar inverter via RS232
85
star
8

philipslight

Xiaomi Philips Lights integration for Home Assistant
Python
62
star
9

esphome-soyosource-gtn-virtual-meter

ESPHome component to simulate the current clamp to control the Soyosource GTN1200 limiter
C++
45
star
10

esphome-jbd-bms

ESPHome component to monitor and control a Xiaoxiang Battery Management System (JBD-BMS) via UART-TTL or BLE
C++
40
star
11

homeassistant-goecharger-mqtt

go-eCharger integration for Home Assistant using the MQTT API
Python
35
star
12

es-f

|es|f| is a web based HTML frontend for esniper, a lightweight console application for sniping eBay auctions.
PHP
29
star
13

esphome-zb-gw03

ESPHome custom firmware for the ZB-GW03 zigbee gateway
29
star
14

esphome-ant-bms

ESPHome component to monitor and control a ANT-BMS via UART
C++
27
star
15

esphome-atorch-dl24

ESPHome component to monitor and control some Atorch meters via bluetooth
C++
23
star
16

esphome-seplos-bms

ESPHome component to monitor a Seplos Battery Management System (Seplos-BMS) via UART or RS485
C++
23
star
17

esphome-solax-x1-mini

ESPHome component to monitor a Solax X1 mini via RS485
C++
22
star
18

esphome-mi-desk-lamp

ESPHome custom firmware for the Xiaomi Mi Desk Lamp
21
star
19

nextbike

Nextbike integration for Home Assistant
Python
11
star
20

esphome-jnge-mppt-controller

ESPHome component to monitor and control a JN-MPPT or JN-W/S Controller via RS485
C++
8
star
21

esphome-votronic

ESPHome component to monitor votronic devices via BLE or Display Link
C++
6
star
22

esphome-smg-ii

ESPHome configuration to monitor and control a ISolar/EASUN SMG II inverter via RS232
Shell
6
star
23

esphome-evse-wallbox

ESPHome component to monitor and control a EVSE wallbox
C++
5
star
24

esphome-pace-bms

ESPHome component to monitor and control a PACE Battery Management System (PACE-BMS) via RS485 (Modbus)
Shell
5
star
25

esphome-dps

ESPHome component to monitor and control the RDTech DPS series
C++
5
star
26

esphome-virtual-can-bms

ESPHome component to emulate a SMA/Victron compatible BMS via CAN bus
C++
5
star
27

xiaomi_airqualitymonitor

Xiaomi Mi Air Quality Monitor (PM2.5) integration for Home Assistant
Python
3
star
28

xiaomi_airhumidifier

Xiaomi Mi Air Humidifier integration for Home Assistant
2
star
29

xiaomi_repeater

Xioami Mi WiFi Repeater 2 integration for Home Assistant
Python
2
star
30

esphome-basen-bms

ESPHome component to monitor a Basen Battery Management System via BLE
C++
2
star
31

htc-vision-extended-keymap

Extended keymap for the qwertz hardware keyboard of my HTC Vision
C++
1
star
32

yeelight

Yeelight integration for Home Assistant
Python
1
star
33

esphome-config-examples

A collection of various ESPHome configurations and snippets
1
star
34

esphome-total-count

Python
1
star