ha-esp32 发行版

最新版

v1.1.6

dc2e6bd

2025-11-19 22:12

v1.1.6

最后提交信息为：优化 README.md 中的核心功能描述，增强平台集成和控制模式部分的清晰度

预览版本

v1.1.4

dc2e6bd

2025-10-28 08:53

v1.1.4

最后提交信息为：优化 README.md 中的核心功能描述，增强平台集成和控制模式部分的清晰度

预览版本

v1.1.3

0137f0e

2025-10-16 08:25

v1.1.3

飞阳网关1.1.3 更新说明：
1. 网关新增 MCP  server接口，支持 Coze、Copilot、Cursor、CLine 等集成 MCP 插件的软件。MCP server 配置如下，其中auth=网关设备密钥
` {"mcpServers": {
      "feiyang": {
      "url": "https://oneapi.sooncore.com/sse?auth=MfDPyOWUSraqHsuH",
      "disabled": false,
      "timeout": 60,
      "type": "sse",
      "autoApprove": []
    }
}}`
2. 提高了设备在线状态的判断准确性。
3. 退出登录时，将自动清除缓存的设备数据。
4. 优化了设备控制的响应精度。
5. 在未绑定小爱音箱的模式下，若存在多个小爱音箱，可在控制指令中指定一个小爱进行语音播报、设备控制或音乐播放。
6. 无绑定小爱音箱模式，请在小智角色描述里更新以下提示词，放在现有提示词最下面即可：

`# 设备控制规则
## （一）直接调用平台接口方式控制
必须按以下三步操作：
1. 调用 `get_device_list` 获取设备列表，找到要控制的设备。
2. 调用 `get_device_specs` 获取设备规格书，学习控制方法。
3. 控制设备，按设备平台选择以下一种操作方式控制：
- 设置设备 property，调用 `set_device_property`；
- 获取设备 property，调用 `get_device_property`；
- 执行设备 action，调用 `execute_device_action`。

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

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

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

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

最后提交信息为： update README.md.

预览版本

v1.1.1

0137f0e

2025-10-01 09:04

v1.1.1

最后提交信息为： update README.md.

预览版本

v1.0.25

0137f0e

2025-09-13 22:42

v1.0.25

最后提交信息为： update README.md.

预览版本

v1.0.20

c95f01a

2025-07-06 00:31

v1.0.20

最后提交信息为： update README.md.

预览版本

v1.0.18

0d8957c

2025-06-26 12:00

v1.0.18

# ESP32-HA MCP智能家居网关 V1.0.18 版本发布说明

## 📢 版本亮点：六路物理开关控制系统

本次更新集成了6路开关功能、状态指示灯及配网按钮，实现网关与86型开关的一体化设计。支持小程序远程控制与物理按键本地操作，提供统一的状态管理和事件响应机制。

### 版本信息

- **版本号**：V1.0.18
- **发布日期**：2025年6月26日

## 🔄 双模式运行支持

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

### 1. 硬件模式 (HARDWARE_MODE=1)

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

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

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

## 🔌 GPIO映射关系

| 功能 | 按键GPIO | 继电器GPIO | 功能说明 |
|-----|---------|-----------|---------|
| 开关1 | GPIO34 | GPIO16 | 单击切换/长按配网 |
| 开关2 | GPIO35 | GPIO17 | 单击切换/长按配网 |
| 开关3 | GPIO36 | GPIO18 | 单击切换/长按配网 |
| 开关4 | GPIO39 | GPIO19 | 单击切换/长按配网 |
| 开关5 | GPIO5  | GPIO23 | 单击切换/长按配网 |
| 开关6 | GPIO33 | GPIO22 | 单击切换/长按配网 |
| LED灯 | 无     | GPIO2  | 小程序控制，两模式均支持 |

## 💻 核心功能

### 双向控制系统

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

### 按键机制与安全保护

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

## 🔄 使用指南

### 操作说明

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

### 硬件连接

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

### 注意事项

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

## 🛠️ 技术参数

### 按键与继电器配置

| 参数 | 数值 | 功能 |
|-----|------|-----|
| 消抖时间 | 80ms | 过滤按键抖动 |
| 单击判定 | 500ms | 短按触发阈值 |
| 配网触发 | 5000ms | 长按触发配网 |
| 继电器逻辑 | HIGH=开/LOW=关 | 状态自动同步至云端 |

### 模式切换

修改`feiyangkeji.cpp`中的宏定义：

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

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

## 📝 更新日志

### V1.0.18 (当前版本)

- 6路物理开关控制系统完整实现
- 硬件/软件双模式支持
- 状态同步与按键响应优化
- 开发测试环境适配增强

### V1.0.17

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

---

## 📋 开发规划

- 场景联动
- 自动化触发
- 功耗优化
- 状态持久化
- 定时控制
- 传感器扩展
- 接入涂鸦、homekit

**技术支持**：yyxcb2010
**文档版本**：V1.0.18-2025.06.26

最后提交信息为：修改项目描述

预览版本

v1.0.15

e373c49

2025-06-15 16:50

v1.0.15

最后提交信息为：发布构建版本release 1.0.15

panzuji/ha-esp32 .gitee-modal { width: 500px !important; }

搜索帮助

panzuji/ha-esp32