Professional Documents
Culture Documents
User's Manual
MatrikonOPC Server for Mark VI Direct
User's Manual
Phone: +1.780.448.1010
Fax: +1.780.448.9191
www.matrikonopc.com
Document
Date Description Author
Version
2009-12-03 1.0 Initial document SN
2010-05-05 1.1 Updated the screenshots, device link names and ZA
tables.
Version: 1.0.0
DOCUMENT VERSION
Version: 2.2
COPYRIGHT INFORMATION
© Copyright 1997 - 2010, Matrikon Inc. 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 Inc.
CONFIDENTIAL
The information contained herein is confidential and proprietary to Matrikon Inc. It may not be disclosed or transferred,
directly or indirectly, to any third party without the explicit written permission of Matrikon Inc.
LIMITATIONS
Matrikon has made its best effort to prepare this manual. Matrikon makes no representation or warranties of
any kind with regard to the completeness or accuracy of the contents herein and accepts no liability of any kind
including without limitation warranties of merchantable quality, satisfactory quality, merchantability and
fitness for a particular purpose on those arising by law, statute, usage of trade, course of dealing or otherwise.
Matrikon shall not be liable for any losses or damages of any kind caused or alleged to be caused directly or
indirectly from this manual.
LICENSE AGREEMENT
This document and the software described in this document are supplied under a license agreement and may only be used
in accordance with the terms of that agreement. Matrikon reserves the right to make any improvements and/or changes to
product specifications at any time without notice.
TRADEMARK INFORMATION
The following are either trademarks or registered trademarks of their respective organizations:
OTHER
Table of Figures
Figure 1 - Architecture using the MatrikonOPC Server for Mark VI Direct ........................ 6
Figure 2 - Insert New Object Window ............................................................................ 12
Figure 3 - Create New Mark VI Direct Network Window ................................................. 14
Figure 4 - GE Mark VI Configuration Files....................................................................... 15
Figure 5 - New Mark VI Direct Network Object............................................................... 16
Figure 6 - MatrikonOPC Server for Mark VI Direct and GE Mark VI Exchanges ............... 17
Figure 7 - Mark VI Direct Unit Settings Panel ................................................................. 18
Figure 8 - Client Reference Warning Message ................................................................ 20
Table of Tables
Table 1 - Terms and Definitions........................................................................................ 8
Table 2 - Files Installed in "Mark VI Direct" Folder (For Stand-Alone Server) ................ 10
Table 3 - MatrikonOPC Support Regional Contact Information ....................................... 11
Table 4 - After-Hours Support ........................................................................................ 11
Table 5 - Insert New Object Window Options................................................................. 12
Table 6 - Create New Mark VI Direct Network Window Components .............................. 15
Table 7 - Mark VI Direct Unit Settings Panel Components .............................................. 19
Table 8 - Mark VI Network Control Items....................................................................... 21
Table 9 - Mark VI Unit Control Items.............................................................................. 22
Table 10 - Mark VI Network Statistical Items................................................................. 22
Table 11 - Mark VI Unit Statistical Items ....................................................................... 23
Table 12 - OPC Events different categories .................................................................... 24
Table 13 - OPC Events Attributes ................................................................................... 24
Table 14 - Alarm Acknowledging Control Items ............................................................. 25
Overview of Manual
This document uses icons to highlight valuable information. Remember these icons and what they
mean, as they will assist you throughout the manual.
The User’s Manual has been designed as such so that you can click on references in the document
to jump to that referenced point without having to scroll through several pages (in some cases).
For example, if you were to see the sentence “Refer to Figure 1 for more information”, pressing the
CTRL key and clicking your mouse on the text “Figure 1” will automatically take you to the location
of Figure 1 within the document.
This manual consists of several sections and is structured as follows:
References
This document references information found within the following documents/sites:
• www.opcfoundation.org
• www.matrikonopc.com
• www.opcsupport.com
• MatrikonOPC Server User’s Manual
• OPC Overview 1.0
• OPC Common Definitions and Interfaces 1.0
• OPC Security Custom Interface 1.0
• OPC Data Access Custom Interface Standard 2.05
• OPC Data Access Custom Interface Standard 3.00 (Pending)
• TCP/IP Ethernet Communications for the Series 90 PLC User's Manual GFK-1541A April 1999
• United States Patent No.: US 6,169,928 B1 January 2nd 2001
• TCP/IP Ethernet Communications for the Series 90™ PLC User's Manual GFK-1541B May
2002
• TCP/IP Ethernet Communications for PACSystems™ User's Manual GFK-2224A May 2004
Document Terminology
The terms screen and window are used interchangeably throughout this document.
Table 1 provides a list of definitions for terms used throughout this document.
Term/Abbreviation Description
A&E OPC Alarms and Events. Provides access to process alarm and event data.
Component Object Model. A method for organizing software, specifying
COM
how to build components that can be dynamically interchanged.
DA OPC Data Access. Provides access to real-time process data.
Distributed Component Object Model. An extension of COM that allows
DCOM
communication between COM components over a network.
System Requirements
The software has Software and Hardware system requirements. These requirements must be
met for the software to function properly.
Software Requirements
At a minimum, the following software is required:
• Microsoft Windows XP SP2, or
• Microsoft Windows 2003 SP0, or
• Microsoft .NET Framework 2.0 (included with this install program)
Hardware Requirements
At a minimum, the following hardware is recommended:
• Intel® Pentium® 4 Processor
• 512 MB RAM
• 40 GB 7200 RPM Hard Drive
The product requires the following additional hardware to make use of the following functionality:
• TCP/IP-compatible network adapter
Installed Files
The installation program copies all necessary files to the target computer and creates short-cut
icons in the Start menu.
The files specific to the server listed in Table 2 are installed by default in the following location:
C:\Program Files\Matrikon\OPC\Mark VI Direct
Licensing
Most MatrikonOPC products require that some form of licensing criteria be met for it to function
correctly.
The MatrikonOPC Server for Mark VI Direct supports software licensing only.
IMPORTANT TO NOTE:
The following licensing information is described in detail within the
Licensing Procedures document which accompanies the MatrikonOPC
Server for Mark VI Direct software and User’s Manual:
• Software key licensing information.
• Information about the MatrikonOPC Licensing Utility that is
used to license server software, and the variety of ways in
which licenses can be obtained (e.g., Internet Connection, Web
Page, Email).
• Licensing Q&A and Troubleshooting.
Contacting Support
The MatrikonOPC Customer Services department (www.opcsupport.com) is available 24 hours a
day, seven days a week.
Contact MatrikonOPC Support using the information below, or send an email
(support@MatrikonOPC.com).
For Monday to Friday daytime support requests, contact MatrikonOPC Support using the regional
phone numbers provided in Table 3.
For after-hours support in all regions, please use either of the following numbers. There is no
extra charge from MatrikonOPC for calling their after-hours support numbers.
Server Configuration
This section shows you how to create and edit objects, using the Configuration window.
Creating Objects
The Insert New Object and Create New windows are used to create Mark VI Direct objects.
Table 5 describes the types of objects that are available for insertion as a child in the Insert New
Object window, depending on which object is currently selected.
Table 6 describes the components of the Create New Mark VI Direct Network window.
Component Description
Name of the object, which becomes an element of the item ID for data items
Name under the object.
Automatically converted to title case for display purposes.
Use this checkbox to enable (i.e., checkbox is selected) or disable (i.e.,
Enabled checkbox is cleared) communication for the object.
By default, the checkbox is selected.
This field is optional, takes any user-defined text (64-character maximum) for
Description documentation purposes.
By default, this field is blank.
Allows you to select, from the drop-down list, the Network Interface Card used
Network Adapter
to connect to the Unit Data Highway (UDH) network.
Allows you to enter a value that defines the port number used to receive the
EGD Port EGD exchanges over the Unit Data Highway (UDH) network.
Default = 18246.
Figure 4 shows the GE Mark VI configuration files (along with the CONFIG.DAT) that are required to
fully configure the OPC server. The exact same hierarchy must be respected:
CONFIG.DAT
ENETALM.DAT
|
|______ UNIT1
| |
| |
| |
| |______ UNIT_EGD.DAT
| |______ ALARM.DAT
| |______ ALARMSIG.DAT
| |______ EVENT.DAT
|
|
|
|
|
|
|______ UNIT2
.
.
.
Figure 4 - GE Mark VI Configuration Files
EGD Overview
Ethernet Global Data (EGD) allows one device (the producer) to share a portion of its internal
memory (the exchange) with one or more other devices (the consumers) at a regularly scheduled
periodic rate. This exchange is uniquely distinguished by a set of identifiers: the Producer ID
(typically the producer’s IP address) and Exchange ID. The Producer ID is assigned to uniquely
identify the Ethernet Global Data device that produces the exchange on the network. The Exchange
ID is a value identifying a specific exchange within that producing device.
The MatrikonOPC Server for Mark VI Direct must be configured to consume the GE Mark VI
Controllers data as illustrated in Figure 6 by providing a path to the most up-to-date site’s
configuration file (CONFIG.DAT).
Note:
Once a path to the site’s configuration file (CONFIG.DAT) is provided,
the MatrikonOPC Server for Mark VI Direct creates a unit object for
each unit defined in the site configuration.
Please press F5 or click on the refresh button in order to visualize the
newly created unit objects.
Table 6 describes the components of the Mark VI Direct Unit Settings window.
Component Description
Name of the object, which becomes an element of the item ID for data items
Name under the object.
Automatically converted to title case for display purposes.
Use this checkbox to enable (i.e., checkbox is selected) or disable (i.e.,
Enabled checkbox is cleared) communication for the object.
By default, the checkbox is selected.
This field is optional, takes any user-defined text (64-character maximum) for
Description documentation purposes.
By default, this field is blank.
Allows you to enter a value that defines the amount of time (in milliseconds)
before reporting an EGD Exchange timeout. The maximum value allowed is
Timeout 60000 milliseconds.
Default = 1000.
Allows you to enter a value that defines the amount of time (in milliseconds)
Connect Delay between two consecutive connection attempts. The maximum value allowed is
10000 milliseconds.
Changing Objects
To change an object’s configuration:
1. Once an object is created, select it in the tree view panel.
2. In the configuration panel, make the applicable changes.
3. Click on the Apply button to accept the changes, or click on the Cancel button to discard
them.
Removing Objects
Note: Users can easily remove any object that they have created, but a warning message (Figure
8) will appear when users remove an object that has data items to which one or more OPC clients
hold reference.
To remove an object:
1. In the Configuration window, under Server Configuration, select the object to be
removed.
2. From the Edit menu, select the Delete menu option (or click on the button).
3. If one or more OPC clients hold references to data items somewhere under the selected
object, a warning message (Figure 8) appears.
4. To mark the object for later deletion, click on the Yes button. To leave the object
unmodified, click on the No button.
Note: Items marked for deletion are disabled and a red X appears over the icon on the right
side of the window when the object is selected.
Important Note:
• Upon connection a list of points is automatically built, based on
the exchange definition file UNIT_EGD.DAT located in the unit’s
folder.
Where:
• “Mark VI Direct Network” is the name assigned to the Mark VI Direct Network.
• “Mark VI Direct Unit” is the name assigned to the Mark VI unit in the site configuration
file.
• “Point name” as defined in the UNIT_EGD.DAT in the unit specific configuration folder.
Examples
Accesses a point called “LTB1D1” located in unit
UDH.S1. LTB1D1
“S1” that is connected to a network called “UDH”.
Accesses a point called “AFPBD” located in unit “F1”
UDH.F1. AFPBD
that is connected to a network called “UDH”.
Statistical Items
The server supplies statistical information pertaining to communication in the form of real-time
data items for the Mark VI Network and each Mark VI unit.
When triggered, the simple OPC event has its severity set to MEDIUM (500) and source set to the
controller (unit) full path. The simple OPC event has also other information which is added to the
event’s message and attributes.
Figure 9 shows a sample of OPC events triggered by the OPC server after reading the controller
alarm information. Note that the attributes are added to the OPC event in the same order as the
Table 13.
Acknowledging Alarms
The MatrikonOPC Server for Mark VI Direct provides control items which can be used for
acknowledging alarms, as described in Table 14.
Refer to the MatrikonOPC Server for Mark VI Direct Release Notes for known issues.
Problem: After configuring the OPC server using a site’s configuration file (CONFIG.DAT). Data
items have been added to a compliant OPC client. Some of the items are showing “bad
configuration” quality.
Solution: Ensure that the site’s configuration files provided are the most up-to-date ones.
Search the MatrikonOPC Support Knowledge Base at www.opcsupport.com to find the answers
to other commonly-asked MatrikonOPC Server for Mark VI Direct questions.