请按如下步骤进行操作： 1. 创建一个 OPC_UA_NodeAdditionalInfo 类型的数组变量。在本示例中，在用于调用“OPC_UA_WriteList”指令的函数块的声明部分创建该变量。将新的局部变量命名为“NodeAdditionalInformation”：新的局部变量“NodeAdditionalInformation”包含两个“OPC_UA_AdditonalInfo”类型的元素。NodeAdditionalInformation[0] 提供了待写入的第一个变量（本示例中为“ProductionEnabled”）的附加信息 NodeAdditionalInformation[1]提供了待写入的第二个变量（本示例中为“Serial_Number”）的 附加信息 2. 为新变量赋值（在声明部分的“默认值”列）。在本示例中，不要写入第二个变量（Serial_Number）的所有元素。 因此，为NodeAdditionalInformation[1].AttributeId 分配值 13（这意味着已写入数组值）。 为NodeAdditionalInformation[1].StartIndex 分配值 5，因为从索引 5（包括索引 5）开始写 入。为 NodeAdditionalInformation[1].EndIndex 分配值 9，因为从索引 9（包括索引 9）开始写入。为 NodeAdditionalInformation[0] 设置以下值，以通知服务器写入列表的第一个元素不是数组的一部分，而是标量或待写入的整个数组。 常量“#ignore”包含值 4_294_967_295。服务器会忽略 StartIndex和 EndIndex 的该值，并完 全写入标量和数组。
通过OPC_UA_WriteList 设置 OPC UA-DataValue (S7-1500) 有效性 以下信息适用于 S7-1500CPU 固件版本 V3.0 及以上版本。 要求 • S7-1500 CPU 中已激活 OPC UA 服务器。 说明 通过OPC_UA_WriteList 设置 OPC UA-DataValue “OPC_UA_WriteList”指令属于 OPC UA客户端指令。但如果使用该指令在本地 CPU 的 OPC UA 服务器上设置一个或多个 OPCUA-DataValues，则该指令的执行与其它客户端功能无关。即， 该 CPU 上的 OPC UA客户端无需连接，也无需激活。如果该客户端已激活，则 “OPC_UA_WriteList”的调用过程不包含在客户端程序中。 说明在上述条件下，也可使用指令“OPC_UA_WriteList”持续覆盖本地 CPU（本地主机连接）的 OPC UA 服务器上一个或多个OPC UA 变量节点的值和相关附加信息。 为确保一致性，不得通过远程 OPC UA 客户端设置应在本地设置的变量节点值。因此，受影响变量节点的“AccessLevel”或“UserAccessLevel”属性不得包含“CurrentWrite”选项。在此，将该值连同相关的附加信息称为 OPC UA-DataValue。 附加信息包括StatusCode、SourceTimestamp 和 SourcePicoseconds。只能设置用户自定义服务器接口节点的数据值。这些节点不得包含任何本地数据映射。常量 将被覆盖。 与之前使用OPC_UA_WriteList 的不同之处 在 S7-1500 CPU 固件版本 V3.0以下版本中，指令“OPC_UA_WriteList”只能用于写入远程 OPC UA 服务器的 PLC变量。为此，需要先调用包含建立连接在内的其它指令。除此之外，执行写入操作后，还需调用其它指令重新释放资源。如果使用指令“OPC_UA_WriteList”在本地 CPU 的 OPC UA服务器上设置一个或多个 OPCUADataValues，则无需执行这些预处理和后处理操作。此时，“OPC_UA_WriteList”完全独立运 行。使用“OPC_UA_WriteList”在本地 CPU 的 OPC UA 服务器上设置 OPC UA-DataValues 时，一些参数的含义与写入远程 OPC UA 服务器的 PLC 变量时不同，尤其是“ConnectionHdl”参数。该参数用于定义此指令的执行方式。 有关参数含义变化的详细说明，请参见相应的参数表。 功能描述“OPC_UA_WriteList”为异步执行指令，该指令的执行可跨多个调用。在参数“Req”的上升沿 处，开始执行。参数“Busy”和“Done”用于指示作业状态。 如果执行过程中出错，则参数“Error”和“Status”将发出指示信号。另请参见“同步指令和异步指令之间的不同之处 (页 715)” 参数 下表列出了在本地 CPU 的 OPC UA服务器上设置一个或多个 OPC UA-DataValues 时， “OPC_UA_WriteList”指令的参数。 参数 声明数据类型 说明 Req Input Bool 控制参数请求 上升沿处激活该作业。 Connection Hdl Input DWord注：该参数在写入远程 OPC UA 服务器的 PLC 变量时含义不同。 十进制值 -42 (16#FFFFFFD6)该值将导致“OPC_UA_WriteList”在本地 CPU 的 OPC UA 服务器上设置 OPC UA-DataValues。NodeHdlCou nt Input UINT 参数“NodeHdls”指定的数组中的元素数。 NodeHdls InOutVariant 注：该参数在写入远程 OPC UA 服务器的 PLC 变量时含义不同。 指向 OPC_UA_NodeId类型元素的数组的指针。 该数组中包含待设置值和附加信息的 OPC UA 变量的节点 ID，位于本地 服务器接口下。参数 声明 数据类型说明 NoteAddInfo s InOut Variant 注：该参数在写入远程 OPC UA 服务器的 PLC 变量时含义不同。不支持该参数，需为 ZERO 或未互连。 Timeout Input Time 注：该参数在写入远程 OPC UA 服务器的 PLC变量时含义不同。 系统不对该参数进行评估。 Done Output Bool 状态参数，具有以下值： •0：作业尚未开始或仍在处理之中。 • 1：作业已完成且未出错。仅显示一次调用的状态。 Busy Output Bool状态参数，具有以下值： • 0：作业尚未启动或已完成。 • 1：作业尚未完成。具有该实例的新作业无法启动。 Error OutputBool 状态参数 • 0：无错误。 • 1：执行过程中出错。“Status”参数将提供有关错误类型的详细信息。仅显示一次调用的状态。 Status Output DWord“OPC_UA_WriteList”指令的返回值或错误信息，见下文。 NodeStatusL ist InOut Variant指向包含 DWord 类型元素的数组的指针。 该数组中包含各个 OPC UA-DataValues 的错误代码，见下文。每个元素指示相关 NodeId 的 OPC UA-DataValue 是否设置成功。仅当 Done 为 1时，NodeStatusList 有效。数组元素的下标 >= NodeHdlCount 时，无效。 Tag InOutVariant 注：该参数在写入远程 OPC UA 服务器的 PLC 变量时含义不同。 指向结构或 PLC 数据类型 (UDT)的指针，或指向结构或 PLC 数据类型 (UDT) 数组的指针。该指针指向待写入的 OPC UA-DataValues。 OPCUA-DataValues 适用的规则，见下文。 有关有效数据类型的更多信息，请参见“有效数据类型概述。OPCUA-DataValues 的规则 OPC UA-DataValues 需遵循以下规则： • 所有 OPC UA-DataValue都是结构或 PLC 数据类型 (UDT)，且包含两个、三个或四个元素。 • 第一个元素通常对应 OPC UA变量的值，由用户自定义服务器接口的节点 ID 寻址。第一 个元素的数据类型可以是任何有效数据类型。不支持“Union”数据类型。请参见“AUTOHOTSPOT” • 第二个到四个元素为附加信息 StatusCode、SourceTimestamp 和SourcePicoseconds。 这些元素的顺序无要求。 仅支持数据类型 DWORD、UINT 和 LDT(DATE_AND_LTIME)。每种数据类型只能使用一次。 元素与元数据的对应关系取决于数据类型： – DWORD数据类型的元素解释为状态代码。 如果该元素不存在或值为 0，则解释为状态代码“Good”。 如果预设的状态代码为“Bad”（位 31置位），则 CPU 的固件将该值设置为 ZERO。 – LDT 数据类型 (DATE_AND_LTIME) 的元素解释为SourceTimestamp。 如果该元素不存在或者值为（预设值），则 CPU 的固件将其设置为当前系统时间。 – UINT数据类型的元素解释为 SourcePicoseconds。 如果该元素不存在，则解释为 0。 CPU的固件不会检查该元素的数字值。即，用户需检查相应的默认设置。 “Status”参数 “Error”参数的值为 1时，可使用“Status”参数确定错误发生的原因。 下表列出了可能的错误代码。 错误代码 (16#...) 错误名称 说明8003_0000 OpcUa_BadOutOfMemory 调用的准备过程中，存储区分配失败。可能 因几个偶发原因导致。8010_0000 OpcUa_BadTooManyOpera tions 已超出每个连接可同时调用的“OPC_UA_WriteList”指令的数量（Zui多 5 个）。 B080_0100Simatic_BadType_VariantIn put1 “NodeHdls”参数的数据类型不正确 B080_0200Simatic_BadType_VariantIn put2 “NoteAddInfos”参数已赋值。