LGF_IsValueInLimits (FC / V3.0.1)

Overview

Author: Siemens Digital Industries

Short description

The function checks whether a value is within a defined value range. The value range is defined with a lower and an upper limit.

Block Interface

LGF_IsValueInLimits (FC)
LReal  value Ret_Val  Bool
    
LReal  lowLimit overHighLimit  Bool
    
LReal  highLimit belowLowLimit  Bool
    
   error  Bool
    
   status  Word
    
   

Input parameter

IdentifierData type Description
valueLReal Value to be checked to determine whether it is within the defined value range
lowLimitLReal Low limit where the value is checked against to be greater
highLimitLReal High limit where the value is checked against to to be less

Output parameter

IdentifierData type Description
Ret_ValBool Return: TRUE if the “value” is in the value range (range of the set point)
overHighLimitBool TRUE if the “value” is greater than the upper limit value
belowLowLimitBool TRUE, if the “value” is less than the lower limit value
errorBool FALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord 16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_NO_ERROR
Status: no error occurred
16#8401ERR_RANGE_HIGH_BELOW_LOW_LIMIT
Error:High limit less then low limit

Functional description

The variables lowLimit and highLimit define a value range.
The function checks whether the value is below, in or above the value range. The outputs belowLowLimit, Ret_Val, or overHighLimit show where the value is located.

Figure: Principle of operation

LGF_IsValueInLimits - Principle of operation

Change log

Version & DateChange description
01.00.00Siemens Industry Support
10.12.2019First released version
Copied from "IsValueInRange"
03.00.00Siemens Industry Support
23.04.2020Set version to V3.0.0, harmonize the version of the whole library
03.00.01Simatic Systems Support
12.11.2020Insert documentation