Configuring the Plug-in

The configuration of the MELSEC Communication plug-in can be adjusted in the "Communication" tab of the MERLIC RTE Setup. In the "Communication" tab, you can add an instance of the MELSEC Communication plug-in, configure the parameters, and you can start and stop the plug-in directly in the user interface.

Enabling the Configuration in the MERLIC RTE Setup

To enable the configuration of the plug-in in the "Communication" tab of the MERLIC RTE Setup, you first have to start the MERLIC Communicator and perform the following steps:

Open the MERLIC RTE Setup and go to the "Communication" tab. In case the MERLIC Communicator is not running, you can start it directly from the "Communication" tab.
Add the MELSEC Communication plug-in to the list of plug-in instances on the left.

Make sure that the plug-in is currently not running. Otherwise, the parameters are not available for the configuration. You can see the current state of the plug-in at the respective status icon in the list of plug-in instances. If the status shows the icon , the plug-in is running. In this case, you have to stop it by clicking the " Stop plug-in" button on the bottom of the MERLIC RTE Setup. If the status shows the icon instead, the plug-in is currently not running. In the example image below, the selected instance of the MELSEC Communication plug-in is currently not running and therefore the configuration is possible.
Select the MELSEC Communication plug-in on the left to display its parameters and to start with the configuration.

The parameters of the selected MELSEC Communication plug-in are shown on the right of the "Communication" tab.

Plug-in Parameters

Parameters of this type represent general parameters for the Communicator plug-in that cannot be adjusted in the configuration area of the "Communication" tab. They may show the version number of the plug-in, the current parameter value for the log level, the access level of the plug-in, and the setting for the validation of the plug-in configuration. These values need to be set in different locations or with different methods, respectively.

Version

This parameter shows the version number that has been defined during the plug-in implementation. It consists of a major, minor, and maintenance version. It is also shown when adding a new plug-in instance. The version is optional. Therefore, it is possible that no version number has been defined during the implementation.

Log level

This parameter shows the log level that is used for the MELSEC Communication plug-in. By default, the log level of the Communicator is used which is "Info". This means that all types of messages of severity "critical", "error", "warning", and "info" are logged, i.e., messages for general non-critical information.

You can also set a different log level for the Communicator in general or for a specific plug-in instance only. For more information, see the section Starting a Plug-in with a Specific Log Level in the topic Starting and Stopping Plug-ins of the MERLIC manual.

Access level

This parameter shows the access level that is set for the plug-in. For the MELSEC Communication plug-in, the access level is set to "monitor and control" by default. This means that the plug-in can receive "events" and send "actions". The access level correlates with the capability that is defined in the implementation of the plug-in. The implemented capability cannot be adjusted in the MERLIC RTE Setup. However, it is possible to restrict the access level of the plug-in to only "monitor". For more information, see the topic Changing Communicator and Plug-in Settings.

Supports rapid validation

This parameter shows whether the plug-in supports the immediate validation of the current plug-in configuration. For this plug-in, the check box is ticked indicating that "rapid validation" is supported. This means that the configuration of the plug-in is validated with each modification of any editable parameter in the "Communication" tab of the MERLIC RTE Setup. If the plug-in does not support "rapid validation", the configuration of the plug-in is validated only when saving the configuration.

User Parameters

The "User parameters" represent the set of parameters that can be configured for the plug-in. They are displayed in different categories which can be expanded or closed.

The following sections describe the parameters for each category.

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

Ethernet Connection Details

The parameters in this category define the settings for the connection to the Mitsubishi Electric MELSEC Series PLC. For more information on how to set up the connection to the PLC, see the topic Setting Up the Connection to the PLC.

The following image shows an overview of the parameters with the respective default setting. A detailed description of the parameters follows after the image.

IP address

This parameter defines the Internet Protocol address (IP address) of the MELSEC Communication PLC to which you want to connect. By default, it is set to "127.0.0.1". The parameter supports only Internet Protocol version 4 (IPv4) addresses. The usage of host names is thereby not supported.

Port

This parameter defines the port used for the connection. By default, it is set to "5010".

Result Handling Behavior

