Pi bailey Sem api interface Manual

Description Data Type

Download 2.52 Mb.

Page	19/43
Date	01.09.2022
Size	2.52 Mb.
	#59441

1 ... 15 16 17 18 19 20 21 22 ... 43

PI BaSemAPI Manual
PI BASemAPI, UniInt Interface User Manual

Description	Data Type		Bailey Function Code		OIS Type Name
Extended Attribute
1		Process Variable		A		Note 1	Station	No
2		Set Point Read		A		Note 1	Station	No
3		Control Output Read		A		Note 1	Station	No
4		Ratio Index Read		A		80, 23	Station	No
5		Analog Read		A		30	Analog	Yes
6		Station Status		D		Note 1	Station	Yes
7		Digital Read		D		45	Digital	No
14		Module Status		D				No
15		RCM Read		D		62, Note 3	RCM	Yes
19		RMSC Read		A		68	RMSC	Yes
21		4-byte Analog Read		A				Yes
29		DAANG		A				Yes
30		ASCII string		S				No
51		MSDD		D		129		Yes
52		DD		D		123		Yes
53		RMC		D				Yes
54		DADIG		D				Yes
60		Text Selector		I				No
70		Harmony Analog Input		A		Note 2		Yes
71		Harmony Analog Output		A		Note 2		Yes
72		Harmony Digital Input		D		Note 2		Yes
73		Harmony Digital Output		D		Note 2		Yes

Note 1: For Station points, the Bailey function code can be 80, 21, 22 or 23. Use the same Bailey address for the PV, SP and CO of the station point.
Note 2: The Harmony point types (70-73) are supported only for interface version 1.3 and greater running on Windows.
Note 3: The Bailey point type specifications for this interface are almost the same as those in the PI BA-I90, the serial communication based interface. For those customers who will convert from the serial based Infi90 interface to the semAPI, NO changes to the location parameters are required except for Bailey point type 15. The serial based interface uses a point type of 15 to get data from RCM, MSDD, and DD point types. The semAPI interface uses 15 for RCM, 51 for MSDD, and 52 for DD point types.

Output Point Types (PI Data to Bailey)

Bailey Point Type	Description	Data Type	Extended Attributes
12	Analog Report	Analog	No
13	Digital Report	Digital	No
22	4-byte Analog Report	Analog	No

After the output tags are defined in PI, the data can be read from the ICI into any Bailey Node as a Analog point or a Digital Point. Use function code 26 to read point type 12 (Analog Report). Use function code 42 to read point type 13 (Digital Report). The address used in the function code 26 or 42 can be calculated from the Location2 parameter of the PI tag as described in the Location2 point attribute section.

Detailed Description of Bailey Point Types

Process Variable (Bailey Point Type 1)

This is the process variable of a control Station block (Bailey function code 80, 21, 22 or 23). The block address should be that of the Station block. The alarm attributes for the station can be accessed through the extended attributes of the station status. See point type 6.

Setpoint Read (Bailey Point Type 2)

This is the set point of a control Station block. See point type 1.

Control Output Read (Bailey Point Type 3)

This is the control output of a control Station block. See point type 1.

Ratio Index Read (Bailey Point Type 4)

This is the ratio index of a ratio control Station block. See point type 1.

Analog Read (Bailey Point Type 5)

This gets the value from an analog block (function code 30) on the Infi90 system.
The status of the analog value can be accessed through the following extended attributes:

Code	Field length	Description
1	1	Quality (q)
2	2	Limit Alarm (la)
3	2	Deviation Alarm (da)
4	1	Red Tagged Status (rt)
5	1	Point Tracking (pt)
6	1	Calibration (ccv)

Station Status (Bailey Point Type 6)

By default, the interface extracts only the fields indicating the Station mode and combines them into an eight-state status, even though the Station status contains other information.
A PI tag for the Station Status is normally defined as a digital point in the PI system.

