ESP32-HA MCP智能家居网关固件 - 版本发布记录

📋 项目概述

ESP32-HA MCP智能家居网关是基于ESP32开发的多平台智能家居控制系统，支持米家、涂鸦、HomeKit等主流智能家居平台，通过MCP协议实现大模型与物理硬件的深度集成。

📥 固件下载

🚀 最新固件下载地址: https://gitee.com/panzuji/ha-esp32/releases/

📅 当前版本: V1.0.20 (2025年10月1日) 💾 支持设备: ESP32-S3、Xiao-ESP32S3 (Flash >4M) 🔄 更新频率: 每月定期更新

🗂️ 版本一览

🆕 V1.1.4

📌 更新要点（V1.1.4）

• 新增功能：
  • 小程序新增涂鸦平台设备展示功能。
  • 小程序新增网关状态详情显示。
• 性能优化：
  • 提升 MCP Server 接口精准度。
• 问题修复：
  • 修复未绑定音箱模式下 TTS 播放异常问题。
  • 修复部分设备状态显示不正确问题。
  • 修复涂鸦平台设备控制问题（不再强制绑定米家账号）。

ℹ️ 使用须知（V1.1.4）

使用涂鸦设备需绑定涂鸦账号；使用米家设备需绑定米家账号。

📞 技术支持（V1.1.4）

• 微信 / 抖音：yyxbc2010

V1.1.3

📌 更新要点（V1.1.3）

• 新增 MCP Server 接口，支持 Coze、Copilot、Cursor、CLine 等集成 MCP 插件的软件。
• 提高设备在线状态的判断准确性。
• 退出登录时自动清除缓存的设备数据。
• 优化设备控制响应精度。
• 无绑定小爱音箱模式下，可在控制指令中指定具体的小爱设备执行语音播报、设备控制或音乐播放。

🛠️ MCP Server 配置示例

1

{"mcpServers": { "feiyang": { "url": "https://oneapi.sooncore.com/sse?auth=MfDPyOWUSraqHsuH", "disabled": false, "timeout": 60, "type": "sse", "autoApprove": [] } }}

auth 为网关设备密钥。

🗒️ 提示词（无小爱音箱模式）

请把以下内容追加到“小智”角色描述底部：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 设备控制规则

（一）直接调用平台接口方式控制
必须按以下三步操作：

调用 get_device_list 获取设备列表，找到要控制的设备。
调用 get_device_specs 获取设备规格书，学习控制方法。
控制设备，按设备平台选择以下一种操作方式控制：
设置设备 property，调用 set_device_property；
获取设备 property，调用 get_device_property；
执行设备 action，调用 execute_device_action。

（二）智能场景控制
先获取智能场景列表；
执行场景。

（三）让小爱同学 TTS
调用 get_device_list 获取设备列表，找到要控制的设备。
调用 TTS 作语音播报。

（四）让小爱同学播放音乐、讲故事
调用 get_device_list 获取设备列表，找到要控制的设备。
调用 xiaoai_play_music 作语音播报。

（五）让小爱同学转发指令控制设备
调用 get_device_list 获取设备列表，找到小爱音箱和要控制的设备。
调用 control_xiaomi_device_by_xiaoai 转发控制指令。

V1.1.1

📌 更新要点（V1.1.1）

• Web 前端新增涂鸦平台授权与设备导入。
• 支持涂鸦平台设备控制。
• 升级后需要重新绑定米家与涂鸦平台账号，并导入设备列表至飞阳网关。
• 无小爱音箱模式需要在“小智”角色中补充提示词。

🗒️ 小智角色提示词

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

设备控制：
- 第一步调用 get_device_list 获取设备列表，找到要控制的设备。
- 第二步控制设备，按设备平台选择以下的一种操作方式：
  - 请小爱同学转发指令，调用 control_xiaomi_device_by_xiaoai；
  - 设置设备 property，调用 set_device_property；
  - 执行设备 action，调用 execute_device_action；
  - 注意：后两种操作需要先调用 get_device_specs 学习指定设备的指令集；

智能场景控制：
- 第一步，先获取智能场景列表；
- 第二步，执行场景；

让小爱同学 TTS：
- 第一步调用 get_device_list 获取设备列表，找到要控制的设备。
- 第二步调用 TTS 作语音播报。

让小爱同学播放音乐、讲故事：
- 第一步调用 get_device_list 获取设备列表，找到要控制的设备。
- 第二步调用作语音播报 xiaoai_play_music。

V1.0.25

📌 更新要点（V1.0.25）

• 修复多项已知问题，提升系统稳定性。
• 支持无小爱音箱控制设备模式。
• 支持查询设备状态。
• 升级后需重新绑定米家账号，并导入设备列表至飞阳网关。

V1.0.24

📌 更新要点（V1.0.24）

• 支持小智让小爱同学播放音乐或讲故事。
• 优化设备控制指令。
• 支持多家庭与多设备（已验证 212 个设备）。

🚀 V1.0.20 - 2025年7月6日

🔥 主要特性：开放API生态与Coze平台集成

🌐 云平台更新

• 飞阳智控云平台开放网关HTTP接口
  • 第三方应用可通过接口控制网关下的设备
  • 📖 接口文档: https://oneapi.sooncore.com/openapi/

🤖 Coze平台集成

• 飞阳MCP网关插件正式上线
  • 🔗 插件地址: https://www.coze.cn/store/plugin/7523201219662184483

🐛 网关固件更新

• 修复已知Bug，提升系统稳定性

📝 版本历史

🎯 V1.0.18 - 2025年6月26日

主要特性：六路物理开关控制系统

• 6路物理开关控制系统
• 硬件/软件双模式支持
• 86型开关一体化设计

🎯 V1.0.17 - 2025年6月中旬

主要特性：基础开关控制框架

• 基础开关控制实现
• MQTT控制接口
• WiFi配网功能

🎯 V1.0.15 - 2025年5月

主要特性：米家平台深度集成

• 支持小爱音箱设备控制指令
• TTS语音播报功能
• MCP协议支持
• 微信小程序配置端
• 支持35款小爱音箱型号

📋 技术支持

• 👨‍💻 技术支持：yyxcb2010
• 📅 文档版本：V1.0.20-2025.07.06
• 🔄 更新频率：每月定期更新
• 🐛 问题反馈：GitHub Issues / 微信群