adc_driver.h

Go to the documentation of this file.

/* This file has been prepared for Doxygen automatic documentation generation.*/
#ifndef ADC_DRIVER_H
#define ADC_DRIVER_H

#include "avr_compiler.h"


#define COMMON_MODE_CYCLES 16


/* Macros */

#define ADC_Enable(_adc) ((_adc)->CTRLA |= ADC_ENABLE_bm)

#define ADC_Disable(_adc) ((_adc)->CTRLA = (_adc)->CTRLA & (~ADC_ENABLE_bm))

#define ADC_Pipeline_Flush(_adc) ((_adc)->CTRLA |= ADC_FLUSH_bm)


#define ADC_ConvMode_and_Resolution_Config(_adc, _signedMode, _resolution)     \
        ((_adc)->CTRLB = ((_adc)->CTRLB & (~(ADC_RESOLUTION_gm|ADC_CONMODE_bm)))|  \
                (_resolution| ( _signedMode? ADC_CONMODE_bm : 0)))

#define ADC_ConvMode_Signed true

#define ADC_ConvMode_Unsigned false


#define ADC_Prescaler_Config(_adc, _div)                                       \
        ((_adc)->PRESCALER = ((_adc)->PRESCALER & (~ADC_PRESCALER_gm)) | _div)


#define ADC_Reference_Config(_adc, _convRef)                                   \
        ((_adc)->REFCTRL = ((_adc)->REFCTRL & ~(ADC_REFSEL_gm)) | _convRef)


#define ADC_SweepChannels_Config(_adc, _sweepChannels)                         \
        ((_adc)->EVCTRL = ((_adc)->EVCTRL & (~ADC_SWEEP_gm)) | _sweepChannels)


#define ADC_Events_Config(_adc, _eventChannels, _eventMode)                    \                                                                           \
        (_adc)->EVCTRL = ((_adc)->EVCTRL & (~(ADC_EVSEL_gm | ADC_EVACT_gm))) | \
                         ((uint8_t) _eventChannels | _eventMode)


#define ADC_Ch_Interrupts_Config(_adc_ch, _interruptMode, _interruptLevel)     \
        (_adc_ch)->INTCTRL = (((_adc_ch)->INTCTRL &                            \
                              (~(ADC_CH_INTMODE_gm | ADC_CH_INTLVL_gm))) |     \
                              ((uint8_t) _interruptMode | _interruptLevel))


#define ADC_Ch_InputMode_and_Gain_Config(_adc_ch, _inputMode, _gain)           \
        (_adc_ch)->CTRL = ((_adc_ch)->CTRL &                                   \
                          (~(ADC_CH_INPUTMODE_gm|ADC_CH_GAIN_gm))) |        \
                          ((uint8_t) _inputMode|_gain)


#define ADC_DRIVER_CH_GAIN_NONE ADC_CH_GAIN_1X_gc


#define ADC_Ch_InputMux_Config(_adc_ch, _posInput, _negInput)                  \
        ((_adc_ch)->MUXCTRL = (uint8_t) _posInput | _negInput)


#define ADC_Ch_Conversion_Complete(_adc_ch)                                    \
        (((_adc_ch)->INTFLAGS & ADC_CH_CHIF_bm) != 0x00)


#define ADC_CompareValue_Set(_adc, _value) ((_adc)->CMP = _value)


#define ADC_FreeRunning_Enable(_adc)  ((_adc)->CTRLB |= ADC_FREERUN_bm)


#define ADC_FreeRunning_Disable(_adc)                                          \
        ((_adc)->CTRLB = (_adc)->CTRLB & (~ADC_FREERUN_bm))



#define ADC_Low_Impedance_Mode(_adc)  ((_adc)->CTRLB |= ADC_IMPMODE_bm)

#define ADC_High_Impedence_Mode(_adc)                                          \
        ((_adc)->CTRLB = (_adc)->CTRLB & (~ADC_IMPMODE_bm))




#define ADC_Ch_Conversion_Start(_adc_ch) ((_adc_ch)->CTRL |= ADC_CH_START_bm)


#define ADC_Conversions_Start(_adc, _channelMask)                         \
        (_adc)->CTRLA |= _channelMask &                                   \
                      (ADC_CH0START_bm | ADC_CH1START_bm |                \
                       ADC_CH2START_bm | ADC_CH3START_bm)


#define ADC_BandgapReference_Enable(_adc) ((_adc)->REFCTRL |= ADC_BANDGAP_bm)


#define ADC_BandgapReference_Disable(_adc) ((_adc)->REFCTRL &= ~ADC_BANDGAP_bm)


#define ADC_TempReference_Enable(_adc) ((_adc)->REFCTRL |= ADC_TEMPREF_bm)


#define ADC_TempReference_Disable(_adc)                                        \
        ((_adc)->REFCTRL = (_adc)->REFCTRL & (~ADC_TEMPREF_bm))


/* Prototype for assembly macro. */
uint8_t SP_ReadCalibrationByte( uint8_t index );

/* Prototypes for functions. */
void ADC_CalibrationValues_Load(ADC_t * adc);

uint16_t ADC_ResultCh_GetWord_Unsigned(ADC_CH_t * adc_ch, uint16_t offset);
int16_t ADC_ResultCh_GetWord_Signed(ADC_CH_t * adc_ch, int16_t offset);

uint16_t ADC_Offset_Get_Unsigned(ADC_t * adc, ADC_CH_t *ch, bool oversampling);
int16_t ADC_Offset_Get_Signed(ADC_t * adc, ADC_CH_t *ch, bool oversampling);

uint16_t ADC_ResultCh_GetWord(ADC_CH_t * adc_ch);
uint8_t ADC_ResultCh_GetLowByte(ADC_CH_t * adc_ch);
uint8_t  ADC_ResultCh_GetHighByte(ADC_CH_t * adc_ch);

void ADC_Wait_8MHz(ADC_t * adc);
void ADC_Wait_32MHz(ADC_t * adc);

#define ADC_Referance_Config(_adc, _convRef) ADC_Reference_Config(_adc, _convRef)
#define ADC_CalibrationValues_Set(_adc) ADC_CalibrationValues_Load(_adc)



#ifndef ADCACAL0_offset

#define ADCACAL0_offset 0x20
#define ADCACAL1_offset 0x21
#define ADCBCAL0_offset 0x24
#define ADCBCAL1_offset 0x25
#endif


#endif