服务器中节点的 NamespaceIndex。 • i：节点的数字标识符 • s：节点的字符串标识符与之前使用的OPC_UA_ReadList 的差异 对于固件版本不超过 V3.0 的 S7-1500CPU，“OPC_UA_ReadList”指令只能用于读取远程 OPC UA 服务器的 PLC变量。为此，需要先调用包含建立连接在内的其它指令。除此之外，执行 读取操作后，还需调用其它指令重新释放资源。如果使用“OPC_UA_ReadList”指令诊断本地 CPU 的 OPC UA 服务器，则无需执行这些预处理和后处理步骤。此时，“OPC_UA_ReadList”完全独立运行。 使用“OPC_UA_ReadList”对本地 CPU 的 OPCUA 服务器执行诊断时，部分参数的含义与读取 远程 OPC UA 服务器的 PLC变量时不同，尤其是“ConnectionHdl”参数。该参数用于定义此指 令的执行方式。有关参数含义变化的详细说明，请参见相应的参数表。 功能描述“OPC_UA_ReadList”指令是异步运行指令。该指令的执行可跨多个调用。在参数“Req”的上升 沿处，开始执行。参数“Busy”和“Done”用于指示作业状态。 如果执行过程中出错，则参数“Error”和“Status”将发出指示信号。另请参见“同步指令和异步指令之间的不同之处 (页 715)” 参数 下表列出了对本地 CPU 的 OPC UA服务器执行诊断时，“OPC_UA_ReadList”指令的参数。 参数 声明 数据类型 说明 Req Input Bool控制参数请求 上升沿处激活该作业。 Connection Hdl Input DWord 注：该参数的含义与读取远程 OPC UA服务器的 PLC 变量时不同。 十进制值 -42 (16#FFFFFFD6) 该值将导致“OPC_UA_ReadList”在本地CPU 的 OPC UA 服务器上读取节 点。 NodeHdlCou nt Input UINT参数“NodeHdls”指定的数组中的元素数。
参数 声明 数据类型 说明NodeHdls InOut Variant 注：该参数的含义与读取远程 OPC UA 服务器的 PLC 变量时不同。 指向OPC_UA_NodeId 类型元素的数组的指针，参见 “OPC_UA_NodeId (页 5894)”该数组包含本地服务器接口的节点。 可在标准 SIMATIC 服务器接口取消激活时读取所有节点。 NodeAddInf os InOutVariant 指向 OPC_UA_NodeAdditionalInfo (页 5895) 或OPC_UA_NodeAdditionalInfoExt (页 5896) 类型的数组的指针该数组定义了要读取节点中（变量中）的哪种属性。 此数组中的第一个元素是指“NodeHdls”参数所指向的数组中的第一个元 素。该参数是可选设置。如果未设置此参数，则会读取所有节点（变量）的 值。 读取数组时，可限制要读取的数组元素，请参见“使用OPC_UA_ReadList 读取数组范围信息 (页 5803)”的“读取数组区”。 Timeout Input Time注：该参数的含义与读取远程 OPC UA 服务器的 PLC 变量时不同。 系统不对该参数进行评估。 Done Output Bool状态参数，具有以下值： • 0：作业尚未开始或仍在处理之中。 • 1：作业已完成且未出错。仅显示一次调用的状态。 BusyOutput Bool 状态参数，具有以下值： • 0：作业尚未启动或已完成。 • 1：作业尚未完成。具有该实例的新作业无法启动。Error Output Bool 状态参数 • 0：无错误。 • 1：执行过程中出错。“Status”参数将提供有关错误类型的详细信息。仅显示一次调用的状态。 Status Output DWord指令“OPC_UA_ReadList”的返回值或错误信息，见下文。 NodeStatusL ist InOut Variant 指向DWORD 类型数组的指针。 该数组包含各变量的错误代码（请参见下文的“NodeStatusList 的错误 编号”）。指定每个变量的值是否可读取。 可能出现指令已成功执行（“错误”参数未设置）、但无法读取特定 NodeId（变量）的值的情况。参数 声明数据类型 说明 TimeStamps InOut Variant 指向 LDT 类型数组的指针。此数组中的第一个元素是指“NodeHdls”参数所指向的数组的第一个元 素。 该参数是可选设置。如果不使用此参数，OPC UA服务器不提供时间戳。 Variable InOut Variant 指向结构或 PLC 数据类型 (UDT) 的指针。该指针指向目标区（读取值）。 有关有效数据类型的更多信息，请参见“有效数据类型概述 (页 255)” “Status”参数“Error”参数的值为 1 时，可使用“Status”参数确定错误发生的原因。 下表列出了可能的错误代码。 错误代码(16#...) 错误名称 说明 8003_0000 OpcUa_BadOutOfMemory 调用的准备过程中，存储区分配失败。可能因几个偶发原因导致。 B080_0100 Simatic_BadType_VariantIn put1 分配给 NodeHdls参数的值指向错误的类型 元素。NodeHdls 必须是指向 OPC_UA_NodeId 类型元素的数组的指针。 B080_0200Simatic_BadType_VariantIn put2 分配给 NodeAddInfos 参数的值指向错误的类型元素。NodeAddInfos 必须是指向 OPC_UA_NodeAdditionalInfo 或OPC_UA_NodeAdditionalInfoExt 类型数组 的指针。 B080_0300Simatic_BadType_VariantIn put3 分配给 NodeStatusList 参数的值指向错误的类型元素。NodeStatusList 必须是指向 DWORD 类型数组的指针。 B080_0400Simatic_BadType_VariantIn put4 分配给 TimeStamps 参数的值指向错误的类型元素。TimeStamps 必须是指向 LDT 类型 数组的指针。 B080_0500Simatic_BadType_VariantIn put5 分配给 Tag 参数的值指向错误的类型元素。 Tag 必须是指向结构或PLC 数据类型 (UDT) 的 指针。(16#...) 错误名称 说明 B080_1100Simatic_ArrayElements_To oMany NodeHdlCount >MAX_ELEMENTS_NODELIST (300) B080_3100 BadNumElements_VariantI nput1NodeHdlCount 的值大于 NodeHdls 指向的 数组大小。 B080_3200BadNumElements_VariantI nput2 NodeHdlCount 的值大于 NodeAddInfos 指向的数组大小。 B080_3300 BadNumElements_VariantI nput3 NodeHdlCount 的值大于NodeStatusList 指 向的数组大小。 B080_3400 BadNumElements_VariantI nput4NodeHdlCount 的值大于 TimeStamps 指向 的数组大小。 B080_3500BadNumElements_VariantI nput5 NodeHdlCount 的值大于或小于“Tag”参数指 向的值元素数。B080_C300 Simatic_InsufficientResour ces OPC UA 服务器无法访问，可能的原因有：存储空间不足。 B080_C500 Simatic_SimaticNothingTo Do NodeHdlCount 的值为 0。B080_C700 Simatic_ServerNotEnabled OPC UA 服务器未激活。 B080_C800Simatic_ServerNotAvailabl e OPC UA 服务器已激活，但尚不可用。 B080_C900Simatic_ServerNotInitialize d OPC UA 服务器已激活并可用，但尚未初始 化。“NodeStatusList”参数 “NodeStatusList”参数中的每个元素指示 NodeHDls 中的相关 NodeId的值是否已成功读取。 仅当“Done”的值为 TRUE 时，NodeStatusList 才有效。元素的下标 >=NodeHdlCount 时，将 忽略这些元素，且这些元素无效。 说明 NodeStatusList强烈建议始终使用并评估“NodeStatusList”参数。 下表列出了各错误代码的具体解释。