The parameters in this category define settings with respect to the retrieval of the results. For more information on the result handling of the different modes, see the topic Result Modes.

The following image shows an overview of the parameters with the respective default setting. A detailed description of the parameters follows after the image.

Result mode

This parameter allows you to select the mode of querying the results. You can choose between "Free-running" and "Dequeue from buffer". By default, the parameter is set to "Dequeue from buffer". In the following table, we give a short description for each mode.

Mode	Description
Free-running	In this mode, the results of a single or continuous execution are immediately written to the respective memory addresses of the PLC without any handshake mechanism. This mode is the fastest but it can also be the most error prone. Depending on the timing of both MERLIC and the PLC, it might be possible that some results get lost or overwritten before the PLC can collect them.
Dequeue from buffer	In this mode, an internal FIFO queue is used to save the incoming results after starting a single or continuous execution. If the PLC requests a result by setting the "gMV_ReqCommandCode" to 10, the first result in the buffer is written to the respective memory address of the PLC. The requested result is then immediately removed from the queue.

Result buffer capacity

This parameter defines the size of the buffer which is used to temporarily store the results when using "Dequeue from buffer" as result mode. It represents the number of results that can be saved in the buffer. By default, it is set to 10.

This parameter is used only if "Dequeue from buffer" is set as result mode. It has no effect if "Result mode" is set to "Free-running". Therefore, it will be deactivated for configuration if the "Free-running" mode is selected.

DequeueResult command timeout

This parameter defines the timeout for the "Dequeue from buffer" mode when waiting for a new result. If the PLC requests a result and the respective result is not available yet, all other requests will be blocked until the result is available or until the specified timeout expired. By default, the timeout is set to 1000 ms.

Writing Data to PLC Memory

The parameters in this category define how many results of each data type can be transmitted to the PLC.

For each result you want to transmit, you have to reserve a so-called field. A field represents a specific memory block on the PLC which is used for the respective result value. However, there are also fields for other contents or for commands, for example, for the current state or to request commands. Each field has a predefined name. In MELSEC communication (MC) protocols used by Mitsubishi Electric MELSEC Series PLCs, these names are called "labels". For example, the label of the field that contains the current state is "gMV_CurrentState".

The plug-in will assign the required fields to a specific memory address range on the PLC. In the MC protocol, memory is addressed in units called "Devices". Depending on the number of results that shall be transmitted and their data type, a different amount of memory is required, that is, a different amount of device addresses. For example, a result of data type INT requires exactly one device address but a result of data type DINT requires two device addresses. If fewer results are transmitted than the number specified for the respective data type, not all of the reserved devices on the PLC will be used.

By default, no fields are reserved for any result data type. This means that no results will be transmitted to the PLC.

To enable the transmission of a result, you have to select the parameter that represents the respective data type of the result and set its value to the number of results you want to transmit. If you are not sure of the result's data type, you can look it up in the MVApp. For example, if your MVApps may contain up to five MVApp results of data type INT, you have to set the respective parameter in the plug-in's configuration, "INT (signed 16-bit integer) result allocation", to at least 5 to ensure that the values of all INT results will by available for the PLC.

If more results of a specific data type are transmitted than specified in the plug-in configuration, not all parameters will be available because not enough device addresses were reserved on the PLC.

The following image shows an overview of the parameters. A detailed description of the parameters follows after the image.

Head device number

This parameter defines the first device address of the block that is reserved on the PLC for all values that are written into the protocol by the plug-in and read by the PLC, for example, the current state and result values.

By default, it is set to 0 which corresponds to D0.

BOOL (Bit) result allocation

This parameter defines the number of Boolean results that can be transmitted to the PLC. For example, if you want to transmit up to five Boolean results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_BOOL" followed by the index number of the respective MVApp result. For example, "gMV_Result_BOOL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no Boolean result will be transmitted.

Parameters of this data type require exactly 1 bit. Therefore, exactly one bit of a device address is mapped to the field of a Boolean result provided that up to 16 results are selected. The individual results within a given device are addressed using a hexadecimal digit, for example, D30.0, D30.1, ..., D30.f. If more than 16 Boolean results are returned, further device addresses are mapped to provide a field for each result.

