Get_Attribute_Single:获取某个对象的某一属性

功能块描述

此功能块用于返回某一对象实例的某一特定属性的内容。

如要使用此功能块,必须在 协议管理器 下方添加至少一个 EtherNet/IP 设备。请参阅添加设备

图形表示形式

输入

下表介绍输入变量:

输入

数据类型

注释

i_xExecute

BOOL

值范围:FALSETRUE

缺省值: FALSE

输入 Execute 的上升沿可启动功能块。功能块持续执行,且输出 Busy 设置为 TRUE。功能块执行期间 Execute 输入的另一个上升沿将被忽略。

  • FALSE:在功能块执行期间,如果输入 Execute 设置为 FALSE,则输出 DoneError 设置为 TRUE(针对一个循环)。

  • TRUE:只要输入 Execute 设置为 TRUE,输出 DoneError 就设置为 TRUE

i_xAbort

BOOL

值范围:FALSETRUE

缺省值: FALSE

  • FALSE:执行尚未中止。

  • TRUE:执行已被另一个功能块所中止。

i_xMsgType

BOOL

  • FALSE:UCCM

  • TRUE:已连接(3 类)消息

i_adTargetIP

TCP_ADDR

目标的 IP 地址。

i_dwClass

DWORD

目标类。

参见如何在设备文档中查找对象信息

如果类不是请求的一部分,则它必须为 0xFFFFFFFF

i_dwInstance

DWORD

目标实例。

参见如何在设备文档中查找对象信息

如果目标是类实例,则它可以为 0。如果实例不是请求的一部分,则它必须为 0xFFFFFFFF

i_dwAttribute

DWORD

目标属性。

参见如何在设备文档中查找对象信息

如果属性不是请求的一部分,则它必须为 0xFFFFFFFF

输出

下表介绍输出变量:

输出

数据类型

注释

q_xDone

BOOL

值范围:FALSETRUE

缺省值: FALSE

  • FALSE:执行尚未启动,或者已检出错误。

  • TRUE:无检出错误时执行终止。

q_xBusy

BOOL

值范围:FALSETRUE

缺省值: FALSE

  • FALSE:功能块不处于正被执行状态。

  • TRUE:功能块正在执行中。

q_xAborted

BOOL

值范围:FALSETRUE

缺省值: FALSE

  • FALSE:执行尚未中止。

  • TRUE:执行已被 Abort 输入所中止。

q_xError

BOOL

值范围:FALSETRUE

缺省值: FALSE

  • FALSE:功能块的执行正在进行中,尚未检出错误。

  • TRUE:已在执行功能块时检出错误。

q_byCommError

BYTE

给出与检出错误有关的信息。请参阅 CommunicationErrorCodes:通讯错误代码

q_dwOperError

DWORD

给出与检出错误有关的信息。请参阅 OperationErrorCodes:操作错误代码

q_abyResponseData

ARRAY OF BYTE

0…MAX_EIP_REQUEST_DATA_SIZE

成功时的响应数据。

q_wDataSize

WORD

以字节数量表示的响应数据的大小。