Manual (unlocked)
Auto (unlocked)
Cascade (unlocked)
Digital Station Failure
Manual (locked)
Control Station Bypassed
Auto (locked)
Cascade (locked)

Station status is processed one field at a time according to the following order. If any field is set, the evaluation is stopped at that field and the digital state is set.

Processing Order for Station Status

IF (QUALITY field is set) THEN
Tag Digital State is BAD INPUT
ELSE IF (BYPASS field is set) THEN
Tag Digital State is Control Station Bypassed
ELSE IF (DIGITAL STATION FAILURE field is set) THEN
Tag Digital State is Digital Station Failure
ELSE IF (CASCADE RATIO field is set) THEN
IF (MANUAL INTERLOCK field is set) THEN
Tag Digital State is Cascade (locked)
ELSE
Tag Digital State is Cascade (unlocked)
ELSE IF (AUTO MODE field is set) THEN
IF (MANUAL INTERLOCK field is set) THEN
Tag Digital State is Auto (locked)
ELSE
Tag Digital State is Auto (unlocked)
ELSE IF (MANUAL INTERLOCK field is set) THEN
Tag Digital State is Manual (locked)
ELSE
Tag Digital State is Manual (unlocked)
Also, the following attributes of the Station Status may be accessed through the use of the extended attributes:

Code		Field length		Description
1		1		Quality (q)
2		2		Limit Alarm (la)
3		2		Deviation Alarm (da)
4		1		Red Tagged Status (rt)
5		1		Point Tracking (spt)
6	1		Station Bypass (byp)
7	1		Manual Interlock (mi)
8	1		Output Tracking (ot)
9	1		Digital Station Failure (dsf)
10	1		Computer OK (cok)
11	1		Computer Control Level (lev)
12	1		Cascade/Ratio Mode (crn)
13	1		Auto Mode (am)

Digital Read (Bailey Point Type 7)

These points should be defined as point type digital in the PI system. If the Quality of the exception report is good, the interface extracts the value field of the report into PI. Otherwise, Bad Input is reported.

Analog Report (Bailey Point Type 12)

This is one of the point types for writing from the PI system to Infi90. Infi90 real points are in the range -9.2E18 to 9.2E18. The output is set to BAD QUALITY and the value 0 is sent to Infi90 when the PI value is a digital state code (such as Shutdown or Over Range) and the SourceTag PI point type is a float or an integer.
If the SourceTag is defined as a digital point type, the interface will convert the absolute digital state to an offset of the digital start code of the point and send the offset as an analog value to the Infi90.

Digital Report (Bailey Point Type 13)

This is another point type for sending data from the PI system to Infi90. A source tag for the digital output can be either a real, integer, or digital point in the PI database. BAD QUALITY status is sent to Infi90 when the PI value is a digital state for real or integer source points. For a digital source point, a digital state out of the point’s range is considered BAD QUALITY.
For conversion of PI values to Infi90 values, a status of 1 is sent if the source PI value is not equal to 0. Otherwise 0 is sent. For PI source tag with point type D, the PI value is converted to a digital offset before sending to the Infi90.

Module Status (Bailey Point Type 14)

On the PI 3 server, use a digital set with 4 states to represent the module status. The four states of the Module status are:

Configure
Failed
Error
Execute

The block number (Location4) should be 0 for this point type.

RCM Read (Bailey Point Type 15)

An RCM (function code 62) has many attributes that could be of interest to the user. By default, the interface extracts only the output field into the PI value for PI tags with Location5 set to 15. To get the other attributes, use the extended descriptor keyword /BLY=x,y,etc. followed by the attributes code as described below:

Code	Field length	Description
1	1	Quality (q)
2	1	Alarm (alm)
3	1	Block tagged (tag)
4	1	Output value (ov)
5	1	Logic set input received (si)
6	1	Set permissive input received (sp)
7	1	Logic reset input received (ri)
8	1	Override (or)
9	1	Feedback (fb)
10	1	Set command received (sc)
11	1	Reset command received (rc)

Download 2.52 Mb.

Share with your friends: