配置插件

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

在 MERLIC RTE Setup 中启用配置

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

打开 MERLIC RTE Setup 并转到“通讯”选项卡。如果 MERLIC Communicator 未运行，您可以从“通讯”选项卡直接启动它。
将 MELSEC Communication 插件添加到左侧的插件实例列表。
确保插件当前未在运行。否则，参数将不可用于配置。可以通过插件实例列表中的相应状态图标查看插件的当前状态。如果状态显示图标，表示插件正在运行。在这种情况下，必须通过单击 MERLIC RTE Setup 底部的“ 停止插件”按钮停止它。如果状态显示图标，表示插件当前未在运行。在以下示例图像中，MELSEC Communication 插件的选定实例当前未在运行，因此可以进行配置。
选择左侧的 MELSEC Communication 插件，以显示其参数并开始配置。

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

Plug-in Parameters

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

Version

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

Log level

此参数显示用于 MELSEC Communication 插件的日志等级。默认情况下，使用 Communicator 的日志等级，即“Info”。这意味着将记录严重程度为“critical”、“error”、“warning”和“info”的所有类型的消息，即提供一般性非关键信息的消息。

还可以为 Communicator 整体设置不同的日志等级，或仅针对特定插件实例进行设置。有关更多信息，请参阅 MERLIC 手册启动和停止插件主题中的使用特定日志等级启动插件部分。

Access level

此参数显示为插件设置的访问等级。对于 MELSEC Communication 插件，访问等级默认设置为“monitor and control”。这表示插件可以接收“事件”并发送“操作”。访问级别与插件实现中定义的功能相关。实现的功能无法在 MERLIC RTE Setup 中调整。但是，可以将插件的访问等级限制为“monitor”。有关更多信息，请参阅主题更改 Communicator 和插件设置。

Supports rapid validation

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

User Parameters

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

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

Ethernet Connection Details
System Operation
Result Handling Behavior
Writing Data to PLC Memory
Reading Data from PLC Memory
Global Label CSV Export

Ethernet Connection Details

此类别中的参数定义了连接到 Mitsubishi Electric MELSEC 系列 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 毫秒。

Writing Data to PLC Memory

此类别中的参数定义可传输到 PLC 的每个数据类型的结果数量。

对于您想要传输的每个结果，必须保留一个所谓的字段。字段表示 PLC 上用于相应结果值的特定内存区块。然而，也有用于其他内容或命令的字段，例如，用于当前状态或请求命令的字段。每个字段都有预定义的名称。在 Mitsubishi Electric MELSEC 系列 PLC 使用的 MELSEC 通讯 (MC) 协议中，这些名称被称为“标签”。例如，包含当前状态的字段的标签为“gMV_CurrentState”。

插件会将所需字段分配到 PLC 上的特定内存地址范围。在 MC 协议中，内存以“Devices”为单位进行寻址。根据将传输的结果数量及其数据类型，需要不同数量的内存，即不同数量的内存地址。例如，一个数据类型为 INT 的结果只需要一个内存地址，但一个数据类型为 DINT 的结果需要两个内存地址。如果传输的结果少于为相应数据类型指定的数量，则并非 PLC 上保留的所有 devices 都会被使用。

默认情况下，不会为任何结果数据类型保留任何字段。这意味着不会将任何结果传输到 PLC。

要启用结果传输，您必须选择表示结果的相应数据类型的参数，并将其值设置为要传输的结果数量。如果您不确定结果的数据类型，可以在 MVApp 中查找。例如，如果您的 MVApps 最多包含数据类型 INT 的五个 MVApp 结果，则必须将插件配置中的相应用户参数“INT (signed 16-bit integer) result allocation”设置为至少 5，以确保所有 INT 结果的值都提供给 PLC。

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

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

Head device number

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

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

BOOL (Bit) result allocation

此参数定义可以传输到 PLC 的 Boolean 结果数量。例如，如果希望传输最多五个 Boolean 结果，请将参数设置为至少 5。然后，PLC 将保留并映射所需字段的内存地址。槽位的标签将由前缀“gMV_Result_BOOL”加上相应 MVApp 结果的索引号组成。例如，“gMV_Result_BOOL_0”将用于此数据类型的第一个结果。

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

这种数据类型的参数需要不多不少 1 个比特。因此，如果选择了最多 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 可为执行覆盖的每个数据类型的参数值数量。

就像对于类别“Writing Data to PLC Memory”中的结果一样，必须在 PLC 上为该 PLC 应可用的每个迭代参数保留一个字段。这意味着需要为迭代参数分配所需的内存。您可以通过将此类别中每个用户参数的值设置为 PLC 可用于相应数据类型的迭代参数数量来执行此操作。

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

默认情况下，不会为任何迭代参数保留任何字段。这意味着不能通过 PLC 设置迭代参数，因为没有可用于传输的参数。

如果要允许 PLC 覆盖执行的特定 MVApp 参数的值，则必须相应地设置相应数据类型的用户参数。如果您不确定相应迭代参数的数据类型，可以在 MVApp 中查找。例如，如果您的 MVApps 最多包含数据类型 INT 的三个 MVApp 参数，则必须将插件配置中的相应用户参数“INT (signed 16-bit integer) iteration parameter allocation”设置为至少 3，以确保所有此数据类型的 MVApp 参数都可以通过 PLC 进行调整。

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

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

示例

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

用户参数	值
INT (signed 16-bit integer) iteration parameter allocation	2
STRING[32] iteration parameter allocation	1

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

然后，插件将向协议添加五个字段：

分配的字段	描述
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”字段上发出，并且这些错误还会记录在 Communicator 的日志文件中。

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”将用于此数据类型的第一个结果。