配置插件

SIMATIC S7 插件的配置可在 MERLIC RTE Setup 的“通讯”选项卡中调整。在“通讯”选项卡中，可以添加 SIMATIC S7 插件实例、配置参数，并可以直接在用户界面中启动和停止插件。

在 MERLIC RTE Setup 中启用配置

要在 MERLIC RTE Setup 的“通讯”选项卡中启用插件的配置，首先必须启动 MERLIC RTE 并执行以下步骤：

  1. 打开 MERLIC RTE Setup 并转到“通讯”选项卡。如果 MERLIC RTE 未运行，您可以从“通讯”选项卡直接启动它。
  2. 将 SIMATIC S7 插件添加到左侧的插件实例列表。

  3. 确保插件当前未在运行。否则，参数将不可用于配置。可以通过插件实例列表中的相应状态图标查看插件的当前状态。如果状态显示 图标，表示插件正在运行。在这种情况下，必须通过单击 MERLIC RTE Setup 底部的“ 停止插件”按钮停止它。如果状态显示 图标，表示插件当前未在运行。在以下示例图像中，SIMATIC S7 插件的选定实例当前未在运行，因此可以进行配置。

  4. 选择左侧的 SIMATIC S7 插件，以显示其参数并开始配置。

选定 SIMATIC S7 插件的参数将显示在“通讯”选项卡的右侧。

Plug-in Parameters

此类型参数代表通讯插件中无法在“通讯”选项卡的配置区域中调整的一般参数。它们可显示插件的版本号、日志等级的当前参数值、插件的访问等级，以及插件配置的验证设置。这些值需要在不同的位置或通过不同的方法分别进行设置。

Version

此参数显示在插件实现期间定义的版本号。它由主要版本、次要版本和维护版本组成。添加新插件实例时也会显示此版本号。版本是可选的。因此，在实现过程中可能并未定义版本号。

Log level

此参数显示插件实例的日志等级。默认情况下，该日志等级会设置为在 MERLIC RTE Setup 中添加插件实例时的相应 MERLIC RTE 进程的日志等级。

Access level

此参数显示为插件设置的访问等级。对于 SIMATIC S7 插件，访问等级默认设置为“monitor and control”。这表示插件可以接收“事件”并发送“操作”。访问等级与插件实现中定义的功能相关。无法在 MERLIC RTE Setup 中调整访问等级。

Supports rapid validation

该参数显示插件是否支持立即验证当前的插件配置。对于这个插件，勾选复选框表示支持“快速验证”。这意味着，每次在 MERLIC RTE Setup 的“通讯”选项卡中修改任何可编辑参数时，都会验证插件的配置。如果插件不支持“快速验证”，则只有在保存配置时才会验证插件的配置。

User Parameters

“User parameters”代表可为插件配置的参数集。它们显示在可以展开或关闭的不同类别中。

以下部分介绍每个类别的参数。

Connection Details

此类别中的参数定义了连接到 PLC 的设置。有关如何设置与 PLC 的连接的更多信息，请参阅设置与 PLC 的连接。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

IP address

此参数定义要连接的 SIMATIC S7 PLC 的互联网协议地址（IP 地址）。默认情况下设置为“127.0.0.1”。此参数仅支持互联网协议版本 4 (IPv4) 地址。因此，不支持使用主机名。

Rack

此参数定义分配给 PLC 并用于连接的机架号。默认情况下设置为“0”。

Slot

此参数定义分配给 PLC 并用于连接的插槽编号。默认情况下设置为“1”。

System Operation

此类别中的参数定义与心跳模式相关的设置。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

Heartbeat interval

此参数定义心跳间隔，以毫秒为单位。默认情况下设置为 1000 毫秒。这意味着心跳计数器的“gMV_Heartbeat”字段每 1000 毫秒更新一次。有关心跳模式的更多信息，请参阅错误处理中的 gMV_Heartbeat 部分。

