Local Sets Driver

Overview

The Local Sets driver provides named, mutually exclusive selection groups (radio-button behavior) that are managed entirely within the RTI processor —no external device is required. Each set contains between 1 and 20 named items. Selecting any item in a set automatically deselects all other items in that set. A selection can also be cleared entirely, leaving the set with no active selection.

Selection state is maintained independently for each RTI interface device connected to the processor, so different panels can hold different selections at the same time.

Configuration

Settings are found under the driver’s configuration page in Integration Designer.

General

Local Set Count (SetCount) — Integer. The total number of sets to activate (1–20). Only the configuration categories for sets 1 through this value will appear.

Set N

Name (SetNName) — String. A human-readable label for the set (e.g., “Audio Source”, “Video Zone”). Default: “Set 0N”.

Item Count (SetNItemCount) — Integer (1–20). The number of items within the set. Default: 3.

Item Name (SetNItemMName) — String. A label for each item (e.g., “Apple TV”, “Blu-ray”). One setting appears for each item up to the configured Item Count. Defaults: “Item 01”–“Item 20”.

System Variables

All variables are Boolean. Variables are per-device (each connected interface maintains its own copy, indicated by the % suffix on the system variable name).

The following variables are created for each active set (Set 1 through Set N).

[Set Name] State (category)

Has Selection (SetNHasSelection%) — true when any item in the set is currently selected; false when the selection has been cleared.

Has NO Selection (SetNHasNoSelection%) — Inverse of Has Selection. true when the set has no active selection.

[Item Name] Selected (SetNItemMSelected%) — true when this specific item is the active selection in its set. One variable per item.

[Item Name] NOT Selected (SetNItemMNotSelected%) — Inverse of [Item Name] Selected. true when this item is not selected. One variable per item.

System Functions

The following functions are created for each active set (Set 1 through Set N). All functions accept hidden parameters (setIndex, itemIndex, view) that are pre-populated by the driver and are not visible to the programmer.

[Set Name] Controls (category)

Clear Selection (clearSelection:N) — Clears the current selection for the set. After calling this function, Has Selection becomes false and Has NO Selection becomes true. All [Item Name] Selected variables are set to false.

Select [Item Name] (selectItem:N_M) — Selects the named item within the set. All other items in the set are automatically deselected. One function is available for each configured item.

Events

Local Set Events (category)

Initialized — Fired once when the driver finishes loading and all sets have been configured. Use this event to run an initialization macro that sets default selections for any sets that require a pre-selected state at startup.

Notes

- Selection state is volatile. It is not persisted across processor reboots. Use the Initialized event to restore desired default states after a restart.

- Because state is tracked per-device, clearing or changing a selection on one panel does not affect the state displayed on another panel.

- Up to 20 sets, each with up to 20 items, can be configured in a single instance of this driver (400 items total).