Package io.openems.edge.ess.generic.common

Class AbstractAllowedChargeDischargeHandler<ESS extends SymmetricEss & CycleProvider>

java.lang.Object

io.openems.edge.ess.generic.common.AbstractAllowedChargeDischargeHandler<ESS>

All Implemented Interfaces:

org.apache.logging.log4j.util.TriConsumer<ClockProvider,Battery,SymmetricBatteryInverter>

Direct Known Subclasses:

AllowedChargeDischargeHandler, AllowedChargeDischargeHandler

public abstract class AbstractAllowedChargeDischargeHandler<ESS extends SymmetricEss & CycleProvider>
extends Object
implements org.apache.logging.log4j.util.TriConsumer<ClockProvider,Battery,SymmetricBatteryInverter>

Helper class to handle calculation of Allowed-Charge-Power and Allowed-Discharge-Power. This class is used by ChannelManager as a callback to updates of Battery Channels.

Field Summary

Fields

Modifier and Type	Field	Description
static final float	DISCHARGE_EFFICIENCY_FACTOR
protected float	lastBatteryAllowedChargePower
protected float	lastBatteryAllowedDischargePower
static final float	MAX_INCREASE_PERCENTAGE	Allow a maximum increase per second.
protected final ESS	parent
static final int	VOLTAGE_CONTROL_FILTER_TIME_CONSTANT
static final int	VOLTAGE_CONTROL_OFFSET

Constructor Summary

Constructors

Constructor	Description
AbstractAllowedChargeDischargeHandler(ESS parent)

Method Summary

Modifier and Type	Method	Description
abstract void	accept(ClockProvider clockProvider, Battery battery, SymmetricBatteryInverter inverter)
protected void	calculateAllowedChargeDischargePower(ClockProvider clockProvider, boolean isStarted, Integer chargeMaxCurrent, Integer dischargeMaxCurrent, Integer voltage)	Calculates Allowed-Charge-Power and Allowed-Discharge Power from the given parameters.
protected void	calculateAllowedChargeDischargePower(ClockProvider clockProvider, Battery battery, SymmetricBatteryInverter inverter)	Calculates Allowed-Charge-Power and Allowed-Discharge Power from the given parameters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DISCHARGE_EFFICIENCY_FACTOR

public static final float DISCHARGE_EFFICIENCY_FACTOR

See Also:

• Constant Field Values

MAX_INCREASE_PERCENTAGE

public static final float MAX_INCREASE_PERCENTAGE

Allow a maximum increase per second.

5 % of possible allowed charge/discharge power

See Also:

• Constant Field Values

VOLTAGE_CONTROL_FILTER_TIME_CONSTANT

public static final int VOLTAGE_CONTROL_FILTER_TIME_CONSTANT

See Also:

• Constant Field Values

VOLTAGE_CONTROL_OFFSET

public static final int VOLTAGE_CONTROL_OFFSET

See Also:

• Constant Field Values

parent

protected final ESS extends SymmetricEss & CycleProvider parent

lastBatteryAllowedChargePower

protected float lastBatteryAllowedChargePower

lastBatteryAllowedDischargePower

protected float lastBatteryAllowedDischargePower

Constructor Details

AbstractAllowedChargeDischargeHandler

public AbstractAllowedChargeDischargeHandler(ESS parent)

Method Details

accept

public abstract void accept(ClockProvider clockProvider,
 Battery battery,
 SymmetricBatteryInverter inverter)

Specified by:

accept in interface org.apache.logging.log4j.util.TriConsumer<ClockProvider,Battery,SymmetricBatteryInverter>

calculateAllowedChargeDischargePower

protected void calculateAllowedChargeDischargePower(ClockProvider clockProvider,
 Battery battery,
 SymmetricBatteryInverter inverter)

Calculates Allowed-Charge-Power and Allowed-Discharge Power from the given parameters. Result is stored in 'lastBatteryAllowedChargePower' and 'lastBatteryAllowedDischargePower' variables - both as positive values!

Parameters:

clockProvider - the ClockProvider

battery - the Battery

inverter - the SymmetricBatteryInverter

calculateAllowedChargeDischargePower

protected void calculateAllowedChargeDischargePower(ClockProvider clockProvider,
 boolean isStarted,
 Integer chargeMaxCurrent,
 Integer dischargeMaxCurrent,
 Integer voltage)

Calculates Allowed-Charge-Power and Allowed-Discharge Power from the given parameters. Result is stored in 'allowedChargePower' and 'allowedDischargePower' variables - both as positive values!

Parameters:

clockProvider - the ClockProvider

isStarted - is the ESS started?

chargeMaxCurrent - the Battery.ChannelId.CHARGE_MAX_CURRENT

dischargeMaxCurrent - the Battery.ChannelId.DISCHARGE_MAX_CURRENT

voltage - the Battery.ChannelId.VOLTAGE