Result Handling Behavior

此类别中的参数定义与结果检索相关的设置。有关不同模式的结果处理的更多信息，请参阅结果模式。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

Result mode

此参数允许您选择查询结果的模式。您可以在“Free-running”与“Dequeue from buffer”之间进行选择。默认情况下，该参数设置为“Dequeue from buffer”。下表为每种模式提供了简短说明。

模式

描述

Free-running

在这种模式下，单次或连续执行的结果会立即写入 PLC 的相应内存地址，无需任何握手机制。此模式最快，但也最容易出错。根据 MERLIC 和 PLC 二者的时序，某些结果可能会在被 PLC 收集之前丢失或被覆盖。

Dequeue from buffer

在这种模式下，使用内部 FIFO 队列来保存启动单次或连续执行后传入的结果。如果 PLC 通过将“gMV_ReqCommandCode”设置为 10 来请求结果，则缓冲区中的第一个结果将被写入 PLC 的相应内存地址。然后，请求的结果会立即从队列中删除。
Result buffer capacity

此参数定义在使用“Dequeue from buffer”作为结果模式时用于临时存储结果的缓冲区大小。它表示可以保存在缓冲区中的结果数量。默认情况下设置为 10。

此参数仅在“Dequeue from buffer”设置为结果模式时使用。当“Result mode”设置为“Free-running”时，此参数无效。因此，如果选择“Free-running”模式，则无法配置此参数。

DequeueResult command timeout

此参数定义等待新结果时“Dequeue from buffer”模式的超时。如果 PLC 请求一个结果，而相应的结果还不可用，则所有其他请求都将被阻止，直至该结果可用或指定的超时到期为止。默认情况下，该超时设置为 1000 毫秒。

此参数仅在“Dequeue from buffer”设置为结果模式时使用。当“Result mode”设置为“Free-running”时，此参数无效。因此，如果选择“Free-running”模式，则无法配置此参数。

Writing Data to PLC Memory

此类别中的参数定义可传输到 PLC 的结果数量。您必须为每种数据类型分别设置所需的数量。确保配置适用于要使用的所有 MERLIC 配方，即适用于配方中引用的所有 MERLIC Vision Apps。

默认情况下不会将任何结果传输到 PLC。因此，您首先必须相应地调整此类别中的参数，并为每种数据类型设置所需的结果数量。

  1. 如果不确定所需的结果数量及其数据类型，可以按以下方法进行检查：
    1. 打开 MERLIC Creator 并加载 MERLIC 配方中引用的 MERLIC Vision App。
    2. 进入“MVApp 参数和结果”面板，查找要传输的每个 MVApp 结果的数据类型。注意每种数据类型所需的结果总数。这是插件配置中相应参数必须设置的最小值，以便传输所有所需的结果。
    3. 选中将使用的所有 MVApps 的 MVApp 结果，即您希望在应用程序中使用的 MERLIC 配方中引用的 MVApps。
  2. 在 MERLIC RTE Setup 的“通讯”选项卡中，选择所需的 SIMATIC S7 插件实例，并转到“Writing Data to PLC Memory”类别参数。
  3. 为该类别中的每个插件参数设置您希望传输的相应数据类型的结果数量。确保该值适合所有将使用的 MVApps。

例如，如果您的 MVApps 最多包含数据类型 INT 的五个 MVApp 结果，则必须将参数“Int (signed 16-bit integer) result allocation”设置为 5 或更高，以确保所有 INT 结果的值都提供给 PLC。

如果传输的特定数据类型的结果比插件配置中指定的要多，则并非所有参数都可用，因为 PLC 上没有保留足够的内存地址。相反，如果传输的结果少于为相应数据类型指定的数量，则并非 PLC 上保留的所有内存地址都会被使用。

