https://github.com/eugeneliu/xiaomi_airconditioningcompanionmcn02
Model lumi.acpartner.mcn02 Xiaomi air conditioning companion access HomeAssistent.
https://github.com/eugeneliu/xiaomi_airconditioningcompanionmcn02
climate hacs xiaomi-mi
Last synced: 5 months ago
JSON representation
Model lumi.acpartner.mcn02 Xiaomi air conditioning companion access HomeAssistent.
- Host: GitHub
- URL: https://github.com/eugeneliu/xiaomi_airconditioningcompanionmcn02
- Owner: EugeneLiu
- Created: 2020-08-22T08:36:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-18T08:04:26.000Z (over 1 year ago)
- Last Synced: 2025-06-11T20:13:30.230Z (6 months ago)
- Topics: climate, hacs, xiaomi-mi
- Language: Python
- Homepage:
- Size: 62.5 KB
- Stars: 87
- Watchers: 5
- Forks: 22
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Xiaomi Air Conditioning Companion 2
This is a custom component for home assistant to integrate the Xiaomi Mi Air Conditioning Companion 2:
| Model ID | Model number | Product name | Shape |
|-------------------|--------------|-----------------------------------------|----------|
| `lumi.acpartner.mcn02` | KTBL03LM | Xiaomi Mi Air Conditioner Companion 2 | square |
Please follow the instructions on [Retrieving the Access Token](https://www.home-assistant.io/components/vacuum.xiaomi_miio/#retrieving-the-access-token) to get the API token to use in the configuration.yaml file.
Credits: Thanks to [Rytilahti](https://github.com/rytilahti/python-miio) 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/EugeneLiu/xiaomi_airconditioningcompanionMCN02](https://github.com/EugeneLiu/xiaomi_airconditioningcompanionMCN02/)) to [HACS](https://hacs.xyz/) 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
```yaml
# configuration.yaml
climate:
- platform: xiaomi_miio_airconditioningcompanionmcn02
name: xiaomi Air Conditioning Companion 2
host:
token:
target_sensor: sensor.temperature_158d0001f53706
scan_interval: 60
```

## 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:
```yaml
# configuration.yaml
logger:
default: debug
logs:
custom_components.xiaomi_miio_airconditioningcompanionmcn02.climate: debug
miio: debug
```