<< 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 |
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 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".
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.
Fig.: MyMeasurement = "metric" |
Fig.: MyMeasurement = "imperial" |
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".
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".
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.
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.
If the advanced parameters are enabled, parameter "Translation" appears in the individual sections.
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.
Conversion "DistanceToVolume" was defined. This could look like this:
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.
This topic is also covered in use case Using unit conversion. |