io.openems.edge.ess.generic.symmetric

Class GenericManagedSymmetricEssImpl

java.lang.Object

io.openems.edge.common.component.AbstractOpenemsComponent

io.openems.edge.ess.generic.symmetric.GenericManagedSymmetricEssImpl

All Implemented Interfaces:

OpenemsComponent, ModbusSlave, StartStoppable, ManagedSymmetricEss, SymmetricEss, GenericManagedSymmetricEss, org.osgi.service.event.EventHandler

public class GenericManagedSymmetricEssImpl
extends AbstractOpenemsComponent
implements GenericManagedSymmetricEss, ManagedSymmetricEss, SymmetricEss, OpenemsComponent, org.osgi.service.event.EventHandler, StartStoppable, ModbusSlave

Nested Class Summary

Nested classes/interfaces inherited from interface io.openems.edge.ess.generic.symmetric.GenericManagedSymmetricEss

GenericManagedSymmetricEss.ChannelId

Field Summary

Fields inherited from interface io.openems.edge.ess.generic.symmetric.GenericManagedSymmetricEss

EFFICIENCY_FACTOR, RETRY_COMMAND_MAX_ATTEMPTS, RETRY_COMMAND_SECONDS

Fields inherited from interface io.openems.edge.ess.api.SymmetricEss

POWER_DOC_TEXT

Constructor Summary

Constructors

Constructor and Description
GenericManagedSymmetricEssImpl()

Method Summary

Modifier and Type	Method and Description
void	applyPower(int activePower, int reactivePower) Forwards the power request to the SymmetricBatteryInverter.
protected void	deactivate() Handles @Deactivate of implementations.
java.lang.String	debugLog() Gets some output that is suitable for a continuous Debug log.
ModbusSlaveTable	getModbusSlaveTable(AccessMode accessMode) Gets the Modbus-Slave-Table for this OpenEMS-Component.
Power	getPower() Gets an instance of the 'Power' class, which allows to set limitations to Active and Reactive Power.
int	getPowerPrecision() Retrieves PowerPrecision from SymmetricBatteryInverter.
StartStop	getStartStopTarget() Gets the target Start/Stop mode from config or StartStop-Channel.
Constraint[]	getStaticConstraints() Retrieves StaticConstraints from SymmetricBatteryInverter.
void	handleEvent(org.osgi.service.event.Event event)
void	setStartStop(StartStop value) Starts or stops the device or service represented by this OpenEMS Component.

Methods inherited from class io.openems.edge.common.component.AbstractOpenemsComponent

_channel, activate, addChannel, addChannels, addChannels, alias, channels, getComponentContext, id, isEnabled, logDebug, logError, logInfo, logWarn, modified, removeChannel

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.openems.edge.ess.generic.symmetric.GenericManagedSymmetricEss

_setMaxBatteryInverterStartAttemptsFault, _setMaxBatteryInverterStopAttemptsFault, _setMaxBatteryStartAttemptsFault, _setMaxBatteryStopAttemptsFault, getMaxBatteryInverterStartAttemptsFault, getMaxBatteryInverterStartAttemptsFaultChannel, getMaxBatteryInverterStopAttemptsFault, getMaxBatteryInverterStopAttemptsFaultChannel, getMaxBatteryStartAttemptsFault, getMaxBatteryStartAttemptsFaultChannel, getMaxBatteryStopAttemptsFault, getMaxBatteryStopAttemptsFaultChannel

Methods inherited from interface io.openems.edge.ess.api.ManagedSymmetricEss

_setAllowedChargePower, _setAllowedChargePower, _setAllowedDischargePower, _setAllowedDischargePower, _setApplyPowerFailed, _setDebugSetActivePower, _setDebugSetActivePower, _setDebugSetReactivePower, _setDebugSetReactivePower, addPowerConstraint, addPowerConstraintAndValidate, createPowerConstraint, getAllowedChargePower, getAllowedChargePowerChannel, getAllowedDischargePower, getAllowedDischargePowerChannel, getApplyPowerFailed, getApplyPowerFailedChannel, getDebugSetActivePower, getDebugSetActivePowerChannel, getDebugSetReactivePower, getDebugSetReactivePowerChannel, getModbusSlaveNatureTable, getSetActivePowerEqualsChannel, getSetActivePowerEqualsWithPidChannel, getSetActivePowerGreaterOrEqualsChannel, getSetActivePowerLessOrEqualsChannel, getSetReactivePowerEqualsChannel, getSetReactivePowerGreaterOrEqualsChannel, getSetReactivePowerLessOrEqualsChannel, setActivePowerEquals, setActivePowerEqualsWithPid, setActivePowerGreaterOrEquals, setActivePowerLessOrEquals, setReactivePowerEquals, setReactivePowerGreaterOrEquals, setReactivePowerLessOrEquals

Methods inherited from interface io.openems.edge.ess.api.SymmetricEss

