Shelly HomeKit 固件升级问题排查指南

问题概述

在将 Shelly 设备升级至支持 HomeKit 的固件版本时，用户常遇到设备无法被发现或固件更新失败的问题。本文针对 Shelly Plus 系列设备（如 Plus 1 和 Plus i4）的固件升级过程提供详细的技术指导。

关键问题分析

1. 设备发现失败：Python 脚本无法在网络上发现 Shelly 设备，但路由器界面可见
2. 固件更新无效：通过 Web 界面或浏览器直接访问更新 URL 无响应
3. 版本兼容性问题：不同固件版本间的升级路径存在限制

解决方案

准备工作

1. 确认设备当前固件版本：通过 Shelly 设备的 Web 界面查看当前运行的固件版本
2. 升级至最新官方固件：确保设备已升级到 Shelly 官方提供的最新稳定版固件（如 1.3.X 版本）

推荐升级方法

方法一：Web 界面直接上传（推荐）

1. 下载对应设备型号的完整固件 ZIP 包（如 shelly-homekit-ShellyPlusI4.zip）
2. 通过设备 Web 界面的"固件更新"功能直接上传 ZIP 文件
3. 注意：不要解压 ZIP 文件，直接上传压缩包

方法二：Python 脚本升级

1. 确保设备与运行脚本的计算机在同一网络段
2. 检查网络安全设置，确保允许设备发现通信
3. 使用最新版本的升级脚本

常见问题解答

Q：为什么 URL 更新方式无效？

A：某些设备型号和固件版本不支持通过 URL 直接更新，特别是较新的设备需要完整的固件包上传。

Q：Safari 浏览器下载后自动解压怎么办？

A：在 Safari 中右键点击下载链接，选择"下载链接文件"而非直接打开，或使用其他浏览器下载完整 ZIP 包。

Q：升级后设备无响应怎么办？

A：尝试设备硬件复位（通常通过长按设备按钮），然后重新进行固件升级流程。

技术建议

1. 对于 Plus 系列设备，建议使用 2.12.0-beta2 或更高版本的 HomeKit 固件
2. 升级过程中保持设备供电稳定
3. 升级完成后，建议清除浏览器缓存再访问设备 Web 界面

注意事项

1. 固件升级有一定风险，请确保操作过程谨慎
2. 重要设备建议在非高峰时段进行升级
3. 升级前记录设备原有配置，以防需要恢复

通过遵循以上指南，大多数 Shelly 设备应能顺利完成 HomeKit 固件的升级。如遇特殊问题，建议查阅设备专属的技术文档或寻求社区支持。