# VirtuelleMessstelle

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/virtuellemessstelle/

_Benötigt Symcon >= 5.5_

Rechnet positive Variablenänderungen nach einstellbaren Regeln mit Veränderungen einer Hauptvariable zusammen und addiert dieses mit dem Wert einer Variable.

*Das Modul „Smart Energy Box“ wurde in Kooperation zwischen der Symcon GmbH, Stark Elektronik GmbH und der Hochschule Biberach (Institut IGE) im Rahmen des Landesprojektes EnMa HAW: Konzept für automationsgestütztes Energiemanagement an nicht-universitären Hochschulen in Baden-Württemberg entwickelt.*

### Funktionsumfang
- Auswahl einer geloggten Variable als primären Messstelle
- Auswahl beliebig vieler Variablen als sekundären Messstellen
- Einstellbar, ob die Veränderungen der sekundären Messtellen zu den Veränderungen der primären Messstellen addiert oder subtrahiert werden sollen

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das 'Virtuelle Messstelle'-Modul installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter 'Instanz hinzufügen' kann das 'Virtuelle Messstelle'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)

### Konfigurationsseite:

| Name                 | Beschreibung                                                                                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Primäre Messstelle   | Auswahl einer geloggten Variable                                                                                                                      |
| Sekundäre Messstelle | Mehrfachauswahl von Variablen                                                                                                                         |
| Operation            | Addieren/Subtrahieren Option, ob die positive Veränderung der sekundären Messstelle zu der primären Messstelle hinzugefügt oder abgezogen werden soll |
| Variable             | Auswahl einer geloggte Variable als sekundäre Messstelle                                                                                              |

### Statusvariablen
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

#### Statusvariablen

| Name     | Typ   | Beschreibung         |
| -------- | ----- | -------------------- |
| Ergebnis | Float | Errechnetes Ergebnis |

## VM_Update

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/virtuellemessstelle/vm-update/

`bool VM_Update(int $InstanzID, float $PrimaryDelta)`

_Benötigt Symcon >= 5.5_

Berechnet die Steigung der sekundären Messstellen und addiert dieses mit dem Ergebnis

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$PrimaryDelta` (float): Positive Veränderung der Hauptmessstelle

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Positive Veränderung der Hauptmessstelle

**Beispiel**

```text
VM_Update(12345, 5.3);
```