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 Type | Value | Description |
|---|---|---|
| TC | 0 | DT8 color temperature Tc value (mirek/mired) |
| XY | 1 | DT8 x/y coordinates |
| RGBWAF | 2 | DT8 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 Type | Description |
|---|---|
| Fixed | Uses a fixed configured time |
| Sunrise | Uses sunrise time with optional offset |
| Sunset | Uses 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
- Select a recipe graph.
- Choose the color type.
- Configure support points for key moments of the day.
- Assign the graph to the target Room Light Control.
- 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
| Command | Value |
|---|---|
| START CIRCADIAN | 29 |
| STOP CIRCADIAN | 30 |
Occupancy command values
These commands are also available in the occupancy command enumerations.
| Command | Value |
|---|---|
| Start Circadian | 10 |
| Stop Circadian | 11 |
Parameters Copy
When Room Light Control parameters are copied, verify the destination room behavior and confirm the expected recipe graph assignment.