| Line No. | Rev | Author | Line |
|---|---|---|---|
| 1 | 6 | kaklik | /*! \file ads7828.h \brief TI ADS7828 12-bit 8ch A/D Converter Driver Library. */ |
| 2 | //***************************************************************************** |
||
| 3 | // |
||
| 4 | // File Name : 'ads7828.h' |
||
| 5 | // Title : TI ADS7828 12-bit 8ch A/D Converter Driver Library |
||
| 6 | // Author : Pascal Stang - Copyright (C) 2004 |
||
| 7 | // Created : 2004.02.10 |
||
| 8 | // Revised : 2004.02.19 |
||
| 9 | // Version : 0.1 |
||
| 10 | // Target MCU : Atmel AVR Series |
||
| 11 | // Editor Tabs : 4 |
||
| 12 | // |
||
| 13 | // NOTE: This code is currently below version 1.0, and therefore is considered |
||
| 14 | // to be lacking in some functionality or documentation, or may not be fully |
||
| 15 | // tested. Nonetheless, you can expect most functions to work. |
||
| 16 | // |
||
| 17 | // This code is distributed under the GNU Public License |
||
| 18 | // which can be found at http://www.gnu.org/licenses/gpl.txt |
||
| 19 | // |
||
| 20 | /// \ingroup driver_hw |
||
| 21 | /// \defgroup ads7828 TI ADS7828 I2C A/D Converter Driver (ads7828.c) |
||
| 22 | /// \code #include "ads7828.h" \endcode |
||
| 23 | /// \par Overview |
||
| 24 | /// This library provides high-level functions for accessing the Texas |
||
| 25 | /// Instruments ADS7828 I2C A/D Converter. |
||
| 26 | /// |
||
| 27 | /// The basic specs of the ADS7828 are: |
||
| 28 | /// - 12-bit results |
||
| 29 | /// - 8 input channels |
||
| 30 | /// - up to 50KHz conversion rate |
||
| 31 | /// - External reference or internal 2.5V reference |
||
| 32 | // |
||
| 33 | //***************************************************************************** |
||
| 34 | //@{ |
||
| 35 | |||
| 36 | #ifndef ADS7828_H |
||
| 37 | #define ADS7828_H |
||
| 38 | |||
| 39 | #include "global.h" |
||
| 40 | |||
| 41 | // constants/macros/typdefs |
||
| 42 | #define ADS7828_I2C_ADDR 0x90 ///< Base I2C address of ADS7828 devices |
||
| 43 | |||
| 44 | // command register bit defines |
||
| 45 | #define ADS7828_CMD_PD0 0x04 ///< ADS7828 Power-down bit 0 |
||
| 46 | #define ADS7828_CMD_PD1 0x08 ///< ADS7828 Power-down bit 1 |
||
| 47 | #define ADS7828_CMD_C0 0x10 ///< ADS7828 Channel Select bit 0 |
||
| 48 | #define ADS7828_CMD_C1 0x20 ///< ADS7828 Channel Select bit 1 |
||
| 49 | #define ADS7828_CMD_C2 0x40 ///< ADS7828 Channel Select bit 2 |
||
| 50 | #define ADS7828_CMD_SD 0x80 ///< ADS7828 Single-ended/Differential Select bit |
||
| 51 | |||
| 52 | // single-ended channel order defines |
||
| 53 | #define ADS7828_CMD_CH0 0x00 ///< ADS7828 Convert Channel 0 |
||
| 54 | #define ADS7828_CMD_CH1 0x04 ///< ADS7828 Convert Channel 1 |
||
| 55 | #define ADS7828_CMD_CH2 0x01 ///< ADS7828 Convert Channel 2 |
||
| 56 | #define ADS7828_CMD_CH3 0x05 ///< ADS7828 Convert Channel 3 |
||
| 57 | #define ADS7828_CMD_CH4 0x02 ///< ADS7828 Convert Channel 4 |
||
| 58 | #define ADS7828_CMD_CH5 0x06 ///< ADS7828 Convert Channel 5 |
||
| 59 | #define ADS7828_CMD_CH6 0x03 ///< ADS7828 Convert Channel 6 |
||
| 60 | #define ADS7828_CMD_CH7 0x07 ///< ADS7828 Convert Channel 7 |
||
| 61 | |||
| 62 | // power-down mode defines |
||
| 63 | #define ADS7828_CMD_PDMODE0 0x00 ///< ADS7828 Power-down Mode 0 |
||
| 64 | #define ADS7828_CMD_PDMODE1 0x04 ///< ADS7828 Power-down Mode 1 |
||
| 65 | #define ADS7828_CMD_PDMODE2 0x08 ///< ADS7828 Power-down Mode 2 |
||
| 66 | #define ADS7828_CMD_PDMODE3 0x0C ///< ADS7828 Power-down Mode 3 |
||
| 67 | |||
| 68 | // functions |
||
| 69 | |||
| 70 | //! Initialize the ADS7828 chip. |
||
| 71 | /// Returns: |
||
| 72 | /// TRUE if successful, |
||
| 73 | /// FALSE if unsuccessful (chip not present). |
||
| 74 | u08 ads7828Init(u08 i2cAddr); |
||
| 75 | |||
| 76 | //! Set the voltage reference to use for A/D conversion. |
||
| 77 | /// - ref = 0 => External reference voltage on Ref pin. |
||
| 78 | /// - ref = 1 => Internal 2.5V reference voltage (Ref pin left open). |
||
| 79 | void ads7828SetReference(u08 ref); |
||
| 80 | |||
| 81 | //! Begin single-ended conversion on given logical channel#, and return result. |
||
| 82 | u16 ads7828Convert(u08 i2cAddr, u08 channel); |
||
| 83 | |||
| 84 | //! Begin differential conversion on given channel pair, and return result. |
||
| 85 | u16 ads7828ConvertDiff(u08 i2cAddr, u08 channel); |
||
| 86 | |||
| 87 | //! Begin conversion on given raw channel#, and return result. |
||
| 88 | u16 ads7828ConvertRaw(u08 i2cAddr, u08 channel); |
||
| 89 | |||
| 90 | #endif |
||
| 91 | //@} |
Powered by WebSVN v2.8.3