下文中将介绍如何使用该指令此部分通过程序示例来说明指令“OPC_UA_WriteList”在为 PLC 变量设置新值的用户程序中的 使用方法。 要求以下说明假定： • 已创建了一个客户端接口，参见“AUTOHOTSPOT”。 • 已创建并组态与 OPC UA服务器的连接，请参见“AUTOHOTSPOT”。 • 如果要使用·CPU 作为 OPC UA 客户端在 OPC UA服务器中读取和写入结构：OPC UA 服 务器需要支持 OPC UA 规范版本 V1.04。使用“OPC_UA_WriteList”指令还必须满足以下要求： • 提供与 OPC UA 服务器建立连接的句柄。通过指令“AUTOHOTSPOT”，可获取连接句柄。 • 命名空间的索引，要求命名空间包含用户要通过客户端写入的变量。 用户可从AUTOHOTSPOT 指令获取索引。 • 用于各变量的句柄列表，其变量值均要在 OPC UA 服务器中设置。 用户可从AUTOHOTSPOT 指令获取此句柄列表。 在以下程序示例中，调用了一次该指令，向 OPC UA 服务器发送一个使能信号。 块的功能可使用“OPC_UA_WriteList”指令来写入 OPC UA 服务器中的变量值。 需要哪些信息？ 该函数需要以下信息： •要写入其值的变量的句柄（“NodeHdls”参数） • 要传输的各变量的值（“Variable”参数） 为此，请参考以下实例： –如果使用的客户端接口具有写入列表，STEP 7 会自动创建与需要传输的变量对应的系 统数据类型。 –如果不使用客户端接口，必须为“Variable”参数创建 PLC 数据类型 (UDT) 或结构 (STRUCT)。根据需要传输的变量定义该 UDT 的分量。 使用与相应 OPC UA 数据类型兼容的 SIMATIC数据类型，请参见“AUTOHOTSPOT”。
指令会返回哪些信息？该指令返回以下信息： • 错误消息列表（“NodeStatusList”参数）。此表中的每条错误消息都与“NodeHdls”参数中的对应句柄相关。 对于各变量（“NodeHdl”），用户需要检查 OPC UA服务器是否能接受新值。 已组态连接的使用方法 1. 在“项目树”(Project tree) 区域中，选择作为客户端的 CPU。 2.在“程序块”(Program blocks) 文件夹中，选择要用于执行客户端指令的函数块。在该示例中，函数块名为“WriteToProductionline”。 选择的语言：SCL。 3.使用拖放功能将“OPC_UA_WriteList”指令从“指令 > 通信 > OPC UA > OPC UA 客户端”(Instructions > Communication > OPC UA > OPC UA Client)文件夹移到编辑器。 4. 选择该调用，作为多重实例。 STEP 7创建该指令的实例并将其命名为“OPC_UA_WriteList_Instance”。 5.单击“OPC_UA_WriteList_Instance”。 STEP 7 将打开“组态”(Configuration)。 6.在“选择用于 OPC UA 接口的客户端接口”(Select client interface for OPC UAinterface) 下，选 择要为指令使用的客户端接口。 在该示例中，客户端接口名为“Productionline”，（请参见“AUTOHOTSPOT”和“AUTOHOTSPOT”）。 7. 单击“数据访问”(Dataaccess)，然后选择写入列表。 在该示例中，读取列表名为“WriteListStatus”。 STEP 7现在将自动为指令参数提供已为客户端接口组态的值。 8. 单击“块参数”(Blockparameters)，然后将变量手动分配给剩余参数 REQ、Busy、Done、 Error、Status。 STEP 7会将所选变量添加到函数调用中。 调用指令（首次调用） 有关完整的程序，请参见“AUTOHOTSPOT”部分。程序示例使用的写入列表“WriteListStatus”包含以下 PLC 变量： • ProductionEnabled程序将该变量的新值写入服务器。 “AUTOHOTSPOT”部分介绍了如何创建客户端接口以及如何为其添加包含 PLC 变量的写入列表。示例程序由 CASE 指令分为多个程序段（实例）。指令调用说明（首次调用） 上例所示为示例 4。 在示例程序中，该实例仅为一个 PLC变量分配新值。在用户应用程序中，可为大量 PLC 变量 分配新值。如果“#SetProductionEnabled”变量包含值“TRUE”，则新值设为 TRUE。由于初始化仅运行一次（在第一个周期中），因此随后会将“#SetProductionEnabled”设为 FALSE。“OPC_UA_WriteList”指令将新值写入 OPC UA 服务器中的 PLC变量“ProductionEnabled”。指令调用说明（故障排除） 如果发生错误，输出参数“Error”的值将设为 TRUE，这会将“#State”变量的值设为 100。该实例将保留以接受故障排除。示例程序还调用了“OPC_UA_WriteList”指令，以将 REQ 参数设为 FALSE。如果输出参数“Done”为 TRUE，说明指令执行成功。注：该指令可能已成功执行（“Error”参数未置位，“Done”参数置位），但不能设置 PLC 变量。因此，在示例中，会对 PLC变量进行检查，以确定程序是否能够设置有效值： • 如果服务器能够将新值分配给第一个 PLC变量，则“NodeStatusList”参数所指向数组的第 一个元素包含值 0。 在本示例中，仅使用一个变量。状态代码位于“Productionline_Data"."WriteListStatus".NodeStatusList[0]”中。 无法设置PLC 变量时，程序会输出错误消息。 “#State”变量的值加 1。这意味着将在下一周期执行下一程序段（示例 5：ReleaseHandle List）。 参见 客户端程序中的 OPC UA 指令 (页 5724)OPC_UA_NodeReleaseHandleList：释放用于读写访问的句柄。使用 OPC_UA_WriteList 写入数组区段(S7-1500) 简介 本部分基于“OPC_UA_WriteList”；请参见“OPC_UA_WriteList：写入变量(页 5808)”。 本部分介绍如何使用“OPC_UA_WriteList”指令为数组的一部分分配（写入）新值。 写入OPC UA 服务器数组的一部分的基本方法如下：以下说明假定： • 已组态一个 CPU 作为 OPC UA 服务器。该服务器提供的数组可由 OPC UA 客户端写入。 在该示例中，使用 "Productionline" CPU 为 OPC UA客户端提供数据块 “Data_from_OPC_UA_Clients”： • 已组态一个 CPU 作为 OPC UA 客户端。在客户端，已创建了一个客户端接口，参见“AUTOHOTSPOT”。 客户端接口包含一个数组形式的写入列表。该数组中只有一部分用于写入服务器上的数组。在本示例中，使用包含“WriteListStatus”写入列表的“Productionline”客户端接口：在服务器的“Serial_Number”数组中，新值将写入“Serial_Number[5]" ”到“Serial_Number[9]”。 调整写入列表数据类型和写入列表 DB“OPC_UA_WriteList”显示了如何使用“OPC_UA_WriteList”指令向整个标量（包含单个值的变量）和数组（包含多个值的变量）中写入新值。 以下部分提供使用 OPC_UA_WriteList 向数组的一部分写入新值时需要使用的“OPC_UA_WriteList”的更多详细信息。 步骤 1：复制并调整写入列表数据类型 首先，更改变量的数据类型，即为写入 OPCUA 服务器提供数值的变量。 必须进行此更改，因为 STEP 7 生成的数据类型过长。由于只向数组的一部分（而非整个数组）分配新值，所以数据类型过长。在本示例中，访问包含十个元素的数组 "Serial_Number”。因此，STEP 7 会生成含十个元素的数据类型。 要缩短数据类型，请按以下步骤操作： 1. 在“项目树”中，打开“PLC数据类型”(PLC data types) 文件夹。 2. 打开“系统数据类型”(System data types) 文件夹。 3.复制数据类型“.”。 在本示例中，数据类型名为“"Productionline.WriteListStatus”。 4.将复制的数据类型粘贴到“PLC 数据类型”(PLC data types) 文件夹。 5.更改插入的数据类型的名称，使其在项目中具有意义。在本示例中，该名称改为“myUDTProductionline.WriteListStatus”。 6. 更改数组的数据类型。在本示例中，我们要将 Serial_Number[5] 到 Serial_Number[9] 中的值写入 OPC UA 服务器。因此，将数据类型从“Array[0..9] of Lint”缩短至“Array[0..4] of Lintl”。 在本示例中： 第 2步：复制写入列表 DB，并为其应用新的写入列表数据类型 在此步骤中，在新数据块中使用新数据类型。 必须执行此步骤，因为 STEP 7生成的数据块中包含数组的原始数据类型。 无法更改数据类型：每次编译数据块时会恢复原始数据类型。更改丢失。要新建一个数据块，请按如下步骤操作： 1. 在“项目树”(Project tree) 区域中，选择作为客户端的 CPU。 2.打开“程序块”(Program blocks) 文件夹 3. 复制数据类型_Data在本示例中，数据块名为“Productionline_Data” 4. 将复制的数据块粘贴到“程序块”(Program blocks)文件夹。 5. 更改插入的数据块的名称，使其在项目中具有意义。在本示例中，该名称改为“myProductionline_Data”