下文中将介绍如何使用该指令 此部分根据程序示例介绍指令“OPC_UA_NodeReleaseHandleList”在与OPC UA 服务器交换数 据的程序中的使用方法。 要求 以下说明假定： • 已创建了一个客户端接口。 • 已创建并组态与 OPCUA 服务器的连接，请参见“AUTOHOTSPOT”。此外，使用“OPC_UA_NodeReleaseHandleList”指令必须满足以下要求： • 提供与 OPC UA服务器建立连接的句柄。 用户可通过调用函数块“AUTOHOTSPOT”获取连接句柄。 •具有各变量的句柄列表，其变量值不再需要在程序中读取或写入。 用户可通过调用函数块“AUTOHOTSPOT”获取此句柄列表。 指令的功能调用“OPC_UA_NodeReleaseHandleList”指令可释放程序中不再需要的节点句柄。 节点句柄为在 OPC UA服务器中对节点（如 PLC 变量）的数值引用。 函数块需要哪些信息？ 该函数块需要以下信息： •各变量（或其它节点）的句柄列表，其变量值不再需要读取或写入（在“NodeHdls”参数 中）。
函数块会返回哪些信息？该函数块会返回以下信息： • 错误消息列表（“NodeStatusList”参数中）。此表中的每条错误消息都与“NodeHdls”参数中的对应句柄相关。 对于各节点句柄，用户需要检查 OPC UA 服务器是否能释放句柄。如果无法释放节点句柄，则用户程序必须捕获此错误：例如，在故障排除会话中再次调 用该指令。 已组态连接的使用方法 1.在“项目树”(Project tree) 区域中，选择将用作客户端的 CPU。 2. 在“程序块”(Program blocks)文件夹中，选择要用于执行客户端指令的函数块。 在该示例中，函数块名为“ReadFromProductionline”。选择的语言：SCL。 3. 使用拖放功能将“OPC_UA_NodeReleaseHandleList”指令从“指令 > 通信> OPC UA > OPC UA 客户端”(Instructions > Communication >OPC UA > OPC UA Client) 文件夹移到编辑器。 4. 选择该调用，作为多重实例。 STEP 7创建该指令的实例并将其命名为“OPC_UA_NodeReleaseHandleList_Instance”。 5.在“OPC_UA_NodeReleaseHandleList_Instance”指令中，单击图标“开始组态”(Startconfiguration)。 STEP 7 随即在巡视窗口中打开“组态”(Configuration) 选项卡。 6. 在“选择用于OPC UA 接口的客户端接口”(Select client interface for OPC UA interface) 下，选择要为指令使用的客户端接口。 在本示例中，客户端接口名为“Productionline”，为“AUTOHOTSPOT”而创建。 7.单击“数据访问”(Data access)，然后选择读取列表。 在该示例中，读取列表“ReadListProduct”。 STEP 7现在将自动为指令参数提供已为客户端接口组态的值。 8. 单击“块参数”(Block parameters)，然后为参数REQ、Busy、Done、Error 和 Status 手动分配 变量。 STEP 7 会将所选变量添加到函数调用中。调用指令（首次调用） 有关完整的程序，请参见“读取 PLC 变量的程序示例 (页 5926)”部分。程序示例使用的读取列表“ReadListProduct”包含以下 PLC 变量： • NewProduct •ProductNumber 这些 PLC 变量的句柄由以下程序示例释放。异步执行“OPC_UA_NodeReleaseHandleList”指令与用户程序异步执行，需要多个程序周期。通过“Busy”、“Done”、“Error”和“Status”参数，可检查作业的状态。有关异步程序执行的信息，请参见“同步指令和异步指令之间的不同之处 (页 715)”部分。 指令调用说明（首次调用）上图所示为示例 5。 程序的这一部分调用“OPC_UA_NodeReleaseHandleList”指令。这将释放 PLC变量的句柄。这 些变量列在“ReadListProduct”读取列表中。 如果指令未执行，#Busy 为FALSE，因此“#Req”变量会设为值 TRUE。这将启动指令的执行过 程。下一周期中，#Req 为FALSE。指令调用说明（故障排除） 如果发生错误，输出参数“Error”的值将设为 TRUE ，这会将 #State 变量的值设为100。该实 例将保留以接受故障排除。示例程序还调用了指令“OPC_UA_NodeReleaseHandleList”，以将 REQ参数设为 FALSE。 如果 TRUE 值在“Done”输出参数中，说明指令执行成功。注：该指令可能已成功执行（“Error”参数未置位，“Done”参数置位），但无法为 PLC 变量释放句柄。因此，在示例中会进行相应的检查，以确定是否已释放两个变量的句柄： • 如果服务器释放第一个 PLC变量的句柄，则“NodeStatusList”参数指向的数组的第一个元 素包含值 0。 在本示例中，状态代码位于"Productionline_Data"."ReadListProduct".NodeStatusList[0] 中。 •如果服务器释放第二个 PLC 变量的句柄，则“NodeStatusList”参数指向的数组的第二个元 素包含值 0。在本示例中，状态代码位于"Productionline_Data"."ReadListProduct".NodeStatusList[1] 中。如果同时满足两个条件，则变量“#State”的值加 1。这意味着将在下一周期执行下一程序段 （示例 6 - 关闭连接）。 有关示例 6的说明信息，请参见“AUTOHOTSPOT”。 说明 在示例 6 中，将启用与 OPC UA服务器的连接。这同样也将释放客户端程序在服务器中占用 的所有其它资源。如果要终止与服务器的连接，则用户程序可跳过示例 5 直接执行示例6。 参见 客户端程序中的 OPC UA 指令 OPC_UA_Disconnect：关闭连接 (S7-1500) 有效性除非另有说明，否则“OPC_UA_Disconnect”指令的以下说明适用于 S7-1500 CPU 固件版本 V2.6及更高版本。使用“OPC_UA_Disconnect”指令断开与 OPC UA 服务器的连接。 说明 固件版本 V2.8及更高版本的连接句柄 (ConnectionHdl) 处理 自固件版本 V2.8起，出现连接错误（错误代码“BadConnectionClosed”）后，必须通过指令“OPC_UA_Disconnect”明确关闭连接，从而再次释放连接资源。必须在用户程序中复位此无 效连接的ConnectionHdl。 下图显示了该指令在编辑器 (FBD) 中的图标。在上图中，尚未包含该指令的参数。 指令"OPC_UA_Disconnect" 用于断开与 OPC UA 服务器的连接，并终止会话，请参见下图中 的 ③：①准备读取和写入操作的指令 ② 读取和写入指令 ③ 完成读取或写入操作后释放资源的指令“OPC_UA_Disconnect”的参数 表格4-81 “OPC_UA_Disconnect”函数块的参数 参数 区域中的 声明 数据类型 含义 REQ Input BOOL参数中的上升沿 0 → 1 可触发该块的执行。 ConnectionHdl Input DWORD已建立连接的唯一标识符：连接句柄。 用户可通过调用函数块 OPC_UA_Connect 获取连接 句柄。 Timeout InputTIME 执行函数块的Zui长时间。 另请参见“OPC_UA_Connect：创建连接 (页 5741)”中该参数的具体说明。Done Output BOOL 用于块处理的状态参数 • 0：已中止块处理，尚未完成或尚未开始 • 1：已完成块处理，未出错注：即使“OPC_UA_Disconnect”指令的处理以 Done=1 完成，连接资源也会在约 60 秒的时间内保持占用状态，请参见“AUTOHOTSPOT”。 Busy Output BOOL 用于块处理的状态参数 • 0：尚未执行块 •1：当前正在执行块 Error Output BOOL 错误显示 • 0：无错误 • 1：发生错误。请参见“Status”参数。Status Output DWORD 请参见下文的“状态参数中的错误编号” 状态参数中的错误编号“Status”参数将提供指令执行过程中所发生错误的相关信息。 错误代码 （十六进制值） 错误名称 说明 0000_0000OpcUa_Good 已成功执行函数块。 0070_0000 - 在 REQ 中没有上升沿时首次调 用，表示未开始执行作业。