The PI Bailey semAPI interface provides bi-directional data transfer between a PI system and a Bailey Infi90 instrument system. The interface runs on Windows-Intel computers.
This interface was developed to take advantage of Bailey’s semAPI library. The semAPI software handles all of the Bailey communications protocol and thereby makes it possible for the PI interface to communicate to Bailey ICI modules via a variety of transport methods (serial, Ethernet, and SCSI).
Note: Currently, interface version 1.3 and greater is compatible with semAPI version 2.0 and greater. Interface version 1.2 is compatible with semAPI version 1.2. For version compatibility and other semAPI issues, see the restriction section at the end of the manual.
The new features introduced in version 1.4.2.0 of the interface consist of Disconnected Startup, Multi-Character Point Source, UniInt Health Tags including SetDeviceStatus and are only supported by the version built for use with semAPI 2.0 and higher (blysem.exe).
Communication using the semAPI software requires that the customer purchase the Bailey semAPI software and computer interface module as well as the PI interface software.
The interface works with the following Bailey computer interface modules:
-
INICI03, INFI-NET to Computer Interface.
-
HNCC, Harmony Network Communications Coupler
The INICI03 supports serial and SCSI connection to the host computer. The module supports a maximum of 30,000 points. Each instance of the interface connects to one computer interface module.
Bailey has come out with an ICI12 communications module. This module only supports a serial connection to the host computer and per Bailey; communication is through use of the Bailey semAPI. The PI Bailey semAPI interface should be compatible with this module but we have not yet had a chance to test it.
Reference Manuals OSIsoft Vendor -
SemAPI Instruction Manual
-
Function Code Application Manual
Supported Features -
Feature
|
Support
|
Part Number
|
PI IN-BA-SEMAP-NTI
|
*Platforms
|
Windows 2000/XP/2003 Server
|
APS Connector
|
Yes
|
Point Builder Utility
|
No
|
ICU Control
|
Yes
|
PI Point Types
|
Float32 / Float16 / Digital / Int16 / Int32 / string
|
Sub-second Timestamps
|
No
|
Sub-second Scan Classes
|
No
|
Automatically Incorporates PI Point Attribute Changes
|
Yes
|
* Exception Reporting
|
Done by Bailey System
|
Outputs from PI
|
Yes
|
Inputs to PI: Scan-based / Unsolicited / Event Tags
|
Unsolicited
|
Supports Questionable Bit
|
No
|
Supports Multi-character PointSource
|
Yes
|
Maximum Point Count
|
30,000
|
* Uses PI SDK
|
No
|
PINet String Support
|
Yes
|
* Source of Timestamps
|
PI server
|
History Recovery
|
No
|
* UniInt-based
* Disconnected Startup
* SetDeviceStatus
|
Yes
Yes
Yes
|
* Failover
|
Yes
|
Vendor Software Required on PI Interface Node
|
Yes
|
* Vendor Software Required on Foreign Device
|
Yes
|
* Vendor Hardware Required
|
Yes
|
Additional PI Software Included with Interface
|
No
|
* Serial-Based Interface
|
Yes
|
See paragraphs below for further explanation.
Platforms
The Interface is designed to run on the above mentioned Microsoft Windows operating systems. Because it is dependent on vendor software, newer platforms may not yet be supported.
Please contact OSIsoft Technical Support for more information.
Exception Reporting
The Bailey System sends data to the PI interface by exception. Hence, by default, the interface does not apply the PI tag’s exception reporting on top of the Bailey events.
Uses PI SDK
The PI SDK and the PI API are bundled together and must be installed on each PI Interface node. This Interface does not specifically make PI SDK calls.
Source of Timestamps
The interface keeps tracks of the current time of the PI server. It applies that time to the timestamp of the exception-based event sent from Bailey.
Failover
The interface supports failover to provide redundant data collection on both VMS platform and on Windows platform. The failover setup involves two instances of the interface, one in primary data collection mode and one in secondary or standby data collection mode. Each interface communicates to a separate ICI module. The secondary interface would monitor the ICI module status of the primary interface. If the primary ICI module is not in execute mode, the secondary interface will start collecting data. When the primary ICI module comes back on-line, the secondary interface would go back to standby mode.
Since the failover mechanism depends on the ICI module, do not set the ICI watch dog timer to 0 for the primary interface. Otherwise, the ICI module will continue to be in execute mode even if the primary interface stops communicating to the ICI module.
When installing the interface in failover setup, test the failover configuration by stopping the primary interface program and verifying that the secondary interface picks up data collection. If the secondary interface cannot read the module status of the primary ICI module within five minutes of the interface startup, the interface program will terminate, assuming the PCU address provided by the command file is incorrect. This safety check is designed to avoid having both instances of the interface collecting data at the same time.
UniInt-based
UniInt stands for Universal Interface. UniInt is not a separate product or file; it is an OSIsoft-developed template used by developers, and is integrated into many interfaces, including this interface. The purpose of UniInt is to keep a consistent feature set and behavior across as many of OSIsoft’s interfaces as possible. It also allows for the very rapid development of new interfaces. In any UniInt-based interface, the interface uses some of the UniInt supplied configuration parameters and some interface-specific parameters. UniInt is constantly being upgraded with new options and features.
The UniInt Interface User Manual is a supplement to this manual.
Disconnected Start-Up
The PI Bailey semAPI interface is built with a version of UniInt that supports disconnected start-up. Disconnected start-up is the ability to start the interface without a connection to the PI server. This functionality is enabled by adding /cachemode to the list of start-up parameters or by enabling disconnected startup using the ICU. Refer to the UniInt Interface User Manual for more details on UniInt Disconnect startup.
SetDeviceStatus
New functionality added to support Health tags. The Health tag with the point attribute Exdesc = [UI_DEVSTAT], is used to represent the status of the source device. The following events can be written into the tag:
-
“1 | Starting” – the interface is starting.
-
“Good” – the interface is properly communicating and reading data from the Bailey semAPI system.
-
“2 | Connected/No data | ICI Offline” – this event represents that the Bailey semAPI system is offline.
-
“3 | 1 device(s) in error | Not connected to semAPI” – This event represents a failure to communicate with the Bailey semAPI system.
-
“4 | Intf Shutdown” – the interface is stopped.
Please refer to the UniInt Interface User Manual.doc for more information on how to configure UniInt health points.
The interface needs the Bailey semAPI Runtime, Supervisory Control, or Development Kit to be installed on the interface node.
Vendor Hardware Required
The interface connects to ICI03 via SCSI or serial connection.
Serial Based Interface
The semAPI software handles all of the Bailey communications protocol and thereby makes it possible for the PI interface to communicate to Bailey ICI modules via a variety of transport methods (serial, Ethernet, and SCSI).
Server class machines often have inferior serial ports. Server class machines are not required for most interfaces and should not be used, especially not when serial port connections are required.
Share with your friends: |