OPC_UA_WriteList：写入变量 (S7-1500) 有效性“OPC_UA_WriteList”指令的以下说明适用于 S7-1500 CPU 固件版本 V2.6 及更高版本。 说明使用指令“OPC_UA_WriteList”将新值写入 PLC 变量。 下图显示了该指令在编辑器 (FBD) 中的图标。客户端中的结果“OP_UA_ReadList”指令现在只从 OPC UA 服务器读取“Temperature”数组的一部分。下图显示了数组“Temperature”。客户端分配从索引 0 开始读取的值： 说明要读取多维数组（Zui多六维）的区段，请使用“OPC_UA_NodeAdditionalInfoExt”数据类型。
在上图中，尚未包含该指令的参数。指令“"OPC_UA_WriteList”用于为 PLC 变量分配新值，请参见下图中的 ②。 指令返回包含各 PLC变量状态信息的列表。 ① 准备读取和写入操作的指令 ② 读取和写入指令 ③ 完成读取或写入操作后释放资源的指令OPC_UA_WriteList 的参数 表格 4-79 指令 OPC_UA_WriteList 的参数 参数 区域中的 声明数据类型 含义 REQ Input BOOL 参数中的上升沿 0 → 1 可触发指令的执行。ConnectionHdl Input DWORD 已建立连接的唯一标识符。 可使用指令“AUTOHOTSPOT”获取句柄。NodeHdlCount Input UINT 指向 NodeHdls 参数的数组中元素的数目。参数 区域中的 声明 数据类型 含义NodeHdls InOut VARIANT 指向 DWORD 类型的数组的指针。 该数组包含要写入其值的变量的节点句柄。NodeAddInfos InOut VARIANT 指向 AUTOHOTSPOT 或 AUTOHOTSPOT 类型的数组 的指针。该数组定义了要在节点中（变量中）设置哪种属性。 此数组中的第一个元素是指 NodeHdls 参数所指向 的数组中的第一个元素。该参数可选。如果未设置此参数，则会在所有节点 （变量）中设置该值。 写入数组时，可限制要写入数组的哪些元素，请参 见“使用OPC_UA_WriteList 写入数组区段 (页 5819)”。 Timeout Input TIME指令执行的Zui长时间（单位为毫秒）。 另请参见“AUTOHOTSPOT”中该参数的具体说明。 NodeStatusList InOutVARIANT 指向 DWORD 类型的数组的指针。 该数组包含各变量的错误代码（请参见下文的 “NodeStatusList的错误编号”。） 指示是否可设置各变量的值。 该指令可能已成功执行（“错误”参数未设置）， 但无法为特定变量分配值。NodeStatusList[0] 与 NodeHdls[0] 相关，以此类 推。 Variable InOut VARIANT指向包含待写入值的变量的指针。 必须为该变量创建 PLC 数据类型 (UDT)。 Done Output BOOL 执行的状态： •0：指令的执行中止、尚未完成或尚未开始 • 1：指令的执行已完成且未出错 Busy Output BOOL 执行状态参数： •0：指令未在执行 • 1：指令当前正在执行状态对应的错误编号 “Status”参数将提供指令执行过程中所发生错误的相关信息。下表汇总了该指令的错误代码： 错误代码 （十六进制值） 错误名称 说明OpcUa_Good 已成功执行函数块。在 REQ中没有上升沿时首次调用，表示 未开始执行作业开始执行作业时首次调用后续调用OpcUa_BadOutOfMemory 无 OPC UA客户端可用的内存。 由于 OPC UA 客户端和 OPC UA 服务器共 用存储区，应降低服务器的存储区要求。 此时，可执行以下操作：• 为 OPC UA 释放少量 PLC 变量。 • 减少当前连接到服务器的 OPC UA 客 户端的数量。 •设置更少的订阅。OpcUa_BadUnknownResponse 服务器发送的响应无法识别。错误代码 （十六进制值） 错误名称 说明800A_0000 OpcUa_BadTimeout 发生网络超时。 可能的原因： • 与 OPC UA服务器的连接速度过慢 （容量不足）。 • 网络负载过高。 • OPC UA 服务器不可用。 可能的补救措施： • 检查 OPC UA服务器的 URL • 增加超时设置（为函数块 OPC_UA_Connect 的超时参数设置 更大的值）。 800D_0000OpcUa_BadServerNotConnecte d 服务器未连接或者连接句柄错误或无效。 800F_0000OpcUa_BadNothingToDo 不执行任何操作：OPC UA 服务器从 OPC UA 客户端接收到一个空表，其中不含任何指令。 8010_0000 OpcUa_BadTooManyOperation s 已超出每个连接可同时调用的“OPC_UA_WriteList”指令数量 (> 5)，请 参见：AUTOHOTSPOT 80AE_0000BadConnectionClosed 与相应 ConnectionHdl 的连接处于 “ShutDown”状态（连接终止）。连接/会话无法自动“重新激活”。可能的原 因：会话已从服务器上删除，例如由于 重启或超时等原因。 在这种情况下，必须通过指令“OPC_UA_Disconnect”明确关闭连接并 再次释放连接资源。在用户程序中，必 须复位已对此连接无效的ConnectionHdl。 随后必须与服务器建立新的连接（参见 指令“OPC_UA_Connect”）。错误代码 （十六进制值）错误名称 说明 80AF_0000 BadInvalidState 与相应 ConnectionHdl 的连接处于“ConnectinError”状态（临时连接错 误，连接中断）。CPU 尝试“重新激 活”连接。如果在设定的超时间隔 (OPC UASession Timeout) 内未成功激 活连接，连接会进入“Shutdown”状态。 状态转换要求：CPU 可访问 OPC UA服 务器以检查会话是否仍处于活动状态。 B080_0100 Simatic_BadType_VariantInput 1参数“NodeHdls”的数据类型不正确。 B080_0200 Simatic_BadType_VariantInput 2参数“NodeAddInfos”的数据类型不正 确。 B080_0300 Simatic_BadType_VariantInput 3参数“NodeStatusList”的数据类型不正 确。 B080_0400 Simatic_BadType_VariantInput4 参数“Variable”的数据类型不正确（不 是 UDT）。 B080_1100Simatic_ArrayElements_TooMa ny 常规错误代码。数组包含的元素过多时 发生该错误。 B080_3100BadNumElements_VariantInpu t1 “NodeHdlCount”参数大于“NodeHdls” 参数中ARRAY 元素的数量。 B080_3200 BadNumElements_VariantInpu t2“NodeHdlCount”参数大于 “NodeAddInfos”参数中 ARRAY 元素的数 量。 B080_3300BadNumElements_VariantInpu t3 “NodeHdlCount”参数大于“NodeStatusList”参数中 ARRAY 元素的 数量。 B080_3400BadNumElements_VariantInpu t4 根据参数“NodeHdlCount”的值，参数 “Variable”的PLC 数据类型/结构的元素 太少或太多。 示例：如果“NodeHdlCount”的值为 5， 则数组“NodeHdls”也必须包含5 个元 素。参数“Variable”的结构也必须包含 5 个元素。 B080_C400Simatic_ClientNotEnabled OPC UA 客户端已禁用。错误代码 （十六进制值） 错误名称 说明B080_C500 Simatic_NothingToDo 不执行任何操作：指令正在使用未包含 任何元素的列表。 C080_C300Simatic_OutOfResources 已超出可同时使用的Zui大客户端指令数 量。 可能的补救措施： •减少同时运行的此类型客户端指令数 量，请参见“ AUTOHOTSPOT” 更多错误代码，请参见“错误代码(页 5899)”。 “NodeStatusList”的错误编号“NodeStatusList”参数包含各节点句柄（变量）的错误代码。 下表列出了各错误代码的具体说明： 错误代码 （十六进制值）错误名称 说明 0000_0000 OpcUa_Good 成功读取值。 8034_0000 OpcUa_BadNodeUnknown传输的节点句柄未知。 8035_0000 OpcUa_BadAttributeInvalid 所需属性不支持用于特定节点。8037_0000 OpcUa_BadIndexRangeNoD 索引范围内无数据。 8039_0000OpcUa_BadDataEncodingUnsupported OPC UA 服务器不支持对该节点 进行所需数据解码。803B_0000 OpcUa_BadNotWritable 没有写入此节点的权限。 803C_0000OpcUa_BadOutOfRange NodeAddInfos 参数中指定的索 引值超出了允许范围。 803D_0000OpcUa_BadNotSupported OPC UA 服务器不支持所请求函 数的其中之一。 部分 OPC UA 服务器不允许访问数组的索引范围。 80AB_0000 OpcUa_BadInvalidArgument 一个或多个参数无效。