ha_xiaomi_home：打造智能家居中枢的零代码集成方案

ha_xiaomi_home：打造智能家居中枢的零代码集成方案

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

核心功能解析：小米设备与Home Assistant的无缝桥接

🔧双模控制架构
项目通过云控与本地控制两种模式实现设备管理：

• 云控制模式：通过MQTT Broker接收设备状态消息（如在线/离线通知），经HTTP API发送控制指令（如set_properties动作），架构如图所示：
  
• 本地控制模式：依托小米中枢网关的MQTT Broker实现局域网内设备直连，减少云端依赖，架构如图所示：
  

⚙️多设备类型支持
核心功能模块位于custom_components/xiaomi_home/，包含传感器（sensor.py）、开关（switch.py）、灯光（light.py）等15+设备类型的适配逻辑，通过MIoT协议标准化设备通信。

环境部署指南：从依赖检查到一键安装

📋前置检查清单
在执行安装前，验证系统环境：

# 检查Python版本（需3.8+） python3 --version # 确认Home Assistant配置目录 echo $HOME/.homeassistant

🚀安装流程

1. 克隆项目仓库：

git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home

2. 运行安装脚本，指定Home Assistant配置目录：

cd ha_xiaomi_home && ./install.sh $HOME/.homeassistant

[!NOTE]
安装脚本会自动复制组件到custom_components目录，并安装依赖包。若出现权限问题，需使用sudo执行。

配置流程详解：从账号绑定到设备导入

🔑账号配置

1. 在Home Assistant中进入「设置 > 设备与服务 > 添加集成」，搜索「Xiaomi Home」
2. 输入小米账号凭据，配置逻辑由config_flow.py实现（可理解为用户与系统交互的对话脚本）

📱设备管理

• 选择目标家居后，系统自动导入设备列表（支持扫地机器人、空调等200+设备型号）
• 在「配置选项」中可调整：
  • update_interval：设备状态刷新间隔（建议设为30秒）
  • entity_prefix：实体名称前缀（避免与其他集成冲突）

进阶使用技巧：性能优化与问题排查

🔍本地控制启用
修改custom_components/xiaomi_home/miot/miot_lan.py中的local_priority参数为True，优先使用局域网通信，降低延迟。

🔧常见问题解决

• 设备离线：检查miot_network.py中的网络超时设置
• 状态不同步：删除miot_storage.py生成的缓存文件，路径通常为config/.xiaomi_miot

[!NOTE]
高级用户可通过tools/update_lan_rule.py更新设备支持列表，添加新设备的本地控制规则。

通过以上步骤，即可实现小米智能家居设备与Home Assistant的深度集成，兼顾灵活性与稳定性。项目持续维护设备支持库，建议定期通过git pull更新代码。

【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home