Remote Automation Solutions Guide: OpenEnterprise OPC Client RDI Reference Guide Manuals & Guides
Reference Guide
D5092
12-Dec-2007
OPC Client RDI
Bristol OpenEnterprise Reference Guide
OPC Client RDI
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 2
OPC Client RDI
Contents
1 OPC Client RDI......................................................................................................................... 5
2 The OPC Client RDI Interface ................................................................................................. 6
2.1 Accessing the OPC Client RDI Interface ............................................................................ 6
3 The OPC Server Page.............................................................................................................. 7
3.1 File Menu ............................................................................................................................ 7
3.2 Help Menu ........................................................................................................................... 7
3.3 Database Address............................................................................................................... 7
3.4 Driver Version ..................................................................................................................... 8
3.5 Time Zone ........................................................................................................................... 8
3.6 Timestamp Conversion ....................................................................................................... 8
3.7 OPC Client RDI Driver Status ............................................................................................. 8
3.8 OPC Server Name .............................................................................................................. 8
3.9 OPC Server Prog ID............................................................................................................ 8
3.10 OPC Server Network Address ......................................................................................... 8
3.11 OPC Server OPC Version ............................................................................................... 8
3.12 OPC Server Status ..........................................................................................................9
3.13 Sub Status ....................................................................................................................... 9
3.14 Group Details Button ....................................................................................................... 9
4 The OPC Group Details Page ...............................................................................................10
4.1 Number of Groups............................................................................................................. 10
4.2 OPC Group Name............................................................................................................. 10
4.3 OPC Group Active............................................................................................................. 10
4.4 OPC Group Status ............................................................................................................ 10
4.5 Sub Status......................................................................................................................... 10
4.6 OPC Group Requested Rate ............................................................................................ 10
4.7 OPC Group Revised Rate................................................................................................. 11
4.8 Deadband.......................................................................................................................... 11
4.9 Locale................................................................................................................................ 11
4.10 Time Bias .......................................................................................................................11
4.11 Item Details Button ........................................................................................................ 11
5 The OPC Item Details Page................................................................................................... 12
5.1 Number of Items................................................................................................................ 12
5.2 Item Name......................................................................................................................... 12
5.3 Tag Id ................................................................................................................................ 12
5.4 Item Active ........................................................................................................................ 12
5.5 Item Status ........................................................................................................................ 12
5.6 Sub Status......................................................................................................................... 13
5.7 Requested Type................................................................................................................ 13
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 3
Canonical Type ................................................................................................................. 13
5.8
5.9 Access Path ...................................................................................................................... 13
5.10 Access Rights ................................................................................................................ 14
6 Status Codes.......................................................................................................................... 15
6.1 OPC Group Status Codes................................................................................................. 15
6.2 OPC Item Status Codes.................................................................................................... 16
6.3 Sub Status Codes ............................................................................................................. 17
7 OPC Quality Flags ................................................................................................................. 19
7.1 Bad Quality Flags.............................................................................................................. 19
7.2 Uncertain Quality Flags..................................................................................................... 19
7.3 Good Quality Flags ........................................................................................................... 20
8 OPC Client Configuration .....................................................................................................21
8.1 Session Manager Configuration........................................................................................ 21
8.1.1 The Session Manager Task Page .............................................................................. 21
8.1.1.1 The Program ........................................................................................................ 21
8.1.1.2 Run Program in the following folder ..................................................................... 21
8.1.1.3 Program Arguments ............................................................................................. 21
8.1.2 The Task Shutdown Page .......................................................................................... 21
8.2 Polyhedra Config File........................................................................................................ 21
8.2.1.1 Dvi_register_datum_with_values ......................................................................... 21
8.2.1.2 Dvi_triggers_on .................................................................................................... 21
OPC Client RDI
9 Database Configuration ........................................................................................................ 23
9.1 Database DVI Architecture ............................................................................................... 23
9.1.1 Driver ..........................................................................................................................23
9.1.2 Network....................................................................................................................... 23
9.1.3 Device......................................................................................................................... 23
9.1.4 Schedule..................................................................................................................... 24
9.1.5 Datum ......................................................................................................................... 24
9.1.6 Region ........................................................................................................................ 24
9.2 OPC Data Access Interface .............................................................................................. 24
9.2.1 Server ......................................................................................................................... 24
9.2.2 Group.......................................................................................................................... 24
9.2.2.1 Name.................................................................................................................... 24
9.2.2.2 Active ................................................................................................................... 25
9.2.2.3 Percent Deadband ............................................................................................... 25
9.2.2.4 Locale................................................................................................................... 25
9.2.2.5 Time Bias ............................................................................................................. 25
9.2.2.6 Requested Update Rate ...................................................................................... 25
9.2.2.7 Revised Update Rate ........................................................................................... 25
9.2.3 Item............................................................................................................................. 25
9.2.3.1 Item ID (Tag) ........................................................................................................ 25
9.2.3.2 Access Path ......................................................................................................... 25
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 4
OPC Client RDI
9.2.3.3
9.2.3.4 Requested Data Type .......................................................................................... 25
9.2.3.5 Canonical Data Type............................................................................................ 26
9.2.3.6 Value .................................................................................................................... 26
9.2.3.7 Quality ..................................................................................................................26
9.2.3.8 Timestamp ........................................................................................................... 26
9.2.3.9 Error Status .......................................................................................................... 26
9.3 Mapped Tables for OPC Client RDI .................................................................................. 26
9.3.1 Dvi_region References ............................................................................................... 27
9.3.2 Dvi_schedule ..............................................................................................................27
9.3.3 OPC Driver ................................................................................................................. 27
9.3.4 OPC Server ................................................................................................................ 27
9.3.5 OPC Device ................................................................................................................ 27
9.3.6 OPC Group ................................................................................................................. 27
9.3.7 OPC Item .................................................................................................................... 28
10 Index ....................................................................................................................................... 29
Active ................................................................................................................... 25
9.3.7.1.1 OPCItemRealAnalog ...................................................................................... 28
9.3.7.1.2 OPCItemIntegerAnalog .................................................................................. 28
9.3.7.1.3 OPCItemDigital ............................................................................................... 28
9.3.7.1.4 OPCItemString................................................................................................ 28
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 5
OPC Client RDI
1 OPC Client RDI
OPC (Object Linking and Embedding for Process Control) is a client/server model intended to provide
greater interoperability between automation/control applications, field devices and business/office
applications in the process control industry.
OPC Server applications communicate directly with field devices, whilst OPC Clients are able to
retrieve that information from the OPC Server. In terms of OpenEnterprise this architecture is best
illustrated in the diagram below.
The OPC Client RDI provides a means of collecting data from OPC Servers and inserting the data
into an OpenEnterprise database. The OpenEnterprise OPC Client RDI is capable of communicating
with several OPC Servers concurrently, but only connects to one OpenEnterprise database at a time.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 6
OPC Client RDI
2 The OPC Client RDI Interface
The OPC Client RDI interface provides the user with three pages of information which display general
and status information for configured OPC Servers, Groups and Items.
2.1 Accessing the OPC Client RDI Interface
The OPC Client RDI interface can be set to be invisible if the 'Visible on the Desktop' box is left
unchecked on the Settings page for the task. However, if this field is checked, then the interface will
appear as a minimized icon on the Windows® Start bar when the OpenEnterprise session is run.
To edit the OPC Client RDI task within the Session Manager, select the task from the Session
Manager's Task List, select Stop from the context menu to stop the task. Then select the Properties
item from the same context menu. See the Session Manager Help for more information.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 7
OPC Client RDI
3 The OPC Server Page
This page displays information about the OPC Servers that the OPC Client RDI is currently set up to
connect to.
3.1 File Menu
The File menu provides only one option, which is to Exit the OPC Client RDI.
3.2 Help Menu
The Help menu provides an option to open this help file, and also to view the About box, which
provides information on the application version and build and also Bristol contact details.
3.3 Database Address
This is the TCP address of the OPC Client RDI driver as defined in the Services file, by default found
in the 'C:\Winnt\System32\Drivers\etc' directory.
An example entry in this file for the OPC Client RDI would be:-
opcclientrdi 11006/tcp OPCCLIENTRDI
The format being <service name> <port number>/<protocol> [aliases...] [#<comment>].
The OPC Client RDI's service name is stored in the address attribute of the applicable driver in the
OPCDriver table entry of the OpenEnterprise database.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 8
OPC Client RDI
3.4 Driver Version
This is the OPC Client version number. It does not represent the OPC Data Access standard.
3.5 Time Zone
The Time Zone setting of the OPC Client RDI, as sourced from the OPC Driver table. Because the
OPC standard is vague about how individual OPC Servers should format timestamps, special
consideration should be given as to whether the OPCDriver should convert timestamps to UTC.
3.6 Timestamp Conversion
The OpenEnterprise database requires that all timestamp values are stored in UTC. However the
OPC standard is vague about how individual OPC Servers should format timestamps, and from
experience on site it has been seen that some OPC Servers report timestamps in local time, while
others report timestamps in UTC. The OPC Client RDI can handle both of these situations, as
detailed below.
If the OPC Server is communicating with an OPC Server that does report timestamps in local time,
then the OPC Client RDI must be configured to convert those timestamps into UTC before they are
inserted into the database. This is achieved by setting the OPCDriver attribute ConvertTimeStamps to
TRUE. (which is the default value for this attribute) and ensuring that the timezone attribute of this
table is set to the same timezone as that with which the OPC Server is reporting timestamps. These
values can then be used in conjunction with any time bias that may be defined to correctly convert the
timestamps into UTC before they are inserted into the database.
If the OPC Server returns timestamps in UTC then no time conversion is required, and in this case the
ConvertTimestamps attribute value must be set to FALSE.
3.7 OPC Client RDI Driver Status
A zero means the driver is working properly. Non-zero means there are problems.
3.8 OPC Server Name
The name of the OPC Server. It is sourced from the networkame attribute of the opcserver table.
3.9 OPC Server Prog ID
The program id of the OPC Server as sourced from the OPCServer attribute of the OPCServer table.
3.10 OPC Server Network Address
This displays the computer on which the OPC Server is running. If the Server is running on the local
machine, this field will say 'Local'.
3.11 OPC Server OPC Version
This value indicates the Data Access standard to be used when communicating with the OPC Server.
This will be listed on the dialog as either 1.0 (corresponding to a value of 0 in the opcversion attribute
of the OPCServer table), or 2.04 (corresponding to a value of 1 in the opcversion attribute of the
OPCServer table).
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 9
OPC Client RDI
3.12 OPC Server Status
A zero value means there are no errors. Anything else is an error. The possible status codes and their
meaning are described in the OPC Server Status Codes topic. Click the link below to go to this topic
now.
3.13 Sub Status
The SubStatus attribute can hold any error returned either by COM or by a specific OPC Server.
3.14 Group Details Button
When an OPC Server is selected from the list, this button becomes enabled. Clicking the button then
opens the OPC Group Details Page, which displays OPC Groups that have been configured for the
selected OPC Server. Click on the link below to view help for this page.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Reference Guide
D5092
12-Dec-2007 - Page 10
OPC Client RDI
4 The OPC Group Details Page
This page displays details about the OPC Groups which have been configured for the selected OPC
Server.
4.1 Number of Groups
The number of Groups configured for the selected OPC Server
4.2 OPC Group Name
The name of each configured OPC group sourced from the name attribute of the opcgroup table.
4.3 OPC Group Active
This value displays True if the Group is currently active, False if not. If a Group is marked as inactive,
then the OPC item values associated with it will not be reported to the OPC Client RDI.
4.4 OPC Group Status
A zero value means there are no errors. Anything else is an error. The possible status codes and their
meaning are described in the OPC Group Status Codes topic. Click the link below to go to this topic
now.
4.5 Sub Status
The SubStatus attribute can hold any error returned either by COM or by a specific OPC Server.
4.6 OPC Group Requested Rate
The period, in milliseconds, at which the OPC Client RDI requires any changes in data or quality, for
OPC Items within the group, to be reported. This value is sourced from the requestedupdaterate
attribute of the opcgroup table.
Remote Automation Solutions
Website: www.EmersonProcess.com/Remote
Loading...