配置插件

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

在 MERLIC RTE Setup 中启用配置

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

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

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

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

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

Plug-in Parameters

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

Version

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

Log level

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

Access level

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

Supports rapid validation

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

User Parameters

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

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

Ethernet Connection Details

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

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

IP address

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

Port

此参数定义用于连接的端口。默认情况下设置为“502”。

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 的“通讯”选项卡中，选择所需的 MODICON®* 插件实例，并转到“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”。在 Schneider Electric 的 PLC 工程软件“EcoStruxure™ Machine Expert - Basic”中，这些名称定义为“符号”。有关可用字段的更多信息，请参阅用于与 PLC 通讯的字段。

插件会将所需字段分配到 PLC 上的特定寄存器地址范围。根据将传输的结果数量及其数据类型，需要不同数量的内存，即不同数量的寄存器地址。

数据类型所需的内存

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

结果数据类型

所需的寄存器地址

（= 2 字节）

BOOL

1 位寄存器地址

INT

1

DINT

2

REAL

2

LREAL

4

STRING[80]

40

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

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

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

字段

描述

GMV_RESULTUSEARRAY_INT_W0

此字段表示是否可查询 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、%MW31 和 %MW32。

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

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

Head Holding Register address

此参数定义在 PLC 上保留的区块的第一个“Holding Register Address”。此区块包含由插件写入并由 PLC 读取的所有值，例如当前状态和结果值。

默认情况下设置为 0，对应于 PLC 上的 %MW0。

BOOL (Bit) result allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_RESULT_BOOL”加上相应 MVApp 的索引组成。例如，“GMV_RESULT_BOOL_0”将用于此数据类型的第一个结果。

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

这种数据类型的参数需要不多不少一个比特。因此，如果选择了最多 16 个结果，则会将一个比特的寄存器地址映射到 Boolean 结果的字段。给定寄存器内的单个结果使用十六进制数字进行寻址，如 %MW35:X0。如果返回超过 16 个Boolean结果，则会映射更多的寄存器地址，以便为每个结果提供一个字段。

INT (signed 16-bit integer) result allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_RESULT_INT”加上相应 MVApp 的索引组成。例如，“GMV_RESULT_INT_0”将用于此数据类型的第一个结果。

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

这种数据类型的参数需要 16 个比特，正好对应于一个寄存器地址，如 %MW36。

DINT (signed 32-bit integer) result allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_RESULT_DINT”加上相应 MVApp 的索引组成。例如，“GMV_RESULT_DINT_0”将用于此数据类型的第一个结果。

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

这种数据类型的参数需要 32 个比特，正好对应于两个寄存器地址。因此，保留两个寄存器，但仅映射第一个的地址，例如，如果使用地址 %MD37 和 %MD38，则映射 %MD37。地址的前缀“%MD”也表示此数据类型的参数通过双字映射。

REAL (single-precision floating-point) result allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_RESULT_REAL”加上相应 MVApp 的索引组成。例如，“GMV_RESULT_REAL_0”将用于此数据类型的第一个结果。

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

这种数据类型的参数需要 32 个比特，正好对应于两个寄存器地址。因此，保留两个寄存器，但仅映射第一个的地址，例如，如果使用地址 %MF39 和 %MF40，则映射 %MF39。地址的前缀“%MF”也表示此数据类型的参数通过双字映射。

STRING[80] result allocation

此参数定义可以传输到 PLC 的 STRING[80] 结果数量。例如，如果希望传输最多五个 STRING[80] 结果，请将参数设置为 5 或更高。PLC 将保留并映射所需字段的寄存器地址。

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

这种数据类型的参数需要 80 个字节（640 个比特），正好对应于 40 个寄存器地址。它们通过单个 WORDS 序列映射，例如 %MW41 到 %MW80，每个序列对应于 ASCI 字符的两个字节。字段的符号由几个部分组成。第一个部分是前缀“GMV_RESULT_STRING80”，表示此字段引用数据类型 STRING[80] 的结果。第二个部分是相应 MVApp 结果的索引。最后的第三个部分是后缀，由字符“W”和索引号组成，该索引号指示相应字段引用包含 STRING[80] 值的 40 个寄存器中的哪一个。

