Energy Cloud Ferroamp Instructions

: September 6, 2024
: ferroamp

Table of Contents

Energy Cloud Ferroamp
Specifications
Product Usage Instructions
FAQ
Instruction
Data formats
Data addressing
Modbus Variables
Contact
Read User Manual Online (PDF format)
Download This Manual (PDF format)

Energy Cloud Ferroamp

Specifications

Supports Modbus TCP standard
Accessible on TCP port 502
16-bit unsigned integer (uint16_t) and signed integer (int16_t) data types

Product Usage Instructions

Enabling Modbus TCP Interface:

To enable the Modbus TCP interface, follow these steps:

Ensure the EnergyHub is powered on and connected to the network.
Access the EnergyHub’s local IP address.
Enable the Modbus TCP interface on TCP port 502.

Data Formats and Addressing:

The product uses uint16_t for 16-bit unsigned integers and int16_t for signed integers represented in binary two’s-complement form. Modbus Numbers follow the Modbus standard, with 3xxxx and 4xxxx referring to input and holding registers, respectively.

FAQ

Q: Is Modbus TCP interface secure?
- A: Modbus is an open protocol available for anyone to connect to without authorization. To enhance security, access is restricted to the Ethernet interface, and additional restrictions can be implemented through a firewall.
Q: What is the range of the Inverter Active Power parameter?
- A: The range of the Inverter Active Power parameter is from negative infinity to positive infinity in kilowatts (kW).

Revision History

Revision	History
PC1	• Grid Power
PB1	• Modbus v.3.0
PA3	• Modbus v.2.0, Post-review
PA2	• Modbus v.2.0, Initial specification
PA1	• Modbus v.1.0

Instruction

Ferroamp EnergyHub supports the Modbus TCP standard. Once enabled, the interface is accessible on TCP port 502 on the EnergyHub’s local IP-address. Note regarding version of this document: As of today, Ferroamp’s Modbus TCP implementation is in beta release state and compatibility between different versions of this document is not guaranteed. For changes between different versions, see the release notes in the bottom of this document.

Data formats

The float data type can be accessed in two ways. The first two addresses use the single precision (32- bit) floating point number as specified by IEEE 754 with the lower 16-bits at the lower address and the higher 16-bits at the following address. The two consecutive addresses use two signed 16-bit integers x, b such that the value represented is x * 10^b. For example, consider the grid voltage L1 located at Modbus number 32032, address 2031. At address 2031 and 2032 the data will be {f15,f14,…,f0} and {f31,f30,…,f16} respectively, where fn is the n:th bit in the floating point representation. At 2033 and 32034 the data will be {x15,x14,…,x0} and {b15,b14,…,b0} respectively. The uint16_t is a 16-bit unsigned integer and the int16_t is a signed integer represented in the binary two’s-complement form.

Data addressing

In the tables below, the Modbus Number is logic number used in the Modbus standard, where 3xxxx and 4xxxx refers to an input register and a holding register, respectively. The address (specified within the parentheses) is the actual value sent in the Modbus ADU, which is always equal the number xxxx minus one.

Security Disclaimer

Modbus is an open protocol available for anyone to connect to without any authorization. To keep the system secure, access is restricted to the Ethernet interface and if further restrictions are needed these needs to be implemented in a firewall or similar.

Modbus Variables

General data

6.1 General data|
---|---
Parameter name| Object type| Modbus number (address)| Data type| Range Notes
Modbus Major version| Input register| 31005 (1004)| uint16_t [0,65535]| Modbus major version in use
Modbus Major version| Input register| 31009 (1008)| uint16_t [0,65535]| Modbus major version in use

Energy Hub Inverter Data

Parameter name| Object type| Modbus
number (address)| Data type| Range| Unit| Notes
---|---|---|---|---|---|---
Inverter Status| Input register| 32001| uint16_t (2000)| [0,65535]| enum| 0 => unavailable, 1 =>idle,

2 => running, 3 => fault

