# Virtueller Zähler

> 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/virtueller-zaehler/

_Benötigt Symcon >= 6.0_

Das Modul stellt eine Eingabemaske für manuell abgelesene Zählerstände bereit. Es übernimmt den manuellen Eintrag, prüft diesen auf Plausibilität und übergibt den Wert an eine Zählervariable. Um auf Plausibilität zu prüfen kann ein Grenzwert eingestellt werden.

### Funktionsumfang
- Prüfung auf Plausibilität
- Anzeige des zuletzt eingegebenen Zählerstandes
- Eingabemaske für neuen Zählerstand

### Software-Instalation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das Modul Virtueller Zähler installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Virtueller Zähler'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/de/service/dokumentation/grundlagen/instanzen/)

#### Konfigurationsseite:

| Name                                 | Beschreibung                                                                                                    |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| Grenzwert                            | Zahl, um die ein neuer Zählerwert maximal steigen darf. Ist der Grenzwert 0 wird nicht auf diesen überprüft     |
| Erfordere Bestätigung zum Übernehmen | Wenn Aktiviert, muss ein Script ausgeführt werden um die Plausibilitätsprüfung anzustoßen                       |
| Logging Aktivieren                   | Button, welcher das Logging der Zählervariable aktiviert. Er wird ausgeblendet, wenn das Logging aktiviert ist. |

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

#### Statusvariablen

| Name                                                                | Typ     | Beschreibung                                                                                                                                    |
| ------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Aktueller Zählerstand                                               | Float   | Zeigt den zuletzt eingetragenen Zählerstand an                                                                                                  |
| Neuer Zählerstand                                                   | String  | Eingabevariable für neuen Zählerstand                                                                                                           |
| Sicher neuen Zählerstand zu setzen: Eingabe des neuen Zählerstandes | Boolean | Erscheint, wenn der neue Zählerstand den Aktuellen um den Grenzwert überschreitet. Der Wert kann mit der Bestätigung trotzdem übernommen werden |

#### Profile

| Name                 | Typ     |
| -------------------- | ------- |
| VZ.Confirm           | Boolean |
| VZ.NewCounterReading | String  |

#### Skripte

| Bezeichnung        | Beschreibung                                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Zählerstand setzen | Führt die Überprüfung auf Plausibilität aus und schiebt den Wert bei Erfolg in die Vaiable "Aktueller Zählerstand" |

### Visualisierung
Über die Visualisierung kann der neue Zählerstand eingegeben werden und das Skript ausgeführt werden, zudem wird der zuletzt übernommene Zählerstand angezeigt.

## VZ_WriteNewCounterValue

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/virtueller-zaehler/vz-writenewcountervalue/

`void VZ_WriteNewCounterValue(int $InstanzID)`

_Benötigt Symcon >= 6.0_

Setzt nach Überprüfung den aktuellen Zählerstand

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (void): Die Funktion liefert keinerlei Rückgabewert.

ID der Instanz

**Beispiel**

```php
VZ_WriteNewCounterValue(12345);
```