9.691 Toggle-Switch

This page describes the device driver and the device window for the Toggle-Switch logical device. This device controls a latching relay providing only one drive coil and one or two position indication circuits. Such a switch works like a ball pen mechanics, each current pulse to the drive coil toggles the switch position once.

The Toggle-Switch logical device is part of the sat-nms framework for M&C of plain digital I/O functions. It does not interrogate a PLC device directly, but requires a low level device driver to do the physical communication. Examples for such drivers are the Fanuc-PLC9030 and the NAIS-FP0 PLC device drivers.

The device supports the usage of one or two position indication ports which tell the device in which position the switch actually is. You may define either the indicationAPort or the indicationBPort, depending on the polarity of the signal. If there are both position indication inputs configured, the device checks these to be oppositional, states an position indication fault if they are equal.

The Toggle-Switch logical device does not check if the commanded position matches the indicated position. You may use the device to generate an output pulse without reading back anything. For this, configure one of the indication ports to an arbitrary input signal and ignore the 'position' value. Instead use the 'toggle' parameter which generates an output pulse any time it gets written.

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 actual switch state.
• --- The faults page.
• --- 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
• drivePort --- The address of the PLC port which toggles the switch position. See the paragraph 'Port addressing' below for details.
• indicationAPort --- The address of the 'position A' indication port, which tells that the relay is in "A" position. May be left empty, if indicationBPort is defined.
• indicationBPort --- The address of the 'position B' indication port, which tells that the relay is in "B" position. May be left empty if indicationAPort is defined.
• pulseWidth --- The activation pulse width (msecs) to be sent to the switch for a position change. When setting this parameter, you should be aware that pulses which are shorter than the IDLE time of the PLC driver's thread may get lost. If in doubt, set the pulse width to 1100 msecs or in the VLC interface/device setup screen tune the IDLE time of the PLC driver thread to e.g. 200 msecs.
• positions --- By default the device reports the state of the output as 'A'/'B'. You may specify arbitrary texts for these states. 'positions' contains the two descriptions, separated by a comma. Please note, that the graphical "Switch" element at the sat-nms user interface requires the switch to use the 'A'/'B' selections.
• enableQuery --- Selects if the switch position selector at the first page of the device window shall query the operator before it actually switches. Default value is "NO".Please note, that changing this parameter only applies to device windows which are opened after the parameter has been changed.
• commFaultId --- By default (commFaultId is empty) the device signals a communication fault if the summary fault of the PLC device get active. This may not be exactly what you want, because the PLC device may signal a fault which does not inhibit the switching or input sampling process. You may set commFaultId to the parameter ID of a fault flag which signals the desired condition. This makes the device ignore the PLC's summary fault and use the state of this fault flag as communication fault. The SatService IO-FEP driver for example offers such a fault flag which signals that actually no switching an no input interrogation is possible (faults.17 at the IO-FEP).

Fault flags

Port addressing

A device driver for a PLC gives access to it's I/O ports through a number of integer variables. Each variable stands for up to 64 input or output ports which are addressed by the bit position within the variable.

Port (bit-) addresses in the configuration of the logical I/O devices refer to such a variable which is provided by the PLC driver and also to the bit position within this variable. The syntax of a port address specification is:

<variable-identifier> + <bit-offset>

<bit-offset> is a decimal constant in the range 0 .. 63. You may replace the + character in the port address by a percent sign ( % ) and specify the bit offset in hexadecimal notation. This may be helpful for PLC types which use hexadecimal addresses.

Example: The port address ' FANUC.Q00065+1 ' refers to the 2^1 bit in the variable ' Q00065 ' provided by the ' FANUC ' device. In fact this addresses the output table register '%Q00066' at the PLC. Other PLC drivers may use a different naming scheme for the variables, but the concept always is the same.

Switch positions

The Toggle-Switch logical device internally controls and monitors the switch position as A/B, following the names of the port configuration parameters indicationAPort and indicationBPort . This internal (not translated) switch position may differ from the switch position signalled with the position selection at the device.

Using the positions configuration parameter, the switch positions may be renamed to arbitrary values. E.g. the positions of a switch may be labelled "DUMMY LOAD" and "ANTENNA". You should however consider, that the graphical "Switch" element at the sat-nms user interface only works, if the selections for the switch are names "A" and "B".

Variables defined by this device driver