例如，带有符号“GMV_RESULT_STRING80_0_W0”的字段引用为第一个 STRING[80] 结果保留的第一个寄存器地址。因此，它将用于第一个 STRING[80] 结果的前两个字节的值。“GMV_RESULT_STRING80_0_W0”到“GMV_RESULT_STRING80_0_W39”字段则表示为第一个 STRING[80] 结果的值保留的寄存器。

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 的“通讯”选项卡中，选择所需的 MODICON®* 插件实例，并转到“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 参数和数据类型 STRING_80 的一个 MVApp 参数，并且您希望使 PLC 能够为单次或连续执行覆盖这些参数的值，则必须设置以下参数：

用户参数

值

INT (signed 16-bit integer) iteration parameter allocation

2

STRING[80] iteration parameter allocation

1

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

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

分配的字段

描述

GMV_ITPARAMUSEARRAY_INT_W0

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

GMV_ITPARAMUSEARRAY_STRING80_W0

此字段将用作指示符，指示数据类型 STRING_80 的配方参数是否将在下一次单次或连续执行时被覆盖。此数据类型的参数通过在 40 个寄存器地址中定义的单个 WORDS 序列进行映射。因此，如果相应地设置了“GMV_ITPARAMUSEARRAY_STRING80_W0”，配方参数将被通过 40 个字段“GMV_ITPARAM_STRING80_0_W0”到“GMV_ITPARAM_STRING80_0_W39”定义的值覆盖。

GMV_ITPARAM_INT_0

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

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

GMV_ITPARAM_INT_1

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

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

GMV_ITPARAM_STRING80_0_W0 ... GMV_ITPARAM_STRING80_0_W39

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

为 STRING_80 参数保留的字段后缀由两个部分组成。像其他数据类型一样，第一个部分表示配方参数的索引号。第二个部分表示相应字段引用定义 STRING[80] 值的 40 个 WORDS 中的哪一个。在本示例中，索引号 0 指示字段引用数据类型 STRING_80 的第一个配方参数。字段“GMV_ITPARAM_STRING80_0_W0”的最后一部分“W0”表示该字段引用 STRING_80 值的前两个字节，而字段“GMV_ITPARAM_STRING80_0_W39”中的“W39”表示该字段引用 STRING_80 值的最后两个字节。

这些字段分配到 PLC 上的 44 个连续寄存器地址，例如，%MW104、%MW105、%MW106、%MW107 和 %MW108 到 %MW147。

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

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

字段

描述

GMV_ITPARAMUSEARRAY_INT_W0

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

GMV_ITPARAMUSEARRAY_STRING80_W0

此字段的值必须设置为 1。这表示由字段“GMV_ITPARAM_STRING80_0_W0”到“GMV_ITPARAM_STRING80_0_W39”中的 WORDS 序列定义的值应该用于下一次执行。

GMV_ITPARAM_INT_0

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

GMV_ITPARAM_INT_1

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

GMV_ITPARAM_STRING80_0_W0 ... GMV_ITPARAM_STRING80_0_W39

这些字段中的 WORDS 序列必须设置为应该用于第一个 STRING_80 参数的字符串，而不是配方中定义的值。

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

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

Head Input Register address

此参数定义在 PLC 上保留的区块的第一个“Input Register Address”。此区块包含由 PLC 写入并由插件读取的所有值，例如请求的命令和迭代参数的值。默认情况下设置为 100，对应于 PLC 上的 %MW100。

使用“Writing Data to PLC Memory”部分中相应参数 Head Holding Register address 的默认设置，有 100 个寄存器地址可用于插件写入的值区块。然而，这些并非在所有用例中都足够。例如，如果在执行 MVApp 时要传输大量结果，并且这些结果需要内存上的超过 100 个寄存器地址，则必须增加“Head Input Register address”。否则，由插件写入的区块和由 PLC 写入的区块将重叠，因为它们会尝试写入相同的地址。 为防止出现这种情况，如果“Reading Data from PLC Memory”中的“Head Input Register address”设置得太低，MERLIC RTE Setup 会显示错误。

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

Polling cycle time for ReqCommandCode

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

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

BOOL (Bit) iteration parameter allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_ITPARAM_BOOL”加上相应 MVApp 的索引组成。例如，此数据类型的第一个迭代参数值将使用“GMV_ITPARAM_BOOL_0”。

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

