《OPCST使用手册.doc》由会员分享，可在线阅读，更多相关《OPCST使用手册.doc（28页珍藏版）》请在金锄头文库上搜索。
1、OPCST使用手册OPCST（OPCDA Server Tool）是用来简化OPCDA服务器开发的工具包，它是对OPC DA 诸多接口及应用的封装，由Visual C+开发，全部源代码超过2 万行。应用OPCST工具，可以使开发者在30分钟内开发出一个基本的OPC DA服务器，既无需涉及烦琐的OPC协议，也不必掌握复杂的COM技术。该工具既适用工控技术人员的驱动开发，又适用于专业软件开发人员的管控系统集成。OPCST开发工具通过了iFix、WinCC以RockWell等组态软件的连接性测试，已在多个工程项目中成功应用，稳定可靠，性能优异。一 支持协议OPCST 工具包完全按照 OPC DA 2
2、.05协议标准开发，支持 1.0和2.0标准。二 数据结构及库函数说明全部的数据结构及库函数都集中在头文件opcst_ipt.h中，具体说明如下：1更新外部设备的回调函数类型，是初始化函数的参数类型之一，由开发者实现。类型：typedefbool (*LPWRITETAG)(unsigned devid,/*IN*/VARIANT*value/*IN*/);参数：dwvid 设备标记ID。OPCST要通过设备标记ID来区别不同的标记点（Tag点）。value 向通道devid 传送的值，类型为VARIANT。开发者根据参数value的不同数据类型，取出具体的基本数据值，更新实际的设备或内存变量
3、。返回值：执行成功返回true，执行失败返回false。用法举例：对于开发者，首先要实现函数 WriteVariant ，示例如下：/由开发者定义的复合数据类型，包括 BOOL、SHORT、LONG、FLOAT等，根据实际需要作调整。typedef union UVariantVARIANT_BOOLbVar;SHORTsVar;LONGlVar;FLOATfVar;UVariant;/定义设备标记点的结构类型typedef struct SDeviceRecordunsigneduDevID;/设备标记IDVARTYPEvtType; /设备标记数据类型UVariantvValue;/ 设备
4、数据值SDeviceRecord;#define BUF_SIZE 40/模拟设备缓冲区SDeviceRecord SimulatorBufBUF_SIZE; 初始化模拟设备缓冲区bool bRet_WR;bool WriteVariant( unsigned devid, VARIANT*value )/确认设备标记的正确性if (devid =BUF_SIZE | devid vt)/ vt 包含value的数据类型。case VT_BOOL:/取出value的BOOL值，更新变量SimulatorBufdevid.vValue.bVarSimulatorBufdevid.vValue.b
5、Var = V_BOOL(value);break;case VT_I2:/取出value的SHORT值，更新变量SimulatorBufdevid.vValue. sVarSimulatorBufdevid.vValue.sVar = V_I2(value);break;case VT_I4:/取出value的LONG值，更新变量SimulatorBufdevid.vValue. lVarSimulatorBufdevid.vValue.lVar = V_I4(value);break;case VT_R4:/取出value的FLOAT值，更新变量SimulatorBufdevid.vVal
6、ue. fVarSimulatorBufdevid.vValue.fVar = V_R4(value);break;default:/不支持的数据类型bRet_WR = -1;if(bRet_WR != 0)LOGWRITE(Write variant s ret != 0);return false;elsereturn true;2读取外部设备的回调函数类型，是初始化函数的参数类型之一。类型：typedefbool (*LPREADTAG)(unsigneddevid, /*IN*/VARIANT*value, /*OUT*/const VARTYPE vtype/*IN*/);参数：dw
7、vid 设备标记ID。OPCST要通过设备标记ID来区别不同的标记点（Tag点）。value 从通道devid 读取的值，类型为VARIANT。开发者根据参数vtype的不同及实际的设备值，向参数value赋值。vtype 指定要读取的数据类型返回值：执行成功返回true，执行失败返回false。用法举例：对于开发者，首先要实现函数 ReadVariant，示例如下：/由开发者定义的复合数据类型，包括 BOOL、SHORT、LONG、FLOAT等，根据实际需要作调整。typedef union UVariantVARIANT_BOOLbVar;SHORTsVar;LONGlVar;FLOATf
8、Var;UVariant;/定义设备标记点的结构类型typedef struct SDeviceRecordunsigneduDevID;/设备标记IDVARTYPEvtType; /设备标记数据类型UVariantvValue;/ 设备数据值SDeviceRecord;#define BUF_SIZE 40/模拟设备缓冲区SDeviceRecord SimulatorBufBUF_SIZE; 初始化模拟设备缓冲区bool ReadVariant( unsigneddevid, VARIANT*value, const VARTYPE vtype)/确认设备ID的合法性if (devid =B
9、UF_SIZE | devid =32)SimulatorBufdevid.vValue.fVar = (float)( rand() % 1000) * 0.997);/向value传送FLOAT值V_R4(value) = SimulatorBufdevid.vValue.fVar;break;default:bRet_RD = -1;if(bRet_RD != 0)LOGWRITE(Read variant s ret != 0);return false;elsereturn true;3数据结构服务器版本及说明根据实际开发的驱动信息，开发者设定OPCDA服务器的版本及说明typede
10、f struct SVendorInfoWORD wMajorVersion; WORD wMinorVersion; WORD wBuildNumber; WORD wReserved;char VendorInfo6464; SVendorInfo;wMajorVersion 主版本号wMinorVersion 次版本号wBuildNumber 发布版本号wReserved 保留VendorInfo6464 服务器说明4数据结构服务器组件注册信息用于向操作系统注册表注册OPC DA服务器组件的相关信息。typedefstruct SOPCRegisterInfocharClsidName1
11、28128;charProgID128128 ;GUIDclsid_OPCServerGUID ;SOPCRegisterInfo;ClsidName128 组件类名称ProgID128128 组件属性名，系统必须唯一。如OPCDA.XXXOPCServerGUID 全局唯一标识符。通常利用微软的guidgen.exe工具产生。选择第3种格式，点击Copy，通过剪贴板粘贴到代码编辑器中。在实际的开发过程中，一般采用静态声明变量法，同时给定初始化，例如SOPCRegisterInfo OPCRegInfo =OPC Server for XXX device , OPCDA.XXX , 0x4d
12、d30130, 0xc9a7, 0x11d4, 0xbe, 0xf5, 0x2d, 0x0, 0xda, 0x20, 0xdb,0x5c ;5数据结构OPCDA服务器参数OPCDA服务器有许多参数，设置服务器的工作方式typedef struct SOPCServerInfoUINTuUpdateRate;DWORDdwForceRefresh_Band;charcTagNameSeperator; SOPCServerInfo;uUpdateRate 开发者根据具体设备的数据变化速度，确定一刷新速度，单位为毫秒dwForceRefresh_Band 强制向客户程序发送数据的时间间隔，单位为毫秒。一般情况下，对于支持2.0标准的客户程序，服务器会主动向客户程序发送更新数据。但在不可预见的因素导致客户端数据过期时，服务器可以定时向客户发送最新的数据。cTagNameSeperator 标识标记名的
