SIEMENS西门子 操作屏连接盒 6AV21252AE030AX0

               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 开始读取的值： 说明要读取多维数组（多六维）的区段，请使用“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指令执行的长时间（单位为毫秒）。 另请参见“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 已超出可同时使用的大客户端指令数 量。 可能的补救措施： •减少同时运行的此类型客户端指令数 量，请参见“ 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 一个或多个参数无效。