EcoSystem · openWB Energy Monitoring

ecomain Integration With OpenWB

ecoMain turns your electrical panel into a multi-channel energy data source for openWB. It provides grid import and export, solar generation, and L1/L2/L3 phase data, helping openWB manage site load and make better use of PV surplus for EV charging.

View ecoMain Start setup
openWB status page showing ecoMain grid meter and solar PV inverter after configuration
After setup, openWB can show ecoMain as the EVU/Grid Meter and selected Solar PV circuits as EcoMain inverter components.
Optional expansion Use ecoSub only when extra Solar PV channels are needed.
Local connection Connect ecoMain and openWB directly on the local network.
Grid + solar See grid and Solar PV data in one system.
Built for charging control Supply live data for load management and PV surplus charging.

Why ecoMain

openWB needs reliable energy data to balance household demand, solar generation, and EV charging. ecoMain measures the main grid connection and Solar PV circuits and makes those live readings available directly to openWB.

This gives openWB a clear view of whether the site is importing or exporting power, how much load is present on each phase, and how much solar surplus is available for charging. ecoSub is optional and is only needed when the installation requires more monitoring channels than ecoMain alone provides.

Whole-site visibility

View the main grid connection, phase data, and Solar PV generation in one system.

Expandable design

Start with ecoMain. Add ecoSub later only if more Solar PV monitoring channels are required.

Local data connection

Exchange energy data directly between ecoMain and openWB on the local network.

Smarter charging

Provide live measurements for openWB load management and PV surplus charging.

What You Can Monitor

Once ecoMain is connected, the current openWB integration provides two energy component types: the main circuit as an EcoMain EVU-Zähler (Grid Meter), and selected solar circuits as single- or three-phase EcoMain Wechselrichter (Solar PV inverter) components.

What you can monitor How openWB uses it
Grid import and export Shows the direction of energy flow between the site and the grid.
Live total power at the main connection Provides the current power state for load management and charging control.
L1/L2/L3 power, voltage, and current Helps openWB monitor phase load and control charging.
L1/L2/L3 power factor Adds more complete electrical information for the main connection.
Live Solar PV power Shows current solar generation and available surplus.
Solar PV current by phase Maps single- or three-phase generation to the correct phases.
Cumulative grid and solar energy Supports openWB status displays and historical energy views.

ecoMain can also measure other circuits, but the current openWB integration uses selected branch circuits for Solar PV inverter components. Do not configure a general load or EV charger circuit as an inverter, as this would affect openWB energy calculations.

Channel Mapping

Before setup, record which ecoMain channel is connected to each solar circuit, and whether that circuit belongs to L1, L2, or L3. If optional ecoSub modules are installed for extra channels, include their device and channel assignments in the same record.

Interface option How to use it
Hauptgerät (Main device) Select when the current sensor is connected to the ecoMain host.
Slave 1, Slave 2, Slave 3 Select only when the current sensor is connected to an optional ecoSub expansion module.
Kanal 1-10 (Channel 1-10) Select the channel connected to the solar circuit on that device.
Einphasig (Single-phase) Select for a solar circuit using one phase.
Dreiphasig (Three-phase) Select for a solar circuit using L1, L2, and L3.
Phase: L1, L2, L3 Match each channel to the phase used in the physical installation.
Messrichtung invertieren Enable only when the displayed power direction is opposite to the actual generation direction.

Single-phase Solar PV example

Phase Source Channel
L1 Hauptgerät Kanal 1

A single-phase component uses one channel. Select L1, L2, or L3 to match the actual solar circuit connection.

Three-phase Solar PV example

Phase Source Channel
L1 Hauptgerät Kanal 1
L2 Slave 1 Kanal 3
L3 Slave 2 Kanal 10

A three-phase component uses three channels, with L1, L2, and L3 configured once each. The channels can come from ecoMain alone, or from ecoMain plus optional ecoSub modules if the installation uses expansion channels.

During normal solar generation, Solar PV power in openWB should appear in the generation direction. If the status page shows the opposite direction, first check the installation direction of the current sensor. After confirming the installation, enable Messrichtung invertieren in the inverter settings if needed.

Requirements

Prepare the following hardware, software, and site information before setup:

Item Requirement
ecoMain Installed and connected to the home or site electrical system.
ecoSub Optional. Required only if the site needs additional monitoring channels beyond ecoMain.
Current sensors Installed on the main grid circuit and the Solar PV circuits to be connected to openWB.
ecoMain firmware Version 139 or newer.
openWB A version that includes ecoMain integration support.
Local network ecoMain and openWB are on a local network where they can reach each other.
Connection details The ecoMain IP address or hostname and the complete serial number, including leading zeroes.
Channel record A list of the Main device/Slave, Channel, and L1/L2/L3 assignment for each solar circuit.

If ecoMain or the required current sensors have not yet been installed, complete the electrical installation according to the relevant enecess installation instructions before configuring openWB. Install ecoSub only when additional monitoring channels are needed.

Setup Guide

1. Add ecoMain Add enecess EcoMain as a device in openWB.
2. Add Grid Meter Add EcoMain EVU-Zähler for the main grid connection.
3. Add Solar PV Add single- or three-phase EcoMain Wechselrichter components.
4. Verify status Check grid direction, phases, Solar PV values, and load management.

