Package io.openems.edge.battery.protection.currenthandler

Class AbstractMaxCurrentHandler

java.lang.Object

io.openems.edge.battery.protection.currenthandler.AbstractMaxCurrentHandler

Direct Known Subclasses:

ChargeMaxCurrentHandler, DischargeMaxCurrentHandler

public abstract class AbstractMaxCurrentHandler
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractMaxCurrentHandler.Builder<T extends AbstractMaxCurrentHandler.Builder<?>>

Field Summary

Fields

Modifier and Type	Field	Description
protected int	bmsMaxEverCurrent
protected final ClockProvider	clockProvider
protected final AbstractForceChargeDischarge	forceChargeDischarge
protected Double	lastCurrentLimit
protected Instant	lastResultTimestamp
protected final PolyLine	temperatureToPercent
protected final PolyLine	voltageToPercent

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractMaxCurrentHandler(ClockProvider clockProvider, int initialBmsMaxEverCurrent, PolyLine voltageToPercent, PolyLine temperatureToPercent, Double maxIncreasePerSecond, AbstractForceChargeDischarge forceChargeDischarge)

Method Summary

Modifier and Type	Method	Description
int	calculateCurrentLimit(Battery battery)	Calculates the actual allowed current limit in [A] as minimum of:.
protected abstract BatteryProtection.ChannelId	getBpBmsChannelId()	Gets the ChannelId for Battery-Protection Limit originating from BMS.
protected abstract BatteryProtection.ChannelId	getBpForceCurrentChannelId()	Gets the ChannelId for Battery-Protection Limit by Force Charge/Discharge Mode.
protected abstract BatteryProtection.ChannelId	getBpMaxIncreaseAmpereChannelId()	Gets the ChannelId for Battery-Protection Limit by Max-Increase-Ampere ramp.
protected abstract BatteryProtection.ChannelId	getBpMaxTemperatureChannelId()	Gets the ChannelId for Battery-Protection Limit by Max-Cell-Temperature.
protected abstract BatteryProtection.ChannelId	getBpMaxVoltageChannelId()	Gets the ChannelId for Battery-Protection Limit by Max-Cell-Voltage.
protected abstract BatteryProtection.ChannelId	getBpMinTemperatureChannelId()	Gets the ChannelId for Battery-Protection Limit by Min-Cell-Temperature.
protected abstract BatteryProtection.ChannelId	getBpMinVoltageChannelId()	Gets the ChannelId for Battery-Protection Limit by Min-Cell-Voltage.
protected Double	getForceCurrent(Integer minCellVoltage, Integer maxCellVoltage)	Calculates the Ampere limit in Force Charge/Discharge mode.
protected Double	getMaxCellVoltageToPercentLimit(Integer minCellVoltage)
protected Double	getMaxIncreaseAmpereLimit()	Calculates the maximum increase limit in Ampere from the 'maxIncreasePerSecond' parameter.
protected Double	getMinCellVoltageToPercentLimit(Integer minCellVoltage)
protected Double	percentToAmpere(Double percent)	Convert a Percent value to a concrete Ampere value in [A] by multiplying it with 'bmsMaxEverAllowedChargeCurrent'.

Methods inherited from class java.lang.Object

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

Field Details

clockProvider

protected final ClockProvider clockProvider

voltageToPercent

protected final PolyLine voltageToPercent

temperatureToPercent

protected final PolyLine temperatureToPercent

forceChargeDischarge

protected final AbstractForceChargeDischarge forceChargeDischarge

bmsMaxEverCurrent

protected int bmsMaxEverCurrent

lastResultTimestamp

protected Instant lastResultTimestamp

lastCurrentLimit

protected Double lastCurrentLimit

Constructor Details

AbstractMaxCurrentHandler

protected AbstractMaxCurrentHandler(ClockProvider clockProvider,
 int initialBmsMaxEverCurrent,
 PolyLine voltageToPercent,
 PolyLine temperatureToPercent,
 Double maxIncreasePerSecond,
 AbstractForceChargeDischarge forceChargeDischarge)

Method Details

getBpBmsChannelId

protected abstract BatteryProtection.ChannelId getBpBmsChannelId()

Gets the ChannelId for Battery-Protection Limit originating from BMS.

• BatteryProtection.ChannelId.BP_CHARGE_BMS
• BatteryProtection.ChannelId.BP_DISCHARGE_BMS

Returns:

the BatteryProtection.ChannelId

getBpMinVoltageChannelId

protected abstract BatteryProtection.ChannelId getBpMinVoltageChannelId()

Gets the ChannelId for Battery-Protection Limit by Min-Cell-Voltage.

