UA_NamespaceGetIndex (S7-1200, S7-1500) 功能 (S7-1200, S7-1500)块的功能 通过 UA_NamespaceGetIndex 块，您可以获取所连的 UA 服务器的命名空间 URI 的命名空间 索引。参数声明 S7 数据类 型 取值范围 含义 Timeout IN TIME 5000 .. 120000建立连接的Zui长时间（单位：毫秒）。如果 超出该值，则中止块的处理，错误编号 B0007001。 如果输入的值超出允许范围，则使用默认值 60000（60 秒）。 ConnectionHdl OUT DWORD 1 .. 5 已建立的连接的唯一标识符其它块需要将其作为输入参数。 Done OUT BOOL 0, 1 块处理的状态参数 • 0：块执行中止、未完成或未启动 •1：无错完成块处理 Busy OUT BOOL 0, 1 块处理的状态参数 • 0：当前未处理块 • 1：块执行当前正在进行Error OUT BOOL 0, 1 错误代码 • 0：无错误 • 1：已发生错误。请参见“参数 “ErrorID””。ErrorID OUT DWORD 请参见“含义” “错误”(Error) = 1 时，输出错误编号。 有关编号的意义，请参见错误编号(页 6014)部分。 注：如果输出错误代码 B000F002，则 OPC UA 会话尚未建立。重新调用块。
参数(S7-1200, S7-1500) 块参数 下表介绍了程序块的形式参数。 表格 4-99 块UA_NamespaceGetIndex 的参数 参数 声明 S7 数据类 型 取值范围 含义 Execute IN BOOL 0,1 参数的上升沿 0 → 1 启动块的处理。只要 Execute = 1，其它输入参数均不能更改。 ConnectionHdl INDWORD 1 .. 5 UA_Connect 提供的连接标识符 NamespaceUri IN STRING Zui多 254 个字符指定目标服务器的地址（命名空间 URI） 带有 CP 443‑1 OPC UA 的 S7‑400 中的 CPU 符号的命名空间示例：http://www.siemens.com/simatic-classics7-opcua Timeout IN TIME5000 .. 120000 建立连接的Zui长时间（单位：毫秒）。如果 超出该值，则中止块的处理，错误编号B0007001。 如果输入的值超出允许范围，则使用默认 值 60000（60 秒）。 NamespaceIndex OUT WORD0 .. 65535 “NamespaceUri”参数指定的命名空间的命 名空间索引的输出。 OPC基金会保留并指定命名空间索引 0 和 1。 Done OUT BOOL 0, 1 块处理的状态参数 • 0：块执行中止、未完成或未启动• 1：无错完成块处理。参数 声明 S7 数据类 型 取值范围 含义 Busy OUT BOOL 0, 1 块处理的状态参数 •0：当前未处理块 • 1：块执行当前正在进行 Error OUT BOOL 0, 1 错误代码 • 0：无错误 •1：已发生错误。请参见“参数 “ErrorID””。 ErrorID OUT DWORD 请参见“含义” “错误”(Error) =1 时，输出错误编号。 有关编号的意义，请参见错误编号 (页 6014)部分。 UA_NodeGetHandleList(S7-1200, S7-1500) 功能 (S7-1200, S7-1500) 块的功能 通过UA_NodeGetHandleList 块，您可以在所连的 UA 服务器上注册 nodeID。 UA服务器返回句柄。这些句柄由具有“NodeHdls”参数的块输出。您可以通过块“UA_ReadList”和“UA_WriteList”在其输入参数“NodeHdls”处访问节点句柄的数据项。您必须了解在“NodeIDs”输入参数中指定的目标服务器的 nodeID。您可以将它们保存在 UDT “UANodeID”中。输入参数“NodeIDCount”处目标节点的数量始终是 1，所以您需要为每个 nodeID 单独调用该 块。参数 (S7-1200,S7-1500) 块参数 下表介绍了程序块的形式参数。 表格 4-100 块 UA_NodeGetHandleList 的参数 参数声明 S7 数据类 型 取值范围 含义 Execute IN BOOL 0, 1 参数的上升沿 0 → 1启动块的处理。 ConnectionHdl IN DWORD 1 .. 5 UA_Connect 提供的连接标识符NodeIDCount IN WORD 1 “NodeIDs”的数据区中的元素数量该数量必 须为 1。 NodeIDs INARRAY of UDT 请参见“含义” 服务器的目标节点的参数结构。 NodeID 的数量 (1) 必须与输出参数“NodeHdls”处的数量相同。 有关 UDT 结构的信息，请参见 UANodeID (页 6010)部分。Timeout IN TIME 5000 .. 120000 建立连接的Zui长时间（单位：毫秒）。如果超出该值，则中止块的处理，错误编号 B0007001。 如果输入的值超出允许范围，则使用默认 值 60000（60 秒）。NodeHdls OUT ARRAY of DWORD 0 .. 4 294 967 295服务器分配的作为客户端查询的回复的句柄 的数组。该句柄用于对服务器上的数据项进 行唯一标识。 在通过调用UA_NodeReleaseHandleList 块 将句柄释放之前，句柄保持有效，释放后即 变为无效。 会话终止时，CP会取消该会话的所有已注 册节点句柄。 该参数用于“UA_ReadList”和“UA_WriteList”块的输入参数“NodeHdls”。 Done OUT BOOL 0, 1 块处理的状态参数 • 0：块执行中止、未完成或未启动 •1：无错完成块处理参数 声明 S7 数据类 型 取值范围 含义 Busy OUT BOOL 0, 1 块处理的状态参数 •0：当前未处理块 • 1：块执行当前正在进行 Error OUT BOOL 0, 1 错误代码 • 0：无错误 •1：已发生错误。请参见“参数 “ErrorID””。 ErrorID OUT DWORD 请参见“含义” “错误”(Error) =1 时，输出错误编号。 有关编号的意义，请参见错误编号 (页 6014)部分。 NodeErrorIDs OUT ARRAYof DWORD 请参见“含义” 包含块“NodeIDs”数据区所有元素的错误编 号。 有关编号的意义，请参见错误编号(页 6014)部分。 UA_NodeReleaseHandleList (S7-1200, S7-1500) 功能(S7-1200, S7-1500) 块的功能 通过 UA_NodeReleaseHandleList 块，您可以在所连的 UA服务器上释放当前会话的节点句 柄。这会删除列表。输入参数“NodeHdls”引用写入了“UA_NodeGetHandleList”块的输出参数“NodeHdls”的句柄的 数据块。输入参数“NodeHdlCount”处的句柄的数量始终是 1，所以您需要为每个句柄单独调用该块。参数 (S7-1200,S7-1500) 块参数 下表介绍了程序块的形式参数。 表格 4-101 块 UA_NodeReleaseHandleList 的参数参数 声明 S7 数据类 型 取值范围 含义/说明 Execute IN BOOL 0, 1 参数的上升沿0 → 1 启动块的处理。 ConnectionHdl IN DWORD 1 .. 5 UA_Connect提供的连接标识符 NodeHdlCount IN WORD 1 “NodeHdls”的数据区中的元素数量该数量 必须为 1。NodeHdls IN ARRAY of DWORD 0 .. 4 294 967 295要取消的句柄的 ID 数组。 如果成功执行该块，该句柄将在服务器上取 消，因此编程无效。 Timeout IN TIME5000 .. 120000 建立连接的Zui长时间（单位：毫秒）。如果 超出该值，则中止块的处理，错误编号B0007001。 如果输入的值超出允许范围，则使用默认 值 60000（60 秒）。 Done OUT BOOL 0, 1块处理的状态参数 • 0：块执行中止、未完成或未启动 • 1：无错完成块处理 Busy OUT BOOL 0, 1 块处理的状态参数• 0：当前未处理块 • 1：块执行当前正在进行 Error OUT BOOL 0, 1 错误代码 • 0：无错误 •1：已发生错误。请参见“参数 “ErrorID””。 ErrorID OUT DWORD 请参见“含义” “错误”(Error) =1 时，输出错误编号。 有关编号的意义，请参见错误编号 (页 6014)部分。 NodeErrorIDs OUT ARRAYof DWORD 请参见“含义” 包含“NodeHdls”数据区所有元素的错误代 码。UA_Disconnect (S7-1200,S7-1500) 功能 (S7-1200, S7-1500) 块的功能 通过 UA_Disconnect 块，您可以终止作为 OPCUA 客户端的 CP 与 UA 服务器之间的现有连接。 这将结束现有会话。 参见 OPC UA 客户端的程序块(页 5986) 参数 (S7-1200, S7-1500) 块参数 下表介绍了程序块的形式参数。 表格 4-102 块UA_Disconnect 的参数 参数 声明 S7 数据类 型 取值范围 含义 Execute IN BOOL 0, 1参数的上升沿 0 → 1 启动块的处理。 ConnectionHdl IN DWORD 1 .. 5UA_Connect 提供的连接标识符 Timeout IN TIME 5000 .. 120000建立连接的Zui长时间（单位：毫秒）。如果 超出该值，则中止块的处理，错误编号 B0007001。 如果输入的值超出允许范围，则使用默认值 60000（60 秒）。 Done OUT BOOL 0, 1 块处理的状态参数 • 0：块执行中止、未完成或未启动 •1：无错完成块处理 Busy OUT BOOL 0, 1 块处理的状态参数 • 0：当前未处理块 • 1：块执行当前正在进行。