konistehrad / tuyaZigbee

Replacement firmwares for TuYa zigbee devices

tuyaZigbee

This project intended to replace firmwares in TuYa devices based on Telink chips

Supported devices

• TS0501B, TS0504B (and possible others) LED controllers.
• TS0041 1 button battery switch
• More to come!

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 ior 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.

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 based on sample from TeLink zigbee SDK. This is continuation of earlier project TuyaLight

Improvements over original firmware

TS0501B

• Short press on hardware button can be used as On/Off switch
• Working reporting with binding or hardware button
• Have a Power on behavior
• No more annoying bug with light goes off shortly afetr turn on (I hope)
• OTA updates

TS0041

• Short click on button send toggle command (switch binded light on/off)
• Long press on button send move command, so light brightness a changed. Direction is switched on next press
• Short click on Net Key buttom send report with battery status

Join

TS0501B Long press on button, connected LED will blink

TS0041 Long press on Net Key button

Compilation

See docs/sdk_installation.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 #general #development

TODO

Known devices and status:

• TS0501B single Work in progress, mostly working
• TS0502B CCT Not started
• TS0503B RGB Not started
• TS0504B RGBW Work in progress
• TS0505B RGB/CCT Not started
• TS0041 1 button working

Tasks

TS050X - Light

• zigbee2mqtt converter
• save state and power on control
• reporting
• OTA
• RGBW support
• Direct control of LED PWM using custom cluster
• Support of other controller types

TS0041 - Switch

• zigbee2mqtt converter
• binding
• reporting
• OTA
• OTA update over Tuya firmware
• Multiclick support

Technical details

TS050X TuYa Zigbee LED controllers can be bought cheapely on Aliexpress. for example, Here. From hardware point of view, they all the same, at least TS0501B and TS0504B, and differs only by firmware and external connector to LED strip. All controllers share same populated PCB and based on Tuya ZT3L module, which is based on Z2 chip - actually it is TeLink TLSR8258 (TLSR8258F1KAT32)

Schematics

TS050X Actually, part of it. I was lazy enough to trace 3.3 voltage converter :)