nz_analog.h

Go to the documentation of this file.

#ifndef NZ_ANALOG_H
#define NZ_ANALOG_H

#if defined(HAS_NZ_ADC)

#define CONVERT_MV_TO_10BIT_ADC_VALUE(mv) ((WORD) ( (((float)mv)/((float)ADC_REF_MV)) * 1023.0) )

//Number of filter stages for each ADC channel. Must be 2, 4 or 8. For each ADC channel, this many
//words are needed. Total required memory is ADC_MAX_CHAN x ADC_FILTERS words.
#ifndef ADC_FILTER_STAGES
#define    ADC_FILTER_STAGES  4
#endif

//ADC Interrupt priority, a value from 0 to 7. 0 will disable interrupt, 7 is highest priority.
#ifndef nzINT_PRIORITY_ADC1
#define    nzINT_PRIORITY_ADC1 4
#endif

#ifndef ADC_MAX_CHAN
#define ADC_MAX_CHAN ADC_MAX_CHAN_BRD
#endif

//The channel mask indicates what AN channels can be used for ADC inputs
#ifndef ADC_CHANNEL_MASK_LOW
#define ADC_CHANNEL_MASK_LOW   ADC_CHANNEL_MASK_LOW_BRD
#endif

//The channel mask indicates what AN channels can be used for ADC inputs
#ifndef ADC_CHANNEL_MASK_HIGH
#define ADC_CHANNEL_MASK_HIGH  ADC_CHANNEL_MASK_HIGH_BRD
#endif


typedef struct __attribute__((aligned(2), packed)) 
{
    BYTE        count;                      //Number of ADC channels
    BYTE        currentFilter;              //Value from 0 to (ADC_FILTER_STAGES - 1)

    union {
        struct
        {
            unsigned int bDataValid : 1;   //If set, getVarCmd() returned all requested data
            unsigned int bFill : 15;       //Fill to ensure flags take up a 16-bit WORD
        } flags;
        WORD flagsVal;
    };

    //Bits indicating enabled ADC channels. Each bit represents an ADC channel, ex: bit 0=AN0, 1=AN1, 15=AN15....
    //If ADC_CHANNEL_MASK_HIGH == 0, upper word is not used!
    // - Is initialized with ADC_CHANNEL_MASK_LOW, giving all possible ADC channels
    // - Then, in adcOpen() is masked with used channels. After adcOpen() contains only opened channels.
    DWORD_VAL    channels;

    //WORD        adcValues[ADC_MAX_CHAN];      //Filtered ADC values

    //Array of ADC filters. For each channel, ADC_FILTER_STAGES WORDs are reserved. Only used channels require
    //reserved adcFilter positions
    WORD        adcFilter[ADC_FILTER_STAGES][ADC_MAX_CHAN];

    WORD        conversionCount;                //Free running counter, get's incremented with each ISR
} ADC_INFO;


//This is used by others
#ifndef THIS_IS_NZ_ANALOG_C
extern ADC_INFO adcInfo;
#endif


void adcOpenExtra(DWORD adcChannels, BYTE conversionClock, BYTE sampleTime);


#define adcOpen(adcChannels) adcOpenExtra(adcChannels, 64, 31)



#define adcStart() {_AD1IF = 0; _ASAM = 1;}


void adcStop(void);


WORD adcReadChanForIndex(BYTE index);


#define adcReadChan8BitForIndex(index) ((BYTE)(adcReadChanForIndex(index)>>2))


WORD adcReadChan(BYTE ch);


#define adcReadChan8Bit(ch) ((BYTE)(adcReadChan(ch)>>2))


WORD adcReadChanMvForIndex(BYTE ch);


WORD adcReadChanMv(BYTE ch);


WORD adcConvertChan(BYTE ch, BYTE times);


WORD adcConvertChanForIndex(BYTE index, BYTE times);


WORD adcConvertChanMv(BYTE ch, BYTE times);


WORD adcConvertChanMvForIndex(BYTE index, BYTE times);


#define adcIntEnable()  (_AD1IE = 1)


#define adcIntDisable()  (_AD1IE = 0)

#define adcGetConversionCount() (adcInfo.conversionCount)

#define adcGetFilterStages() (ADC_FILTER_STAGES)

#endif  //#if defined(HAS_NZ_ADC)
#endif  //#ifndef NZ_ANALOG_H