一、ha_xiaomi_home：小米设备接入Home Assistant
ha_xiaomi_home 是小米官方提供的Home Assistant集成组件，它扮演着桥梁的角色，将你众多的小米智能设备无缝连接到Home Assistant平台。这意味着你能够在Home Assistant的统一界面上掌控所有小米设备，实现自动化场景、自定义控制以及更高级的智能家居体验。它是由小米官方开发和维护的，保证了稳定性和与小米生态系统的兼容性。
二、安装ha_xiaomi_home：三种便捷途径
ha_xiaomi_home 提供了三种不同的安装方法，用户可以根据自身情况选择最合适的方式：
-
• 方法一：Git 克隆 (推荐): 这是最灵活也最推荐的安装方式，方便版本管理和更新。你需要先进入Home Assistant的
config目录，然后执行以下命令：
cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config更新到特定版本（例如 v1.0.0）的方法如下：
cd config/ha_xiaomi_home
git checkout v1.0.0
./install.sh /config-
• 方法二：HACS (未来支持): 虽然目前尚未正式集成到HACS，但未来
ha_xiaomi_home将会支持通过 HACS 进行安装，这将进一步简化安装流程。请关注HACS的更新。 -
• 方法三：手动安装: 你可以直接下载
custom_components/xiaomi_home文件夹，然后将其复制到 Home Assistant 的config/custom_components文件夹下。这种方法相对繁琐，且更新维护较为不便，因此不推荐。
三、配置与登录：轻松连接你的小米世界
安装完成后，你需要在 Home Assistant 中配置 ha_xiaomi_home 并登录你的小米账号：
-
1. 启动配置流程: 在 Home Assistant 的设置页面，找到 “设备与服务”，点击 “添加集成”，搜索 “小米智能家居” 并启动配置流程。
-
2. 小米账号登录: 按照提示，使用你的小米账号进行登录。
ha_xiaomi_home使用 OAuth 2.0 授权机制，不会直接存储你的小米账号密码，保障了你的账户安全。 -
3. 选择家居和设备: 登录成功后，你将可以选择你希望接入 Home Assistant 的小米家居以及其中的设备。
-
4. 多账号支持:
ha_xiaomi_home支持添加多个小米账号，方便管理分散在不同账号下的设备。 -
5. 高级设置: 在已配置的 “小米智能家居” 集成中，你可以找到高级设置，例如更新设备列表、启用/禁用局域网控制等。
四、局域网控制与云端控制：兼顾速度与稳定性
ha_xiaomi_home 支持两种控制模式：
-
• 云端控制: 通过小米云服务器进行控制，稳定性高，但速度相对较慢。这是默认的控制模式。
-
• 局域网控制: 某些支持局域网控制的小米设备，可以通过局域网直接控制，速度更快，响应更及时。但这需要你的小米设备和 Home Assistant 在同一个局域网内，并且需要满足一定的条件（例如，需要特定的固件版本）。需要注意的是，启用局域网控制可能会导致某些设备出现异常，请谨慎使用。
五、安全与隐私：保护你的数据
尽管 ha_xiaomi_home 使用 OAuth 2.0 避免直接存储密码，但你的小米账号相关信息（包括设备信息、令牌等）仍然会存储在 Home Assistant 的配置文件中。为了保证你的安全与隐私，请务必妥善保管你的 Home Assistant 配置文件，并定期备份。
六、高级功能：释放更多潜力
ha_xiaomi_home 不仅仅是简单的设备控制，它还提供了一些高级功能：
-
• 动作调试模式: 方便开发者调试以及高级用户自定义控制。
-
• 多语言支持: 支持多种语言，方便全球用户使用。
-
• 实体映射: 灵活的实体映射机制，确保与 Home Assistant 的完美集成。
七、部分设备暂不支持
ha_xiaomi_home 持续更新，支持的小米设备范围不断扩大，但并非所有小米设备都支持。蓝牙设备、红外设备以及部分特殊类型的设备暂不支持。
八、总结
ha_xiaomi_home 为小米智能家居设备与 Home Assistant 的集成提供了一种官方支持、稳定可靠的解决方案。通过本文的指导，你能够轻松地将你的小米设备添加到 Home Assistant 中，并体验到更加便捷、智能的家庭自动化生活。请记住妥善保管你的配置文件，并关注项目更新，以获得最新的功能和改进。
项目地址：https://github.com/XiaoMi/ha_xiaomi_home
