---
title: Realtime energy data [Modbus TCP Server]
slug: dev/realtime-energy-data-modbus-tcp-server
createdAt: 2024-04-16T12:34:12.086Z
---

:::hint{type="info"}
To activate the modbus TCP port, please contact support\@clemap.com

To activate the write registers also note to the clemap engineer. (The cascading module needs to be activated).
:::

:::hint{type="danger"}
Note that Modbus and RestAPI overwrite each other.
:::

:::hint{type="warning"}
All registers are **holding registers**.

**Modbus port:** 5020

**Ip Address:** \<clemap\_device\_ip\_address>
:::

<u>**Read registers:**</u>

| Register | Type      | Name                    | Unit |
| -------- | --------- | ----------------------- | ---- |
| 19000    | float f32 | Voltage L1-N            | V    |
| 19002    | float f32 | Voltage L2-N            | V    |
| 19004    | float f32 | Voltage L3-N            | V    |
| 19012    | float f32 | Current I L1            | A    |
| 19014    | float f32 | Current I L2            | A    |
| 19016    | float f32 | Current I L3            | A    |
| 19018    | float f32 | Vector sum; IN=I1+I2+I3 | A    |
| 19020    | float f32 | Real power P L1         | W    |
| 19022    | float f32 | Real power P L2         | W    |
| 19024    | float f32 | Real power P L3         | W    |
| 19026    | float f32 | Sum; Psum3=P1+P2+P3     | W    |
| 19028    | float f32 | Apparent power S L1     | VA   |
| 19030    | float f32 | Apparent power S L2     | VA   |
| 19032    | float f32 | Apparent power S L3     | VA   |
| 19034    | float f32 | Sum; Ssum3=S1+S2+S3     | VA   |
| 19036    | float f32 | reactive power Q L1     | var  |
| 19038    | float f32 | reactive power Q L2     | var  |
| 19040    | float f32 | reactive power Q L3     | var  |
| 19042    | float f32 | Sum; Qsum3=Q1+Q2+Q3     | var  |

<u>**Write Registers**</u>

:::hint{type="danger"}
Take in consideration that each register has to be written individually. For example when you write FallbackCurrentLimit, you write directly on 19052.

Block writes are not supported yet.
:::

| Register | Type      | Name                                                                                                                                                                                                                                                                                                                                                                | Unit         |
| -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| 19050    | float f32 | **ActivePowerActivation**<br />Enable or disable LM controll over modbus or API:<br />Activates Registers 19052 and 19054 and KeepAlive timer.                                                                                                                                                                                                                      | bool \[0, 1] |
| 19052    | float f32 | **FallbackCurrentLimit**<br />Limit set if keep no endpoint is not called in 120 sec (default).<br />The default limit is min\_current\_limit set on the config of the resource of the device.                                                                                                                                                                      | A            |
| 19054    | float f32 | **Current Limit**<br />Load management current limit                                                                                                                                                                                                                                                                                                                | A            |
| 19056    | float f32 | **Keep Alive**: cab be used write every 120s, else CurrentLimit falls into FallbackCurrentLimit values.<br />Please note that writing any of the other Write Register, will also do the trick. <br />If you want to change the default 120s, it can be overwritten in the config. Please contact support\@clemap.com for this:<br />FLEX\_CONTROL\_MESSAGE\_TIMEOUT | int          |

