MpComUnit configuration

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

MpComUnit configuration

mapp Services V5.16

For information about how the configuration can be adjusted at runtime, see here in section "Changing the configuration at runtime".

Show advanced parameter

Name



UnitConversion




Customized measurement-systems





{/Identifier}






Identifier






Fallback measurement-system




Unit Groups





{/Identifier}






Identifier






Display units







Metric








Unitcode







Imperial








Unitcode







ImperialUS








Unitcode







Customized measurement-systems








{/Identifier}









Identifier









Unitcode






Measurement system variable




Datapoints





Process variable





Datapoint 1-N






Name






Display Units







Metric








Unitcode







Imperial








Unitcode







ImperialUS








Unitcode







Customized measurement-systems








{/Identifier}









Identifier









Unitcode







Unitgroup




Units





Unit 1-N






Engineering unit







Unitcode






Display Units







Metric








Unitcode







Imperial








Unitcode







ImperialUS








Unitcode







Customized measurement-systems








{/Identifier}









Identifier









Unitcode







Unitgroup






User-defined unit

A user-defined unit can be specified with "Customized measurement systems". The name of the user-defined unit is defined with "Identifier". A fallback unit must also be specified. There are 3 standard units to choose from: imperial, imperial-US and metric.

Unit groups

Unit groups can be defined under "Unit groups". If a project contains a temperature variable of data type "INT[100]", one unit would need to be specified for each array variable in each system of units (imperial, metric, etc.). A unit group can be used, for example, to create group "TemperatureUnit" which defines the unit that should be used for each system of units. The temperature variable then uses unit group "TemperatureUnit". This reduces the necessary configuration work.

The unit group is uniquely identified in the project with "Identifier".

config_unitgroup

A variable of data type STRING can be appended under "Measurement system variable". This variable determines the unit system used for this group. If the PV has value "metric", CEL is used, as shown in the example above. FAH is used if "imperial" is specified. IF user-defined unit "MySystem" is specified, for example, then "MySystem" can be used as the ID.

unit_cel

Fig.: MyMeasurement = "metric"

unit_fah

Fig.: MyMeasurement = "imperial"

Datapoints

Process variables can be specified under "Datapoints" that are applied to a unit system. The "engineering unit" is specified in the OPC UA configuration for this. This configuration provides the option of converting the process variables to other units for display in a mapp View-based HMI application.

Unit-code: The unit code defines the unit to be displayed in the mapp View-based HMI application.

Namespace: The namespace defines where the unit definition can be found. This is only needed for units that are not included in the available standard units.

In addition to units in the metric, imperial and imperial-US systems, units for user-defined unit systems can also be added for each process variable. It is also possible to select a unit group. This is done by selecting "Unit group" under "Display units".

Units

Standard unit conversions can be specified under "Units". Unit conversion can thus be specified for a certain unit. This conversion is then applied to all process variables defined with this unit in OPC UA.

Engineering unit: The "engineering unit" that should be converted for display on the mapp View-based HMI application.

Unit-code: The unit code defines the unit to be displayed in the mapp View-based HMI application.

Namespace: The namespace defines where the unit definition can be found. This is only needed for units that are not included in the available standard units.

In addition to unit conversions into the metric, imperial and imperial-US systems, conversions into user-defined units can also be configured for each "engineering unit".

Defining a format

The format of a process variable, unit or unit group can be defined when the advanced parameters are enabled. The number of decimal places and the minimum number of digits to be used are defined. Leading digits that are not used are replaced by spaces. If value "5" is recorded and the minimum number of total digits is 2, " 5" is displayed, for example.

configruation_format_definition

The settings defined here directly affect the mapp components that can record or display process variables with a unit. This applies to mapp Data or mapp AlarmX, for example.

Defining a unit conversion

If the advanced parameters are enabled, parameter "Translation" appears in the individual sections.

usecase4_unitconfig_translation

Unit conversion can be used if the engineering unit is not compatible with the display unit ("Display unit"). The conversion of the engineering unit into the display unit is defined by the user and is done in the units editor. For additional information about how to create a conversion, see section unit system.

Parameter "Translation" as well as unit conversion in the units editor are only available with an Automation Studio version ≥ 4.10.

Example:

Cubic centimeter ("Input unit") is defined as the engineering unit for a process variable. Millimeter is the unit that should be used as the display unit ("Output unit"), however. Conversion of the engineering unit into the display unit cannot be carried out automatically since the two defined units are not compatible with each other. The conversion is carried out in the unit editor of the unit system. File "Translation formulas" is added for this. The conversion is defined in this file.

usecase4_unittranslation

Conversion "DistanceToVolume" was defined. This could look like this:

unittranslation_formula

The factor by which the engineering unit is multiplied or divided is defined under "Variables".

The name of the previously defined conversion is specified in the MpComUnit configuration at the desired data point.

unitconfiguration_definedtransformation

logo_use_case

This topic is also covered in use case Using unit conversion.