Lighting Clusters

Lighting clusters control color and ballast configuration for smart lights.

Color Control (0x0300)

The most complex cluster in zigbee-rs. Supports three color models (Hue/Saturation, CIE XY, and Color Temperature) plus enhanced hue and color loop functionality. All color transitions are managed by a built-in TransitionManager.

Attributes

Color Modes

#![allow(unused)]
fn main() {
pub const COLOR_MODE_HUE_SAT: u8 = 0x00;
pub const COLOR_MODE_XY: u8 = 0x01;
pub const COLOR_MODE_TEMPERATURE: u8 = 0x02;
}

Commands

Usage

#![allow(unused)]
fn main() {
use zigbee_zcl::clusters::color_control::ColorControlCluster;

let mut color = ColorControlCluster::new();
// Default: XY mode, color temp 250 mireds (~4000K), all capabilities enabled

// In your timer callback (call every 100ms):
color.tick(1); // advance transitions by 1 decisecond

// Read current state for LED driver:
let hue = color.attributes().get(AttributeId(0x0000)); // CurrentHue
let sat = color.attributes().get(AttributeId(0x0001)); // CurrentSaturation
let temp = color.attributes().get(AttributeId(0x0007)); // ColorTemperature
}

The Transition Engine

Color Control uses a TransitionManager<4> supporting 4 concurrent transitions (hue, saturation, X, Y or color temperature). When a command like MoveToColor arrives:

1. The cluster calculates start value, target value, and transition time
2. Starts a Transition in the TransitionManager
3. Each tick() call interpolates the current value linearly
4. Attribute store is updated with the interpolated value
5. RemainingTime attribute reflects time left

Color Loop

The Color Loop engine (ColorLoopSet command 0x44) continuously cycles the hue:

• Active: ColorLoopActive attribute (0 = off, 1 = running)
• Direction: 0 = decrement hue, 1 = increment hue
• Time: Full cycle period in seconds
• tick() advances the hue based on elapsed time and loop parameters

Ballast Configuration (0x0301)

Configuration attributes for fluorescent lamp ballasts.

No cluster-specific commands — configuration is done via Write Attributes.

#![allow(unused)]
fn main() {
use zigbee_zcl::clusters::ballast_config::BallastConfigCluster;

let ballast = BallastConfigCluster::new();
}

Putting It Together: Dimmable Color Light

A typical color light uses On/Off + Level Control + Color Control together:

#![allow(unused)]
fn main() {
use zigbee_zcl::clusters::on_off::OnOffCluster;
use zigbee_zcl::clusters::level_control::LevelControlCluster;
use zigbee_zcl::clusters::color_control::ColorControlCluster;

let mut on_off = OnOffCluster::new();
let mut level = LevelControlCluster::new();
let mut color = ColorControlCluster::new();

// In the 100ms timer:
on_off.tick();
level.tick(1);
color.tick(1);

// Drive the LED:
if on_off.is_on() {
    let brightness = level.current_level();
    // Read color temp from attribute store
    // Apply to LED driver
}
}