Koenkk / Koenkk/zigbee2mqtt

T1M (CL-L02D) RGB effects fail with UNSUPPORTED_CLUSTER manuSpecificLumi (regression since 2.9.1)

Open
#32,970 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

What happened?

What happened?
Setting effect/effect_speed/effect_colors on the Aqara T1M Ceiling Light (CL-L02D) fails with:

z2m: Publish 'set' 'effect' to '<friendly_name>' failed: 'Error: Status 'UNSUPPORTED_CLUSTER' manuSpecificLumi'

Same happens for effect_speed and effect_colors. Payload format matches the official docs exactly (https://www.zigbee2mqtt.io/devices/CL-L02D.html).

Device firmware: 27 (meets documented minimum requirement)
Zigbee2MQTT version: 2.13.0

Confirmed by another user with the same error and firmware/z2m version combo, who found that downgrading to Zigbee2MQTT 2.9.1 resolves the issue:
https://community.home-assistant.io/t/aqara-advanced-lighting-custom-integration/969960/44

This suggests a regression was introduced somewhere between 2.9.1 and 2.13.0 affecting writes to the manuSpecificLumi cluster for T1M RGB effects specifically.

What did you expect to happen?
Effect commands should be accepted by the device as documented.

What did you expect to happen?

effect shall be executed

How to reproduce it (minimal and precise)

set sepcific effect in expose functions

Zigbee2MQTT version

2.13.0

Adapter firmware version

27

Adapter

Aqara CL-L02D

Setup

ha is running on unraid as VM

Device database.db entry

No response

Debug log
Image
Notes

No response

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

No source file or test is identified. Start by reproducing the effect, effect_speed, and effect_colors writes for the Aqara CL-L02D on Zigbee2MQTT 2.13.0, then compare the manuSpecificLumi handling with 2.9.1. Done means the documented commands are accepted without UNSUPPORTED_CLUSTER.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
embedded-iot
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.