配置插件

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

在 MERLIC RTE Setup 中启用配置

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

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

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

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

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

Plug-in Parameters

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

Version

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

Log level

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

Access level

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

Supports rapid validation

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

User Parameters

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

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

Ethernet Connection Details

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

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

IP address

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

Port

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

System Operation

此类别中的参数定义与 MVTec 的 PLC 协议版本和心跳模式相关的设置。

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

Protocol version

此参数定义所使用的 MVTec PLC 协议版本。默认情况下设置为“1.1”，这是最新版本。您可以将协议版本设置为“1.0”，这是之前的 MERLIC 版本所使用的协议版本。

相较于协议版本“1.0”，新版本带有心跳模式，可以不断发出信号表明与 MERLIC 的连接仍处于活动状态。如果使用协议版本“1.1”，则在导出的标签文件中将提供带有“gMV_Heartbeat”标签的附加字段，且该字段保留用于 PLC。该字段包含一个 16 位计数器，而该计数器会在插件运行时不断更新。这样可以监控 MERLIC 与 PLC 之间的连接，并且能够通过对应的 PLC 程序配置来处理由于意外错误而导致的任何连接丢失。有关 PLC 协议中所使用字段的更多信息，请参阅用于与 PLC 通讯的字段。

如果您想使用现有的 GX Works2 或 GX Works3 项目，而该项目中 MERLIC 版本配置的 MELSEC Communication 插件使用的是早于 5.6.0 的版本，对于这一 MERLIC 版本的 MERLIC RTE，您要么必须使用“1.0”协议版本，要么必须根据新的 PLC 协议调整插件和项目配置。

Heartbeat interval

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

仅当使用支持心跳模式的协议版本，即“Protocol version”设置为“1.1”时，此参数可用。因此，如果“Protocol version”参数设置为“1.0”，则无法配置此参数。

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 的“通讯”选项卡中，选择所需的 MELSEC Communication 插件实例，并转到“Writing Data to PLC Memory”类别参数。
  3. 为该类别中的每个插件参数设置您希望传输的相应数据类型的结果数量。确保该值适合所有将使用的 MVApps。

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

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

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

插件会将所需字段分配到 PLC 上的特定内存地址范围。在 MC 协议中，内存以“Devices”为单位进行寻址。根据将传输的结果数量及其数据类型，需要不同数量的内存，即不同数量的内存地址。

数据类型所需的内存

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

结果数据类型

所需的内存地址

（= 2 字节）

BOOL

1 位内存地址

WORD

1

DWORD

2

INT

1

DINT

2

REAL

2

LREAL

4

STRING[32]

16

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

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

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

字段

描述

gMV_ResultUseArray_INT

此字段表示是否可查询 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 上的三个连续内存地址，例如 D30、D31 和 D32。

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

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

Head device number

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

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

Flush cycle time for writing data to the PLC memory

此参数定义插件尝试向 PLC 内存写入数据的时间间隔。

默认设置为 10 毫秒，这意味着插件每 10 毫秒尝试向 PLC 写入数据。

BOOL (Bit) result allocation

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

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

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

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

WORD (unsigned 16-bit integer) result allocation

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

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

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

这种数据类型的参数需要 16 个比特，正好对应于一个device。因此，整个device的地址将被映射，例如，D31。

DWORD (unsigned 32-bit integer) result allocation

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

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

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

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

INT (signed 16-bit integer) result allocation

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

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

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

这种数据类型的参数需要 16 个比特，正好对应于一个device。因此，整个device的地址将被映射，例如，D34。

DINT (signed 32-bit integer) result allocation

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

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

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

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

REAL (single-precision floating-point) result allocation

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

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

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

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

LREAL (double-precision floating-point) result allocation

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

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

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

这种数据类型的参数需要 64 个比特，正好对应于四个devices。因此，保留四个devices，但仅映射第一个的地址，例如，如果使用地址 D39 到 D42，则映射 D39。

STRING[32] result allocation

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

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

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

这种数据类型的参数需要 32 个字节（256 个比特），正好对应于 16 个devices。因此，保留 16 个devices，但仅映射第一个的地址，例如，如果使用地址 D43 到 D58，则映射 D43。

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 的“通讯”选项卡中，选择所需的 MELSEC Communication 插件实例，并转到“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 上的特定内存地址范围。根据将传输的迭代参数数量及其数据类型，需要不同数量的内存，即不同数量的内存地址。 如果传输的迭代参数少于为相应数据类型指定的数量，则并非 PLC 上保留的所有 devices 寄存器都会被使用。

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

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

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

