OPC说明书中文版.docx
《OPC说明书中文版.docx》由会员分享，可在线阅读，更多相关《OPC说明书中文版.docx（31页珍藏版）》请在冰点文库上搜索。
OPC说明书中文版
<>
题目 :
Opc 数据存取接口定义标准
版本 2.05A
日期 2002 6 28
规范类型:
工业标准规范
题目:
OPC 数据存取接口定义规范
作者:
OPC基金会
日期 2002 6 28
版本:
2.05A
软件:
MS_Word
资源:
opcda205a_cust
状态:
发布
大纲
这个规范是为OPC客户端和服务器端开发者作的接口规范.这个规范是在为能产生一个能够让不同的卖主的客户和服务器能一起无缝交互的分析和设计过程中诞生的.[/color]
商标:
[/color]
多数计算机和软件都有商标或者已经注册商标,在这里不单独列出商标.
]需要运行环境
这个标准需要 Windows 95 Windows NT 4.0 或者更晚版本.
公开的授权协议书
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）这个协议要依据DFARS 227,7202-3规定 （b） 小段（c）
（1）（i）中的技术数据和计算机软件的权利要依据 DFARS252 227-7013的规定 （c） 商业计算机软件的限制权依据FAR 52.227-19子条（c）
（1）和
（2） 的规定使用。
订约/制造：
OPC 基金会， ：
140524, 奥斯丁， 78714-0524
如果任何的这个协议中提供的被置空，残缺，没有强制的能力或不能在法庭上使用，其他相关的条款不受到影响。
这个协议受到明尼苏达州的法律的强制和解释执行，依据法律选择执行。
这个协议收录了当事人的期望和推迟执行任何的解释和协议（口头的和书面的）相关的 opc 资料的全部解释
新增功能
3．0版本摘要
这个版本包含了对 2.05 A版的 Data Access Custom Interface 办更，再晚些时候会决定是否会提供一个单独的文档（The OPC Data Access Automation Specification 3.0 ）用来描述适用于VB Delphi和其他一些有自动化功能的产品与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．05 A 版本摘要
这个版本在4.2.13的注释（5）中阐述关于怎样把浮点数和双精度数转换成整数，也纠正了附录D中 （200-207 用1 关闭）属性的定义
2．05 版本摘要
这个版本包含了在4.2.13小节中列举并阐述了关于在Native和请求数据类型之间的转换
2．04版本摘要
这个版本包含对某几个在相互协作的会话和服从测试中出现的不明确地方的另了的精简。
还有一些章节：
时间偏倚和死区在Group Object中讨论，通用属性（4.5.1）。
SetState 的LocaleID（为了使他更清楚这个行为是可选择的）。
添加和阐明了GetItemProperties,LookupItemIDs,AddItems,ValidateItemsRemoveItems,SetActiveState, SetClientHandles, SetDataTypes, both SyncIO and AsyncIO Read and Write 返回的错误 E_INVALIDARG和S_FALSE
“部分成功“改为“一个或多个错误完成“，这就清晰的预示着输出的方法（特别是PPErrors的返回值）定义为这种情况，其他的对返回错误文本的调整又通过交叉函数组成。
阐述GetItemID行为。
在Refresh2和IOPCDateCallback:
:
OnDataChange 传送参数的ID被阐述。
特别的0 是被允许的值。
也可以见到对OPCAsyncIO的描述（4.5.6），增加了4.2.14小节对客户和服务器中关于LocaleID职责的讨论。
2．03版本摘要
这个版本包括了对死区的简要阐述（4.5.1.6）也阐述了列举的清空行为。
对IOPCServer:
:
CreateGroupEnumerator和IOPCBrowseServerAddressSpace:
:
BrowseAccessPaths的描述已经被澄清和描述，他们现在由已经存在的IOPCBrowseServerAddressSpace:
:
BrowseOPCItemIDS的描述组成
2．02版本摘要
这个版本包括了对OPCItemProperties 接口讨论（4.4.6）GroupStateMgt:
:
SetState（4.5.3.2）和1。
0版中对流聚合的讨论（4.6.4.6）的简要阐述
2．01版本摘要
这个版本阐述了IOPCBrowseServerAddressSpace中的dwAccessRightsFilter和讨论了一般的数据入口（6.7.6节）
2．0版本摘要
这个版本包含了对1.0A版本的增强。
通篇中也作了更改。
下面的方面或许特别重要：
这个被称为OPC Data Access Specificatong 的东西是从其他的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
2 OPC 数据访问的基本原理。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
2
2．1 OPC 总览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
2
2．2 哪些地方适合使用OPC。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
3
2．3 通常的OPC的机构和组成。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
4
2．4 OPC 数据访问结构详述。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
5
2．5 对象和接口总览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
6
2．6 服务器的地址空间和配置。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
7
2．7 服务器和网络节点应用水平的选择。
。
。
。
。
。
。
。
。
8
2．8 同步和串行传输的问题。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
8
2．9 持久存储的事例。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
9
3 OPC 数据访问的快速参考。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
10
3．1 自定义接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
10
4 OPC 自定义接口。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
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．12 VARIANT 数据类型和互用性。
。
。
。
。
。
。
。
。
。
。
。
16
4．2．13 定位和LocaleID。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
19
4．2．14 条目属性。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
19
4．2．15 IOPCSyncIO。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
25
4．2．16 IOCASyncIO2。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
26
4．2．17 通过IOPCDataCallback 的定制。
。
。
。
。
。
。
。
。
。
27
4．3 OPCServer 对象。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
28
4．3．1 概要。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
28
4．3．2 IUnknown。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
29
4．3．3 IOPCCommon。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
29
4．3．4 IOPCServer。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
30
4．3．4．1 IOPCServer:
:
AddGroup 。
。
。
。
。
。
。
。
。
。
。
。
。
。
30
4．3．4．2 IOPCServer:
:
GetErrorString。
。
。
。
。
。
。
。
。
。
。
。
。
33
4．3．4．3 IOPCServer:
:
GetGroupByName。
。
。
。
。
。
。
。
。
。
34
4．3．4．4 IOPCServer:
:
GetStatus 。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
35
4．3．4．5 IOPCServer :
:
RemoveGroup。
。
。
。
。
删除组。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
36
4．3．4．6 IOPCServer:
:
CreateGroupEnumerator。
。
。
。
。
创建组列举。
。
。
。
。
。
。
。
38
4．3．5 IConnectionPointContainer（On OPCServer）。
。
。
。
。
。
连接电容器。
。
。
。
。
。
。
。
40
4．3．5．1 IConnectionPointContainer:
:
EnumConnectionPoints。
连接点列举。
41
4．3．5．2 IConnectionPointContainer:
:
FindConnectionPoint。
。
。
查询连接接点。
。
42
4．3．6 IOPCBrowse 。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
OPC浏览。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
43
4.3.6.1 IOPCBrowse:
:
Browse...浏览..................................43
4.3.6.2 IOPCBrowse:
:
GetProperties......获得属性.........................46
4.3.7 IOPCItemIO...................条目.........................48
4.3.7.1 IOPCItemIO:
:
Read........读取...............................48
4.3.7.2 IOPCItemIO:
:
WriteVQT...................................51
4.4 OPCGROUP OBJECT.............组对象..............................53
4.4.1 General Properties......一般属性............................54
4.4.1.1 Name..............名字.....................................54
4.4.1.2 Cached data..........缓存数据..................................54
4.4.1.3 Active................激活................................54
4.4.1.4 Update Rate...............更新率..............................55
4.4.1.5 Time Zone （TimeBias）.........时区（时间偏倚）............................55
4.4.1.6 Percent Deadband...........死区百分比.............................56
4.4.1.7 ClientHandle..............客户端句柄..............................56
4.4.1.8 Reading and Writing Data.........读写数据......................56
4.4.2 IOPCItemMgt........................................58
4.4.2.1 IOPCItemMgt:
:
AddItems.......加入条目..........................58
4.4.2.2 IOPCItemMgt:
:
ValidateItems...条目生效........................60
4.4.2.3 IOPCItemMgt:
:
RemoveItems......刈除条目.....................62
4.4.2.4 IOPCItemMgt:
:
SetActiveState....设置为活动状态.....................63
4.4.2.5 IOPCItemMgt:
:
SetClientHandles....设置客户端句柄....................64
4.4.2.6 IOPCItemMgt:
:
SetDatatypes........设定数据类型....................65
4.4.2.7 IOPCItemMgt:
:
CreateEnumerator.....创建枚举器.....................66
4.4.3 IOPCGroupStateMgt..................................67
4.4.3.1 IOPCGroupStateMgt:
:
GetState.....获取状态.......................67
4.4.3.2 IOPCGroupStateMgt:
:
SetState.......设置状态......................69
4.4.3.3 IOPCGroupStateMgt:
:
SetName.......设置名称......................71
4.4.3.4 IOPCGroupStateMgt:
:
CloneGroup.....关闭组......................72
4.4.4 IOPCGroupStateMgt2................................74
4.4.4.1 IOPCGroupStateMgt2:
:
SetKeepAlive....设置生命期..................74
4.4.4.2 IOPCGroupStateMgt2:
:
GetKeepAlive......获得生命期...............76
4.4.5 IOPCSyncIO.....................同步IO....................77
4.4.5.1 IOPCSyncIO:
:
Read.............读取...........................77
4.4.5.2 IOPCSyncIO:
:
Write..............写入........................80
4.4.6 IOPCSyncIO2.........................................82
4.4.6.1 IOPCSyncIO2:
:
ReadMaxAge.....读取最大生命期...................82
4.4.6.2 IOPCSyncIO2:
:
WriteVQT..............................85
4.4.7 IOPCAsyncIO2.............异步IO................87
4.4.7.1 IOPCAsyncIO2:
:
Read..............读............................88
4.4.7.2 IOPCAsyncIO2:
:
Write..............写............91
4.4.7.3 IOPCAsyncIO2:
:
Refresh2...........刷新................94
4.4.7.4 IOPCAsyncIO2:
:
Cancel2............取消..................96
4.4.7.5 IOPCAsyncIO2:
:
SetEnable.........使活动..................97
4.4.7.6 IOPCAsyncIO2:
:
GetEnable..........获得活动...................98
4.4.8 IOPCAsyncIO3........................99
4.4.8.1 IOPCAsyncIO3:
:
ReadM
升级会员 