Universal Tuya docsHomeSupported devicesRequest a deviceFAQChangelogArchitectureKnowledge baseCreditsSourcesContributing

Battery multi-button remotes — TS0041 / TS0042 / TS0043 / TS0044 / TS004F

P2249 + P2253 (hybrid RX/TX wrappers, scene mode, blue LED, 5.x regression path). Sacred couple = manufacturerName + productId only. Never invent a pid.

What these devices are

PidButtonsRoleHomey drivers
TS00411Battery scene remotebutton_wireless_1, button_wireless_4_ts0041
TS00422Battery scene remotebutton_wireless_2
TS00433Battery scene remote (Zemismart ZM-ZS-3, Moes, Lonsonho, LoraTap)button_wireless_3
TS00444Battery scene remote / scene switch (Moes ZT-SY, Lonsonho, Nedis)scene_switch_4 / button_wireless_4
TS004F4 / knobScene or dimmer (0x8004 only here)button_wireless_4, smart_knob*

They are end devices (not routers). Presses arrive as manufacturer OnOff cmd 0xFD per endpoint (Z2M tuya_on_off_action), not as Homey native toggles.

Protocol mix (P2253) — support ALL layers

Homey native Zigbee does not cover every path. Runtime keeps parallel wrappers:

LayerPathRole
Native ZCLgenOnOff / scenes / levelControl cmdsSome firmwares / TS004F command mode
Tuya Zigbee mfrgenOnOff 0xFD BoundCluster + raw catcherDominant press path (TS0041–44)
E000cluster 0xE000 BoundClusterAlternate button encoding
EF000xEF00 RX listen onlyHybrid DP remotes; never force EF00 TX on pure ZCL
MagicgenBasic 0xFFDE=0x13First-press-after-sleep fix
Scene attrgenOnOff 0x8004TS004F only — TS0041–44 reject → kills presses

IntelligentProtocolDetect → HYBRID listen + cascade; HomeyCompensationLayer queues magic for TS0041–44 without ts004f_scene_mode.

Scene mode vs dimmer

PidSoftware 0x8004?Homey button_mode
TS0041–44No (writeSceneAttr: false)Default scene (UI hint only)
TS004FYes (0=dimmer, 1=scene)Auto / scene / dimmer writes attr

Hardware scene/dimmer toggle on some TS004F: hold buttons 2+4 ~6s (Z2M).

Blue LED (if present)

