普通Tuya开关秒变Zigbee遥控器:tuya-zigbee-switch绑定控制与群组玩法详解

原创2026-11-02 15:43:201,428 阅读

普通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 键开关。

Moes四键开关模块拆机前的正面照片

三、两种刷机方式:无线 OTA 优先

方式一:无线 OTA 升级(推荐,仅限 Telink 设备)

全程不需要拆机、不需要任何硬件,只需在 Zigbee2MQTT 中配置自定义 OTA 索引并安装外部 converter:

  1. 在 Z2M 设置 OTA 索引指向项目提供的 index_router.json 或 index_end_device.json(文件位于 zigbee2mqtt/ota/);
  2. 下载 zigbee2mqtt/converters/ 中的 switch_custom.js 与 tuya_with_ota.js 放入 external_converters/;
  3. 重启 Z2M,找到设备点击"Check for updates"开始升级;
  4. 升级完成后重新 Interview(i)+ Reconfigure(🗘)。

Zigbee2MQTT的configuration.yaml配置OTA索引与外部converter

详细步骤见 docs/updating.md,注意:配对时信号要足够强,建议先把设备移到协调器附近再刷。

方式二:有线刷机(Silabs 设备必选 / 救砖方案)

Silabs 芯片设备(如 SONOFF ZBMINIL2)无法无线转换,需要 UART 烧录器 + 电烙铁。以 TS0012 为例,需焊接 3.3V、GND、SWS、RESET 四根线:

TS0012模块UART接线图:3.3V、RESET、SWS、GROUND

接线后使用 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 灯泡:

  1. 在 Z2M 中选择你的开关,进入绑定(bindings)界面;
  2. 将开关的端点 2 绑定到灯泡的端点 1,选择 OnOff 集群(如需调光可再加 LevelControl);
  3. 完成后按第二键,灯泡即被直接控制——即使协调器离线也能工作,这就是 Zigbee 绑定去中心化的魅力。

端点分配与绑定的完整文档见 docs/usage/endpoints.md。

五、核心玩法二:Zigbee 群组,一个按键控全屋 💡

绑定是"一对一",**群组(Group)**则是"一对多":把多个设备的端点加入同一个组,控制组名即可同时响应。

典型场景:你有两台双键开关,想把它们的第一个继电器联动起来。由于继电器 1 对应端点 N+1 = 3,只需:

  1. 在 Z2M 的 Groups 页面创建群组(如 TestGroup #1);
  2. 把两台设备的端点 3 分别添加到该群组;
  3. 之后任一设备被组播控制,两个继电器同步动作。

Zigbee2MQTT界面将TS0012开关的端点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,十分钟就能体验"按键直控灯光、断网照常工作"的智能家居自由度。🚀

登录后查看全文
tuya-zigbee-switch