博客

说起基于PI的软件开发主要包括两方面,

1:利用PIAPI直接操作PI,此种方式的好处在于高效率,容易掌控任何操作,缺点在于需要购买PIAPI,下面会详细介绍此类方法;

2:通过国际工业组织约定的OPC通讯协议访问PI,此种方式的好处在于通用,因为只要是实时数据库都会支持OPC协议,有关OPC方面的请参考我的 “[原创]为中华崛起而学习系列[原创]” 下面有关OPC的资料.

下面说说基于PISDK,利用PIAPI对PI的操作:

1.首先需要检测PI的连接:

C       : int32 piut_setservernode (char PIPTR * servername );

c#     : int piut_setservernode (string servername );

servername[passed] : 服务器IP或服务器名,

如果连接成功返回0,这里需要注意的是,如果开发防火墙的话,有可能会出现连接失败的情况.

2.登陆PI

C    :   int32 piut_login (char PIPTR * username, char PIPTR * passwrd, int32 PIPTR * valid);

c#     : int piut_login (string username, string passwrd, ref int valid);

username[passed] : 用户名,如piadmin;

passwrd[passed] : 登陆密码;

valid[returned] : 服务器返回访问级别 ,如下:

#define PINO 0 (PI错误);

#define PIREAD 1 (只读);

#define PIREADWRITE 2 (读写);

如果登陆成功返回0;

3.查找需要的点

C    : int32 pipt_findpoint (char PIPTR * tagname, int32 PIPTR * pt);

c#     :   int pipt_findpoint (string tagname, ref int pt);

tagname[passed] : 点在PI中的名称;

pt[returned] : 返回点在PI中的索引;

如果成功找到该点返回0;

4.断开连接

C    : int32 piut_disconnect (void);

C#     : int32 piut_disconnect (void);

成功断开连接返回0;

到此,通过以上步骤1,2建立与PI的连接,步骤3查找需要的点,步骤4断开连接,一个最基础的PI操作就完成,下面在介绍一些实用的PIAPI函数, 以下以C++为主,C#与其类似.

◆

PIVOID pitm_intsec (int32 PIPTR * timedate, int32 timearray[6]);

timedate[returned] : PI使用的时间

timearray[passed] : 保存时间的数组,如下:

timearray [0] month; // (1-12)

timearray [1] day; // (1-31)

timearray [2] year; // (four digit)

timearray [3] hour; // (0-23)

timearray [4] minute; // (0-59)

timearray [5] second; // (0-59)

此函数将一个给定的时间数组转化为PI时间

◆

PIVOID pitm_secint (int32 PIPTR * timedate, int32 timearray[6]);

timedate[passed] : PI使用的时间

timearray[returned] : 保存时间的数组,如下:

此函数将一个给定的PI时间转化为时间数组,其格式可参考上条;

◆

int32 piar_summary (int32 pt,int32 PIPTR *time1,int32 PIPTR *time2, float PIPTR *rval,

float PIPTR *pctgood, int32 code);

pt[passed] : 点索引

time1[passed,returned] : 开始时间,返回对应时间,如果code属性为ARCMINIMUM,ARCMAXIMUM,ARCSTDEV

time2[passed,returned] : 开始时间,返回对应时间,如果code属性为ARCMINIMUM,ARCMAXIMUM,ARCSTDEV

rval[returned] : 返回计算值

pctgood[returned] : 返回计算结果的品质

code[passed] : 计算方式,如下:

#define ARCTOTAL 0

#define ARCMINIMUM 1

#define ARCMAXIMUM 2

#define ARCSTDEV 3

#define ARCRANGE 4

#define ARCAVERAGE 5

#define ARCMEAN 6

计算成功返回0,

值得注意的有两点: 1.此函数进行计算时,默认的转换因子为1,也就是天,如果需要自己的时间,主要根据转换因子1将计算结果进行转化; 2. pctgood,此参数返回计算品质,如果在进行统计运算时需要乘上此品质,才是真实结果;

◆

int32 piar_compvalues (int32 pt, int32 PIPTR * count, int32 times[], float rvals [], int32 istats[], int32 rev);

pt[passed] : 点索引

count[passed,returned] : 指定返回数据最大个数,返回实际取得最大个数

times[passed,returned] : 指定查询时间段,times[0]表示开始时间,返回各数据实际时间

rvals [returned] : 返回各数据值

istats[returned] : 返回各时间点上数据状态

rev [passed] : 指定查询方向,false(0)表示根据指定时间向前搜索,true表示向后搜索;

查找成功返回0;

值得注意的是,一次查询返回的最后时间还并没有到指定的时间,此时返回的count为指定数组最大数量,表明此查询没有完成,需要将开始时间点设置为返回的最后时间,继续查询,直到count返回值小于指定的最大值为止.

◆

int32 pisn_getsnapshots (int32 PIPTR * pt, float PIPTR * rval, int32 PIPTR * istat, int32 PIPTR * timedate,

int32 PIPTR * error, int32 count );

pt[passed] : 指向点索引数组

rval[returned] : 返回点索引数组对应各点的数据

istat[returned] : 返回点索引数组对应各点数据状态

timedate[returned] : 返回各数据值对应的时间

error[returned] : 返回错误代码

count [passed] : 指定数组大小

成功查询返回0,

需要说明的是此函数返回的值仅是在快照中存在的最新的数据.