You are on page 1of 29

Windows SCADA

Mapboard Driver
User Guide
____________________________________________
Document Number: MB-400

Presentation Date: June 15, 2016


Prepared By: Rick Hayden
Version: 1.1
Copyright, Notices and Trademarks
Copyright © 2016 Survalent Technology Corporation. All rights reserved.
The software described in this document is furnished under license and
can only be used or copied in accordance with the terms of such license.
The content of this manual has been carefully checked for accuracy.
However, if you find any errors, please notify the Survalent Technology
Corporation.

Survalent Technology Corporation


2600 Argentia Road
Mississauga, Ontario L5N 5V4

(905) 826 5000

(905) 826 7144

support@survalent.com

www.survalent.com
FAX (905) 826-7144

About This Publication

This manual describes the functionality and data entry requirements for the Mapboard
Driver used in the Windows SCADA system.
.

Mapboard Driver User’s Guide Revisions


Windows SCADA
Revisions

Date Description
January 6, 2005 New manual.
June 15, 2016 Added Mauell protocol

Mapboard Driver User’s Guide Revisions


Windows SCADA
Contents

1 Introduction 1-1

2 Operation of Mapboard Driver 2-1

2.1 Mapboard Protocols ........................................................................................................................2-1


2.2 Polling Scheme ...............................................................................................................................2-1
2.3 Communication Via TCP/IP ...........................................................................................................2-2
2.4 Port Switching .................................................................................................................................2-2
2.5 Same Point Driving Multiple Lamps ..............................................................................................2-2
2.6 Multiple Points Driving the Same Lamp ........................................................................................2-3

3 Mapboards 3-1

3.1 Mapboard Data Fields - General .....................................................................................................3-1


3.1.1 Status ...........................................................................................................................................3-2
3.1.2 Protocol .......................................................................................................................................3-2
3.1.3 Auto Start ....................................................................................................................................3-2
3.1.4 Blank Display on Start-up ...........................................................................................................3-3
3.1.5 Full Update Interval .....................................................................................................................3-3
3.1.6 Time Between Scans ...................................................................................................................3-3
3.1.7 Health Check Interval ..................................................................................................................3-3
3.1.8 Synchronization Interval .............................................................................................................3-4
3.1.9 Configuration Switches ...............................................................................................................3-5

Mapboard Driver User’s Guide Contents i


Windows SCADA
3.2 Mapboard Data Fields - Connection ...............................................................................................3-6
3.2.1 Network .......................................................................................................................................3-6
3.2.2 Port Parameters............................................................................................................................3-6
3.2.3 After n Errors...............................................................................................................................3-8
3.3 Mapboard Data Fields - Test ...........................................................................................................3-9

4 Macros 4-1

4.1 Case Statement ................................................................................................................................4-3

5 Indications 5-1

5.1.1 Point.............................................................................................................................................5-2
5.1.2 Mapboard.....................................................................................................................................5-2
5.1.3 Controller.....................................................................................................................................5-2
5.1.4 Address ........................................................................................................................................5-2
5.1.5 Macro...........................................................................................................................................5-2

6 Numerics 6-1

6.1.1 Point.............................................................................................................................................6-2
6.1.2 Mapboard.....................................................................................................................................6-2
6.1.3 Controller.....................................................................................................................................6-2
6.1.4 Address ........................................................................................................................................6-2
6.1.5 Width ...........................................................................................................................................6-2
6.1.6 Decimal Digits .............................................................................................................................6-2
6.1.7 Macro...........................................................................................................................................6-2

Mapboard Driver User’s Guide Contents ii


Windows SCADA
1 Introduction

This document describes the functionality and database entry requirements for the Windows SCADA
Mapboard driver.

The Mapboard driver is designed to operate on a Survalent SCADA master station for Windows and to
communicate with one or more mapboard display panels.

Chapter 2 summarizes the operation of the Mapboard driver.

