TS0041
ActivoTuya Zigbee Scene Button 1-Gang
Generic Tuya Zigbee scene button — cheapest smart button.
Aplicaciones comunes
The $5 Zigbee button. Available from dozens of white-label brands on AliExpress. All use the same Tuya chip. Works with Smart Life app and Home Assistant via Zigbee2MQTT.
Notas de Investigación
1. Overview
The Tuya TS0041 is a battery-powered, single-button Zigbee 3.0 wireless scene switch sold under numerous brand names including MOES, Zemismart, LoraTap, Benexmart, Loratap, Immax NEO, Tesla Smart, EMOS GoSmart, Marmitek, Himojo, and YOVDA. It belongs to the TS004X family (TS0041=1-button, TS0042=2-button, TS0043=3-button, TS0044=4-button), all using the same underlying Tuya ZS3L/TZ3000 Zigbee module. Manufacturer codes (the _TZ3000_xxxx suffix) vary by variant — documented codes include _TZ3000_fa9mlvja, _TZ3000_mrpevh8p, _TZ3000_4upl1fcj, _TZ3000_axpdxqgu, _TZ3000_tk3s5tyg, _TZ3000_8rppvwda, _TZ3000_yj6k7vfo, _TZ3000_5bpeda8u, _TZ3000_22ugzkme, _TZ3000_itb0omhv, _TZ3000_qgwcxxws, _TZ3000_rsqqkdxv, _TZ3000_pzui3skt, _TZ3000_f97vq5mn, _TZ3000_kxaow5ki, _TZ3000_ghqckvr8, and _TYZB01_4qw4rl1u (TS0041A variant). The round button variant measures approximately 50×13.5 mm.
2. User Sentiment
Community reception is generally positive for basic use cases — the device is praised for its low cost (~$5–17 USD depending on source), easy pairing, and broad Zigbee2MQTT compatibility exposing clean single, double, and hold action events. However, Zigbee2MQTT is consistently preferred over ZHA: under ZHA, the button often presents as a switch (On-Off toggle) rather than a multi-action remote, requiring quirks and more complex automation setup. One blogger explicitly adopted a dual-Zigbee-network setup because "ZHA exposed it as a switch instead of a button; Zigbee2MQTT exposed clear action events like single, double, and hold." Negative feedback centers on three recurring issues: (1) battery draining in weeks rather than a year on some variants (Zemismart _TZ3000_tk3s5tyg documented at ~2-week drain due to hourly network announcements); (2) the first button press after hours of inactivity being silently dropped — a sleep-mode wake-up issue reported across ZHA and Z2M; (3) noticeable response latency (~0.5 second delay for double-click disambiguation, up to 1–3 seconds in poor mesh topologies).
3. Real-World Applications
The TS0041 is deployed predominantly in residential smart home setups as a battery-powered, wire-free wall switch or desk remote. Common use cases include scene activation (e.g., "movie mode"), light on/off/dimming control via HA automations, motorized curtain control (Tuya TS0041 + Zemismart motor documented in the wild), and manual ventilation control in bathrooms/bedrooms. Integration paths include Zigbee2MQTT (most popular), ZHA, deCONZ/Phoscon, Hubitat (built-in driver + custom TS004F driver), SmartThings (Edge driver), Jeedom (jeezigbee plugin), Homey (Universal TUYA Zigbee app), Domoticz, and ioBroker. HomeKit access is via Homebridge+Z2M or HOOBS. Rocket Home (Russian platform with Yandex Alice) also supports it via Z2M.
4. Technical Specifications
- Type: Zigbee 3.0 battery-powered 1-button wireless scene switch (end device, not router)
- Supported Actions: Single press, Double press, Hold/Long press (3–5 seconds)
- Battery: CR2032 × 1
- Hardware SoC (fa9mlvja variant): TLSR8258, 1 MB Flash
- Zigbee Protocol: Custom command 0xFD on genOnOff cluster (non-standard ZCL); firmware incorrectly reports device type as Switch (0x0000) instead of Remote (0x0006) — patched by ZHA quirks
- MQTT Action Values (Zigbee2MQTT):
single,double,hold - ZHA Event (press_type): 0 = single, 1 = double, 2 = long
- Battery Reporting: Published to MQTT
batteryproperty (0–100%); updates may take up to 24 hours; voltage also available in TS0041A variant - Pairing: Hold button 5 seconds until LED blinks rapidly
- LED: Visible red LED confirms each action press
- OTA: Firmware OTA update supported via zigbee-herdsman/tuya-zigbee-switch tooling
5. Ordering & Compatibility
The TS0041 is available from AliExpress ($3–8 USD), Amazon (~$17 USD for waterproof variants), and branded retail under MOES/Zemismart/LoraTap. The TS0041A variant adds voltage reporting. Compatible with all major Zigbee coordinators (Sonoff Zigbee 3.0 USB, CC2652, CC26X2R1, zStack3x0). Works natively in Zigbee2MQTT (best experience), ZHA (requires quirk from zhaquirks.tuya.ts0041), deCONZ (JSON device definition), Hubitat (built-in or TS004F driver), SmartThings Edge (erickv driver). Related models: TS0042 (2-button), TS0043 (3-button), TS0044 (4-button), TS004F (dimmer/scene knob variant). Multiple Home Assistant blueprints available on GitHub Gist for both ZHA and Z2M paths.
6. Known Issues
Variant fragmentation is the dominant pain point: dozens of _TZ3000_xxxx manufacturer codes exist for what is nominally the same device, and each may need a separate fingerprint entry in drivers/quirks — unsupported codes present as "unknown Zigbee device." Battery drain on certain variants (notably Zemismart _TZ3000_tk3s5tyg) due to hourly network announcements; separately, battery percentage reports stuck at 100% or 1% are known ZHA and Z2M bugs (fixed in ZHA PR #2288 and addressed in Z2M). First-press-after-sleep failure: after hours of inactivity, the initial button press fires a Zigbee message but no MQTT action is published — second press works. Z2M 2.0 regression: _TZ3000_axpdxqgu and related variants broke after Z2M 2.0.0 update (automations stop firing while device remains visible). Action naming inconsistency: some variants or Z2M versions report 1_single instead of single, breaking automations after upgrades.
Fuente
- Tuya TS0041 control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
- Tuya Wireless Scene Switch TS0041 Zigbee compatibility — zigbee.blakadder.com
- CB3S: TS0041_TZ3000_fa9mlvja - pvvx.github.io — pvvx.github.io
- zha-device-handlers/zhaquirks/tuya/ts0041.py at dev — github.com
- Simple blueprint for ZHA Tuya 1 Button switch (TS0041 TZ3000_mrpevh8p) — community.home-assistant.io
- Zemismart Wireless Wall Switch _TZ3000_tk3s5tyg Tuya TS0041 - Fast discharge + device announcements — github.com
- TuYa TS0041 _TZ3000_axpdxqgu stopped working after Zigbee2mqtt 2.0.0 update — github.com
- Tuya TS0041 scene switch (no zigbee2mqtt) - Home Assistant Community — community.home-assistant.io
- The hold action has disappeared from my Tuya TS0041 buttons — github.com
- Moes ZT-B-EU1 (TS0041): event_type exposed as 1_single/1_double — github.com
- Running two Zigbee networks side by side in Home Assistant — jonathas.com
- Tuya TS0041 no entity for automations - Home Assistant Community — community.home-assistant.io
- [BUG] Tuya TS0041 TS0042 TS0043 - no battery #2227 — github.com
- Button recommendations? - Page 2 - Hubitat — community.hubitat.com
- Tuya TS0041 - no battery percentage and voltage #6180 — github.com
- Tuya TS0041A control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
- Device: TuYa - Wireless_switch_with_1_button_TS0041 #296 — github.com
- ZHA - Tuya 2-button Scene Switch (TS0041) - Home Assistant Community — community.home-assistant.io
- Adding support for Tuya ZS3L / TZ3000 / TS0043 / TS0042 / TS0041 to Zigbee Bindings — community.openhab.org
- Tuya TS0044 first action ignored - Home Assistant Community — community.home-assistant.io
- [Wrong device]: SH-SC07 identified as TS0041 — github.com
- [Device Support Request] Tuya TS0041 _TZ3000_itb0omhv — github.com
- Received Zigbee message but no MQTT publish happened — github.com
- Tuya zigbee switch delay issue #8149 — github.com
- [Device Support Request] TS0041 _TZ3000_8rppvwda Tuya 1 smart button — github.com
- Zigbee2MQTT - Tuya TS0041 Scene Switch (Event Entity Support) — community.home-assistant.io
- [SOLVED] TuYa TS0041 momentary switch via Zigbee2MQTTAutodiscover — forum.domoticz.com
- I was able to pair a Tuya switch but how to I assign actions to it? — community.home-assistant.io
- ReX Telecommande Zigbee Loratap 1 bouton — community.jeedom.com
- Latence interrupteur zigbee et relais Sonoff ZBMiniL2 — forum.hacf.fr
- Tuya TS0041 no entity for automations — community.home-assistant.io
- Tuya TS0041 'wall switch' injecting error(s) in z2m logs regularly — github.com
- Tuya TS0041 not picking up custom quirk — github.com
- Tuya TS0044 first action ignored (affects TS0041 too) — community.home-assistant.io
- Zigbee TS0041 Round Button - Desktop Holder — makerworld.com
- [RELEASE] Tuya Scene Switch TS004F driver (w/ healthStatus) — community.hubitat.com
- [RELEASE] Tuya Scene Switch TS004F driver - page 12 — community.hubitat.com
- [RELEASE] Tuya Scene Switch TS004F driver - page 15 — community.hubitat.com
- [New device support]: Immax NEO Smart outdoor button, IP55 (whitelabel TS0041) — github.com
- [APP][Pro] Universal TUYA Zigbee Device App - TS0041 _TZ3000_5bpeda8u fix — community.homey.app
- Nested quirks signature triggering - TS004X family — github.com
- Automation using TuYa SH-SC07 / TS0041 button does not work after update — github.com
- Tuya スマート Zigbee シーン ボタン スイッチ (TS0041 review) — aliexpress.com
- Tuya Zigbee 스마트 스위치 무선 장면 스위치 (TS0041 review) — aliexpress.com
- WS700 Zigbee switches recognized as TuYa TS0041/TS0042/TS0043 — wiki.soloshin.su
- Tuya TS0041 - Рокет Хоум — rocket-home.ru
- Action sur un bouton TS0041 - Communauté Jeedom — community.jeedom.com
- Sharing my Zigbee .png images including tuya_TS0041_button — community.home-assistant.io
- [ST Edge] Zigbee Driver for MOES 4-Button Scene Switch - TS0041 fingerprints — community.smartthings.com
- TS0041/TS0042/TS0043 1-gang/2-gang/3-gang switch hardware mapping — github.com
- TS0041: Net Key Button - device class identifier discussion — github.com
- Tuya Smart Button IH-663 (TS0041) - three states confirmed — github.com
- Tuya TZ3000 TS0041 ZHA quirk documentation — aloade.net
- ZHA - Tuya button (TS0041).yaml blueprint — gist.github.com
- ts0041_button_controller.yaml for _TZ3000_yj6k7vfo — gist.github.com
- Successfully Integrating Smart Curtains with Motion Sensors (TS0041 use case) — forum.aqara.com
- EMOS GoSmart Portable Scenario Switch (TS0041 white-label review) — amazon.it
- Marmitek Push_LE_WHT (_TZ3000_4upl1fcj) white-label TS0041 in ioBroker — github.com
Apertura y modificabilidad
Firmware personalizado: Tasmota, ESPHome (WiFi via tuya-convert), Zigbee2MQTT (Zigbee)
Zigbee models work with Z2M. WiFi models flashable with Tasmota/ESPHome via tuya-convert (no soldering). Most hackable smart ecosystem.
Especificaciones
|
Available from
|
Aliexpress.com
|
|
Battery Life
Expected battery life under normal use. BLE buttons typically last 1-2 years on a coin cell.
|
1 year
|
|
Battery Type
The battery used. CR2032 = common coin cell, easy to replace. AAA = higher capacity. USB-C = rechargeable.
|
CR2032
|
|
Smart Home Integrations
Compatible smart home platforms and voice assistants.
|
Tuya Smart Life, Home Assistant, SmartThings
|
|
Mounting Type
How the button attaches to the panel. Panel mount is standard — installs through a cutout from the front.
|
Adhesive
|
|
Protocol
The wireless communication standard. BLE = short range, phone direct. Zigbee = mesh network, needs hub. Z-Wave = mesh, needs hub. WiFi = direct, higher power.
|
Zigbee 3.0
|
|
Works with
|
ZHA
|
|
Zigbee id
|
TS0041
|
Referencia rápida de instalación
Setup: Pair with your hub or phone via Zigbee 3.0. Most smart buttons support single press, double press, and long press for three different actions.
Battery: Uses CR2032 battery. Expected life: 1 year. Low battery notification via the app.
Dimensiones
Solución de problemas
Not responding to input
Check wiring continuity with a multimeter. Verify the contact block is properly seated. Inspect terminals for loose connections.
Dónde comprar
Rango de precios
$21.54 — $29.66
across 2 sellers in US dollars
Especificaciones rápidas
- Available from
- Aliexpress.com
- Battery Life
- 1 year
- Battery Type
- CR2032
- Smart Home Integrations
- Tuya Smart Life, Home Assistant, SmartThings
- Mounting Type
- Adhesive
Lo que dicen los usuarios
“Tuya TS0041 works well with home automation. Zigbee 3.0 protocol. Battery lasts 1 year.”
Más información
Fuentes de datos
Especificaciones y datos de producto obtenidos de las siguientes referencias.