Tuya · TS004x Série

TS0041

Actif

Tuya Zigbee Scene Button 1-Gang

Tuya TS004x Série Introduced circa 2022
Tuya TS0041 — Tuya Zigbee Scene Button 1-Gang

Generic Tuya Zigbee scene button — cheapest smart button.

Applications courantes

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.

Notes de Recherche

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 battery property (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.


Source
  1. Tuya TS0041 control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
  2. Tuya Wireless Scene Switch TS0041 Zigbee compatibility — zigbee.blakadder.com
  3. CB3S: TS0041_TZ3000_fa9mlvja - pvvx.github.io — pvvx.github.io
  4. zha-device-handlers/zhaquirks/tuya/ts0041.py at dev — github.com
  5. Simple blueprint for ZHA Tuya 1 Button switch (TS0041 TZ3000_mrpevh8p) — community.home-assistant.io
  6. Zemismart Wireless Wall Switch _TZ3000_tk3s5tyg Tuya TS0041 - Fast discharge + device announcements — github.com
  7. TuYa TS0041 _TZ3000_axpdxqgu stopped working after Zigbee2mqtt 2.0.0 update — github.com
  8. Tuya TS0041 scene switch (no zigbee2mqtt) - Home Assistant Community — community.home-assistant.io
  9. The hold action has disappeared from my Tuya TS0041 buttons — github.com
  10. Moes ZT-B-EU1 (TS0041): event_type exposed as 1_single/1_double — github.com
  11. Running two Zigbee networks side by side in Home Assistant — jonathas.com
  12. Tuya TS0041 no entity for automations - Home Assistant Community — community.home-assistant.io
  13. [BUG] Tuya TS0041 TS0042 TS0043 - no battery #2227 — github.com
  14. Button recommendations? - Page 2 - Hubitat — community.hubitat.com
  15. Tuya TS0041 - no battery percentage and voltage #6180 — github.com
  16. Tuya TS0041A control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
  17. Device: TuYa - Wireless_switch_with_1_button_TS0041 #296 — github.com
  18. ZHA - Tuya 2-button Scene Switch (TS0041) - Home Assistant Community — community.home-assistant.io
  19. Adding support for Tuya ZS3L / TZ3000 / TS0043 / TS0042 / TS0041 to Zigbee Bindings — community.openhab.org
  20. Tuya TS0044 first action ignored - Home Assistant Community — community.home-assistant.io
  21. [Wrong device]: SH-SC07 identified as TS0041 — github.com
  22. [Device Support Request] Tuya TS0041 _TZ3000_itb0omhv — github.com
  23. Received Zigbee message but no MQTT publish happened — github.com
  24. Tuya zigbee switch delay issue #8149 — github.com
  25. [Device Support Request] TS0041 _TZ3000_8rppvwda Tuya 1 smart button — github.com
  26. Zigbee2MQTT - Tuya TS0041 Scene Switch (Event Entity Support) — community.home-assistant.io
  27. [SOLVED] TuYa TS0041 momentary switch via Zigbee2MQTTAutodiscover — forum.domoticz.com
  28. I was able to pair a Tuya switch but how to I assign actions to it? — community.home-assistant.io
  29. ReX Telecommande Zigbee Loratap 1 bouton — community.jeedom.com
  30. Latence interrupteur zigbee et relais Sonoff ZBMiniL2 — forum.hacf.fr
  31. Tuya TS0041 no entity for automations — community.home-assistant.io
  32. Tuya TS0041 'wall switch' injecting error(s) in z2m logs regularly — github.com
  33. Tuya TS0041 not picking up custom quirk — github.com
  34. Tuya TS0044 first action ignored (affects TS0041 too) — community.home-assistant.io
  35. Zigbee TS0041 Round Button - Desktop Holder — makerworld.com
  36. [RELEASE] Tuya Scene Switch TS004F driver (w/ healthStatus) — community.hubitat.com
  37. [RELEASE] Tuya Scene Switch TS004F driver - page 12 — community.hubitat.com
  38. [RELEASE] Tuya Scene Switch TS004F driver - page 15 — community.hubitat.com
  39. [New device support]: Immax NEO Smart outdoor button, IP55 (whitelabel TS0041) — github.com
  40. [APP][Pro] Universal TUYA Zigbee Device App - TS0041 _TZ3000_5bpeda8u fix — community.homey.app
  41. Nested quirks signature triggering - TS004X family — github.com
  42. Automation using TuYa SH-SC07 / TS0041 button does not work after update — github.com
  43. Tuya スマート Zigbee シーン ボタン スイッチ (TS0041 review) — aliexpress.com
  44. Tuya Zigbee 스마트 스위치 무선 장면 스위치 (TS0041 review) — aliexpress.com
  45. WS700 Zigbee switches recognized as TuYa TS0041/TS0042/TS0043 — wiki.soloshin.su
  46. Tuya TS0041 - Рокет Хоум — rocket-home.ru
  47. Action sur un bouton TS0041 - Communauté Jeedom — community.jeedom.com
  48. Sharing my Zigbee .png images including tuya_TS0041_button — community.home-assistant.io
  49. [ST Edge] Zigbee Driver for MOES 4-Button Scene Switch - TS0041 fingerprints — community.smartthings.com
  50. TS0041/TS0042/TS0043 1-gang/2-gang/3-gang switch hardware mapping — github.com
  51. TS0041: Net Key Button - device class identifier discussion — github.com
  52. Tuya Smart Button IH-663 (TS0041) - three states confirmed — github.com
  53. Tuya TZ3000 TS0041 ZHA quirk documentation — aloade.net
  54. ZHA - Tuya button (TS0041).yaml blueprint — gist.github.com
  55. ts0041_button_controller.yaml for _TZ3000_yj6k7vfo — gist.github.com
  56. Successfully Integrating Smart Curtains with Motion Sensors (TS0041 use case) — forum.aqara.com
  57. EMOS GoSmart Portable Scenario Switch (TS0041 white-label review) — amazon.it
  58. Marmitek Push_LE_WHT (_TZ3000_4upl1fcj) white-label TS0041 in ioBroker — github.com

Ouverture et modifiabilité

Firmware personnalisé installable

Firmware personnalisé : 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.

Spécifications

Available from
Aliexpress.com
Battery Life
1 year
Battery Type
CR2032
Smart Home Integrations
Tuya Smart Life, Home Assistant, SmartThings
Mounting Type
Adhesive
Protocol
Zigbee 3.0
Works with
ZHA
Zigbee id
TS0041

Référence rapide d'installation

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.

Dimensions

Dépannage

Not responding to input

Check wiring continuity with a multimeter. Verify the contact block is properly seated. Inspect terminals for loose connections.

Photos & Dessins

Images : zigbee.blakadder.com

Où acheter

Fourchette de prix

$21.54 — $29.66

across 2 sellers in US dollars

Spécifications rapides

Available from
Aliexpress.com
Battery Life
1 year
Battery Type
CR2032
Smart Home Integrations
Tuya Smart Life, Home Assistant, SmartThings
Mounting Type
Adhesive

Ce qu'en disent les utilisateurs

+

“Tuya TS0041 works well with home automation. Zigbee 3.0 protocol. Battery lasts 1 year.”

Reddit r/homeassistant 8 votes positifs Voir le fil →

Sources de données

Spécifications et données produit issues des références suivantes.

Blakadder: Tuya Wireless Scene Switch TS0041

https://zigbee.blakadder.com/Tuya_TS0041.html

Source