Chapters 3 to 6 describe the database entry requirements for the Mapboard driver. They describe how to
use the Survalent STC Explorer to define:

 Mapboards
 Macros
 Indicators
 Numerics

Mapboard Driver User’s Guide Introduction 1-1


Windows SCADA
2 Operation of Mapboard Driver

2.1 Mapboard Protocols


The Mapboard driver supports the CIS and the Mauell protocols.

The CIS Mapboard display protocol was developed by Computer Inquiry Systems Inc. (now called EL-
CAT Inc.). Other companies, such as SACO Controls Inc., have developed Mapboard displays which also
uses the same CIS protocol.

The Mauell Mapboard display protocol was developed by Bilfinger Mauell Corporation.

2.2 Polling Scheme


On startup, the Mapboard driver will connect to the Mapboard via the specified network device. If the
Blank Display on Startup option has been checked, the Mapboard driver turns off all the lamps on the
Mapboard. The Mapboard driver then sends commands to all the lamp and indicator addresses of the
Mapboard assigned to SCADA database points.

The Mapboard driver scans the assigned SCADA database points for changes and sends these changes
to the Mapboard on a periodic basis. You can control the frequency of the scan via the Time Between
Scans field. See section 3.1.6, Time Between Scans.

Mapboard Driver User’s Guide Operation of Mapboard Driver 2-1


Windows SCADA
The Mapboard driver refreshes the entire mapboard at a frequency that you control via the Full Update
Interval field. See section 3.1.5, Full Update Interval.

The Mapboard driver requests the internal status of the mapboard at a frequency that you control via the
Health Check Interval field. See section 3-3, Health Check Interval.

If supported by the protocol, the Mapboard driver sends synchronization messages at a frequency that
you control via the Synchronization Interval field.

2.3 Communication Via TCP/IP


Even if the mapboards do not have Ethernet interfaces, it is still possible to make use of the network to
communicate by connecting to them through terminal servers. Although it is necessary for the Mapboard
driver to use TCP/IP to reach the terminal servers, the data coming out of the RS232 or RS485 terminal
server ports is the selected Mapboard protocol.

2.4 Port Switching


If an alternate port is defined, the Mapboard driver will switch to the alternate port when communication
on the primary port fails. In this case, only if communication on both primary and alternate ports fails is
the Mapboard declared failed. A status point is used to indicate which port is currently in use. See
section 3.2.2, Port Parameters.

This feature may be used to make use of redundant terminal servers and to avoid resorting to failover
when a mapboard port fails.

2.5 Same Point Driving Multiple Lamps


The same SCADA database point may be assigned to multiple lamp addresses. For example, if your
mapboard contains three separate lamps to indicate open, closed and error conditions, you can select a
SCADA database point three times with three different lamp addresses and three different Macros.

Mapboard Driver User’s Guide Operation of Mapboard Driver 2-2


Windows SCADA
2.6 Multiple Points Driving the Same Lamp
If a single lamp is driven by multiple SCADA database points, the lamp is operated by the highest priority
case that produces a TRUE result for any of the points. See section 4.1 for a discussion on case priority.

To illustrate how this feature can be used, consider the Macro in Figure 4-2. If you assign just one
SCADA database point to a lamp address, you get the following:

 If the point is in the abnormal state AND has an unacknowledged alarm, the lamp Fast Flashes

 Else, if the point is in the abnormal state, the lamp is ON

 Otherwise, the lamp is OFF

If you assign multiple SCADA database points to the same lamp address (and use the same Macro), you
get the following:

 If any of the points are in the abnormal state AND has an unacknowledged alarm, the lamp Fast
Flashes

 Else, if any of the points are in the abnormal state, the lamp is ON

 Otherwise, the lamp is OFF

Mapboard Driver User’s Guide Operation of Mapboard Driver 2-3


Windows SCADA
3 Mapboards

This chapter describes how to define a Mapboard for the Windows SCADA system. The STC Explorer is
used to create or modify a mapboard’s definition. The dialog box that allows you to do that has several
tabs, each of which contains different data.

