[ST EDGE] Schneider Wiser 4-Button Wireless Switch – WDE002924 / FLS/SYSTEM-M/4

Zigbee Edge Driver for the Schneider Wiser 4-Button Wireless Switch

This SmartThings Edge driver adds support for Schneider Electric / Wiser battery-powered wireless switches reporting:

Manufacturer: Schneider Electric
Model:        FLS/SYSTEM-M/4

The driver has been tested with the Schneider Wiser WDE002924.

Related models such as WDE002906 and Merten MEG5001-0300 belong to the same Schneider wireless-switch family, but the driver deliberately fingerprints only the exact Zigbee identity above.


What makes this device unusual?

Although the switch has four physical press areas, internally it is not implemented as four independent Zigbee buttons.

It has two Zigbee endpoints:

Endpoint Physical rocker
21 Right rocker
22 Left rocker

Each rocker generates standard Zigbee On/Off and Level Control commands.

The Edge driver translates those two rockers into four normal SmartThings button components:

  • Upper Left
  • Lower Left
  • Upper Right
  • Lower Right

Each physical component supports:

pushed
held

Short press and long press

The Schneider firmware supports different operating modes for each rocker.

For normal SmartThings use, the relevant modes are:

Mode Short press Long press
Light pushed
Dimmer pushed held
Light reversed pushed
Dimmer reversed pushed held

In Light mode:

Upper short → On  → pushed
Lower short → Off → pushed

In Dimmer mode:

Upper short → On                  → pushed
Lower short → Off                 → pushed

Upper hold  → Move Up             → held
Lower hold  → Move Down           → held
Release     → Stop

SmartThings’ standard button capability has no released event, so the Zigbee Stop command is not exposed separately.

If you want to use long presses in SmartThings routines, configure that rocker as:

Dimmer — pushed + held

The Edge driver does not emulate long presses with a timer. The Schneider firmware itself changes the Zigbee commands it sends.


Rocker settings

The left and right rockers can be configured independently from the SmartThings device settings.

Available modes are:

  • Keep current setting
  • Light — pushed
  • Dimmer — pushed + held
  • Light reversed — pushed
  • Dimmer reversed — pushed + held
  • Disable rocker

Keep current setting

This is the default and safest option.

Pairing the switch with SmartThings does not automatically overwrite its existing Schneider configuration.

Only selecting another mode explicitly writes a new configuration to the device.

Reversed modes

The reversed variants simply invert the physical direction:

Normal:
Upper → On / Up
Lower → Off / Down

Reversed:
Upper → Off / Down
Lower → On / Up

The driver compensates for this when generating SmartThings events so that the four SmartThings components still correspond to the physical buttons.


Why aren’t Scene, Shutter, Toggle, etc. exposed?

The Schneider firmware supports additional internal switchActions values including Scene, shutter, Toggle and Alternate modes.

These are not simply additional four-button modes.

Depending on the physical HMI configuration, some of them deliberately generate no commands at all. Others send completely different Zigbee commands, such as Window Covering or Scenes commands intended for direct Zigbee bindings, groups or Schneider-specific installations.

For a SmartThings four-button remote, exposing those low-level modes only creates confusion.

The production driver therefore concentrates on the modes that map cleanly and predictably to SmartThings:

Light
Dimmer
Light reversed
Dimmer reversed
Disabled

SmartThings button mapping

For normal operation:

EP22 + On  → Upper Left  pushed
EP22 + Off → Lower Left  pushed

EP21 + On  → Upper Right pushed
EP21 + Off → Lower Right pushed

For Dimmer mode:

Move Up   → upper button held
Move Down → lower button held
Stop      → release, no SmartThings event

Level Step commands are also handled.

Commands that do not identify a specific physical half of the rocker are intentionally not mapped to an arbitrary button.


Technical details

The device uses standard Zigbee clusters for normal button operation plus a Schneider-specific configuration cluster.

Cluster ID Purpose
Basic 0x0000 Device information
Power Configuration 0x0001 Battery
On/Off 0x0006 Short presses
Level Control 0x0008 Long presses
Schneider Light Switch Configuration 0xFF17 Rocker mode

Required command bindings:

EP21 → On/Off → Hub
EP21 → Level  → Hub

EP22 → On/Off → Hub
EP22 → Level  → Hub

Battery reporting comes from endpoint 21.

Without the On/Off and Level bindings, the device may pair correctly while button presses produce no SmartThings events.


Schneider rocker configuration

The rocker mode is stored in:

Manufacturer code: 0x105E
Cluster:           0xFF17
Attribute:         0x0001
Type:              ENUM8

The production driver uses:

Mode Value
Light 0x00
Dimmer 0x01
Disabled 0x7F
Dimmer reversed 0xFD
Light reversed 0xFE

Other Schneider values are still recognized internally so that devices previously configured with unsupported modes are not misinterpreted as normal SmartThings button modes.


1-gang vs. 2-gang

The physical 1-gang / 2-gang configuration is separate from the rocker settings above.

For the WDE002906/WDE002924 family, Schneider documents changing to 2-gang mode by holding:

Top Right + Bottom Left

for approximately 10 seconds until the LED starts blinking red.

This changes the physical button layout.

It is unrelated to selecting Light or Dimmer in the SmartThings settings.


Installation

1. Install the Edge driver

Open my SmartThings Edge driver channel:

SmartThings Edge driver channel invitation

Then:

  1. Sign in with your Samsung account.
  2. Accept the invitation.
  3. Enroll your SmartThings Hub.
  4. Open Available Drivers.
  5. Install Schneider Wiser 4-Button Wireless Switch.

2. Pair the switch

Start Scan for nearby devices in SmartThings and put the Wiser switch into pairing mode.

For the WDE002924 family, Schneider uses three quick presses of the pairing button; on the Exxact variant this is the upper-right button.

After pairing, SmartThings should expose:

  • Battery
  • Refresh
  • Upper Left
  • Lower Left
  • Upper Right
  • Lower Right
  • Left rocker mode
  • Right rocker mode

Tested behavior

Real-hardware testing with WDE002924 / FLS/SYSTEM-M/4 confirms:

Feature Status
Correct Edge driver selection :white_check_mark:
Four independent button components :white_check_mark:
Upper-left short press :white_check_mark:
Lower-left short press :white_check_mark:
Upper-right short press :white_check_mark:
Lower-right short press :white_check_mark:
SmartThings pushed events :white_check_mark:
Change rocker mode from SmartThings :white_check_mark:
Dimmer mode :white_check_mark:
Long press / held :white_check_mark:
Reversed mode handling Implemented
Battery support Implemented

The driver deliberately focuses on this verified SmartThings button functionality rather than exposing every low-level mode available in the Schneider firmware.


Notes

  • The driver currently fingerprints only Schneider Electric / FLS/SYSTEM-M/4.
  • WDE002924 is the hardware-tested variant.
  • Each physical button is exposed as its own SmartThings component.
  • There is no aggregate main button event, avoiding accidental triggering of routines assigned to another button.
  • Use Dimmer mode if you need held.
  • This is a sleepy battery-powered Zigbee device. Configuration changes are most reliable while it is awake; pressing a button immediately before changing a setting can help.

Sources

1 Like