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
https://bestow-regional.api.smartthings.com/invite/8b2Ay0rKX2ve
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.
- From ST APP, press "+" sign in the upper right corner
- Select "Add device"
- Find "Scan for nearby devices" and press "Scan". This will put the hub into pairing mode
- Press and hold pairing button until the led starts blinking
- 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.
- From ST APP, press "+" sign in the upper right corner
- Select "Add device"
- Find "Scan for nearby devices" and press "Scan". This will put the hub into pairing mode
- 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