通过设置该类别的用户参数，您可以定义每种数据类型可传输到 PLC 的结果数量。对于每个可传输的结果，都预留了一个所谓的字段。字段表示 PLC 上用于相应结果值的特定内存区块。然而，也有用于其他内容或命令的字段，例如，用于当前状态或请求命令的字段。每个字段都有预定义的名称，例如“gMV_CurrentState”。在 PLC 工程软件“TIA 门户 - SIMATIC STEP 7”中，这些名称被称为“标记”。有关可用字段的更多信息，请参阅用于与 PLC 通讯的字段。

插件会将所需字段分配到 PLC 上的特定内存地址范围。在 SIMATIC S7 协议中，内存按内存区域和内存地址（以字节为单位）寻址。目前，SIMATIC S7 插件只能读写 BitMemory 区域（%M 前缀）。不支持其他内存区域，如 Input、Output 或 DataBlock。根据将传输的结果数量及其数据类型，需要不同数量的内存。

数据类型所需的内存

下表列出了每种数据类型所需的内存，即不同数据类型的单个值所需的内存地址数量。

结果数据类型

所需的内存地址

（= 1 字节）

BOOL

1 位内存地址

INT

2

DINT

4

SINT

1

REAL

4

LREAL

8

WORD

2

DWORD

4

以下部分将举例说明如何配置插件，以便向 PLC 传输两个结果，并显示在 PLC 上分配了哪些字段。

如果您的 MVApp 恰好包含两个数据类型为 INT 的 MVApp 结果，而您又希望允许传输这两个结果，则需要在插件配置中设置相应的用户参数。由于结果的数据类型为 INT，因此必须设置参数“Int (signed 16-bit integer) result allocation”。在本例中，参数必须至少设置为 2，以确保 PLC 能够查询最多两个 INT 数据类型的结果。

保存插件配置后，可以按照参数类别“Export Tags”中的指定方式导出相应的字段集。在执行 PLC 程序时，导出的文件用作通讯所需的字段和内存区块的输入。对于我们的示例配置，插件将分配以下三个字段：

字段

描述

gMV_ResultUseArray_Int_0

此字段表示是否可查询 INT 结果。表示结果是否可用的字段始终位于结果值字段之前。

gMV_Result_Int_0

此字段用于索引为 0 的 INT 结果值。附加的编号与 MERLIC Creator 中 MVApp 结果概述中的结果索引相对应。因此，索引为 0 的 INT 结果代表 MVApp 结果概述中的第一个 INT 结果。

gMV_Result_Int_1

此字段用于索引为 1 的 INT 结果值。附加的编号与 MERLIC Creator 中 MVApp 结果概述中的结果索引相对应。因此，索引为 1 的 INT 结果代表 MVApp 结果概述中的第二个 INT 结果。

根据控件的大小（以字节为单位），这些字段将分别被分配到 PLC 上的三个地址，例如 %MW30、%MW32 和 %MW34。

如果只传输一个 INT 结果，则并非 PLC 上保留的所有寄存器都会被使用。然而，如果传输数据类型 INT 的两个以上结果，例如，因为准备的配方的 MVApp 包含两个以上 INT 结果，PLC 将只能查询前两个结果，因为插件只为两个 INT 结果保留了寄存器地址。

下图显示了参数的概览。图下有参数的详细说明。

Head tag offset

此参数定义在 PLC 上为由插件写入并由 PLC 读取的所有值（如当前状态和结果值）保留的内存区块的地址内存偏移。

默认情况下设置为 0，对应于 %M0。

Bool (Bit) result allocation

此参数定义可以传输到 PLC 的 Boolean 结果数量。例如，如果希望传输最多五个 Boolean 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_Bool”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_Bool_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 Boolean 结果。

这种数据类型的参数需要不多不少一个比特。因此，如果选择了最多 16 个结果，则会将一个比特的字地址（2 个字节）映射到Boolean结果的字段。给定内存区域内的单个结果使用位级特定表示法寻址，例如 %M30.0、%M30.1、...、%M31.0。如果分配了超过 16 个Boolean结果，则会映射另一个字地址（2 字节），以便为每个结果提供一个字段。

