DRAFT - Implementation DEYE SUN-12K-SG04LP3-EU

io.openems.edge.application/EdgeApp.bndrun

@@ -142,6 +142,7 @@
 	bnd.identity;id='io.openems.edge.fenecon.mini',\
 	bnd.identity;id='io.openems.edge.fenecon.pro',\
 	bnd.identity;id='io.openems.edge.goodwe',\
+	bnd.identity;id='io.openems.edge.batteryinverter.deye',\
 	bnd.identity;id='io.openems.edge.io.filipowski',\
 	bnd.identity;id='io.openems.edge.io.gpio',\
 	bnd.identity;id='io.openems.edge.io.kmtronic',\
@@ -328,6 +329,7 @@
 	io.openems.edge.fenecon.mini;version=snapshot,\
 	io.openems.edge.fenecon.pro;version=snapshot,\
 	io.openems.edge.goodwe;version=snapshot,\
+	io.openems.edge.batteryinverter.deye;version=snapshot,\
 	io.openems.edge.io.api;version=snapshot,\
 	io.openems.edge.io.filipowski;version=snapshot,\
 	io.openems.edge.io.gpio;version=snapshot,\

io.openems.edge.batteryinverter.deye/.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.batteryinverter.deye/.gitignore

@@ -0,0 +1,2 @@
+/generated/
+/bin_test/

io.openems.edge.batteryinverter.deye/.project

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>io.openems.edge.batteryinverter.deye</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.batteryinverter.deye/.settings/org.eclipse.core.resources.prefs

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

io.openems.edge.batteryinverter.deye/bnd.bnd

@@ -0,0 +1,19 @@
+Bundle-Name: OpenEMS Edge ESS Deye
+Bundle-Vendor: MaMoTec
+Bundle-License: https://opensource.org/licenses/EPL-2.0
+Bundle-Version: 1.0.0.${tstamp}
+
+-buildpath: \
+	${buildpath},\
+	com.ghgande.j2mod,\
+	io.openems.common,\
+	io.openems.edge.battery.api,\
+	io.openems.edge.batteryinverter.api,\
+	io.openems.edge.bridge.modbus,\
+	io.openems.edge.common,\
+	io.openems.edge.ess.api,\
+	io.openems.edge.meter.api,\
+	io.openems.edge.timedata.api,\
+	io.openems.edge.pvinverter.api
+-testpath: \
+	${testpath}

io.openems.edge.batteryinverter.deye/readme.adoc

@@ -0,0 +1 @@
+= Deye Battery Inverter

io.openems.edge.batteryinverter.deye/src/io/openems/edge/deye/ess/Config.java

@@ -0,0 +1,54 @@
+package io.openems.edge.deye.ess;
+
+import org.osgi.service.metatype.annotations.AttributeDefinition;
+import org.osgi.service.metatype.annotations.ObjectClassDefinition;
+
+@ObjectClassDefinition(//
+		name = "Deye.BatteryInverter", //
+		description = "Implements the Deye Battery Inverter")
+@interface Config {
+
+	@AttributeDefinition(name = "Component-ID", description = "Unique ID of this Component")
+	String id() default "ess0";
+
+	@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 = "Read-Only mode", description = "Enables Read-Only mode")
+	boolean readOnlyMode() default false;
+
+	@AttributeDefinition(name = "Modbus-ID", description = "ID of Modbus bridge.")
+	String modbus_id() default "modbus0";
+
+	@AttributeDefinition(name = "Modbus-Unit-ID", description = "Unit ID of Modbus bridge.")
+	int unit_id() default 1;
+
+	@AttributeDefinition(name = "Power limit on PowerDecreaseCausedByOvertemperature error; '0' to disable power limit logic", description = "")
+	int powerLimitOnPowerDecreaseCausedByOvertemperatureChannel() default 20_000;
+
+	@AttributeDefinition(name = "Modbus target filter", description = "This is auto-generated by 'Modbus-ID'.")
+	String Modbus_target() default "(enabled=true)";
+
+	@AttributeDefinition(name = "Surplus Feed-In: State-of-Charge limit", description = "Start Surplus-feed-in if State-of-Charge is bigger than this limit")
+	int surplusFeedInSocLimit() default 90;
+
+	@AttributeDefinition(name = "Surplus Feed-In: Allowed-Charge-Power limit", description = "Start Surplus-feed-in if Charge-Power is smaller than this limit. (Needs to set negative)")
+	int surplusFeedInAllowedChargePowerLimit() default -8_000;
+
+	@AttributeDefinition(name = "Surplus Feed-In: Increase Power by percentage", description = "1.1 for 10 %")
+	double surplusFeedInIncreasePowerFactor() default 1.1;
+
+	@AttributeDefinition(name = "Surplus Feed-In: Max increase Power", description = "")
+	int surplusFeedInMaxIncreasePowerFactor() default 2_000;
+
+	@AttributeDefinition(name = "Surplus Feed-In: Off Time", description = "The time to stop grid feed in.")
+	String surplusFeedInOffTime() default "17:00:00";
+
+	@AttributeDefinition(name = "Surplus Feed-In: PV-Limit on PowerDecreaseCausedByOvertemperature", description = "")
+	int surplusFeedInPvLimitOnPowerDecreaseCausedByOvertemperature() default 5_000;
+
+	String webconsole_configurationFactory_nameHint() default "Deye Battery Inverter [{id}]";
+}

