com.cinterion.io

Class ADC

java.lang.Object

com.cinterion.io.ADC

public class ADC
extends Object

The ADC class provides the ability to get sampled values from the Analogue Digital Converter inputs. Values can either be polled by the midlet or the listener mechanism with an automatic sampling interval from 100 to 30.000 ms. If sampling is enabled the registered listener callbacks will be called with the measured values. These callbacks do not occur faster than every second, instead multiple values are delivered in one callback. Due to heavy system load samples may be discarded!

Example

   ADC adc = new ADC(0,0);              // adc channel 0 with sampling interval of 0, which disables automatic
                                        // sampling so listeners can not be used  

   for (int i=0;i<100;i++)              // take 100 samples, one every five seconds
   {           
       System.out.println("\r\nSample: " + adc.getValue() + " mV");
 
       Thread.sleep(5000*1);    
   }

 

See Also:

ADCListener, DAC

Constructor Summary

Constructors

Constructor and Description
ADC(int channel, int interval) Creates a new instance of the ADC class.

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(ADCListener listener) Registers listeners to receive sample values.
void	clearListener() Removes all listener objects which have been previously added to the list table of listener objects.
int	getChannel() Gets the channel.
int	getInterval() Gets the current interval.
int	getValue() Gets a single sample value.
void	release() Stops and removes the listeners and releases all HW resources.
void	removeListener(ADCListener listener) Removes a listener object which has been previously added to the internal list table of listener objects.

Methods inherited from class java.lang.Object

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

Constructor Detail

ADC

public ADC(int channel,
   int interval)
    throws IOException

Creates a new instance of the ADC class.

Parameters:

channel - Selects the adc input channel. Valid values are 0 or 1.

interval - Sampling interval in ms with a resolution of 60/13 ms. Valid values are from 100 to 30.000 or 0 for no sampling.

Throws:

IOException - if an error occurs

See Also:

ADCListener

Method Detail

getValue

public int getValue()
             throws IOException

Gets a single sample value.

Returns:

The measured voltage in mV. Range is -25 to 2425.

Throws:

IOException - if an error occurs

getInterval

public int getInterval()

Gets the current interval.

getChannel

public int getChannel()

Gets the channel.

addListener

public void addListener(ADCListener listener)

Registers listeners to receive sample values. The listener object is an implementation of ADCListener interface. Listeners are stored into an internal HashTable.

Parameters:

listener - The ADCListener object to be registered.

See Also:

ADCListener, removeListener(com.cinterion.io.ADCListener)

removeListener

public void removeListener(ADCListener listener)

Removes a listener object which has been previously added to the internal list table of listener objects. After it has been removed from the list it won't be called in case of new sampled values any more. If it hasn't been registered before the list will remain unchanged.

Parameters:

listener - The ADCListener object to be removed from the list.

See Also:

ADCListener, addListener(com.cinterion.io.ADCListener)

clearListener

public void clearListener()

Removes all listener objects which have been previously added to the list table of listener objects.

See Also:

ADCListener, addListener(com.cinterion.io.ADCListener)

release

public void release()
             throws IOException

Stops and removes the listeners and releases all HW resources.

Throws:

IOException - if an error occurs

See Also:

ADC