3分钟快速上手：hass-xiaomi-miot 完整教程，让小米智能设备无缝接入 HomeAssistant

3分钟快速上手：hass-xiaomi-miot 完整教程，让小米智能设备无缝接入 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

hass-xiaomi-miot 是一个强大的 HomeAssistant 集成，通过小米 MIOT 协议自动将各类小米智能设备接入您的智能家居系统。无论是 Wi-Fi、BLE 还是 ZigBee 设备，这个集成都能提供完整的自动化支持，让您无需编写复杂的 YAML 配置即可享受小米生态链带来的便利。

📦 核心优势：为什么选择 hass-xiaomi-miot

🚀 快速安装指南

方法一：通过 HACS 安装（推荐）

HACS（Home Assistant Community Store）是最简单的安装方式：

1. 打开 HomeAssistant 的 HACS 集成页面
2. 点击"浏览并下载存储库"
3. 搜索"Xiaomi Miot Auto"
4. 点击下载并等待安装完成
5. 重启 HomeAssistant 服务

方法二：手动安装

如果您更喜欢手动控制，可以使用以下命令：

cd /config/custom_components git clone https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot xiaomi_miot

方法三：一键脚本安装

通过 SSH 或终端执行：

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

🔧 配置与设备添加

添加设备方式对比

连接模式选择

在添加集成时，您可以选择三种连接模式：

• 自动模式：组件会智能选择最优连接方式
• 本地模式：仅限局域网设备，响应速度最快
• 云端模式：支持远程访问，适合不在同一网络的设备

小米云配置

对于通过主机/令牌集成的设备，可以配置小米云服务：

# configuration.yaml xiaomi_miot: username: xiaomi_username password: xiaomi_password server_country: cn # 可选：cn(默认), de, i2, ru, sg, tw, us http_timeout: 15 # API 请求超时时间（秒）

🏠 实战应用场景

智能回家场景

当您回家时，自动执行一系列智能操作：

alias: 智能回家模式 trigger: - platform: state entity_id: binary_sensor.door_sensor to: 'on' condition: - condition: state entity_id: device_tracker.your_phone state: 'home' action: - service: light.turn_on target: entity_id: light.living_room - service: climate.set_temperature target: entity_id: climate.air_conditioner data: temperature: 24 - service: media_player.volume_set target: entity_id: media_player.xiaoai_speaker data: volume_level: 0.3

安防监控系统

利用小米摄像头和传感器构建智能安防：

1. 移动检测：摄像头检测到移动时自动录像并发送通知
2. 门窗监控：门窗传感器触发时开启灯光并录制视频
3. 离家模式：手机离开家时自动启动安防监控

设备自定义配置

您可以通过 YAML 配置文件深度定制设备行为：

# 设备级自定义 xiaomi_miot: device_customizes: chuangmi.plug.212a01: miot_local: true chunk_properties: 7 # 实体级自定义 homeassistant: customize: light.bedroom_light: miot_cloud: true yeelight_smooth_on: 2000 climate.bedroom_ac: bind_sensor: sensor.temperature_entity,sensor.humidity_entity

⚙️ 核心服务调用

设置设备属性

service: xiaomi_miot.set_property data: entity_id: camera.living_room field: camera_control.on value: true

执行设备动作

service: xiaomi_miot.call_action data: entity_id: vacuum.cleaner siid: 4 aiid: 1 params: - 18 - '{"selects":[[7,1,0,2,1]]}'

小爱音箱控制

service: xiaomi_miot.intelligent_speaker data: entity_id: media_player.xiaoai_lx04_xxxx text: 打开客厅的灯 execute: true silent: true

📊 支持的设备类型

hass-xiaomi-miot 支持丰富的设备类型：

核心模块解析

项目的核心功能集中在custom_components/xiaomi_miot/core/目录：

• miot_spec.py- MIOT 协议解析核心，处理设备通信
• device.py- 设备管理模块，统一设备接口
• coordinator.py- 数据协调器，管理设备状态更新
• xiaomi_cloud.py- 云端服务接口，处理远程连接

🔍 常见问题排查

设备无法连接

1. 网络检查：确保设备与 HomeAssistant 在同一网络
2. 协议支持：确认设备支持 MIOT 协议
3. 账号权限：验证小米账号密码是否正确
4. 防火墙设置：检查防火墙是否阻止了相关端口

状态更新延迟

1. 调整轮询间隔：

   domain.your_entity_id_xxxx: interval_seconds: 30

2. 启用本地模式：减少云端延迟

3. 网络优化：检查网络带宽和稳定性

实体属性过多

通过配置过滤不必要的属性：

xiaomi_miot: exclude_state_attributes: - miot_type - stream_address - motion_video_latest

获取调试日志

启用详细日志记录：

# configuration.yaml logger: default: warning logs: custom_components.xiaomi_miot: debug

🛠️ 高级技巧

多语言支持

xiaomi_miot: language: zh # 使用内置字典，目前仅支持 `zh` translations: idle: '空闲' busy: '工作中' fan.mode: straight wind: '直吹模式' natural wind: '自然风'

配置热重载

无需重启 HomeAssistant 即可应用配置更改：

1. 进入开发者工具 > YAML 配置重载
2. 查找"Xiaomi Miot"
3. 点击重载配置

获取设备令牌

1. 使用 HomeAssistant 服务工具
2. 选择xiaomi_miot.get_token服务
3. 输入设备名称关键词
4. 从通知中查找令牌

🎯 总结

hass-xiaomi-miot 集成为小米智能设备接入 HomeAssistant 提供了最便捷、最完整的解决方案。无论您是智能家居新手还是经验丰富的用户，都能在几分钟内完成配置，享受自动化带来的便利。

通过本文的指南，您应该已经掌握了从安装、配置到高级使用的全部技巧。现在就开始您的智能家居之旅，让小米设备与 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