New controller for flexibility trading with Levl Energy

io.openems.edge.application/EdgeApp.bndrun

@@ -148,6 +148,7 @@
 	bnd.identity;id='io.openems.edge.kaco.blueplanet.hybrid10',\
 	bnd.identity;id='io.openems.edge.katek.edcom',\
 	bnd.identity;id='io.openems.edge.kostal.piko',\
+	bnd.identity;id='io.openems.edge.levl.controller',\
 	bnd.identity;id='io.openems.edge.meter.abb',\
 	bnd.identity;id='io.openems.edge.meter.artemes.am2',\
 	bnd.identity;id='io.openems.edge.meter.bcontrol.em300',\
@@ -328,6 +329,7 @@
 	io.openems.edge.kaco.blueplanet.hybrid10;version=snapshot,\
 	io.openems.edge.katek.edcom;version=snapshot,\
 	io.openems.edge.kostal.piko;version=snapshot,\
+	io.openems.edge.levl.controller;version=snapshot,\
 	io.openems.edge.meter.abb;version=snapshot,\
 	io.openems.edge.meter.api;version=snapshot,\
 	io.openems.edge.meter.artemes.am2;version=snapshot,\

io.openems.edge.common/src/io/openems/edge/common/type/TypeUtils.java

@@ -881,6 +881,19 @@ public static int fitWithin(int lowLimit, int highLimit, int value) {
 		return Math.max(lowLimit, //
 				Math.min(highLimit, value));
 	}
+
+	/**
+	 * Fits a value within a lower and upper boundary.
+	 *
+	 * @param lowLimit  the long lower boundary
+	 * @param highLimit the long upper boundary
+	 * @param value     the long actual value
+	 * @return the adjusted long value
+	 */
+	public static long fitWithin(long lowLimit, long highLimit, long value) {
+		return Math.max(lowLimit, //
+				Math.min(highLimit, value));
+	}
 
 	/**
 	 * Fits a value within a lower and upper boundary.

io.openems.edge.levl.controller/.classpath

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="con" path="aQute.bnd.classpath.container"/>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-21"/>
+	<classpathentry kind="src" output="bin" path="src"/>
+	<classpathentry kind="src" output="bin_test" path="test">
+		<attributes>
+			<attribute name="test" value="true"/>
+		</attributes>
+	</classpathentry>
+	<classpathentry kind="output" path="bin"/>
+</classpath>

io.openems.edge.levl.controller/.gitignore

@@ -0,0 +1,3 @@
+/bin/
+/bin_test/
+/generated/

io.openems.edge.levl.controller/.project

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>io.openems.edge.levl.controller</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>bndtools.core.bndbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>bndtools.core.bndnature</nature>
+	</natures>
+</projectDescription>

io.openems.edge.levl.controller/.settings/org.eclipse.core.resources.prefs

@@ -0,0 +1,2 @@
+eclipse.preferences.version=1
+encoding/<project>=UTF-8

io.openems.edge.levl.controller/bnd.bnd

@@ -0,0 +1,16 @@
+Bundle-Name: Ess Balancing with flexibility trading
+Bundle-Vendor: Levl Energy GmbH
+Bundle-License: https://opensource.org/licenses/EPL-2.0
+Bundle-Version: 0.1.0.${tstamp}
+
+-buildpath: \
+	${buildpath},\
+	io.openems.common,\
+	io.openems.edge.common,\
+	io.openems.edge.controller.api,\
+	io.openems.edge.ess.api,\
+	io.openems.edge.ess.generic,\
+	io.openems.edge.meter.api
+
+-testpath: \
+	${testpath}

io.openems.edge.levl.controller/readme.adoc

@@ -0,0 +1,19 @@
+= Levl Controller for ESS Balancing
+
+This is a beta version.
+
+This controller combines the optimization of self-consumption with flexibility trading by levl.
+Note: This controller can only be used in combination with an optimization contract with Levl Energy. For contact und more information please visit https://levl.energy
+
+== How it works
+This controller receives charging and discharging instructions from Levl Energy and executes these taking into account local optimization and various constraints (such as SoC, grid limits, etc.).
+
+== Requirements
+The following components are required to use this controller successfully:
+- Contract with Levl Energy for system optimization 
+- ManagedSymmetricEss - a controllable energy storage system
+- ElectricityMeter - a meter at the grid connection point
+
+== Further information
+Detailed information on self-consumption optimization can be found in the OpenEMS source code.
+https://github.com/OpenEMS/openems/tree/develop/io.openems.edge.controller.ess.balancing[Source Code icon:github[]]

io.openems.edge.levl.controller/src/io/openems/edge/levl/controller/Config.java

@@ -0,0 +1,33 @@
+package io.openems.edge.levl.controller;
+
+import org.osgi.service.metatype.annotations.AttributeDefinition;
+import org.osgi.service.metatype.annotations.ObjectClassDefinition;
+
+@ObjectClassDefinition(//
+		name = "Levl Controller Ess Balancing", //
+		description = "Combines the optimization of self-consumption with flexibility trading by levl.")
+@interface Config {
+
+	@AttributeDefinition(name = "Component-ID", description = "Unique ID of this Component")
+	String id() default "ctrlLevlBalancing0";
+
+	@AttributeDefinition(name = "Alias", description = "Human-readable name of this Component; defaults to Component-ID")
+	String alias() default "";
+
+	@AttributeDefinition(name = "Is enabled?", description = "Is this Component enabled?")
+	boolean enabled() default true;
+
+	@AttributeDefinition(name = "Ess-ID", description = "ID of Ess device.")
+	String ess_id();
+
+	@AttributeDefinition(name = "Grid-Meter-ID", description = "ID of the Grid-Meter.")
+	String meter_id();
+
+	@AttributeDefinition(name = "Ess target filter", description = "This is auto-generated by 'Ess-ID'.")
+	String ess_target() default "(enabled=true)";
+
+	@AttributeDefinition(name = "Meter target filter", description = "This is auto-generated by 'Meter-ID'.")
+	String meter_target() default "(enabled=true)";
+
+	String webconsole_configurationFactory_nameHint() default "Levl Controller Ess Balancing [{id}]";
+}