3.1 Mapboard Data Fields - General


The General tab on the Edit Mapboard dialog (see Figure 3-1) contains the data fields discussed below.

NOTE: After creating or changing a Mapboard definition, a Mapboard Macro or editing the display
address or Macro for any points on the Mapboard, remember to come back to this dialog to restart the
Mapboard driver.

Mapboard Driver User’s Guide Mapboards 3-1


Windows SCADA
Figure 3-1 Edit Mapboard Dialog (General)

3.1.1 Status
This is the status point that will be used by the Mapboard driver to indicate the Up or Down status of the
mapboard. The status point is not optional. It must be specified.

3.1.2 Protocol
This is the name that identifies the protocol to be used to communicate with the mapboard. Select the
CIS protocol for CIS and SACO mapboards. Select Mauell protocol for Bilfinger Mauell mapboards.

3.1.3 Auto Start


Set this flag if you want the Mapboard driver to start automatically when the SCADA system starts up,
either initially, or as the result of a failover.

Mapboard Driver User’s Guide Mapboards 3-2


Windows SCADA
3.1.4 Blank Display on Start-up
Set this flag if you want the display blanked by the Mapboard driver whenever it starts up, before updating
all assigned lamp and indicator addresses. This option is useful when SCADA database point
assignments to lamps have changed or have been decommissioned and you do not want nuisance lamp
displays.

Alternatively, you could use the Test page to manually turn off all lamps and then resume normal
operations. See section 3.3,Mapboard Data Field Test

3.1.5 Full Update Interval


This parameter specifies the interval, in seconds, that the Mapboard driver will update all assigned lamp
and indicator addresses for the mapboard, whether the points have changed or not.

If this value is zero, then a full update will not take place, only changes are sent to the Mapboard. In this
case, the Mapboard driver will only do a full update on startup.

If this value is one second, then on every Time Between Scans interval, the Mapboard driver will update
all assigned lamp and indication addresses.

For any other value, at the specified interval, the Mapboard driver will update all assigned lamp and
indication addresses.

3.1.6 Time Between Scans


This parameter specifies the interval in seconds that the Mapboard driver scans for changes to the
SCADA database points assigned to this mapboard. Normally, only the point values that have changed
are sent to the mapboard but depending on the Full Update Interval, all defined lamp and indication
addresses may be sent to the mapboard. See Full Update Interval.

3.1.7 Health Check Interval


This parameter specifies the interval in seconds that the Mapboard driver will sent a command to request
the internal status of the mapboard display.

For the CIS protocol, Table 3-1 illustrates the alarms that may be raised against the mapboard status
point for the specified conditions at the mapboard.

For the Mauell protocol, controllers are polled in a round-robin fashion. One controller is polled for each
Health Check Interval. Only controllers defined for indications or numeric displays are polled. Table 3-2
illustrates the alarms that may be raised against the mapboard status point for the error conditions at the
controller.

Mapboard Driver User’s Guide Mapboards 3-3


Windows SCADA
Table 3-1 CIS Internal Status Alarms
Field Bit State Alarm Raised
W 0 1 DCU Reloaded
W 1 0 DCU Not Running
X 2 0 DCU Not in RUN/LOCK
Y 0 1 DCU Key Switch Change
Z 1 0 Lamp Power Abnormal
Z 0 0 DMUX Power Abnormal

Table 3-2 Mauell Error Alarms


Error Alarm Raised
0x01 Receiver overrun
0x02 Queue rollover
0x04 Invalid command syntax
0x10 Watch Dog Timer
0x20 Stack Overflow
0x80 Receive Error

3.1.8 Synchronization Interval


This parameter specifies the interval in seconds that the Mapboard driver will sent a command to
synchronize the mapboard.

For the CIS protocol, this parameter is not used, enter zero.

