jdk.dio.dac

Class DACChannelConfig

java.lang.Object

jdk.dio.dac.DACChannelConfig

All Implemented Interfaces:

DeviceConfig<DACChannel>, DeviceConfig.HardwareAddressing

public final class DACChannelConfig
extends java.lang.Object
implements DeviceConfig<DACChannel>, DeviceConfig.HardwareAddressing

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

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

An instance of DACChannelConfig can be passed to the DeviceManager.open(DeviceConfig) or DeviceManager.open(Class, DeviceConfig) method to open the designated DAC channel with the specified configuration. A InvalidDeviceConfigException is thrown when attempting to open a device with an invalid or unsupported configuration.

See Also:

DeviceManager.open(DeviceConfig), DeviceManager.open(Class, DeviceConfig)

Nested Class Summary

Nested classes/interfaces inherited from interface jdk.dio.DeviceConfig

DeviceConfig.HardwareAddressing

Field Summary

Fields inherited from interface jdk.dio.DeviceConfig

DEFAULT

Constructor Summary

Constructors

Constructor and Description
DACChannelConfig(int controllerNumber, int channelNumber, int resolution, int samplingInterval) Creates a new DACChannelConfig with the specified hardware addressing information and configuration parameters.
DACChannelConfig(java.lang.String controllerName, int channelNumber, int resolution, int samplingInterval) Creates a new DACChannelConfig 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 DACChannelConfig objects for equality.
int	getChannelNumber() Gets the configured channel number.
java.lang.String	getControllerName() Gets the configured controller name (such as its device file name on UNIX systems).
int	getControllerNumber() Gets the configured controller number.
int	getResolution() Gets the configured resolution.
int	getSamplingInterval() Gets the default/initial configured output sampling interval (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

DACChannelConfig

public DACChannelConfig(int controllerNumber,
                int channelNumber,
                int resolution,
                int samplingInterval)

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

Parameters:

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

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

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

samplingInterval - the initial output sampling interval in microseconds (a positive integer) or DeviceConfig.DEFAULT.

Throws:

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

• controllerNumber 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.

DACChannelConfig

public DACChannelConfig(java.lang.String controllerName,
                int channelNumber,
                int resolution,
                int samplingInterval)

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

Parameters:

controllerName - the controller name (such as its device file name on UNIX systems).

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

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

samplingInterval - the initial output sampling interval in microseconds (a positive integer) or DeviceConfig.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.

java.lang.NullPointerException - if controllerName 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 DeviceConfig.DEFAULT.

getControllerNumber

public int getControllerNumber()

Gets the configured controller number.

Specified by:

getControllerNumber in interface DeviceConfig.HardwareAddressing

Returns:

the hardware converter's number (a positive or zero integer) or DeviceConfig.DEFAULT.

getControllerName

public java.lang.String getControllerName()

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

Specified by:

getControllerName in interface DeviceConfig.HardwareAddressing

Returns:

the controllerName or null.

getResolution

public int getResolution()

Gets the configured resolution.

Returns:

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

getSamplingInterval

public int getSamplingInterval()

Gets the default/initial configured output sampling interval (in microseconds).

Returns:

the default/initial output sampling interval in microseconds (a positive integer) or DeviceConfig.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 DACChannelConfig 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 DACChannelConfig and has the same hardware addressing information and configuration parameter values as this DACChannelConfig object.