LGF_IsValueInRange (FC / V3.0.1)


Autor: Siemens Digital Industries

Kurzbeschreibung

Die Funktion prüft, ob ein Wert sich in einem definierten Wertebereich befindet.
Der Wertebereich wird mit einem Sollwert und einem Bereich um diesen Sollwert definiert. Die Funktion berechnet die untere und obere Grenze des Wertebereichs.

Baustein Schnittstelle

LGF_IsValueInRange (FC)
LReal  value Ret_Val  Bool
    
LReal  setpoint overHighLimit  Bool
    
LReal  range belowLowLimit  Bool
    
   error  Bool
    
   status  Word
    
   

Input Parameter

BezeichnerDatentypBeschreibung
valueLRealWert, der geprüft werden soll, ob er sich im definierten Wertebereich befindet
setpointLRealSollwert
rangeLRealBereich in dem der Sollwert im Wertebereich liegt

Output Parameter

BezeichnerDatentypBeschreibung
Ret_ValBoolRückgabewert: TRUE wenn sich "value" im Wertebereich (Bereich um den Sollwert) befindet
overHighLimitBoolTRUE, wenn "value" größer ist als der obere Grenzwert
belowLowLimitBoolTRUE, wenn "value" kleiner ist als der untere Grenzwert
errorBoolFALSE: Kein Fehler
TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
statusWord16#0000-16#7FFF: Status des FB
16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_NO_ERROR
Status: kein Fehler aufgetreten
16#8401ERR_RANGE_LIMIT_VALUES
Error: Fehler bei der Berechnung der Grenzwerte

Funktionsbeschreibung

Die Variable setpoint und range definieren einen Wertebereich.
Die Funktion prüft, ob sich der Wert value unter, in oder über dem Wertebereich befindet. Die Ausgänge belowLowLimit, Ret_Val oder overHighLimit geben aus, wo sich der Wert value befindet.

Abbildung: Funktionsweise

LGF_IsValueInRange - Principle of operation

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Siemens Industry Online Support
30.01.2017First released version
01.00.01Siemens Industry Online Support
17.08.2018Upgrade: TIA V15 Update 2
01.00.02Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
01.01.00Simatic Systems Support
13.11.2019renamed from "LGF_HighLowLimit" to "LGF_IsValueInRange"
Code refactoring
error values changed, regions, comments and constant’s are added
03.00.00Simatic Systems 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