For the Mauell protocol, this command will synchronize all the controllers at once. The synchronization
interval must be a multiple of 2 seconds and must be a factor of 60 seconds. Best practices is to use 10
second intervals.

Mapboard Driver User’s Guide Mapboards 3-4


Windows SCADA
3.1.9 Configuration Switches
This field allows you to specify certain “command line” switches to control the behavior of the Mapboard
driver. The switches supported are described below. Specify each switch you need by entering
/name=value in this field. You do not need to add a space or punctuation (other than the “/”) between
switches.

/LogPath
The LogPath option overrides the default folder that is used when logging communications to a file. If
this option is specified, it must precede the Log option and the folder must exist. If there are any
spaces in the name of the folder, then quotes are required around the name. For example,
/LogPath=”D:\My Logging”.

/Log
The Log option specifies the Mapboard driver is to log communications to a file. The file will be
created in the folder specified when Windows SCADA was installed; the default folder is C:\Program
Files\Quindar\ScadaServer. The file name is comprised of the Mapboard id and the current date. For
example, a file from Mapboard 1 on January 3, 2005 would be MAPBOARD1-2005-01-03.log. If you
wish to change the default folder for logging, see the LogPath option.
Note: If this option is specified, the Mapboard driver will log the communications to a file until the
driver has been stopped. The file can become quite large and may consume the entire disk if left too
long.
The valid values for this option are:

 Hex – Log all communication, including raw data in hexadecimal form


 Errors – Log only communication errors
 Debug – Similar to “hex”, with additional details
 All – Log all communication

Mapboard Driver User’s Guide Mapboards 3-5


Windows SCADA
3.2 Mapboard Data Fields - Connection
The Connection tab on the Edit Mapboard dialog (see Figure 3-2) contains the data fields discussed
below.

Figure 3-2 Edit Mapboard Dialog (Connection)

3.2.1 Network
This specifies the type of communication network to be used. Choose COMM for mapboards that will
communicate directly through a serial port on the SCADA host (i.e. a COM port known to Windows).
Choose TCP/IP for all connections that rely on the TCP/IP network, such as serial ports on terminal
servers.

3.2.2 Port Parameters


The editor provides for up to two communication ports. If information is provided for both ports, the
Mapboard driver can switch from one to the other if communication using the first port is not successful.

Each port corresponds to a physical or logical connection from the host computer to the communication
medium. The type of Network (see section 3.2.1, Network) determines how these fields are used. For
COMM networks, the port means a serial port attached to the host computer.

Mapboard Driver User’s Guide Mapboards 3-6


Windows SCADA
For TCP/IP networks, a port might mean a serial port on an external terminal server, or it may mean a
network connection identified by a host name (or address) and port number.

Host Name
When Network is set to COMM:

 For Mapboard drivers that use a local serial port, this must be the name that identifies the
serial port. It will be of the form COMn where n is a number uniquely identifying the serial
port. This is the same name that Windows uses to identify the port.

When Network is set to TCP/IP:

 For Mapboard drivers that use TCP/IP, this will usually be the name that identifies the other
device that we are communicating with over the network. It may be the mapboard display
itself, or more commonly, a terminal server. It may be a fixed IP address (of the form
nnn.nnn.nnn.nnn), or preferably, a name known to the SCADA host computer (such as may
be specified in the Windows HOSTS file, or by another name-resolution means).

Host Port
When Network is set to TCP/IP:

 For a TCP/IP connection, there will be a TCP/IP port number that must be entered here. For
terminal servers, this will correspond with the number of the desired physical serial port.
Consult the terminal server documentation to determine which port numbers to use.

When Network is set to COMM:

 This field is not used if the network type is not TCP/IP.

Baud Rate, Parity


When Network is set to COMM:

 Select from the available choices for baud rate and parity, if your Network uses a local serial
port. Note that the hardware you are using must support the chosen settings as well.

When Network is set to TCP/IP:

 You cannot use these fields for a TCP/IP Network. In the case of a terminal server or similar
