com.dalsemi.onewire.container
Interface MissionContainer

All Superinterfaces:
ClockContainer, OneWireSensor
All Known Implementing Classes:
OneWireContainer41

public interface MissionContainer
extends ClockContainer

Interface class for 1-Wire® devices that perform analog measuring operations. This class should be implemented for each A/D type 1-Wire device.

Features

Usage

ADContainer extends OneWireSensor, so the general usage model applies to any ADContainer:

  1. readDevice()
  2. perform operations on the ADContainer
  3. writeDevice(byte[])

Consider this interaction with an ADContainer that reads from all of its A/D channels, then tries to set its high alarm on its first channel (channel 0):


     //adcontainer is a com.dalsemi.onewire.container.ADContainer
     byte[] state = adcontainer.readDevice();
     double[] voltages = new double[adcontainer.getNumberADChannels()];
     for (int i=0; i < adcontainer.getNumberADChannels(); i++)
     {
          adcontainer.doADConvert(i, state);
          voltages[i] = adc.getADVoltage(i, state);
     }
     if (adcontainer.hasADAlarms())
     {
          double highalarm = adcontainer.getADAlarm(0, ADContainer.ALARM_HIGH, state);
          adcontainer.setADAlarm(0, ADContainer.ALARM_HIGH, highalarm + 1.0, state);
          adcontainer.writeDevice(state);
     }

 

Version:
1.00, 20 February 2002
Author:
SH

Field Summary
static int ALARM_HIGH
          Indicates the high alarm.
static int ALARM_LOW
          Indicates the low alarm.
 
Method Summary
 void clearMissionResults()
          Clears the mission results and erases the log memory from this missioning device.
 long getFirstSampleOffset(int channel)
          Returns the amount of time, in milliseconds, before the first sample occurred.
 double getMissionAlarm(int channel, int alarmType)
          Returns the threshold value which will trigger the alarm of the specified type on the specified channel.
 boolean getMissionAlarmEnable(int channel, int alarmType)
          Returns true if the alarm of the specified type has been enabled for the specified channel.
 boolean getMissionChannelEnable(int channel)
          Returns true if the specified mission channel is enabled, indicating that the channel's readings will be recorded in the mission log.
 String getMissionLabel(int channel)
          Returns a default friendly label for each channel supported by this Missioning device.
 double getMissionResolution(int channel)
          Returns the currently selected resolution for the specified channel.
 double[] getMissionResolutions(int channel)
          Returns all available resolutions for the specified mission channel.
 double getMissionSample(int channel, int sampleNum)
          Returns the value of each sample taken by the current mission.
 int getMissionSampleCount(int channel)
          Returns the number of samples taken for the specified channel during the current mission.
 int getMissionSampleCountTotal(int channel)
          Returns the total number of samples taken for the specified channel during the current mission.
 int getMissionSampleRate(int channel)
          Returns the amount of time, in seconds, between samples taken by this missioning device.
 long getMissionSampleTimeStamp(int channel, int sampleNum)
          Returns the time, in milliseconds, that each sample was taken by the current mission.
 long getMissionTimeStamp(int channel)
          Returns the time, in milliseconds, that the mission began.
 int getNumberMissionChannels()
          Gets the number of channels supported by this Missioning device.
 boolean hasMissionAlarmed(int channel, int alarmType)
          Returns true if the specified channel's alarm value of the specified type has been triggered during the mission.
 boolean hasMissionAlarms(int channel)
          Indicates whether or not the specified channel of this missioning device has mission alarm capabilities.
 boolean hasMissionRolloverOccurred()
          Returns true if a mission has rolled over.
 boolean isMissionLoaded()
           
 boolean isMissionRolloverEnabled()
          Returns true if a rollover is enabled.
 boolean isMissionRunning()
          Returns true if a mission is currently running.
 void loadMissionResults()
          Loads the results of the currently running mission.
 void setMissionAlarm(int channel, int alarmType, double threshold)
          Sets the threshold value which will trigger the alarm of the specified type on the specified channel.
 void setMissionAlarmEnable(int channel, int alarmType, boolean enable)
          Enables/disables the alarm of the specified type for the specified channel
 void setMissionChannelEnable(int channel, boolean enable)
          Enables/disables the specified mission channel, indicating whether or not the channel's readings will be recorded in the mission log.
 void setMissionResolution(int channel, double resolution)
          Sets the selected resolution for the specified channel.
 void startNewMission(int sampleRate, int missionStartDelay, boolean rolloverEnabled, boolean syncClock, boolean[] channelEnabled)
          Begins a new mission on this missioning device.
 void stopMission()
          Ends the currently running mission.
 
