下文中将介绍如何使用该指令 此部分通过程序示例来说明指令“OPC_UA_ReadList”在读取 PLC变量值的用户程序中的使用 方法。 要求 以下说明假定： • 已创建了一个客户端接口，参见“AUTOHOTSPOT”。 •已创建并组态与 OPC UA 服务器的连接，请参见“AUTOHOTSPOT”。 • 如果要使用·CPU 作为 OPC UA 客户端在OPC UA 服务器中读取和写入结构：OPC UA 服 务器需要支持 OPC UA 规范版本 V1.04。使用“OPC_UA_ReadList”指令还必须满足以下要求： • 提供与 OPC UA 服务器建立连接的句柄。通过以下指令获取连接句柄：AUTOHOTSPOT。 • 用于各个变量的句柄列表，其变量值均要从 OPC UA 服务器读取。通过以下指令获取句柄列表：AUTOHOTSPOT。
指令的功能举例来说，可使用“OPC_UA_ReadList”指令来从 OPC UA 服务器读取变量值（见上文）。 需要哪些信息？使用该指令需要用到以下信息： • 要读取其值的变量的句柄（“NodeHdls”参数）。 指令会返回哪些信息？ 该指令返回以下信息： •变量的当前值（“Variable”参数）。 值顺序对应于“NodeHdls”参数中的句柄顺序。 为此，请参考以下实例： –使用的客户端接口具有读取列表时，STEP 7 会自动创建与需要读取的变量对应的系统 数据类型。 –如果不使用客户端接口，必须为“Variable”参数创建 PLC 数据类型 (UDT) 或结构 (STRUCT)。根据需要读取的变量定义该 UDT 的分量。 使用与相应 OPC UA 数据类型兼容的 SIMATIC数据类型，请参见“AUTOHOTSPOT”。 • 错误消息列表（“NodeStatusList”参数）。此表中的每条错误消息都与“NodeHdls”参数中的对应句柄相关：NodeStatusList[0] 对应 于NodeHdls[0]。 对于各变量（各“NodeHdl”），用户需要检查 OPC UA 服务器是否能返回一个有效值。已组态连接的使用方法 1. 在“项目树”(Project tree) 区域中，选择作为客户端的 CPU。 2.在“程序块”(Program blocks) 文件夹中，选择将包含客户端指令的函数块。在该示例中，函数块名为“ReadFromProductionline”。 选择的语言：SCL。 3.使用拖放功能将“OPC_UA_ReadList”指令从“指令 > 通信 > OPC UA > OPC UA 客户端”(Instructions > Communication > OPC UA > OPC UA Client)文件夹移到编辑器。 4. 选择该调用，作为多重实例。 STEP 7创建该指令的实例：“OPC_UA_ReadList_Instance”。 5.在“OPC_UA_ReadList_Instance”指令中，单击图标“开始组态”(Start configuration)。STEP 7 随即在巡视窗口中打开“组态”(Configuration) 选项卡。 6. 在“选择用于 OPC UA接口的客户端接口”(Select client interface for OPC UA interface) 下，选择要为指令使用的客户端接口。 在该示例中，客户端接口名为“Productionline”。7. 单击“数据访问”(Dataaccess)，然后选择读取列表。 在该示例中，读取列表名为“ReadListProduct”。 STEP 7现在将自动为指令参数提供已为客户端接口组态的值。 8. 单击“块参数”(Blockparameters)，然后将变量手动分配给剩余参数 REQ、Busy、Done、 Error、Status。 STEP 7会将所选变量添加到函数调用中。 调用指令（首次调用） 有关完整的程序，请参见“AUTOHOTSPOT”部分。程序示例使用的读取列表“ReadListProduct”包含以下 PLC 变量： • NewProduct •ProductNumber 程序从服务器读取这些变量的值。 有关如何创建客户端接口以及如何通过 PLC 变量添加读取列表的信息，请参见“AUTOHOTSPOT”部分。 示例程序由 CASE 指令分为多个程序段（实例）。 在第四个程序段中，会读取变量值：异步执行“OPC_UA_ReadList”指令与用户程序异步执行，需要多个程序周期。通过“Busy”、“Done”、“Error”和“Status”参数，可检查作业的状态。有关异步程序执行的信息，请参见“同步指令和异步指令之间的不同之处 (页 715)”部分。 指令调用说明（首次调用）上图所示为示例 4。 这部分程序会调用“OPC_UA_ReadList”指令读取 PLC 变量的值。 如果指令未执行，#Busy 为FALSE，因此“#Req”变量会设为值 TRUE。这将启动指令的执行过 程。下一周期中，#Req 为 FALSE。调用指令（故障排除） 下图所示为对“Done”和“Error”参数的评估。指令调用说明（故障排除）如果发生错误，输出参数“Error”的值将设为 TRUE ，这会将“#State”变量的值设为 100。该实例将保留以接受故障排除。示例程序还调用了“OPC_UA_ReadList”指令，以将 REQ 参数设为 FALSE。 如果 TRUE值在“Done”输出参数中，说明指令执行成功。 注：该指令可能已成功执行（“Error”参数未置位，“Done”参数置位），但不能读取PLC 变量。 因此，在示例中，会对各 PLC 变量进行检查，以确定程序是否已获取有效值： • 如果服务器为第一个 PLC变量发送有效值，则“NodeStatusList”参数指向的数组的第一个 元素包含值 0。 在本示例中，状态代码列于“"Productionline_Data"."ReadListProduct".NodeStatusList[0].”中。 •如果服务器为第二个 PLC 变量发送有效值，则“NodeStatusList”参数指向的数组的第二个 元素包含值 0。在本示例中，状态代码列于“Productionline_Data”."ReadListProduct".NodeStatusList[1]中。 程序识别到无效值时，会输出错误消息。 即使检测到一个或两个无效值，“#State”变量的值也会加 1。这意味着将在下一周期执行下一程序段（示例 5）。 有关示例 5的信息，请参见“OPC_UA_NodeReleaseHandleList：释放用于读写访问的句柄”。使用OPC_UA_ReadList 读取数组范围信息 (S7-1500) 简介本部分基于“OPC_UA_ReadList”；请参见“OPC_UA_ReadList：读取变量 (页 5792)”。本部分介绍了如何使用“OPC_UA_ReadList”指令读取数组的各部分。 从 OPC UA服务器读取数组的各部分的基本方法如下：① 从 OPC UA 服务器读取数组的各部分 要求 以下说明假定： • 已组态一个 CPU 作为OPC UA 服务器。 服务器提供可由 OPC UA 客户端读取的数组。 在该示例中，CPU 名为“Productionline”，为OPC UA 客户端提供数据块 “Data_for_OPC_UA_Clients”： • 已组态一个 CPU 作为 OPC UA客户端。 在客户端，已创建了一个客户端接口。 客户端接口包含读取列表，其中包含要读取其中某一部分的数组。在本示例中，客户端接口名为“Productionline”，包含读取列表“ReadListProduct”：“Temperature[5]”到“Temperature[9]” 中的值从服务器的“Temperature”数组中读取。提供其它信息“OPC_UA_ReadList”显示了如何使用“OPC_UA_ReadList”指令读取整个标量（包含单个值的变量）或数组（包含多个值的变量）。以下部分提供使用“OPC_UA_ReadList”读取部分数组时需要使用的“OPC_UA_ReadList”的更多 详细信息。OPC_UA_NodeAdditionalInfo首先创建一个“OPC_UA_NodeAdditionalInfo”类型的局部变量，请参见“OPC_UA_NodeAdditionalInfo (页 5895)”。该变量用于告知“OPC_UA_ReadList”指令要读取数组的哪一部分。请按如下步骤进行操作： 1. 创建一个OPC_UA_NodeAdditionalInfo 类型的数组变量。在本示例中，变量是在函数块的声明部分创建的，此部分会调用“OPC_UA_ReadList”指令。新建的本地变量名为“NodeAdditionalInformation”：由于读取列表“ReadListProduct”包含三个节点，因此新建的本地变量“NodeAdditionalInformation”包含三个 OPC_UA_AdditionalInfo 类型的分量。NodeAdditionalInformation[0] 提供关于要读取的第一个变量（本示例中为“NewProduct”）的附加信息。 NodeAdditionalInformation[1] 提供关于要读取的第二个变量（本示例中为“ProductNumber”）的附加信息。 NodeAdditionalInformation[2]提供关于要读取的第三个变量（本示例中为“Temperature”） 的附加信息。 2. 为新变量赋值（在声明部分的“默认值”列）。在本示例中，将读取第三个变量 (Temperature 的一部分。 因此会为NodeAdditionalInformation[2].AttributeId 分配 13（即读取数组的值）。 由于会从索引5（包括索引 5）开始读取，因此为 NodeAdditionalInformation[2].StartIndex 分配数值 5。由于会从索引 9（包括索引 9）开始读取，因此为 NodeAdditionalInformation[2].EndIndex 分配数值 9。 NodeAdditionalInformation[0] NodeAdditionalInformation[1]设为默认值。 常量“#ignore”包含值 4_294_967_295。对于 StartIndex 和EndIndex，服务器会忽略该值， 并完全读取标量和数组。 或者： 还可以在用户程序中设置NodeAdditionalInformation 的值 。