Package io.openems.edge.fenecon.mini.ess
Class FeneconMiniEssImpl
- java.lang.Object
-
- io.openems.edge.common.component.AbstractOpenemsComponent
-
- io.openems.edge.bridge.modbus.api.AbstractOpenemsModbusComponent
-
- io.openems.edge.fenecon.mini.ess.FeneconMiniEssImpl
-
- All Implemented Interfaces:
ModbusComponent
,OpenemsComponent
,ModbusSlave
,AsymmetricEss
,ManagedAsymmetricEss
,ManagedSinglePhaseEss
,ManagedSymmetricEss
,SinglePhaseEss
,SymmetricEss
,FeneconMiniEss
,TimedataProvider
,org.osgi.service.event.EventHandler
public class FeneconMiniEssImpl extends AbstractOpenemsModbusComponent implements FeneconMiniEss, ManagedSinglePhaseEss, ManagedAsymmetricEss, ManagedSymmetricEss, SinglePhaseEss, AsymmetricEss, SymmetricEss, ModbusComponent, OpenemsComponent, ModbusSlave, TimedataProvider, org.osgi.service.event.EventHandler
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class io.openems.edge.bridge.modbus.api.AbstractOpenemsModbusComponent
AbstractOpenemsModbusComponent.BitConverter, AbstractOpenemsModbusComponent.ChannelMapper<T extends AbstractModbusElement<?>>
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.AsymmetricEss
AsymmetricEss.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.fenecon.mini.ess.FeneconMiniEss
FeneconMiniEss.ChannelId, FeneconMiniEss.ServiceInfoChannelId, FeneconMiniEss.SystemErrorChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.ManagedAsymmetricEss
ManagedAsymmetricEss.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.ManagedSinglePhaseEss
ManagedSinglePhaseEss.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.ManagedSymmetricEss
ManagedSymmetricEss.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.bridge.modbus.api.ModbusComponent
ModbusComponent.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.common.component.OpenemsComponent
OpenemsComponent.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.SinglePhaseEss
SinglePhaseEss.ChannelId
-
Nested classes/interfaces inherited from interface io.openems.edge.ess.api.SymmetricEss
SymmetricEss.ChannelId
-
-
Field Summary
Fields Modifier and Type Field Description protected org.osgi.service.cm.ConfigurationAdmin
cm
protected Power
power
-
Fields inherited from interface io.openems.edge.fenecon.mini.ess.FeneconMiniEss
MAX_APPARENT_POWER
-
-
Constructor Summary
Constructors Constructor Description FeneconMiniEssImpl()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
applyPower(int activePower, int reactivePower)
Apply the calculated Power.protected void
deactivate()
Handles @Deactivate of implementations.java.lang.String
debugLog()
Gets some output that is suitable for a continuous Debug log.protected ModbusProtocol
defineModbusProtocol()
Defines the Modbus protocol.ModbusSlaveTable
getModbusSlaveTable(AccessMode accessMode)
Gets the Modbus-Slave-Table for this OpenEMS-Component.SinglePhase
getPhase()
Gets the Phase this ESS is connected to.Power
getPower()
Gets an instance of the 'Power' class, which allows to set limitations to Active and Reactive Power.int
getPowerPrecision()
Gets the smallest positive power that can be set (in W, VA or var).Constraint[]
getStaticConstraints()
Gets static Constraints for this Ess.Timedata
getTimedata()
Gets theTimedata
service.void
handleEvent(org.osgi.service.event.Event event)
boolean
isManaged()
Gets a boolean if the ess is managed or not.protected void
logInfo(org.slf4j.Logger log, java.lang.String message)
Log an info message including the Component ID.protected void
setModbus(BridgeModbus modbus)
Set the Modbus bridge.-
Methods inherited from class io.openems.edge.bridge.modbus.api.AbstractOpenemsModbusComponent
activate, activate, activate, getBridgeModbus, getModbusProtocol, getUnitId, m, m, m, m, m, m, modified, modified, unsetModbus
-
Methods inherited from class io.openems.edge.common.component.AbstractOpenemsComponent
_channel, addChannel, addChannels, addChannels, alias, channels, getComponentContext, id, isEnabled, logDebug, logError, logWarn, 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.api.AsymmetricEss
_setActivePowerL1, _setActivePowerL1, _setActivePowerL2, _setActivePowerL2, _setActivePowerL3, _setActivePowerL3, _setReactivePowerL1, _setReactivePowerL1, _setReactivePowerL2, _setReactivePowerL2, _setReactivePowerL3, _setReactivePowerL3, getActivePowerL1, getActivePowerL1Channel, getActivePowerL2, getActivePowerL2Channel, getActivePowerL3, getActivePowerL3Channel, getReactivePowerL1, getReactivePowerL1Channel, getReactivePowerL2, getReactivePowerL2Channel, getReactivePowerL3, getReactivePowerL3Channel
-
Methods inherited from interface io.openems.edge.fenecon.mini.ess.FeneconMiniEss
applyPower, getBecu1AllowedChargeCurrentChannel, getBecu1AllowedDischargeCurrentChannel, getBecu1TotalVoltage, getBecu1TotalVoltageChannel, getDebugRunState, getDebugRunStateChannel, getGridMaxChargeCurrent, getGridMaxChargeCurrentChannel, getGridMaxDischargeCurrent, getGridMaxDischargeCurrentChannel, getPcsMode, getPcsModeChannel, getSetupMode, getSetupModeChannel, setDebugRunState, setGridMaxChargeCurrent, setGridMaxDischargeCurrent, setPcsMode, setSetupMode
-
Methods inherited from interface io.openems.edge.ess.api.ManagedAsymmetricEss
_setDebugSetActivePowerL1, _setDebugSetActivePowerL1, _setDebugSetActivePowerL2, _setDebugSetActivePowerL2, _setDebugSetActivePowerL3, _setDebugSetActivePowerL3, _setDebugSetReactivePowerL1, _setDebugSetReactivePowerL1, _setDebugSetReactivePowerL2, _setDebugSetReactivePowerL2, _setDebugSetReactivePowerL3, _setDebugSetReactivePowerL3, applyPower, getDebugSetActivePowerL1, getDebugSetActivePowerL1Channel, getDebugSetActivePowerL2, getDebugSetActivePowerL2Channel, getDebugSetActivePowerL3, getDebugSetActivePowerL3Channel, getDebugSetReactivePowerL1, getDebugSetReactivePowerL1Channel, getDebugSetReactivePowerL2, getDebugSetReactivePowerL2Channel, getDebugSetReactivePowerL3, getDebugSetReactivePowerL3Channel, getSetActivePowerL1EqualsChannel, getSetActivePowerL1GreaterOrEqualsChannel, getSetActivePowerL1LessOrEqualsChannel, getSetActivePowerL2EqualsChannel, getSetActivePowerL2GreaterOrEqualsChannel, getSetActivePowerL2LessOrEqualsChannel, getSetActivePowerL3EqualsChannel, getSetActivePowerL3GreaterOrEqualsChannel, getSetActivePowerL3LessOrEqualsChannel, getSetReactivePowerL1EqualsChannel, getSetReactivePowerL1GreaterOrEqualsChannel, getSetReactivePowerL1LessOrEqualsChannel, getSetReactivePowerL2EqualsChannel, getSetReactivePowerL2GreaterOrEqualsChannel, getSetReactivePowerL2LessOrEqualsChannel, getSetReactivePowerL3EqualsChannel, getSetReactivePowerL3GreaterOrEqualsChannel, getSetReactivePowerL3LessOrEqualsChannel, setSetActivePowerL1Equals, setSetActivePowerL1GreaterOrEquals, setSetActivePowerL1LessOrEquals, setSetActivePowerL2Equals, setSetActivePowerL2GreaterOrEquals, setSetActivePowerL2LessOrEquals, setSetActivePowerL3Equals, setSetActivePowerL3GreaterOrEquals, setSetActivePowerL3LessOrEquals, setSetReactivePowerL1Equals, setSetReactivePowerL1GreaterOrEquals, setSetReactivePowerL1LessOrEquals, setSetReactivePowerL2Equals, setSetReactivePowerL2GreaterOrEquals, setSetReactivePowerL2LessOrEquals, setSetReactivePowerL3Equals, setSetReactivePowerL3GreaterOrEquals, setSetReactivePowerL3LessOrEquals
-
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, getSetActivePowerEqualsChannel, getSetActivePowerEqualsWithPidChannel, getSetActivePowerGreaterOrEqualsChannel, getSetActivePowerLessOrEqualsChannel, getSetReactivePowerEqualsChannel, getSetReactivePowerGreaterOrEqualsChannel, getSetReactivePowerLessOrEqualsChannel, setActivePowerEquals, setActivePowerEqualsWithPid, setActivePowerGreaterOrEquals, setActivePowerLessOrEquals, setReactivePowerEquals, setReactivePowerGreaterOrEquals, setReactivePowerLessOrEquals
-
Methods inherited from interface io.openems.edge.bridge.modbus.api.ModbusComponent
_setModbusCommunicationFailed, getModbusCommunicationFailed, getModbusCommunicationFailedChannel
-
Methods inherited from interface io.openems.edge.common.component.OpenemsComponent
_channel, _getChannelAs, alias, channel, channel, channels, getComponentContext, getState, getStateChannel, hasFaults, id, isEnabled, serviceFactoryPid, servicePid
-
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
-
-
-
-
Field Detail
-
cm
protected org.osgi.service.cm.ConfigurationAdmin cm
-
power
protected Power power
-
-
Method Detail
-
setModbus
protected void setModbus(BridgeModbus modbus)
Description copied from class:AbstractOpenemsModbusComponent
Set the Modbus bridge. Should be called by @Reference- Overrides:
setModbus
in classAbstractOpenemsModbusComponent
- Parameters:
modbus
- the BridgeModbus Reference
-
deactivate
protected void deactivate()
Description copied from class:AbstractOpenemsComponent
Handles @Deactivate of implementations. Prints log output.- Overrides:
deactivate
in classAbstractOpenemsModbusComponent
-
getPhase
public SinglePhase getPhase()
Description copied from interface:SinglePhaseEss
Gets the Phase this ESS is connected to.- Specified by:
getPhase
in interfaceSinglePhaseEss
- Returns:
- the
SinglePhase
-
defineModbusProtocol
protected ModbusProtocol defineModbusProtocol() throws OpenemsException
Description copied from class:AbstractOpenemsModbusComponent
Defines the Modbus protocol.- Specified by:
defineModbusProtocol
in classAbstractOpenemsModbusComponent
- Returns:
- the ModbusProtocol
- Throws:
OpenemsException
- on error
-
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 interfaceOpenemsComponent
- Returns:
- the debug log output
-
getModbusSlaveTable
public ModbusSlaveTable getModbusSlaveTable(AccessMode accessMode)
Description copied from interface:ModbusSlave
Gets the Modbus-Slave-Table for this OpenEMS-Component.- Specified by:
getModbusSlaveTable
in interfaceModbusSlave
- Parameters:
accessMode
- filters the Modbus-Records that should be shown- Returns:
- the Modbus-Slave-Table
-
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 interfaceManagedSymmetricEss
- Returns:
- the Power instance
-
isManaged
public boolean isManaged()
Description copied from interface:ManagedSymmetricEss
Gets a boolean if the ess is managed or not.Returns false if the ess itself is not managed or in a read only mode.
- Specified by:
isManaged
in interfaceManagedSymmetricEss
- Returns:
- is managed or not
-
applyPower
public void applyPower(int activePower, int reactivePower) throws OpenemsError.OpenemsNamedException
Description copied from interface:ManagedSymmetricEss
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 interfaceManagedAsymmetricEss
- Specified by:
applyPower
in interfaceManagedSymmetricEss
- 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()
Description copied from interface:ManagedSymmetricEss
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 interfaceManagedSymmetricEss
- Returns:
- the power precision
-
getStaticConstraints
public Constraint[] getStaticConstraints() throws OpenemsError.OpenemsNamedException
Description copied from interface:ManagedSymmetricEss
Gets static Constraints for this Ess. Override this method to provide specific Constraints for this Ess on every Cycle.- Specified by:
getStaticConstraints
in interfaceManagedSymmetricEss
- Returns:
- the Constraints
- Throws:
OpenemsException
- on errorOpenemsError.OpenemsNamedException
-
handleEvent
public void handleEvent(org.osgi.service.event.Event event)
- Specified by:
handleEvent
in interfaceorg.osgi.service.event.EventHandler
-
getTimedata
public Timedata getTimedata()
Description copied from interface:TimedataProvider
Gets theTimedata
service.- Specified by:
getTimedata
in interfaceTimedataProvider
- Returns:
- the service or null if it is not (yet) available.
-
logInfo
protected void logInfo(org.slf4j.Logger log, java.lang.String message)
Description copied from class:AbstractOpenemsComponent
Log an info message including the Component ID.- Overrides:
logInfo
in classAbstractOpenemsComponent
- Parameters:
log
- the Logger instancemessage
- the message
-
-