Step 1: Add enecess ecoMain

  1. Sign in to the openWB web interface.
  2. Open Konfiguration → Geräte und Komponenten.
  3. Under Hersteller, select enecess.
  4. Under Verfügbare Geräte, select and add EcoMain.
openWB configuration screen showing enecess manufacturer and EcoMain device selection
Select enecess as the manufacturer, then add EcoMain under available devices.

Expand the EcoMain device and enter IP-Adresse / Hostname and Seriennummer. Enter the complete serial number and preserve any leading zeroes, then save the settings.

openWB EcoMain settings showing IP address hostname and serial number fields
Enter the ecoMain IP address or hostname and the complete serial number, including leading zeroes.

Step 2: Add the EcoMain EVU/Grid Meter

  1. Expand the EcoMain device you just added.
  2. Under Verfügbare Komponenten, add EcoMain EVU-Zähler.
  3. Save the settings.

This component uses the ecoMain main-circuit data as the EVU/Grid Meter in openWB. No branch channel selection is required.

openWB EcoMain EVU grid meter component added below ecoMain device
Add EcoMain EVU-Zähler as the grid meter component below the EcoMain device.

Step 3: Add single-phase Solar PV

  1. Add EcoMain Wechselrichter below EcoMain.
  2. Set Phasenanzahl to Einphasig.
  3. Use the channel record to select Phase, Quelle, and Kanal.
  4. Save the settings.
openWB single-phase EcoMain Wechselrichter settings with phase source and channel selection
For single-phase Solar PV, select one phase, source device, and channel.

Step 4: Add three-phase Solar PV

  1. Add or expand EcoMain Wechselrichter below EcoMain.
  2. Set Phasenanzahl to Dreiphasig.
  3. Select the correct Main device/Slave and Channel for L1, L2, and L3.
  4. Save the settings.
openWB three-phase EcoMain Wechselrichter settings with L1 L2 and L3 channel selections
For three-phase Solar PV, assign one channel each for L1, L2, and L3.

Step 5: Arrange the Load Management hierarchy

  1. Open Konfiguration → Lastmanagement.
  2. Under Struktur, place the EcoMain EVU/Grid Meter at the grid connection point.
  3. Arrange the Solar PV inverter, charge points, and other components according to the physical electrical topology.
  4. Review the load management settings and save.
openWB load management hierarchy with EcoMain grid meter and Solar PV components
Arrange the EcoMain EVU/Grid Meter, Solar PV inverter, charge points, and other components according to the physical topology.

Step 6: Check the status page

Open the openWB status page while the home is using power and the solar system is generating, then check:

  • whether the Grid Meter import or export direction matches the actual site condition;
  • whether L1, L2, and L3 power and current values are plausible;
  • whether Solar PV power appears in the generation direction;
  • whether single-phase Solar PV is assigned to the correct phase;
  • whether all three channels of a three-phase Solar PV component are present.

If the Solar PV direction is reversed, check the current sensor direction and, after confirming the installation, use Messrichtung invertieren.

openWB status page showing EcoMain grid meter Solar PV power and phase data
Check the status page to verify grid direction, Solar PV power, and L1/L2/L3 values.

FAQ

Does the ecoMain connection to openWB require a cloud account?

No. ecoMain and openWB connect directly on a local network where they can reach each other. Everyday energy data transfer does not depend on a cloud account.

What main-circuit information is available in openWB?

The EcoMain EVU/Grid Meter provides grid import and export, live total power, and L1/L2/L3 power, voltage, current, and power factor. openWB can use this data for status displays and load management.

Can ecoMain connect both single-phase and three-phase Solar PV to openWB?

Yes. For single-phase Solar PV, select one channel and its actual phase. For three-phase Solar PV, select one channel for each of L1, L2, and L3.

When do I need ecoSub for openWB?

ecoSub is not required for every openWB setup. Use it only when the Solar PV circuits you want to connect need more monitoring channels than ecoMain alone provides.

Why is the complete serial number important?

openWB uses the serial number to identify the ecoMain it is connecting to. Enter it exactly as shown by the device or on its label, including any leading zeroes.

What should I do if Solar PV power is shown in the wrong direction?

First check the installation direction of the corresponding current sensor. If the physical installation causes the reading to be opposite to the actual generation direction, enable Messrichtung invertieren for that inverter component.

What should I check if ecoMain cannot connect?

Confirm that ecoMain is powered on, the IP address or hostname is correct, the complete serial number is entered correctly, firmware version 139 or newer is installed, and ecoMain and openWB can reach each other on the local network.

Which circuits can the current openWB integration monitor?

The current integration uses the ecoMain main circuit as the EVU/Grid Meter and selected branch circuits as single- or three-phase Solar PV inverter components.

Build a Scalable openWB Energy Monitoring System with ecoMain

Start with ecoMain for the main grid connection and Solar PV data openWB needs for load management and PV surplus charging. If the installation later requires more Solar PV monitoring channels, add optional ecoSub modules while keeping energy flow visible in one local system.

View ecoMain Start openWB setup
Previous Next