WORD (unsigned 16-bit integer) result allocation

This parameter defines the number of WORD results that can be transmitted to the PLC. For example, if you want to transmit up to five WORD results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_WORD" followed by the index number of the respective MVApp result. For example, "gMV_Result_WORD_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no WORD result will be transmitted.

Parameters of this data type require exactly 16 bits which correspond to exactly one device. Therefore, the address of a whole device will be mapped, for example, D31.

DWORD (unsigned 32-bit integer) result allocation

This parameter defines the number of DWORD results that can be transmitted to the PLC. For example, if you want to transmit up to five DWORD results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_DWORD" followed by the index number of the respective MVApp result. For example, "gMV_Result_DWORD_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no DWORD result will be transmitted.

Parameters of this data type require exactly 32 bits which corresponds to exactly two devices. Therefore, two devices are reserved but only the address of the first will be mapped, for example, D32 if the addresses D32 and D33 are used.

INT (signed 16-bit integer) result allocation

This parameter defines the number of INT results that can be transmitted to the PLC. For example, if you want to transmit up to five INT results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_INT" followed by the index number of the respective MVApp result. For example, "gMV_Result_INT_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no INT result will be transmitted.

Parameters of this data type require exactly 16 bits which correspond to exactly one device. Therefore, the address of a whole device will be mapped, for example, D34.

DINT (signed 32-bit integer) result allocation

This parameter defines the number of DINT results that can be transmitted to the PLC. For example, if you want to transmit up to five DINT results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_DINT" followed by the index number of the respective MVApp result. For example, "gMV_Result_DINT_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no DINT result will be transmitted.

Parameters of this data type require exactly 32 bits which correspond to exactly two devices. Therefore, two devices are reserved but only the address of the first will be mapped, for example, D35 if the addresses D35 and D36 are used.

REAL (single-precision floating-point) result allocation

This parameter defines the number of REAL results that can be transmitted to the PLC. For example, if you want to transmit up to five REAL results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_REAL" followed by the index number of the respective MVApp result. For example, "gMV_Result_REAL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no REAL result will be transmitted.

LREAL (double-precision floating-point) result allocation

This parameter defines the number of LREAL results that can be transmitted to the PLC. For example, if you want to transmit up to five LREAL results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_LREAL" followed by the index number of the respective MVApp result. For example, "gMV_Result_LREAL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no LREAL result will be transmitted.

Parameters of this data type require exactly 64 bits which correspond to exactly four devices. Therefore, four devices are reserved but only the address of the first will be mapped, for example, D39 if the addresses D39 to D42 are used.

STRING[32] result allocation

This parameter defines the number of STRING[32] results that can be transmitted to the PLC. For example, if you want to transmit up to five STRING[32] results, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the slots will be composed of the prefix "gMV_Result_STRING32" followed by the index number of the respective MVApp result. For example, "gMV_Result_STRING32_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no STRING[32] result will be transmitted.

Parameters of this data type require exactly 32 bytes (256 bits) which corresponds to exactly 16 devices. Therefore, 16 devices are reserved but only the address of the first will be mapped, for example, D43 if the addresses D43 to D58 are used.

Reading Data from PLC Memory

The parameters in this category define how many iteration parameters can be provided per data type to the PLC. An iteration parameter represents a parameter that serves as argument for the execution of the MVApp to override the value of the corresponding MVApp parameter that is given in the prepared recipe. This allows you to run the MVApp with other input values without the need to change the recipe. Thus, the user parameters in this category define how many parameter values per data type can be overridden by the PLC for the execution.

Just like for the results in the category "Writing Data to PLC Memory", you have to reserve a field on the PLC for each iteration parameter that shall be available for the PLC. This means that the required memory needs to be allocated for the iteration parameters. You can do this by setting the value of each user parameter in this category to the number of iteration parameters you want to make available for the PLC for the respective data type.

The plug-in will assign the required fields for the parameters to a specific memory address range on the PLC. Depending on the number of iteration parameters that shall be transmitted and their data type, a different amount of memory is required, that is, a different amount of device addresses. For example, a parameter of data type INT requires exactly one device address but a parameter of data type DINT requires two device addresses. If fewer iteration parameters are transmitted than the number specified for the respective data type, not all of the reserved devices on the PLC will be used.