device that will provide a serial port, this information must be programmed into that device,
and not here.

Switch
If two ports have been defined, this port switch status point is required. The point is used to show which
port the mapboard is currently communicating on. When the point’s value is 0, the Mapboard driver is
using the first port. When the status point’s value is 1, the Mapboard driver is using the second port.
Whenever it wants to poll, the Mapboard driver first tries the port currently indicated by the port switch
status point. If the poll fails, the Mapboard driver retries. If the After n errors count expires, the Mapboard
driver switches to the other port and sets the port switch status point accordingly.

Mapboard Driver User’s Guide Mapboards 3-7


Windows SCADA
If polling fails there also, After n errors count expires, the driver declares the mapboard failed, but
continues to poll the mapboard, flipping between both ports as described above.

You can force the Mapboard driver to either port by manually setting the port switch status point.

The port switch status point should be defined as a non-alarm point because you don’t want to be
bothered by alarms on this point when the driver is constantly switching ports.

While the Mapboard driver is using one particular port, it does not check the other port for availability.
Such checks can be made manually by manually setting the port switch point. If you do this, don’t forget
to remove the manual set, or the driver will not be able to switch ports when it needs to. If you define the
port switch point as a control point associated with a dummy scan task, then you don’t have to worry
about manual set. Alternatively, you can automate the forced switching process via a command
sequence.

3.2.3 After n Errors


Enter the number of consecutive error responses (timeouts, wrong replies, security errors, etc.) that will
be tolerated before the Mapboard driver switches from the current port to the other one. If the entered
value is zero, the Mapboard driver defaults to 3.

The Mapboard driver also uses this value (times 2), to establish the number of retries before failing the
Mapboard. If the entered value is zero, the Mapboard driver defaults to 3*2 or 6 for the retry count.

Mapboard Driver User’s Guide Mapboards 3-8


Windows SCADA
3.3 Mapboard Data Fields - Test
The Test tab on the Edit Mapboard dialog (see Figure 3-3) is a maintenance feature that can be used to
verify the working status of the lamps on the Mapboard display. During the testing period, the Mapboard
driver does not send changes to the mapboard nor does it poll for internal status until the operation
Resume normal mapboard functions has been performed.

To verify the lamps on the mapboard display, select an Operation (see Table 3-3) and a Station (if
required by the Operation), and click Send. When completed testing, remember to perform the operation
Resume normal mapboard functions. Otherwise, a reminder alarm will be generated every 3 minutes.

Table 3-3 Operations


Operation Meaning
Turn OFF all the display lights, not just the lights with defined
Turn OFF all lights addresses for this Mapboard.

Turn ON all the display lights, not just the lights with defined
Turn ON all lights addresses for this Mapboard.

Turn OFF only the display lights that correspond to points on the
Turn OFF all lights for station selected station.

Turn ON only the display lights that correspond to points on the


Turn ON all lights for station selected station.

Resume normal mapboard Stop testing, perform a complete refresh of all display lamps and
functions return to normal polling and updating.

Turn OFF all display lights and disable Mapboard updates. No


reminder alarm will be generated. The Mapboard updates will remain
Inhibit mapboard and turn OFF disabled until the Mapboard is restarted or when SCADA is restarted,
all lights or on failover or when Resume normal mapboard functions has been
performed. If you want to permanently disable the Mapboard, set the
Mapboard status point to failed.

Mapboard Driver User’s Guide Mapboards 3-9


Windows SCADA
Figure 3-3 Edit Mapboard Dialog (Test)

Mapboard Driver User’s Guide Mapboards 3-10


Windows SCADA
4 Macros

This chapter describes how to define a Mapboard Macro for the Windows SCADA system. The STC
Explorer is used to create or modify a Macro’s definition. To access the Macros, click “+” on Mapboards to
expand the tree, then click Macros. The Macro dialog box is illustrated in Figure 4-2.

