小米空调伴侣自定义组件教程

项目介绍

小米空调伴侣自定义组件是专为Home Assistant设计的，由@syssi开发，用于增强对小米Mi和Aqara空调伴侣的支持。它允许用户更深入地集成和控制这些设备，特别是通过模拟红外命令发送和学习功能，为家庭自动化带来更多的灵活性和定制性。

项目快速启动

要快速启动并运行此自定义组件，请遵循以下步骤：

环境准备

确保您的Home Assistant系统已经升级到最新版本，并且启用了开发者模式。

安装组件

1. 克隆仓库： 在您的Home Assistant配置目录下的custom_components文件夹内创建（如果尚未存在）一个名为xiaomi_miio_airconditioningcompanion的文件夹。

   mkdir -p custom_components/xiaomi_miio_airconditioningcompanion
   

2. 下载组件： 将项目源码复制到上一步创建的文件夹中。

   git clone https://github.com/syssi/xiaomi_airconditioningcompanion.git custom_components/xiaomi_miio_airconditioningcompanion
   

3. 配置Home Assistant： 编辑Home Assistant的configuration.yaml文件，添加以下行来启用该组件（替换YOUR_DEVICE_ID和YOUR_TOKEN）：

   climate:
     - platform: xiaomi_miio_airconditioningcompanion
       name: "小米空调伴侣"
       host: "192.168.1.XX" # 设备IP地址
       token: "YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY" # 设备token
   

4. 重启Home Assistant： 保存配置并重启Home Assistant以加载新组件。

5. 验证安装： 重启后，在Home Assistant的界面中检查是否成功添加了小米空调伴侣设备。

应用案例和最佳实践

学习并发送红外命令

您可以通过服务调用来捕获和发送红外命令，实现对家中不同电器的智能化控制。

• 学习红外命令：

  service: xiaomi_miio_airconditioningcompanion.climate_learn_command
  data:
    entity_id: climate.xiaomi_ac_companion
    slot: 30
    timeout: 10
  

• 发送已学习的命令：

  service: xiaomi_miio_airconditioningcompanion.climate_send_command
  data:
    entity_id: climate.xiaomi_ac_companion
    command: "FE0000000000000000000000000000"
  

自动化场景

结合Home Assistant的自动化规则，您可以基于温度变化自动调节空调设置或开关。

典型生态项目

在小米生态链中，空调伴侣可以与其他小米智能产品如温湿度传感器、人体感应器等配合使用，构建复杂的联动场景。例如，当室内温度超过设定值且检测到有人时，自动开启空调并调整至预设舒适温度。这种结合使用不仅提升了智能家居体验，还展现了开放平台的强大之处，鼓励用户探索更多个性化的应用场景。

通过上述指南，您应该能够顺利集成小米空调伴侣到Home Assistant系统中，并利用其强大功能优化家庭自动化环境。记得不断探索和实验，发现更多可能性！