# EditRealVisu

## `EditRealVisu` (FB)

FUNCTION\_BLOCK EditRealVisu

### Kurzbeschreibung

> Eingabe eines numerischen Wertes mit Eingabegrenzen (Visualisierung)\
> \
> Typische Anwendung: Eingabe einer Solltemperatur in der Visualisierung\
> \
> Besonderheit: Min/Max Eingaben, Einheit, Nachkommastellen und weitere Parameter 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="/files/llMt7nkuJKNuBnwpKwwl" alt=""><figcaption></figcaption></figure>

### Schnittstellen

#### 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                                                         |
| **sDialogTitle**      | STRING   |              |             | Dialogtitel des Eingabewerts                                                        |
| **sUnit**             | STRING   |              |             | Einheit des Eingabewerts                                                            |
| **rMaxInputVisu**     | REAL     |              | 100.0       | Obere Eingabegrenze des Eingabewerts                                                |
| **rMinInputVisu**     | REAL     |              | 0.0         | Untere Eingabegrenze des Eingabewerts                                               |
| **rSetPoint**         | REAL     |              | 0.0         | Numerischer Eingabewert                                                             |

### Funktionsbeschreibung

#### Allgemeines

Dieser Funktionsbaustein dient zur Übergabe eines numerischen Eingabewerts **rSetPoint** und die direkte Übertragung zum numerischen Ausgabewert *rOut*.\
Zusätzlich können hier weitere Eigenschaften des Eingabewerts definiert werden, die jedoch nicht im Funktionsbaustein, sondern zum Beispiel in einem geeigneten Visualisierungselement Verwendung finden.\
\
So können die Anzahl der Nachkommastellen **bDecimals**, der Titel des Eingabewerts **sDialogTitle**, die Einheit des Eingabewerts **sUnit** sowie die Eingabegrenzwerte **rMinInputVisu** und **rMaxInputVisu** an das Visualisierungselement übergeben werden und dort bei der Eingabe Berücksichtigung finden.\
Mit dem Parameter **xDisableSeparator** kann das Tausender-Trennzeichen in der Visualisierung deaktiviert werden.

{% hint style="warning" %}
**Verhalten bei Spannungsausfall**

Alle Sollwerte / Parameter werden spannungsausfallsicher gespeichert und automatisch wiederhergestellt.
{% endhint %}

### Visualisierung

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

#### Darstellung

<figure><img src="/files/nu6gSRVO8gVVpbJAtz6Z" 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 Eingabens des FB HVAC.EditRealVisu werden automatisch übernommen und können zur Laufzeit geändert werden: rMinInputVisu, rMaxInputVisu, sUnit, sDialogTitle, bDecimals, xDisableSeperator

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

### CODESYS

InOut:

| Scope       | Name                | Type     | Initial |
| ----------- | ------------------- | -------- | ------- |
| Input Const | `xDisableSeparator` | `BOOL`   |         |
| Input Const | `bDecimals`         | `BYTE`   | 1       |
| Input Const | `sDialogTitle`      | `STRING` |         |
| Input Const | `sUnit`             | `STRING` |         |
| Input Const | `rMaxInputVisu`     | `REAL`   | 100     |
| Input Const | `rMinInputVisu`     | `REAL`   | 0       |
| Input Const | `rSetPoint`         | `REAL`   | 0       |
| Output      | `rOut`              | `REAL`   |         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.powerio.com/hub/codesys-hvac/hvac-library/functionblocks/setpoint/editrealvisu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.