Each Macro can have up to six cases, which is one case for every possible lamp action. Macros are
evaluated in priority order from case 1 through to case 6. Therefore, you should plan your cases
accordingly. Evaluation continues until the first case that produces a TRUE result, then the resulting lamp
action is performed. If all cases have been evaluated without a TRUE, the default lamp action is OFF.

To prevent unexpected behavior, it is strongly suggested that Macros be defined in such a way that the
last case evaluated always produces a TRUE result. See Figure 4-1. This may be of particular interest
when you do not want the default lamp action to be OFF.

Figure 4-1 Case Statement – Always Produces a TRUE Result

Mapboard Driver User’s Guide Macros 4-1


Windows SCADA
Figure 4-2 Edit Mapboard Macro

The Macro illustrated in Figure 4-2 contains three cases that will do the following:

 Case 1 will set the lamp to Fast Flash, if the point being evaluated is in its abnormal state AND
the point has an unacknowledged alarm

 If case 1 did not return TRUE, case 2 will set the lamp to ON if the point being evaluated is in its
abnormal state

 If case 2 did not return TRUE, case 3 will always set the lamp to OFF, as <Ignore> produces a
FALSE result, but because NOT is checked the result is changed to a TRUE result

 Cases 4, 5 and 6 are never evaluated because case 3 always produces a TRUE result

Mapboard Driver User’s Guide Macros 4-2


Windows SCADA
4.1 Case Statement
A case statement contains a left predicate that can be “AND” or “Or” together with the right predicate. See
Figure 4-3. If AND is selected, then both predicates must produce a TRUE result for the case to be
TRUE. If OR is selected, then at least one of the predicates needs to produce a TRUE result for the case
to be TRUE. If the case produces a TRUE result, then the selected action will be performed, otherwise no
action will be performed.

Figure 4-3 Case Statement – Two Predicates

If only one predicate is required for the case, then for the left predicate make your selection from the
drop-down list, select OR and select <Ignore> for the right predicate. See Figure 4-4. The <Ignore>
predicate will always return a FALSE result, so the left predicate you selected must produce a TRUE
result for the case to be TRUE and the action to be performed.

Figure 4-4 Case Statement – One Predicate

Predicate results for status points are listed in Table 4-1. For analog points, the predicate results are
listed in Table 4-2, and for stations, they are listed in Table 4-3. A predicate result can be negated by
checking the NOT flag. That is, a FALSE result will become a TRUE result and vice versa.

The possible actions for lamps are listed in Table 4-4. Note, however, that not all mapboards may be
able to perform these actions. Check with your mapboard documentation.

Mapboard Driver User’s Guide Macros 4-3


Windows SCADA
Table 4-1 Predicate Results for Status Points
Predicate Result for Status points
<Ignore> Always returns FALSE.
State=0 Return TRUE if point in state 0.
State=1 Return TRUE if point in state 1.
State=2 Return TRUE if point in state 2.
State=3 Return TRUE if point in state 3.
State=Normal Return TRUE if point in normal state.
State=Abnormal Return TRUE if point in abnormal state.
Condition=Failed Return TRUE if points condition is telemetry failed.
Condition=Normal Return TRUE if points condition is normal.
Condition=Manual Return TRUE if points condition is manual set.
Interlocked Return TRUE if point is interlocked.
Selected for control Return TRUE if point is being controlled.
Unacknowledged Alarm Return TRUE if point has an unacknowledged alarm.
Outstanding Alarm Always returns FALSE.
Tag=Full Return TRUE if point has a full tag.
Tag=None Return TRUE if point is not tagged.
Tag=Any Restrictive Return TRUE if point has a tag that prevents operation.

Alarm=Lo Unreasonable Always returns FALSE.


Alarm=Lo Emergency Always returns FALSE.
Alarm=Lo Pre Emergency Always returns FALSE.
Alarm=Hi Unreasonable Always returns FALSE.
Alarm=Hi Emergency Always returns FALSE.
Alarm=Hi Pre Emergency Always returns FALSE.

