com.acces.aiousb
Class AO16_AnalogOutputSubsystem

java.lang.Object
  extended by com.acces.aiousb.AnalogOutputSubsystem
      extended by com.acces.aiousb.AO16_AnalogOutputSubsystem

public class AO16_AnalogOutputSubsystem
extends AnalogOutputSubsystem

Class AO16_AnalogOutputSubsystem represents the analog output subsystem of a device. One accesses this analog output subsystem through its parent object, typically through a method such as dac() (see USB_AO16_Family.dac()).


Field Summary
static int MAX_COUNTS
          Maximum number of counts D/A can output.
static int MIN_COUNTS
          Minimum number of counts D/A can output.
static int RANGE_0_10V
          Unipolar, 0-10 volt range (see setRange()).
static int RANGE_0_5V
          Unipolar, 0-5 volt range (see setRange()).
static int RANGE_10V
          Bipolar, -10 to +10 volt range (see setRange()).
static int RANGE_5V
          Bipolar, -5 to +5 volt range (see setRange()).
 
Method Summary
 double countsToVolts(char counts)
          Converts a single D/A count value to volts, based on the current range setting.
 USBDevice getParent()
          Gets the parent device that this subsystem is part of.
 int getRange()
          Gets the current voltage range of the D/A outputs.
static java.lang.String getRangeText(int range)
          Gets the textual string for the specified range.
 AO16_AnalogOutputSubsystem setRange(int range)
          Sets the voltage range of the D/A outputs.
 char voltsToCounts(double volts)
          Converts a single voltage value to D/A counts, based on the current range setting.
 AO16_AnalogOutputSubsystem writeVolts(int channel, double volts)
          Writes a voltage value to a D/A channel.
 AO16_AnalogOutputSubsystem writeVolts(OutputVoltagePoint[] points)
          Writes a block of voltage values to one or more D/A channels.
 
Methods inherited from class com.acces.aiousb.AnalogOutputSubsystem
getNumChannels, print, writeCounts, writeCounts
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

RANGE_0_5V

public static final int RANGE_0_5V
Unipolar, 0-5 volt range (see setRange()).

See Also:
Constant Field Values

RANGE_5V

public static final int RANGE_5V
Bipolar, -5 to +5 volt range (see setRange()).

See Also:
Constant Field Values

RANGE_0_10V

public static final int RANGE_0_10V
Unipolar, 0-10 volt range (see setRange()).

See Also:
Constant Field Values

RANGE_10V

public static final int RANGE_10V
Bipolar, -10 to +10 volt range (see setRange()).

See Also:
Constant Field Values

MIN_COUNTS

public static final int MIN_COUNTS
Minimum number of counts D/A can output.

See Also:
Constant Field Values

MAX_COUNTS

public static final int MAX_COUNTS
Maximum number of counts D/A can output.

See Also:
Constant Field Values
Method Detail

getRangeText

public static java.lang.String getRangeText(int range)
Gets the textual string for the specified range.

Parameters:
range - the range for which to obtain the textual string.
Returns:
The textual string for the specified range.
Throws:
java.lang.IllegalArgumentException
See Also:
setRange()

getRange

public int getRange()
Gets the current voltage range of the D/A outputs.

Returns:
Current voltage range.
See Also:
setRange()

setRange

public AO16_AnalogOutputSubsystem setRange(int range)
Sets the voltage range of the D/A outputs.

Parameters:
range - the voltage range to select. May be one of:
RANGE_0_5V
RANGE_5V
RANGE_0_10V
RANGE_10V
Returns:
This subsystem, useful for chaining together multiple operations.
Throws:
java.lang.IllegalArgumentException
OperationFailedException

writeVolts

public AO16_AnalogOutputSubsystem writeVolts(int channel,
                                             double volts)
Writes a voltage value to a D/A channel.

Parameters:
channel - the channel to write to.
volts - the voltage value to output.
Returns:
This subsystem, useful for chaining together multiple operations.

writeVolts

public AO16_AnalogOutputSubsystem writeVolts(OutputVoltagePoint[] points)
Writes a block of voltage values to one or more D/A channels.

Parameters:
points - an array of OutputVoltagePoint points representing channel-voltage pairs.
Returns:
This subsystem, useful for chaining together multiple operations.
Throws:
java.lang.IllegalArgumentException

countsToVolts

public double countsToVolts(char counts)
Converts a single D/A count value to volts, based on the current range setting.

Parameters:
counts - the count value to convert to volts.
Returns:
A voltage value calculated using the current D/A range. The voltage value returned is constrained to the current minimum-maximum voltage range of the D/A. (see setRange()).

voltsToCounts

public char voltsToCounts(double volts)
Converts a single voltage value to D/A counts, based on the current range setting.

Parameters:
volts - the voltage value to convert to counts.
Returns:
A count value calculated using the current D/A range. The count value returned is constrained to the current minimum-maximum count range of the D/A. (see setRange()).

getParent

public USBDevice getParent()
Gets the parent device that this subsystem is part of.

Returns:
The parent device that this subsystem is part of.