Byte (unsigned 8-bit integer) result allocation

此参数定义可以传输到 PLC 的 BYTE 结果数量。例如，如果希望传输最多五个 BYTE 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_Byte”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_Byte_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 BYTE 结果。

这种数据类型的参数需要不多不少一个字节。因此，内存区域的一个字节地址将映射到BYTE结果字段。给定内存区域内的单个结果使用字节特定表示法寻址，例如 %MB30、%MB31、...、%MB35。如果分配的字节数不均衡，将增加一个填充字节，以到达下一个字。

Word (unsigned 16-bit integer) result allocation

此参数定义可以传输到 PLC 的 WORD 结果数量。例如，如果希望传输最多五个 WORD 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_Word”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_Word_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 WORD 结果。

这种数据类型的参数需要不多不少两个字节。因此，内存区域的两个字节地址（一个WORD）将映射到WORD结果字段。给定集内的单个结果使用WORD特定表示法寻址，例如 %MW30、%MW32、...、%MW38。

DWord (unsigned 32-bit integer) result allocation

此参数定义可以传输到 PLC 的 DWORD 结果数量。例如，如果希望传输最多五个 DWORD 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_DWord”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_DWord_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 DWORD 结果。

这种数据类型的参数需要不多不少四个字节。因此，内存区域的四个字节地址（两个WORD）将映射到DWORD结果字段。给定集内的单个结果使用DWORD特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

SInt (signed 8-bit integer) result allocation

此参数定义可以传输到 PLC 的 SINT 结果数量。例如，如果希望传输最多五个 SINT 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_SInt”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_SInt_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 SINT 结果。

这种数据类型的参数需要不多不少一个字节。因此，内存区域的一个字节地址将映射到SINT结果字段。给定集内的单个结果使用字节特定表示法寻址，例如 %MB30、%MB31、...、%MB35。如果分配的 SINT 结果数不均衡，将增加一个填充字节，以到达下一个字。

Int (signed 16-bit integer) result allocation

此参数定义可以传输到 PLC 的 INT 结果数量。例如，如果希望传输最多五个 INT 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_Int”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_Int_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 INT 结果。

这种数据类型的参数需要不多不少两个字节。因此，内存区域的两个字节地址（一个WORD）将映射到 INT 结果字段。给定集内的单个结果使用WORD特定表示法寻址，例如 %MW30、%MW32、...、%MW38。

DInt (signed 32-bit integer) result allocation

此参数定义可以传输到 PLC 的 DINT 结果数量。例如，如果希望传输最多五个 DINT 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_DInt”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_DInt_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 DINT 结果。

这种数据类型的参数需要不多不少四个字节。因此，内存区域的四个字节地址（两个WORD）将映射到DINT结果字段。给定集内的单个结果使用DWORD特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

Real (single-precision floating-point) result allocation

此参数定义可以传输到 PLC 的 REAL 结果数量。例如，如果希望传输最多五个 REAL 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_Real”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_Real_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 REAL 结果。

这种数据类型的参数需要不多不少四个字节。因此，内存区域的四个字节地址（两个WORD）将映射到REAL结果字段。给定集内的单个结果使用DWORD特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

LReal (double-precision floating-point) result allocation

此参数定义可以传输到 PLC 的 LREAL 结果数量。例如，如果希望传输最多五个 LREAL 结果，请将参数设置为 5 或更高。

PLC 将保留并映射所需字段的内存区域地址。字段的标记名称将由前缀“gMV_Result_LReal”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_LReal_0”将用于此数据类型的第一个结果。

默认情况下，此参数设置为 0，表示不传输 LREAL 结果。

这种数据类型的参数需要 64 个比特，正好对应于内存区域的八个字节地址（四个WORD）。给定集内的单个结果使用位级特定表示法寻址，例如 %M30.0、%M38.0、...、%M62.0。