Mapboard Driver User’s Guide Macros 4-4


Windows SCADA
Table 4-2 Predicate Results for Analog Points
Predicate Result for Analog points
<Ignore> Always returns FALSE.
State=0 Always returns FALSE.
State=1 Always returns FALSE.
State=2 Always returns FALSE.
State=3 Always returns FALSE.
State=Normal Return TRUE if point in normal alarm limit range.
State=Abnormal Return TRUE if point not in normal alarm limit range.
Condition=Failed Return TRUE if points condition is telemetry failed.
Condition=Normal Return TRUE if points condition is normal.
Condition=Manual Return TRUE if points condition is manual set.
Interlocked Return TRUE if point is interlocked.
Selected for control Always returns FALSE.
Unacknowledged Alarm Return TRUE if point has an unacknowledged alarm.
Outstanding Alarm Always returns FALSE.
Tag=Full Return TRUE if point has a full tag.
Tag=None Return TRUE if point is not tagged.
Tag=Any Restrictive Return TRUE if point has a tag that prevents operation.
Alarm=Lo Unreasonable Return TRUE if point is in Lo Unreasonable alarm.
Alarm=Lo Emergency Return TRUE if point is in Lo Unreasonable alarm.
Alarm=Lo Pre Emergency Return TRUE if point is in Lo Emergency alarm.
Alarm=Hi Unreasonable Return TRUE if point is in Lo Pre Emergency alarm.
Alarm=Hi Emergency Return TRUE if point is in Hi Emergency alarm.
Alarm=Hi Pre Emergency Return TRUE if point is in Hi Pre Emergency alarm.

Mapboard Driver User’s Guide Macros 4-5


Windows SCADA
Table 4-3 Predicate Results for Stations
Predicate Result for Stations
<Ignore> Always returns FALSE.
State=0 Always returns FALSE.
State=1 Always returns FALSE.
State=2 Always returns FALSE.
State=3 Always returns FALSE.
State=Normal Always returns FALSE.
State=Abnormal Always returns FALSE.
Condition=Failed Always returns FALSE.
Condition=Normal Always returns FALSE.
Condition=Manual Always returns FALSE.
Interlocked Always returns FALSE.
Selected for control Return TRUE if any point on the station is selected for control.
Unacknowledged Alarm Return TRUE if any point on the station has an unacknowledged
alarm.
Outstanding Alarm Return TRUE if any point on the station has an outstanding alarm
higher than priority zero.
Tag=Full Always returns FALSE.
Tag=None Always returns FALSE.
Tag=Any Restrictive Always returns FALSE.
Alarm=Lo Unreasonable Always returns FALSE.
Alarm=Lo Emergency Always returns FALSE.
Alarm=Lo Pre Emergency Always returns FALSE.
Alarm=Hi Unreasonable Always returns FALSE.
Alarm=Hi Emergency Always returns FALSE.
Alarm=Hi Pre Emergency Always returns FALSE.

Table 4-4 Lamp Action

Lamp Action
Off
On
Slow Flash
Fast Flash
Dim
Modulate

Mapboard Driver User’s Guide Macros 4-6


Windows SCADA
5 Indications

This chapter describes how to define indication lamps for the Mapboard driver. The Edit Mapboard
Indication dialog from the STC Explorer is illustrated in Figure 5-1. This editor is used to assign SCADA
database points to lamps on the mapboard. For each database point, you specify the mapboard, the lamp
address and a Mapboard Macro (that you previously defined). The Macro specifies how the database
point values drive the lamps.

Figure 5-1 Edit Mapboard Indication

Mapboard Driver User’s Guide Indications 5-1


Windows SCADA
5.1.1 Point
This field contains the SCADA database point name that will be assigned to the lamp address on the
mapboard. Analog points, status points and stations may be dropped into this field.

Next to this field is a “browse” button, which will call up the point browser as described in DB-400,
Database Editing Overview. You can use the browser window to drag point names into this field.

