Package io.openems.edge.battery.protection

Class BatteryProtection

java.lang.Object

io.openems.edge.battery.protection.BatteryProtection

public class BatteryProtection
extends Object

This utility class provides algorithms to calculate maximum allowed charge and discharge currents for batteries.

The logic uses:

• Allowed Current Limit provided by Battery Management System
• Voltage-to-Percent characteristics based on Min- and Max-Cell-Voltage
• Temperature-to-Percent characteristics based on Min- and Max-Cell-Temperature
• Linear max increase limit (e.g. 0.5 A per second)
• Force Charge/Discharge mode (e.g. -1 A to enforce charge/discharge)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BatteryProtection.Builder
static enum	BatteryProtection.ChannelId

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BatteryProtection(Battery battery, ChargeMaxCurrentHandler chargeMaxCurrentHandler, DischargeMaxCurrentHandler dischargeMaxCurrentHandler)

Method Summary

Modifier and Type	Method	Description
void	apply()	Apply the logic on the Battery.
static BatteryProtection.Builder	create(Battery battery)	Create a BatteryProtection using builder pattern.

Methods inherited from class java.lang.Object

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

Constructor Details

BatteryProtection

protected BatteryProtection(Battery battery,
 ChargeMaxCurrentHandler chargeMaxCurrentHandler,
 DischargeMaxCurrentHandler dischargeMaxCurrentHandler)

Method Details

create

public static BatteryProtection.Builder create(Battery battery)

Create a BatteryProtection using builder pattern.

Parameters:

battery - the Battery

Returns:

a BatteryProtection.Builder

apply

public void apply()

Apply the logic on the Battery.

• Set CHARGE_MAX_CURRENT Channel
• Set DISCHARGE_MAX_CURRENT Channel
• Set FORCE_DISCHARGE_ACTIVE State-Channel if Charge-Max-Current invalid input: '<' 0
• Set FORCE_CHARGE_ACTIVE State-Channel if Discharge-Max-Current invalid input: '<' 0
• SET