配置插件

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

在 MERLIC RTE Setup 中启用配置

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

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

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

Plug-in Parameters

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

Version

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

Log level

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

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

Access level

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

Supports rapid validation

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

User Parameters

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

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

Ethernet Connection Details
Result Handling Behavior
Writing Data to PLC Memory
Reading Data from PLC Memory
Export Symbols

Ethernet Connection Details

此类别中的参数定义了连接到 Schneider Electric Modicon®* 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 毫秒。

Writing Data to PLC Memory

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

对于您想要传输的每个结果，必须保留一个所谓的字段。字段表示 PLC 上用于相应结果值的特定内存区块。然而，也有用于其他内容或命令的字段，例如，用于当前状态或请求命令的字段。每个字段都有预定义的名称。在 Schneider Electric 的 PLC 工程软件“EcoStruxure™ Machine Expert - Basic”中，这些名称定义为“符号”。例如，包含当前状态的字段的符号为“GMV_CURRENTSTATE”。

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

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

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

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

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

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 结果。

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

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

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

默认情况下，不会为任何迭代参数保留任何字段。这意味着不能通过 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[80] iteration parameter allocation	1

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

然后，插件将分配五个字段：

分配的字段	描述
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 写入的区块将重叠，因为它们会尝试写入相同的地址。为了防止这种情况，如果“Head Input Register address”设置得太低，MERLIC RTE Setup 会显示一个错误。在这类情况下，最好尝试错误中给出范围之外的下一个地址，并检查这个地址是否合适。

或者，您也可以将该参数设置为较大的数字，以最大限度地减少内存重叠的可能性。但是，必须避免设置有效范围之外的寄存器地址。可用内存的数量取决于 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_RESULT_BOOL”加上相应 MVApp 的索引组成。例如，“GMV_RESULT_BOOL_0”将用于此数据类型的第一个结果。