adc.h

#ifndef _AVRIO_ADC_H_
#define _AVRIO_ADC_H_

#include <avrio/defs.h>

__BEGIN_C_DECLS
/* ========================================================================== */
/* constants ================================================================ */
typedef enum {
  eAdcExternal = 0,  
  eAdcVcc = 1,       
  eAdcInternal  = 3, 
  eAdcInternal2 = 2  
} eAdcRef;

typedef enum {
  eAdcRaw = 0,      
  eAdcAverage = 1,  
  eAdcMin = 2,      
  eAdcMax = 4,      
} eAdcFilter;

/* internal public functions ================================================ */
void vAdcInit (void);

void vAdcEnable (void);

void vAdcDisable (void);

uint16_t usAdcRead (uint8_t ucChannel);

uint16_t usAdcReadFilter (uint8_t ucChannel, uint8_t ucTerms, eAdcFilter eFilter);

static inline void vAdcSetChannel (uint8_t ucChan);

void vAdcSetDiv (uint8_t ucDiv);

uint8_t ucAdcGetDiv (void);

// -----------------------------------------------------------------------------
#  if defined(__DOXYGEN__)
/*
 * __DOXYGEN__ defined
 * Partie documentation ne devant pas être compilée.
 * =============================================================================
 */
static inline uint16_t usAdcReadAverage (uint8_t ucChannel, uint8_t ucTerms);

static inline void vAdcSetRef (uint8_t ucRef);

static inline uint8_t eAdcGetRef (void)


/* macros =================================================================== */
#define ADC_VALUE(_MEASUREMENT,_FULL_SCALE)

#define ADC_MEASUREMENT(_VALUE,_FULL_SCALE)

#  else
/*
 * __DOXYGEN__ not defined
 * Partie ne devant pas être documentée.
 * =============================================================================
 */
#include "avrio-config.h"
#ifdef AVRIO_ADC_ENABLE
#include "avrio-board-adc.h"
#endif
#include <avrio/delay.h>

/* inline public functions ================================================== */
#if defined(REFS2) && defined(REFS1) && defined(REFS0)
#define ADCREF_MASK (_BV(REFS2)|_BV(REFS1)|_BV(REFS0))
#elif defined(REFS1) && defined(REFS0)
#define ADCREF_MASK (_BV(REFS1)|_BV(REFS0))
#else
#define ADCREF_MASK (_BV(REFS0))
#endif

#if !defined(ADMUX) && defined(ADMUXB)
#define ADMUX ADMUXB
#endif


/* -----------------------------------------------------------------------------
 * Valeurs courantes:
    00 AREF, Internal V ref turned off
    01 AV CC with external capacitor at AREF pin
    10 Reserved
    11 Internal Voltage Reference with external capacitor at AREF pin
* attiny441/841: ADMUXB & REFS2 defined
    AREF Pin Disconnected
    000 VCC
    001 Internal 1.1V reference 
    010 Internal 2.2V reference 
    011 Internal 4.096V reference

    AREF Pin Connected, with external bypass capacitor connected to pin
    100 AREF pin (internal reference turned off)
    101 Internal 1.1V reference 
    110 Internal 2.2V reference 
    111 Internal 4.096V reference
 */
INLINE void vAdcSetRef (eAdcRef eRef) {

  ADMUX = (ADMUX & ~ADCREF_MASK) | (eRef << REFS0);
  delay_ms (100);
}

INLINE eAdcRef eAdcGetRef (void) {

  return (ADMUX & ADCREF_MASK)  >> REFS0;
}

INLINE uint16_t usAdcReadAverage (uint8_t ucChannel, uint8_t ucTerms) {

  return usAdcReadFilter (ucChannel, ucTerms, eAdcAverage);
}

#if defined(ADC_SCALE_ENABLE)

//void vAdcSetScale (uint8_t ucChannel, uint8_t ucScale);

//uint8_t ucAdcGetScale (uint8_t ucChannel);

//static inline void vAdcSetAutoscale (uint8_t ucChannel);

//static inline void vAdcClearAutoscale (uint8_t ucChannel);

void vAdcSetScale (uint8_t ucChannel, uint8_t ucScale);
uint8_t ucAdcGetScale (uint8_t ucChannel);
uint8_t ucAdcGetScaleMax (uint8_t ucChannel);
#else
INLINE void vAdcSetScale (uint8_t ucChannel, uint8_t ucScale) {

}
INLINE uint8_t ucAdcGetScale (uint8_t ucChannel) {

  return 0;
}
INLINE uint8_t ucAdcGetScaleMax (uint8_t ucChannel) {

  return 0;
}
#endif

#if defined(ADC_AUTOSCALE_ENABLE)
extern uint16_t usAdcAutoScaleFlag;

INLINE void vAdcSetAutoscale (uint8_t ucChannel) {

  usAdcAutoScaleFlag = _BV(ucChannel);
}

INLINE void vAdcClearAutoscale (uint8_t ucChannel) {

  usAdcAutoScaleFlag = 0;
}
#else
INLINE void vAdcSetAutoscale (uint8_t ucChannel) {

}

INLINE void vAdcClearAutoscale (uint8_t ucChannel) {

}
#endif

/* macros =================================================================== */
#define ADC_VALUE(_MEASUREMENT,_FULL_SCALE) \
  ((uint16_t)(((_MEASUREMENT)*1024.0)/(_FULL_SCALE)))

#define ADC_MEASUREMENT(_VALUE,_FULL_SCALE) \
  ((((double)(_VALUE))*((double)(_FULL_SCALE)))/1024.0)
#  endif /* __DOXYGEN__ not defined */

/* ========================================================================== */
__END_C_DECLS
#endif  /* _AVRIO_ADC_H_ not defined */