Skip to content
  • There are no suggestions because the search field is empty.

What is Button Mapping and How can I use it?

This article explains how to set-up button mapping on Lightwave dimmers (LP21,LP22,LP23,LP24) and examples on how button mapping can be leveraged in your Lightwave System 

The Button Mapping feature can only be configured through the Lightwave Link Plus app. You’ll find this option in the Settings tab for the relevant dimmer channel, under the Advanced section.

Button Mapping defines how the User Interface (buttons and indicator LEDs) links to the dimmer outputs that power the lighting.

Default Setup

By default, each button and its LED are mapped directly to the corresponding dimmer output to maintain a consistent device layout. For instance, Channel 1 (bulb icon) aligns with the right-hand output on the dimmer module, known as Dimmer 1 or the Primary channel.

Custom Mapping Options

This setting allows you to:

  • Remap a dimmer output to one or more User Interfaces (UIs)

  • De-map a dimmer output, detaching it from all UIs

De-mapping is useful when you want the button to function independently of the light output. For example, a de-mapped button can serve as a remote trigger for other Lightwave devices or automations even though it is physically wired to a lighting circuit.

Behavior of De-Mapped Channels

  • The Indicator LED stays off when idle and lights up when a button is pressed.

  • LED colors reflect the type of press:

    • Green – Short press

    • Red – Multi-press

    • Blue – Long press

  • Automations can control the LED color, which will be temporarily overridden by real-time button press feedback.

Advanced Use Cases

If a single button needs to control a large load split across multiple output channels, you can assign that UI to all relevant outputs. This synchronizes all outputs with one button press and frees up other UI channels for tasks like scene lighting or heating control.

A practical example: On a single-gang dimmer, you can de-map the button from the light output. This retains app control of the light while converting the physical button into a wireless remote for other Lightwave devices – ideal for scene setting or multi-way switching.

Notes

  • The Lock function affects the UI channel physically aligned with the dimmer output (e.g., locking Channel 1 locks its own button, not any UI remapped to it).

  • The Auto LED Off function applies to de-mapped UIs, even when LED behavior is controlled via automation.

  • 2-way switching & Group Automations do not behave correctly on a re-mapped channel