ads7828.h

Go to the documentation of this file.

/*! \file ads7828.h \brief TI ADS7828 12-bit 8ch A/D Converter Driver Library. */
//*****************************************************************************
//
// File Name    : 'ads7828.h'
// Title        : TI ADS7828 12-bit 8ch A/D Converter Driver Library
// Author       : Pascal Stang - Copyright (C) 2004
// Created      : 2004.02.10
// Revised      : 2004.02.19
// Version      : 0.1
// Target MCU   : Atmel AVR Series
// Editor Tabs  : 4
//
// NOTE: This code is currently below version 1.0, and therefore is considered
// to be lacking in some functionality or documentation, or may not be fully
// tested.  Nonetheless, you can expect most functions to work.
//
// This code is distributed under the GNU Public License
//      which can be found at http://www.gnu.org/licenses/gpl.txt
//
/// \ingroup driver_hw
/// \defgroup ads7828 TI ADS7828 I2C A/D Converter Driver (ads7828.c)
/// \code #include "ads7828.h" \endcode
/// \par Overview
///     This library provides high-level functions for accessing the Texas
///     Instruments ADS7828 I2C A/D Converter.
///
///     The basic specs of the ADS7828 are:
///     - 12-bit results
///     - 8 input channels
///     - up to 50KHz conversion rate
///     - External reference or internal 2.5V reference
//
//*****************************************************************************
//@{

#ifndef ADS7828_H
#define ADS7828_H

#include "global.h"

// constants/macros/typdefs
#define ADS7828_I2C_ADDR    0x90    ///< Base I2C address of ADS7828 devices

// command register bit defines
#define ADS7828_CMD_PD0     0x04    ///< ADS7828 Power-down bit 0
#define ADS7828_CMD_PD1     0x08    ///< ADS7828 Power-down bit 1
#define ADS7828_CMD_C0      0x10    ///< ADS7828 Channel Select bit 0
#define ADS7828_CMD_C1      0x20    ///< ADS7828 Channel Select bit 1
#define ADS7828_CMD_C2      0x40    ///< ADS7828 Channel Select bit 2
#define ADS7828_CMD_SD      0x80    ///< ADS7828 Single-ended/Differential Select bit

// single-ended channel order defines
#define ADS7828_CMD_CH0     0x00    ///< ADS7828 Convert Channel 0
#define ADS7828_CMD_CH1     0x04    ///< ADS7828 Convert Channel 1
#define ADS7828_CMD_CH2     0x01    ///< ADS7828 Convert Channel 2
#define ADS7828_CMD_CH3     0x05    ///< ADS7828 Convert Channel 3
#define ADS7828_CMD_CH4     0x02    ///< ADS7828 Convert Channel 4
#define ADS7828_CMD_CH5     0x06    ///< ADS7828 Convert Channel 5
#define ADS7828_CMD_CH6     0x03    ///< ADS7828 Convert Channel 6
#define ADS7828_CMD_CH7     0x07    ///< ADS7828 Convert Channel 7

// power-down mode defines
#define ADS7828_CMD_PDMODE0 0x00    ///< ADS7828 Power-down Mode 0
#define ADS7828_CMD_PDMODE1 0x04    ///< ADS7828 Power-down Mode 1
#define ADS7828_CMD_PDMODE2 0x08    ///< ADS7828 Power-down Mode 2
#define ADS7828_CMD_PDMODE3 0x0C    ///< ADS7828 Power-down Mode 3

// functions

//! Initialize the ADS7828 chip.
/// Returns:
/// TRUE if successful, 
/// FALSE if unsuccessful (chip not present).
u08 ads7828Init(u08 i2cAddr);

//! Set the voltage reference to use for A/D conversion.
/// - ref = 0  =>  External reference voltage on Ref pin.
/// - ref = 1  =>  Internal 2.5V reference voltage (Ref pin left open).
void ads7828SetReference(u08 ref);

//! Begin single-ended conversion on given logical channel#, and return result.
u16 ads7828Convert(u08 i2cAddr, u08 channel);

//! Begin differential conversion on given channel pair, and return result.
u16 ads7828ConvertDiff(u08 i2cAddr, u08 channel);

//! Begin conversion on given raw channel#, and return result.
u16 ads7828ConvertRaw(u08 i2cAddr, u08 channel);

#endif
//@}

---