Package com.smartgridready.communicator.generic.impl

Class SGrGenericDevice

java.lang.Object

com.smartgridready.communicator.common.impl.SGrDeviceBase<com.smartgridready.ns.v0.DeviceFrame,com.smartgridready.ns.v0.GenericFunctionalProfile,com.smartgridready.ns.v0.DataPointBase>

com.smartgridready.communicator.generic.impl.SGrGenericDevice

All Implemented Interfaces:

GenDeviceApi

public class SGrGenericDevice
extends SGrDeviceBase<com.smartgridready.ns.v0.DeviceFrame,com.smartgridready.ns.v0.GenericFunctionalProfile,com.smartgridready.ns.v0.DataPointBase>

Implements a generic device, which has no actual communication interface. Supports constant data points only.

Nested Class Summary

Nested classes/interfaces inherited from class com.smartgridready.communicator.common.impl.SGrDeviceBase

SGrDeviceBase.Comparator, SGrDeviceBase.RwpDirections

Field Summary

Fields inherited from class com.smartgridready.communicator.common.impl.SGrDeviceBase

device

Constructor Summary

Constructors

Constructor	Description
SGrGenericDevice(com.smartgridready.ns.v0.DeviceFrame deviceDescription)	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
void	connect()	Connect the device.
void	disconnect()	Disconnect the device.
protected java.util.Optional<com.smartgridready.ns.v0.DataPointBase>	findDataPointForProfile(com.smartgridready.ns.v0.GenericFunctionalProfile functionalProfile, java.lang.String dataPointName)	Finds a data point of a given functional profile by name.
protected java.util.Optional<com.smartgridready.ns.v0.GenericFunctionalProfile>	findProfile(java.lang.String profileName)	Finds a functional profile by name.
Value	getVal(java.lang.String profileName, java.lang.String dataPointName)	Get a value for a given data point
Value	getVal(java.lang.String profileName, java.lang.String dataPointName, java.util.Properties parameters)	Get a value for a given data point, with request-specific parameters
boolean	isConnected()	Checks if the device is connected.
void	setVal(java.lang.String profileName, java.lang.String dataPointName, Value value)	Set a value for a given data point

Methods inherited from class com.smartgridready.communicator.common.impl.SGrDeviceBase

applyUnitConversion, canSubscribe, checkOutOfRange, checkOutOfRange, checkReadWritePermission, divide, findDataPoint, getDataPoint, getDataPoints, getDeviceConfigurationInfo, getDeviceInfo, getFunctionalProfile, getFunctionalProfiles, getValues, isNumeric, multiply, subscribe, unsubscribe

Methods inherited from class java.lang.Object

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

Constructor Detail

SGrGenericDevice

public SGrGenericDevice(com.smartgridready.ns.v0.DeviceFrame deviceDescription)

Constructs a new instance.

Parameters:

deviceDescription - the EID description

Method Detail

getVal

public Value getVal(java.lang.String profileName,
                    java.lang.String dataPointName)
             throws com.smartgridready.driver.api.common.GenDriverException

Description copied from interface: GenDeviceApi

Get a value for a given data point

Parameters:

profileName - The functional profile name

dataPointName - The data point name

Returns:

The value read from the device

Throws:

com.smartgridready.driver.api.common.GenDriverException - Generic error while reading from the device

getVal

public Value getVal(java.lang.String profileName,
                    java.lang.String dataPointName,
                    java.util.Properties parameters)
             throws com.smartgridready.driver.api.common.GenDriverException

Description copied from interface: GenDeviceApi

Get a value for a given data point, with request-specific parameters

Parameters:

profileName - The functional profile name

dataPointName - The data point name

parameters - Key value pairs with request parameters

Returns:

The value read from the device

Throws:

com.smartgridready.driver.api.common.GenDriverException - Generic error while reading from the device

setVal

public void setVal(java.lang.String profileName,
                   java.lang.String dataPointName,
                   Value value)
            throws com.smartgridready.driver.api.common.GenDriverException

Description copied from interface: GenDeviceApi

Set a value for a given data point

Parameters:

profileName - The functional profile name

dataPointName - The data point name

value - The value to be set

Throws:

com.smartgridready.driver.api.common.GenDriverException - Generic error while reading from the device

connect

public void connect()
             throws com.smartgridready.driver.api.common.GenDriverException

Description copied from interface: GenDeviceApi

Connect the device.

Throws:

com.smartgridready.driver.api.common.GenDriverException - Generic error while reading from the device

disconnect

public void disconnect()
                throws com.smartgridready.driver.api.common.GenDriverException

Description copied from interface: GenDeviceApi

Disconnect the device.

Throws:

com.smartgridready.driver.api.common.GenDriverException - Generic error while reading from the device

isConnected

public boolean isConnected()

Description copied from interface: GenDeviceApi

Checks if the device is connected.

Returns:

true if connected, false otherwise

findProfile

protected java.util.Optional<com.smartgridready.ns.v0.GenericFunctionalProfile> findProfile(java.lang.String profileName)

Description copied from class: SGrDeviceBase

Finds a functional profile by name.

Specified by:

findProfile in class SGrDeviceBase<com.smartgridready.ns.v0.DeviceFrame,com.smartgridready.ns.v0.GenericFunctionalProfile,com.smartgridready.ns.v0.DataPointBase>

Parameters:

profileName - the name of the functional profile

Returns:

an optional functional profile

findDataPointForProfile

protected java.util.Optional<com.smartgridready.ns.v0.DataPointBase> findDataPointForProfile(com.smartgridready.ns.v0.GenericFunctionalProfile functionalProfile,
                                                                                             java.lang.String dataPointName)

Description copied from class: SGrDeviceBase

Finds a data point of a given functional profile by name.

Specified by:

findDataPointForProfile in class SGrDeviceBase<com.smartgridready.ns.v0.DeviceFrame,com.smartgridready.ns.v0.GenericFunctionalProfile,com.smartgridready.ns.v0.DataPointBase>

Parameters:

functionalProfile - the functional profile

dataPointName - the name of the data point to find

Returns:

an optional data point