Shelly HomeKit固件中SP1门磁传感器状态异常问题分析与解决方案

问题背景

在使用Shelly HomeKit固件的SP1智能开关控制车库门时，用户反馈当车库门关闭时，HomeKit显示"blocked"状态而非预期的"closed"状态。该问题发生在仅使用附加模块(Addon)连接单门磁传感器的配置下，而在Shelly官方固件和HomeAssistant中相同配置工作正常。

技术分析

通过开发者与用户的交流，发现问题的核心在于固件对门磁传感器输入信号的处理逻辑：

1. 硬件连接差异：

   • 标准方案建议将关门传感器连接至SW输入端口
   • 用户因使用230V电压的特殊配置，只能将传感器连接至Addon端口

2. 固件逻辑差异：

   • Shelly官方固件采用"单传感器逻辑"：仅检测关门状态，未关门即视为开门
   • HomeKit固件默认采用"双传感器逻辑"：需要独立检测开门和关门两种状态

3. 状态机设计：

   • 当只使用关门传感器时，固件无法准确判断开门状态
   • 超时机制会导致状态显示为"stopped"(Web界面)和"blocked"(HomeKit)

解决方案

开发者提供了定制固件版本，通过以下方式解决问题：

1. 输入信号交换功能：

   • 新增sensor_swap配置参数
   • 允许将Addon端口的传感器信号映射为SW输入

2. 配置方法：

   curl http://设备IP/rpc/Config.Set -d '{"config": {"gdo1": {"sensor_swap": true}}}'
   curl http://设备IP/rpc/Config.Save
   

3. 使用建议：

   • 在Web界面中禁用开门传感器检测
   • 正确设置传感器类型(normally Open/Closed)
   • 配置合适的超时时间

经验总结

1. 在高压(230V)应用场景下，Addon端口传感器连接是合理选择

2. 固件应提供更灵活的传感器配置选项，包括：

   • 独立启用/禁用开门/关门传感器
   • 传感器连接端口选择(SW/Addon)
   • 输入信号反转选项

3. 对于终端用户：

   • 注意Web界面与API参数名称的一致性(如gdo1 vs gdo)
   • 配置变更后建议重启设备确保生效

该问题的解决体现了开源固件灵活适应特殊使用场景的优势，同时也展示了完善配置界面对用户体验的重要性。未来版本有望将这些高级配置选项集成到Web界面中，降低用户配置难度。