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

📋 项目概述

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

📥 固件下载

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

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

📝 更新日志

🚀 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型开关的一体化设计。支持小程序远程控制与物理按键本地操作，提供统一的状态管理和事件响应机制。

🔄 双模式运行支持

固件提供两种运行模式，通过HARDWARE_MODE宏定义切换：

1. 硬件模式 (HARDWARE_MODE=1)

• 特点：实际控制全部物理GPIO
• 场景：生产环境部署
• 功能：
  • 物理按键实时响应
  • 继电器实际开关控制
  • LED指示灯实时反馈
  • 所有GPIO真实工作

2. 软件虚拟模式 (HARDWARE_MODE=0)

• 特点：仅LED使用实际GPIO，其他状态虚拟化
• 场景：开发测试环境
• 功能：
  • 内存模拟开关状态
  • 保持与硬件模式完全一致的逻辑
  • 支持小程序远程控制
  • LED指示灯保持实际控制

🔌 GPIO映射关系

💻 核心功能

双向控制系统

• 本地控制：物理按键直接切换状态
• 远程控制：小程序通过MQTT控制
• 状态同步：物理状态与应用界面实时同步

按键机制与安全保护

• 单击功能：切换对应继电器状态
• 长按功能：按住5秒触发配网模式
• 安全机制：长按期间锁定远程控制

🔄 使用指南

操作说明

• 按键操作：单击切换状态，长按5秒配网
• 远程控制：小程序实时控制与状态显示
• 切换模式：修改HARDWARE_MODE宏后重编译

硬件连接

• 按键接法：GPIO接VCC，使用上拉电阻
• 继电器：光耦隔离，默认低电平(关闭)
• LED灯：GPIO2控制(低电平点亮)

注意事项

• 硬件模式需接全部GPIO，软件模式仅需LED接口
• 上电默认所有继电器关闭状态
• 电源要求：5V 2A以上稳定电源
• 软件模式下状态变化同样触发MQTT消息

🛠️ 技术参数

按键与继电器配置

模式切换

修改feiyangkeji.cpp中的宏定义：

// 硬件模式(完整GPIO控制)
#define HARDWARE_MODE 1

// 软件模式(仅LED实际控制)
// #define HARDWARE_MODE 0

📝 版本历史

🎯 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 / 微信群