FAQ: Using Tuya Zigbee Devices Directly With a SmartThings/Aeotec Hub (2024)

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.

Process:

  1. 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. :man_shrugging:t2:

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

FAQ: Manufacturer/Model Shows All Zeroes

  1. 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).

https://api.smartthings.com/invitation-web/accept?id=6b68563b-1905-4654-8d2b-e677a2997424

Enroll your hub and then select the “Zigbee thing MC“ edge driver to download it.

  1. switch your device from the standard “Zigbee thing” edge driver to Mariano’s.

FAQ: How to change to a different edge driver

  1. 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. :disappointed_relieved: 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.

[ST Edge] Personal Tuya Devices - Generic EF00 Device

Ask any further questions about that edge driver in that author thread.

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

Post Requests for Zigbee Edge Drivers Here (community-created)

  1. 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.
8 Likes

Tnx for the explanation. I have a Tuya Zigbee Hub with a zigbee wall switch and a Tuya Airkeeper (measures Co2 etc), will give it a try…

This method is not for people using a Tuya hub. It won’t work.

It is for people who want to use tuyamade Zigbee end devices, like buttons, switches, and sensors, connected directly to a smartthings/Aeotec hub without using a Tuya hub.

It won’t work if your end devices are connected to a Tuya hub.

And since the Zigbee profiles that smartthings uses only allow one Zigbee hub per net work, you can’t connect the Zigbee hub directly either.

The exception is if your Tuya Zigbee hub is also a “matter bridge.” Then you would be able to connect it to your smartthings account using matter (although community reports are that that isn’t working very well yet).

But that’s an entirely different process. Not the process described in this FAQ.

1 Like

I would reset the wall switch from the Tuya Hub and try to add it to the Smartthings hub.

2 Likes

Ok, then yes, you can try this method. But then it won’t work with your smartlife/Tuya app anymore, only with the smartthings app.

1 Like

A post was split to a new topic: Moving switch from Tuya hub to SmartThings hub

A post was merged into an existing topic: Help needed to use this tuya device as a garage door opener

A post was split to a new topic: Help needed to use this tuya device as a garage door open