the following applies only to tuyamade Zigbee devices that you want to connect directly to a smartthings/Aeotec hub.
It does not apply to Wi-Fi devices or to devices that will be bridged via matter. Or to devices that are connected to a tuya hub and then brought in through the “Tuya smart” or smartlife integration. Just ones using zigbee that you want to connect without using a tuya hub.
These devices can be sold under more than a dozen different brand names. They are usually very inexpensive with cool features, but no independent safety certifications.
Tuya is a huge device manufacturer which makes devices which are then rebranded and sold by other companies. There are literally dozens of companies selling tuya made devices, including Moes, yagusmart, btf, zemismart, and many more. Sometimes the devices have slightly different firmware, and they typically have a different “fingerprint“ which can make it tricky to get them to work with SmartThings if it’s a fingerprint that has never been added to the existing edge drivers.
How can you tell if it’s a tuya-made device? Usually the product description will mention either a Tuya gateway or the “smartlife“ app. If the device works with either of those, it started life in a Tuya factory.
So… can you get a Tuya-made Zigbee device to work directly with SmartThings? Maybe. Tuya uses a lot of proprietary code which then has to be translated into something that SmartThings can understand. The official edge drivers written by Samsung don’t do those translations. But there are some community created edge drivers that can do it for some models (but not all).
And then smartthings has its own layer of proprietary code, which are the edge drivers, so you have to find the right one. And if it doesn’t include the fingerprint of your specific device, you’ll have to get the edge driver author to add it.
add the device to SmartThings. If it doesn’t add as at least a “Zigbee thing,” there’s a problem with the device itself. It might just need to be reset. But it might be defective: it happens.
once you have it added, you need to get the fingerprint (The combination of manufacturer code and model number.) The following FAQ shows you where those fields are. If they happen to be blank or all zeros, the pairing failed, and you will need to pair it again until you see actual numbers/letters in those fields.
- now there’s a step specific to Tuya devices. You need to download a community diagnostic tool, the “zigbee thing mc”edge driver.
Follow this link to subscribe to Mariano‘s channel (the “MC“ you will see on a lot of custom drivers are his initials).
Enroll your hub and then select the “Zigbee thing MC“ edge driver to download it.
- switch your device from the standard “Zigbee thing” edge driver to Mariano’s.
- now you will be able to see the “clusters“ that this device supports. If you see EF00 , then it’s using proprietary Tuya clusters. Those are a pain. You might be able to get it work with the following edge driver, but no guarantees. Read the first post carefully, it has a lot of information you will need.
Ask any further questions about that edge driver in that author thread.
- if you don’t see EF00, Then it might work with a more standard edge driver, but one created by a community member.
So put a request post in the following thread. Read the first post in that thread carefully. Your request needs to include the fingerprint and the list of clusters.
If someone knows of an edge driver that will work with it, or if it just needs to have its fingerprint added to an existing edge driver, a community developer will hopefully respond there.
Then you’ll be able to follow the link to that channel and subscribe to that edge driver and hopefully everything will work.
- You can delete the “Zigbee thing MC” edge Driver from your hub once you have switched your new device to a different edge Driver. It’s just used as a diagnostic tool.