Package io.openems.edge.batteryinverter.refu88k

Class RefuStore88kImpl

java.lang.Object

io.openems.edge.common.component.AbstractOpenemsComponent

io.openems.edge.bridge.modbus.api.AbstractOpenemsModbusComponent

io.openems.edge.batteryinverter.refu88k.RefuStore88kImpl

All Implemented Interfaces:

ManagedSymmetricBatteryInverter, SymmetricBatteryInverter, RefuStore88k, ModbusComponent, OpenemsComponent, StartStoppable, TimedataProvider

public class RefuStore88kImpl
extends AbstractOpenemsModbusComponent
implements ManagedSymmetricBatteryInverter, SymmetricBatteryInverter, ModbusComponent, OpenemsComponent, RefuStore88k, TimedataProvider, StartStoppable

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.batteryinverter.api.ManagedSymmetricBatteryInverter

ManagedSymmetricBatteryInverter.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.batteryinverter.refu88k.RefuStore88k

RefuStore88k.ChannelId

Nested classes/interfaces inherited from interface io.openems.edge.common.startstop.StartStoppable

StartStoppable.ChannelId

Nested classes/interfaces inherited from interface io.openems.edge.batteryinverter.api.SymmetricBatteryInverter

SymmetricBatteryInverter.ChannelId

Field Summary

Fields

Modifier and Type	Field	Description
protected org.osgi.service.cm.ConfigurationAdmin	cm
static int	DEFAULT_UNIT_ID
protected static double	EFFICIENCY_FACTOR

Fields inherited from interface io.openems.edge.batteryinverter.refu88k.RefuStore88k

RETRY_COMMAND_MAX_ATTEMPTS, RETRY_COMMAND_SECONDS, WATCHDOG_CYCLES

Fields inherited from interface io.openems.edge.batteryinverter.api.SymmetricBatteryInverter

POWER_DOC_TEXT

Constructor Summary

Constructors

Constructor	Description
RefuStore88kImpl()

Method Summary

Modifier and Type	Method	Description
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.
int	getPowerPrecision()	Gets the smallest positive power that can be set (in W, VA or var).
StartStop	getStartStopTarget()	Gets the target Start/Stop mode from config or StartStop-Channel.
BatteryInverterConstraint[]	getStaticConstraints()	Gets static Constraints for this Battery-Inverter.
Timedata	getTimedata()	Gets the Timedata service.
void	run(Battery battery, int setActivePower, int setReactivePower)	Run the Battery-Inverter.
protected void	setModbus(BridgeModbus modbus)	Set the Modbus bridge.
void	setStartStop(StartStop value)	Starts or stops the device or service represented by this OpenEMS Component.

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, logInfo, 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.batteryinverter.api.ManagedSymmetricBatteryInverter

isManaged, isOffGridPossible

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.batteryinverter.refu88k.RefuStore88k

_setMaxStartAttempts, _setMaxStopAttempts, enterStartedMode, enterThrottledMpptMode, exitStandbyMode, getAcCurrent, getAcVoltage, getApparentPower, getDcVoltage, getMaxStartAttempts, getMaxStartAttemptsChannel, getMaxStopAttempts, getMaxStopAttemptsChannel, getOperatingState, getSerialNumber, stopInverter

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

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

Methods inherited from interface io.openems.edge.batteryinverter.api.SymmetricBatteryInverter

_setActiveChargeEnergy, _setActiveChargeEnergy, _setActiveDischargeEnergy, _setActiveDischargeEnergy, _setActivePower, _setActivePower, _setGridMode, _setMaxApparentPower, _setMaxApparentPower, _setReactivePower, _setReactivePower, getActiveChargeEnergy, getActiveChargeEnergyChannel, getActiveDischargeEnergy, getActiveDischargeEnergyChannel, getActivePower, getActivePowerChannel, getGridMode, getGridModeChannel, getMaxApparentPower, getMaxApparentPowerChannel, getReactivePower, getReactivePowerChannel

Field Detail

DEFAULT_UNIT_ID

public static final int DEFAULT_UNIT_ID

See Also:

Constant Field Values

EFFICIENCY_FACTOR

protected static final double EFFICIENCY_FACTOR

See Also:

Constant Field Values

cm

protected org.osgi.service.cm.ConfigurationAdmin cm

Constructor Detail

RefuStore88kImpl

public RefuStore88kImpl()

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 class AbstractOpenemsModbusComponent

Parameters:

modbus - the BridgeModbus Reference

deactivate

protected void deactivate()

Description copied from class: AbstractOpenemsComponent

Handles @Deactivate of implementations. Prints log output.

Overrides:

deactivate in class AbstractOpenemsModbusComponent

run

public void run(Battery battery,
                int setActivePower,
                int setReactivePower)
         throws OpenemsError.OpenemsNamedException

Description copied from interface: ManagedSymmetricBatteryInverter

Run the Battery-Inverter.

• bring the Battery-Inverter in the desired state
• apply information from Battery as required
• set the target Active and Reactive Power.

This is called on ManagedSymmetricEss::applyPower()

Specified by:

run in interface ManagedSymmetricBatteryInverter

Parameters:

battery - the Battery

setActivePower - the active power setpoint

setReactivePower - the reactive power setpoint

Throws:

OpenemsError.OpenemsNamedException - on error

getStaticConstraints

public BatteryInverterConstraint[] getStaticConstraints()
                                                 throws OpenemsException

Description copied from interface: ManagedSymmetricBatteryInverter

Gets static Constraints for this Battery-Inverter. Override this method to provide specific Constraints for this Battery-Inverter on every Cycle.

Specified by:

getStaticConstraints in interface ManagedSymmetricBatteryInverter

Returns:

the Constraints

Throws:

OpenemsException - on error

getPowerPrecision

public int getPowerPrecision()

Description copied from interface: ManagedSymmetricBatteryInverter

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 ManagedSymmetricBatteryInverter

Returns:

the power precision

defineModbusProtocol

protected ModbusProtocol defineModbusProtocol()
                                       throws OpenemsException

Description copied from class: AbstractOpenemsModbusComponent

Defines the Modbus protocol.

Specified by:

defineModbusProtocol in class AbstractOpenemsModbusComponent

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 interface OpenemsComponent

Returns:

the debug log output

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: RefuStore88k

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

Specified by:

getStartStopTarget in interface RefuStore88k

Returns:

StartStop

getTimedata

public Timedata getTimedata()

Description copied from interface: TimedataProvider

Gets the Timedata service.

Specified by:

getTimedata in interface TimedataProvider

Returns:

the service or null if it is not (yet) available.