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 COMMEN_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_Prescaler_Config(_adc, _div)                                       \
    ((_adc)->PRESCALER = ((_adc)->PRESCALER & (~ADC_PRESCALER_gm)) | _div)


#define ADC_Referance_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_GAINFAC_gm))) |        \
                      ((uint8_t) _inputMode|_gain)

#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_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_Set(ADC_t * adc);
uint16_t ADC_ResultCh_GetWord(ADC_CH_t * adc_ch, uint8_t offset);
uint8_t ADC_ResultCh_GetLowByte(ADC_CH_t * adc_ch, uint8_t offset);
uint8_t  ADC_ResultCh_GetHighByte(ADC_CH_t * adc_ch);
void ADC_Wait_8MHz(ADC_t * adc);
void ADC_Wait_32MHz(ADC_t * adc);
uint8_t ADC_Offset_Get(ADC_t * adc);

#endif