Reading Data from PLC Memory

此类别中的参数定义可向 PLC 提供的每个数据类型的迭代参数数量。迭代参数表示一个参数，该参数用作执行 MVApp 以覆盖准备的配方中给定的相应 MVApp 参数 的参数。这让您可以使用其他输入值运行 MVApp，而无需更改配方。因此，此类别中的用户参数定义 PLC 可为执行覆盖的每个数据类型的参数值数量。

默认情况下，PLC 没有可供配置的迭代参数。因此，您首先必须相应地调整此类别中的参数，并为每种数据类型设置所需的迭代参数数量。

如果要允许 PLC 覆盖执行的特定 MVApp 参数的值，则必须相应地设置相应数据类型的用户参数。

  1. 如果不确定所需的迭代参数数量及其数据类型，可以按以下方法进行检查：
    1. 打开 MERLIC Creator 并加载 MERLIC 配方中引用的 MERLIC Vision App。
    2. 进入“MVApp 参数和结果”面板，查找要通过 PLC 设置的每个 MVApp 参数的数据类型。注意每种数据类型所需的迭代参数总数。这是插件配置中相应参数必须设置的最小值，以便通过 PLC 设置所有所需的迭代参数。
    3. 选中将使用的所有 MVApps 的 MVApp 参数，即您希望在应用程序中使用的 MERLIC 配方中引用的 MVApps。
  2. 在 MERLIC RTE Setup 的“通讯”选项卡中，选择所需的 SIMATIC S7 插件实例，并转到“Reading Data from PLC Memory”类别参数。
  3. 为该类别中的每个插件参数设置您希望能够覆盖的迭代参数数量。确保该值适合所有将使用的 MVApps。

例如，如果您的 MVApps 最多包含数据类型 INT 的三个 MVApp 参数，则必须将参数“Int (signed 16-bit integer) iteration parameter allocation”设置为至少 3，以确保此数据类型的所有 MVApp 参数都可以通过 PLC 进行调整。

插件配置仅定义多少个迭代参数可供 PLC 用于覆盖执行中的相应 MVApp 参数。但是，不一定要使用指定的迭代参数。PLC 也可以在不使用迭代参数的情况下请求单次或连续执行。在这种情况下，将使用相应配方中定义的值来执行 MVApp。

当指定迭代参数以覆盖配方中的参数值时，PLC 需要考虑一些要求。指定参数值的数量需要与配方文件中定义的值的数量相对应。此外，其数据类型必须适合无损转换为配方中相应参数值的数据类型。如果不满足这些条件，则整个迭代参数集将被丢弃，并使用默认值执行配方。在这种情况下，还会在“gMV_ErrorCode”和“gMV_ErrorCause”字段上发出警告。有关更多信息，请参阅《通讯插件开发手册》中关于 Available Actions 中参数“MV_PARAM_START_PARAMS”的相应规则的描述。

通过设置该类别的用户参数，您可定义 PLC 可设置的每种数据类型的迭代参数数量。对于 PLC 可配置的每个迭代参数，都预留了一个所谓的字段。这意味着需要为迭代参数分配所需的内存。您可以通过将此类别中每个用户参数的值设置为 PLC 可用于相应数据类型的迭代参数数量来执行此操作。有关可用字段的更多信息，请参阅用于与 PLC 通讯的字段。

插件会将这些参数的所需字段分配到 PLC 上的特定内存地址范围。根据将传输的迭代参数数量及其数据类型，需要不同数量的内存，即内存区域中不同数量的地址。例如，一个数据类型为 INT 的参数只需要两个字节地址，而数据类型为 DINT 的参数则需要四个字节地址。如果传输的迭代参数少于为相应数据类型指定的数量，则并非 PLC 上保留的所有地址都会被使用。

