ESP-HomeKit-Devices项目：Gosund WP2智能插座HAA固件配置指南

设备概述

Gosund WP2是一款基于ESP8266芯片的双路智能插座，可通过HomeKit Accessory Architecture (HAA)固件实现与苹果HomeKit生态系统的兼容。该设备具有两个独立控制的插座，每个插座配有相应的状态指示灯和物理控制按钮。

硬件接口配置

设备采用ESP8266作为主控芯片，各功能引脚分配如下：

• 继电器控制：

  • GPIO14：控制插座1的继电器
  • GPIO12：控制插座2的继电器

• 状态指示灯：

  • GPIO13：插座1的状态LED
  • GPIO2：插座2的状态LED
  • GPIO1：设备状态指示灯(共用)

• 物理按钮：

  • GPIO0：插座1的控制按钮
  • GPIO4：插座2的控制按钮

固件配置脚本解析

针对Gosund WP2设备的HAA固件配置采用了JSON格式的脚本，主要包含以下功能配置：

1. GPIO初始化配置：

   • 继电器控制引脚组(GPIO12和GPIO14)设置为输出模式
   • LED指示灯组(GPIO2、GPIO13和GPIO1)设置为输出模式
   • 按钮输入组(GPIO0和GPIO4)设置为输入模式，并启用内部上拉电阻

2. 设备功能映射：

   • 插座1控制逻辑：
     • 继电器状态与LED状态反向关联
     • 按钮短按切换状态
   • 插座2控制逻辑：
     • 独立控制继电器和LED状态
     • 按钮短按切换状态

3. 特殊功能：

   • 顶部按钮(插座1按钮)长按8秒进入配网模式
   • 设备状态指示灯(GPIO1)用于显示整体工作状态

使用注意事项

1. 刷写固件前，建议先确认设备硬件版本，不同批次可能存在引脚差异
2. 配置脚本中的GPIO分配已经针对WP2型号优化，直接使用即可
3. 进入配网模式时，需长按顶部按钮(插座1按钮)8秒，此时状态指示灯会有特殊闪烁提示
4. 双路插座可独立控制，在HomeKit中会显示为两个独立的开关设备

常见问题解决方案

1. 继电器状态与指示灯不同步：

   • 检查GPIO13和GPIO2的接线是否正常
   • 确认配置脚本中的状态映射关系正确

2. 按钮无响应：

   • 测量按钮引脚电压，确认上拉电阻正常工作
   • 检查GPIO0和GPIO4的配置是否正确

3. 无法进入配网模式：

   • 确保长按时间足够(8秒)
   • 检查GPIO0的按钮功能是否正常

通过以上配置，Gosund WP2智能插座可以完美融入HomeKit生态系统，实现与其他智能设备的联动控制，为用户提供更加便捷的智能家居体验。