Professional Documents
Culture Documents
Matrikon OPC Server For GCOM User's Manual
Matrikon OPC Server For GCOM User's Manual
User's Manual
Matrikon OPC Server for GCOM
For additional information on this manual, this OPC server, or Matrikon, please contact:
Address: Matrikon
1800, 10405 Jasper Avenue
Edmonton, Alberta, Canada
T5J 3N4
Phone: 780-448-1010
Fax: 780-448-9191
Web: http://www.matrikon.com
Sales: drivers@matrikon.com
Support: support@matrikon.com
CONFIDENTIAL
The information contained here in is confidential and proprietary to Matrikon.
It may not be disclosed or transferred, directly or indirectly, to any third party without the
explicit written permission of Matrikon.
All rights reserved. No part of this document may be reproduced, stored in a retrieval system,
translated, or transmitted in any form or by any means, electronic, mechanical, photocopying,
recording, or otherwise, without prior written permission of Matrikon.
© Copyright 2002
Matrikon Inc.
TABLE OF CONTENTS
1. Introduction................................................................................................................................................................................................................ 6
1.1 System Requirements ..................................................................................................................................................................................... 6
1.2 OPC Overview.................................................................................................................................................................................................. 6
1.3 OPC Server Overview....................................................................................................................................................................................7
2. Getting Started .......................................................................................................................................................................................................... 8
2.1 Installation ...................................................................................................................................................................................................... 8
2.1.1 Matrikon OPC Server ............................................................................................................................................................................. 8
2.1.2 Standard OPC Proxy/Stubs ................................................................................................................................................................ 8
2.1.3 Standard OPC Server Browser ......................................................................................................................................................... 9
2.1.4 Matrikon OPC Common Components ........................................................................................................................................... 9
2.1.5 Matrikon OPC Explorer ......................................................................................................................................................................... 9
2.1.6 Matrikon OPC Automation Component........................................................................................................................................ 9
2.1.7 Installation Options ............................................................................................................................................................................ 10
2.2 Licensing ........................................................................................................................................................................................................ 10
2.2.1 Hardware Key Licensing ................................................................................................................................................................... 10
2.2.2 Application-Specific Software Licensing.................................................................................................................................11
2.2.3 Feature & Computer-Specific Software Licensing...............................................................................................................11
2.2.3.1 Requesting a Software License ........................................................................................................................................ 12
2.2.3.2 Temporary Authorization of Software............................................................................................................................ 13
2.2.3.3 The Software License Key .................................................................................................................................................... 14
2.2.3.4 Licensing The Software......................................................................................................................................................... 15
2.2.3.5 Removing and/or Transferring The Software License...........................................................................................17
2.2.3.6 Licensing Contact Information and Summary .......................................................................................................... 18
2.3 Command-Line............................................................................................................................................................................................. 18
3. Configuration .......................................................................................................................................................................................................... 20
3.1 Starting Up .................................................................................................................................................................................................... 20
3.2 Server Configuration................................................................................................................................................................................22
3.3 GCOM.................................................................................................................................................................................................................24
3.3.1 Configuring A GCOM Card.................................................................................................................................................................24
3.3.2 Configuring A Controller.................................................................................................................................................................. 25
3.3.3.............................................................................................................................................................................................................................. 28
3.3.4 Configuring Datasets ........................................................................................................................................................................ 28
3.4 Alias Configuration ................................................................................................................................................................................... 31
3.5 Save the Configuration........................................................................................................................................................................... 34
3.6 DCOM Configuration................................................................................................................................................................................. 34
3.7 Statistics........................................................................................................................................................................................................ 34
3.8 Options............................................................................................................................................................................................................ 35
3.8.1 General ..................................................................................................................................................................................................... 35
3.8.2 Logging ..................................................................................................................................................................................................... 36
3.8.3 Advanced ................................................................................................................................................................................................. 38
3.9 Shutting Down............................................................................................................................................................................................. 38
4. Matrikon OPC Explorer ........................................................................................................................................................................................ 39
1. INTRODUCTION
This document is the user’s manual for the . This server is an OPC™ compliant program that
allows access to ABB GCOM compliant gateways and controllers. The product has the
following features:
The following is required on the ABB equipment to properly communicate with the GCOM OPC
Server:
• Properly configured GCOM card. (Refer to ABB manuals for additional information)
OPC Interface
Once an OPC server is written for a particular device, it can be reused by any application that is
able to act as an OPC client. OPC servers use Microsoft’s OLE technology (also known as the
Component Object Model, or COM) to communicate with clients. COM technology permits a
standard for real-time information exchange between software applications and process hardware
to be defined.
2. GETTING STARTED
This section guides you through the process of setting up a Matrikon OPC Server for real-time
data access. Please follow the instructions carefully to avoid problems.
2.1 INSTALLATION
The installation program for a Matrikon OPC Server comes on either CD-ROM or 3½” floppy
disks. Insert the media in the drive and choose Add/Remove Programs from the Control Panel.
Click Install and follow the instructions from the Installation Wizard.
The installation program copies all necessary files to the target computer, registers the various
software components, and creates short-cut icons in the Start menu.
Filename Description
OPCGCOM.EXE Matrikon OPC Server for GCOM Devices Executable
PSTCFGGCOM LIB.OCX Configuration Panels ActiveX Component
The version-independent program ID for the server is "Matrikon.OPC.GCOM ". The version-
specific program ID for this version of the server is "Matrikon.OPC.GCOM.1".
The Matrikon OPC Server for GCOM Devices uses a software key for licensing. Contact
Matrikon at drivers@matrikon.com to obtain the registration code for this server.
Filename Description
OPC Data Access 2.0 and 1.0a Interfaces Marshalling
OPCPROXY.DLL
Library
OPCCOMN_PS.DLL OPC Common 1.0 Interfaces Marshalling Library
OPC_AEPS.DLL OPC Alarms and Events 1.0 Interfaces Marshalling Library
Vendors were originally required to supply their own version of the OPC proxy/stub.
Unfortunately, this proved to cause conflicts between various versions of the DLL’s
when products from different vendors were installed on the same machine. To solve
Note this problem, the OPC Foundation created official DLLs and they now require that all
vendors install these instead. However, older OPC server installation programs may
still install the old DLLs, preventing new servers from functioning properly. If this
Filename Description
ACTXPRXY.DLL ActiveX Interface Marshalling Library
OPCENUM.EXE OPC Server Browser
Filename Description
PSTCFG.EXE Matrikon OPC Server Configuration Client
PSTCFGPS.DLL Matrikon OPC Server Configuration Marshalling Library
OEM_Matrikon_OPC.DLL Matrikon OPC OEM Badge Library
EXPREVAL.DLL Expression Evaluation Library (for aliases)
Filename Description
OPCEXPLORER.EXE Matrikon OPC Explorer (General-purpose OPC Client)
Filename Description
Matrikon Inc. Page 9 of 84
Matrikon OPC Server for GCOM
2.2 LICENSING
Most Matrikon OPC products require some form of license criteria to be met in order to function
fully. Licensing for a particular server can use either a hardware key or a software key. There are
two types of software key licensing. Table 1 describes the licensing methods supported by
Matrikon OPC products.
In addition to creating the authorization request file, the installation program also provides you
the option to create a temporary software license key. This allows you to use the software before
receiving your permanent software license key, or if you’re evaluating the software, to try it
before purchasing. The key will allow the product to run in fully functional mode for a specific
amount of time from the installation date, typically 30 or 90 days.
If you do not select this option during installation, you can perform temporary authorization at a
later time, using the supplied License utility application. This program is described in more detail
in section 2.2.3.4.
If you have purchased the software and sent in the authorization request file, a software license
key file will be issued to you. Typically the key file is sent by email, however there are alternate
methods of receiving the software key. These methods are outlined during the installation
process.
When you are sent the key via any method that is file based, for example email, ftp or disk, the
key is contained in a file named Authorize.MTK. If you are provided the key information by
another method, you must enter the information into a file that you create, based on instructions
from Matrikon technical support. You can use a text-based editor such as Notepad to create the
file.
After receiving or creating the file, you should make a backup copy before you do anything else
You can use the backup file to reauthorize the software should you need to reinstall it at a later
date on the same computer.
After you have made a backup copy, store the original file in the same folder where the product
has been installed.
With the key file residing in the application’s installation folder, you can now authorize the
software to use the license key by running the provided License utility application. Access to this
program is available from a program shortcut on the Start menu. Typically the path to this
shortcut is:
Where <Product Name> is the name of the Matrikon software being licensed. When you run this
application, you are presented with a list of licensing options as shown in Figure 1.
Table 2 describes the software licensing options that are available. When you select an option, a
default path and file name for the selected option is displayed in the Authorization file path field.
Normally the default information does not need to be modified, but you can modify this field if
required. You can also use the Browse button next to the field to locate a specific authorization
file.
To authorize the software, select the License this software checkbox. The application will create
a default path and file name for the authorization file to be processed. Normally this will be a
path to the folder where the software is installed, and the file name will be Authorize.MTK. If the
default information is not correct, modify it, or use the Browse button to locate the authorization
file. Otherwise, press OK and the application will attempt to process the key file.
A confirmation message will verify that the software has been successfully licensed. If an error
occurs, note the error information carefully, and contact technical support.
If you need to install the software on a different computer, or return the software, you must de-
license the currently installed version first. To do this, send the file RemoveRequest.MTK, to
Matrikon technical support for processing. This file is generated during the authorization
process, and can be located in the folder where the software was installed.
Upon receipt of this file, Matrikon will send you a de-licensing key file named Remove.MTK,
that you copy into the installation folder, and process using the De-license this software option
of the authorization program.
After you de-license the software, a validation file named RemoveValidate.MTK, is created to
confirm that the software was de-licensed correctly. Send this file to Matrikon to finalize the de-
licensing process.
If you are transferring the software to another computer, you can install it there first, and send
your new authorization request file along with the de-license validation file at the same time.
Matrikon will then issue you a license authorization file for the new installation. Before you
receive your new license, you can use the temporary authorization feature to enable the software
immediately on the new installation.
The following information will help you to easily determine who to contact, and what
information is required for any part of the software licensing process:
Step Description
Software has been installed. Send AuthorizeRequest.MTK to our support group.
Authorization file received Run the Software Authorization licensing program, and
from Matrikon. select the License this software option.
Transfer or Remove software Send RemoveRequest.MTK to our support group. Matrikon
license. will issue a removal key file, Remove.MTK.
Removal file received from Run the Software Authorization licensing program, and
Matrikon. select the De-license this software.
Software successfully de-
Send RemoveValidate.MTK to our support group.
licensed.
Run the Software Authorization licensing program, and
Create a new authorization select the Create authorization request option. Normally
request on the same computer. disabled, contact Matrikon support for information on how to
use this option.
2.3 COMMAND-LINE
The installation program registers the Matrikon OPC Server to run as either a local executable or
an NT service (based on user choices) and creates a shortcut in the Start menu. Use this shortcut
to invoke the configuration utility, which will in turn start up the server. For reference purposes,
the command-line parameters for the OPC server executable are as follows.
Parameter Description
/REGSERVER Registers the OPC server to run as a local executable
–REGSERVER (uninstalling the NT service if necessary).
/SERVICE Registers the OPC server to run as an NT service. By default
3. CONFIGURATION
Matrikon OPC Servers require a very small amount of configuration to function properly. This
section describes how to create a configuration for your OPC Server using the supplied PSTCFG
utility application. It begins with a generic discussion of using PSTCFG, and is followed by
specific details on configuring devices supported by this OPC Server.
3.1 STARTING UP
Choose the appropriate shortcut for the OPC server from the Start menu to invoke the PSTCFG
configuration utility. By default, the shortcut has the name “Matrikon OPC Server for Device”
and appears in “Matrikon OPC/Device” under the common section of the Programs folder.
If the OPC server is not currently running, then it will launch when the configuration utility is
started. If the server runs as a local executable, the splash screen is displayed and then a small
red X appears in the Tool Tray at the right-hand side of the Task Bar. Right-click on the X to
display the following menu.
Click “Show Control Panel” to display the control panel for the server. Double clicking on the X
accomplishes this as well. The control panel displays general statistics for the server, such as the
If the server runs as a local executable, it will remain running even after the main configuration
window is closed, even if no clients are connected. Displaying the control panel or main
configuration window for the server will “lock” it so that it will not shut down while
configuration is being performed.
If the server runs as an NT service, it will remain running so long as there are clients connected
to it. Closing the main configuration window will shut down the configuration utility, but will
not interfere with the normal operation of the server.
Once an object is selected, its configuration panel appears. Each type of configurable object has
its own configuration panel allowing users to enter object-specific information. Change the
configuration settings as desired and press OK to create the object.
Three fields are common to all types of object: Name, Description, and Enabled. The Name field
specifies a unique name for the object. It is used later as part of any item ID’s that refer to data
It may be useful to change the default settings for a new object to avoid repetitive work. Choose
Defaults from the View menu in order to alter the default settings for available object types.
Simply edit the settings in the various configuration panels and choose OK. The next time an
object of a particular type is created, it will use these default settings for initial values.
3.3 GCOM
3.3.1 CONFIGURING A GCOM CARD
All GCOM cards that the bridge must communicate with must be configured. The following
illustration shows the configuration option that must be set up.
For the bridge to communicate with a ABB controller, such as a Plant Network Gateway, Kent
4000, or Advant controller, a GCOM card must be configured on the device itself as well as in
the bridge. The GCOM bridge configuration has the following options:
Field Description
Name This can be any name.
The next illustration shows a typical selection list of available controllers, available to choose
from when creating a new controller link.
While each controller requires its type to be specified by selecting the appropriate type, the
controller links themselves all have identical settings, described by the following table:
Field Description
Name This can be any name.
Description Any description may be entered here. Blank is also valid.
Enabled The Enabled checkbox must be checked for communications with the
card to occur!
Network This is the network where the defined controller resides.
Node This is the node number of the controller.
Autoprobe Assumes that all network numbers in the same decade are possible
backups should the primary configured network fail.
Redundant Networks Explicitly specifies one or more backup networks. Use this or
Autoprobe, but not both together.
Return to primary on Monitor the original network after switchover and, should it begin
recovery working again, switch back immediately without waiting for the backup
network to fail.
Minimum Switching is locked out for this many seconds after a switch takes place.
Switchover Delay This is to prevent thrashing between primary and backup networks.
ObjRes Retries This indicates how many attempts should be made to resolve an object
name. (This is how the bridge connects to an object. If the name can not
be resolved, all subscriptions to the object will have a status of BAD, Not
in service.
** A value of 0 will allow the bridge to continually try to resolve the
object name.
ObjRes Timeout This is the period of time the bridge will wait for a response to an attempt
to resolve an object name.
Obj Package Time This is the delay for which the server will wait after receiving the last
item from an OPC client to ensure that no other items have been added.
No action will be performed until this period has expired. This parameter
does not apply to Data Sets, only objects.
When configuring redundancy, one must remember that redundancy may have been
already configured in the controller itself. In such a case, if communication is lost
between the OPC server and the GCOM DCS system, the DCS may fail over to a
Note different GCOM network. Consequently, the OPC Server may indicate that
communication has been lost between itself and the controller. Thus it is important to
configure the OPC Server to reflect all networks that are accessible by the GCOM DCS
The bridge supports read data sets, write data sets, demand data sets and text sets. This first
screen shot shows the settings common for all data sets.
Field Description
Name This can be any name.
Description Any description may be entered here. Blank is also valid.
Enabled The Enabled checkbox must be checked for communications with
the card to occur!
Read/Write Indicator This indicates the direction the data set is to be sent.
READ – This data set will be read. This means the controller configured
with this data set will be writing it to the bridge. (Controller -> Bridge)
WRITE – This data set will be written. A corresponding data set should
be configured on the controller, and bridge will write to the data set on
the controller.
(Bridge -> Controller)
Data Set Identifier This must be the same identifier number as the data set configured on the
controller.
Update Interval This indicates how often the bridge should expect an update from the
controller for this data set, or how often this data set needs to be written
to the controller.
**A value of 0 identifies this data set as being a demand packet!
Exception Mode Not currently used by any controller configuration.
Enabled
The data configuration of the data set must match the controller configuration exactly. The data
types must be identical to translate the proper values.
Each of the 24 values in the edit box must have the correct data type selected. If the data type is
incorrect, values that are read or written may appear to be incorrect! To set all the values at once
right click on the Values list box.
If only one point is configured, then the bridge will only write out the specified number of
values. If the incoming data set has fewer points in the message, then only the specific points
will be updated. If there are more data points in the incoming data set, then those extra points are
ignored.
Text sets are slightly different than data sets in that only one value can be transmitted at a time.
Additionally, the size of the text string must be indicated. Again this must be exactly the same as
what is configured on the controller.
In the "Insert New Alias" dialog box, enter a name for the alias and the item path (item ID) for
the OPC item that it references. Click the ellipsis button to browse for available item ID's on the
server. Click Save to save the alias, or click "Save & Create New" to configure another one.
Select the “Default to new” checkbox to make the “Save & Create New” button the default
control when you press Enter, rather than Save. Double-click an existing alias or press Enter
while it is selected to change its settings.
Additional options available when creating an alias are as follows. The Data Type drop-down
box allows the user to specify a "canonical" data type for the alias. The OPC item value is
coerced to this data type prior to being sent to the client. The Read-only checkbox prevents client
applications from writing to this item. The Update Rate and "Poll when inactive" fields work
together to ensure that data for the item is always received at a particular rate even if it is not
being read by the client.
Certain standard scaling formulas may also be applied to the alias. Click the button marked
"Scaling >>" to display the scaling portion of the dialog box. Click the tab corresponding to the
desired type of scaling and fill in the parameters as needed. Click "<< No Scaling" to hide the
scaling portion. When the scaling portion is not visible, no scaling is applied to the alias.
The four available types of scaling are Linear, Square Root, Gain/Offset, and Expression. For
each type of scaling, a different algorithm is applied to the incoming value before it is passed on
to the client. A reverse algorithm is applied to any values written to the alias before they are
passed on to the OPC item.
x − Offset
Gain/Offset Gain ⋅ x + Offset
Gain
Both Linear and Square Root scaling use the same parameter. Enter the high and low range for
the expected raw values and their corresponding high and low scaled values. Optionally, select
the corresponding checkboxes to "clamp" the value to its high or low limit to prevent it from
going out of range. Gain/Offset is a special type of linear scaling where only a scaling factor and
offset need to be specified (no limits are assumed). Incoming values must be numeric for these
scaling types to work.
Expression scaling provides the ability to enter simple text equations to be applied to incoming
and outgoing values. Enter the equation to be applied to incoming values in the Input field and
enter the equation to be applied to outgoing values in the Output field. Click one of the ellipsis
buttons to bring up the expression wizard to assist with the creation of a formula. See the Annex
for further information about expression syntax.
Select an alias group in the tree view to display the aliases configured in that group. The name,
item path, data type, access rights, and update rate for each alias are listed in the right-hand side
of the window.
The alias database can be exported to and imported from comma-delimited text files (CSV).
Choose Export Aliases from the File menu and choose a file location to export the current
configuration. Choose Import Aliases from the File menu and choose the desired file to import
aliases into the current configuration. See the Annex for a description of the alias CSV file
format.
Important Caveats:
1. You should specify a variant type (e.g. VT_UI2, VT_I4) when requesting data from
an alias; by default, a scaled alias becomes a variable of type REAL.
Note 2. Using Square Root scaling is not recommended for signed numbers. If the square
root expression becomes negative, the alias will return –1, bad quality.
3.7 STATISTICS
Select an object in the tree view under “Server Configuration”. If the statistics panel is not
already showing then choose Statistics from the View menu. The statistics panel appears just
below the object tree view. It displays any communication statistics that are supported for the
selected object. Different objects supply different statistics as appropriate. The possible values
are as follows.
Statistic Description
Sent The number of messages (requests) sent to the device.
Received The number of messages (responses) received from the
device.
Timed Out The number of timeout periods that have elapsed waiting for a
response.
Retried The number of messages re-sent to the device.
Failed The number of failed transactions (due to timeouts or
communication errors).
Overrun The number of times that the program failed to get a response
3.8 OPTIONS
Choose Options from the View menu to change the advanced options for the server. These
values are stored in the registry and loaded by the server at start-up. Therefore, the server must
be shut down and restarted in order for changes in this dialog to take effect. Click the Defaults
button to restore the original settings for the server.
3.8.1 GENERAL
The General tab contains settings related to the configuration of a server. Select the “Load
configuration on start-up” checkbox and enter a filename in the edit box below it to have the
server automatically use the specified configuration file when it is launched. Click the ellipsis
button next to the edit box to browse for the file. Select the “Save current configuration on
shutdown” to have the server automatically save any changes to the configuration when it shuts
down (not usually needed).
Select the “Launch configuration program on start-up” checkbox to have the server automatically
spawn the configuration utility when it starts up as a local executable. Otherwise, the
configuration utility will have to be started manually from the Start menu. The configuration
utility must always be started manually when the server runs as an NT service.
Select the “Restrict items to pre-configured aliases only” checkbox to prevent client applications
from connecting to anything except for configured aliases in the server. When this box is
selected, client applications will not be able to access any “raw” OPC items. This may be useful
for security reasons.
3.8.2 LOGGING
All Matrikon OPC Servers produce log files that record errors and debugging information. If
difficulties occur with a server then the log files can be extremely valuable for troubleshooting.
By default, the servers log very little information. The Logging tab of the Options dialog
contains settings to control server logging.
General Activity Logging records information about the internal workings of the OPC server. It
is useful for troubleshooting problems with configuration and device communication. Select the
“Enable activity logging” checkbox and choose the desired log level from the drop-down box.
Available log levels include Medium, Low, and None.
The higher the log level, the more information is recorded. However, server
performance may decrease at higher log levels. The recommended operating level is
Low.
Note
Enter a filename in the edit box or click the ellipsis button to browse for a file location. The
default log file is “PSTCFGMatrikon.OPC.Device.#.LOG” in the MATRIKON\COMMON
directory under the Program Files folder. Select the “Overwrite old log information” checkbox to
overwrite this file each time the server starts up. Otherwise, it will rename the old file to start
with an underscore.
Select “Display activity log on screen” to show the log messages in a console window as they
occur. This may have a negative effect on server performance especially at higher log levels.
Interface Activity Logging records information about the client/server OPC communication. It is
useful for troubleshooting compliance issues. Select the “Enable logging” checkbox and choose
the desired log level. The server will generate a separate log file for each client named
“PST###.tmp” in the directory where it is installed. Interface Activity Logging is not generally
used.
Select the “Commit all log file writes” checkboxes for either log file to ensure that its buffer is
flushed each time a message is logged. This can be useful when a fatal error that causes the
server program to crash is occurring regularly. However, it is not recommended for normal
operation as it greatly decreases the performance of the server.
3.8.3 ADVANCED
The Advanced tab contains some special timing parameters sometimes used to improve the
performance of certain OPC servers. It is not usually a good idea to alter these settings unless
asked to do so by support staff. They have very little effect on device communication.
The first edit box specifies the minimum update rate that the server will allow for any OPC
group. This prevents client applications from requesting update rates that are impossible to
achieve or that cause heavy CPU loads. The default value is 100ms.
The second and third edit boxes work in conjunction to break up the scanning of items in large
groups with slow update rates in order to reduce CPU load. For every “OPC Items per Group
Scan (maximum)” number of items scanned, the scanning thread will pause for “OPC Group
Scan Pause (maximum)” number of milliseconds. The default values are zero, indicating that no
pause occurs in the scan loop.
To create an OPC item, enter an item ID in the edit box and click the right-pointing arrow. The
item appears in the list box on the right-hand side of the window. Double-click on an item to edit
its settings (the appearance of the arrow changes). Choose “Update and Return to Explorer” to
add the created items to the OPC group and return to Matrikon OPC Explorer.
In addition to an item ID, users can also specify an access path, a requested data type, and an
active state. The following sections describe these settings in further detail.
In the item display, the Value field shows the real-time value for the item. The Quality field
indicates whether or not this value is valid, and why (see the annex for a list of quality values).
The Timestamp field indicates how “fresh” the value is (the time that it was received from the
data source).
The information panel at the bottom of the window displays status information about the selected
server and group. Choose “Info Panel” from the view panel to hide and show this panel.
Control values may be written to items regardless of whether they or the group that they
are in are active or inactive. If the items and the group containing the items are both
active then the written control value should appear when the next update occurs. Also,
Note some OPC servers may contain read-only item. Values written to these items will be
discarded.
Matrikon OPC Explorer also contains a Signal Generator to write ramping control values to OPC
items. Choose the “Signal Generator” tab in the “Write Values” dialog box. Enter the high and
low limits and the increment factor for the ramp wave. Finally, enter the time period in
milliseconds and press Start. Press Stop or close the dialog box to finish writing the ramp wave.
4.7 OPTIONS
Choose Options from the View menu to display the Options dialog box. Users can change certain
aspects of OPC Explorer’s behavior with these options. Click the Defaults button to restore the
original settings
4.7.1 GENERAL
Use the Errors checkboxes to specify whether the error dialog box should be displayed when
COM or OPC errors occur, or when errors occur for individual items. The sanity check option
ensures that the OPC server keeps track of lists of groups and items properly. At present, session
files may only be stored as text files, so the binary format is unavailable.
4.7.4 COM
Use these checkboxes to specify the class context flags to be used when OPC Explorer attempts
to connect to an OPC server. Do not deselect any of these flags unless absolutely necessary.
6. TROUBLESHOOTING
The following sections address some of the most common problems encountered while using this
OPC server. Please check the following list before contacting Matrikon Technical Support.
• Problem: The OPC server stops updating the client with item values after two hours.
Solution: The OPC server is licensed with a hardware key, and the demonstration period for
the server has expired. Check that the correct HASP hardware key is securely fastened to the
parallel port. If it is, run the HINSTALL program that is located in the
MATRIKON\COMMON directory under Program files with the “/I” parameter.
• Problem: The OPC server shuts down automatically after 5 minutes when no clients are
connected.
Solution: This is standard behavior for COM servers. However, you can override this
behavior as follows:
- In the registry, locate HKEY_CLASSES_ROOT\PSTCFGMatrikon.OPC.{server
name}.1\CLSID\ and obtain the class ID of the OPC server.
- In HKEY_CLASSES_ROOT\CLSID\{class ID of OPC server}\Options create a
string value named “LockServer”. To create a new value, select the Options key, and
then select Edit\New\String Value from the Registry menu.
- Set the value of the LockServer entry to “1”. To edit the value, select the entry and
select Edit\Modify from the Registry menu.
Eg. Simulation server’s CLSID is {F8582CEE-88FB-11D0-B850-00C0F0104305}
• Problem: There is more than one HASP hardware key from Matrikon attached to the
parallel port, but only the first one is recognized by the software.
Solution: HASP keys from the same vendor can not be chained together. Send an email to
technical support (please refer to the beginning of this manual) to obtain a HASP key
containing the combined codes of all installed Matrikon OPC servers.
• Problem: The server cannot be configured because there is no red ‘X’ in the System
Tray.
Solution: If the server is running as a service, you will not see the usual red ‘X’ in the system
tray that indicates the OPC server is running. To configure the server, start the configuration
1) The subscription type item-id is used to specify objects of various types. The format is as
follows:
GcomCardName,Controller,ObjectType,ObjectName,SubscriptionType,
Parameter,{StatusParameter}
Parameter Description
GcomCardName This is the name of the GCOM card defined in the bridge configuration.
Controller This is the name of a controller defined in the bridge configuration.
ObjectType This is the type of object to access.
ObjectName This is the actual name of the object.
SubscriptionType This is how the bridge should retrieve the data from the object.
Valid types are:
D – Demand update
E – Event update
C1 – 1 second cyclic update
C2 – 2 second cyclic update
C3 – 3 second cyclic update
Parameter This is the name of the parameter of the object that is to be accessed. (refer
to annex to see valid types)
StatusParameter The name of a specific status for an associated status field. Ie.
“Above_HI_Limit_2” (Refer to annex for a list of vaid names.)
NOTE: If the object has an associated status, the status parameters can be referenced as indicated
by the {StatusParameter} option.
When setting up data points once the user creates a single point for an object, the bridge will
automatically create all the other possible fields and status that can be accessed. It is highly
recommended when configuring other points for the same object that the browsing method be
used.
By selecting a “hint” point, and changing the object name, the rest of the points will be created
and can be selected with out having to create each individually.
2) The data set item-id is used to access data values of a configured data set.
GcomCardName,Controller,DataSetName,ValueX(.X)
Parameter Description
GcomCardName This is the name of the GCOM card defined in the bridge configuration.
Controller This is the name of a controller defined in the bridge configuration.
DataSetName This is the name of the configured data set.
ValueX(.X) When data sets are configured, the values are automatically created in the
bridge. If it is boolean, or some other type with sub values, the sub values are
generated as well for each of the 24 original values.
Each subscription defines how data is collected from the controller. The cyclic subscriptions
receive data regularly at the specified intervals. Demand data is only received when requested,
and the Event updates only receive data when an event, as defined in the ABB documentation for
specific objects, occur.
NOTE: For cyclic writes to start all data set values configured must be written to at least
once!
NOTE: When starting up at least one of the 24 data values must be accessed to start data
transfer! For any values that are not “connected”, the default values will be used when
sending the packet!
The Matrikon OPC Server for GCOM includes three items that provide useful information on the
status of the GCOM card. These items are “GCOMCardStatus”, “SysText” and “SysText#”
• GCOMCardStatus: This item reflects the status of the communication between the
OPC server and the GCOM Card. The value is 0 until the OPC server has received
communications from the GCOM device. At that point, the value becomes 1 and stays at
1 until communications with the GCOM device is broken. The OPC quality is kept at
Q_GOOD to allow users to graph it with a program such as PI. A graph of this point will
show when the OPC server has and has not been connected to the GCOM device. If the
network is totally reliable, this graph will show when the GCOM link is up and when it is
down. Note that this value is dependent upon the ping interval, set in the configuration
screen. This value will be updated every ping interval, and may not show that a
connection has been broken until the ping interval has elapsed. If the ping interval is set
to 0, the value of GCOMCardStatus is meaningless since the card is never pinged, but is
assumed to be perpetually available.
While datasets in every type of controller are the same in terms of the protocol, with a set having
up to 24 4-byte values, the possible data type of a value will vary from controller to controller.
There are currently three controller types supported by the GCOM OPC server: Advant
controller series, such as the AC450; Plant Network Gateway to MOD300 devices; and the
P4000 Gateway to the Kent 4000 DCS system.
The following table describes the types allowed for each controller, and specific information
about each type. The Item Subtype field is the notation used to access the subtype in an OPC
item ID. For example, to access the CTRL field in a Status type, the syntax would be (using
typical example links):
Gcomcard,P4g,Dataset001,VALUE1.CTRL
Text sets are allowed in most controllers as well, with sizes varying from 20-72 characters. A
text set contains only ONE string per set, with the length fixed by the controller and/or OPC
server. A text set creates three items within the text set link: REAL_VAL, INT_LONG, and
TEXT. The text item contains the actual text set text, while the others can contain additional
information passed with the set.
Appendix B - PERFORMANCE
The Advant 400 series controllers have the following performance criteria:
• At most 50 messages per second can be transferred through one GCOM card.
• A maximum of three signals per 60 ms can be transferred through one GCOM card.
• A maximum of three signals ready for sending to each node on the GCOM bus can be
queued on the GCOM card.
• A maximum delay of 20ms will be seen when transferring messages between the Advant
Controller and the OPC GCOM Server.
The OPC Server must send an acknowledgement within 250ms otherwise the GCOM card will
retransmit the signal. The OPC Server will typically acknowledge a message at most within
20ms. Additional messages are queued on the GCOM card while waiting for this
acknowledgement.
Message examples are:
• A single data subscription request to one node, requesting 1-16 objects.
• A single answer on a request from one node which can contain of 1-38 objects depending on
the object type and access type.
Example:
– Up to 38 objects for cyclic data of DI or DO.
– Up to five objects for event data of DI or DO.
– Up to 23 objects for cyclic data of AI or AO.
– Up to three objects for event data of AI.
– Up to two objects for cyclic data of PIDCON.
– One object for demand data of PIDCON with access type 3.
• A single Data Set (with up to 24 values (a value can be one integer, one real or 32 Boolean)).
• A single order for one object.
If data sets are used at most 24*50 = 1200 values per second (1200 (integer/real) or 38400
(Boolean) object values) values can be sent or received.
For other controllers, please consult your ABB documentation for performance specifications.
Performance Considerations
Receiving Data Sets generate more load than transmitting Data Sets. To minimize the load, you
can create database elements for receiving Data Sets in an Advant 450 Controllers before
transmitting. Place database elements for the Data Set which receives data most frequently at the
beginning. If there are still load problems in the controller or on the bus, you can transmit data
event-controlled. Use the element SENDREQ for this. You can use the “VALID” flag on the
database element for a receiving Data Set and the DAT element as a “Fresh data available” flag.
1
Contents of entire page from GCOM Multidrop User’s Guide.
Copyright ABB Industrial Systems AB 1997.
DCOM settings are stored in the registry and loaded by COM (and OPC) servers at
start-up. Therefore, server processes must be shut down and restarted in order for these
changes to take effect.
Note
Click on the Security tab to set the Security for the Server.
To add users to the list click Add. Another screen similar to the following appears:
To add a user to the list click on that user and then click Add. If the user you wish to add does
not appear then click Show Users. When you are done adding users click OK to close “Add
Users and Groups”. You can then choose to “Allow Access” or “Deny Access” for each user.
This method may not work for every OPC client. Please check the client documentation
for more information.
Note
1. On the server machine, run REGEDIT as a user that has access rights to the local registry.
2. Expand the HKEY_CLASSES_ROOT key.
3. Find the program ID(s) for the desired OPC server(s). In the case of Matrikon OPC Servers,
the ID has the form "Matrikon.OPC.Device". If you quickly type the first few letters then
REGEDIT should jump to the location of that key. Some servers may have both a version-
specific as well as a version-independent program ID. In this case both ID's should be copied
to the client machine.
4. For each program ID, select the key and choose "Export Registry File" from the Registry
menu. Enter a file name and choose Save. Be careful not to overwrite other export files that
you are creating.
5. Copy the exported REG files to the client machine.
6. Merge the REG files into the registry of the client machine. This should simply be a matter of
double clicking on the file from the desktop of the client machine. Alternatively, run
REGEDIT on the client machine and choose "Import Registry File" from the Registry menu,
selecting each file in turn. This must be done as a user who has write access to the local
registry.
7. Use REGEDIT to check that the program ID's have in fact been copied.
8. Delete the REG files since they are no longer needed.
Field Description
The name of the alias group folder to add the alias item to.
Periods in this name indicate subfolders below the root (i.e.
"Alias Group"
North.FIC101 = folder "North" under the root and subfolder
"FIC101" under that).
The alias item name. To access a particular item from an
"Alias Name" OPC client, the full path name is delimited with periods (i.e.
North.FIC101.CV).
The fully qualified item ID for the OPC item to which this
"Item Path"
alias refers.
A number indicating the data type to convert the value to
before it is returned to the OPC client. This is also appears
as the "canonical" data type for the alias when browsing.
<data type>
Use as zero in this field for the default data type of the
referenced OPC item. See the annex for a list of possible
values.
The number one in this field indicates that the alias cannot
<read-only>
be written to. The number zero indicates that it can.
These values are used in conjunction to ensure that an OPC
item is always being scanned whether the client is presently
<poll always>,
using it or not. Set the "poll always" value to a one for the
<update rate>
item to be scanned continuously, and specify the update rate
in milliseconds. Otherwise, set both values to zero.
Field Description