io.openems.edge.batteryinverter.deye/src/io/openems/edge/deye/ess/DeyeSunHybrid.java

@@ -0,0 +1,220 @@
+package io.openems.edge.deye.ess;
+
+import org.osgi.service.event.EventHandler;
+
+import io.openems.common.channel.AccessMode;
+import io.openems.common.channel.Level;
+import io.openems.common.channel.PersistencePriority;
+import io.openems.common.channel.Unit;
+import io.openems.common.types.OpenemsType;
+import io.openems.edge.common.channel.Doc;
+import io.openems.edge.common.channel.IntegerDoc;
+import io.openems.edge.common.channel.IntegerReadChannel;
+import io.openems.edge.common.channel.StateChannel;
+import io.openems.edge.common.component.OpenemsComponent;
+import io.openems.edge.common.modbusslave.ModbusSlave;
+import io.openems.edge.ess.api.ManagedSymmetricEss;
+import io.openems.edge.ess.api.SymmetricEss;
+import io.openems.edge.timedata.api.TimedataProvider;
+
+public interface DeyeSunHybrid
+		extends ManagedSymmetricEss, SymmetricEss, OpenemsComponent, EventHandler, ModbusSlave, TimedataProvider {
+
+	/**
+	 * Gets the Modbus Unit-ID.
+	 *
+	 * @return the Unit-ID
+	 */
+	public Integer getUnitId();
+
+	/**
+	 * Gets the Modbus-Bridge Component-ID, i.e. "modbus0".
+	 *
+	 * @return the Component-ID
+	 */
+	public String getModbusBridgeId();
+
+	public enum ChannelId implements io.openems.edge.common.channel.ChannelId {
+		// EnumReadChannels
+		SERIAL_NUMBER(Doc.of(OpenemsType.STRING) //
+				.persistencePriority(PersistencePriority.HIGH) //
+				.accessMode(AccessMode.READ_ONLY)),
+		SURPLUS_FEED_IN_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.WATT)), //
+
+		// Gen Port Use Channels
+		// AC 1/28/2024
+		SET_GRID_LOAD_OFF_POWER(Doc.of(OpenemsType.INTEGER).unit(Unit.PERCENT) //
+				.accessMode(AccessMode.WRITE_ONLY)), // ), //
+
+
+
+		// EnumWriteChannels
+		SET_WORK_STATE(Doc.of(SetWorkState.values()) //
+				.accessMode(AccessMode.WRITE_ONLY)), //
+
+		// IntegerWriteChannel
+		SET_ACTIVE_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.WATT) //
+				.accessMode(AccessMode.WRITE_ONLY)), //
+		SET_REACTIVE_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.VOLT_AMPERE_REACTIVE) //
+				.accessMode(AccessMode.WRITE_ONLY)), //
+
+		SET_GEN_PEAK_SHAVING_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.WATT) //
+				.accessMode(AccessMode.WRITE_ONLY)), //
+		SET_GRID_PEAK_SHAVING_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.WATT) //
+				.accessMode(AccessMode.WRITE_ONLY)), //
+		CT_RATIO(Doc.of(OpenemsType.INTEGER)), //
+		INVERTER_RUN_STATE(Doc.of(OpenemsType.INTEGER)), //
+
+		// LongReadChannel
+		ORIGINAL_ACTIVE_CHARGE_ENERGY(Doc.of(OpenemsType.LONG)), //
+		ORIGINAL_ACTIVE_DISCHARGE_ENERGY(Doc.of(OpenemsType.LONG)), //
+
+		// IntegerReadChannels
+		ORIGINAL_ALLOWED_CHARGE_POWER(new IntegerDoc() //
+				.onChannelUpdate((self, newValue) -> {
+					// on each Update to the channel -> set the ALLOWED_CHARGE_POWER value with a
+					// delta of max 500
+					IntegerReadChannel currentValueChannel = self
+							.channel(ManagedSymmetricEss.ChannelId.ALLOWED_CHARGE_POWER);
+					var originalValue = newValue.asOptional();
+					var currentValue = currentValueChannel.value().asOptional();
+					final int value;
+					if (!originalValue.isPresent() && !currentValue.isPresent()) {
+						value = 0;
+					} else if (originalValue.isPresent() && !currentValue.isPresent()) {
+						value = originalValue.get();
+					} else if (!originalValue.isPresent() && currentValue.isPresent()) {
+						value = currentValue.get();
+					} else {
+						value = Math.max(originalValue.get(), currentValue.get() - 500);
+					}
+					currentValueChannel.setNextValue(value);
+				})), //
+
+		ORIGINAL_ALLOWED_DISCHARGE_POWER(new IntegerDoc() //
+				.onChannelUpdate((self, newValue) -> {
+					// on each Update to the channel -> set the ALLOWED_DISCHARGE_POWER value with a
+					// delta of max 500
+					IntegerReadChannel currentValueChannel = self
+							.channel(ManagedSymmetricEss.ChannelId.ALLOWED_DISCHARGE_POWER);
+					var originalValue = newValue.asOptional();
+					var currentValue = currentValueChannel.value().asOptional();
+					final int value;
+					if (!originalValue.isPresent() && !currentValue.isPresent()) {
+						value = 0;
+					} else if (originalValue.isPresent() && !currentValue.isPresent()) {
+						value = originalValue.get();
+					} else if (!originalValue.isPresent() && currentValue.isPresent()) {
+						value = currentValue.get();
+					} else {
+						value = Math.min(originalValue.get(), currentValue.get() + 500);
+					}
+					currentValueChannel.setNextValue(value);
+				})), //
+
+
+		APPARENT_POWER(Doc.of(OpenemsType.INTEGER) //
+				.unit(Unit.VOLT_AMPERE)), //
+
+
+		// StateChannels
+		SYSTEM_ERROR(Doc.of(Level.FAULT) //
+				.onInit(new StateChannel.TriggerOnAny(SystemErrorChannelId.values()))
+				.text("System-Error. More information at: https://deyeinverter.com/")), //
+		INSUFFICIENT_GRID_PARAMTERS(Doc.of(Level.FAULT) //
+				.onInit(new StateChannel.TriggerOnAny(InsufficientGridParametersChannelId.values()))
+				.text("Insufficient Grid Parameters. More information at: https://deyeinverter.com/")), //
+		POWER_DECREASE_CAUSED_BY_OVERTEMPERATURE(Doc.of(Level.FAULT) //
+				.onInit(new StateChannel.TriggerOnAny(PowerDecreaseCausedByOvertemperatureChannelId.values()))
+				.text("Power Decrease caused by Overtemperature. More information at:  https://deyeinverter.com/")), //
+		EMERGENCY_STOP_ACTIVATED(Doc.of(Level.WARNING) //
+				.text("Emergency Stop has been activated. More information at:  https://deyeinverter.com/")), //
+		KEY_MANUAL_ACTIVATED(Doc.of(Level.WARNING) //
+				.text("Key Manual has been activated. More information at:  https://deyeinverter.com/")), //
+		BECU_UNIT_DEFECTIVE(Doc.of(Level.FAULT) //
+				.text("BECU Unit is defective. More information at:  https://deyeinverter.com/")), //
+		;
+
+		private final Doc doc;
+
+		private ChannelId(Doc doc) {
+			this.doc = doc;
+		}
+
+		@Override
+		public Doc doc() {
+			return this.doc;
+		}
+
+	}
+
+	/**
+	 * Source-Channels for {@link ChannelId#SYSTEM_ERROR}.
+	 */
+	public static enum SystemErrorChannelId implements io.openems.edge.common.channel.ChannelId {
+		STATE_149(Doc.of(OpenemsType.BOOLEAN) //
+				.text("HighVoltageSideVoltageChangeUnconventionally")) //
+		;
+
+		private final Doc doc;
+
+		private SystemErrorChannelId(Doc doc) {
+			this.doc = doc;
+		}
+
+		@Override
+		public Doc doc() {
+			return this.doc;
+
+		}
+	}
+
+	/**
+	 * Source-Channels for {@link ChannelId#INSUFFICIENT_GRID_PARAMTERS}.
+	 */
+	public static enum InsufficientGridParametersChannelId implements io.openems.edge.common.channel.ChannelId {
+		STATE_84(Doc.of(OpenemsType.BOOLEAN) //
+				.text("Phase3InverterVoltageGeneralOvervoltageProtection")), //
+		;
+
+		private final Doc doc;
+
+		private InsufficientGridParametersChannelId(Doc doc) {
+			this.doc = doc;
+		}
+
+		@Override
+		public Doc doc() {
+			return this.doc;
+
+		}
+	}
+
+	/**
+	 * Source-Channels for
+	 * {@link ChannelId#POWER_DECREASE_CAUSED_BY_OVERTEMPERATURE}.
+	 */
+	public static enum PowerDecreaseCausedByOvertemperatureChannelId
+			implements io.openems.edge.common.channel.ChannelId {
+		STATE_146(Doc.of(OpenemsType.BOOLEAN) //
+				.text("Fan4StartupFailed"));
+
+		private final Doc doc;
+
+		private PowerDecreaseCausedByOvertemperatureChannelId(Doc doc) {
+			this.doc = doc;
+		}
+
+		@Override
+		public Doc doc() {
+			return this.doc;
+
+		}
+	}
+
+}