有关每种数据类型所需内存的更多信息，请参阅类别“Writing Data to PLC Memory”描述中的字段和分配的内存部分。

下一节将举例说明如何配置插件以允许 PLC 覆盖迭代参数，并显示在 PLC 上分配了哪些字段。

如果您的配方包含数据类型 INT 的两个 MVApp 参数和数据类型 WORD 的一个 MVApp 参数，并且您希望使 PLC 能够为单次或连续执行覆盖这些参数的值，则必须设置以下参数：

用户参数

值

Int (signed 16-bit integer) iteration parameter allocation

2

Word (unsigned 16-bit integer) iteration parameter allocation

1

即使当前配方仅包含两个 INT 参数和一个 WORD 参数，也可以设置更高的值。但是，对于本示例，我们假设插件配置中的值是按照上表中所述进行设置的。

保存插件配置后，可以按照参数类别“Export Tags”中的指定方式导出相应的字段集。在执行 PLC 程序时，导出的文件用作通讯所需的字段和内存区块的输入。对于我们的示例配置，插件将分配以下字段：

分配的字段

描述

gMV_ItParamUseArray_Int_0

此字段将用作指示符，指示数据类型 INT 的配方参数是否将在下一次单次或连续执行时被“gMV_ItParam_Int_0”和“gMV_ItParam_Int_1”中定义的值覆盖。

gMV_ItParamUseArray_Word_0

此字段将用作指示符，指示数据类型 WORD 的配方参数是否将在下一次单次或连续执行时被“gMV_ItParam_Word_0”中定义的值覆盖。

gMV_ItParam_Int_0

此字段将用于定义数据类型 INT 和索引 0 的 MVApp 参数（即配方中的第一个 INT 参数）的新值。

作为后缀添加的数字表示配方参数的索引。在本示例中，它指的是数据类型 INT 的第一个配方参数。配方参数列表和相应的索引号也可以在 MERLIC Creator 中的 MVApp 参数 概述中看到。

gMV_ItParam_Int_1

此字段将用于定义数据类型 INT 和索引 1 的 MVApp 参数（即配方中的第二个 INT 参数）的新值。

如后缀 1 所示，此字段指的是数据类型 INT 的第二个配方参数。

gMV_ItParam_Word_0

此字段将用于定义数据类型 WORD 和索引 0 的 MVApp 参数（即配方中的 WORD 参数）的新值。

如后缀 0 所示，此字段指的是数据类型 WORD 的第一个配方参数。

然后，可以使用新字段来指定参数值，以用于执行准备的配方中引用的 MVApp。

对于我们的示例，假设准备了具有两个 INT 参数和一个 WORD 参数的配方。为了覆盖下一次执行的参数，PLC 必须将参数的所需值设置到相应的字段中，并指定所有三个参数值都应用于下一个“StartSingleJob”或“StartContinuous”命令。这表示 PLC 必须设置以下字段的值：

字段

描述

gMV_ItParamUseArray_Int_0

此数组中的前两位必须设置为 1（或设置为 TRUE）。这表示两个“gMV_ItParam_Int”值中的每一个都应该用于下一次执行。

gMV_ItParamUseArray_Word_0

此字段的值必须设置为 1（或设置为 TRUE）。这表示“gMV_ItParam_Word_0”中的值应该用于下一次执行。

gMV_ItParam_Int_0

此字段必须设置为应该用于第一个 INT 参数的整数值，而不是配方中定义的值。

gMV_ItParam_Int_1

此字段必须设置为应该用于第二个 INT 参数的整数值，而不是配方中定义的值。

gMV_ItParam_Word_0

此字段必须设置为应该用于第二个 WORD 参数的无符号整数值，而不是配方中定义的值。

当 PLC 请求新的“StartSingleJob”或“StartContinuous”命令时，插件会将迭代参数的指定值用于下一次执行。每次执行“StartSingleJob”和“StartContinuous”命令都将覆盖配方值，只要字段“gMV_ItParamUseArray_Int_0”和“gMV_ItParamUseArray_Word_0”如上所述设置，即直至其值重置为 0。如果没有迭代参数设置为“使用中”，则会再次使用配方中定义的默认值。

