Feature-rich custom firmware for Telink/Silabs Zigbee switches, modules, sockets
- Already 130+ 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 (configurable multi-press count, 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
- Curatain modules
- 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/
💬 Chat
Discuss, troubleshoot and follow the updates on Discord 🙂
🙏 Acknowledgements
- doctor64/tuyaZigbee
⤷ fw for other Tuya Zigbee devices (helpful examples) - medium.com/@omaslyuchenko
⤷ Hello Zigbee World series (very useful Zigbee programming guides)