By default, no fields are reserved for any iteration parameters. This means that no iteration parameter can be set via the PLC because no parameter is available for transmission.

If you want to allow the PLC to override the value of a specific MVApp parameter for the execution, you have to ensure that the user parameter for the respective data type is set accordingly. If you are not sure about the data type of the respective iteration parameter, you can look it up in the MVApp. For example, if your MVApps contain up to three MVApp parameters of data type INT, you have to set the respective user parameter in the plug-in's configuration, "INT (signed 16-bit integer) iteration parameter allocation", to at least 3 to ensure that all MVApp parameters of this data type can be adjusted via the PLC.

The plug-in configuration only defines how many iteration parameters will be available for the PLC to override the respective MVApp parameters in the execution. However, the specified iteration parameters don't have to be used. The PLC may also request a single or continuous execution without using an iteration parameter. In this case, the MVApp will be executed with the values defined in the respective recipe.

When specifying iteration parameters to override parameter values in the recipe, the PLC needs to consider some requirements. The number of specified parameter values need to correspond to the number of values defined in the recipe file. In addition, their data type must be suitable to enable a lossless conversion into the data type of the respective parameter value in the recipe. If these conditions are not met, the whole set of iteration parameters is discarded and the recipe is executed with the default values instead. In this case, a warning will be emitted, also on the "gMV_ErrorCode" and "gMV_ErrorCause" fields. For more information, see the description of the corresponding rules stated for the parameter "MV_PARAM_START_PARAMS" in the topic Available Actions in the Communicator API reference documentation.

Example

If your recipe contains two INT parameters and one STRING_80 parameter and you want to enable the PLC to override the values of these parameters for a single or continuous execution, you have to set the following parameters:

User parameter	Value
INT (signed 16-bit integer) iteration parameter allocation	2
STRING[32] iteration parameter allocation	1

It is also possible to set higher values even if your current recipe only contain two INT and one STRING_80 parameter. However, for this example we assume that the values in the plug-in configuration are set as described in the table above.

The plug-in will then add five fields to the protocol:

Allocated field	Description
gMV_ItParamUseArray_INT	This field will serve as indicator whether the recipe parameters of data type INT shall be overridden for the next single or continuous execution by the value defined in "gMV_ItParam_INT_0" and "gMV_ItParam_INT_1".
gMV_ItParamUseArray_STRING32	This field will serve as indicator whether the recipe parameter of data type STRING_80 will be overridden for the next single or continuous execution by the value defined in "gMV_ItParam_STRING32_0".
gMV_ItParam_INT_0	This field will be provided to define the new value for the MVApp parameter of data type INT and index 0, that is, for the first INT parameter in the recipe. The number that is added as suffix indicates the index of the recipe parameter. In this example, it refers to the first recipe parameter of data type INT. The list of recipe parameters and the respective index number is also visible in the overview of the MVApp parameters within the MERLIC Creator.
gMV_ItParam_INT_1	This field will be provided to define the new value for the MVApp parameter of data type INT and index 1, that is, for the second INT parameter in the recipe. As indicated by the suffix 1, this field refers to the second recipe parameter of data type INT.
gMV_ItParam_STRING32_0	This field will be provided to define the new value for the MVApp parameter of data type STRING_80 and index 0, that is, for the STRING_80 parameter in the recipe. As indicated by the suffix 0, this field refers to the first recipe parameter of data type STRING_80.

The new fields can then be used to specify parameter values for the execution of the MVApp that is referenced in the prepared recipe.

For our example, we assume that the recipe with two INT parameters and one STRING_80 parameter is prepared. To override the parameters for the next execution, the PLC has to set the desired values for the parameters into the respective fields and specify that all three parameters values should be used for the next "StartSingleJob" or "StartContinuous" command. This means, the PLC has to set the values for the following fields:

