外观
Shelly Gen3 与 Plus / Pro 系列
Shelly 的 Plus / Pro（Gen2）、Gen3、Gen4 设备都采用乐鑫芯片，并共用 Gen2+ 的 RPC 本地接口。本文说明各代的芯片、本地控制方式，以及改刷 ESPHome 的现状与风险。
市电危险
影响范围：Shelly 设备安装在墙盒内，直接连接市电。拆开、接线、串口刷机都存在触电与火灾风险；刷错分区表或固件可能使设备变砖，且位于墙内的设备不易取回。 前置条件：只在断电并取出设备的情况下使用 UART 刷机，用独立的 3.3 V 适配器，不要同时接市电与电脑；具有电气资质的人员操作；先备份 Flash。 回退：多数情况下可用串口刷回官方固件，但官方镜像是否公开下载、能否恢复校准数据（电能计量校准）并不确定；校准数据丢失会让电能读数不准，需要预先备份。触电与烧毁不可回退。
规格
| 世代 | 代表型号 | 芯片 |
|---|---|---|
| Gen2 / Plus | Plus 1、Plus 1PM、Plus 2PM | ESP32-U4WDH，4 MB 内置 Flash；ESPHome 数据库提示新硬件版本（如 Plus 1PM 2026 年的 PCB 0.2.0）改为双核 240 MHz |
| Gen2 部分型号 | Plus 1 Mini | ESP32-C3 |
| Gen3 | 1 Gen3、2PM Gen3 等 | Shelly 定制 ESP-Shelly-C38F（官方称 8 MB Flash），ESPHome 配置按 ESP32-C3 |
| Gen4 | 1 Gen4、1PM Gen4、2PM Gen4、Plug US Gen4、EM Mini Gen4 | ESP-Shelly-C68F，ESPHome 描述为 ESP32-C6 变体，8 MB Flash |
时间线：Gen3 在 2024 年 1 月的 CES 前后发布，官方称 Gen3 设备可升级到 Matter；Gen4 的具体发布时间本次未核实。
亮点
- 开箱即用本地控制：HTTP / WebSocket / MQTT / UDP / BLE RPC，另支持 Webhook、脚本与 KNX（部分固件）
- Gen3 增加虚拟组件，2PM Gen3 在 1.6.1 固件加入 Matter 窗帘支持（官方更新日志）
- ESPHome 设备库已经收录大量 Plus、Gen3、Gen4 型号
能拿来做什么
- 墙盒内的灯光与窗帘控制：见 智能家居
- 电能计量，如 2PM Gen3 使用 ADE7953 计量芯片（ESPHome 配置显示）
- Home Assistant 官方集成直接发现
开发方式
本地 API：RPC 形式为 http://设备IP/rpc/组件.方法?id=0&参数=值，通道从 0 开始计数；Gen3 / Gen4 与 Gen2 使用同一套 RPC 文档。刷 ESPHome：
- Gen2：有 shelly2esphome 之类的 OTA 转换流程，也可以走 UART。
- Gen3：ESPHome 文档说明需要串口刷入，配置用
esp32c3，Flash 8 MB。 - Gen4：社区项目 shelly-gen4-esphome 可通过原厂 Web UI 安装 ESPHome，也支持 UART；Shelly 的分区表位于 0x10000 而不是 ESP-IDF 默认的 0x8000，这是容易出错的地方。该项目与 shelly2esphome 都声明 Gen3 / Gen4 配置未在所有实机上验证。
- Tasmota：2024 年 11 月出现 2PM Gen3 的模板，但官方支持程度以 Tasmota 文档为准。
- 工具和流程见 烧录工具。
同类对比
| 方案 | 特点 | 代价 |
|---|---|---|
| Shelly Gen3 / Gen4 | 本地 API 完整，计量好 | 价格较高；改刷需要串口 |
| SONOFF | 便宜，型号多 | 本地能力依赖刷机或 DIY 模式 |
| 自制 ESPHome 继电器 | 完全自定义 | 电气安全责任自负 |
注意事项
- 同一型号会在不同硬件版本之间换芯片或 PCB，按实际版本选择配置。
- Gen4 的 ESP32-C6 支持 Thread，但 Shelly 官方固件目前不支持 Thread；有用户在 ESPHome 下可以在 Thread 与 WLAN 之间切换，属于社区经验，未经过本手册验证。
- Gen3 的 1 Gen3 在社区里反馈过引脚与预期不符（按键、开关 GPIO 不同），照搬别人的配置前先核对。
- 刷第三方固件会失去官方云与保修，请自行评估。