# Calculated Counter

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/calculated-counter/

_Requires Symcon >= 5.5_

Calculates positive variable changes with changes of a main variable according to adjustable rules and adds this to the value of a variable.

*The "Smart Energy Box" module was developed in cooperation between Symcon GmbH, Stark Elektronik GmbH and Biberach University of Applied Sciences (IGE Institute) as part of the state project EnMa HAW: Concept for automation-supported energy management at non-university universities in Baden-Württemberg.*

### functional scope
- Selection of a logged variable as primary measuring point
- Selection of any number of variables as secondary measuring points
- Adjustable whether the changes of the secondary measuring points should be added or subtracted to the changes of the primary measuring points

### software installation
- Install the 'Calculated Counter' module via the [Module Store](https://www.symcon.de/en/service/documentation/components/management-console/module-store/).

### Set up instances in IP-Symcon
- Under 'Add instance' the 'Calculated Counter' module can be found using the quick filter.
  - More information about adding instances in the [Instances documentation](https://www.symcon.de/en/service/documentation/basics/instances/)

### Configuration Page:

| Name                      | Description                                                                                                                            |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Primary measuring point   | Selection of a logged variable                                                                                                         |
| Secondary measuring point | Multiple selection of variables                                                                                                        |
| Operation                 | Add/Subtract Option whether to add or subtract the positive change of the secondary measurement point to the primary measurement point |
| Variable                  | Selection of a logged variable as secondary measuring point                                                                            |

### status variables
The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.

#### Status variables

| Name   | Type  | Description       |
| ------ | ----- | ----------------- |
| Result | Float | Calculated Result |

## VM_Update

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/calculated-counter/vm-update/

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

_Requires Symcon >= 5.5_

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

**Parameters**

- `$InstanceID` (int): ID of the Instance
- `$PrimaryDelta` (float): Positive Veränderung der Hauptmessstelle

**Returns** (bool): If the command could be executed successfully, it returns __TRUE__ as result, otherwise __FALSE__.

Positive Veränderung der Hauptmessstelle

**Example**

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