当前位置：首页 > news >正文

小米智能家居全面接入HomeAssistant：一个插件打通全屋设备

news 2026/6/7 17:20:27

小米智能家居全面接入HomeAssistant：一个插件打通全屋设备

【免费下载链接】hass-xiaomi-miotAutomatic integrate all Xiaomi devices to HomeAssistant via miot-spec, support Wi-Fi, BLE, ZigBee devices. 小米米家智能家居设备接入Hass集成项目地址: https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot

还在为家里几十个小米智能设备无法统一管理而烦恼吗？每次都要打开米家APP、小爱音箱、智能网关等多个应用才能控制不同设备？今天我要分享一个彻底改变小米智能家居体验的终极方案——Xiaomi Miot For HomeAssistant集成插件。这个开源项目基于MIoT-Spec协议，能够自动将你的所有小米设备无缝接入HomeAssistant系统，无论是Wi-Fi、蓝牙还是Zigbee设备，都能在一个界面中集中控制。

为什么你需要这个插件？🚀

在智能家居生态中，小米设备以其高性价比和丰富的产品线赢得了大量用户。然而，随着设备数量增多，管理分散的问题日益突出：

多APP切换：米家APP、小爱音箱、智能网关各自为政
自动化限制：米家APP的自动化逻辑相对简单，无法实现复杂场景
数据孤岛：设备数据无法与其他智能家居系统共享
高级功能缺失：缺少精细化的设备控制和状态监控

Xiaomi Miot For HomeAssistant插件正是为了解决这些问题而生。它通过小米官方的MIoT-Spec协议，为HomeAssistant用户提供了一个统一的管理平台。

核心优势：为什么这个方案脱颖而出？⚡

1. 协议级原生支持

不同于传统的逆向工程方案，该项目直接使用小米官方的MIoT-Spec协议规范。这意味着：

更高的兼容性：支持最新发布的小米设备
更稳定的连接：基于官方协议，减少断连问题
更完整的功能：能够访问设备的全部属性和服务

2. 双模式智能连接

插件提供了两种设备连接方式，适应不同网络环境：

账号集成模式：使用小米账号登录，系统自动发现局域网内所有设备。插件会自动识别设备类型，并为每个设备创建对应的HomeAssistant实体。

本地Token模式：对于需要更高安全性的场景，可以使用设备的host和token进行直接本地连接，数据完全在局域网内传输。

3. 自动化设备发现

插件内置了设备识别机制，能够自动判断设备类型并创建合适的实体。从简单的智能插座到复杂的扫地机器人，都能被正确识别和配置。

5分钟快速部署指南💡

第一步：安装插件

最推荐的方式是通过HACS（HomeAssistant社区商店）安装：

打开HACS集成页面
搜索"Xiaomi Miot"
点击下载并安装

如果你更喜欢手动安装，也可以直接从仓库克隆：

git clone https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot

然后将custom_components/xiaomi_miot文件夹复制到HomeAssistant的custom_components目录中。

第二步：配置集成

重启HomeAssistant后，在配置界面添加集成：

进入"配置" → "设备与服务" → "集成"
点击右下角"添加集成"按钮
搜索"Xiaomi Miot"并选择

第三步：选择连接模式

根据你的需求选择合适的连接方式：

自动模式（推荐）：插件会自动检测局域网内支持miot-spec协议的设备，并优先使用本地连接
本地模式：所有设备都使用局域网连接，需要确保HomeAssistant与设备在同一子网
云端模式：通过小米云服务连接设备，适合远程访问场景

高级配置技巧：释放设备全部潜能🔧

设备自定义配置

在configuration.yaml中，你可以对每个设备进行精细化控制：

xiaomi_miot: device_customizes: chuangmi.plug.212a01: miot_local: true chunk_properties: 7 interval_seconds: 30

实体属性过滤

为了避免HomeAssistant数据库过大，可以过滤掉不需要的设备属性：

xiaomi_miot: exclude_state_attributes: - miot_type - stream_address - motion_video_latest

多语言支持

插件支持中文界面，你可以在配置中指定语言：

xiaomi_miot: language: zh translations: idle: '空闲' busy: '工作中' fan.mode: straight wind: '直吹模式' natural wind: '自然风'

实战应用场景：从基础到进阶🎯

场景一：智能灯光自动化

通过Xiaomi Miot插件，你可以将小米智能灯与HomeAssistant的其他设备联动：

automation: - alias: "晚上回家自动开灯" trigger: - platform: state entity_id: device_tracker.your_phone to: 'home' condition: - condition: sun after: sunset action: - service: light.turn_on entity_id: light.xiaomi_bedroom_light data: brightness: 100 color_temp: 400

场景二：空调智能温控

结合温度传感器，实现基于环境温度的自动空调控制：

climate.your_ac_entity_id: bind_sensor: sensor.temperature_entity,sensor.humidity_entity

场景三：安防联动

将小米摄像头与门窗传感器联动，实现智能安防：

automation: - alias: "门窗异常时录制视频" trigger: - platform: state entity_id: binary_sensor.door_window_sensor to: 'on' action: - service: xiaomi_miot.set_property data: entity_id: camera.xiaomi_camera field: camera_control.on value: true

避开常见坑点的实用建议⚠️

1. 网络配置问题

确保HomeAssistant与小米设备在同一局域网段
对于需要本地连接的设备，避免使用VLAN隔离
如果遇到连接问题，可以尝试在路由器中设置静态IP

2. 设备兼容性检查

虽然插件支持大部分小米设备，但仍有少数设备由于协议限制无法实时监听事件，如：

无线开关（如lumi.sensor_switch.v1）
人体传感器（如lumi.sensor_motion.v1）
门窗传感器（如lumi.sensor_magnet.v1）

3. 性能优化

对于设备数量较多的场景，适当调整轮询间隔
使用chunk_properties参数批量获取设备属性，减少请求次数
定期清理不需要的实体属性，避免数据库膨胀

深度调试：当设备不工作时🔍

启用详细日志

在configuration.yaml中添加以下配置，获取详细的调试信息：

logger: default: warning logs: custom_components.xiaomi_miot: debug

使用服务调试

HomeAssistant提供了丰富的服务用于设备调试：

# 获取设备属性 service: xiaomi_miot.get_properties data: entity_id: camera.xiaomi_camera mapping: - siid: 2 piid: 1 - siid: 3 piid: 2 update_entity: true # 调用设备动作 service: xiaomi_miot.call_action data: entity_id: vacuum.xiaomi_vacuum siid: 4 aiid: 1 params: - 18