Timer Widget

The Timer Widget provides timer functions for Lighting Groups. For example, turning a group on for 10 minutes and then turning it off.

It implements the traditional "Toggle Timer" and “Retrigger Timer” behaviors, which work the same way as previous key units, but offer more flexibility with the ability to specify both the initial and expiry levels as well as the initial and final ramp rates.

In addition, there are several new types of Timer:

The “Delay Timer” starts a timer but does not emit an initial event, allowing a delayed event without affecting the current state of the Group.
The “Pulse Timer” is similar to a normal “Retrigger Timer”, but the initial event is always emitted, regardless of the Group state.
The “Toggle Timer with On” works the same as the “Toggle Timer”, but also allows the Group to be turned on without a timer by using a long press. This is useful for example a light in a room such as a pantry or a laundry where you normally want a timer to automatically switch the light off after a few minutes, but occasionally you need the light to stay on.

The specific behavior of the Timer Widget is selected by choosing the desired Key Function.

Key Function	Description
Retrigger Timer	If the unit is not currently the Active unit for the group, or if the widget level and the current target level of the group are different, the initial event is generated. At the expiry of the timer, the expiry event is generated. If the group is on, long press turns the group off and cancels the timer.
Toggle Timer	If group is off, short press turns on the group at the specified level with the specified ramp rate and starts the timer. At the expiry of the timer, the expiry event is generated. If the group is on, short press turns the group off with the same ramp as the initial event.
Delay Timer	Short press starts the timer, without generating an event. At the expiry of the timer, the expiry event is generated. Long press does nothing.
Pulse Timer	Short Press sends the initial event, regardless of group state, and starts the timer. Long press does nothing.
Toggle Timer with On	Same as Toggle Timer but Long Press turns group on without starting the timer.

Status Indication

The status of the indicator is based on the state of the group address controlled, and whether the timer is active:

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 a timer is active the indicator will blink briefly to the On color once per second.
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.
- If a timer is active the indicator will blink briefly to the Off color once per second.