下图显示了参数的概览。图下有参数的详细说明。

Head tag offset

此参数定义在 PLC 上为由插件读取并由 PLC 写入的所有值（例如请求的命令和迭代参数值）保留的内存区块的地址内存偏移。默认情况下设置为 100，对应于 %M100。

使用“Writing Data to PLC Memory”部分中相应参数“Head tag offset”的默认设置，有 100 个字节可用于由插件写入协议的值区块。然而，这些并非在所有用例中都足够。例如，如果在执行 MVApp 时要传输大量结果，并且这些结果需要内存上的超过 100 个字节，则必须增加此类别“Reading Data from PLC Memory”中的“Head tag offset”。否则，由插件写入的区块和由 PLC 写入的区块将重叠，因为它们会尝试写入相同的地址。 为防止出现这种情况，如果“Reading Data from PLC Memory”中的“Head tag offset”设置得太低，MERLIC RTE Setup 会显示错误。 在这类情况下，最好尝试错误中给出范围之外的下一个地址，并检查这个地址是否合适。

或者，您也可以将该参数设置为较大的数字，以最大限度地减少内存重叠的可能性。但是，您还必须避免设置 PLC 有效地址范围之外的地址。可用内存的数量取决于 PLC 型号，并且无法从插件中提前查询。因此，在启动插件时，将首先检查此参数的设置并尝试与 PLC 通讯。一旦 PLC 尝试将值写入不可用的寄存器地址，就会发生错误。错误会在“gMV_ErrorCode”和“gMV_ErrorCause”字段上发出，并且这些错误还会记录在 MERLIC RTE 的日志文件中。

Polling cycle time for ReqCommandCode

此参数定义读取“gMV_ReqCommandCode”字段值的周期。

默认情况下设置为 40 毫秒，表示插件每 40 毫秒检查一次 PLC 是否请求了新命令。

Bool (Bit) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 Boolean 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 Boolean 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_Bool”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_Bool_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要不多不少 1 个比特。因此，一个比特的字地址（2 个字节）将映射到Boolean迭代参数的字段，最多 16 个参数。给定内存区域内的单个迭代参数使用位级特定表示法寻址，例如 %M30.0、%M30.1、...、%M31.0。如果分配了超过 16 个Boolean参数，则会映射另一个字地址（2 字节），以便为每个新的迭代参数提供一个字段。

此外，将添加另一个字段：“gMV_ItParamUseArray_Bool_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 Boolean 参数，则 PLC 需要将“gMV_ItParamUseArray_Bool_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

