Lighting Widget

The Lighting Widget provides most of the standard Key Functions for lighting control such as “Toggle”, which turns a group on or off from a single key, or “Toggle Dimmer”, which does the same but also dims when using a long press.

Each Lighting Widget has a single Key Function, as well as its own independent settings for Ramp Rate, Preset Level, and Indicator Colors.

To set up functionality that uses 2 (or more) keys for the same group (for example, one key to do Off/Down and another to do On/Up), you use multiple widgets with each assigned the desired Key Function and set to the same group.

The following Key Functions are available for use with Lighting Widgets.

Key Function	Description
Toggle	Short press toggles the state of the group between on and off, with an instant ramp.
On	Short press turns group on with an instant ramp, only if currently off.
Off	Short press turns group off with an instant ramp, only if currently on.
Preset	Short press set the group to the preset level with an instant ramp, regardless of current level. If the group is on, a long Press ramps the group to off at the Widget's Ramp Rate.
Toggle Dimmer	Short press toggles the state of the group with an instant ramp. If the group is on, and the key has not been pressed for 15 seconds, a long press ramps the group down at the Widget's Ramp Rate. If the group is on, and the key has been pressed within the last 15 seconds, a long press ramps the group in the opposite direction to the last operation, at the Widget's Ramp Rate. If the group is off, a long press ramps the group up at the Widget's Ramp Rate.
Memory Toggle Dimmer	As per Toggle Dimmer, but when toggling to on state, restores to last active level.
Toggle Dimmer Down	Short press toggles the state of the group with instant ramp. Long press ramps the group down at the Widget's Ramp Rate.
Toggle Dimmer Up	Short press toggles state of the group with instant ramp. Long press ramps the group up at the Widget's Ramp Rate.
Memory Toggle Dimmer Down	As per Toggle Dimmer Down, but when turning on, restores to last active level.
Memory Toggle Dimmer Up	As per Toggle Dimmer Up, but when turning on, restores to last active level.
Dimmer Down	Short press turns the group off with instant ramp, only if currently on. Long press ramps the group down at the Widget's Ramp Rate.
Dimmer Up	Short press turns the group on with instant ramp, only if currently off. Long press ramps the group up at the Widget's Ramp Rate.
Down	Ramps the group down at the Widget's Ramp Rate.
Up	Ramps the group up at the Widget's Ramp Rate.
Soft Down	Short press ramps the group off at the Widget's Ramp Rate. Long press ramps the group down at the Widget's Ramp Rate.
Soft Up	Short press ramps the group on at the Widget's Ramp Rate. Long press ramps the group up at the Widget's Ramp Rate.
Nudge Down	Short press ramps the level of the group down by the nudge amount, with an instant ramp.
Nudge Up	Short press ramps the level of the group up by the nudge amount, with an instant ramp.
Bell Press	Group is turned on with instant ramp (only if off) when the key is pressed and turned off with an instant ramp when the key is released.
Preset on Short Press*	Short Press recalls the preset level with instant ramp.
Preset on Long Press*	Long Press recalls the preset level with instant ramp.
Unused	Key does nothing. Useful for widgets to indicate status only.

* The “Preset on Short Press” and “Preset on Long Press” Key Functions are provided to allow a single key to be configured with two different Preset Levels. In older key units this was done using the Recall1 and Recall2 microfunctions, however as these functions do not work quite the same way in the Next Generation Saturn and Saturn Zen wall plates, to set up such a function, you need to create two widgets with the same group, assign “Preset on Short Press” to one and “Preset on Long Press” to the other, and then map the same key to both.

Status Indication

For all Key Functions other than “Preset”, the status of the indicator is based on the state of the group address controlled:

If the level of the group address is zero, the state is Off, and the indicator will show the Off color defined for the Widget
If the level of the group address is not zero, the state is On, and the indicator will show the On color defined for the Widget

For the “Preset” Key Function, the status of the indicator is based on the level of the group address controlled:

If the level of the group address is not equal to the Preset level, the indicator will show the Off color defined for the Widget.
If the level of the group address is equal to the Preset level, the indicator will show the On color defined for the Widget.

Where a Widget uses a timer function there is an option to indicate that the timer is active by flashing the indicator, in which case:

If the level of the group address is zero and the timer is running, the indicator will be the Off color, and blink briefly to the On color once per second.
If the level of the group address is not zero and the timer is running, the indicator will be the On color, and blink briefly to the Off color once per second.

C-Bus Ramp Rates

Lighting Key Functions that perform dimming use pre-defined Ramp Rates to control the rate of change of brightness when dimming.

The Ramp Rate is defined as the time to fade from 0% to 100% (or vice versa), so for example a 4 second ramp will take 2 seconds to reach full brightness if ramping up from a level of 50%.

Typically, a Ramp Rate setting of 4 or 8 seconds is good for use with push button dimming of lights (8 seconds is selected by default). Ramp rates of 8 or 12 seconds are good for controlling Audio functions such as Volume, and longer Ramp Rates are more useful for effect within scenes. For example a slow fade off /on.