[ST Edge/Beta] Buttons and remotes Edge Driver (Aqara,IKEA,Tuya)

General

Overview

This driver is for different buttons/remotes.

The driver currently supports only binding to the hub. Zigbee groups are not supported by this driver.

Signal Strength

The devices, created by this driver will show Signal strength (LQI/RSSI) in detailed view.

Link Quality Indication (LQI) is a cumulative value used in multi-hop networks to assess the cost of a link.

Received Signal Strength (RSSI) is a measure of incoherent (raw) RF power in a channel.

The LQI will be shown as reported by the hub, without any transformation (i.e. will have 0-255 range).

Good values for strong network are above 150.

Similarly, RSSI values are not transformed.

RSSI value above -60 dbm (i.e -59 and higher) indicates a strong network.

For values below -70 dbm adding Zigbee repeaters should be considered.

Please refer to Microchip’s article for more details.

Battery voltage

Some devices report the battery voltage, instead of remaining battery (in %).

Whether supported by the device, Battery voltage measurement will be shown in the detailed view.

User selectable actions

Some devices support more events that might be required by a user. It is usually not a problem for a single button. However, for 6 buttons, showing all options makes a very long detailed view. Therefore, for selected devices, the driver allows to hide unused actions.

Go to “Settings” in the right corner and enable the required actions to fit your needs.

You might need to exit the detailed view or even to close the app to see the changes.

Supported devices

Brand               | Model        | Type                                | Fingerprint
---------------------------------------------------------------------------------------------
Aqara Opple         | WXCJKG13LM   | 6 buttons remote                    | LUMI/lumi.remote.b686opcn01
IKEA                | E1812        | Tradfri Shortcut Button             | IKEA of Sweden/TRADFRI SHORTCUT Button
IKEA                | E2001/E2002  | 4 buttons remote                    | IKEA of Sweden/Remote Control N2
Tuya                |              | 1 button remote                     | _TZ3000_itb0omhv/TS0041
Tuya (Benexmart)    |              | 1 button remote                     | _TZ3000_tk3s5tyg/TS0041
Zemismart           | ZM-RM02      | 6 buttons remote                    | _TZE200_zqtiam4u/TS0601

Invitation

Please install

Zigbee Button Remote Driver [YG] from the following channel

Devices

Aqara buttons

Name Aqara Opple Wireless Scene Switch 6 Button WXCJKG13LM
Type 6 buttons remote
Image
Supported actions
Pressed
User selectable:
Held, Double pressed, Toggled up
Battery Not user replacable

Pairing Aqara Opple Wireless Scene Switch 6 Button WXCJKG13LM

The pairing button is located on the backside of the device.

  1. From ST APP, press "+" sign in the upper right corner
  2. Select "Add device"
  3. Find "Scan for nearby devices" and press "Scan". This will put the hub into pairing mode
  4. Press and hold pairing button until the led starts blinking
  5. Keep pressing pairing button every 1-2 seconds until the device is shown in the app

It may take several attempts to successfully pair the device

IKEA buttons

Name Tradfri Shortcut Button E1812 Styrbar Remote Control
Type Single button 4 buttons remote
Image
Supported actions Pressed
User selectable:
Held, Toggled up
Pressed,Held
Battery CR2032 2x AAA
Comments E1812 - 403.563.81 E2002 - white, 604.883.66
E2001 - stainless steel, 004.680.45

Pairing IKEA Tradfri Shortcut Button E1812

The pairing button is hidden and is located near the battery. The back cover should be removed to access it.



  1. From ST APP, press "+" sign in the upper right corner
  2. Select "Add device"
  3. Find "Scan for nearby devices" and press "Scan". This will put the hub into pairing mode
  4. Quickly press pairing button on the device 4 times (or more) until the led starts blinking

Pairing IKEA Styrbar Remote Control E2001/E2002

The pairing button is hidden and is located near the battery. The back cover should be removed to access it.



The instructions are similar to E1812.

Known issues

IKEA’s battery reporting might be inaccurate.

The driver tries to mitigate this by showing battery voltage measurement, in addition to remaining battery.

The driver handles both BatteryVoltage and BatteryPercentageRemaining reportings under PowerConfiguration cluster.

If BatteryPercentageRemaining report is received, only Battery is updated.

If BatteryVoltage report is received, both Voltage and Battery capabilities are updated. The voltage is assumed to be in 2.1-3.0V range,

the percentage will be calculated lineary based on received voltage.

Additional Resources


Tuya remotes

Name Wireless Scene Switch Benexmart Wireless Scene Switch
Model _TZ3000_itb0omhv ZM-sui1
Type 1 buttons remote 1 buttons remote
Image
Supported actions Pressed, Double pressed,Held Pressed, Double pressed,Held


Zemismart remotes

Name Zemismart Tuya Zigbee 6 Gang Wireless Remote Control
Type 4 buttons remote
Image
Supported actions Pressed, Double pressed,Held

Additional Resources

Change log

v1.2.3

Added support for Benexmart (Tuya) _TZ3000_tk3s5tyg/TS0041 Wireless Scene Switch

v1.2.0

Added support for Tuya _TZ3000_itb0omhv/TS0041 Wireless Scene Switch
Many thanks to @Trakker2 for his work on TS004x devices and for his enormous contributions to the community

v1.1 2022-04-21T10:25:46.304649Z

Added support for IKEA E2001/E2002 STYRBAR remotes

v1.0 2022-04-16T18:55:49.408654Z

Initial version

3 Likes

I thought Ikea button only has two options, pressed and held. What does this toggled up mean?

@Sakari toggled up is sent to notify the button is released after being held. This allows to get the time the button was held (i.e. the elapsed time between held and toggled up events).

Depending on what it’s connected to, it has three options; Press, Double Press, Long Press (Held)

This seemingly looks like a better option than the Ikea Styrbar Remote driver to be able to use together with other conditions. For example using buttons for incremental changes in devices, such as changing volume for Sonos speaker in steps.

My question may be more related to SmartThings in general. But there is no way to use a condition like volume => 31 AND volume =< 44)? That way, whenever the left button is pressed, if volume is anywhere from 31-44, then it turns it down to 30, etc.

It seems I can’t use the volume condition for the Sonos more than once either, to do higher than and lower than as two conditions. I can do this using SharpTools, but then it will be in the cloud.