FAQ: Zigbee Application Profiles, or why not all zigbee devices work with SmartThings

Zigbee is always zigbee, but the standard allows for different "profiles,"including manufacturer proprietary ones.

These are not all able to communicate with each other, they don’t even use the same addressing schemes.

SmartThings uses the Zigbee Home Automation profile (ZHA 1.2) and part of the Zigbee 3.0 profile. Devices using other zigbee profiles may be able to join to the network, but their communications may not be understood, or they may frequently drop off because they don’t receive a handshake message they are expecting.

There a lot of different ways to explain this, but I think one of the easiest is to think of zigbee as a post office and the different profiles as different languages. The outside envelope for different messages may look similar, have a specific format, and have enough information to pass the letter on to its destination. But the contents inside could be written in Chinese, Russian, English, etc. A person who can speak one of these languages doesn’t necessarily understand any of the others.

That’s not a perfect analogy, but it is good enough to explain why two zigbee devices might not be able to work together even if they’re on the same network.

Zigbee design prioritizes energy efficiency. If a feature isn’t needed by a particular profile, it was usually cut. A limited set of choices meant less energy required to process each message.

The ability of individual manufacturers to design their own profiles was considered a plus, particularly by companies with major security requirements. Essentially they got to write their own messages with their own secret codes, knowing that no one else would be able to read them. It’s one of the reasons that zigbee became popular with security systems. But it’s also the reason why you can’t usually use a control4 zigbee device with a SmartThings system. They are both using zigbee, but they are using incompatible profiles.

The following is an engineering document which explains how one transceiver manufacturer tries to deal with different zigbee profiles. Most people can just skip this, but those with a firmware-oriented technical background who want to see a practical example should find this interesting:

http://www.telegesis.com/download/document-centre/application_notes/TG-APP-R3xxInterop-202.pdf

Anyway, long story short: the zigbee standard allows for multiple profiles, and they are not all compatible with SmartThings. Look for Devices certified for ZHA 1.2 and you’ll have the best chance of getting them to work with SmartThings.

There are now a number of zigbee 3.0 devices on the market, but they can still vary a little bit by profile. The smartthings V2 and V3 hubs support most of the Zigbee 3.0 standard, but not all of it. Specifically it does not have any way of supporting zigbee “green power” devices, so you can’t use one of the “friends of hue“ batteryfree switches with smartthings yet. But you can use the gledopto zigbee 3.0 RGBW controllers.

A Note About Tuya 3.0 Devices

Tuya is a major manufacturer of both Wi-Fi and zigbee devices, which are then sold under many different brand names, often with somewhat different firmware.

Although the zigbee devices are certified for 3.0, they do use some manufacturer specific proprietary code, including the “EF00“ cluster for multiendpoint devices. This means that, for example, the Tuya multi gang zigbee light switches will not work out of the box with smartthings. (They are sold under many different brand names, including Zemismart, yagusmart, Losonho, moes , etc. ) They have to have custom code to allow for that proprietary cluster. The most common symptom if you try to use them without custom code is that the first gang switch will work, but the others either won’t work or will just turn on and off when the first switch turns on and off.

That means you will have to search the forum for custom code specifically for the model that you have in order to get these to work directly with a SmartThings hub. :thinking: here’s the FAQ for that.

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

MATTER BRIDGES AS AN ALTERNATIVE

as of 2024, one other option is to connect the Zigbee devices to a Zigbee hub (with a matching Zigbee profile) which is also a “matter bridge.“ (not a “matter hub,“ or a “matter controller,“ – – we’re specifically looking for the bridge capability.)

Once you do that, as long as you have a matter controller for your SmartThings account (typically an Aeotec hub or an older, smartthings hub), but might also be a Samsung smart television or some other devices, THEN You can have the matter bridge operate an interface to those Zigbee devices using the matter protocol. So in that case, you don’t even have to have a Zigbee coordinator in your smartthings set up, although you probably will. But the Zigbee connection to those specific devices is handled by the third-party Matter Bridge, and then brought over to smartthings via either Wi-Fi or the Internet.

The great news is that if you do it with a Matter bridge you won’t have to worry about any proprietary Zigbee profiles, those are all handled on the other side of the matter bridge.

The not so good news is that the connection using matter may be limited to only the most basic features of the device. For example, if it’s a lightbulb which can do automatic circadian rhythm adjustments over the course of the day, those probably won’t be available in smart things if you’re using matter over bridge. You’ll probably just get on/off/and dim. But you would still be able to get the other features using the app for the matter bridge itself, so sometimes that’s the best of both worlds. And sometimes it’s just a frustrating limitation. :man_shrugging:t2:

As of June 2025, Matter over bridge has turned out to be quite a good way to bring in both tuya Zigbee devices and Aqara Zigbee devices. No custom code required, but you do need the correct matter bridge to work with each of those devices. So you might end up with one Zigbee gateway for aqara, a different Zigbee gateway for Tuya, a different Zigbee Gateway for third reality, etc. The Zigbee part wouldn’t affect your smartthings set up in any way. The integration would be through matter over bridge.

It can work really well, though, and give you access to a much wider variety of devices than trying to make each one work directly with smartthings.

11 Likes

Now that more details are available on zigbee 3.0 and devices are starting to come to market, note that it will only combine the profiles previously based on zigbee pro addressing. That includes ZHA, ZLL, and zigbee green, but specifically does not include the Zigbee Smart Energy profile used in smart meters.

The new 2018 V3 SmartThings Hub will support zigbee 3.0, but not the full stack, as well as legacy ZHA devices. There has been some staff discussion of possibly eventually updating V2 hubs to also support zigbee 3.0, but no timeline and no promises.

Specifically, as of this writing (December 2018) the V3 hub will support zigbee 3.0 light bulbs and switches that do not required “touchlink commissioning” and are not using the zigbee green power structures. But it won’t yet work with some of the Zigbee 3.0 devices like the battery-free Wall switches in the " Friends of hue" program.

4 Likes