这种数据类型的参数需要不多不少 1 个比特。因此，寄存器地址的单个位被映射到 Boolean 参数的字段，最多 16 个参数。给定寄存器内的单个迭代参数使用十六进制数字进行寻址，如 %MW109:X0。如果定义了超过 16 个 Boolean 参数，则会映射另一个寄存器地址，以便为每个迭代参数提供一个字段。

此外，将添加另一个字段：“GMV_ITPARAMUSEARRAY_BOOL_W0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。此字段的符号由两个部分组成。第一个部分是前缀“GMV_ITPARAMUSEARRAY_BOOL”，表示此字段引用数据类型 Boolean 的迭代参数。第二个部分是后缀“W0”，指保留的两个寄存器地址中的第一个。

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

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 个比特，正好对应于一个寄存器地址，如 %MW110。

此外，将添加另一个字段：“GMV_ITPARAMUSEARRAY_INT_W0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。此字段的符号由两个部分组成。第一个部分是前缀“GMV_ITPARAMUSEARRAY_INT”，表示此字段引用数据类型 INT 的迭代参数。第二个部分是后缀“W0”，指保留的两个寄存器地址中的第一个。

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

DINT (signed 32-bit integer) iteration parameter allocation

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

PLC 将保留并映射所需字段的寄存器地址。字段的符号将由前缀“GMV_ITPARAM_DINT”加上相应 MVApp 的索引组成。例如，此数据类型的第一个迭代参数值将使用“GMV_ITPARAM_DINT_0”。

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

这种数据类型的参数需要 32 个比特，正好对应于两个寄存器地址。因此，保留两个寄存器，但仅映射第一个的地址，例如，如果使用地址 %MW111 和 %MW112，则映射 %MW111。

此外，将添加另一个字段：“GMV_ITPARAMUSEARRAY_DINT_W0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。此字段的符号由两个部分组成。第一个部分是前缀“GMV_ITPARAMUSEARRAY_DINT”，表示此字段引用数据类型 DINT 的迭代参数。第二个部分是后缀“W0”，指保留的两个寄存器地址中的第一个。

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

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 个比特，正好对应于两个寄存器地址。因此，保留两个寄存器，但仅映射第一个的地址，例如，如果使用地址 %MW113 和 %MW114，则映射 %MW113。

此外，将添加另一个字段：“GMV_ITPARAMUSEARRAY_REAL_W0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。此字段的符号由两个部分组成。第一个部分是前缀“GMV_ITPARAMUSEARRAY_REAL”，表示此字段引用数据类型 REAL 的迭代参数。第二个部分是后缀“W0”，指保留的两个寄存器地址中的第一个。

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

STRING[80] iteration parameter allocation

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

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

这种数据类型的参数需要 80 个字节（640 个比特），正好对应于 40 个寄存器地址。它们通过单个 WORDS 序列映射，例如 %MW115 到 %MW154，每个序列对应于 ASCI 字符的两个字节。字段的符号由几个部分组成。第一个部分是前缀“GMV_ITPARAM_STRING80”，表示此字段引用数据类型 STRING[80] 的迭代参数。第二个部分是相应 MVApp 参数的索引。最后的第三个部分是后缀，由字符“W”和索引号组成，该索引号指示相应字段引用为 STRING[80] 参数值保留的 40 个寄存器中的哪一个。例如，带有符号“GMV_ITPARAM_STRING80_0_W0”的字段引用为第一个 STRING[80] 迭代参数保留的第一个寄存器地址。因此，它将用于第一个 STRING[80] 迭代参数的前两个字节的值。“GMV_ITPARAM_STRING80_0_W0”到“GMV_ITPARAM_STRING80_0_W39”字段则表示为数据类型 STRING[80] 的第一个迭代参数的值保留的 WORDS。

此外，将添加另一个字段：“GMV_ITPARAMUSEARRAY_STRING80_W0”。此字段由 PLC 用于指示配方中提供的参数值是否将在下一次执行时被相应迭代参数字段中定义的值覆盖。此字段的符号由两个部分组成。第一个部分是前缀“GMV_ITPARAMUSEARRAY_STRING80”，表示此字段引用数据类型 STRING[80] 的迭代参数。第二个部分是后缀“W0”，指保留的两个寄存器地址中的第一个。

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

Export Symbols

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

该文件采用 CSV 格式（逗号分隔值文件），并可导入到 PLC 程序的项目。

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

Output directory

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

Output file name

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

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

* Modicon® is a registered trademark of Schneider Electric USA, Inc.