5.1.2 Mapboard
This field specifies the mapboard to which the SCADA database point name will be assigned. Select the
desired mapboard from the drop-down list.

5.1.3 Controller
This field specifies the mapboard controller to which the SCADA database point is to be assigned.

For the CIS protocol, this field is not used, enter zero.

For the Mauell protocol, this field is required. The controller number is entered in decimal and ranges from
0 to 255.

5.1.4 Address
This field specifies the mapboard lamp address to which the SCADA database point is to be assigned.

For the CIS protocol, the required address is a DMUX address. This number is entered in octal (base 8)
and ranges from 0 to 6777 for 4 digit addresses (most common) and 0 to 37776 for 5 digit addresses.
Leading zeros are not required. Note that address 7777 for 4 digit addresses and 37777 for 5 digit
addresses will address all lamps on the mapboard and therefore should not be used.

For the Mauell protocol, this field is required. The address is entered in decimal and ranges from 0 to 127
for DO128 controllers.

5.1.5 Macro
This field contains the Mapboard Macro (that you previously defined) that specifies how the SCADA
database point value is to drive the lamp. Select the Macro from the drop-down list. See Chapter 4,
Macro, for a discussion on defining Macros.

For the Mauell protocol, when defining Macros for DO128 controllers, the lamp actions that are available
are OFF, ON, Slow Flash and Fast Flash.

Mapboard Driver User’s Guide Indications 5-2


Windows SCADA
6 Numerics

This chapter describes how to define numeric indicators for the Mapboard driver. The Edit Mapboard
Numeric dialog from the STC Explorer is illustrated in Figure 6-1. This editor is used to assign SCADA
database points to numeric indicators on the mapboard. For each database point, you specify the
mapboard, the indicator address, the total field width, number of decimal digits and a Mapboard Macro
(that you previously defined). The Macro specifies how the database point values drive the indicators.

Figure 6-1 Edit Mapboard Numeric Dialog

Mapboard Driver User’s Guide Numerics 6-1


Windows SCADA
6.1.1 Point
This field contains the SCADA database point name that will be assigned to the numeric indicator
address on the mapboard. Only Analog points may be dropped into this field.

Next to this field is a “browse” button, which will call up the point browser as described in DB-400,
Database Editing Overview. You can use the browser window to drag point names into this field.

6.1.2 Mapboard
This field specifies the mapboard to which the SCADA database point name will be assigned. Select the
desired mapboard from the drop-down list.

6.1.3 Controller
This field specifies the mapboard controller to which the SCADA database point is to be assigned.

For the CIS protocol, this field is not used, enter zero.

For the Mauell protocol, this field is required. The controller number is entered in decimal and ranges from
0 to 255.

6.1.4 Address
This field specifies the numeric indicator address on the mapboard to which the SCADA database point is
to be assigned.

For the CIS protocol, the required address is a BCD address. This number is entered in octal (base 8)
with a maximum of 3 digits. Leading zeros are not required.

For the Mauell protocol, this field is required. The address is entered in decimal and ranges from 0 to 8.

6.1.5 Width
This field specifies the total number of digits there are in the numeric indicator at the specified address.

6.1.6 Decimal Digits


This field specifies how many decimal digits to show in the numeric indicator at the specified address.

6.1.7 Macro
This field contains the Mapboard Macro (that you previously defined) that will be used to specify how the
SCADA database point values drive the indicators. Select the Macro from the drop-down list. See
Chapter 4, Macro, for a discussion on Macros.

For the CIS protocol, when defining Macros for numeric displays, the lamp actions that are available are
OFF, ON, Slow Flash and possibly Fast Flash.

For the Mauell protocol, when defining Macros for numeric displays, the lamp actions that are available
are OFF, ON, Slow Flash, Fast Flash, Dim and Modulate.

Mapboard Driver User’s Guide Numerics 6-2


Windows SCADA

You might also like