# Energy 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/energy-counter/

Calculates the consumption

## Energy Counter Pulse

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

_Requires Symcon >= 4.2_

The module calculates the instantaneous and cumulative power consumption via an electricity meter (e.g. S0 connection).

### Function scope
- Calculates the instantaneous power consumption in watts and the total power consumption in kWh.
- Adjustability of the pulses of the counting device.
- Adjustability of interval frequency in seconds for recalculation of consumption

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

### Setting up instances in IP-Symcon
- Under "Add Instance", the 'Energy Counter Pulse' 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                                                                                                                                                                                                                                                                                                               |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source   | Source variable (pulse counter) to be used for the calculation.                                                                                                                                                                                                                                                           |
| Pulses   | How many pulses the device sends per kilowatt. This must be taken from the respective operating manual of the device.                                                                                                                                                                                                     |
| Interval | In which seconds interval the device should recalculate automatically. (Note: Intervals that are set too short (faster than incoming pulses), can lead to strong fluctuations in the indication of the current consumption. It has no influence on the calculated total consumption. => Recommendation: min. 300 seconds) |

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

#### Statusvariables

| Name                   | Type  | Description                                                             |
| ---------------------- | ----- | ----------------------------------------------------------------------- |
| Current                | Float | Specification in W                                                      |
| Counter                | Float | Specification in kWh                                                    |
| Last Value (Temporary) | Float | Auxiliary variable for last value. Required for difference calculation. |

## EZI_Update

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

`bool EZI_Update(int $InstanceID)`

_Requires Symcon >= 4.2_

**Parameters**

- `$InstanceID` (int): ID of the Instance

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

ID of the Instance

**Example**

```text
EZI_Update(12345);
```

## Energy Counter Power

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

_Requires Symcon >= 4.2_

The module calculates the instantaneous and cumulative power consumption via an electricity meter (current or power).

### function scope
- Calculates instantaneous power consumption in watts and total power consumption in kWh.
- Adjustability of type and source of the counting device.
- Adjustability of the interval frequency in seconds to recalculate the consumption if the source variable has not changed.

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

### Setting up instances in IP-Symcon
- Under "Add Instance", the 'Energy Counter Power' 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                                                                                                            |
| -------- | ---------------------------------------------------------------------------------------------------------------------- |
| Type     | Is the source variable of type power (W) or current (A).                                                               |
| Source   | Source variable to be used for the calculation.                                                                        |
| Voltage  | Voltage (V) to be used for conversion.                                                                                 |
| Interval | At which seconds interval the calculation should be automatically recalculated if the source variable has not changed. |

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

#### Status variables

| Name     | Description                                                                                                            |
| -------- | ---------------------------------------------------------------------------------------------------------------------- |
| Type     | Is the source variable of type power (W) or current (A).                                                               |
| Source   | Source variable to be used for the calculation.                                                                        |
| Voltage  | Voltage (V) to be used for conversion.                                                                                 |
| Interval | At which seconds interval the calculation should be automatically recalculated if the source variable has not changed. |

## EZS_Update

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

`bool EZS_Update(int $InstanceID)`

_Requires Symcon >= 4.2_

**Parameters**

- `$InstanceID` (int): ID of the Instance

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

ID of the Instance

**Example**

```text
EZS_Update(12345);
```