🔓 Custom firmware for Tuya Zigbee switches

Feature-rich custom firmware for Telink/Silabs Zigbee switches, modules, sockets

• Already 60+ supported_devices.md
• Port new devices: contribute/porting.md

🤔 Why?

The main driver for this project was a frustrating bug in the factory firmware:

When you pressed one button, the device shortly ignored input from the others.
As a result, simultaneously pressing two buttons toggled a single relay.

Users also consider this the missing piece of a reliable smart home, because it allows using a light switch as a Zigbee remote.

Most cheap switches on the market don't allow binding to other devices out-of-the-box.

✨ Features

Already implemented

• Super fast reaction time (choose action moment: press / release)
• Detached mode (unlink switch and relay)
• Outgoing binds (remotely control Zigbee lights - state & brightness)
• Supports all button types: toggle, momentary NO, momentary NC
• Configurable Long press for push-switches (action & duration)
• Custom switch action modes (sync: switch position - relay state - bound devices)
• Both Router & EndDevice modes for no-Neutral devices
• Power-on behavior (on, off, previous, toggle)
• Wireless flashing and updating (OTA from original fw, further OTA updates)
• Multiple reset options (10x switch press, on-board button)

Work in progress

• Wireless switches (battery-powered remotes)
• FW-level multi-press (double or triple click)
• Countdown timers (on_with_timed_off)
• Inching (pulse relay output)
• Scenes (send and receive)
• Power monitoring
• Touchlink
• Integrate converters with Z2M

📲 Installation

If your device is already on supported_devices.md, the firmware can be installed:

• wirelessly on Z2M / ZHA (only Telink devices): updating.md
• by wire: flashing/

Otherwise, check contribute/porting.md.

📑 Documentation

Information and diagrams are available in docs/

Some quick links:

• ❓ faq.md ⬅ Troubleshoot
• 🚨 ️known_issues.md
• 📝 changelog_fw.md
• 🛠️ contribute/
• ⚙️ usage/
  • endpoints.md
  • change_device_type.md

💬 Chat

Discuss, troubleshoot and follow the updates on Discord 🙂

🙏 Acknowledgements

• pvvx/ZigbeeTLc
  ⤷ fw for Telink temp-humidity sensors (base of this project)
• doctor64/tuyaZigbee
  ⤷ fw for other Tuya Zigbee devices (helpful examples)
• medium.com/@omaslyuchenko
  ⤷ Hello Zigbee World series (very useful Zigbee programming guides)

⭐ Star History