ESP32-based smart home control system that allows AI models to directly control your Mi speakers and smart devices!

🔌 The FeiYang Smart Control Cloud Platform offers comprehensive open API capabilities, enabling secure communication with smart gateway devices through standardized HTTPS protocols. This document elaborates on interface protocol specifications, API definitions, and typical application scenarios, helping developers quickly integrate FeiYang smart home solutions.

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中的宏定义：