Universal Device Driver Reference Manual

1.375 Monitor-Switch

This page describes the device driver and the device window for the Monitor-Switch logical device. This device can be used to setup a monitoring device (e.g. a test converter or a measuring device) to measure the signal from a certain signal chain in the station. The Monitor-Switch logical device controls a N:1 signal switch in front of the monitoring device in order to select the appropriate signal and it copies one parameter value (typically a frequency) from an arbitrary device in each chain to the testing / monitoring device.

Device window pages

The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .

--- Sets / shows the monitor switch position.
--- The device info page.
--- The maintenance page. The configuration parameters described below are set at this page.

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameters which must be set to integrate the device into the VLC/M&C.

parameter	description
choices	The list of choices presented to the operator for the 'position' parameter. For each signal to monitor, a unique name must be provided. The list entries must be separated by comma characters. The device will automatically add an "UNKNOWN" selection in front of the given list of entries. Example: " PROG-1,PROG-2,PROG-3 "
sourceIds	A comma separated list of parameter identifiers. The device will use the parameter id at the same list position as the selected 'position' value owns in the choices list above and will copy the corresponding parameter value to the destination parameter defined below. Example: " UPC-1.tx.frequency,UPC-2.tx.frequency,UPC-3.tx.frequency "
destinationId	The ID of the parameter to copy the source value to. Example: " TEST-CONVERTER.frequency "
positions	A comma separated list of switch positions which are applied to the input signal selection switch in front of the monitoring device. Example: " 1,2,3 "
switchId	The parameter ID controlling the position of the switch in front of the monitoring device. Example: " S05.position "

Remarks

The Monitor-Switch device does not read back the switch position. This is because the 'positions' translation table is not necessarily one-to-one, the primary position cannot be derived non-ambiguously from the hardware switch position. As a consequence, the Monitor-Switch device wakes up after system boot showing the position "UNKNOWN".
The destination parameter is only set when the position parameter is commanded. Later changes of the source parameter assigned to the selected position are ignored.

Variables defined by this device driver

name	type	flags	range
info.driver	TEXT	R/O	StringRange R/O
info.type	TEXT	R/O	StringRange R/O
info.port	TEXT	R/O	StringRange R/O
info.frame	TEXT	R/O	StringRange R/O
config.choices	TEXT	SAVE SETUP	StringRange
config.sourceIds	TEXT	SAVE SETUP	StringRange
config.destinationId	TEXT	SAVE SETUP	StringRange
config.positions	TEXT	SAVE SETUP	StringRange
config.switchId	TEXT	SAVE SETUP	StringRange
position	CHOICE		EnumRange (UNKNOWN)