# LGF_IsValueInTolerance (FC / 3.0.2)

Übersicht

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

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
value | LReal | Wert, der geprüft werden soll, ob er sich im definierten Wertebereich befindet
setpoint | LReal | Sollwert
tolerance | LReal | Toleranzbereich um den Sollwert in Prozent (%)

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | Bool | Rückgabewert: TRUE wenn sich "value" im Wertebereich (Bereich um den Sollwert) befindet
overHighLimit | Bool | TRUE, wenn "value" größer ist als der obere Grenzwert
belowLowLimit | Bool | TRUE, wenn "value" kleiner ist als der untere Grenzwert
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Status: kein Fehler aufgetreten
16#8401 | ERR_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

## Änderungshistorie

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