Yokogawa YGW
Interface to the PI System
Version 1.37 and Greater
How to Contact Us -
Phone
|
(510) 297-5800 (main number)
(510) 297-5828 (technical support)
|
Fax
|
(510) 357-8136
|
Internet
|
techsupport@osisoft.com
|
World Wide Web
|
http://www.osisoft.com
|
Bulletin Board
|
(510) 895-9423
Telebit WorldBlazer modem (Hayes, MNP, or PEP compatible)
8 data bits, 1 stop bit, no parity, up to 14400 bps download
protocols: Xmodem, Ymodem, Zmodem, Kermit
|
Mail
|
OSI Software, Inc.
P.O. Box 727
San Leandro, CA 94577-0427
USA
OSI Software GmbH
Hauptstrae 30
D-63674 Altenstadt 1
Deutschland
|
OSI Software, Ltd
P. O. Box 8256
Level One, 6-8 Nugent Street
Auckland 3, New Zealand
|
Unpublished -- rights reserved under the copyright laws of the United States.
RESTRICTED RIGHTS LEGEND
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii)
of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013
Trademark statement—PI is a registered trademark of OSI Software, Inc. Microsoft Windows, Microsoft Windows for Workgroups, and Microsoft NT are registered trademarks of Microsoft Corporation. Solaris is a registered trademark of Sun Microsystems. HP UX is a registered trademark of Hewlett Packard Corp. IBM AIX RS/6000 is a registered trademark of the IBM Corporation. DUX, DEC VAX and DEC Alpha are registered trademarks of the Digital Equipment Corporation.
1997 OSI Software, Inc. All rights reserved
777 Davis Street, Suite 250, San Leandro, CA 94577
Table of Contents
How to Contact Us ii
Table of Contents iii
Introduction 1
Communication Configuration 2
Yokogawa Gateway Setup Diagram 2
Hardware Configuration 2
Micro XL Ethernet Requirements 3
Outline of Operation 5
Input Tags 5
Output Tags 5
Tag Attributes Update 6
Event Counter Tags 6
Logging File 6
Error Handling 7
PI System Databases 9
Point Source (PI2 only) 9
Digital States 9
Tag Definition 11
Interface Files 15
Interface Program File 15
Interface Startup File 15
Interrupt Messages Switch File 22
Data I/O Type Filter File 22
Digital State String Translation File 23
Communication Testing Programs 23
Pre-Installation Checklist 25
VMS Installation 26
Basic Installation 26
Permanent Installation 27
Windows NT Installation 29
Basic Installation 29
Permanent Installation 29
Appendix — Error Messages 31
Revision History 34
The Yokogawa YGW interface provides communication between PI and Yokogawa CGWU, EGCW3 and ECGW* gateways and the Micro XL DCS. It is an OSI Software standard Universal Interface (Uniint).
Note: All mention of the above four Yokogawa systems will be referred to, hereafter in this manual, as “the gateway”. If, however, information in this manual refers to a specific gateway, the actual gateway name will be used.
Data is transferred between the gateway and the interface via RS-232 Serial TTY communication or TC/PIP socket calls. Data is transferred between the interface and PI via the PI API. The PI API is necessary for the interface to run and is not included with the interface. The minimum requirements for the interface are given in the following table:
-
Platform
|
OS Version
|
PI System
|
PI API
|
VAX/Alpha VMS
|
All
|
2.1.1
|
N/A
|
Intel Windows NT
|
3.51
|
3.1
|
1.2
|
Alpha Windows NT
|
4.0
|
3.1
|
1.2
|
The interface supports input tags (from Yokogawa to PI) and output tags (from PI to Yokogawa). It counts the events to and from these tags, including exception tests, and sends its totals periodically to PI. Data from the gateway is received at cyclic frequencies or by exception in the data. The frequency of the cycles is configured by the user and controlled by the interface. The number of tags that the interface is capable of servicing is unlimited.
Changes that are made to the PI point database are reflected in the interface. This includes the adding, editing and deleting of tags.
All error information and some summary information are output to a log file. The amount of summary information that is output is configurable by the user and is minimal by default. For information about configuring information messages, see the “/db”, “/lg” and “/cl” headings of the Interface Startup File section on page 15.
A summary of the features of the interface is shown in the following table:
-
Sign-up for updates
|
Yes
|
Exception reporting
|
Yes
|
PINet
|
Yes
|
Outputs
|
Yes
|
Vendor software required
|
Yes, for MicroXL TCP/IP
|
Failover
|
No
|
Maximum number of points
|
Depends on gateway
|
Share with your friends: |