User Manual

9.148 Conditional-Replicator

The Conditional-Replicator logical device replicates a parameter value from one device to a destination selected from a configured list of parameters. Selecting the destination is done by comparing a reference value read (typically from the source device) to reference values which are assigned to the destinations.

Copying the parameter value happens only on an operators request by clicking the 'REPLICATE' button. This button click also may be done programmatically by sending an arbitrary text to the 'take' variable of the Conditional-Replicator.

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 .

--- Contains the 'REPLICATE' button.
--- The device info page.
--- The maintenance page. The configuration parameters from this page are described below.

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameter which must be set to interconnect the Conditional-Replicator device with the devices it shall connect.

parameter	description
sourceId	Enter the message identifier here of the parameter the Conditional-Replicator shall read and copy, e.g. "MODULATOR.tx.dataRate".
sourceRefId	Enter the message identifier here of the reference value the Conditional-Replicator shall read before copying to select the destination to copy to, e.g. "MATRIX.output.04".
destIds	Enter a comma separated list of message identifiers the Conditional-Replicator shall use as destinations. The list of reference values described below controls to which destinations the Conditional-Replicator actually copies the source value.
destRefValues	Enter a comma separated list of values here which define to which destination the device will copy its source value. If the reference value read from sourceRefId matches a value in this list, the source value is copied to the destination defined by the message identifier at the same position in the destIds list.

Remarks

The destIds and destRefValues lists should not contain any space characters before or after the comma separators unless the space character is intended as a part of the (reference) value.
The destRefValues list may contain the same value multiple times. In this case the Conditional-Replicator will copy its source value to multiple destinations if this value matches the reference value.
In general TEXT or CHOICE type parameters should be used for the selection of the copy destinations. If you want to use a FLOAT for this, be sure to format the reference values in the destRefValues list in exactly the same way as the parameter would appear in the user interface. For comparison the Conditional-Replicator formats the floating point value read from sourceRefId following the range definition of this parameter and then compares this value (without unit string) to the values listed in destRefValues.

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.frame	TEXT	R/O	StringRange R/O
info.state	TEXT	R/O	StringRange R/O
config.sourceId	TEXT	SAVE SETUP	StringRange
config.sourceRefId	TEXT	SAVE SETUP	StringRange
config.destIds	TEXT	SAVE SETUP	StringRange
config.destRefValues	TEXT	SAVE SETUP	StringRange
take	TEXT	NOPRESET	StringRange