Field	Description
gMV_ItParamUseArray_INT	The first two bits in this array must be set to 1 (or alternatively to TRUE). This indicates that each of the two "gMV_ItParam_INT" values should be used for the next execution.
gMV_ItParamUseArray_STRING32	The value for this field must be set to 1 (or alternatively to TRUE). This indicates that the value in "gMV_ItParam_STRING32_0" should be used for the next execution.
gMV_ItParam_INT_0	This field must be set to the integer value that shall be used for the first INT parameter instead of the value defined in the recipe.
gMV_ItParam_INT_1	This field must be set to the integer value that shall be used for the second INT parameter instead of the value defined in the recipe.
gMV_ItParam_STRING32_0	The sequence of WORDS in these fields must be set to the string that shall be used for the STRING_80 parameter instead of the value defined in the recipe.

When the new "StartSingleJob" or "StartContinuous" command is requested by the PLC, the plug-in will use the specified values of the iteration parameters for the next execution. The recipe values will be overwritten with each "StartSingleJob" and "StartContinuous" command as long as the fields "gMV_ItParamUseArray_INT" and "gMV_ItParamUseArray_STRING32" are set as described above, that is, until their values are reset to 0. If no iteration parameters are set to "in use", the default value defined in the recipe are used again.

The following image shows an overview of the parameters. A detailed description of the parameters follows after the image.

Head device number

This parameter defines the first device address of the block that is reserved on the PLC. This block includes all values that are written into the protocol by the PLC and read by the plug-in, for example, requested commands and values of iteration parameters. By default, it is set to 100 which correspond to D100.

With the default setting of the corresponding parameter Head device number in the section "Writing Data to PLC Memory", 100 devices are available for the block of values that are written by the plug-in to the protocol. However, these might not be enough in all use cases. For example, if a lot of results shall be transmitted with the execution of an MVApp and these result require more than 100 devices on memory, the "Head device number" in this category "Reading Data from PLC Memory" must be increased. Otherwise, the block written by the plug-in and the block written by the PLC would overlap because they attempt to write to the same addresses. To prevent this, the MERLIC RTE Setup shows an error if the "Head device number" in "Reading Data from PLC Memory" is set too low. In such cases, it is best to simply try out the next address outside the range that is given in the error and check if that one fits.

Alternatively, you can also set the parameter to a large number to minimize the chances of a memory overlap. However, you have to avoid setting a device address outside the valid range of devices. The amount of available memory depends on the PLC model and cannot be queried in advance from the plug-in. Therefore, the setting of this parameter will be checked first when starting the plug-in and attempting to communicate with the PLC. As soon as the PLC attempts to write a value to an unavailable register address, an error occurs. The error is emitted on the "gMV_ErrorCode" and "gMV_ErrorCause" fields and the errors will also be logged in the log file of the Communicator.

Polling cycle time for ReqCommandCode

This parameter defines the cycle time in which the value of the field "gMV_ReqCommandCode" is read.

By default, it is set to 10 ms which means that the plug-in checks every 10 ms whether a new command is requested by the PLC.

BOOL (Bit) iteration parameter allocation

This parameter defines the number of iteration parameters of data type Boolean that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the Boolean values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_BOOL" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_BOOL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

Parameters of this data type require exactly 1 bit. Therefore, exactly one bit of a device address is mapped to the field of a Boolean iteration parameter. The individual iteration parameters within a given device are addressed using a hexadecimal digit, for example, D112.0, D112.1, ..., D112.f.

In addition, another field will be added: "gMV_ItParamUseArray_BOOL". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type BOOL, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both BOOL parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_BOOL" field to 11.

WORD (unsigned 16-bit integer) iteration parameter allocation

This parameter defines the number of iteration parameters of data type WORD that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the WORD values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_WORD" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_WORD_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

Parameters of this data type require exactly 16 bits which correspond to exactly one device. Therefore, the address of a whole device will be mapped, for example, D113.

In addition, another field will be added: "gMV_ItParamUseArray_WORD". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type WORD, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both WORD parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_WORD" field to 11.

DWORD (unsigned 32-bit integer) iteration parameter allocation

This parameter defines the number of iteration parameters of data type DWORD that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the DWORD values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_DWORD" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_DWORD_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

In addition, another field will be added: "gMV_ItParamUseArray_DWORD". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type DWORD, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both DWORD parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_DWORD" field to 11.

INT (signed 16-bit integer) iteration parameter allocation

