Implement Battery-Inverter Nature, Generic-ESS and KACO blueplanet gr…

…idsave as SunSpec (#1099)

This pull-request contains following major developments and design ideas:

- Generic implementation of State-Machines
- Implement Start-Stop feature: new interface 'StartStoppable' marks a device or service that can be started or stopped
- Split components in Interface (Name) and implementation (NameImpl)
- Getters and Setters for Nature-Channels: see #1046 (comment)
- JUnit Test-Framework for all kinds of OpenemsComponents
- Refactoring of "Battery" interface:
-- drop 'READY_FOR_WORKING' channel
-- extends "StartStoppable"
-- To indicate, that the Battery is ready for charging/discharging, the following Channels need to be set:
--- StartStoppable.ChannelId.START_STOP must be set to 'START'
--- No 'Fault'-StateChannels are set (i.e. 'OpenemsComponent.ChannelId.STATE' is < 3)
--- CHARGE_MAX_VOLTAGE, CHARGE_MAX_CURRENT, DISCHARGE_MIN_VOLTAGE and DISCHARGE_MAX_CURRENT are != null

- New interface "BatteryInverter" (ManagedSymmetricBatteryInverter, SymmetricBatteryInverter)
- Implement Generic ManagedSymmetricEss

cnf/build.bnd

@@ -65,6 +65,7 @@ buildpath: \
 	com.google.gson;version=2.8.5
 
 testpath: \
+	slf4j.simple,\
     \${junit}
 
 javac.source: 1.8

cnf/pom.xml

@@ -244,5 +244,10 @@
 			<artifactId>slf4j-api</artifactId>
 			<version>1.7.30</version>
 		</dependency>
+		<dependency>
+			<groupId>org.slf4j</groupId>
+			<artifactId>slf4j-simple</artifactId>
+			<version>1.7.30</version>
+		</dependency>
 	</dependencies>
 </project>

io.openems.common/src/io/openems/common/jsonrpc/request/EdgeRpcRequest.java

@@ -11,6 +11,19 @@
 
 /**
  * Wraps a JSON-RPC Request for a specific Edge-ID.
+ * 
+ * <pre>
+ * {
+ *   "jsonrpc": "2.0",
+ *   "id": "UUID",
+ *   "method": "edgeRpc",
+ *   "params": {
+ *     "edgeId": string,
+ *     "payload": {
+ *     }
+ *   }
+ * }
+ * </pre>
  */
 public class EdgeRpcRequest extends JsonrpcRequest {
 

io.openems.common/src/io/openems/common/jsonrpc/request/QueryHistoricTimeseriesExportXlxsRequest.java

@@ -17,6 +17,24 @@
 import io.openems.common.types.ChannelAddress;
 import io.openems.common.utils.JsonUtils;
 
+/**
+ * Represents a JSON-RPC Request for 'queryHistoricTimeseriesExportXlxs'.
+ * 
+ * <pre>
+ * {
+ *   "jsonrpc": "2.0",
+ *   "id": "UUID",
+ *   "method": "queryHistoricTimeseriesExportXlxs",
+ *   "params": {
+ *     "timezone": Number,
+ *     "fromDate": YYYY-MM-DD,
+ *     "toDate": YYYY-MM-DD,
+ *     "dataChannels": ChannelAddress[],
+ *     "energyChannels": ChannelAddress[]
+ *   }
+ * }
+ * </pre>
+ */
 public class QueryHistoricTimeseriesExportXlxsRequest extends JsonrpcRequest {
 
 	public final static String METHOD = "queryHistoricTimeseriesExportXlxs";

io.openems.common/src/io/openems/common/types/OptionsEnum.java

@@ -1,5 +1,7 @@
 package io.openems.common.types;
 
+import com.google.common.base.CaseFormat;
+
 public interface OptionsEnum {
 
 	/**
@@ -23,6 +25,18 @@ public interface OptionsEnum {
 	 */
 	OptionsEnum getUndefined();
 
+	/**
+	 * Gets the name in CamelCase format.
+	 * 
+	 * <p>
+	 * If {@link #getName()} returns 'MY_VALUE' this method returns 'MyValue'.
+	 * 
+	 * @return the Name in CamelCase format
+	 */
+	public default String asCamelCase() {
+		return CaseFormat.UPPER_UNDERSCORE.to(CaseFormat.UPPER_CAMEL, this.getName());
+	}
+
 	/**
 	 * Gets whether the current enum represents the 'UNDEFINED' value.
 	 * 

io.openems.edge.application/EdgeApp.bndrun

@@ -28,6 +28,8 @@
 	bnd.identity;id='org.apache.felix.inventory',\
 	bnd.identity;id='io.openems.edge.application',\
 	bnd.identity;id='io.openems.edge.battery.bydcommercial',\
+	bnd.identity;id='io.openems.edge.batteryinverter.kaco.blueplanetgridsave',\
+	bnd.identity;id='io.openems.edge.batteryinverter.sunspec',\
 	bnd.identity;id='io.openems.edge.battery.soltaro',\
 	bnd.identity;id='io.openems.edge.bridge.mbus',\
 	bnd.identity;id='io.openems.edge.bridge.modbus',\
@@ -78,6 +80,7 @@
 	bnd.identity;id='io.openems.edge.ess.cluster',\
 	bnd.identity;id='io.openems.edge.ess.core',\
 	bnd.identity;id='io.openems.edge.ess.fenecon.commercial40',\
+	bnd.identity;id='io.openems.edge.ess.generic',\
 	bnd.identity;id='io.openems.edge.ess.kaco.blueplanet.gridsave50',\
 	bnd.identity;id='io.openems.edge.ess.mr.gridcon',\
 	bnd.identity;id='io.openems.edge.ess.refu',\
@@ -136,6 +139,9 @@
 	io.openems.edge.battery.api;version='[1.0.0,1.0.1)',\
 	io.openems.edge.battery.bydcommercial;version='[1.0.0,1.0.1)',\
 	io.openems.edge.battery.soltaro;version='[1.0.0,1.0.1)',\
+	io.openems.edge.batteryinverter.api;version='[1.0.0,1.0.1)',\
+	io.openems.edge.batteryinverter.kaco.blueplanetgridsave;version='[1.0.0,1.0.1)',\
+	io.openems.edge.batteryinverter.sunspec;version='[1.0.0,1.0.1)',\
 	io.openems.edge.bridge.mbus;version='[1.0.0,1.0.1)',\
 	io.openems.edge.bridge.modbus;version='[1.0.0,1.0.1)',\
 	io.openems.edge.bridge.onewire;version='[1.0.0,1.0.1)',\
@@ -187,6 +193,7 @@
 	io.openems.edge.ess.cluster;version='[1.0.0,1.0.1)',\
 	io.openems.edge.ess.core;version='[1.0.0,1.0.1)',\
 	io.openems.edge.ess.fenecon.commercial40;version='[1.0.0,1.0.1)',\
+	io.openems.edge.ess.generic;version='[1.0.0,1.0.1)',\
 	io.openems.edge.ess.kaco.blueplanet.gridsave50;version='[1.0.0,1.0.1)',\
 	io.openems.edge.ess.mr.gridcon;version='[1.0.0,1.0.1)',\
 	io.openems.edge.ess.refu;version='[1.0.0,1.0.1)',\
@@ -262,4 +269,4 @@
 	org.ops4j.pax.logging.pax-logging-log4j1;version='[2.0.3,2.0.4)',\
 	org.osgi.util.function;version='[1.1.0,1.1.1)',\
 	org.osgi.util.promise;version='[1.1.1,1.1.2)',\
-	rrd4j;version='[3.6.0,3.6.1)'
+	rrd4j;version='[3.6.0,3.6.1)'