安装与使用 `homeassistant-mi-acpartner` 教程

安装与使用 homeassistant-mi-acpartner 教程

homeassistant-mi-acpartnerXiaoMi AC Partner plugins for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ho/homeassistant-mi-acpartner

1. 项目目录结构及介绍

homeassistant-mi-acpartner 是一个用于 Home Assistant 的插件，专为小米空调伴侣提供支持。以下是项目的目录结构及其基本解释：

├── custom_components      # 主要的自定义组件文件夹
│   └── xiaomi_miio          # 小米设备自定义组件
│       ├── __init__.py     # 组件初始化文件
│       ├── config_flow.py  # 配置流程管理器
│       ├── manifest.json   # 组件元数据
│       └── ...              # 其他相关文件
├── README.md               # 项目说明文档
├── LICENSE                 # 许可证文件
└── ...                      # 其他辅助文件和脚本

• custom_components: 存放自定义组件的主目录，xiaomi_miio 子目录包含了与小米设备交互的具体代码。
• __init__.py: 自定义组件的主要逻辑代码，处理与空调伴侣的通信。
• config_flow.py: 处理在 Home Assistant 中的配置过程，如添加、编辑和删除设备。
• manifest.json: 提供关于组件的元数据，包括作者、版本、依赖项等。

2. 项目启动文件介绍

在 Home Assistant 系统中，添加自定义组件并不涉及特定的启动文件。通常情况下，当你按照官方教程将 homeassistant-mi-acpartner 集成至你的 Home Assistant 安装时，只需要正确配置 .yaml 文件并重启 Home Assistant 服务。集成的过程可能如下：

1. 将 homeassistant-mi-acpartner 文件夹放置在 config/custom_components 目录下。
2. 更新或创建 configuration.yaml 文件，添加类似以下内容来配置小米空调伴侣：

   climate:
     - platform: xiaomi_miio
       host: <AC_PARTNER_IP_ADDRESS>
       token: <YOUR_ACCESS_TOKEN>
       name: "小米空调"
   

3. 保存文件，重启 Home Assistant。
4. 在 Home Assistant UI 中，你应该能看到新添加的小米空调伴侣设备。

3. 项目的配置文件介绍

主要的配置发生在 Home Assistant 的主配置文件 configuration.yaml 中。对于 homeassistant-mi-acpartner 插件，你需要提供空调伴侣的 IP 地址和设备访问令牌以建立连接。以下是一个示例配置：

# configuration.yaml 配置片段
climate:
  # 定义小米空调伴侣设备
  - platform: xiaomi_miio
    # 空调伴侣IP地址
    host: 192.168.1.100
    # 设备的令牌，从米家APP获取
    token: YOUR_ACCESS_TOKEN
    # 可选参数：设备名称
    name: "小米空调伴侣"
    # 可选参数：其他高级配置，如温控模式、风扇速度等
    temperature_unit: 'C'  # 温度单位
    min_temp: 17            # 最小温度
    max_temp: 30            # 最大温度
    hvac_modes:             # HVAC 模式
      - AUTO
      - HEAT
      - COOL
      - DRY
      - FAN
    swing_modes:
      - ON
      - OFF

请确保替换 <AC_PARTNER_IP_ADDRESS> 和 <YOUR_ACCESS_TOKEN> 为你自己的空调伴侣的实际 IP 地址和正确的设备访问令牌。其他可选参数可以根据你的具体需求进行配置。

完成配置后，记得保存文件并重新启动 Home Assistant，以便加载新的设置并与空调伴侣设备建立连接。现在，你就可以通过 Home Assistant 来控制小米空调伴侣及其关联的空调设备了。

homeassistant-mi-acpartnerXiaoMi AC Partner plugins for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ho/homeassistant-mi-acpartner