Methods inherited from interface com.dalsemi.onewire.container.ClockContainer
canDisableClock, getClock, getClockAlarm, getClockResolution, hasClockAlarm, isClockAlarmEnabled, isClockAlarming, isClockRunning, setClock, setClockAlarm, setClockAlarmEnable, setClockRunEnable
 
Methods inherited from interface com.dalsemi.onewire.container.OneWireSensor
readDevice, writeDevice
 

Field Detail

ALARM_HIGH

public static final int ALARM_HIGH
Indicates the high alarm.

ALARM_LOW

public static final int ALARM_LOW
Indicates the low alarm.
Method Detail

startNewMission

public void startNewMission(int sampleRate,
                            int missionStartDelay,
                            boolean rolloverEnabled,
                            boolean syncClock,
                            boolean[] channelEnabled)
                     throws OneWireException,
                            OneWireIOException
Begins a new mission on this missioning device.
Parameters:
sampleRate - indicates the sampling rate, in seconds, that this missioning device should log samples.
missionStartDelay - indicates the amount of time, in seconds, that should pass before the mission begins.
rolloverEnabled - if false, this device will stop recording new samples after the data log is full. Otherwise, it will replace samples starting at the beginning.
syncClock - if true, the real-time clock of this missioning device will be synchronized with the current time according to this java.util.Date.

stopMission

public void stopMission()
                 throws OneWireException,
                        OneWireIOException
Ends the currently running mission.

isMissionRunning

public boolean isMissionRunning()
                         throws OneWireException,
                                OneWireIOException
Returns true if a mission is currently running.
Returns:
true if a mission is currently running.

isMissionRolloverEnabled

public boolean isMissionRolloverEnabled()
                                 throws OneWireException,
                                        OneWireIOException
Returns true if a rollover is enabled.
Returns:
true if a rollover is enabled.

hasMissionRolloverOccurred

public boolean hasMissionRolloverOccurred()
                                   throws OneWireException,
                                          OneWireIOException
Returns true if a mission has rolled over.
Returns:
true if a mission has rolled over.

loadMissionResults

public void loadMissionResults()
                        throws OneWireException,
                               OneWireIOException
Loads the results of the currently running mission. Must be called before all mission result/status methods.

isMissionLoaded

public boolean isMissionLoaded()

clearMissionResults

public void clearMissionResults()
                         throws OneWireException,
                                OneWireIOException
Clears the mission results and erases the log memory from this missioning device.

getNumberMissionChannels

public int getNumberMissionChannels()
                             throws OneWireException,
                                    OneWireIOException
Gets the number of channels supported by this Missioning device. Channel specific methods will use a channel number specified by an integer from [0 to (getNumberOfMissionChannels() - 1)].
Returns:
the number of channels

setMissionChannelEnable

public void setMissionChannelEnable(int channel,
                                    boolean enable)
                             throws OneWireException,
                                    OneWireIOException
Enables/disables the specified mission channel, indicating whether or not the channel's readings will be recorded in the mission log.
Parameters:
channel - the channel to enable/disable
enable - if true, the channel is enabled

getMissionChannelEnable

public boolean getMissionChannelEnable(int channel)
                                throws OneWireException,
                                       OneWireIOException
Returns true if the specified mission channel is enabled, indicating that the channel's readings will be recorded in the mission log.
Parameters:
channel - the channel to enable/disable
enable - if true, the channel is enabled

getMissionLabel

public String getMissionLabel(int channel)
                       throws OneWireException,
                              OneWireIOException
Returns a default friendly label for each channel supported by this Missioning device.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
friendly label for the specified channel

getMissionTimeStamp

public long getMissionTimeStamp(int channel)
                         throws OneWireException,
                                OneWireIOException
Returns the time, in milliseconds, that the mission began.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
time, in milliseconds, that the mission began

getFirstSampleOffset

public long getFirstSampleOffset(int channel)
                          throws OneWireException,
                                 OneWireIOException