Byte (unsigned 8-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 BYTE 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 BYTE 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_Byte”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_Byte_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 1 个字节，正好对应于一个字节地址。给定集内的单个参数使用字节特定表示法寻址，例如 %MB30、%MB31、...、%MB38。

此外，将添加另一个字段：“gMV_ItParamUseArray_Byte_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 BYTE 参数，则 PLC 需要将“gMV_ItParamUseArray_Byte_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

Word (unsigned 16-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 WORD 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 WORD 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_Word”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_Word_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 16 个比特，正好对应于两个字节地址（一个WORD）。给定集内的单个参数使用字级特定表示法寻址，例如 %MW30、%MW32、...、%MW38。

此外，将添加另一个字段：“gMV_ItParamUseArray_Word_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 WORD 参数，则 PLC 需要将“gMV_ItParamUseArray_Word_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

DWord (unsigned 32-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 DWORD 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 DWORD 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_DWord”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_DWord_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 32 个比特，正好对应于四个字节地址（两个WORD）。给定集内的单个参数使用双字特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

此外，将添加另一个字段：“gMV_ItParamUseArray_DWord_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 DWORD 参数，则 PLC 需要将“gMV_ItParamUseArray_DWord_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

SInt (signed 8-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 SINT 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 SINT 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_SInt”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_SInt_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 1 个字节，正好对应于一个字节地址。给定集内的单个参数使用字节特定表示法寻址，例如 %MB30、%MB31、...、%MB38。

此外，将添加另一个字段：“gMV_ItParamUseArray_SInt_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 SINT 参数，则 PLC 需要将“gMV_ItParamUseArray_SInt_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

Int (signed 16-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 INT 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 INT 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_Int”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_Int_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 16 个比特，正好对应于两个字节地址（一个WORD）。给定集内的单个参数使用WORD特定表示法寻址，例如 %MW30、%MW31、...、%MW38。

此外，将添加另一个字段：“gMV_ItParamUseArray_Int_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 INT 参数，则 PLC 需要将“gMV_ItParamUseArray_Int_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

DInt (signed 32-bit integer) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 DINT 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 DINT 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_Result_DInt”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_Result_DInt_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 32 个比特，正好对应于四个字节地址（两个WORD）。给定集内的单个参数使用DWORD特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

此外，将添加另一个字段：“gMV_ItParamUseArray_DInt_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 DINT 参数，则 PLC 需要将“gMV_ItParamUseArray_DInt_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

Real (single-precision floating-point) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 REAL 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 REAL 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_Real”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_Real_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 32 个比特，正好对应于四个字节地址（两个WORD）。给定集内的单个参数使用DWORD特定表示法寻址，例如 %MD30、%MD34、...、%MD46。

此外，将添加另一个字段：“gMV_ItParamUseArray_Real_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 REAL 参数，则 PLC 需要将“gMV_ItParamUseArray_Real_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

LReal (double-precision floating-point) iteration parameter allocation

此参数定义可从 PLC 传输到 MERLIC 的 LREAL 数据类型迭代参数的数量。例如，如果要允许 PLC 覆盖配方中定义的最多五个 MVApp 参数的 LREAL 值，将此参数设置为 5。

PLC 将保留并映射所需字段的内存地址。字段的标记名称将由前缀“gMV_ItParam_LReal”加上相应 MVApp 结果的索引号组成。例如，此数据类型的第一个迭代参数值将使用“gMV_ItParam_LReal_0”。

默认情况下，此参数设置为 0，表示不会为此数据类型的任何参数添加字段。

这种数据类型的参数需要 64 个比特，正好对应于八个字节地址（四个WORD）。给定集内的单个参数使用位级特定表示法寻址，例如 %M30.0、%M38.0、...、%M62.0。

此外，将添加另一个字段：“gMV_ItParamUseArray_LReal_0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 LREAL 参数，则 PLC 需要将“gMV_ItParamUseArray_LReal_0”字段的值设置为 0b11（或用十六进制表示为 0x02）。

Export Tags

此类别中的参数定义启动插件时导出的文件的位置和名称。该文件基于插件配置并包含应由 PLC 保留的所有字段的全局标记名称。它包含一些始终导出的标准标记，例如用于请求命令的标记，以及用于在插件配置中定义的结果和迭代参数数量的标记。

该文件采用 .xml 文件格式，并可导入到 TIA 门户 - SIMATICSTEP 7 项目。

下图概述了参数以及相应的默认设置。图下有参数的详细说明。

Output directory

此参数定义保存文件的目录。您可以通过 按钮（在本地系统上）从文件系统中选择目录，也可以直接在文本字段中输入路径。默认情况下，该参数在 Windows 系统上设置为“%LOCALAPPDATA%/Temp”，在 Linux 系统上设置为“/tmp”。

Output file name

此参数定义导出文件的名称。您可以直接在文本字段中更改名称。默认情况下设置为“gMV_Tags”。

文件扩展名会自动附加到文件名中。如果手动添加任何其他文件扩展名，会将其替换为兼容的扩展名。