Set_Attribute_Single:设置某个对象的属性

功能块描述

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

图形表示形式

G-SE-0047924.1.gif-high.gif

 

 

输入

下表介绍了输入变量:

输入

数据类型

注释

i_xExecute

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

输入 Execute 的上升沿可启动功能块。功能块持续执行,且输出 Busy 设置为 TRUE。

oFALSE:如果 Enable 被设置为 FALSE,输出 DoneError 或 CommandAborted 将被设置为 TRUE 并持续一个周期。

oTRUE:如果 Enable 被设置为 FALSE,输出 DoneError 或 CommandAborted 仍将被设置为 TRUE。

i_xAbort

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

oFALSE:执行尚未中止。

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

i_xMsgType

BOOL

oFALSE:UCCM

oTRUE:已连接(3 类)消息

i_adTargetIP

TCP_ADDR

目标的 IP 地址。

i_dwClass

DWORD

目标类。

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

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

i_dwInstance

DWORD

目标实例。

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

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

i_dwAttribute

DWORD

目标属性。

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

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

i_abyRequestData

ARRAY OF BYTE

0…MAX_EIP_REQUEST_DATA_SIZE

必须发送至目标的数据。如果未使用,则 wDataSize 必须为 0  1

q_wDataSize

WORD

abyRequestData 的实际大小 1

1   输入数据缓冲区也必须经过格式化处理。请参阅 ODVA EtherNet/IP 规范第 1 卷中的 Set_Attribute_Single 请求数据。

输出

下表描述了输出变量:

输出

数据类型

注释

q_xDone

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

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

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

q_xBusy

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

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

oTRUE:功能块正在执行中。

q_xAborted

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

oFALSE:执行尚未中止。

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

q_xError

BOOL

值范围:FALSE,TRUE。

缺省值: FALSE。

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

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

q_byCommError

BYTE

给出与检出错误有关的信息。

q_dwOperError

DWORD

给出与检出错误有关的信息。