Not a Homey-controllable backlight / DP. Observed behaviour (Z2M #8072 class + forum):

Do not invent a LED capability or write backlight DPs on these remotes.

Locked couples (do not invent)

CoupleDriverSource
_TZ3000_a7ouggvs + TS0043button_wireless_3DEVICE_TRUTH zemismart-ts0043
_TZ3000_vsxvaj9i + TS0043button_wireless_3Bastien live interview P2629 — 0xFD/E000, no EF00
_TZ3400_key8kk7r + TS0043button_wireless_3Blakadder ZM-ZS-3
_TZ3000_bczr4e10 + TS0043button_wireless_3INT-170
_TZ3000_zgyzgdua + TS0044scene_switch_4meter91 / INT-015 Moes
_TZ3000_wkai4ga5 + TS0044scene_switch_4Z2M Moes white-label
_TZ3000_xffhmvhv + TS004Fbutton_wireless_4Nobø — no 0x8004
_TZ3000_mrpevh8p + TS0041button_wireless_1Z2M SH-SC07 / Johan #1120 / Peter #2202 — P2285
_TZ3000_5bpeda8u / _TZ3000_b4awzgct + TS0041button_wireless_1Z2M SH-SC07 siblings (not 4_ts0041)

Architecture deep-dive — _TZ3000_mrpevh8p+TS0041 (P2285)

LayerReality (cross-ref)
IdentitySacred couple only. Retail: SH-SC07 / RSH-SC021. Z2M whitelabel PR #6225.
InterviewEP1: clusters 0,1,6,E000; out 25,10. EP2–4: phantom OnOff/power (battery 253 junk).
RX pressDominant: genOnOff mfr cmd 0xFD data[0]=0 single / 1 double / 2 hold (Z2M tuya.fz.on_off_action).
BoundOnOffBoundCluster.handleFrame + raw wrapHandleFrame('physical-onoff-fd')
E000Present on EP1 — cascade Bound when profile.usesE000
EF00Absent — never force EF00 TX; IO passive wrap must not orphan 0xFD
TX wakeconfigureMagicPacket / sendTuyaMagicPacket (0xFFDE=0x13) on init + announce
Forbidden TX0x8004 scene attr — kills presses on TS0041–44
BatteryEP1 only; ZCL 0–200; never configure battery reporting (Z2M #8072 mesh death)
Flowsbutton_wireless_1_button_1gang_button_{pressed\|double_press\|long_press}

Known external bugs: Z2M interview fail (force re-pair); HA ZHA double-event “stuck” toggle; Domoticz momentary on→off race; fingerprints case MRPEVH8P→switch_1gang (fixed P2285).

Why some users said 5.x “worked better”

Cross-ref (diags meter91 55e3e591, Nobø 9cbf9eb6, forum #2189, git P2235/P2249):

  1. Older 5.x paths were less aggressive on wake: fewer triple-writes of 0x8004 onto sleepy remotes that never implemented it.
  2. Master briefly over-applied TS004F scene recovery to TS0044 → physical press died → fixed by family classification + wake skip.
  3. Hybrid wrappers (0xFD BoundCluster + raw + magic) restore parity and keep multi-press scene behaviour without the bad TX.

Recurring failure modes

  1. Wrong driver — TS0043/44 stolen by button_wireless_2 / wall_switch (P2249 strip pids).
  2. 0x8004 scene write on TS0041–44 — attr 32772 unsupported → press dies.
  3. First press ignored after sleep / pair — missing 0xFFDE=0x13 (Z2M configure + HA “first action ignored”).
  4. Missing 0xFD BoundCluster — SDK drops mfr cmds.
  5. Button order reversed — use setting reverse_button_order (scene_switch_4 / button_wireless_3).
  6. Peter couples ABSENT — do not invent; wait for [BUTTON-WAKE] mfr=… pid=….
  7. Late identity (P2298/P2316) — zb_manufacturer_name lands minutes after init → re-arm 0xFD + magic.

Runtime path (Homey)

wake/announce → TuyaMagicPacket (0xFFDE=0x13)
             → bind genOnOff EP1..N (+ scenes / E000 when present)
             → OnOffBoundCluster 0xFD + raw catcher + optional E000/EF00 RX
             → ButtonDevice.triggerButtonPress (+ reverse_button_order)
             → FlowCardHeuristics declared-only trigger
             → NEVER write 0x8004 unless family=ts004f

User action

Update Test → remove + re-pair remotes still shown as 1/2-gang wall switch. Pairing: hold bottom-left (TS0044) or left button ~10s. Fresh CR2032.

Do not

Live interview — _TZ3000_vsxvaj9i+TS0043 (P2629 Bastien)

FieldValue
IEEE[IEEE-1]
Typeenddevice, receiveWhenIdle=false (sleepy)
EP1 inbasic(0), power(1), onOff(6), E000(57344)
EP1 outota(25), time(10)
EP2–4 inonOff(6), power(1) — phantom battery 0
EF00absent — no DP path
BatteryEP1 batteryPercentageRemaining=200 → 100%; voltage 30 (=3.0 V)
RXOnOff mfr 0xFD per EP1–3 + E000/raw parallel
TX forbidgenOnOff 0x8004, EF00 writes, battery configure storm

Bastien live — _TZ3000_axpdxqgu+TS0041 (P2630)

EP1 only [0,1,6] / out [25,10]. No E000/EF00. Battery ZCL 200→100%. RX 0xFD. Driver button_wireless_1. Re-pair after tip.

P2633 — Phantom 4-EP firmware on TS0041 (HA T455202)

Some Chinese 1-button remotes (_TZ3000_adndolvx+TS0041 etc.) ship TS0044 4-endpoint firmware. ZHA shows 4 dead switches; real presses are OnOff 0xFD on EP1 only.

Homey: button_wireless_1 with collapsePhantomEndpoints + mapAllEndpointsToButton1 — never pair as 4-gang.

← Knowledge base index · source