jEEBus

EEBus (VDE-AR-E 2829-6 series) is a communication protocol for connecting energy-related devices such as heat pumps, wallboxes, batteries, inverters, control boxes, and energy management systems.

Our implementation of EEBus is compliant to § 14a EnWG as well as § 9 EEG and supports all relevant EEBus Use Cases. Paragraph 14a of the German Energy Industry Act (EnWG) covers the grid-oriented control of controllable energy-consuming devices and controllable grid connections. Paragraph 9 of the Renewable Energy Act (EEG) describes similar control for energy-producing devices. This allows distribution system operators (DSO) to temporarily limit the power of these devices in critical grid situations.

We are a member of the EEBus Initiative e.V. and the FNN Project Group Control Box Test Cases in order to participate in the further development of the standard. We successfully tested our stack with other manufacturers at the annual Plugfest at the EEBUSummit.

Open Source

As the research team Smart Grid Communication (SGC) at the Fraunhofer Institute for Solar Energy Systems, our mandate is to advance the energy transformation and digitalization in Europe and beyond. Our focus is to enable the smart and efficient use of energy in the electricity grid. That is why we are committed to providing and maintaining an open, mature, high quality implementation of the EEBus standard.

With jEEBus.SHIP and jEEBus.SPINE we provide Open Source Java implementations for the communication and data layers of EEBus. In combination these libraries act as an SDK for implementing any EEBus Use Case. Furthermore, our implementations of the Controllable System side of LPC and LPP enable devices to receive power limits from DSOs.

Our Use Case libraries go far beyond simple communication interfaces for SPINE messages. Rather, they are complete implementations of the specifications including the given application level logic. This minimizes the required effort in both adapting and integrating EEBus in your products.

These libraries are available under the Eclipse Public License (EPL 2.0) with the source code on GitHub and Maven Central. The table below provides an overview of where to find our open source libraries:

Implementation Library Source Code Package Repository License
jEEBus.SHIP jEEBus.SHIP on GitHub jEEBus.SHIP on Maven Central EPL 2.0
jEEBus.SPINE jEEBus.SPINE on GitHub jEEBus.SPINE on Maven Central EPL 2.0
Limitation of Power Consumption
Actor Controllable System
jEEBus LPC on GitHub maven-central EPL 2.0
Limitation of Power Production
Actor Controllable System
jEEBus LPP on GitHub maven-central EPL 2.0

Offered Services

Since we started our EEBus development back in 2020, our code base and knowledge of concerning the standard has reached a considerable level of maturity. Take advantage of our know-how in the field of EEBus to develop innovative, EEBus-compatible products. We support you in your development with our expert advice, testing services and individual software license agreements. We offer the following services:

Please contact us if you have any questions about the implementation or the services we offer.

Software Licenses

We already implemented more EEBus Use Cases based on our libraries. These Use Case implementations are not available as open source but can be licensed individually. Take a look at the table below for a list of EEBus Use Case Actors we already implemented.

Use Case Abbreviation Actor
Limitation of Power Consumption LPC Energy Guard
Limitation of Power Production LPP Energy Guard
Monitoring of Power Consumption MPC Monitoring Appliance
Monitoring of Power Consumption MPC Monitored Unit
Monitoring of Grid Connection Point MGCP Monitoring Appliance
Monitoring of Grid Connection Point MGCP Grid Connection Point
Monitoring of Battery MOB Monitoring Appliance
Monitoring of Inverter MOI Monitoring Appliance
Monitoring of Inverter MOI Inverter
Node Identification NID Identifiable Node

EEBus Device Simulation

We offer EEBus device simulation software you can easily integrate into your test pipelines. Concretely, these are stand-alone Java applications (without source code) you can start locally with no restrictions on the number of instances or devices running them.

For example, you can run our control box simulation to test whether your real device handles the EEBus communication with control boxes correctly. Conversely, you can use our controllable device simulation to test your HEMS or control box.

In order to seamlessly include EEBus device simulation software into automatic test pipelines, it supports a REST API you can use to re-configure which Use Case Actors should be included at runtime. It can also be used to trigger the simulated device to send out messages like power limits, heartbeats or measurement updates.

If you would like to learn more or get a demonstration, please get in touch.

Software Development, Integration and Tests

Need help with implementing and testing EEBus? We offer various services around software development, customized integration, and testing. As EEBus Use Cases are highly dependent on the local system, we offer implementation and system integration support for the EEBus application layer. This includes extending your systems and devices with EEBus. With our experience from years of development and various research projects, we can identify and integrate the necessary EEBus Use Cases for your project.

  • Integration and development support for customized solutions
  • Implementation of new EEBus Use Cases
  • Carrying out device tests in our Digital Grid Lab

Roadmap

Besides maintaining our EEBus libraries we are also implementing more Use Cases. Currently, the Use Cases listed in the table below are in active development.

Use Case Abbreviation Actor
Power Envelope POEN Transmission Broker
Power Envelope POEN CEM
Control of Reactive Power * - Inverter
Control of Reactive Power * - Energy Guard

* We are working on a new EEBus Use Case and prototype implementation to enable DSOs to transmit reactive power setpoints to inverters.

Developers

Patrick Hercegfi, Arife Rabia Karahisar, Nicolas Stamm, Stefan Wursthorn, Dirk Zimmermann