Control4 Lux Load Group Driver Documentation

Driver download

Filename: control4_lux_load_group.c4z

Lux load group driver is a load group driver for Lux devices.

Lux load group driver allows multiple Lux light devices to be controlled as a single entity. Setting a brightness for a group will cause all the devices to go to the specified brightness level. Group devices can still be controlled independently. Group can be configured as either switch or dimmer group.

Group brightness is determined based on current brightness of its members. The reported brightness level can be configured to be one of the following:

  • Lowest Load Level: Use the lowest brightness across all group devices,
  • Highest Load Level: Use the highest brightness across all group devices,
  • Specific load: Brightness of the group is the brightness of a specific load,
  • Keep Loads Synced: Brightness of the group is the last set brightness on any of its devices.

If the Keep Loads Synced mode is enabled, all group devices will be hidden from the UIs in all rooms.

System Requirements

OS 3.3.3 or newer.

Supported Devices

The following c4z drivers can be added in the group:

  • control4_lux_0_10v_dimmer.c4z
  • control4_lux_dual_dimmer_switch_keypad.c4z
  • control4_lux_keypad_dimmer_switch.c4z
  • control4_lux_light.c4z
  • control4_lux_universal_dimmer.c4z
  • control4_lux_switch.c4z (only for switch mode)

Note that this driver does not support Gen3 devices.

Properties Screen

Log Settings

  Log Level – This property allows to filter which message types display in the Lua Output window. Options 0 - 5 correspond to Fatal through Trace levels, increasing in level of verbosity.

  Log Mode – Activates logging of diagnostic information. The log level is set in the above property. Options include Off, Print (to the window), Log (to the Director Log), and Print and Log (both). Default is Off.

General Information

  Driver Version – Displays current driver version.

Color Group Settings

  Group Type – Sets the group type to either dimmer or switch.

  Device Selector – Choose which Lux devices to add to a group. List of the devices is not filtered.

  Brightness Report Mode – Specifies how brightness of the group is determined:

  • Lowest Load Level: Use the lowest brightness across all group devices,
  • Highest Load Level: Use the highest brightness across all group devices,
  • Specific load: Brightness of the group is the brightness of a specific load. Load is selected through Brightness Track Load property. If there are no devices in a group, it will automatically switch to Lowest Load Level option.
  • Keep Loads Synced: Brightness of the group is the last set brightness on any of its devices.

  Brightness Track Load – This option is only visible if Brightness Report Mode is set to Specific Load. It is a drop-down list where device can be selected. Brightness of the group will be reported as the brightness of this device.

Actions

This section lists and defines the Actions that the driver provides and are available through ComposerPro.

  Print Debug Info – Prints debug information in the lua output log.

Programming Actions

Device-specific commands are not yet implemented.

Change Log

  • Version 14
    • Add support for switch groups
  • Version 13
    • Fix advanced lighting scenes.
  • Version 12
    • Initial version