SYS600 - External OPC Data Access Client - 758101 - ENc
SYS600 - External OPC Data Access Client - 758101 - ENc
4
External OPC Data Access Client
Trace back information:
Workspace Main version a54
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Contents
1 Copyrights ............................................................................................. 5
4 Instructions ........................................................................................... 13
4.1 Configuration ................................................................................ 13
4.1.1 Base system configuration .............................................. 13
4.1.1.1 Configuring the base system with System
Configuration Tool ........................................ 13
4.1.1.2 Configuring the SYS_BASCON.COM file ..... 13
4.1.2 External OPC Data Access Client configuration ............. 14
4.1.3 Starting from the command line ...................................... 15
4.1.4 Configuration attributes ................................................... 15
4.1.4.1 Node Attributes ............................................. 15
4.1.5 Creating configuration ..................................................... 16
4.1.5.1 Changing External OPC Data Access Client
settings .......................................................... 26
4.1.5.2 OPC item configuration ................................. 30
4.1.5.3 Manual mapping of process objects or custom
station attributes ............................................ 32
4.1.5.4 Adding device connection status item for
system self supervision ................................. 43
4.1.5.5 Importing process objects from an external file
prepared with OPC PO List Tool ................... 45
4.1.5.6 Automated External OPC Data Access Client
configuration .................................................. 51
4.1.6 Importing and Exporting OPC Items configuration ......... 53
4.1.7 OPC Process Object List tool ......................................... 53
4.1.7.1 Introduction ................................................... 54
4.1.7.2 Start-up ......................................................... 54
4.1.7.3 Browsing Process Objects ............................ 55
4.1.7.4 Setting filters ................................................. 56
3
SYS600 9.4 MicroSCADA Pro 1MRS758101
4
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
1 Copyrights
The information in this document is subject to change without notice and should not be
construed as a commitment by ABB Oy. ABB Oy assumes no responsibility for any
errors that may appear in this document.
In no event shall ABB Oy be liable for direct, indirect, special, incidental or consequential
damages of any nature or kind arising from the use of this document, nor shall ABB Oy
be liable for incidental or consequential damages arising from the use of any software
or hardware described in this document.
This document and parts thereof must not be reproduced or copied without written
permission from ABB Oy, and the contents thereof must not be imparted to a third party
nor used for any unauthorized purpose.
The software or hardware described in this document is furnished under a license and
may be used, copied, or disclosed only in accordance with the terms of such license.
Copyright © 2016 ABB Oy. All rights reserved.
Trademarks
ABB is a registered trademark of ABB Group. All other brand or product names
mentioned in this document may be trademarks or registered trademarks of their respective
holders.
Guarantee
Please inquire about the terms of guarantee from your nearest ABB representative.
Third Party Copyright Notices
List of Third Party Copyright notices are documented in "3rd party licenses.txt" and
included in SYS600 and DMS600 installation packages.
5
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
2.1 General
There are two OPC Data Access Clients in SYS600. One is the internal OPC Data Access
Client and the other is external. This manual describes the External OPC Data Access
Client.
This manual provides thorough information on the OLE Process Control (OPC) Data
Access (DA) client in SYS600. It describes how to configure the base system and the
communication system to establish communication with slave devices managed by the
OPC server. It also describes how to configure and use the External OPC Data Access
Client software in the SYS600 application.
In addition to this configuration, the SYS600 application needs to be configured for
process communication. For more information on this subject, see other manuals, for
example SYS600 Application Objects and SYS600 System Objects.
The following features defined in the OPC specification are not supported by External
OPC Data Access Client in SYS600:
• Public groups
• Blobs in item definitions
• Item Access Paths
These features are optional according to the OPC documents. External OPC Data Access
Client is able to communicate with several OPC servers from different vendors, but
several copies of the External OPC Data Access Client have to be started for it.
The following features are not supported by the External OPC Data Access Client
Configuration tool:
• The list of available OPC Items is not shown, if the OPC server does not support
the IOPCBrowseAddressSpace interface.
• OPC Item properties is not shown, if the OPC server does not support the
IOPCItemProperties interface.
7
SYS600 9.4 MicroSCADA Pro 1MRS758101
Although warning hazards are related to personal injury, and caution hazards are
associated with equipment or property damage, it should be understood that operation
of damaged equipment could, under certain operational conditions, result in degraded
process performance leading to personal injury or death. Therefore, comply fully with
all warnings and caution notices.
The External OPC Data Access Client implementation is based on the following
documents by the IEC Technical Committee 57:
Name of the document Version
OPC Overview Version 1.0. October 27, 1998
OPC Common Definitions and Interfaces Version 1.0. October 21, 1998
OPC Data Access Custom Interface Standard Version 2.04. September 5, 2000
8
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
9
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
3 Safety information
This section has information on the prevention of hazards and taking backups from the
system.
System backup
Usually a system back up is taken after the application is made. It should be taken again
when changes are made to the SYS600 system. This is required when the driver
configuration or the network setup is changed.
Application backup
An application backup is also taken at the same time with the system backup, after the
application is made. It should be taken again when changes are made to the application,
for example, if pictures or databases are edited or new pictures are added.
Handling
In case of a fatal error:
1. Write down the possible SYS600 error messages.
2. Shut down the SYS600 main program. If this cannot be done in the SYS600 Control
Panel, try to end the task in Windows Task Manager.
11
SYS600 9.4 MicroSCADA Pro 1MRS758101
3. The data kept in the main memory at the moment of a fatal error is placed in the
drwtsn32.log file with Windows 2003 Server, Windows XP and earlier. By default
it is placed under %SYSTEMDRIVE%\Documents And Settings\All
Users\Application Data\Microsoft\Dr Watson. Log and dump file paths can be
checked with the drwtsn32 application. (Start -> run -> drwtsn32.exe). Analyze and
copy the data in these files.
Starting with Windows Server 2008 and Windows 7 the crash handling has changed.
The location of the dump files can be read from the registry under the key
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error
Reporting\LocalDumps. The DumpFolder value tells the location of the dump files.
Collect the data from this location.
4. Restart the system.
Report the program break-down together with the possible SYS600 error messages and
the information from the drwtsn32.log file to the SYS600 supplier.
Status codes
Error messages in SCIL are called status codes. A list of status codes and short
explanations for them can be found in SYS600 Status Codes.
12
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
4 Instructions
This chapter describes how to configure and start External OPC Data Access Client in
SYS600.
4.1 Configuration
The base system objects are defined either with System Configuration Tool or manually
with SCIL commands in the SYS_BASCON.COM file. It is recommended to use the
configuration tool.
After making the changes either with the tool or by manually editing the file, the base
system should be restarted to have the changes reflected in system. With a few limitations,
the base system objects can also be defined and modified at any time when SYS600 is
running.
To configure SYS_BASCON.COM:
1. Define a base system object (SYS:B).
2. Define a link. The link type is TCP/IP.
3. Define a node.
13
SYS600 9.4 MicroSCADA Pro 1MRS758101
;***************************************************************************
;
; COMMUNICATION NODE
#CREATE NOD:V = LIST(-
LI = 2,-
SA = 203)
#CREATE NOD2:B = %NOD
;***************************************************************************
;
; STATIONS
#CREATE STA:V = LIST(-
TT = "EXTERNAL",-
ST = "SPA",-
ND = 2,-
TN = 2)
#CREATE STA2:B = %STA
;***************************************************************************
This section describes External OPC Data Access Client configuration in accordance
with the system, link, node and station numbers defined in SYS_BASCON.COM.
For IEC 61850 systems the automatic External OPC DA Client configuration creation
function of MicroSCADA SCL Importer tool should be used. The SCL Import tool can
automatically create the full configuration based on the IEC 61850 system configuration
during the configuration import to MicroSCADA.
OPC DA Client Configuration Tool (DAOCT) is used to create and modify the parameter
file which is used by External OPC Data Access Client (DAOPCCL).
14
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The External OPC Data Access Client configuration tool can be started from the command
line using any of the following commands.
Daoct : Opens an empty file
-hide : Validation of the items occur without the UI and non-validated items are
captured in the trace file(.trc)
Figure 4.1: Starting External OPC Data Access Client configuration tool from the command line
RM Running mode
This attribute consists of a set of flags which control the behavior and functionality of
External OPC DA Client instance. Each flag is one bit of this attribute. The bits are the
following:
Bit 0: When this bit is 0 and the used OPC Server reports that the quality of
an item is bad, the Object Status (OS) of the corresponding item behaves
as described in Table 4.6. This is the default behavior. When this bit is
1, and the used OPC Server reports that the quality of an item is bad
the Object Status behaves as described in Table 4.5. The value of the
RM is read from the configuration file, section [CPI], parameter Running-
Mode or it may be given as a command line argument.
Data type: Integer
Value: 0..65535
Index range: no index
Default value: 0
Access: Read, Write
15
SYS600 9.4 MicroSCADA Pro 1MRS758101
The manual configuration steps described next in this manual are not required for IEC
61850 systems when MicroSCADA SCL Importer automatic configuration is used.
However the Configuration Tool can be used to verify and modify the automatically
created configuration.
When configuring manually the following actions should be executed via the
Configuration Tool to create the configuration file:
1. Locate OPC servers installed in the system and allow the user to select the desired
server, which provides access to OPC-enabled devices. The Server Properties dialog
is used for this purpose (main menu item File > New).
2. Define the parameters for communication External OPC Data Access Client with
SYS600 base system via the CPI interface, in the CPI Node Properties dialog (main
menu item File > New > Next) and should be filled as follows:
Own Node Number Should be the same as the value of the created node attribute of the
communication NODE object (NOD: V). See the SYS-BASCON.COM
file. For example:
#CREATE NOD2:B = %NOD
The communication node created is NOD2, therefore the own node
number is 2.
Own Station Number Should be the same as the value of the SA attribute of COMMUNIC-
ATION NODE object (NOD:V). See SYS_BASCON.COM.
System Messages Should be 4 in new IEC 61850 systems. In IEC 61850 systems made
Enabled (SE) with MicroSCADA 9.2SP2 or earlier, or with OPC servers other than
the MicroSCADA IEC 61850 OPC server, the value should be 1.
Running Mode (RM) Should be 1 (bit 0 = 1) in new systems. If a backward compatible
quality handling is needed in an existing system, value 0 (bit 0 = 0)
for RM may be used. Section Section 4.4 OPC quality flags describes
the differences between these values.
Base Node Number Should be the same as the value of the ND attribute of BASE SYS-
TEM OBJECT (SYS:B). See SYS_BASCON.COM.
Base Station Number Should be the same as the value of the SA attribute of BASE SYS-
TEM OBJECT (SYS:B). See SYS_BASCON.COM.
Base Application Application Number in SYS600, where the connection is created.
Number
Base IP Address SYS600 TCP/IP address.
3. Define parameters for communication between External OPC Data Access Client
and another SYS600 base system (secondary), if the connection with the primary
base system has been lost. These parameters are optional. External OPC Data Access
Client has to be reconnected to the primary SYS600 base system, if the list of the
secondary system parameters is not defined. These parameters are defined in the
CPI Node Properties dialog of the configuration tool and should be used as follows:
Back Node Number Should be the same as the value of the ND attribute of BASE SYS-
TEM OBJECT (SYS:B). See SYS_BASCON.COM of the secondary
SYS600 base system.
16
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Back Station Number Should be the same as the value of the SA attribute of BASE SYS-
TEM OBJECT (SYS:B). See SYS_BASCON.COM of the secondary
SYS600 base system.
Back Application Application Number in secondary SYS600, where connection is
Number created.
Back IP Address Secondary SYS600 TCP/IP address.
MS Max Reconnec- The number of reconnection attempts to the primary SYS600. After
tions these attempts are expired, External OPC Data Access Client is
connected to the secondary SYS600 base system.
4. Define SPA stations, which are supported via External OPC Data Access Client.
The SPA station is defined in the Add STA dialog (main menu item Edit > Add
STA ) and the appropriate fields should be filled as follows:
Node Name The name of the station to be used in configuration.
Unit Number Specifies the unit number of the station. Should be the same as the
value of the TN attribute of SPA STATION OBJECT (STA:V).
Read/Write Timeout Timeout (ms) to be defined for all read/write operations to/from the
OPC server for each STA unit. When this parameter is 0, these op-
erations never time out.
In Use Specifies whether the station is in use or not.
The following is an example of External OPC Data Access Client configuration for
SYS600. Before starting this example, the SYS600 base system should be configured
according to the example in Section 4.1.1 Base system configuration. The Matrikon OPC
Simulation server should be installed on the computer. The OPC server can be obtained
from http://www.matrikon.com/opc.
When the Matrikon OPC Simulation Server has been installed the following actions
should be executed:
1. Start the configuration tool using Windows Explorer, command line or a desktop
short cut to the executable file. The file name of the program is DAOCT.EXE.
2. To open the Server Properties dialog, select File > New from the menu.
17
SYS600 9.4 MicroSCADA Pro 1MRS758101
18
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
4. Double-click on Matrikon.OPC.Simulation.1.
The following information is displayed in the Server Properties dialog:
19
SYS600 9.4 MicroSCADA Pro 1MRS758101
When the Prog ID & CLSID fields are filled in, the OPC server is configured.
5. Click Next to open the CPI Node Properties dialog.
6. Fill in the dialog fields as shown in Figure 4.5
20
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
21
SYS600 9.4 MicroSCADA Pro 1MRS758101
Expand the Simulated Items branch in the tree on the right side of the main window.
When this is done, the other branches and properties are shown in the tree. Expand
the branch named Random, and any OPC Item that is shown under the branch.
The main window should look like this:
22
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Figure 4.7: OPC Configuration Tool main window after expanding the branches
Random.Int4 is an OPC Item in the window above. The OPC Items are represented
on the Available Items page by various icons. A green downward arrow means that
the OPC Item has read access right, whereas write access right is denoted by a red
upward arrow. The tree leaves under Random.Int4 are OPC Item properties. To see
the values of the item properties available at the moment, right-click the
Random.Int4 item and select Properties in the pop-up menu to open the Item
Properties dialog.
23
SYS600 9.4 MicroSCADA Pro 1MRS758101
9. Change the Unit number value to 2 and click the In Use check box.
10. Click OK to open the main window.
24
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The External OPC Data Access Client has now been configured for communication with
Matrikon OPC Simulation Server and with the SYS600 base system.
If the filter options Show valid item and Show invalid items
are chosen, the Save icon remains disabled. The Save icon is
enabled only if the Show All filter option is selected.
25
SYS600 9.4 MicroSCADA Pro 1MRS758101
When the OPC server and the CPI node properties have been configured, they can be
changed in the same session, or in the future sessions of the OPC DA Client Configuration
Tool.
To open the pop-up menu for changing the Server and CPI properties, right-click the
CPI Node (root of the tree) on the left side of the main window.
26
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Here new STA objects can be added and the Server and CPI node properties can be
changed by selecting the corresponding item in the pop-up menu.
27
SYS600 9.4 MicroSCADA Pro 1MRS758101
If this setting is not selected, the refresh requests from the External OPC Data Access
Client to the OPC Server are set to type 'device'. Device refresh should be used when
the OPC Server may provide outdated data and needs to be update from the IED. Device
refresh is used to trigger the OPC Server to refresh the item values explicitly from the
IED and update the values. This causes more processing for the IEDs and additional
traffic to the IED. Depending on the IEDs this may cause additional events as there can
be changes in timestamps of IED values. Device refresh can be used with 3rd party OPC
Servers which require updating of the process values of the underlying devices.
No Buffering
When No Buffering is selected, External OPC Data Access Client does not buffer the
events.
Normal Buffering
When Enable Normal Buffering is selected, External OPC Data Access Client buffers
the events so that the latest update is always stored into the buffer independently of the
process object type. Normal buffering is the default setting.
Circular Buffering
When Enable Circular Buffering is selected, External OPC Data Access Client buffers
the events so that changes of switching device indications are always stored into the
buffer as their own entries, which means that all the state transitions are stored.
With measurement updates, the latest update is always stored into the buffer.
In the case of IEC 61850 HSB systems, Circular Buffering should be used. However,
all the changes of the switching device indications are stored during the communication
28
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
break as long as the size of the buffer has not been exceeded. For more information, see
Maximum buffering size and behavior at run-time, on page 29.
29
SYS600 9.4 MicroSCADA Pro 1MRS758101
External OPC Data Access Client is able to represent OPC Items with the following
SYS600 object types depending on the OPC Item access rights:
1. Input process objects
Table 4.1: Input process objects for the OPC Items with read-only or read-write
access rights
Station Object type Station Object type
SPA Single Indication IEC 61850 Single Indication
SPA Double Indication IEC 61850 Double Indication
SPA Digital Value IEC 61850 Digital Value
SPA Analog Value IEC 61850 Analog Value
SPA Pulse Counter IEC 61850 Pulse Counter
SPA Bit Stream IEC 61850 Bit Stream
When Bit Stream process objects are used to receive the OPC items of array data
type from the OPC server, additional handling in the SYS600 application is required.
The following example demonstrates how the original array of numeric values,
separated by commas, could be extracted from the value of the Bit Stream process
object:
@csv_text = TYPE_CAST( 'LN':POV'IX', "TEXT" )
@text_vector = SEPARATE(%csv_text, ",")
@analog_vector = DEC_SCAN(%text_vector)
OPC servers use standard OLE data types for OPC items. There is no strict
correspondence between OPC server data types and types of process objects, because
all data coming from the OPC server is converted by External OPC Data Access
Client into the data type requested by SYS600 for a certain kind of process object.
SYS600 process object types are represented by the following OLE data types:
• Single Indication, Double Indication, Block of Indications, Digital Input and
Digital Setpoint are mapped to VT_UI2
• Analog Input and Analog Setpoint are mapped to VT_R4
30
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
31
SYS600 9.4 MicroSCADA Pro 1MRS758101
Update Rate The minimum period of time (in ms), in which the OPC server sends the
updated OPC Item values of the items included in the group to the client.
In addition, it is the maximum period of time, in which the OPC server
updates its internal cache of the item values from the process devices.
In SYS600, the process objects mapped to the items in the group cannot
be updated faster than this parameter defines. The signal changes
shorter than specified value can get lost. For the measurements (analog
signals). It is typical to use an update rate of 1000 ms, but for the state
indications an update rate of 0 ms should be always used. The default
value is 0 ms.
Time bias The initial time bias (in minutes) for the group. The purpose of this
parameter is to indicate the time zone, in which the data (process object
changes) was collected. The time bias is the difference between Coordin-
ated Universal Time (UTC) and local time. The timestamp parameter for
SYS600 is set according to the time zone specified in this parameter,
i.e. timestamp = UTC + Time Bias.
Percent deadband Another parameter defined for each OPC group. It should be in the range
from 0 to 100. This parameter defines how sensitive the updating items
process on the OPC server is to small fluctuations of the item value. The
value 0 tells the OPC server to update its catch and to send notifications
to the client when any small modification of the item value occurs.
Higher values of this parameter allow avoiding unnecessary data sending
after small fluctuations of item values. Not all OPC servers support this
feature.
If an OPC server supports this feature, deadband applies only to those
items in the group that have dwEUType attribute equal to 1-"Analog".
For other items, and if the OPC server does not support this feature, the
percent deadband parameter is ignored. See the "OPC DA 2.0x Specific-
ation" document on the OPC foundation Web site: http://www.opcfound-
ation.org.
The Item Editor dialog of the configuration tool is used for mapping the SYS600 objects
to the OPC data items, see Figure 4.13. When the appropriate OPC groups are created,
mapping of the SYS600 process objects or custom attributes to the OPC Items can be
started. Select an appropriate group on the left side of the configuration tool's main
window and select Edit > Add Item in the main menu to open the Item Editor dialog.
32
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
An OPC Item or item property can be mapped to SYS600 Process Objects or to an STA
object attribute.
The following fields of this dialog should be filled in before the mapping can be done:
Item The name of the OPC Item. This field may be typed in manually or selec-
ted from the OPC server address space by the Browse button. The
Browse feature is accessed, if the appropriate OPC server supports
IOPCBrowseServerAddressSpace interface.
33
SYS600 9.4 MicroSCADA Pro 1MRS758101
Property The name of the OPC Items property. This field may be typed in manually
or filled in automatically by selecting an OPC Item property in the Browse
dialog. This field is empty when an OPC Item, not an OPC Item property,
is being mapped.
Req.Type The requested type of appropriate SYS600 object value. The value of
the requested type is sent to SYS600. This field may only be changed
for STA:S attributes, that is when radio button "Connect to SYS600
Custom STA Attribute" is selected. For process objects Req. type, is
predefined by the dependence of the process object type (the PT attribute
of the process object).
Disable write data con- Option for disabling local data conversion prior to writing data over OPC
version DA. This option is separately configurable for all items.
SYS600 process objects can be imported from an external file produced by OPC PO List
Tool by clicking the Import button. If the process objects have never been imported
34
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
before, the File Chooser dialog opens where the appropriate file is selected and opened
(click Open). Otherwise the process objects are read from the previously used file.
35
SYS600 9.4 MicroSCADA Pro 1MRS758101
To enable the mapping to IEC 61850 Range Item, the Enable IEC61850 Range Data
Attribute Mapping radio button should be enabled.
To enable the mapping of alarm flags, the Enable limit value alarms mapping radio
button should be enabled. The meaning of the dialog field is identical to the Item and
Property fields of the OPC Item Editor dialog, and they can be selected from the OPC
36
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
server address space by clicking one of the Browse buttons. It is not possible to define
less than four alarm flags. After all the Alarm Items are filled in, click OK.
When all the fields of the Item Editor dialog have been filled in, the mapping is completed
and OK can be clicked. The newly created and mapped item is shown under the
appropriate STA object, under the appropriate OPC Group.
The following is an example of mapping IEC 61850 measurement data with IED limit
checking to SYS600 process object through SYS600 IEC 61850 OPC Server.
Before starting this example, the following requirements should be fulfilled:
• IEC 61850 OPC Server is configured and connected to an IED supporting
measurement limit supervision.
• The SYS600 base system should be configured as in the example in Section 4.1.1
Base system configuration.
• In the SYS600 Object Navigator, create an analog input process object with block
address 45.
Once these actions are done, the following can be done:
1. Start the configuration tool (DAOCT.EXE).
2. Create a configuration file from the main menu File > New. Configure server
properties for an IEC 61850 OPC Server (for example
ABB.IEC61850_OPC_DA_Server.Instance[1].1).
3. Add STA 2.
4. Right-click the STA_(2) object and select Add Group... to open the Add Group
dialog.
37
SYS600 9.4 MicroSCADA Pro 1MRS758101
6. To open the Item Editor dialog, activate the ProcObjs object on the left side of the
main window and select Edit > Add from the main menu, see Figure 4.18.
38
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
7. Click Browse. Select a measurement in the Available Items dialog and click OK.
39
SYS600 9.4 MicroSCADA Pro 1MRS758101
8. After clicking OK, the measurement is shown on the Item field in the Item Editor
dialog, see Figure 4.20.
9. Select the Connect to MicroSCADA Process Object radio button.
10. Check the Enable Input Process Object check box.
11. Select Analog Input in Obj. type drop-down list.
12. Fill in the other fields related to input process object.
40
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
13. Click the Alarm Items button to open the Alarm Items Editor dialog, see Figure 4.21.
41
SYS600 9.4 MicroSCADA Pro 1MRS758101
14. In Alarm Item Editor dialog select Enable IEC 61850 Range Data Attribute
mapping and browse the appropriate measurement limit indication item in the
Browse dialog.
15. Click OK in the OPC Alarm Items Editor dialog and then click OK again in the
Item Editor dialog.
42
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Mapped items can be seen on the left side of the main window, under ProcObjs object.
4.1.5.4 Adding device connection status item for system self supervision
In case the System Messages Enabled (SE) definition made in the CPI Node Properties
dialog is set to 4, the device connection status items must be added.
In case the System Messages Enabled (SE) definition made in the CPI Node Properties
dialog is set to 1, adding the device connection status items is not required. When SE=1,
the OPC Item Attributes\Device connection status has no special meaning and adding
this item is not mandatory.
For more information about the differences between the SE=1 and SE=4 configurations,
see Section 4.2 Starting External OPC Data Access Client Starting from the command
line.
43
SYS600 9.4 MicroSCADA Pro 1MRS758101
The item Attributes\Device connection status is provided by the IEC 61850 OPC Server
and it is used to report whether the OPC Server has a connection to the specified IED or
not.
System events RUNNING and SUSPENDED are based on the updating of this item in
the OPC Server. If SE=4, each configured STA object must have a device connection
status item configured. Otherwise, the data points defined for the STA object are not
updated to the process database. See SYS600 Application Objects manual for more
information about the predefined event channel APL_EVENT and events RUNNING
and SUSPENDED.
To add the device connection status item when creating a new configuration:
1. When creating the configuration manually, add an STA for each IED to be
configured. The number of STAs should equal the number of IEDs configured in
the OPC Server. Each STA must have at least one configured group.
2. Add the IED's device connection status item in a group of the IED's STA with the
lowest update rate.
This can be done manually before saving the configuration. The device connection
status item for the IED in that STA is added automatically when saving the
configuration. It is added to the group with the lowest update rate. In case there are
items from multiple IEDs under one STA, the device connection status item is added
to the IED with the maximum number of configured items in that STA.
A message box is shown for the user to accept the adding of the device connection
status item.
Figure 4.23: Confirming the adding of the device connection status item
3. Confirm the adding of the device connection status item by clicking Yes for the
indicated STA, or Yes to All for all STAs.
If an existing configuration file with SE=4 is opened, the device connection status
items are added if necessary when the file is saved.
4. Verify the attributes for the device connection status item.
• Indication type is "I"
• Object type is single binary "SB"
• Address is allocated automatically. It is the maximum block address occupied
by any item in an STA +1. The block number is present, but it is meaningless
if the SE value is 4, since the process object is not updated.
44
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
4.1.5.5 Importing process objects from an external file prepared with OPC
PO List Tool
Before using this feature, prepare the process objects list file which contains information
about the process objects to be imported. This is a plain text file in which the process
objects' attributes are stored in comma-separated format. There are 8 columns for different
attributes:
Table 4.3: PO list file format
“STA_UN“ UN attribute
“STA_TN” meaning of STA’UN’:BTN
“LN“ object name
“IX“ object index
“OX“ Signal text
“PT“ object type
“OA“ block address
“OB“ bit address
“OI” Object Identifier
“CX” Comment text
“RX” Filter text
“IN” OPC item name
“ATTR_NAME:VAL” User defined attribute name and its value (optional)
The OPC PO List tool can be used to create such a file. See Section 4.1.7 OPC Process
Object List tool for details.
The Import Process Objects dialog of the OPC DA Client Configuration tool is used for
mapping SYS600 objects to OPC data items.
When the OPC groups have been created, the SYS600 process objects or custom attributes
can be mapped to OPC Items. Select the appropriate group on the left side of the
configuration tool main window and select File > Import Proc List from the main menu
to open the Import dialog. In this dialog, select the file which has been prepared previously
to see the list of available process objects, see Figure 4.24.
45
SYS600 9.4 MicroSCADA Pro 1MRS758101
If this dialog is started for the first time, select the file which has been prepared previously.
Otherwise, process objects are read from the last used file. Another file can be opened
by clicking the Select File button. When the process objects are loaded, select the process
object(s) from the list to be mapped to the OPC Items. There is a multiple selections
available.
When certain objects have been selected and OK is clicked, the following Figure 4.25
opens.
46
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The selected process objects are shown in the Process Object group. The address space
of the OPC server is shown on the right side of the dialog (tree view). It is possible to
filter the OPC items displayed in this tree view by using the RX attribute, if it is not
empty.
There are two filtering modes that are allowed. The LIB 5xx mode is filtering by using
the first 30 positions from the RX attribute and the IEC 61850 mode is filtering by using
31-63 positions of the RX attribute. When the filtering is enabled, the left tree contains
only those items that satisfy the selected condition. The RX string can consist of characters
and wildcards "*". For mapping the appropriate process object to an OPC Item or item
property, double-click the item on the right side of the dialog. After that, the Name field
is filled and the Add button is activated.
If the imported SYS600 process object is of Analog Input or Digital Input type, OPC
Items can be assigned to the alarm flags of this object.
1. Click the Alarm Items button in the same manner as in the Item Editor dialog.
47
SYS600 9.4 MicroSCADA Pro 1MRS758101
2. Add the mapped object by clicking the Next button, or return to the previously
mapped object by clicking the Back button, or skip the current object by clicking
the Skip button.
3. When the process objects are mapped or skipped, the next selected process object
is shown in this dialog, and the mapping procedure can be continued.
• The whole mapping operation can be stopped by clicking the Cancel button.
If some objects have already been mapped, the following dialog is shown, see
Figure 4.26.
Click the Yes or No button, to save or discard the mapping results. To continue
the mapping of the process objects, click the Cancel button on this dialog.
The following is an example of importing SYS600 process objects and mapping them
to OPC Items of Matrikon OPC Simulation Server.
Before starting this example, the following requirements should be fulfilled:
• Matrikon.OPC.Simulation server should be installed. See the example in Section 4.1.5
Creating configuration.
• The configuration file (matrikon_cfg.ini) should be prepared. See the example in
Section 4.1.5 Creating configuration.
• The SYS600 base system should be configured as in the example in Section 4.1.1
Base system configuration.
When using the SYS600 Object Navigator, there are two process objects that should be
created:
• SPA/Analog Input process object with the following attributes: PT=SPA/Analog
Input, OA=801.
• SPA/Single Indication process objects with the following attributes: PT=SPA/Single
Indicat., OA=802, OB=2.
• Export the created process objects from SYS600 to the PO list file (ObjPOList.pl)
by using the OPC PO List tool. See the description of PO List tool in Section 4.1.7
OPC Process Object List tool.
When these procedures are done, the following actions can be taken:
1. Start the configuration tool (DAOCT.EXE).
2. Open the configuration file (matrikon_cfg.ini) from the main menu File > Open,
see Figure 4.27.
48
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
3. Select the STA_(2) object on the left side of the main window. Then select Add
Group... from the main menu to open the Add Group dialog.
4. Set the group name to ProcObjs in the dialog and click OK.
5. Activate ProcObjs object on the left side of the main window and select File >
Import Proc List from the main menu. Select the file ObjPOList.pl in the Import
dialog to open a dialog containing a list of the available SYS600 objects, see
Figure 4.24. This dialog contains the two process objects (SPA/Analog Input and
SPA/Single Indication) that have been created by using the Object Navigator.
6. Select the two objects from the list and click OK.
The Import Process Objects dialog for the first object is opened, see Figure 4.28.
49
SYS600 9.4 MicroSCADA Pro 1MRS758101
7. Expand the Simulation Items and Random tree node and double-click the OPC Item
Random.Int2 on the right side of the dialog to fill in the Name field on the dialog
and to activate the Add button.
8. Click Next.
The first object (SPA/Analog Input) is mapped to the OPC Item Random.Int2. After
that, the dialog is refreshed automatically and the new imported process object
(SPA/Single Indication) is shown in the Process Object section. At the same time,
Random.Int2 is marked as not allowed (already used) on the right side of the window.
9. Double-click the OPC Item Random.UInt2 on the right side of the dialog to show
the Random.UInt2 item in the Name field and to activate the Next button. Click
Next.
10. When the SPA/Single Indication object has been mapped to the OPC Item
Random.UInt2, the importing is complete.
On the left side of the main window, under ProcObjs group, there are now two
mapped objects for the ProcObjs group: Random.Int2 and Random.UInt2.
50
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
This function is useful only in IEC 61850 based SYS600 systems. Similarly to importing
process objects, see Section 4.1.5.4 Adding device connection status item for system self
supervision, a process objects list file should first be prepared by using the OPC PO List
tool. The auto configure function can be applied to process objects that contain a reference
to an OPC item name in their IN attribute. This attribute is fulfilled by the SA-LIB objects
when the IEC 61850 type process objects are created or imported to the SYS600 process
database by using the SCL Importer tool.
When a connection to the IEC 61850 server is established, the automated configuration
can be started by selecting File > Auto Configure from the main menu to open the Auto
Configure dialog, see Figure 4.29.
All the fields in this dialog are filled in with the default values, but it is also possible to
redefine them manually.
Node Name The computer identifier in the network (name or
TCP/IP address).
OPC Server Prog ID By default, this is the name of the OPC server
instance.
Process Object List File The name of the file containing a list of exported
process objects. By default, this is the last used
file name. This is a read-only field. To change
this, click the Select file... button.
51
SYS600 9.4 MicroSCADA Pro 1MRS758101
OPC Item Name Delimiter (IN) The character used as a path delimiter in the IN
attribute of process objects.
Default OPC Group Name The name of OPC Group which contains the
configured items. Such a group is created for
all the Unit Numbers found in the Process Ob-
jects List file.
OPC Item Path Delimiter The character used by an OPC server as a path
delimiter.
Maximum number of LD occurrences Method This flag indicates the maximum number of lo-
gical device occurrences under one STA.
During the auto configuration process, the tool reads process objects from the PO List
file and maps an OPC Item to each of them. The OPC Item name consists of Node Name,
OPC Server Prog ID and the IN attribute of the imported process object. The newly
configured OPC Items are placed in the Default OPC Group Name, which is located
under the STA number corresponding to the Unit Number of process object.
When all the fields of the Auto Configure dialog are completed and verified, click the
Configure button to start the automatic configuration process. The status of the
configuration process and its progress information is shown in the opening dialog.
A warning dialog may be displayed during the auto configuration process, see Figure 4.30
52
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
OPC DA Client Configuration Tool can be used to import the whole item configuration
from a comma-separated (CSV) file (main menu File > Import CSV file). The file can
be prepared in any text editor or Excel, or created in the same or previous session of the
configuration tool.
The file has the following format:
Each record contains 7 or 8 fields, separated by commas. The fields should not contain
quotation marks. A record for an item mapped to a custom STA attribute has 8 fields:
1. Fully qualified OPC Item name.
2. The character I, P or R indicating whether the record describes Item, Item Property
or IEC 61850 Range Data Attribute.
3. Required data type (for example VT_BSTR).
4. Object type as it is seen in the item editor dialog (Single Indication, Analog Input,
Custom STA attribute and so on).
5. "STA" followed by the STA number concatenated by an underscore ("_"), as it is
seen on the left side of the tool main window (for example STA_(2)).
6. Custom STA attribute in the form "STA:Sxx", where xx is the name of the attribute.
7. Address of the process object or STA attribute index (0 if the attribute is not indexed).
8. Name of the group to which the OPC Item belongs.
A record describing an item mapped to a process object has the same format as above,
except field 6, which is not included. Therefore, the record has only 7 fields. The address
field can be in the form BLOCK:BIT for Single or Double indication objects or BLOCK
for other Process Objects. The following is an example of the CSV file rows:
Bucket Brigade.UInt2,I,VT_UI2,Custom STA attribute,STA_(2),STA:SIM,0,Group_1
Bucket Brigade.Int4, I,VT_UI2, Single indication, STA_(2), 1700:0, Group_2
The file can be prepared by using the configuration tool from the open configuration
(main menu File > Export CSV file). In both operations (Export or Import), the CSV
file can be selected in the standard Windows file chooser dialog. Both operations are
enabled only if an existing configuration is open or a new one is created in the tool
session.
The OPC Process Object List tool (OPC PO List tool) can be used to make it easier to
create mapping between the OPC Items and SYS600 addresses (process objects). The
tool produces a file (OPCPOLIST.PL) in which available process objects are listed in
comma-separated (CSV) format. This file is then used by the OPC Configuration tool
to select a process object and map it to an OPC Item.
53
SYS600 9.4 MicroSCADA Pro 1MRS758101
4.1.7.1 Introduction
The SYS600 External OPC Data Access Client uses its own parameter file. Along with
other data, this file contains mapping information on OPC Items and points in SYS600.
These points are block and bit addresses of the SPA type process objects in one of the
SYS600 applications. The OPC DA Client Configuration tool allows the manual
customizing of these values for an OPC Item. Another possibility is to import the list of
available addresses from an external file, then select a row in the imported table and
assign an OPC Item to the block and bit addresses selected. The OPC PO List tool makes
it easy to create such an external file. The format of the file is described in Section 4.1.7.9
Formats for the output file.
The following actions can be done in the OPC PO List tool:
• Display the process objects filtered by the OX and RX attributes or by using the
custom filter
• Browse process objects
• Set a new station number for the listed process objects
• Set filters
• Include and exclude an object into/from the output file
• Change the application from which the process objects are taken
• Save the Process Objects List
• Generate and assign new block and bit addresses for process objects that are included
in an export file
4.1.7.2 Start-up
OPC PO List tool is a Visual SCIL tool of SYS type in SYS600. It can be started from
the Tool Manager by double-clicking its icon:
54
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Figure 4.31: Starting the OPC PO List tool from the Tool Manager
The main dialog of the OPC PO List tool is a process objects navigator with a main table,
a toolbar and a menu, see Figure 4.32. At start-up, the tool reads the current application
and shows the available SPA type process objects.
There are five standard columns that are always shown: Process object (in ’LN’:P’IX’
format), the Object Identifier of the process objects, signal text (OX), Block/Bit address
and station (value of STA’UN’:BTN). There is also one user-defined column (IX), where
another process object attribute can be listed.
55
SYS600 9.4 MicroSCADA Pro 1MRS758101
The main table has a limited row count. If the number of possible process objects is more
than this value, then the full objects list is shown page by page. The full list can be
navigated by using the toolbar buttons First, Previous, Next and Last. The maximum
row count is specified by the Table_PageSize parameter of the [PO_List] section in the
OPCPOLIST.INI file in the user parameters directory. The default page size is 100. The
left part of the status bar at the bottom of the table shows information about the number
of the objects found and the currently displayed object numbers. The application from
which the process objects are taken is shown in the right part of the status bar.
It is possible to refresh the object list by reading objects from the current application or
another application by means of the File > Open menu command.
The process objects listed in the main table can be filtered by using the RX and OX
attributes. The Filters dialog is accessible from the toolbar button or from menu Edit >
Filter, the Figure 4.33 is shown when an option is selected.
56
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The conditions for the OX and/or RX attributes can be specified in this dialog. It is
possible to select objects which satisfy any or both of the specified conditions.
By default, all the objects shown in the main dialog are included in the output file. If the
file OPCPOLIST.PL already exists in the tool home directory, only those objects that
are present in the file, are marked as "included". The not included objects are dimmed.
By selecting the option "Do not show objects with empty IN attribute", the tool hides
those objects that do not have a value in IN (OPC Item Name) attribute. This setting is
useful in the IEC 61850 based systems, because it hides unnecessary objects during
signal engineering.
All the filters are saved in the OPCPOLIST.INI file in the user parameter directory.
By checking the Custom Filter check box the user can add a custom filter string to set
various conditions for the filtering process objects. This string uses the common syntax
for a logical expression, for example UN>1 AND LN == “TEST”.
To define a Custom filter condition, click the browse button (Button with three dots) in
the Filters dialog > Custom Filter container.
The Custom Filter dialog opens.
57
SYS600 9.4 MicroSCADA Pro 1MRS758101
In this dialog it is possible to define filter conditions by using attributes found in the
process database and by using a set of comparison operators and condition values. It is
also possible to type in the filter condition directly in the Filter text box.
When the filter dialog is opened, only the first drop-down list is enabled. It is possible
to select any attribute from the Attribute drop-down list. After the attribute is selected,
the next drop-down list becomes enabled. From this list, it is possible to select the
comparison signs: < (smaller than), <= (smaller than or equal to), = = (equal to), >=
(bigger than or equal to), > (bigger than) or <> (unequal). In the text box, it is possible
to type any text.
To enter the next filter condition AND or OR has to be selected from the last drop-down
list.
The chosen filter is added to the Filter text box when OK or Apply is clicked. Below
are the explanations for all buttons:
• OK adds the contents of all fields and combo boxes into the Filter text box and
closes the dialog.
• Apply adds the contents of all fields and combo boxes to the Filter text box, but
does not close the dialog. Another filter condition can be selected in the combo
boxes and fields to append to the existing filter conditions present in the Filter text
box.
• Clear clears all fields and combo boxes.
• Cancel closes the dialog after confirming the update of the selected filter condition
in combos.
When clicking Cancel, a message dialog opens to confirm whether the filter condition
selected in combo boxes and fields must be updated. If Yes is clicked, the Filter Text is
58
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
updated with the selected condition in combo boxes and fields. If No is clicked, the
dialog closes without updating.
The station number of the process objects listed in the Station column in the tool window
can be modified. Select Edit > Set station number from the main menu, or click the
right mouse button and select Set station number from the pop-up menu to open the
dialog shown in Figure 4.35, in which a station number can be chosen.
The selected station number is assigned only for those objects marked to be included in
the export file.
One or more process objects can be simultaneously included in or excluded from the
output file.
To include process objects, select the table row(s) with the object(s) to include. Choose
Edit > Include Selected Objects in the menu or click the toolbar button. Or click the
right mouse button and select Exclude Selected Objects in the pop-up menu.
To exclude process objects, select the row(s) with the object(s) to exclude. Then select
Edit > Exclude Selected Objects menu option, click the toolbar button, or select the
corresponding item in the pop-up menu. All the excluded process objects are dimmed.
It is also possible to include or exclude all process objects simultaneously by selecting
Edit > Include All and Edit > Exclude All in the menu or in the corresponding pop-up
menu.
If some of the process objects included do not have a valid station number, then the Set
Station Number dialog opens, see Figure 4.36.
59
SYS600 9.4 MicroSCADA Pro 1MRS758101
When the tool is started, it lists the objects for the current application. Later, the process
object list can be retrieved from another application by using the menu item File > Open
or the toolbar button to open the Open Objects List dialog, see Figure 4.37.
The drop-down list displays the currently selected application. Another application can
be selected from the list.
The Process Objects list can be saved to the output file by selecting File > Save or by
using the toolbar button. It is also possible to select File > Save As... to open the Save
Objects List As dialog. (See Figure 4.38)
60
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The name and location of the output file is defined in this dialog.
When the output file has been defined, click OK or select File > Save to save the Process
Objects list. The Figure 4.39 opens.
61
SYS600 9.4 MicroSCADA Pro 1MRS758101
It is possible to exclude objects with invalid addresses from the export file by clicking
the Skip button, or automatically generate the new address by clicking OK.
During the save operation the tool produces an output file named OPCPOLIST.PL to
the folder sc\sys\active\sys_. The format of the output file is described in Section 4.1.7.9
Formats for the output file.
The OPCPOLIST.PL file is a plain text file, in which process object attributes are stored
in a comma separated format. There are 10 columns for different attributes:
"STA_UN" UN attribute
"STA_TN" Meaning of STA’UN’:BTN
"LN" Object name
"IX" Object index
"OX" Signal text
"PT" Object type 1
"OA" Block address
"OB" Bit address
62
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
1This attribute does not depend on the SPA or other protocols. The SPA-type objects are
filtered using the DX attribute.
The following is an example of the file contents:
2,2,"RIVH03_R1Z",135,"Output TS2",3,23,1,
"Rivers Winchester","","SPCJ4D61 FRFMFUIOUT","",AT:"04-12-28 17:48:02"
2,2,"RIVH03_R1Z",137,"Output TS3",3,23,2,"Rivers
Winchester","","SPCJ4D61 FRFMFUIOUT","",AT:"04-12-28 17:48:02"
2,2,"RIVH03_R2A",2,"Tripping of stage Io>",3,23,3,"Rivers
Winchester","","REJ511SB-AREJ511_1 FRFMFUITRP","",AT:"04-12-28 17:48:02"
2,2,"RIVH03_R2A",4,"Tripping of stage Io>>",3,23,4,"Rivers
Winchester","","REJ511SB-AREJ511_1 FRFMFUITRP","",AT:"04-12-28 17:48:02"
2,2,"TEST111",11,"Breaker open select command",5,0,16,"Rivers
IEC Q9",""," FPQB01COBC CSWI1.Pos.ctlSelOff","",AT:"04-12-28 17:48:02"
2,2,"TEST111",12,"Breaker close select command",5,1,16,"Rivers
IEC Q9",""," FPQB01COBC CSWI1.Pos.ctlSelOn","",AT:"04-12-28 17:48:02"
2,2,"TEST111",13,"Breaker open execute command",5,2,16,"Rivers
IEC Q9",""," FPQB01COBC CSWI1.Pos.ctlOperOff","",AT:"04-12-28 17:48:02"
2,2,"TEST111",14,"Breaker close execute command",5,5,16,"Rivers
IEC Q9",""," FPQB01COBC CSWI1.Pos.ctlOperOn","",AT:"04-12-28 17:48:02"
If one or more OPC client instances are running, it is possible to see the process object
states for the objects involved in running OPC client configurations. To do this, select
Tools > Signal Diagnostics from the menu bar to open the Select Station Number and
filter dialog, see Figure 4.41.
In this dialog, select the STA number of the process objects to be seen and set a custom
filter to narrow down the list to the process objects which have this station number, and
click OK. The Signal Diagnostics system tool is started and the process objects are
63
SYS600 9.4 MicroSCADA Pro 1MRS758101
loaded into this tool. The objects are loaded from the application that is open in the PO
List tool. The main window of the Signal Diagnostics tool is shown below.
The process object values, states and time stamps are updated as soon as new events are
received from the OPC server.
The following commands can be used in the External OPC Data Access Client type:
DAOPCCL -show | -id "id_name" { -start "conf_file_name" [-trace [level] | -stop
| -restart | -trace [on|off|high] }
-show : show information about all active instances
-id "id_name" : unique identifier of client instance (according to NT file name
conventions)
64
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
65
SYS600 9.4 MicroSCADA Pro 1MRS758101
Other OPC servers than the IEC 61850 OPC Server do not
usually provide the item Attributes\Device connection status.
In these cases the setting "-se 1" must be used.
The same commands can be executed by means of the OPS_CALL function in SCIL,
for instance:
@a = OPS_CALL("daopccl -id <id_name> -start <file_name> -trace <trace value> -se
<se value>", 0)
or
@a = OPS_CALL("start daopccl -id <id_name> -start <file_name> -trace <trace value>
-se <se value>", 0)
-se is optional.
The SE (system message enabled) attribute can have the following values:
• 1 System message generation enabled (analog status points updated)
• 4 System message generation enabled (analog and binary status points updated)
If option "-se" is not defined and the configuration file is created with MicroSCADA
version 9.2SP2 or older, value SE=1 is used as default and the functionality is as in
version 9.2SP2 and older. See Section 4.2.1 Starting from the command line for more
information.
This line can be included into a Visual SCIL tool method or command procedure. For
example, include this command into the application initialization procedure (APL_INIT_...
or LIB_INIT_...) to start the External OPC Data Access Client automatically at the
SYS600 start-up.
The same command line argument presented in Section 4.2.1 Starting from the command
line, can be used when the External OPC client is started from the SCIL application. In
case System Self Supervision is used, the option "-se 4" must be used.
To stop an External OPC Data Access Client, where "id_name" is the id of the instance:
@b=OPS_CALL(" daopccl.exe -id <id_name> -stop")
or
@b=OPS_CALL("start daopccl.exe -id <id_name> -stop")
To restart an External OPC Data Access Client, where "id_name" is the id of the instance:
@c=OPS_CALL("daopccl.exe -id <id_name> -restart")
or
@c=OPS_CALL("start daopccl.exe -id <id_name> -restart")
66
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
See the following examples of starting, stopping and restarting instances. In the examples
the <id_name> is Softing and the configuration file path is c:\sc\sys\active\sys_\Softing.ini
Start Instance:
daopccl -id "Softing" -start c:\sc\sys\active\sys_\Softing.ini -trace high -se 1
Stop Instance:
@a=OPS_CALL("C:\sc\prog\OPC_Client\DA_Client\daopccl.exe -id Softing -stop 20")
Restart Instance:
@a=OPS_CALL("C:\sc\prog\OPC_Client\DA_Client\daopccl.exe -id Softing -restart ")
4.2.3 Starting from External OPC Data Access Client Control Panel
Run the DAOPCCP.EXE program to open the OPC DA Control Panel, see Figure 4.43.
67
SYS600 9.4 MicroSCADA Pro 1MRS758101
This dialog contains a list of the existing client instances. A new instance is started by
clicking the New Instance button to open the dialog and fill in the following parameters:
Instance ID The name of the created instance.
Config File The name of configuration file, which can be selected by clicking the
Browse button.
Tracing The level of tracing. A trace file with the same name as the Instance ID
is written, if Normal, High level or Extreme is selected. The high level of
tracing provides detailed information about data transfer during the run-
time.
If the Extreme level is selected, the OPC DA writes the following inform-
ation into the trace log:
• Name of the item that received an update
• Its timestamp
• Value
The same information is written after an update has been transferred to
the SYS600 application.
When a corresponding name (ID) is selected from the list of External OPC Data Access
Client instances, the following actions are available for the existing instances:
• To change the trace level, click Trace and select a new level from the pop-up menu.
68
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
69
SYS600 9.4 MicroSCADA Pro 1MRS758101
The returned value of the STAn:SOS is the same as the value which is updated to the
ANSI Analog input process object described in Section 4.2.1 Starting from the command
line, setting "-se 4".
When an OPC DA Client instance is started, it updates and ANSI Analog Input process
object UN=0, OA=6000+Node number, with value 10001 and an ANSI Binary Input
process object, UN=0, OA=6000+1000000hex+Node number with the value 1. These
process objects are used by the SSS. In general, the usage of SSS is recommended in the
supervising of the External OPC DA Client.
When "System Messages Enabled" SE has the value 1 and the connection to the IED is
lost, OPC DA Client loops through all configured items and marks the corresponding
process objects to status OS=2 (Obsolete). In most cases, this happens when the OPC
server has lost its connection to the IED or a failure has occurred in the OPC Server
itself. SSS cannot supervise the behavior of the OPC DA client, if SE has the value 1.
If the quality is good for IEC 61850 OPC Server, the status
returned to SYS600 depends on the time quality. This is
represented by the second of the high 8 bits which are not used
by other OPC servers. If this bit is set, the BAD_TIME status
is reported to SYS600. When the quality is not good, the time
70
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
quality bit is ignored, since the OPC item value quality has
higher priority than the quality of time.
The layout of the Substatus field depends on the value of the Quality field.
The used substatus values are listed below. A separate table is given for both
configurations node attribute RM bit 0 = 0 and RM bit 0 = 1.
Table 4.5: Substatus for bad quality when node attribute RM bit 0 = 1
SSSS BIT VALUE DEFINE SYS600 Object Status DESCRIPTION
(OS)
0 000000LL Non-specific 2 (Obsolete Status) The value is bad but no specific
reason is known.
1 000001LL Configuration 2 (Obsolete Status) There is a server specific prob-
Error lem with the configuration. For
example, the item is question has
been deleted from the configura-
tion.
2 000010LL Not Connec- 2 (Obsolete Status) The input is required to be logic-
ted ally connected to something but
is not. This quality can reflect that
no value is available at this time,
for reasons like the value may
not have been provided by the
data source.
3 000011LL Device Fail- 2 (Obsolete Status) A device failure has been detec-
ure ted.
4 000100LL Sensor Fail- 2 (Obsolete Status) A sensor failure has been detec-
ure ted. The Limits field can provide
additional diagnostic information
in some situations.
5 000101LL Last Known 2 (Obsolete Status) Communication has failed. The
Value last known value is available.
6 000110LL Comm Fail- 2 (Obsolete Status) Communication has failed. No
ure last known value is available.
7 000111LL Out of Ser- 2 (Obsolete Status) The block is off-scan or otherwise
vice locked. This quality is also used
when the active state of the item
or the group containing the item
is inactive.
8-15 N/A 2 (Obsolete Status) Not used by OPC.
71
SYS600 9.4 MicroSCADA Pro 1MRS758101
Table 4.6: Substatus for bad quality when node attribute RM bit 0 = 0
SSSS BIT VALUE DEFINE SYS600 Object Status DESCRIPTION
(OS)
0 000000LL Non-specific 10 (Not Sampled The value is bad but no specific
Status) reason is known.
1 000001LL Configuration 10 (Not Sampled There is a server specific prob-
Error Status) lem with the configuration. For
example, the item is question has
been deleted from the configura-
tion.
2 000010LL Not Connec- 10 (Not Sampled The input is required to be logic-
ted Status) ally connected to something, but
it is not. This quality can reflect
that no value is available at this
time, for a reason such as the
value may have not been
provided by the data source.
3 000011LL Device Fail- 10 (Not Sampled A device failure has been detec-
ure Status) ted.
4 000100LL Sensor Fail- 10 (Not Sampled A sensor failure has been detec-
ure Status) ted. The Limits field can provide
additional diagnostic information
in some situations.
5 000101LL Last Known 2 (Obsolete Status) Communication has failed. The
Value last known value is available.
6 000110LL Comm Fail- 10 (Not Sampled Communication has failed. The
ure Status) last known value is not available.
7 000111LL Out of Ser- 10 (Not Sampled The block is off-scan or otherwise
vice Status) locked. This quality is also used
when the active state of the item
or the group containing the item
is inactive.
8-15 N/A Not used by OPC.
72
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
The Limit Field is valid regardless of the Quality and Substatus. In some cases, such as
Sensor Failure, it can provide useful diagnostic information.
Table 4.9: Limit bit field
LL BIT VALUE DEFINE DESCRIPTION
0 QQSSSS00 Not Limited The value is free to move up or down.
1 QQSSSS01 Low Limited The value has violated the lower limit.
2 QQSSSS10 High Limited The value has violated the high limit.
3 QQSSSS11 Constant The value is a constant and cannot move.
73
SYS600 9.4 MicroSCADA Pro 1MRS758101
Values of the attributes are 0 when the corresponding quality bit is not set, and 1 when
the corresponding quality bit is set.
In addition to the table above, the 13-bit IEC 61850 Quality is mapped as a whole to the
MicroSCADA process object attribute QL. Attribute QL contains 16 bits and the IEC
61850 quality is shifted left by 3 bits (and padded with zeros) with most significant bit
left. The attributes OF, OR, SB, BL, TM and QL are updated in a same way with
following input type process objects: single and double indications, analog value, digital
value and pulse counter value. This functionality is present without any configuration
and it cannot be disabled.
BE is not set for data received via OPC refresh. E.g. when
setting UP=1 for a STA unit in MicroSCADA the current data
from the OPC server is refreshed and sent without BE=1
regardless of the timestamp of the data item.
74
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
For comparing event timestamps a STA specific compare timestamp is used. The compare
timestamp is initialized to External OPC Data Access Client startup time and updated
to the connected OPC server startup time if it is newer. If a 'Device connection status'-item
(DCS) is configured for the STA the compare timestamp will be updated to the timestamp
of DCS=TRUE change. All events older then the connection time will be marked with
BE=1. If DCS is not configured, events older than External Data Access Client / OPC
server startup time are marked with BE=1.
75
SYS600 9.4 MicroSCADA Pro 1MRS758101
Error Description
OPC_E_INVALIDHANDLE The value of the handle is invalid. Note: a client should
(0xC0040001) never pass an invalid handle to a server. If this error oc-
curs, it is due to a programming error in the client or pos-
sibly in the server.
OPC_E_INVALIDITEMID The item ID does not conform to the server's syntax.
(0xC0040008)
OPC_E_INVALID_PID The passed property ID is not valid for the item.
(0xC0040203)
OPC_E_NOTFOUND Requested Object (for example a public group) was not
(0xC0040011) found.
OPC_E_PUBLIC The requested operation cannot be done on a public
(0xC0040005) group.
OPC_E_RANGE The value is out of range.
(0xC004000B)
OPC_E_UNKNOWNITEMID The item ID is not defined in the server's address space
(0xC0040007) (on add or validate operations) or no longer exists in the
server's address space (for read or write operations).
OPC_E_UNKNOWNPATH The item's access path is not known to the server.
(0xC004000A)
OPC_S_CLAMP A value passed to WRITE was accepted but the output
(0x0004000E) was clamped.
OPC_S_INUSE The operation cannot be performed because the object
(0x0004000F) is being referenced.
OPC_S_UNSUPPORTEDRATE The server does not support the requested data rate but
(0x0004000D) will use the closest available rate.
76
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
5 Technical description
Tool_Dir_ = \SC\OPC
The \SC\OPC path is shown here only as an example. It should be the actual path to the
VSO and INI files of the tool. If the tool is registered in the TOOLS.INI file, it is added
77
SYS600 9.4 MicroSCADA Pro 1MRS758101
to the available tools list in the Add tool dialog of the Tool Manager. See SYS600 System
Configuration for details about working with the Tool Manager.
78
1MRS758101 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2016 External OPC Data Access Client
Version: C/3.6.2016
Index
79
SYS600 9.4 MicroSCADA Pro 1MRS758101
PO .................................................................. 45, 48
N Primary SYS600 base system .............................. 16
Name .................................................................... 34 Process Object List File ........................................ 51
Node Name .......................................................... 51 Process objects list file ......................................... 45
Property ................................................................ 34
PT ................................................................... 45, 62
O
OA .................................................................. 45, 62 R
OB .................................................................. 45, 62
Obj. type ............................................................... 40 Req. Type ............................................................. 34
Object index ................................................... 45, 62 Running Mode ...................................................... 16
Object name ................................................... 45, 62 RX ............................................................. 45, 56, 63
Object type ..................................................... 45, 62
ObjPOList.pl ......................................................... 48 S
OI .......................................................................... 45
OPC DA Client Configuration Tool ....................... 14 save process objects ............................................ 60
OPC DA Client Control Panel ............................... 64 Save Process Objects list ..................................... 60
OPC DA Client package ....................................... 77 Saving ................................................................... 60
OPC DA Control Panel ......................................... 67 Secondary SYS600 Pro base system .................. 17
OPC data items with read-write access rights ...... 31 Server properties .................................................. 19
OPC- enabled devices ......................................... 77 Server Properties dialog ....................................... 17
OPC error codes .................................................. 75 Set filters ............................................................... 56
OPC group ............................................................ 31 Set station number ............................................... 59
OPC Groups ......................................................... 31 Signal text ....................................................... 45, 62
OPC Item access rights ........................................ 30 Simulation server .................................................. 17
OPC Item icons .................................................... 23 SPA stations ................................................... 14, 17
OPC item name .............................................. 45, 63 SPA type ............................................................... 55
OPC Item Name Delimiter (IN) ............................. 52 STA_TN .......................................................... 45, 62
OPC Item Path Delimiter ...................................... 52 STA_UN .......................................................... 45, 62
OPC items ............................................................ 30 Starting OPC DA Client ........................................ 64
OPCPOLIST.PL .............................................. 53, 62 SYS_BASCON.COM ............................................ 13
OPC Process Object list tool ................................ 53 System Messages Enabled (SE) .......................... 16
OPC quality flags .................................................. 70
OPC Server Prog ID ............................................. 51 T
OPC Servers ........................................................ 16
OPS_CALL function ............................................. 66 Time bias .............................................................. 32
Output process objects ......................................... 30
Own Node Number ............................................... 16
Own Station Number ............................................ 16
U
OX ............................................................ 45, 56, 62 UN attribute .................................................... 45, 62
Update Rate ......................................................... 32
P
Percent deadband ................................................ 32
80
Contact us
www.abb.com/substationautomation