# DisplayRealVisu

## `DisplayRealVisu` (FB)

FUNCTION\_BLOCK DisplayRealVisu

### Kurzbeschreibung

> Anzeige eines numerischen Wertes mit Korrekturwert (Visualisierung)\
> \
> Typische Anwendung: Abgleich eines Temperaturfühlers in der Visualisierung\
> \
> Besonderheit: Einheit, Nachkommastellen und weitere Paramter werden direkt im CFC Editor parametriert und nicht im Visualisierungsobjekt.\
> Dies ermöglicht, Änderungen und Grenzwerte online in der Applikation ohne Download zu ändern.

### Darstellung

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-c1b59da32cb29264e9aec56b5b12eee2938d347a%2Fimage%20(30).png?alt=media" alt=""><figcaption></figcaption></figure>

### Schnittstellen

#### Eingänge

| Name     | Datentyp | Wertebereich | Initialwert | Funktion     |
| -------- | -------- | ------------ | ----------- | ------------ |
| *rInRaw* | REAL     |              |             | Eingangswert |

#### Ausgänge

| Name   | Datentyp | Wertebereich | Initialwert | Funktion                |
| ------ | -------- | ------------ | ----------- | ----------------------- |
| *rOut* | REAL     |              |             | Numerischer Ausgabewert |

#### Sollwerte / Parameter

| Name                  | Datentyp | Wertebereich | Initialwert | Funktion                                                                            |
| --------------------- | -------- | ------------ | ----------- | ----------------------------------------------------------------------------------- |
| **xDisableSeparator** | BOOL     |              | FALSE       | TRUE = Deaktiviert das tausender Trennzeichen bei der Anzeige in der Visualisierung |
| **bDecimals**         | BYTE     |              | 1           | Anzahl der Nachkommastellen                                                         |
| **sSymbol**           | STRING   |              |             | Symbol in der Visualisierung                                                        |
| **sUnit**             | STRING   |              |             | Einheit des Eingabewerts                                                            |
| **rOffset**           | REAL     |              | 0.0         | Korrekturwert                                                                       |

### Funktionsbeschreibung

#### Allgemeines

Der Ausgangswert *rOUT* wird durch die Addition des Eingangswerts *rInRaw* mit dem Korrekturwert **rOffset** gebildet.\
Zusätzlich können hier weitere Eigenschaften des Ausganswerts definiert werden, die jedoch nicht im Funktionsbaustein, sondern zum Beispiel in einem geeigneten Visualisierungselement Verwendung finden.\
\
Mit dem Paramter **xDisableSeparator** kann das Tausender-Trennzeichen in der Visualisierung deaktiviert werden.

### Visualisierung

Passendes Visualisierungselement aus der HVACV Visu Library: **DisplayRealVisu**

#### Darstellung

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-8ba1328f913c895253c041ba18583c2473ef3242%2Fimage%20(29).png?alt=media" alt=""><figcaption></figcaption></figure>

#### Schnittstellen Visu-Element

| Name            | Datentyp         | Typ          | Initialwert | Funktion                                                                                                                    |
| --------------- | ---------------- | ------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
| **rValue**      | FB\_EditRealVisu | VAR\_IN\_OUT |             | FB Instanz HVAC.EditRealVisu hier eintragen z.B. PRG.EditRealVisu                                                           |
| **iFieldSizeL** | INT              | VAR\_INPUT   | 0           | Feld vergrößert sich um Anzahl der eingegebenen Pixel nach links. Wird benötigt um lange Zahlen oder Einheiten anzuzeigen.  |
| **iFieldSizeR** | INT              | VAR\_INPUT   | 0           | Feld vergrößert sich um Anzahl der eingegebenen Pixel nach rechts. Wird benötigt um lange Zahlen oder Einheiten anzuzeigen. |

Folgende Eingaben des FB HVAC.DisplayRealVisu werden automatisch übernommen und können zur Laufzeit geändert werden: rOffset, sUnit, sSymbol, bDecimals, xDisableSeperator.

{% hint style="info" %}
Hinweis: VAR\_IN\_OUT Schnittstellen müssen belegt werden, VAR\_INPUT sind optional.&#x20;
{% endhint %}

### CODESYS

InOut:

| Scope       | Name                | Type     | Initial |
| ----------- | ------------------- | -------- | ------- |
| Input       | `rInRaw`            | `REAL`   |         |
| Input       | `xAlarm`            | `BOOL`   |         |
| Input Const | `xDisableSeparator` | `BOOL`   |         |
| Input Const | `bDecimals`         | `BYTE`   | 1       |
| Input Const | `sSymbol`           | `STRING` | ‘A’     |
| Input Const | `sUnit`             | `STRING` |         |
| Input Const | `rOffset`           | `REAL`   | 0       |
| Output      | `rOut`              | `REAL`   |         |