用户参数

值

INT (signed 16-bit integer) iteration parameter allocation

2

STRING[32] iteration parameter allocation

1

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

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

分配的字段

描述

gMV_ItParamUseArray_INT

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

gMV_ItParamUseArray_STRING32

此字段将用作指示符，指示数据类型 STRING_80 的配方参数是否将在下一次单次或连续执行时被“gMV_ItParam_STRING32_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_STRING32_0

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

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

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

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

字段

描述

gMV_ItParamUseArray_INT

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

gMV_ItParamUseArray_STRING32

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

gMV_ItParam_INT_0

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

gMV_ItParam_INT_1

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

gMV_ItParam_STRING32_0

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

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

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

Head device number

此参数定义在 PLC 上保留的区块的第一个内存地址。此区块包含由 PLC 写入协议并由插件读取的所有值，例如请求的命令和迭代参数的值。默认情况下设置为 100，对应于 D100。

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

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

Polling cycle time for reading data from the PLC memory

此参数定义插件尝试读取 PLC 内存区域全部内容的时间间隔。

默认设置为 10 毫秒，这意味着插件每 10 毫秒尝试读取一次内存。

BOOL (Bit) iteration parameter allocation

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

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

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

这种数据类型的参数需要不多不少 1 个比特。因此，内存地址的一个比特将映射到一个Boolean迭代参数的字段。给定device内的单个迭代参数使用十六进制数字进行寻址，如 D112.0、D112.1、…、D112.f。

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 Boolean 参数，则 PLC 需要将“gMV_ItParamUseArray_BOOL”字段的值设置为 11。

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 个比特，正好对应于一个device。因此，整个device的地址将被映射，例如，D113。

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 WORD 参数，则 PLC 需要将“gMV_ItParamUseArray_WORD”字段的值设置为 11。

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

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 DWORD 参数，则 PLC 需要将“gMV_ItParamUseArray_DWORD”字段的值设置为 11。

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 个比特，正好对应于一个device。因此，整个device的地址将被映射，例如，D116。

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 INT 参数，则 PLC 需要将“gMV_ItParamUseArray_INT”字段的值设置为 11。

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

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 DINT 参数，则 PLC 需要将“gMV_ItParamUseArray_DINT”字段的值设置为 11。

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

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 REAL 参数，则 PLC 需要将“gMV_ItParamUseArray_REAL”字段的值设置为 11。

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 个比特，正好对应于四个devices。因此，保留四个devices，但仅映射第一个的地址，例如，如果使用地址 D121 到 D124，则映射 D121。

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 LREAL 参数，则 PLC 需要将“gMV_ItParamUseArray_LREAL”字段的值设置为 11。

STRING[32] iteration parameter allocation

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

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

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

这种数据类型的参数需要 32 个字节（256 个比特），正好对应于 16 个devices。因此，保留 16 个devices，但仅映射第一个的地址，例如，如果使用地址 D125 到 D140，则映射 D125。

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

对于此数据类型的每个可用迭代参数，PLC 需要逐位定义是否应将其用于执行。例如，如果将此参数设置为 2，并希望在下一次执行中使用两个 STRING[32] 参数，则 PLC 需要将“gMV_ItParamUseArray_STRING32”字段的值设置为 11。

Global Label CSV Export

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

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

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

Environment

此参数定义为其导出标签的应用程序。您可以在下表中列出的 GX Works 版本之间进行选择。导出的“Global Label”文件将根据所选应用程序的要求进行格式化。默认情况下设置为“GX Works2”。请务必选择正确的应用程序。否则，在将 CSV 文件导入到您所用 GX Works 版本的项目中时可能会发生错误。

值

描述

GX Works2

导出的“Global Label”文件将根据 GX Works2 的要求进行格式化。

GX Works3

导出的“Global Label”文件将根据 GX Works3 的要求进行格式化。
Locale

此参数定义导出“Global Label”文件的语言。更准确地说，它确定导出文件中标题的语言。目前，您可以在下表中列出的设置之间进行选择。默认情况下设置为“en-US”。

值

描述

en-US

英语（美国）

ja-JP

日语（日本）

在 GX Works 中导入 CSV 文件时，请务必选择正确的语言以避免出现错误。如果使用的是英语版 GX Works，则必须选择“en-US”；如果使用的是日语版本，则必须选择“ja-JP”。

Output directory

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

Output file name

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