PI-AutoPointSync Connector for the Honeywell PHD Interface ...



PI-AutoPointSync Connector for the Honeywell PHD Interface User Manual

Version 1.0.0.9 and greater

10-Sep-02

How to Contact Us

|Phone |(510) 297-5800 (main number) |

| |(510) 297-5828 (technical support) |

|Fax |(510) 357-8136 |

|Internet |techsupport@ |

|World Wide Web | |

|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 |OSIsoft, Inc. | |

| |P.O. Box 727 | |

| |San Leandro, CA 94577-0427 | |

| |USA | |

| | | |

| |OSI Software GmbH |OSI Software, Ltd |

| |Hauptstra(e 30 |P. O. Box 8256 |

| |D-63674 Altenstadt 1 |Level One, 6-8 Nugent Street |

| |Deutschland |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 OSIsoft, 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.

HWPHD_APS.DOC

( 1997 OSIsoft, Inc. All rights reserved

777 Davis Street, Suite 250, San Leandro, CA 94577

Table of Contents

Introduction 2

Principle of Operation 3

Configuration Control 4

Features and Assumptions 5

Tag Attributes 5

Available Points 5

Point Types 5

Naming Convention 6

Installation Instructions 7

Installation Checklist 7

Un-installation Procedure 11

HWPHD_APS Connector Updates 12

Troubleshooting 13

Error 1904 – during HWPHD_APSSetup 13

Glossary 14

Introduction

PI-AutoPointSync (PI-APS) provides PI users with a utility that synchronizes the existing PI points for an interface with the tag definitions on the DCS, and that locates points on the DCS that do not yet exist in PI, and can be created. As DCS tag definitions change, PI points can be modified to reflect these changes automatically.

APS is versatile enough to allow the user to configure which attributes, on a per tag basis, will be synchronized with DCS. The user may also configure how PI-APS handles tags that have been created and deleted on the DCS.

PI-APS logs all actions and changes for the system administrator in order to allow for proper auditing of automated point changes. The audit logs, coupled with the versatility of tag-by-tag configuration, afford users a powerful tool for the PI system maintenance.

The APS Connector for the Honeywell PHD Interface (HWPHD_APS) is a specific module that communicates with the PHD Servers from which Honeywell PHD Interface data is displayed, gets tag attribute updates, and locates new points. The APS Connector and its attendant routines are called up with each synchronization scan.

The APS Connector for the Honeywell PHD Interface runs on Windows NT or Windows 2000 with the PI-APS Sync Engine and PI-APS Configuration & Management Utility. The PI server version that PI-APS talks to must be 3.3.361.43 or greater. This version of PI ensures compatibility with the PI-SDK version 1.1.

Principle of Operation

The PI AutoPointSync Connector for the Honeywell PHD Interface is implemented as an in-process COM object in a DLL called HWPHD_APS.dll. The COM object is registered during installation of the APS Connector.

The APS Connector will never appear in the Windows NT Task Manager process list as an independent process. It is loaded by a PI-APS process called the PI-APS Synchronization Engine, that appears in the process list as piapsengine.exe. The Synchornization Engine loads the PHD APS Connector automatically at the schedule synchronization time.

The PI Honeywell PHD APS Connector synchronizes existing PI-UDS points to the PHD database, as well as creating new PI-UDS points for new PHD points, and identifying PI-UDS points whose corresponding PHD points have been deleted.

For details on how to configure PI-APS to create, edit, and delete PI-UDS points as desired, please refer to the PI-AutoPointSync Configuration & Management Utility manual.

Configuration Control

The APS Connector for the Honeywell PHD Interface has an extra configuration control that is used to configure whether Available Points are defined to perform history recovery. The control looks like this:

[pic]

The default behavior is to define Available Points with history recovery disabled. To override this setting, check the “Perform history recovery” check box.

Features and Assumptions

Tag Attributes

The following fields are used within PI-UDS:

|Description |PHD Attribute Name |PI-UDS Attribute Name |Syncable |Key Field |

|PI-UDS Tag Name |N/A |Tag |No |Yes |

|PI-UDS input/ output flag |N/A |Location2 |No |Yes |

|PHD Tagname |PHD Tagname |InstrumentTag |Yes |Yes |

|PHD Tag Number |PHD Tag Number |UserInt1 |Yes |No |

|PHD scaling min extreme value |lo extreme |Zero |Yes |No |

|PHD scaling max extreme value |hi extreme |Span |Yes |No |

|(hi - lo) | | | | |

|PHD Tag descriptor |description |Descriptor |Yes |No |

|PHD Enineering units |eng. units |Engunits |Yes |No |

|PHD interp_method |interp_method |Step |Yes |No |

|UDS Scan Class |N/A |Location4 |Yes |No |

|PI-UDS PointType |datatype |Pointtype |No |No |

|PI-UDS Point Class |N/A |PtClassName |No |No |

|Digital Set |N/A |DigitalSet |No |No |

|Digital State Set |Possible States |N/A |No |No |

Available Points

Available points are points that PI-AutoPointSync has detected in the PHD server that do not exist in PI-UDS.

Point Types

In order to create a PI-UDS tag from a PHD tag, there has to be a data type mapping. The defaults are as follows:

|PHD Point Type |PI-UDS Point Type |

|C |String |

|F |Float |

|I |Int32 |

|B |Blob |

Naming Convention

Available Points are named according to their corresponding PHD Tagname.

Installation Instructions

The PI Honeywell PHD APS Connector requires that PI-APS be installed on the machine on which the PI Honeywell PHD APS Connector is to be run.

The PI Honeywell PHD APS Connector Installation package is called HWPHD_APSSetup.msi. This installation package will install just the HWPHD_APS Connector, not the Honeywell PHD Interface or PI-APS. To install the PI Honeywell PHD APS Connector, run HWPHD_APS_Setup.msi on the node where PI-APS is installed, and the PHD CAPI is installed.

Installation Checklist

1. Install PI-AutoPointSync (PI-APS). (The PI-APS setup installs PI-SDK).

2. Make sure that the Honeywell PHD CAPI is installed on the same machine as PI-APS. The PI-PHD interface does not need to be running on the same node with the APS Connector, as long as the PHD CAPI is present on the APS Connector node.

3. Run PI-ICU (installed by PI-APS Setup) and configure the PI PHD interface whose tags are to be synchronized.

4. Install the PI Honeywell PHD APS Connector with HWPHD_ APSSetup.msi.

5. Run the PI-AutoPointSync Configuration Utility and select “Register New” from the “Interface” menu.

[pic]

Follow the instructions for configuring the PI PHD interface for PI-APS. The PI-APS Sync Engine will be started automatically when the PI-AutoPointSync Configuration Utility is run. For details on using the Add an Interface dialog, see the section that is titled “Add an Interface - Configure an Interface for AutoPointSync” in the PI-APSUserManual.doc.

6. Configure the APS Connector for the newly added interface with the options under the Settings menu on the PI-AutoPointSync Configuration Utility main window. Review all of the following settings under the Settings menu, as it is likely that the default settings need to be changed for individual interfaces and sites:

• Rules

[pic]

• Sync Schedule

[pic]

• User-set Defaults

[pic]

Be sure to check the settings on both tabs. For details on using the Configuration & Settings dialog, see the section that is titled “PI-APS Configuration Utility” in the PI-APSUserManual.doc.

7. Enable the Sync Engine with the Tools menu option titled “Enable Sync Engine” via the PI-AutoPointSync Configuration Utility. The PI-APS Sync Engine is installed disabled and requires the user to enable it. If this menu item has a check next to it, then the Sync Engine is already enabled, and does not need to be enabled.

[pic]

8. Enable the connector for the selected interface with the Tools menu option titled “Enable Connector” via the PI-AutoPointSync Configuration Utility. All PI-APS Connectors are installed disabled and require the user to enable them. If this menu item has a check next to it, then the Connector is already enabled, and does not need to be enabled.

Un-installation Procedure

To uninstall the HWPHD_APS Connector, run the “Add-Remove Programs” applet (this is found from the Start Menu, Settings>Control Panel> Add-Remove Programs). The following program needs to be removed:

• PI Honeywell PHD APS Connector (HWPHD_APS)

HWPHD_APS Connector Updates

For information on the current version of the PI-APS Connector for the Honeywell PHD Interface, please see the following web site:



Troubleshooting

The following is a list of known error messages, their explanations and steps for resolving the circumstances that caused those messages to be displayed.

Error 1904 – during HWPHD_APSSetup

This error indicates that the Honeywell PHD CAPI software has not yet been installed on the machine where the PI-APS Connector for the Honeywell PHD Interface is being installed.

Glossary

Available Points

Available points are points that PI-AutoPointSync has detected on the DCS, but that do not exist in PI-UDS. Available Points are displayed grayed out.

Hidden Points

Hidden points are points that PI-AutoPointSync has detected on the DCS, but that do not exist in PI-UDS, that the user has marked to be hidden from view.

Existing Points or Existing PI Points

Existing Points or Existing PI-UDS Points refers to points that already exist in PI-UDS and belong to the current interface.

APS Connector (APS Interface Connector)

The APS Connector or APS Interface Connector is responsible for attribute data collection from the DCS.

Revision History

|Date |Author |Comments |

|05-Oct-01 |HAB |Written |

|14-Nov-01 |HAB |Updated for Beta 1 (1.0.0.7) |

|10-Sep-02 |HAB |Updated for initial release. Added screen shots to installation instructions section |

| | |(1.0.0.9) |

| | | |

| | | |

| | | |

| | | |

| | | |

| | | |

| | | |

| | | |

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download