Package io.openems.edge.batteryinverter.sinexcel

Class BatteryInverterSinexcelImpl

java.lang.Object

io.openems.edge.common.component.AbstractOpenemsComponent

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

io.openems.edge.batteryinverter.sinexcel.BatteryInverterSinexcelImpl

All Implemented Interfaces:

ManagedSymmetricBatteryInverter, OffGridBatteryInverter, SymmetricBatteryInverter, BatteryInverterSinexcel, ModbusComponent, OpenemsComponent, ModbusSlave, StartStoppable, TimedataProvider

public class BatteryInverterSinexcelImpl
extends AbstractOpenemsModbusComponent
implements BatteryInverterSinexcel, OffGridBatteryInverter, ManagedSymmetricBatteryInverter, SymmetricBatteryInverter, ModbusComponent, OpenemsComponent, TimedataProvider, StartStoppable

Nested Class Summary

Nested classes/interfaces inherited from class io.openems.edge.bridge.modbus.api.AbstractOpenemsModbusComponent

AbstractOpenemsModbusComponent.BitConverter, AbstractOpenemsModbusComponent.ChannelMapper<ELEMENT extends ModbusElement>

Nested classes/interfaces inherited from interface io.openems.edge.batteryinverter.sinexcel.BatteryInverterSinexcel

BatteryInverterSinexcel.ChannelId

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

OffGridBatteryInverter.ChannelId, OffGridBatteryInverter.TargetGridMode

Nested classes/interfaces inherited from interface io.openems.edge.common.component.OpenemsComponent

OpenemsComponent.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 Config	config
static final int	DEFAULT_BMS_TIMEOUT
static final int	DEFAULT_EMS_TIMEOUT
static final EnableDisable	DEFAULT_GRID_EXISTENCE_DETECTION_ON
static final PowerRisingMode	DEFAULT_POWER_RISING_MODE
static final int	DEFAULT_UNIT_ID
static final int	MAX_APPARENT_POWER
protected final AtomicReference<OffGridBatteryInverter.TargetGridMode>	targetGridMode

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

POWER_DOC_TEXT

Constructor Summary

Constructors

Constructor	Description
BatteryInverterSinexcelImpl()

Method Summary

Modifier and Type	Method	Description
protected void	deactivate()	Handles @Deactivate of implementations.
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.
int	getPowerPrecision()	Gets the smallest positive power that can be set (in W, VA or var).
StartStop	getStartStopTarget()	Gets the inverter start-stop target.
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.
void	setTargetGridMode(OffGridBatteryInverter.TargetGridMode targetGridMode)	Tells the Battery-Inverter to go to ON_GRID or OFF_GRID mode.

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, retryModbusCommunication, 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.sinexcel.BatteryInverterSinexcel

getClearFailureChannel, getSetOffGridMode, getSetOffGridModeChannel, getSetOnGridMode, getSetOnGridModeChannel, getStartInverterChannel, getStopInverterChannel, setClearFailure, setOffGridMode, setOnGridMode, setStartInverter, setStopInverter

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, retryModbusCommunication

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

_setInverterState, _setOffGridFrequency, _setOffGridFrequency, getInverterState, getInverterStateChannel, getOffGridFrequency, getOffGridFrequencyChannel, getSetOffGridFrequencyChannel, setTargetOffGridFrequency

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.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 Details

MAX_APPARENT_POWER

public static final int MAX_APPARENT_POWER

See Also:

• Constant Field Values

DEFAULT_UNIT_ID

public static final int DEFAULT_UNIT_ID

See Also:

• Constant Field Values

DEFAULT_EMS_TIMEOUT

public static final int DEFAULT_EMS_TIMEOUT

See Also:

• Constant Field Values

DEFAULT_BMS_TIMEOUT

public static final int DEFAULT_BMS_TIMEOUT

See Also:

• Constant Field Values

DEFAULT_GRID_EXISTENCE_DETECTION_ON

public static final EnableDisable DEFAULT_GRID_EXISTENCE_DETECTION_ON

DEFAULT_POWER_RISING_MODE

public static final PowerRisingMode DEFAULT_POWER_RISING_MODE

config

protected Config config

targetGridMode

protected final AtomicReference<OffGridBatteryInverter.TargetGridMode> targetGridMode

Constructor Details

BatteryInverterSinexcelImpl

public BatteryInverterSinexcelImpl()
                            throws OpenemsError.OpenemsNamedException

Throws:

OpenemsError.OpenemsNamedException

Method Details

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

debugLog

public 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()

Gets the inverter start-stop target.

Returns:

StartStop

setTargetGridMode

public void setTargetGridMode(OffGridBatteryInverter.TargetGridMode targetGridMode)

Description copied from interface: OffGridBatteryInverter

Tells the Battery-Inverter to go to ON_GRID or OFF_GRID mode. Be sure to call this method before you call StartStoppable.start().

Specified by:

setTargetGridMode in interface OffGridBatteryInverter

Parameters:

targetGridMode - the OffGridBatteryInverter.TargetGridMode

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

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

Parameters:

accessMode - filters the Modbus-Records that should be shown

Returns:

the Modbus-Slave-Table

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

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.