OPC说明书中文版.docx
《OPC说明书中文版.docx》由会员分享，可在线阅读，更多相关《OPC说明书中文版.docx（37页珍藏版）》请在冰点文库上搜索。
OPC说明书中文版
<>
题目:
Opc数据存取接口定义标准
版本？
日期2002628
规范类型:
工业标准规范
题目:
OPC数据存取接口定义规范？
作者:
OPC基金会？
日期2002628
版本:
软件:
MS_Word
资源:
opcda205a_cust
状态:
发布
大纲
这个规范是为OPC客户端和服务器端开发者作的接口规范.这个规范是在为能产生一个能够让不同的卖主的客户和服务器能一起无缝交互的分析和设计过程中诞生的.[/color]
商标:
[/color]
多数计算机和软件都有商标或者已经注册商标,在这里不单独列出商标.
]需要运行环境
这个标准需要Windows95WindowsNT或者更晚版本.
公开的授权协议书
opc基金会，一个非赢利的公司（“opc基金会“），已经建立了一系列为增强过程控制工业里的自动控制应用程序，现场系统/设备和商业/办公应用程序协作能力已经建立了一系列标准的ole/com接口协议
当前的opc规范，原理性样例和相关的文档（统称”opc资料“），形成了一系列建立在微软的ole/com技术的功能需要的基础上的的标准的ole/com接口协议。
这些技术为服务器适时信息定义了一些标准的对象，方法和属性，象分散过程控制系统，可编程逻辑控制器，精巧的现场设备和为传输信息的分析系统这些服务器适合所有符合标准的ole/com技术的设备（例如,服务器，应用程序等）。
opc基金会同意你（用户）无论是个人还是法人单位，具有授权和为用户提供一个当前的opc资料的一个拷贝，只要用户接受包含在这个非专有的授权协议书里的条款。
opc资料如果无用，所有资料的拷贝（所有形式的），用户的个人财产必须被销毁和归还opc基金会。
使用opc资料的用户（包括任何雇员和用户代理）必须接受这个协议书了的约束。
授权的承认：
这份协议的期限和条件，OPC基金会承认不独占，免费出售的用户，禁止使用，拷贝，展示，分发OPC资料为制造，使用，销售或分发其他的任何产品和或者符合OPC资料的标准产品文献。
所有的用户制作的或分发的OPC资料的拷贝必须把opc资料里包含的版权和其他
的所有权声明包含进来。
OPC基金会保留所有在OPC资料里的权利，标题和利益，标注的协议里禁止的用户的授权。
不承担的责任和义务
用户接受OPC基金会提供的OPC资料是出于为了帮助用户理解微软的OLE/COM技术的信息。
OPC资料是作为没有任何类型的明确的和含糊的包含的授权，但是没有任何的限制，性能的保证，销售商，适合特殊的目的和无伤害的。
用户承担所有的与性能，设计，使用和OPC资料性能有关的风险。
OPC基金会及其会员不能承担OPC资料在他们的设计或他们的使用会遇到用户不断的需求，操作和大量的错误的责任。
这份协议或任何OPC资料的使用的结果使OPC基金会，及其会员们或第三方组织不承担任何通过用户或任何第三方的使用导致事件的资费，开支，损失，损害，或人身伤害
一般规定：
这个OPC材料约定和用户授权应当被终止（a）在用户停止所有OPC材料的使用。
（b）在用户获得了更高版本的材料来替代它，或者（c）OPC基金会有选择终止，当用户不正当的，超出协议使用这是资料。
依据以上的终止协议，用户应该立即停止使用所用的OPC材料，销毁所有的相关资料的拷贝然后是自己制作的相关资料和其他发生的相关行为，作为OPC基金会要求确保没有任何在此协议之下的资料授权的拷贝在个人的财产上。
用户不应该出口，和二次出口opc材料，在美国的出口控制法和出口规则没有授权接收它们的任何个人或目的地的任何的产品不得直接的使用相关资料这些软件和文档是有限制的提供的。
使用，复制或者纰漏都美国政府依据以下的限制（a）这个协议要依据DFARS227,7202-3规定（b）小段（c）
（1）（i）中的技术数据和计算机软件的权利要依据DFARS252227-7013的规定（c）商业计算机软件的限制权依据FAR子条（c）
（1）和
（2）的规定使用。
订约/制造：
OPC基金会，邮箱：
140524,德州奥斯丁，78714-0524
如果任何的这个协议中提供的被置空，残缺，没有强制的能力或不能在法庭上使用，其他相关的条款不受到影响。
这个协议受到明尼苏达州的法律的强制和解释执行，依据法律选择执行。
这个协议收录了当事人的期望和推迟执行任何的解释和协议（口头的和书面的）相关的opc资料的全部解释
新增功能
3．0版本摘要
这个版本包含了对A版的DataAccessCustomInterface办更，再晚些时候会决定是否会提供一个单独的文档（TheOPCDataAccessAutomationSpecification）用来描述适用于VBDelphi和其他一些有自动化功能的产品与OPC服务器的接口。
以下的功能是已经加入到这个版本的规范中了
加入的新接口
IOPCBrowse
IOPCItemDeadbandMgt
IOPCItemSamplingMgt
IOPCitemIO
IOPCSyncIO2
IOPCAsyncIO3
IOPCGroupStateMgt2
阐明了启动的问题和加入了WAITING_FOR_INITIAL_DATA质量状态掩饰
加入了EUTYPE#7＃8条目属性
阐明SetActimState用来表明一个条目从非激活到激活的变换中产生的质量结果，和控制回调函数。
加入了新服务器状态列举变量（OPC_STATUS_COMM_FAULT）
在头标签里加入了便于进入访问目录表的方法？
在这给规范中删除了以下接口
IOPCServerPublicGroups
IOPCBrowseServerAddressSpace
IOPCPublicGroupStateMgt
IOPCAsyncIO
IOPCItemProperties
另外加入拼写，语法，格式和最小的净化代码用来提高规范的质量。
加入了条目属性的章节。
阐明了RemoveGroup
在idl中加入了CATIDs
提供了读写质量和时间戳的功能
使回调函数连接更健康加入了保持活动生命期机制
2．05A版本摘要
这个版本在的注释（5）中阐述关于怎样把浮点数和双精度数转换成整数，也纠正了附录D中（200-207用1关闭）属性的定义
2．05版本摘要
这个版本包含了在小节中列举并阐述了关于在Native和请求数据类型之间的转换
2．04版本摘要
这个版本包含对某几个在相互协作的会话和服从测试中出现的不明确地方的另了的精简。
还有一些章节：
时间偏倚和死区在GroupObject中讨论，通用属性（）。
SetState的LocaleID（为了使他更清楚这个行为是可选择的）。
添加和阐明了GetItemProperties,LookupItemIDs,AddItems,ValidateItemsRemoveItems,SetActiveState,SetClientHandles,SetDataTypes,bothSyncIOandAsyncIOReadandWrite返回的错误E_INVALIDARG和S_FALSE
“部分成功“改为“一个或多个错误完成“，这就清晰的预示着输出的方法（特别是PPErrors的返回值）定义为这种情况，其他的对返回错误文本的调整又通过交叉函数组成。
阐述GetItemID行为。
在Refresh2和IOPCDateCallback:
:
OnDataChange传送参数的ID被阐述。
特别的0是被允许的值。
也可以见到对OPCAsyncIO的描述（），增加了小节对客户和服务器中关于LocaleID职责的讨论。
2．03版本摘要
这个版本包括了对死区的简要阐述（）也阐述了列举的清空行为。
对IOPCServer:
:
CreateGroupEnumerator和IOPCBrowseServerAddressSpace:
:
BrowseAccessPaths的描述已经被澄清和描述，他们现在由已经存在的IOPCBrowseServerAddressSpace:
:
BrowseOPCItemIDS的描述组成
2．02版本摘要
这个版本包括了对OPCItemProperties接口讨论（）GroupStateMgt:
:
SetState和1。
0版中对流聚合的讨论（）的简要阐述
2．01版本摘要
这个版本阐述了IOPCBrowseServerAddressSpace中的dwAccessRightsFilter和讨论了一般的数据入口（节）
2．0版本摘要
这个版本包含了对版本的增强。
通篇中也作了更改。
下面的方面或许特别重要：
这个被称为OPCDataAccessSpecificatong的东西是从其他的OPC起步努力中得来的
自动化
接口规范被分在另外一个独立的文档中
所有的前一版本的定义接口被保留并做了简单的阐述。
基于连接的异步和异常用IDataObject要比使用连接点更好一点。
IOPCAsyncIO,IDataObject和客户端的IAdviseSink接口支持老板本（1。
0）的连接。
新的接口IOPCAsyncIO2,IConnectionPiontContainer和客户端的IOPCDataCallback接口支持新诗的2。
0版的连接
定义了新的舒服的接口，IOPCItemProperties允许轻松访问一般的和开发者的特殊属性或条目及变量的属性
一个关闭请求功能特性的加入，通过服务器组件连接点和客户端IOPCShutdown接口允许服务器请求关闭所有客户端同服务器的连接。
这个接口将被其他的OPC服务器使用
服务器中加入了一个IOPCCommon接口，这个接口提供了一些公共的LocaleID相关的功能。
这个接口将被其他的OPC服务器使用
BrowseServerAddressSpace中加入了OPC_BROWSE_TO的能力
目录表
1介绍。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
1
1．1读者。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
1
1．2提供的内容。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
1
2OPC数据访问的基本原理。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
2
2．1OPC总览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
2
2．2哪些地方适合使用OPC。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
3
2．3通常的OPC的机构和组成。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
4
2．4OPC数据访问结构详述。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
5
2．5对象和接口总览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
6
2．6服务器的地址空间和配置。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
7
2．7服务器和网络节点应用水平的选择。
。
。
。
。
。
。
。
。
8
2．8同步和串行传输的问题。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
8
2．9持久存储的事例。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
9
3OPC数据访问的快速参考。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
10
3．1自定义接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
10
4OPC自定义接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
11
4．1浏览OPC自定义接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
11
4．2综合资料。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
12
4．2．2内存所有权。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
13
4．2．3标准的接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
14
4．2．4空字符串和空指针。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
14
4．2．5返回阵列。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
14
4．2．6高速缓存数据，设备数据和时间戳。
。
。
。
。
。
。
。
。
。
15
4．2．7时间系列的值。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
15
4．2．8异步和同步的对比。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
15
4．2．9激活标志，死区和更新率。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
15
4．2．10错误和返回代码。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
15
4．2．11启动问题。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
15
4．2．12VARIANT数据类型和互用性。
。
。
。
。
。
。
。
。
。
。
。
16
4．2．13定位和LocaleID。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
19
4．2．14条目属性。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
19
4．2．15IOPCSyncIO。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
25
4．2．16IOCASyncIO2。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
26
4．2．17通过IOPCDataCallback的定制。
。
。
。
。
。
。
。
。
。
27
4．3OPCServer对象。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
28
4．3．1概要。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
28
4．3．2IUnknown。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
29
4．3．3IOPCCommon。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
29
4．3．4IOPCServer。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
30
4．3．4．1IOPCServer:
:
AddGroup。
。
。
。
。
。
。
。
。
。
。
。
。
。
30
4．3．4．2IOPCServer:
:
GetErrorString。
。
。
。
。
。
。
。
。
。
。
。
。
33
4．3．4．3IOPCServer:
:
GetGroupByName。
。
。
。
。
。
。
。
。
。
34
4．3．4．4IOPCServer:
:
GetStatus。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
35
4．3．4．5IOPCServer:
:
RemoveGroup。
。
。
。
。
删除组。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
36
4．3．4．6IOPCServer:
:
CreateGroupEnumerator。
。
。
。
。
创建组列举。
。
。
。
。
。
。
。
38
4．3．5IConnectionPointContainer（OnOPCServer）。
。
。
。
。
。
连接电容器。
。
。
。
。
。
。
。
40
4．3．5．1IConnectionPointContainer:
:
EnumConnectionPoints。
连接点列举。
41
4．3．5．2IConnectionPointContainer:
:
FindConnectionPoint。
。
。
查询连接接点。
。
42
4．3．6IOPCBrowse。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
OPC浏览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
43
浏览..................................43？
获得属性.........................46？
条目.........................48？
读取...............................48？
OPCGROUPOBJECT.............组对象..............................53？
一般属性............................54？
名字.....................................54？
缓存数据..................................54？
激活................................54？
更新率..............................55？
时区（时间偏倚）............................55？
死区百分比.............................56？
客户端句柄..............................56？
读写数据......................56？
加入条目..........................58？
条目生效........................60？
刈除条目.....................62？
设置为活动状态.....................63？
设置客户端句柄....................64？
设定数据类型....................65？
创建枚举器.....................66？
获取状态.......................67？
设置状态......................69？
设置名称......................71？
关闭组......................72？
设置生命期..................74？
获得生命期...............76？
同步IO....................77？
读取...........................77？
写入........................80？
读取最大生命期...................82？
异步IO................87
读............................88？
写............91？
刷新................94？
取消..................96？
使活动..................97？
获得活动...................98？
读取最大生命期...................99？
刷新最大生命期................104？
设置条目死区...............106？
获得条目死区........108？
清除条目死区..............110？
连接点容器.....123？
列举连接点.........124？
查找连接点.......125？
列举条目属性.................126？
下一个....................126？
跳过.................127？
复位...........128？
克隆.................129？
CLIENTSIDEINTERFACES.........客户端接口........................130？
回调函数........................130？
数据变更通知.....................131？
全部读入.......................134？
全部写入......................136？
全部取消.................138？
关闭............................139？
关闭请求............................139？
5INSTALLATIONISSUES..............安装问题.......................140？
COMPONENTCATEGORIES........组建类........................140？
REGISTRYENTRIESFORCUSTOMINTERFACE.....自定义接口注册入口.................140？
REGISTRYENTRIESFORTHEPROXY/STUBDLL.......代理存根dll注册入口..........141？
6DESCRIPTIONOFDATATYPES,PARAMETERSANDSTRUCTURES...数据类型，参数，结构的描述..142？
ITEMDEFINITION........条目定义..........................142？
ACCESSPATH...............访问路径..............................143
BLOB...............污点.........................144？
TIMESTAMPS.......时间戳................................144？
VARIANTDATATYPESFOROPCDATAITEMS......OPC数据条目的Variant数据类型.......145？
CONSTANTS...........................................146？
组句柄........................146？
条目句柄.................................146？
STRUCTURESANDMASKS..............结构和蒙布........................147？
条目状态.......................147？
条目定义.....................148？
条目结果.........................150？
条目特性....................151？
服务器状态......................153？
存取权限...................154？
条目特权.....................156？
条目属性表....................157？
浏览的组成...............158？
OPCQUALITYFLAGS..............OPC性能标志...............160？
7SUMMARYOFOPCERRORCODES............OPC错误代码摘要........164？
8APPENDIXA-.............附录A头文件.....167？
9APPENDIXB-DATAACCESSIDLSPECIFICATION.......附录B数据访问IDL文件规范..173
1介绍
在一个单独的OPC概述文档（）对OPC作了全面的介绍，这个特殊的文档只是对OPC数据访问接口做详细的解说
1．1读者
这个规范是特地为做OPC客户端和服务器端开发者作的一个参考手册。
他认为读者已经对MSOLE/COM技术和工业过程控制需求非常熟悉。
这个规范是为熟悉并选择使用C和C++语言来开发OPC客户程序提供的资料。
所以开发者要对这些方面的技术和特别的组件要相当熟悉。
1。
2可获得的资料
从OPC基金会可获得的OPC借口访问相关的资料包括他OPC规范本身以外还有OPCIDL文件（在这本文档的附录里）和OPC错误头文件（在这个文档里）。
你可以方便地在OPC基金会的网站上可以找到标准的代理存根的DLLS和从OPC接口访问IDL文件产生的头文件，会员可以在OPC基金会的网站上下载OPC接口访问的例子的源代码。
这个OPC数据访问规范包括以下设计信息
1.OPC数据访问自定义接口—这个文档描述了OPC组件和对象的接口和方法。
2.OPC数据访问自动化接口—晚些时候将会提供一个可选择的单独文
升级会员 