Skip to main content

Dynamic Color Recipes

Dynamic Color Recipes (abbreviated DCR) adjust brightness and color automatically over time.

They can be used for circadian schedules, RGBWAF color transitions, and smooth fade-based lighting scenes.

It works together with Room Light Control and uses the same room outputs.

Recipe Graphs

Dynamic Color Recipes are configured with graphs. A graph defines how room lighting should evolve across the day.

Graph availability

The available graph count depends on the product model:

  • 4 DALI channels model: 16 graphs.
  • 1 DALI channel model: 4 graphs.

Each graph contains 8 support points and can be assigned to one or many Room Light Controls.

Support points

A support point defines:

  • A reference time.
  • A target brightness.
  • A target color.

You can combine several points to create gradual morning, daytime, and evening transitions.

Color types

The graph color type determines how color values are interpreted.

Color TypeValueDescription
TC0DT8 color temperature Tc value (mirek/mired)
XY1DT8 x/y coordinates
RGBWAF2DT8 Red, Green, Blue, White, Amber, Free Colour

For TC, user-facing values are in Kelvin (K).

Protocol conversion note:

Tc is in mirek (also called mired):

Mirek = 1000000 / Kelvin.

Kelvin = 1000000 / Mirek.

Example: 4000 K corresponds to 250 mirek.

Time types

Each support point uses one time type.

Time TypeDescription
FixedUses a fixed configured time
SunriseUses sunrise time with optional offset
SunsetUses sunset time with optional offset

Recipe Operation

Dynamic Color Recipes transition smoothly between active support points.

Interpolation is updated every 60 seconds.

For sunrise and sunset based points, offset and clamp settings can be used to keep transitions within a preferred time window.

Interaction With Room Light Control

Daylight Harvesting

Dynamic Color Recipes and Daylight Harvesting are mutually exclusive in operation.

  • Starting Dynamic Color Recipes stops daylight harvesting.
  • Starting daylight harvesting stops Dynamic Color Recipes.

Manual Override

Manual control of the room output temporarily stops Dynamic Color Recipes for that room.

Occupancy commands

Dynamic Color Recipes can be started or stopped through Room Light Control command logic.

Related BACnet properties: Command, Occupied_Command_Command, Warning_Command_Command, Unoccupied_Command_Command, Occupied_Mode_Command_Enable.

Fade behavior

An optional graph fade time can be used to apply smoother transitions when a new recipe target is applied.

Configuration Workflow

  1. Select a recipe graph.
  2. Choose the color type.
  3. Configure support points for key moments of the day.
  4. Assign the graph to the target Room Light Control.
  5. Validate behavior during occupied and unoccupied periods.

Web Interface

Dynamic Color Recipes

Use this page to configure graphs, support points, color type, and transition behavior.

Room Light Control mapping

Use this page to assign a recipe graph to each Room Light Control.

BACnet Interface

For compatibility, BACnet command names use circadian terminology. These commands control Dynamic Color Recipes through the Loop object for Room Light Control.

Related BACnet object: Loop Object - Room Light Control.

Loop command values

CommandValue
START CIRCADIAN29
STOP CIRCADIAN30

Occupancy command values

These commands are also available in the occupancy command enumerations.

CommandValue
Start Circadian10
Stop Circadian11

Parameters Copy

When Room Light Control parameters are copied, verify the destination room behavior and confirm the expected recipe graph assignment.