_setActiveChargeEnergy, _setActiveChargeEnergy, _setActiveDischargeEnergy, _setActiveDischargeEnergy, _setActivePower, _setActivePower, _setCapacity, _setCapacity, _setGridMode, _setMaxApparentPower, _setMaxApparentPower, _setMaxCellTemperature, _setMaxCellTemperature, _setMaxCellVoltage, _setMaxCellVoltage, _setMinCellTemperature, _setMinCellTemperature, _setMinCellVoltage, _setMinCellVoltage, _setReactivePower, _setReactivePower, _setSoc, _setSoc, getActiveChargeEnergy, getActiveChargeEnergyChannel, getActiveDischargeEnergy, getActiveDischargeEnergyChannel, getActivePower, getActivePowerChannel, getCapacity, getCapacityChannel, getGridMode, getGridModeChannel, getMaxApparentPower, getMaxApparentPowerChannel, getMaxCellTemperature, getMaxCellTemperatureChannel, getMaxCellVoltage, getMaxCellVoltageChannel, getMinCellTemperature, getMinCellTemperatureChannel, getMinCellVoltage, getMinCellVoltageChannel, getReactivePower, getReactivePowerChannel, getSoc, getSocChannel

Methods inherited from interface io.openems.edge.common.component.OpenemsComponent

_channel, _getChannelAs, alias, channel, channel, channels, getComponentContext, getState, getStateChannel, hasFaults, id, isEnabled, logDebug, logError, logInfo, logWarn, serviceFactoryPid, servicePid, updateConfigurationProperty, updateReferenceFilter

Methods inherited from interface io.openems.edge.common.startstop.StartStoppable

_setStartStop, getModbusSlaveNatureTable, getStartStop, getStartStopChannel, isStarted, isStopped, start, stop

Constructor Detail

GenericManagedSymmetricEssImpl

public GenericManagedSymmetricEssImpl()

Method Detail

deactivate

protected void deactivate()

Description copied from class: AbstractOpenemsComponent

Handles @Deactivate of implementations. Prints log output.

Overrides:

deactivate in class AbstractOpenemsComponent

handleEvent

public void handleEvent(org.osgi.service.event.Event event)

Specified by:

handleEvent in interface org.osgi.service.event.EventHandler

debugLog

public java.lang.String debugLog()

Description copied from interface: OpenemsComponent

Gets some output that is suitable for a continuous Debug log. Returns 'null' by default which causes no output.

Specified by:

debugLog in interface OpenemsComponent

Returns:

the debug log output

getPower

public Power getPower()

Description copied from interface: ManagedSymmetricEss

Gets an instance of the 'Power' class, which allows to set limitations to Active and Reactive Power.

Specified by:

getPower in interface ManagedSymmetricEss

Returns:

the Power instance

applyPower

public void applyPower(int activePower,
                       int reactivePower)
                throws OpenemsError.OpenemsNamedException

Forwards the power request to the SymmetricBatteryInverter. Apply the calculated Power.

Careful: do not adjust activePower and reactivePower in this method, e.g. setting it to zero on error. The purpose of this method is solely to apply the calculated power to the ESS. If you need to constrain the allowed power, add Constraints using the ManagedSymmetricEss.getStaticConstraints() method.

Specified by:

applyPower in interface ManagedSymmetricEss

Parameters:

activePower - the active power in [W]

reactivePower - the reactive power in [var]

Throws:

OpenemsError.OpenemsNamedException - on error; causes activation of APPLY_POWER_FAILED StateChannel

getPowerPrecision

public int getPowerPrecision()

Retrieves PowerPrecision from SymmetricBatteryInverter. Gets the smallest positive power that can be set (in W, VA or var). Example:

• FENECON Commercial 40 allows setting of power in 100 W steps. It should return 100.
• KACO blueplanet gridsave 50 allows setting of power in 0.1 % of 52 VA. It should return 52 (= 52000 * 0.001)

Specified by:

getPowerPrecision in interface ManagedSymmetricEss

Returns:

the power precision

getStaticConstraints

public Constraint[] getStaticConstraints()
                                  throws OpenemsError.OpenemsNamedException

Retrieves StaticConstraints from SymmetricBatteryInverter. Gets static Constraints for this Ess. Override this method to provide specific Constraints for this Ess on every Cycle.

Specified by:

getStaticConstraints in interface ManagedSymmetricEss

Returns:

the Constraints

Throws:

OpenemsException - on error

OpenemsError.OpenemsNamedException

setStartStop

public void setStartStop(StartStop value)

Description copied from interface: StartStoppable

Starts or stops the device or service represented by this OpenEMS Component.

Specified by:

setStartStop in interface StartStoppable

Parameters:

value - target StartStop state

getStartStopTarget

public StartStop getStartStopTarget()

Description copied from interface: GenericManagedSymmetricEss

Gets the target Start/Stop mode from config or StartStop-Channel.

Specified by:

getStartStopTarget in interface GenericManagedSymmetricEss

Returns:

StartStop

getModbusSlaveTable

public ModbusSlaveTable getModbusSlaveTable(AccessMode accessMode)

Description copied from interface: ModbusSlave

Gets the Modbus-Slave-Table for this OpenEMS-Component.

Specified by:

getModbusSlaveTable in interface ModbusSlave

Specified by:

getModbusSlaveTable in interface GenericManagedSymmetricEss

Parameters:

accessMode - filters the Modbus-Records that should be shown

Returns:

the Modbus-Slave-Table