Midea Smart Home
[![GitHub Release][releases-shield]][releases] [![GitHub Activity][commits-shield]][commits] [![License][license-shield]](LICENSE) [![hacs][hacsbadge]][hacs]
Home Assistant 美的设备本地控制集成，无需云端即可控制您的智能设备。
获取帮助
- 欢迎加入QQ群交流，获取最新更新和帮助：
功能特点
- 本地控制：设备通过本地网络直接控制，无需依赖云端连接
- 自动下载协议：自动从云端下载设备对应的 Lua 协议脚本（首次配置）
- 灵活配置：支持通过设备映射文件自定义实体属性，方便适配新设备
- 多语言支持：支持中文、英文界面
- 丰富的实体平台：支持 binary_sensor、button、climate、cover、fan、humidifier、light、lock、number、select、sensor、switch、text、time、update、vacuum、water_heater
工作流程
配置阶段
- 用户输入美的账号密码
- 登录美的云端 API
- 从云端获取设备详细信息（设备ID、型号、SN8等）
- 自动下载设备对应的 Lua 协议文件
- 在本地局域网中扫描设备 IP 地址
- 获取设备的 Token 和 Key（仅 V3 协议设备需要，V1/V2 协议设备无需）
- 通过本地网络连接设备
- 使用 Lua 脚本解析设备协议
- 普通设备通过回调推送状态更新，特殊设备（如 0xD9 复式洗衣机）使用定时轮询
- 用户操作直接发送到设备（无需云端）
环境要求
- Home Assistant >= 2025.12.4
安装
一键安装（推荐）
HACS 自定义仓库
- 在 Home Assistant 中打开 HACS
- 进入"集成"
- 点击右上角"+"按钮
- 点击"⚙️ 自定义存储库"（3 点菜单 > 自定义存储库）
- 输入：
https://github.com/Cyborg2017/midea_smart_home - 类别选择：集成
- 点击"添加"
- 搜索"Midea Smart Home"并点击"下载"
手动安装
- 将
custom_components/midea_smart_home目录复制到您的 Home Assistantcustom_components文件夹 - 重启 Home Assistant
- 进入 设置 > 设备与服务
- 点击"添加集成"
- 搜索"Midea Smart Home"
文档
- 📖 配置指南：集成安装、添加设备、选项功能与常见问题的图文教程
- 🤖 借助 AI 适配 / 调试设备指南：想让列表中"⏳ 待支持"的新设备尽快可用，或设备实体缺失、数值异常、Lua 协议解析有问题时，按本指南收集诊断材料并配合 AI 编程助手（Trae、ChatGPT、Claude、Cursor 等）完成适配与调试，内含数据链路说明、
device_mapping配置速查、CI 格式规则和可直接复制的提示词模板
支持的设备
| 序号 | 代码 | 设备类型 | | ----- | ------ | ----------------- | | 1 | 0x13 | 智能灯 / 风扇灯 | | 2 | 0x14 | 电动窗帘 | | 3 | 0x17 | 晾衣架 | | 4 | 0x26 | 浴霸 | | 5 | 0x40 | 凉霸 | | 6 | 0x9B | 烤箱 | | 7 | 0x9C | 集成灶 | | 8 | 0xA1 | 除湿机 | | 9 | 0xAC | 柜式空调 / 壁挂空调 / 中央空调 & 风管机 / 新风 / 迷你新风 | | 10 | 0xAD | 空气魔方（检测仪） | | 11 | 0xB0 | 微波炉 | | 12 | 0xB3 | 消毒柜 | | 13 | 0xB6 | 油烟机 | | 14 | 0xB8 | 扫地机器人 | | 15 | 0xBF | 微蒸烤一体机 | | 16 | 0xC2 | 智能马桶 | | 17 | 0xCA | 多开门冰箱 | | 18 | 0xCC | Wifi线控器 (中央空调 / 风管机) | | 19 | 0xCD | 空气能热水器 | | 20 | 0xCE | 新风 | | 21 | 0xCF | 中央空调(水力) | | 22 | 0xD9 | 复式洗衣机 (左右双筒 / 上下双筒) | | 23 | 0xDA | 波轮洗衣机 | | 24 | 0xDB | 滚筒洗衣机 | | 25 | 0xDC | 干衣机 | | 26 | 0xE1 | 洗碗机 | | 27 | 0xE2 | 电热水器 | | 28 | 0xE3 | 燃气热水器 | | 29 | 0xE6 | 壁挂炉 | | 30 | 0xEA | 电饭煲 | | 31 | 0xEC | 电压力锅 | | 32 | 0xED | 净饮机 / 净水机 / 管线机 / 软水机 / 前置过滤器 | | 33 | 0xF1 | 破壁机 | | 34 | 0xFA | 风扇 | | 35 | 0xFB | 取暖器 | | 36 | 0xFC | 空气净化器 | | 37 | 0xFD | 加湿器 |
其他类型的设备正在适配中，欢迎贡献代码！
V2 0x0110 新协议设备说明
⚠️ 部分搭载新固件的美的设备在局域网发现阶段使用 V2 0x0110 新协议进行广播应答。集成目前可以识别并解析这类设备的基本信息（设备名称、型号、IP 地址等），但尚无法与其建立 TCP 通信，因此暂时无法本地控制。在配置向导的设备发现列表中，这类设备会被标记为 [不支持]，添加时可以跳过。
当前已发现使用 V2 0x0110 新协议的设备型号：
| 设备名称 | 设备类型 | 设备型号 | | -------- | -------- | -------- | | 华凌 神机二代Pro(部分批次) | 空调 | KFR-35G/N8HE1 II Pro | | 美的 小西梅 PRO（X7） | 油烟机 | CXW-140-AK11 PRO | | 美的 蒸汽洗 AK7 MAX | 油烟机 | CXW-140-AK7 MAX | | 美的 无冷感 M10S Ultra | 燃气热水器 | JSLQ27-M10S Ultra | | COLMO 净矿厨下净水机 | 净水器 | CWRCM1000-A1 |
新协议的适配正在研究中。如果您的设备也在上表中，或发现其他无法控制的设备，欢迎提交 Issue 并附上设备信息。
致谢
本项目参考/使用了以下项目的部分代码：
[commits-shield]: https://img.shields.io/github/commit-activity/y/Cyborg2017/midea_smart_home.svg?style=for-the-badge [commits]: https://github.com/Cyborg2017/midea_smart_home/commits/main [hacs]: https://github.com/hacs/integration [hacsbadge]: https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge [license-shield]: https://img.shields.io/github/license/Cyborg2017/midea_smart_home.svg?style=for-the-badge [releases-shield]: https://img.shields.io/github/release/Cyborg2017/midea_smart_home.svg?style=for-the-badge [releases]: https://github.com/Cyborg2017/midea_smart_home/releases