LGF_IsValueInTolerance (FC / V3.0.2)


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 Toleranzbereich um den Sollwert in Prozent (%) definiert. Die Funktion berechnet die untere und obere Grenze des Wertebereichs.

Baustein Schnittstelle

LGF_IsValueInTolerance (FC)
LReal  value Ret_Val  Bool
    
LReal  setpoint overHighLimit  Bool
    
LReal  tolerance belowLowLimit  Bool
    
   error  Bool
    
   status  Word
    
   

Input Parameter

BezeichnerDatentypBeschreibung
valueLRealWert, der geprüft werden soll, ob er sich im definierten Wertebereich befindet
setpointLRealSollwert
toleranceLRealToleranzbereich um den Sollwert in Prozent (%)

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: Fehlerhafte Werte während der Berechnung der Grenzwerte

Funktionsbeschreibung

Die Variable setpoint und tolerance in Prozent 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_IsValueInTolerance - Funktionsweise

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Siemens Industry Support
10.12.2019First released version
Copied from "IsValueInRange"
03.00.00Simatic Systems Support
23.04.2020Set version to V3.0.0, harmonize the version of the whole library
03.00.02Simatic Systems Support
12.11.2020Bug fix - negative setpoint verification
Insert documentation