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.

STEP ONE: DOES YOUR ST HUB HAVE A ZIGBEE RADIO?

First things first, just to get this out-of-the-way because it came up in another thread.

In order to use Zigbee devices of any brand with SmartThings, at the time of this writing you must have either a standalone SmartThings hub or an Aeotec “works as a SmartThings hub“ hub, or some of the 2024 or newer Samsung appliances/televisions that have a Zigbee chip built in. Or an older Samsung smart television or appliance plus the optional add-on Zigbee dongle.

All of the other Samsung “hub everywhere” options, including the soundbars, the Samsung smart televisions without the dongle, the family hub refrigerators without the dongle, etc that were built before 2024 don’t have a Zigbee radio. So they can’t talk to Zigbee devices.

So step one is to make sure that you do have a hub that has a Zigbee radio. Now onto the Tuya details.

STEP TWO: THE TUYA UNIVERSE

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

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 downloaded the new custom edge Driver. It’s just used as a diagnostic tool.

  2. now that you finally have the right edge driver on your hub, You’re ready to add your device and it should match to that new custom edge driver.

Note that in the past We typically just switched from one Zigbee edge driver to another in the SmartThings app, but the idiosyncrasies of the tuya-made devices plus some changes to the SmartThings platform now mean that in order to get the device to work correctly you have to delete it from your SmartThings account and then re-add it so that it will pick up the new edge driver and get configured correctly as part of the initial add process. Unfortunately, that also means that you will have to re-create any routines you had that were using it, but since the reason for getting the new custom edge driver is that the device wasn’t working with the old one, hopefully that won’t be too annoying.

Here are Mariano‘s instructions for this step:

  • Once your device fingerprints has been added to a community driver, do not change to new driver from Zigbee Thing stock or Zigbee Thing Mc. This could cause your device to not work properly or appear offline after a few hours, due to your device not being configured correctly.
    .
    Follow these steps:
    .
  • Install the community driver with the new fingerprints added to your Hub
  • Uninstall the device with the App
  • Check or put the device in pairing mode
  • Add new Device in the App and use the Search nearby devices option.

———
9) once you have tested the device and it is working correctly, you can now re-create any routines you had to delete as part of this process. And hopefully the device will now work the way you first expected.

13 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

Usage of the Zigbee Thing MC results in the attached so I’m unable to get the device details to request the fingerprint addition of my Tuya LY-1690 Blind Motor to an Edge Driver.

Tagging @Mariano_Colmenarejo

Look in the API Browser+ under Status for your device.

1 Like

And for clarity, the API browser+ is a community-built utility that was very important in mid 2023 before SmartThings released its official advanced web page.

It’s not as popular as it used to be, but it does still provide some information that the official features do not, such as in this example, the endpoint information for a Zigbee device. :sunglasses:

Here’s the topic that explains how to sign up for the utility

SmartThings API Browser+ ... Now Available to All

3 Likes

You can use Samsung account.

Manufacturer: _TZ3000_kdi2o9m6
Model: TS011F
FingerPrinted_EndPoint.Id: 0x0B
App Version: 0x42
ZCL Version: 0x03
Network ID: 0x158D
Zigbee EUI: EC1BBDFFFEA88018
Device ID: 23b34f80-16bf-47c1-938a-80497f29bb0e

Server Cluster:
Ep: 0x0B={ 0000,0003,0004,0005,0006 }

Client Clusters:
Ep: 0xF2={ 0021 }
Ep: 0x0B={ 0019,000A }

Signal Metrics:
LQI: 186 .... RSSI: -64 dbm
1 Like

Thank you all for your assistance. It’s much appreciated.

3 Likes