• BatteryProtection.ChannelId.BP_CHARGE_MIN_VOLTAGE
• BatteryProtection.ChannelId.BP_DISCHARGE_MIN_VOLTAGE

Returns:

the BatteryProtection.ChannelId

getBpMaxVoltageChannelId

protected abstract BatteryProtection.ChannelId getBpMaxVoltageChannelId()

Gets the ChannelId for Battery-Protection Limit by Max-Cell-Voltage.

• BatteryProtection.ChannelId.BP_CHARGE_MAX_VOLTAGE
• BatteryProtection.ChannelId.BP_DISCHARGE_MAX_VOLTAGE

Returns:

the BatteryProtection.ChannelId

getBpMinTemperatureChannelId

protected abstract BatteryProtection.ChannelId getBpMinTemperatureChannelId()

Gets the ChannelId for Battery-Protection Limit by Min-Cell-Temperature.

• BatteryProtection.ChannelId.BP_CHARGE_MIN_TEMPERATURE
• BatteryProtection.ChannelId.BP_DISCHARGE_MIN_TEMPERATURE

Returns:

the BatteryProtection.ChannelId

getBpMaxTemperatureChannelId

protected abstract BatteryProtection.ChannelId getBpMaxTemperatureChannelId()

Gets the ChannelId for Battery-Protection Limit by Max-Cell-Temperature.

• BatteryProtection.ChannelId.BP_CHARGE_MAX_TEMPERATURE
• BatteryProtection.ChannelId.BP_DISCHARGE_MAX_TEMPERATURE

Returns:

the BatteryProtection.ChannelId

getBpForceCurrentChannelId

protected abstract BatteryProtection.ChannelId getBpForceCurrentChannelId()

Gets the ChannelId for Battery-Protection Limit by Force Charge/Discharge Mode.

• BatteryProtection.ChannelId.BP_FORCE_CHARGE
• BatteryProtection.ChannelId.BP_FORCE_DISCHARGE

Returns:

the BatteryProtection.ChannelId

getBpMaxIncreaseAmpereChannelId

protected abstract BatteryProtection.ChannelId getBpMaxIncreaseAmpereChannelId()

Gets the ChannelId for Battery-Protection Limit by Max-Increase-Ampere ramp. Mode.

• BatteryProtection.ChannelId.BP_FORCE_CHARGE
• BatteryProtection.ChannelId.BP_FORCE_DISCHARGE

Returns:

the BatteryProtection.ChannelId

calculateCurrentLimit

public int calculateCurrentLimit(Battery battery)

Calculates the actual allowed current limit in [A] as minimum of:.

• Is the battery started? (block any charge/discharge if not)
• Is there any value from the BMS? (block any charge/discharge if not)
• Allowed Current Limit provided by Battery Management System
• Voltage-to-Percent characteristics for Min-Cell-Voltage
• Voltage-to-Percent characteristics for Max-Cell-Voltage
• Temperature-to-Percent characteristics for Min-Cell-Temperature
• Temperature-to-Percent characteristics for Max-Cell-Temperature
• Applied max increase limit (e.g. 0.5 A per second)
• Force Charge/Discharge mode (e.g. -1 A to enforce charge/discharge)

Parameters:

battery - the Battery

Returns:

the actual allowed current limit, mathematically rounded to [A]

getMinCellVoltageToPercentLimit

protected Double getMinCellVoltageToPercentLimit(Integer minCellVoltage)

getMaxCellVoltageToPercentLimit

protected Double getMaxCellVoltageToPercentLimit(Integer minCellVoltage)

getMaxIncreaseAmpereLimit

protected Double getMaxIncreaseAmpereLimit()

Calculates the maximum increase limit in Ampere from the 'maxIncreasePerSecond' parameter.

If maxIncreasePerSecond is 0.5, last limit was 10 A and 1 second passed, this method returns 10.5.

Returns:

the limit or null

getForceCurrent

protected Double getForceCurrent(Integer minCellVoltage,
 Integer maxCellVoltage)

Calculates the Ampere limit in Force Charge/Discharge mode. Returns:

• -1 -> in force charge/discharge mode
• 0 -> in block discharge/charge mode
• null -> otherwise

Parameters:

minCellVoltage - the Min-Cell-Voltage, possibly null

maxCellVoltage - the Max-Cell-Voltage, possibly null

Returns:

the Current, possibly null

percentToAmpere

protected Double percentToAmpere(Double percent)

Convert a Percent value to a concrete Ampere value in [A] by multiplying it with 'bmsMaxEverAllowedChargeCurrent'.

• null % -> null
• 0 % -> 0
• anything else -> calculate percent; at least '1 A'.

Parameters:

percent - the percent value in [0,1]

Returns:

the ampere value in [A]