ConverterToEngineeringValue Template Manual

This template is designed to convert the input value of the analog module to the engineering value.
Target equipment: analog input module

If analog input module is high resolution model, ConverterToEVForHighResolution template

should be used.

Function Overview
 Scaling function
The input value of the analog module is converted, and the engineering value is output.

Calculation formula:
Engineering value = (Engineering Maximum – Engineering Minimum) / (Input Maximum – Input
Minimum) * (Input value– Input Minimum) + Engineering Minimum
If (Input Maximum – Input Minimum) is 0, then Engineering value is 0.
If Input value is out of range, Engineering value also becomes out of range.

ConverterToEngineeringValue Template Manual

1/8
Symbol
The symbol of this template is shown below.
It is common for ConverterToEngineeringValue and ConverterToEVForHighResolution.

Control Operability Description

No The equipment name is displayed.
No This indicates the engineering value converted
from the input value of the analog module.

Faceplate
The faceplate is shown below.
It is common for ConverterToEngineeringValue and ConverterToEVForHighResolution.

Control Operability Description

No The equipment name is displayed.
No This indicates the engineering value converted
from the input value of the analog module.

ConverterToEngineeringValue Template Manual

2/8
Function Block
・GX Works2
Program Language: Structured Ladder/FBD
Function Block property: Use Macrocode

・GX Works3
Program Language: FBD/LD
FB Type: Subroutine Type

ConverterToEngineeringValue Template Manual

3/8
Resource
・GX Works2
The number of program steps: 51 steps (ConverterToEngineeringValue)
54 steps (ConverterToEVForHighResolution)

(This is the compile result in Q25H and may be different by CPU type and compile options.)

Used Device Point Point

(ConverterToEngineeringValue) (ConverterToEVForHighResolution)
Word device 24 points 26 points
Word device (retained) 0 points 0 points
Bit device 6 points 6 points
Bit device (retained) 0 points 0 points
Pointer device 2 points 2 points
Timer device 0 points 0 points
Counter device 0 points 0 points

・GX Works3
The number of function block steps: 129 steps (ConverterToEngineeringValue)
129 steps (ConverterToEVForHighResolution)
(This is the compile result in R120 and may be different by CPU type and compile options.)

MC Works64 tag: 6 tags (ConverterToEngineeringValue or ConverterToEVForHighResolution)

ConverterToEngineeringValue Template Manual

4/8
Interface
There are 4 kinds of interface types.
 Equipment Parameter
This is the constant parameter used in function blocks. The value is set in MC
AppBuilder. Also, the user can change constant value in GX Works2 or GX
Works3.
 I/O Access Interface
This is the interface to connect to the equipment.
 Program Interface
This is the interface used in a user program.
 Monitoring Interface
This is the interface to communicate with SCADA.

 Equipment Parameter
Label Data Type IN/OUT Value (default value is Description

indicated with

underline)
EEE_SCALED_MIN REAL IN 0.00 Minimum engineering value
EEE_SCALED_MAX REAL IN 60.00 Maximum engineering value
EEE_RAW_MIN WORD / IN 0 Minimum input value
DWORD
(*)
EEE_RAW_MAX WORD / IN 4000 Maximum input value
DWORD
(*)
EEE_UNIT STRING(8) IN ‘Hz’ Engineering unit displayed on the
symbol and faceplate
EEE_DECIMALPOS WORD IN 2 (0 to 5) Number of digits displayed under the
decimal point
(*) In the case of EEE_EqConvToEV, Data Type is WORD. In the case of EEE_EqDConvToEV, Data Type is DWORD.

 I/O Access Interface

Label Data Type IN/OUT Value Description
EEE_RAW_IN WORD IN - The input value of the analog module

 Program Interface
Label (Latched parameter is Data Type IN/OUT Value Description

indicated with underline)

EEE_SCALED_OUT REAL IN - Output of the engineering value
EEE_INIT BOOL IN True: Initialization Initialization request for the function
Request block
False: NonRequest Use pulse signal.

ConverterToEngineeringValue Template Manual

5/8
 Monitoring Interface
The following parameters are in structure data type. The label name is EEE_SDT_EqConvToEV.
These parameters are used as IN/OUT. Attribute in the table is the setting for OPC tag. (R: Read,
W: Write, RW: Read and Write)
Name Data Type Attribute Value Description
Unit STRING(8) R - The engineering unit
DecimalPosition WORD R 0 to 5 Number of digits displayed under the
decimal point
ActualValue REAL R - The engineering value converted from
the input value of the analog module

GOT Library
Symbol and faceplate for GOT are shown below.
They are common for ConverterToEngineeringValue and ConverterToEVForHighResolution.

Library File Name Data Name

109_ Converter.mlb 1 EqConvToEV_Symbol
2 EqConvToEV_FacePlate

Symbol (for GOT)

The symbol of this template is shown below.

Control Operability Description

No The equipment name is displayed.
No This indicates the engineering value converted
from the input value of the analog module.

ConverterToEngineeringValue Template Manual

6/8
Faceplate (for GOT)
The faceplate is shown below.

Control Operability Description

No The equipment name is displayed.
No This indicates the engineering value converted
from the input value of the analog module.

Template Property (for GOT)

Template Properties are shown below.

Data Type Data Name Description

Symbol EquipmentName Equipment name displayed on symbol
EngineeringUnit Engineering unit displayed with value on symbol
Faceplate_ScreenNo The number of Window screen linked to faceplate
Label_ActualValue System label name for ActualValue of Monitoring
Interface
Faceplate EquipmentName Equipment name displayed on faceplate
EngineeringUnit Engineering unit displayed with value on faceplate
Label_ActualValue System label name for ActualValue of Monitoring
Interface

ConverterToEngineeringValue Template Manual

7/8
Caution
1. Restoration of values
This function block stores some device values to latched devices at every scan.
After the programmable controller is turned on or the programmable controller is reset, it restores
some values stored to latched devices to corresponding devices at the first scan.
If the user changes the device value during programmable controller stop, the device value may not
be applied after the programmable controller is turned on or the programmable controller is reset.

2. Online program change

New function blocks written by online program change have to be initialized by the input of
initialization request because they may work wrong by using undefined values.

3. ToolTip
ToolTip is displayed when the cursor is on the symbol of Overview Display.

You can see the Tooltip setting in the Properties of Canvas.

If ToolTip is not needed, its setting should be False.

ConverterToEngineeringValue Template Manual

8/8