com.oracle.deviceaccess.adc

Class ADCChannelConfig

java.lang.Object

com.oracle.deviceaccess.adc.ADCChannelConfig

All Implemented Interfaces:

PeripheralConfig<ADCChannel>, PeripheralConfig.HardwareAddressing

public final class ADCChannelConfig
extends java.lang.Object
implements PeripheralConfig<ADCChannel>, PeripheralConfig.HardwareAddressing

The ADCChannelConfig class encapsulates the hardware addressing information, and static and dynamic configuration parameters of an ADC channel.

Some hardware addressing parameter, and static and dynamic configuration parameters may be set to PeripheralConfig.DEFAULT. Whether such default settings are supported is platform- as well as peripheral driver-dependent.

An instance of ADCChannelConfig can be passed to the PeripheralManager.open(PeripheralConfig) or PeripheralManager.open(Class, PeripheralConfig) method to open the designated ADC channel with the specified configuration. A PeripheralConfigInvalidException is thrown when attempting to open a peripheral device with an invalid or unsupported configuration.

See Also:

PeripheralManager.open(PeripheralConfig), PeripheralManager.open(Class, PeripheralConfig)

Nested Class Summary

Nested classes/interfaces inherited from interface com.oracle.deviceaccess.PeripheralConfig

PeripheralConfig.HardwareAddressing

Field Summary

Fields inherited from interface com.oracle.deviceaccess.PeripheralConfig

DEFAULT

Constructor Summary

Constructors

Constructor and Description
ADCChannelConfig(int deviceNumber, int channelNumber, int resolution, int samplingInterval, int samplingTime) Creates a new ADCChannelConfig with the specified hardware addressing information and configuration parameters.
ADCChannelConfig(java.lang.String deviceName, int channelNumber, int resolution, int samplingInterval, int samplingTime) Creates a new ADCChannelConfig with the specified hardware addressing information and configuration parameters.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Checks two ADCChannelConfig objects for equality.
int	getChannelNumber() Gets the configured channel number.
java.lang.String	getDeviceName() Gets the configured device name (such as to its device file name on UNIX systems).
int	getDeviceNumber() Gets the configured device number (such as the ADC conveter number).
int	getResolution() Gets the configured resolution.
int	getSamplingInterval() Gets the configured default/initial input sampling interval - the amount of time between two samples (in microseconds).
int	getSamplingTime() Gets the configured input sampling time - the amount of time to take the sample (in microseconds).
int	hashCode() Returns the hash code value for this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

ADCChannelConfig

public ADCChannelConfig(int deviceNumber,
                int channelNumber,
                int resolution,
                int samplingInterval,
                int samplingTime)

Creates a new ADCChannelConfig with the specified hardware addressing information and configuration parameters.

Parameters:

deviceNumber - the hardware converter's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

channelNumber - the hardware channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

resolution - the resolution in bits (a positive integer) or PeripheralConfig.DEFAULT.

samplingInterval - the initial input sampling interval (the amount of time between two samples) in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

samplingTime - the sampling time (the amount of time to take the sample) in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• deviceNumber is not in the defined range;
• channelNumber is not in the defined range;
• resolution is not in the defined range;
• samplingInterval is not in the defined range;
• samplingTime is not in the defined range.

ADCChannelConfig

public ADCChannelConfig(java.lang.String deviceName,
                int channelNumber,
                int resolution,
                int samplingInterval,
                int samplingTime)

Creates a new ADCChannelConfig with the specified hardware addressing information and configuration parameters.

Parameters:

deviceName - the device name (such as to its device file name on UNIX systems).

channelNumber - the hardware channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

resolution - the resolution in bits (a positive integer) or PeripheralConfig.DEFAULT.

samplingInterval - the initial input sampling interval (the amount of time between two samples) in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

samplingTime - the sampling time (the amount of time to take the sample) in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

Throws:

java.lang.IllegalArgumentException - if any of the following is true:

• channelNumber is not in the defined range;
• resolution is not in the defined range;
• samplingInterval is not in the defined range;
• samplingTime is not in the defined range.

java.lang.NullPointerException - if deviceName is null.

Method Detail

getChannelNumber

public int getChannelNumber()

Gets the configured channel number.

Returns:

the hardware channel's number (a positive or zero integer) or PeripheralConfig.DEFAULT.

getDeviceNumber

public int getDeviceNumber()

Gets the configured device number (such as the ADC conveter number).

Specified by:

getDeviceNumber in interface PeripheralConfig.HardwareAddressing

Returns:

the device number (a positive or zero integer) or PeripheralConfig.DEFAULT.

getDeviceName

public java.lang.String getDeviceName()

Gets the configured device name (such as to its device file name on UNIX systems).

Specified by:

getDeviceName in interface PeripheralConfig.HardwareAddressing

Returns:

the device name or null.

getResolution

public int getResolution()

Gets the configured resolution.

Returns:

the resolution in bits (a positive integer) or PeripheralConfig.DEFAULT.

getSamplingInterval

public int getSamplingInterval()

Gets the configured default/initial input sampling interval - the amount of time between two samples (in microseconds).

Returns:

the default/initial input sampling interval in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

getSamplingTime

public int getSamplingTime()

Gets the configured input sampling time - the amount of time to take the sample (in microseconds).

Returns:

the input sampling time in microseconds (a positive integer) or PeripheralConfig.DEFAULT.

hashCode

public int hashCode()

Returns the hash code value for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

a hash code value for this object.

equals

public boolean equals(java.lang.Object obj)

Checks two ADCChannelConfig objects for equality.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to test for equality with this object.

Returns:

true if obj is a ADCChannelConfig and has the same hardware addressing information and configuration parameter values as this ADCChannelConfig object.