Returns the amount of time, in milliseconds, before the first sample occurred. If rollover disabled, or datalog didn't fill up, this will be 0.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
time, in milliseconds, before first sample occurred

getMissionSampleRate

public int getMissionSampleRate(int channel)
                         throws OneWireException,
                                OneWireIOException
Returns the amount of time, in seconds, between samples taken by this missioning device.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
time, in seconds, between sampling

getMissionSampleCount

public int getMissionSampleCount(int channel)
                          throws OneWireException,
                                 OneWireIOException
Returns the number of samples taken for the specified channel during the current mission.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
number of samples taken for the specified channel

getMissionSampleCountTotal

public int getMissionSampleCountTotal(int channel)
                               throws OneWireException,
                                      OneWireIOException
Returns the total number of samples taken for the specified channel during the current mission. This number can be more than the actual sample count if rollover is enabled and the log has been filled.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
number of samples taken for the specified channel

getMissionSample

public double getMissionSample(int channel,
                               int sampleNum)
                        throws OneWireException,
                               OneWireIOException
Returns the value of each sample taken by the current mission.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
sampleNum - the sample number to return, between 0 and (getMissionSampleCount(channel)-1)
Returns:
the value of the specified sample on the specified channel

getMissionSampleTimeStamp

public long getMissionSampleTimeStamp(int channel,
                                      int sampleNum)
                               throws OneWireException,
                                      OneWireIOException
Returns the time, in milliseconds, that each sample was taken by the current mission.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
sampleNum - the sample number to return, between 0 and (getMissionSampleCount(channel)-1)
Returns:
the sample's timestamp, in milliseconds

getMissionResolutions

public double[] getMissionResolutions(int channel)
                               throws OneWireException,
                                      OneWireIOException
Returns all available resolutions for the specified mission channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
all available resolutions for the specified mission channel.

getMissionResolution

public double getMissionResolution(int channel)
                            throws OneWireException,
                                   OneWireIOException
Returns the currently selected resolution for the specified channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
the currently selected resolution for the specified channel.

setMissionResolution

public void setMissionResolution(int channel,
                                 double resolution)
                          throws OneWireException,
                                 OneWireIOException
Sets the selected resolution for the specified channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
resolution - the new resolution for the specified channel.

hasMissionAlarms

public boolean hasMissionAlarms(int channel)
Indicates whether or not the specified channel of this missioning device has mission alarm capabilities.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
Returns:
true if the device has mission alarms for the specified channel.

hasMissionAlarmed

public boolean hasMissionAlarmed(int channel,
                                 int alarmType)
                          throws OneWireException,
                                 OneWireIOException
Returns true if the specified channel's alarm value of the specified type has been triggered during the mission.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
alarmType - valid value: ALARM_HIGH or ALARM_LOW
Returns:
true if the alarm was triggered.

getMissionAlarmEnable

public boolean getMissionAlarmEnable(int channel,
                                     int alarmType)
                              throws OneWireException,
                                     OneWireIOException
Returns true if the alarm of the specified type has been enabled for the specified channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
alarmType - valid value: ALARM_HIGH or ALARM_LOW
Returns:
true if the alarm of the specified type has been enabled for the specified channel.

setMissionAlarmEnable

public void setMissionAlarmEnable(int channel,
                                  int alarmType,
                                  boolean enable)
                           throws OneWireException,
                                  OneWireIOException
Enables/disables the alarm of the specified type for the specified channel
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
alarmType - valid value: ALARM_HIGH or ALARM_LOW
enable - if true, alarm is enabled.

getMissionAlarm

public double getMissionAlarm(int channel,
                              int alarmType)
                       throws OneWireException,
                              OneWireIOException
Returns the threshold value which will trigger the alarm of the specified type on the specified channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
alarmType - valid value: ALARM_HIGH or ALARM_LOW
Returns:
the threshold value which will trigger the alarm

setMissionAlarm

public void setMissionAlarm(int channel,
                            int alarmType,
                            double threshold)
                     throws OneWireException,
                            OneWireIOException
Sets the threshold value which will trigger the alarm of the specified type on the specified channel.
Parameters:
channel - the mission channel, between 0 and (getNumberOfMissionChannels()-1)
alarmType - valid value: ALARM_HIGH or ALARM_LOW
threshold - the threshold value which will trigger the alarm


Copyright © 1999-2003 Dallas Semiconductor. All Rights Reserved.