This parameter defines the number of iteration parameters of data type INT that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the INT values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_INT" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_INT_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

Parameters of this data type require exactly 16 bits which correspond to exactly one device. Therefore, the address of a whole device will be mapped, for example, D116.

In addition, another field will be added: "gMV_ItParamUseArray_INT". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type INT, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both INT parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_INT" field to 11.

DINT (signed 32-bit integer) iteration parameter allocation

This parameter defines the number of iteration parameters of data type DINT that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the DINT values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_DINT" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_DINT_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

In addition, another field will be added: "gMV_ItParamUseArray_DINT". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type DINT, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both DINT parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_DINT" field to 11.

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

This parameter defines the number of iteration parameters of data type REAL that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the REAL values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_REAL" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_REAL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

In addition, another field will be added: "gMV_ItParamUseArray_REAL". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type REAL, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both REAL parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_REAL" field to 11.

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

This parameter defines the number of iteration parameters of data type LREAL that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the LREAL values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_LREAL" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_LREAL_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

In addition, another field will be added: "gMV_ItParamUseArray_LREAL". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type LREAL, the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both LREAL parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_LREAL" field to 11.

STRING[32] iteration parameter allocation

This parameter defines the number of iteration parameters of data type STRING[32] that can be transmitted from the PLC to MERLIC. For example, if you want to allow the PLC to override the STRING[32] values of up to five MVApp parameters defined in the recipe, set the parameter to at least 5. The PLC will then reserve and map the device addresses for the required fields. The labels of the fields will be composed of the prefix "gMV_ItParam_STRING32" followed by the index number of the respective MVApp result. For example, "gMV_ItParam_STRING32_0" will be used for the first result of this data type.

By default, the parameter is set to 0 which means that no field will be added for any parameters of this data type.

In addition, another field will be added: "gMV_ItParamUseArray_STRING32". This field is used by the PLC to indicate whether the provided parameter values in the recipe shall be overridden for the next execution by the values defined in the fields of the respective iteration parameters.

For each available iteration parameter of data type STRING[32], the PLC needs to define bit by bit whether it should be used for the execution. For example, if you set this parameter to 2 and want to use both STRING[32] parameter in the next execution, the PLC needs to set the value of the "gMV_ItParamUseArray_STRING32" field to 11.

Global Label CSV Export

The parameters in this category define the location and name of the "Global Label" file that is exported when starting the plug-in. The file is based on the configuration of the plug-in and contains the global labels of all fields that shall be reserved by the PLC. It contains some standard labels that are always exported such as the label for requesting commands and also the labels for the number of results and iteration parameters that are defined in the configuration of the plug-in.

The file is formatted as a .csv file (comma-separated values file) and can be imported to the project of the PLC program.

The following image shows an overview of the parameters with the respective default setting. A detailed description of the parameters follows after the image.

Environment

This parameter defines the application for which the labels are exported. You can select between the GX Works versions listed in the table below. The exported "Global Label" file will be formatted as required by the selected application. By default, it is set to "GX Works2". Make sure to select the correct application. Otherwise, an error might occur when importing the .csv file into the project of your GX Works version.

Value	Description
GX Works2	The exported "Global Label" file will be formatted as required by GX Works2.
GX Works3	The exported "Global Label" file will be formatted as required by GX Works3.

Locale

This parameter defines the language for the export of the "Global Label" file. To be more precise, it determines the language of the headings in the exported file. Currently, you can choose between the settings listed in the table below. By default it is set to "en-US".

Value	Description
en-US	English (United States)
ja-JP	Japanese (Japan)

Make sure to select the correct language to avoid errors when importing the .csv file in GX Works. If you are using GX Works in English, you have to select "en-US" and if you are the Japanese version, you have to select "ja-JP".

Output directory

This parameter defines the directory in which the file will be saved. You can select the directory from the file system via the button (on local systems) or you can type the path directly into the text field. By default, it is set to "%LOCALAPPDATA%/Temp" on Windows systems and to "/tmp" on Linux systems.

Output file name

This parameter defines the name of the file. You can change the name directly in the text field. By default, it is set to "gMV_GlobalLabels.csv".