Koenkk / Koenkk/zigbee2mqtt

[Feature request]: Add LED backlight brightness control for Gewiss GWA1201_TWO_WAY_SWITCH

Open
#32,614 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

stale
Dominant language
TypeScript
Stars
15.7k
Forks
2k
Avg merge
18h 55m
Merged PRs (30d)
35

Description

Is your feature request related to a problem? Please describe

The Gewiss GWA1201_TWO_WAY_SWITCH has a status LED that is currently
very bright and cannot be dimmed through Zigbee2MQTT. In the
manufacturer's own Home Gateway app, this LED brightness is
adjustable, but Zigbee2MQTT does not expose this option, so I have
no way to reduce the LED intensity after migrating the device away
from the Gewiss hub.

Describe the solution you'd like

The Gewiss GWA1201 (and likely other ChorusMart devices) supports
adjusting the internal status LED brightness via the manufacturer's
Home Gateway app, but this attribute is not currently exposed in
Zigbee2MQTT.

Current exposes: switch, power_on_behavior, power, voltage, current,
energy, identify.

Would it be possible to add support for reading/writing LED backlight
brightness, similar to what's documented in the Gewiss manual?

Device: GWA1201_TWO_WAY_SWITCH
Z2M definition: https://www.zigbee2mqtt.io/devices/GWA1201_TWO_WAY_SWITCH.html

Describe alternatives you've considered
  • Physically covering the LED with tape/diffuser material to reduce
    visible brightness — works but is a workaround, not a real fix,
    and looks unprofessional on a wall switch.
  • Manually inspecting the device's Zigbee clusters via the Z2M
    frontend (Dev console) to find an undocumented manufacturer-specific
    attribute for LED brightness, without success so far.
  • Staying on the Gewiss Home Gateway hub instead of migrating to
    Zigbee2MQTT, just to keep LED brightness control — not desirable
    since it means giving up local/open-source integration with Home
    Assistant.
Additional context

Gewiss product page:
https://www.gewiss.com/ww/en/products/product.1000000.1008169.GWA1201

Related Gewiss ChorusMart manual (for a similar device, GWA1241)
mentions the status LED and its behavior:
https://manuals.plus/gewiss/chorusmart-connected-axial-2-command-module-manual

LED states documented: fixed red (not configured), fixed blue 50%
brightness (normal operation), flashing blue (identification),
fixed yellow (startup), fixed green (network open), alternating
green/red (factory reset).

This suggests the device already has brightness-level control
internally (the "50%" reference), which may be exposed through a
manufacturer-specific cluster not yet reverse-engineered in the
current Z2M definition (contributed in v2.1.0, PR #8601).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the GWA1201_TWO_WAY_SWITCH definition linked in the issue and review the related contribution in PR #8601. Use the Gewiss manual and the Zigbee2MQTT frontend Dev console to investigate the undocumented manufacturer-specific attribute. Done means exposing readable and writable LED backlight brightness for the device.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
embedded-iot
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.