普通Tuya开关秒变Zigbee遥控器:tuya-zigbee-switch绑定控制与群组玩法详解
普通Tuya开关秒变Zigbee遥控器:tuya-zigbee-switch绑定控制与群组玩法详解
tuya-zigbee-switch 是一款面向 Telink/Silabs 芯片 Tuya Zigbee 开关、模块和插座的开源定制固件,已支持 160+ 款设备。它最大的价值是让廉价的 Tuya 开关突破原厂限制:支持**设备绑定(Binding)**直接遥控 Zigbee 灯具,支持加入 **Zigbee 群组(Group)**一键控制多灯,还具备超长按键、动作模式、Router/EndDevice 双模式等高级玩法。本文带你从刷机到绑定、群组,一步步把普通 Tuya 开关变成智能家居里的"万能遥控器"。
一、为什么原厂固件不够用?🤔
市面上大多数便宜的 Tuya Zigbee 开关,出厂固件存在两大硬伤:
- 无法绑定控制其他设备:按钮只控制自家继电器,想当遥控器控制灯泡?原厂不行;
- 按键冲突 Bug:快速连按时会"吞"掉其他按键输入,同时按两个按钮甚至只切换一个继电器。
tuya-zigbee-switch 定制固件针对性解决了这些问题,核心特性包括:
| 特性 | 说明 |
|---|---|
| ⚡ 毫秒级响应 | 可自由选择"按下/松开"哪个时刻触发动作 |
| 📡 出向绑定(Outgoing binds) | 直接通过 Zigbee 遥控其他设备,控制开关状态与亮度 |
| 🔗 分离模式 | 开关与继电器解耦,按键纯粹当遥控器 |
| 🎛️ 自定义动作模式 | toggle / momentary NO / momentary NC 全支持 |
| ⏱️ 长按配置 | 可自定义长按动作与时长 |
| 🔋 Router / EndDevice 双模式 | 无零线(no-Neutral)设备也能稳定工作 |
| 📶 无线 OTA | 从原厂固件即可无线转换到定制固件 |
完整功能与更新记录可参考 readme.md 和 docs/changelog_fw.md。
二、刷机前必做:确认设备是否支持 ✅
刷机第一步是核对设备型号。打开 docs/supported_devices.md,按 Zigbee Manufacturer + Model(例如 TS0001、TS0012)查找你的设备:
- 🟩 绿色 = 完全支持
- 🟨 黄色 = 基本支持(有小问题)
- 🟧 橙色 = 开发中
💡 提示:Z2M 页面信息有时是通用的,建议以 Z2M 日志中显示的真实 Manufacturer 为准。常见推荐选择:AVATTO、Aubess、iHseno 模块,以及 Moes 1-3 键开关。
三、两种刷机方式:无线 OTA 优先
方式一:无线 OTA 升级(推荐,仅限 Telink 设备)
全程不需要拆机、不需要任何硬件,只需在 Zigbee2MQTT 中配置自定义 OTA 索引并安装外部 converter:
- 在 Z2M 设置 OTA 索引指向项目提供的
index_router.json或index_end_device.json(文件位于 zigbee2mqtt/ota/); - 下载 zigbee2mqtt/converters/ 中的
switch_custom.js与tuya_with_ota.js放入external_converters/; - 重启 Z2M,找到设备点击"Check for updates"开始升级;
- 升级完成后重新 Interview(
i)+ Reconfigure(🗘)。
详细步骤见 docs/updating.md,注意:配对时信号要足够强,建议先把设备移到协调器附近再刷。
方式二:有线刷机(Silabs 设备必选 / 救砖方案)
Silabs 芯片设备(如 SONOFF ZBMINIL2)无法无线转换,需要 UART 烧录器 + 电烙铁。以 TS0012 为例,需焊接 3.3V、GND、SWS、RESET 四根线:
接线后使用 pvvx 网页烧录器写入固件即可。完整教程(拆机、焊接、烧录、恢复)见 docs/flashing/telink.md 和 docs/flashing/silabs.md。
⚠️ 安全提醒:拆机前务必断电;L-only(无零线)开关需要足够大的负载(如 10W 以上灯泡)才能稳定工作。
四、核心玩法一:设备绑定,开关变身遥控器 🔗
刷完固件,重头戏来了——把按键绑定到任意 Zigbee 设备。
先搞懂 Endpoint 分配规则
固件为多键设备使用 Zigbee 端点(Endpoint)路由命令,N 键设备使用 2×N 个端点:
- 端点
1 ~ N:OnOff client(输出端),用于绑定出去控制其他设备; - 端点
N+1 ~ 2N:OnOff server(输入端),对应本地继电器状态。
以双键(2-gang)模块为例:
| Endpoint | 类型 | 用途 |
|---|---|---|
| 1 / 2 | OnOff client | 绑定控制其他 Zigbee 设备 |
| 3 / 4 | OnOff server | 控制继电器 1 / 继电器 2 |
实操:双键模块第二键控制智能灯泡
假设你想让第二颗按钮无线控制一盏 Zigbee 灯泡:
- 在 Z2M 中选择你的开关,进入绑定(bindings)界面;
- 将开关的端点 2 绑定到灯泡的端点 1,选择
OnOff集群(如需调光可再加LevelControl); - 完成后按第二键,灯泡即被直接控制——即使协调器离线也能工作,这就是 Zigbee 绑定去中心化的魅力。
端点分配与绑定的完整文档见 docs/usage/endpoints.md。
五、核心玩法二:Zigbee 群组,一个按键控全屋 💡
绑定是"一对一",**群组(Group)**则是"一对多":把多个设备的端点加入同一个组,控制组名即可同时响应。
典型场景:你有两台双键开关,想把它们的第一个继电器联动起来。由于继电器 1 对应端点 N+1 = 3,只需:
- 在 Z2M 的 Groups 页面创建群组(如
TestGroup #1); - 把两台设备的端点 3 分别添加到该群组;
- 之后任一设备被组播控制,两个继电器同步动作。
常见组合玩法:
- 🌙 全屋总控:把卧室、客厅、走廊的灯泡端点 1 加入同一群组,门边开关一键全开全关;
- 🔁 多控开关:楼梯上下两个 Tuya 开关加入同组,实现传统双控;
- 📶 群组 + 绑定:开关 client 端点绑定群组,即可用普通按键遥控整个灯组。
六、进阶技巧:动作模式、长按与设备类型 🎛️
按键行为随心配
固件支持在 Z2M 中为每个按键单独配置:
- Action 模式:
toggle(切换)、on/off、momentary(点动)等,详见 src/zigbee/switch_cluster.c 中的状态机实现; - binded_mode:控制绑定设备的响应策略(随本机状态同步 / 仅按 / 仅长按),适配"墙壁双控"与"遥控器"两种用法;
- 长按自定义:例如短按开关灯、长按调亮度(Level Move),移步速率可调。
开关与继电器解耦(Detached 模式)
把某个按键从本地继电器"解绑"后,它就不再控制自身回路,成为纯粹的 Zigbee 遥控器——这是把墙面开关改造成床头/门边遥控器的关键开关项。
Router 还是 EndDevice?
- Router:响应更快,还能中继信号扩展网络,适合有零线的稳定供电设备;
- EndDevice:功耗更低,适合无零线开关或经常断电的位置。
两者之间可以通过 FORCE 索引无线重装切换,方法见 docs/usage/change_device_type.md。
七、遇到问题?排查清单 🛠️
- 设备不响应 / 不入库:先重启协调器 → 重新下载 converter → Interview + Reconfigure 设备 → 仍不行则重置设备重配;
- 无零线开关频繁掉线:检查负载是否太小(EndDevice 建议 >4W,Router >8W);
- 刷砖了:唯一恢复路径是有线刷机,参考 docs/flashing/;
- 其他高频问题:docs/faq.md 与 docs/known_issues.md。
总结
tuya-zigbee-switch 用一套开源固件,把几十块的 Tuya 开关变成了功能完整的 Zigbee 遥控器:绑定让它直接控制任意 Zigbee 设备,群组让它一键联动全屋灯具,再配合动作模式、长按调光与 Router/EndDevice 切换,玩法几乎不设上限。确认设备在支持列表、刷上固件、配好 converter,十分钟就能体验"按键直控灯光、断网照常工作"的智能家居自由度。🚀



