Skip to content

Add pinout for Tuya TS0041 1-button remote (_TZ3000_4upl1fcj, ZS3L) - #544

Open
dzikus wants to merge 2 commits into
romasku:mainfrom
dzikus:remote-tuya-ts0041-pinout
Open

dzikus wants to merge 2 commits into
romasku:mainfrom
dzikus:remote-tuya-ts0041-pinout

Conversation

@dzikus

@dzikus dzikus commented Nov 1, 2026

Copy link
Copy Markdown

REMOTE_TUYA_TS0041 was in_progress with "Needs pinout" (#171). This adds the pinout and enables the build.

Tuya 1-button wireless switch TS0041 (_TZ3000_4upl1fcj)

Z2M device link: https://www.zigbee2mqtt.io/devices/Push_LE.html

  • Battery: CR2430
  • Module: Tuya ZS3L (EFR32MG21A020F768IM32)
  • PCB: ESW-4ZAA-CN KER_V1.2.1 (the shared 1-4 gang board, only the middle key K5 and LED D6 populated), sticker ESW-0ZBD-EU

Switch config:
4upl1fcj;TS0041-TUYA;SA4d;IC0i;BTA0;M;

Pinout

Taken from the stock user data page (0x0FE00000), read over SWD before flashing:

{bt1_pin:5,led1_pin:10,rsthold:10,module:ZS3L,net_trig:0,led_md_slt:2,jv:1.0.0,net_t:45,samp_type:0,led1_lv:0,max_V:3000,battery_type:0,min_V:2500,ch_num:1,bt1_lv:1,crc:83,}

With the ZS3L map from helper_scripts/extract_pinout_from_silabs_data.py:

  • button bt1_pin:5 = A4, active high (bt1_lv:1) → SA4d
  • LED led1_pin:10 = C0, active low (led1_lv:0) → IC0i

This is the same pair as the third button of REMOTE_TUYA_TS0044 (SA4d;IC0i), and BTA0 is taken from there.

Flashing

The SWD pins are the six unpopulated ZS3L holes at the end opposite the antenna (module pins 17-22: 3V3, SWDIO, SWCLK, GND, RST2, GND). Flashing steps: mass erase, then bin/efr32mg21_bootloader_generic.s37, then the end-device build of this branch.

Tested

Tested on 1.11.2026 with Zigbee2MQTT 2.14.2 and an EmberZNet coordinator:

  • joins; interview and configure work with the generated converter
  • press / long_press / released are reported (long press after 0.8 s); the indicator LED lights on press
  • battery is reported (100 % on a fresh CR2430)
  • rejoins on its own after the battery is taken out and put back
  • polls its parent every 120 s

Not tested:

Notes

  • After flashing, device/interview on the already paired stock device reported success after ~5 s without any answer from the sleeping remote, and Zigbee2MQTT kept the stock model ID. Removing the device, resetting it and pairing again worked.
  • Observed once: after the 10-press reset the remote sent Leave, the LED stayed on, and the remote did not scan for a network for ~1.5 min. It joined right after a reset.

Photos

PCB front and back, the ZS3L pins (from the Tuya datasheet, mirrored to the top view) and the SWD wires used for the dump and flashing.

pcb-front pcb-back zs3l-pinout swd-wires

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant