tuyaZigbee
ATTENTION! Current version of firmware have a critical bug, making impossible next updates over OTA. If you don't have hardware programmer, do not install updated firmware until bug is fixed.
This project intended to replace firmwares in TuYa devices based on Telink TLSR82XX chips
Supported devices
Currently, implemented main code for following classes of devices:
- Lights amd LED controllers
- Switches and buttons (not include relays and switches with relays)
- Intruder Alarm Systems (IAS) sensors
- More to come!
After main code implemented, implementing new devices of same class usually much easier - only implementation specific hardware detail need to be added.
List of currently implemented devices Supported
List of work in progress devices WIP
Is my device supported?
Theoretically speaking, any device based on Telink zigbee chips can be supported. Practically, I worked only on TLSR8258 based devices. You can check your device by opening it and look on board. If you see chip named TLSR8258 or tuya modules named ZT3L, ZTLC5, ZTU-IPEX, ZTU, ZT5, ZT2S, ZTC - this device theoretically can be supported. Or look at device in zigbee2mqtt interface. If device IEEE (MAC) address begins with 0xa4c138 - this is Telink based device.
Unfortunately, for some devices replacement firmware can't be implemented. Mostly because some complex devices like thermostats, roller shaders openers, etc have two MCU. Telink chip used only for zigbee network operations, and some other MCU do real operations with hardware. This architecture used by many Tuya devices and allows manufacturer to put any Zigbee module or even WiFi/Bluetooth without changing hardware-related code.
List of unsupported devices Unsupported
Why?
Because TuYa firmware sucks, that's why :)
But, seriously, not counting common drawbacks of TuYa devices firmware like manufacturer dependent messages and overall strange approach to zigbee standart, TS050X devices have very annoying bug: sometimes, then device receive On command, it turn on light for few seconds and turned off. I was unable to find exact condition to trigger this bug, but it happens from time to time. TS0041 does not support binding, etc.
So, this project was born.
This project partially based on samples from TeLink zigbee SDK.
This is continuation of earlier project TuyaLight
Compilation
- For Windows see: docs/windows_build.md
- For Linux see: docs/linux_build.md
Flashing
See docs/flash.md
OTA update of Tuya firmware
See docs/ota_tuya.md
OTA
See docs/ota.md
Support & help
If you need assistance you can check opened issues. Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media.
Check Diskord channels