Grid Frequency| Input register| 32017| float| [0, inf)| Hz|
| | (2016)| | | |
Grid Voltage L1| Input register| 32033| float| [0, inf)| Vrms|
| | (2032)| | | |
Grid Voltage L2| Input register| 32037| float| [0, inf)| Vrms|
| | (2036)| | | |
Grid Voltage L3| Input register| 32041| float| [0, inf)| Vrms|
| | (2040)| | | |
Grid Neutral Voltage| Input register| 32045| float| [0, inf)| Vrms| Not implemented yet
| | (2044)| | | |
Energy to DC-Nanogrid| Input register| 32065| float| [0, inf)| kWh| Incoming Energy from AC
| | (2064)| | | | Grid to DC-Nanogrid
Energy from DC-Nanogrid| Input register| 32069| float| [0, inf)| kWh| Outgoing Energy from
| | (2068)| | | | DCNanogrid to AC Grid
Inverter Active Power| Input register| 32101| float| (-inf, inf)| kW| Power based on inverter
| | (2100)| | | | active currents
Inverter Reactive Power| Input register| 32105| float| (-inf, inf)| kVAr| Power based on inverter
| | (2104)| | | | reactive currents
Inverter Apparent Power| Input register| 32109| float| [0, inf)| kVA| Power based on inverter RMS
| | (2108)| | | | currents
Inverter Active Current L1        Input register| 32113| float| (-inf, inf)| Arms| Current measured using
---|---|---|---|---|---
| (2112)| | | | internal current sensors
Inverter Active Current L2        Input register| 32117| float| (-inf, inf)| Arms| Current measured using
| (2116)| | | | internal current sensors
Inverter Active Current L3        Input register| 32121| float| (-inf, inf)| Arms| Current measured using
| (2120)| | | | internal current sensors
Inverter Reactive Current L1 Input register| 32125| float| (-inf, inf)| Arms| Current measured using
| (2124)| | | | internal current sensors
Inverter Reactive Current L2 Input register| 32129| float| (-inf, inf)| Arms| Current measured using
| (2128)| | | | internal current sensors
Inverter Reactive Current L3 Input register| 32133| float| (-inf, inf)| Arms| Current measured using
| (2132)| | | | internal current sensors
Inverter RMS Current L1         Input register| 32137| float| [0, inf)| Arms| Current measured using
| (2136)| | | | internal current sensors
Inverter RMS Current L2         Input register| 32141| float| [0, inf)| Arms| Current measured using
| (2140)| | | | internal current sensors
Inverter RMS Current L3 Input register| 32145| float| [0, inf)| Arms| Current measured using
| (2144)| | | | internal current sensors

Energyhub facility Data

The EnergyHub measures the facility power/energy through a set of external current transformers (CTs).

Parameter name| Object type| Modbus
number

(address)

| Data type| Range| Unit| Notes
---|---|---|---|---|---|---
Energy Exported To Grid      Input register| 33065| float| [0, inf)| kWh| Outgoing Energy from facility to AC Grid
---|---|---|---|---|---
| (3064)| | | |
Energy Imported From Grid Input register| 33069| float| [0, inf)| kWh| Incoming Energy from AC Grid to facility
| (3068)| | | |
Grid Voltage L1                      Input register| 32033| float| [0, inf)| Vrms|
| (2032)| | | |
Grid Active Power                  Input register| 33101| float| (-inf, inf)| kW| Power based on grid active currents
| (3100)| | | |
Grid Reactive Power             Input register| 33105| float| (-inf, inf)| kVAr| Power based on grid reactive currents
| (3104)| | | |
Grid Apparent Power          Input register| 33109| float| [0, inf)| kVA| Power based on grid RMS currents
| (3108)| | | |
Grid Active Current L1        Input register| 33113| float| (-inf, inf)| Arms| Current measured using external
| (3112)| | | | current sensors
Grid Active Current L2        Input register| 33117| float| (-inf, inf)| Arms| Current measured using external
| (3116)| | | | current sensors
---|---|---|---|---|---
Grid Active Current L3| Input register| 33121| float| (-inf, inf)| Arms| Current measured using external
| | (3120)| | | | current sensors
Grid Reactive Current L1| Input register| 33125| float| (-inf, inf)| Arms| Current measured using external
| | (3124)| | | | current sensors
Grid Reactive Current L2| Input register| 33129| float| (-inf, inf)| Arms| Current measured using external
| | (31128)| | | | current sensors
Grid Reactive Current L3| Input register| 33133| float| (-inf, inf)| Arms| Current measured using external
| | (3132)| | | | current sensors
Grid RMS Current L1| Input register| 33137| float| [0, inf)| Arms| Current measured using external
| | (3136)| | | | current sensors
Grid RMS Current L2| Input register| 33141| float| [0, inf)| Arms| Current measured using external
| | (31140)| | | | current sensors
Grid RMS Current L3| Input register| 33145| float| [0, inf)| Arms| Current measured using external
| | (3144)| | | | current sensors

Energyhub facility load

Load power/energy refers to the power from all AC grid-connected loads in the facility, with the exception of the EnergyHub.

Parameter name| Object type| Modbus
number

(address)

| type| Range| Unit| Notes
---|---|---|---|---|---|---
Load Production Energy| Input register| 34065| float| [0, inf)| kWh| Outgoing Energy from facility to AC Grid
| | (4064)| | | |
Load Consumption Energy| Input register| 34069| float| [0, inf)| kWh| Incoming Energy from AC Grid to
| | (4068)| | | | facility loads
Load Active Power| Input register| 34101| float| (-inf, inf)| kW| Power based on load active currents
| | (4100)| | | |
Load Reactive Power| Input register| 34105| float| (-inf, inf)| kVAr| Power based on load reactive currents
| | (4104)| | | |
Grid Active Current L1| Input register| 34113| float| (-inf, inf)| Arms|
| | (4112)| | | |
Grid Active Current L2| Input register| 34117| float| (-inf, inf)| Arms|
| | (4116)| | | |
Grid Active Current L3| Input register| 34121| float| (-inf, inf)| Arms|
| | (4120)| | | |
Load Reactive Current L1| Input register| 34125| float| (-inf, inf)| Arms|
| | (4124)| | | |
Load Reactive Current L2| Input register| 34129