io.openems.edge.simulator.app

Class SimulatorApp

java.lang.Object

io.openems.edge.common.component.AbstractOpenemsComponent

io.openems.edge.simulator.app.SimulatorApp

All Implemented Interfaces:

CommonTimedataService, ClockProvider, OpenemsComponent, JsonApi, SimulatorDatasource, Timedata, org.osgi.service.event.EventHandler

public class SimulatorApp
extends AbstractOpenemsComponent
implements SimulatorDatasource, ClockProvider, OpenemsComponent, JsonApi, org.osgi.service.event.EventHandler, Timedata

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SimulatorApp.ChannelId

Constructor Summary

Constructors

Constructor and Description
SimulatorApp()

Method Summary

Modifier and Type	Method and Description
protected void	deactivate() Handles @Deactivate of implementations.
java.time.Clock	getClock() Gets the Clock - real or mocked like TimeLeapClock.
java.util.Set<java.lang.String>	getKeys() Gets the available keys.
java.util.concurrent.CompletableFuture<java.util.Optional<java.lang.Object>>	getLatestValue(ChannelAddress channelAddress) Gets the latest known value for the given ChannelAddress.
int	getTimeDelta() Returns the delta between two values in seconds.
<T> T	getValue(OpenemsType type, java.lang.String channelAddress) Gets the value for the given key (channelId) in the given type.
void	handleEvent(org.osgi.service.event.Event event)
java.util.concurrent.CompletableFuture<? extends JsonrpcResponseSuccess>	handleJsonrpcRequest(User user, JsonrpcRequest request) Handles a JSON-RPC Request.
java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>>	queryHistoricData(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels, int resolution) Queries historic data.
java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>	queryHistoricEnergy(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels) Queries historic energy.
java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>>	queryHistoricEnergyPerPeriod(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels, int resolution) Queries historic energy per period.

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.common.timedata.CommonTimedataService

calculateResolution, handleQueryHistoricTimeseriesExportXlxsRequest, queryHistoricData

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

_channel, _getChannelAs, alias, channel, channel, channels, debugLog, getComponentContext, getModbusSlaveNatureTable, getState, getStateChannel, hasFaults, id, isEnabled, serviceFactoryPid, servicePid, updateConfigurationProperty, updateReferenceFilter

Constructor Detail

SimulatorApp

public SimulatorApp()

Method Detail

deactivate

protected void deactivate()

Description copied from class: AbstractOpenemsComponent

Handles @Deactivate of implementations. Prints log output.

Overrides:

deactivate in class AbstractOpenemsComponent

handleJsonrpcRequest

public java.util.concurrent.CompletableFuture<? extends JsonrpcResponseSuccess> handleJsonrpcRequest(User user,
                                                                                                     JsonrpcRequest request)
                                                                                              throws OpenemsError.OpenemsNamedException

Description copied from interface: JsonApi

Handles a JSON-RPC Request.

Specified by:

handleJsonrpcRequest in interface JsonApi

Parameters:

user - the authenticated User

request - the JSON-RPC Request

Returns:

a Future JSON-RPC Success Response; null response results in a OpenemsError.JSONRPC_UNHANDLED_METHOD

Throws:

OpenemsError.OpenemsNamedException - on error

handleEvent

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

Specified by:

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

getClock

public java.time.Clock getClock()

Description copied from interface: ClockProvider

Gets the Clock - real or mocked like TimeLeapClock.

Specified by:

getClock in interface ClockProvider

Returns:

the Clock

getKeys

public java.util.Set<java.lang.String> getKeys()

Description copied from interface: SimulatorDatasource

Gets the available keys.

Specified by:

getKeys in interface SimulatorDatasource

Returns:

the Channel-Id

getTimeDelta

public int getTimeDelta()

Description copied from interface: SimulatorDatasource

Returns the delta between two values in seconds.

Specified by:

getTimeDelta in interface SimulatorDatasource

Returns:

the delta in seconds

getValue

public <T> T getValue(OpenemsType type,
                      java.lang.String channelAddress)

Description copied from interface: SimulatorDatasource

Gets the value for the given key (channelId) in the given type.

Specified by:

getValue in interface SimulatorDatasource

Type Parameters:

T - the type

Parameters:

type - the expected type

Returns:

the value

queryHistoricData

public java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>> queryHistoricData(java.lang.String edgeId,
                                                                                                                                      java.time.ZonedDateTime fromDate,
                                                                                                                                      java.time.ZonedDateTime toDate,
                                                                                                                                      java.util.Set<ChannelAddress> channels,
                                                                                                                                      int resolution)
                                                                                                                               throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic data.

Specified by:

queryHistoricData in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

resolution - the Resolution in seconds

Throws:

OpenemsError.OpenemsNamedException

queryHistoricEnergy

public java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement> queryHistoricEnergy(java.lang.String edgeId,
                                                                                           java.time.ZonedDateTime fromDate,
                                                                                           java.time.ZonedDateTime toDate,
                                                                                           java.util.Set<ChannelAddress> channels)
                                                                                    throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic energy.

Specified by:

queryHistoricEnergy in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

Throws:

OpenemsError.OpenemsNamedException

queryHistoricEnergyPerPeriod

public java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>> queryHistoricEnergyPerPeriod(java.lang.String edgeId,
                                                                                                                                                 java.time.ZonedDateTime fromDate,
                                                                                                                                                 java.time.ZonedDateTime toDate,
                                                                                                                                                 java.util.Set<ChannelAddress> channels,
                                                                                                                                                 int resolution)
                                                                                                                                          throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic energy per period.

This is for use-cases where you want to get the energy for each period (with length 'resolution') per Channel, e.g. to visualize energy in a histogram chart. For each period the energy is calculated by subtracting first value of the period from the last value of the period.

Specified by:

queryHistoricEnergyPerPeriod in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

resolution - the Resolution in seconds

Throws:

OpenemsError.OpenemsNamedException

getLatestValue

public java.util.concurrent.CompletableFuture<java.util.Optional<java.lang.Object>> getLatestValue(ChannelAddress channelAddress)

Description copied from interface: Timedata

Gets the latest known value for the given ChannelAddress.

Specified by:

getLatestValue in interface Timedata

Parameters:

channelAddress - the ChannelAddress to be queried

Returns:

the latest known value or Empty