EcoSystem · evcc Energy Management
ecoMain Integration With EVCC
ecoMain turns your electrical panel into a multi-channel, real-time energy data source for evcc. With one system, evcc can receive data for grid import and export, solar PV production, EV charging, heat pumps and house loads.
Why Use ecoMain with evcc?
Solar surplus charging in evcc depends on real-time energy data. Installed on the main incoming lines and selected branch circuits, ecoMain continuously tells evcc whether the site is importing power from the grid or exporting power to it, how much solar power is being produced, and how much power the vehicle and other devices are consuming.
With this data, evcc can adjust charging power according to the actual energy flow at the site. This helps the vehicle use more locally generated solar energy while reducing unnecessary grid consumption.
Monitor the grid connection, solar PV, EV charging and selected circuits together.
Provide the real-time feedback evcc needs for solar surplus control.
Use ecoMain as an external meter for chargers without an integrated meter.
Expand from the ecoMain branch channels to additional channels when the project needs more measurement points.
Local, Open and Ready for Energy Automation
ecoMain communicates with evcc over the local network. Energy measurements do not need to be uploaded to the cloud first, making the integration suitable for locally controlled homes and small commercial sites that need detailed circuit-level visibility.
The same ecoMain system can serve several measurement roles in evcc. The main circuit can be used as the grid meter, while branch channels can be configured as solar, charging or auxiliary load meters. This reduces the need for separate metering devices and keeps energy data within one consistent measurement system.
What You Can Monitor
After ecoMain is integrated with evcc, you can monitor the site-level and circuit-level data evcc needs for energy visualization and PV charging control.
Real-time grid power plus forward and reverse energy totals from the main circuit.
Real-time solar production and cumulative energy from one or three branch channels.
Charging power and cumulative energy when ecoMain is used as an external charging meter.
Heat pumps, heating elements, house loads and selected circuits that affect site energy flow.
Supported ecoMain Measurement Roles in evcc
| evcc usage | ecoMain data source | Data provided to evcc | Typical use |
|---|---|---|---|
| Grid Meter | ecoMain main circuit | Total power, three-phase power, voltage, current, imported and exported energy totals. | Grid connection measurement and solar surplus control. |
| Solar PV | 1 or 3 branch channels | Total solar power, phase values, forward and reverse energy totals. | AC-side solar inverter monitoring. |
| EV Charger / Consumer | 1 or 3 branch channels | Real-time power, phase values and cumulative energy. | External EV charger meter or regular consumer. |
| Auxiliary Consumer | 1 or 3 branch channels | Real-time power, phase values and cumulative energy. | Self-regulating heat pump, heating element or other auxiliary consumer. |
Channel Mapping Before Setup
Before configuration, record the circuit connected to each ecoMain channel. The example below represents a home with solar PV, a heat pump and an EV charger. Your mapping may be different depending on the installation.
| ecoMain channel | Connected device | evcc configuration example |
|---|---|---|
| Main circuit | Main incoming lines | Grid Meter |
| Channel 1 | Three-phase heat pump, phase 1 | First channel of the three-phase load |
| Channel 2 | Three-phase heat pump, phase 2 | Second channel of the three-phase load |
| Channel 3 | Three-phase heat pump, phase 3 | Third channel of the three-phase load |
| Channel 4 | Solar PV | Solar PV, single-phase, ecoMain channel 4 |
| Channel 5 | House Load | Consumer, single-phase, ecoMain channel 5 |
| Channel 6 | EV Charger | Charging Point Energy Meter, single-phase, ecoMain channel 6 |
Device and Channel Numbers
Each device provides 10 branch channels. In the evcc configuration interface, first select the ecoMain or ecoSub module connected to the current sensor, then select the corresponding channel.
| Device | Device option in evcc | Available channels |
|---|---|---|
| ecoMain | 0 | 1 to 10 |
| ecoSub 1 | 1 | 1 to 10 |
| ecoSub 2 | 2 | 1 to 10 |
| ecoSub 3 | 3 | 1 to 10 |
A three-phase device requires three different channels. The channels can be located on the same device or distributed across ecoMain and optional ecoSub modules.
Requirements
Prepare the following hardware and software before starting the integration.
| Item | Requirement |
|---|---|
| ecoMain energy monitor | Installed and connected to the main incoming lines. |
| Current sensors | Installed on the grid, solar, EV or other circuits you want to monitor. |
| ecoSub modules | Optional. Use ecoSub only when the project needs additional branch channels beyond ecoMain. |
| ecoMain firmware | Version 139 or later. |
| evcc | A version that supports enecess ecoMain. |
| Local network | evcc and ecoMain are connected to a local network where they can communicate. |
| Channel mapping | A prepared list of the device, channel and circuit for each current sensor. |
Setup Guide
Step 1: Add ecoMain as the Grid Meter
Open the evcc web interface and go to Configuration. In the Grid section, add a grid meter and search for enecess or ecoMain. Enter the ecoMain IP address and keep the remaining connection settings at their preset values.
Step 2: Add Solar PV
In the Solar & Battery section, add a solar device and select enecess ecoMain. Select the number of phases for the solar circuit, then enter the device and channel numbers from your channel mapping.
Step 3: Add the EV Charger Meter
If the charger does not have an integrated meter, or if ecoMain should be used as an independent charging meter, edit the corresponding Charging Point and add an Energy Meter. Select enecess ecoMain, then choose the channel connected to the EV charging circuit.
Step 4: Add a Heat Pump and Other Loads
ecoMain branch channels can also monitor heat pumps, heating elements and major house loads. Add a regular load as a Consumer, or add a device that adjusts its own power and must be included in evcc calculation as an Auxiliary Consumer.
Step 5: Check the Power Direction
Return to the evcc main screen and check the energy flow. Grid power should be positive when importing and negative when exporting. Solar PV power should be positive during production. EV Charger, Heat Pump and House Load power should be positive during consumption.
Step 6: Verify Device Data
After configuration, evcc starts displaying real-time power and energy flow. Once the Grid, Solar PV and load directions are correct, use the evcc PV charging mode to charge the vehicle automatically according to the available solar surplus.
FAQ
Can ecoMain work with evcc?
Yes. ecoMain provides real-time power, energy, voltage and current data from the main circuit and selected branch circuits to evcc over the local network.
How does ecoMain help evcc with solar surplus charging?
The ecoMain main circuit tells evcc whether the site is importing power from or exporting power to the grid. evcc uses this feedback to continuously adjust vehicle charging power so more available solar energy can be used for EV charging.
Can I monitor solar PV separately?
Yes. Select one single-phase channel or three three-phase channels in the Solar PV configuration, and evcc can display real-time data for the solar system.
Can I monitor an EV charger separately?
Yes. Add an ecoMain Energy Meter to the corresponding Charging Point and select the EV charging circuit to view real-time charging power and cumulative energy.
Do I need an ecoMain charging channel if the charger has an integrated meter?
Normally, ecoMain does not need to be configured as the external meter for that Charging Point. The ecoMain channel can still be used as an independent circuit-level monitoring point.
Can I monitor a three-phase heat pump or EV charger?
Yes. Select three channels for the three phases. evcc automatically calculates the total power and energy while preserving the values for each phase.
Does the ecoMain integration with evcc require cloud access?
No. evcc reads ecoMain directly over the local network. The enecess cloud app can continue to be used independently by users who prefer a ready-to-use app experience.
Can I start with main-circuit monitoring and add branch circuits later?
Yes. Start by configuring the ecoMain main circuit as Grid, then add Solar PV, EV Charger, Heat Pump and other branch circuits as required. Add ecoSub modules only when more channels are needed.
How many branch channels can the ecoMain system monitor?
The current integration supports ecoMain and up to three ecoSub modules, providing 40 branch channels in total.
Why does one phase report power in the opposite direction?
The current sensor on that phase is usually installed in the opposite direction. Enable Invert direction for the corresponding phase to correct both the power direction and cumulative energy direction.
Why can evcc not connect to ecoMain?
Confirm that the ecoMain IP address is correct and that evcc and ecoMain are connected to a local network where they can communicate. Also check whether guest-network or router isolation is blocking communication between the devices.
Why can I not find ecoMain in the evcc device list?
Update evcc to a version that supports enecess ecoMain, then reopen the device configuration page.
Can ecoMain be used as an evcc Battery Meter?
The current integration focuses on Grid, Solar PV, EV Charging and Auxiliary Load monitoring. A complete battery integration also requires information such as battery state of charge, so use a supported battery-device integration in evcc.
Build Your evcc Energy Management System with ecoMain
ecoMain provides evcc with complete, expandable and locally available energy data. Start with grid import and export, then add Solar PV, EV Charger, Heat Pump and other branch circuits as required. This gives evcc a more accurate view of the home energy flow and helps direct more locally generated solar energy into vehicle charging.