SIEMENS西门子 S120伺服电机 1FK7022-5AK71-1HG3-Z

                ResolveSymbols：解析多个符号 (S7-1500) 说明 “解析多个符号”指令用于解析多个符号变量名称。执行该指令后，会收到对变量的引用。引 用属于类型化指针，可用于对变量进行读写访问。 在 "nameList" 参数中指定 Array of WSTRING 。运行期间会通过此数组传送待解析的变量名称。 该数组可位于优化的存储区或非优化存储区中。 在参数 "referenceList" 中指定保存引用的 Array of ResolvedSymbol (SDT)。ARRAY 需位于优 化存储区中。这两个数组的限值需相同。 符号变量名称以 WSTRING 格式传输，且长度不得超过 254 个 UTF-16 字符。输入完全限定 的名称（包括命名空间）。不支持表示本地变量的限定符 #。支持数组中的元素，但必须指 定固定下标才能访问元素。不支持通过可变下标（如myArray[myIndexTag]）进行访问。 完全限定名称示例： myNamespace.mySubnamespace.myDataBlock.myArray[7,12,1] 使用 "firstIndex" 和 "lastIndex" 参数，可以仅解析列表中的部分符号。要解析整个符号列表， 可在 "firstIndex" 参数中指定下限，在 "lastIndex" 参数中指定上限。 该指令以异步方式执行。参数“"execute"”出现信号上升沿时开始执行。该指令在执行过程中 (Busy = 1)，"nameList" 和 "referenceList" 参数中的值无法更改。对符号进行解析前，"referenceList" 参数中位于指定数组范围（"firstIndex"和 "lastIndex"）内 的数组的值将复位。 该指令执行完成后，"done" 参数值将在一个周期内为 1。参数 "referenceList" 中的数组会填 入对变量的引用。 “execute”参数出现下降沿后，表示“ResolveSymbol”的实例不再处于激活状态。 说明 组态限值 每次Zui多可激活 10 条 "ResolveSymbols" 指令。该指令的所有活动实例总共可解析Zui多 2000 个符号。系统数据类型 ResolvedSymbol (S7-1500) 说明 执行“运行期间进行符号化访问”功能需要使用系统数据类型 "ResolvedSymbol"。该数据类 型会保存对 PLC 程序中变量的引用，并会保存用于生成这些引用的状态信息。系统数据类型 需位于优化存储器中。 在固件版本 V3.0 及以上版本，系统数据类型“ResolvedSymbol”可声明为 PLC 数据类型的元 素。 说明 查询被引用变量的数据类型 可以使用“TypeOf”指令查询“ResolvedSymbol”引用的变量的数据类型。 另请参见“TypeOf：检查数据类型为 VARIANT 或 ResolvedSymbol 的变量 (页 2076)”如果操作数“#Input_Execute”的信号状态更改为“1”，则该指令开始执行。对参数 "nameList" 中的变量名称进行解析，并将变量引用写入参数 "referenceList" 中的操作数 "#InOut_ResolvedSymbols"。该指令执行完成后，"done" 参数值将在一个周期内为 1。系统数据类型的结构 "ResolvedSymbol" 系统数据类型具有以下可见元素： 参数名称 数据类型 说明 resolved BOOL 指示符号是否成功解析： • 已解析 = FALSE，且 STATUS = 0 => 尚未执行符号解析。 • 已解析 = FALSE + status <> 0 => 符号解析失败 status 参数的值指示变量中无法解析的结构等 级。 负值表示无法解析符号，原因包括超出范围等。 正值表示变量不可访问或不可通过 HMI/OPC UA 或 Web API 写入。 • 已解析 = TRUE，且 STATUS = 0 => 符号已成功解析。 • 已解析 = TRUE，且状态 <> 0 => 符号已成功解析，但该 DB 由“RUN”模式下 的后续加载结果覆盖。 status INT "resolved" 元素用于指示某个符号是否已成功解析。只有成功解析符号时，STATUS 参数的值 才能为“0”，且 "ResolvedSymbol" 结构中包含正确的信息。 除了这两个参数之外，系统数据类型还包含用于保存变量数据类型、长度和地址信息的内部 参数，但这些参数不可访问。 如果符号解析错误，则 "status" 参数将返回以下值：系统数据类型“ResolvedSymbol”中的无效引用 如果在 RUN 模式下因加载导致被引用的变量覆盖，则 SDT "ResolvedSymbol" 中的引用可能 变为无效。引用可能指向不存在的变量。"status" 参数中的错误代码指示引用无效。 以下示例中显示了出错时如何中断 Move 指令的执行以及如何重新解析该符号：在调用 „MoveResolvedSymbolsToBuffer“ 指令之前，需进行检查，确定符号解析是否成功以 及 „MoveResolvedSymbolsToBuffer“ 是否可以执行。 即使符号解析成功，执行 „MoveResolvedSymbolToBuffer“ 时也可能出错。例如，在 RUN 模 式下因加载导致变量覆盖。此时，返回值 „err“ 为复制失败的进程数。 如果识别到复制过程识别，则后续的 IF 指令将 "EnableMove" 设置为 FALSE。这样，系统将 不再执行 "MoveResolvedSymbolsToBuffer"。 之后，FOR 指令将进行检查，确定产生错误代码的相关符号。对于这些符号，会将错误代码 复制到 "status" 参数中。 同时，参数“„resolved“”设置为 FALSE。现在需要再次使用异步操作指令 „ResolveSymbols“ 解 析符号。MoveToResolvedSymbol：将值写入已解析的符号中 (S7-1500) 说明 使用“将值写入已解析的符号中”指令读取变量值，并将其写入由已解析符号引用的目标变 量中。 SRC 参数的数据类型为 VARIANT。指向读取的变量。 DST 参数的数据类型为 ResolvedSymbol。指向 PLC 程序中写入的变量。之前必须已使用 “"ResolveSymbols"”指令对变量进行解析。 源变量和目标变量的数据类型必须相同。 说明 查询被引用变量的数据类型 执行“将值写入已解析的符号中”之前，可以使用 "TypeOf" 指令查询“ResolvedSymbol”引用 的变量的数据类型。 另请参见“TypeOf：检查数据类型为 VARIANT 或 ResolvedSymbol 的变量 SDT“ResolvedSymbol”中的引用无效 如果在 RUN 模式下因加载导致被引用的变量覆盖，则 SDT "ResolvedSymbol" 中的引用可能 变为无效。引用可能指向不存在的变量。“status”参数中的错误代码指示引用无效。 此时，需使用“ResolveSymbols”指令对该符号进行重新解析。”MoveFromResolvedSymbol：从已解析的符号中读取值 (S7-1500) 说明 使用“从已解析的符号中读取值”指令读取已解析符号引用的变量值，并将其写入目标变量 中。 "SRC" 参数的数据类型为 ResolvedSymbol。指向 PLC 程序中读取的变量。之前必须已使用 “"ResolveSymbols"”指令对变量进行解析。"DST" 参数的数据类型为 VARIANT. 。该参数指向写入的变量。 源变量和目标变量的数据类型必须相同。 说明 查询被引用变量的数据类型 执行“将值写入已解析的符号中”之前，可以使用 "TypeOf" 指令查询“ResolvedSymbol”引用 的变量的数据类型。 另请参见“TypeOf：检查数据类型为 VARIANT 或 ResolvedSymbol 的变量”MoveResolvedSymbolsToBuffer：从已解析的符号中读取值并写入缓冲区中 (S7-1500) 说明 “从已解析的符号中读取值并写入缓冲区中”指令用于从多个已解析的符号中读取数值并写 入存储区 (Array of BYTE) 中。采用这种方式，可准备符号解析后的相应值，进行后续处理。 如，通过诸如 TSEND 等通信指令进行发送。 "src" 参数是一个 ResolvedSymbol (SDT) 数组，其中包含对之前通过“ResolveSymbols”指令解 析的变量的引用。在“dst”参数中指定一个 BYTE 数组。该数组用作写入变量值的目标缓冲区。 这两个数组的限值需相同。 使用参数 "firstIndex" 和 "lastIndex" 限制将在此次指令调用过程中复制的值列表。在后续的 调用过程中，可复制其它已解析符号的值。如果不希望对列表进行限制，则 "firstIndex" 参 数中的值必须等于该列表的下限且 "lastIndex" 参数中的值需等于该列表的上限。"mode" 参数的值用于定义 "dst" 参数中的存储器格式。 可通过偏移量确定目标缓冲区中已解析的符号值的存储位置。通过“dstOffsets”(Array of DINT) 参数指定偏移量。每个偏移量均为位偏移，用于确定将值写入缓冲区时的起始位。可在一个 字节中存储多个 BOOL 数据类型的值。其它所有数据类型的值的起始位位置必须可被 8 整除。 例如，如果 "src[i]" 参数引用一个数据类型为 REAL 的变量，同时"dstOffsets[i]"参数中的值为 88，"mode" 参数值为 2#1，则“从已解析的符号中读取值并写入缓冲区中”指令会将值复 制到字节 11 到 14 中（从Zui低有效字节开始）。 例如，如果 "src[i]" 参数引用一个数据类型为 BOOL 的变量，同时 "dstOffsets[i]" 参数中的值 为 29，则“从已解析的符号中读取值并写入缓冲区中”指令会将该值复制到字节为 3 并且 偏移量为 5 的目标存储器。 为确保 "dstOffsets[i]" 中包含有 "src[i]" 的偏移量，"dstOffsets" 和 "src" 处的数组限值必须相 同。 这样，可准确定义目标缓冲区的结构。但请注意，该指令不会验证所指定的偏移量是否重叠。 此时，不会发送错误消息，而且目标缓冲区中的内容不确定。 目标缓冲区中的内容同样取决于这是值从优化存储器中读取，或是从非优化存储器中。这两 个存储区对字节填充的规则不同。有关字节填充的更多信息，请参见“另请参见”。 "status" 参数是一个 INT 数组。为确保 "status[i]" 中包含有 "src[i]" 的状态，该参数的限值必 须与 "src" 和 "dstOffsets" 参数的相同。 对于 WSTRING 和 STRING，将复制源字符串的当前长度。如果源字符串比目标字符串短，则 目标字符串中的其余字符保持不变。 说明 SDT“ResolvedSymbol”中的引用无效 如果在 RUN 模式下因加载导致被引用的变量覆盖，则 SDT "ResolvedSymbol" 中的引用可能 变为无效。引用可能指向不存在的变量。“status”参数中的错误代码指示引用无效。 此时，需使用“ResolveSymbols”指令对该符号进行重新解析。