【亲测免费】 Xiaomi Miot For HomeAssistant 安装和配置指南

1. 项目基础介绍和主要的编程语言

项目基础介绍

hass-xiaomi-miot 是一个开源项目，旨在通过 miot-spec 协议自动将小米设备集成到 HomeAssistant 中。该项目支持 Wi-Fi、BLE 和 ZigBee 设备，并且支持通过 HomeAssistant 的 Web UI 进行配置，无需手动编写 YAML 配置文件。

主要的编程语言

该项目主要使用 Python 进行开发，利用 HomeAssistant 的插件机制来实现小米设备的集成。

2. 项目使用的关键技术和框架

关键技术

• miot-spec 协议：小米 IoT 设备的协议规范，用于描述硬件产品的功能定义。
• HomeAssistant 插件机制：通过 HomeAssistant 的插件机制，实现设备的自动集成。

框架

• HomeAssistant：一个开源的智能家居平台，支持多种设备的集成。
• HACS (Home Assistant Community Store)：一个用于管理和安装 HomeAssistant 插件的社区商店。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

1. HomeAssistant 环境：确保你已经安装并配置好了 HomeAssistant。
2. HACS 安装：如果你还没有安装 HACS，请先安装 HACS，它可以帮助你更方便地管理和安装 HomeAssistant 插件。

安装步骤

方法一：通过 HACS 安装

1. 打开 HACS：在 HomeAssistant 的侧边栏中找到并点击“HACS”。
2. 进入集成页面：在 HACS 页面中，点击“集成”。
3. 搜索并安装：点击右下角的“浏览并下载存储库”按钮，搜索“Xiaomi Miot Auto”，然后点击“下载此存储库”。
4. 重启 HomeAssistant：安装完成后，重启 HomeAssistant 以加载新安装的插件。

方法二：手动安装

1. 下载插件：通过 Samba 或 SFTP 下载 hass-xiaomi-miot 项目的 custom_components/xiaomi_miot 文件夹。
2. 复制文件夹：将下载的 xiaomi_miot 文件夹复制到 HomeAssistant 配置目录下的 custom_components 文件夹中。
3. 重启 HomeAssistant：重启 HomeAssistant 以加载新安装的插件。

方法三：通过 SSH 一键安装

1. 打开 SSH：通过 HomeAssistant 的 SSH 或 Terminal & SSH 插件打开 SSH 终端。
2. 执行安装脚本：在终端中执行以下命令：

   wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot bash -
   

3. 重启 HomeAssistant：安装完成后，重启 HomeAssistant 以加载新安装的插件。

配置步骤

1. 添加集成：在 HomeAssistant 的“配置” > “设备与服务” > “集成”页面中，点击右下角的“添加集成”按钮。
2. 搜索并添加：搜索“Xiaomi Miot Auto”，然后点击“提交”以添加集成。
3. 配置设备：根据提示，输入小米账号和密码，或者手动输入设备的 IP 地址和 Token 进行配置。

配置示例

xiaomi_miot:
  username: xiaomi_username
  password: xiaomi_password
  server_country: cn  # 小米云服务器的地区，可选值：cn, de, i2, ru, sg, tw, us
  http_timeout: 15  # 请求小米 API 的超时时间（秒）

通过以上步骤，你就可以成功地将小米设备集成到 HomeAssistant 中，并开始享受智能家居的便利。