rt-thread/bsp/synwit/libraries/SWM341_CSL/SWM341_StdPeriph_Driver/SWM341_adc.h

#ifndef __SWM341_ADC_H__
#define __SWM341_ADC_H__

typedef struct {
    uint8_t  clk_src;       //ADC转换时钟源：ADC_CLKSRC_HRC、ADC_CLKSRC_XTAL、...
    uint8_t  samplAvg;      //采样取平均，触发启动ADC转换后，ADC在一个通道上连续采样、转换多次，并将它们的平均值作为该通道转换结果

    uint8_t  EOC_IEn;       //EOC中断使能，     可针对每个序列设置，其有效值为ADC_SEQ0、ADC_SEQ1、ADC_SEQ2、ADC_SEQ3及其组合（即“按位或”运算）
    uint8_t  HalfIEn;       //FIFO半满中断使能，可针对每个序列设置，其有效值为ADC_SEQ0、ADC_SEQ1、ADC_SEQ2、ADC_SEQ3及其组合（即“按位或”运算）
} ADC_InitStructure;

typedef struct {
    uint16_t channels;      //ADC序列转换通道选中，ADC_CH0、ADC_CH1、... ... 、ADC_CH7及其组合（即“按位或”运算）
    uint8_t  trig_src;      //ADC序列触发方式：ADC_TRIGGER_SW、ADC_TRIGGER_TIMER2、ADC_TRIGGER_TIMER3、... ...
    uint16_t conv_cnt;      //ADC序列转换次数，可取值1--256
    uint8_t  samp_tim;      //ADC序列采样时间，可取值ADC_SAMPLE_1CLOCK、ADC_SAMPLE_2CLOCK、ADC_SAMPLE_4CLOCK、ADC_SAMPLE_8CLOCK
} ADC_SEQ_InitStructure;

typedef struct {
    uint16_t UpperLimit;    //比较上限值
    uint16_t UpperLimitIEn; //ADC转换结果大于UpperLimit中断使能
    uint16_t LowerLimit;    //比较下限值
    uint16_t LowerLimitIEn; //ADC转换结果小于LowerLimit中断使能
} ADC_CMP_InitStructure;

#define ADC_CH0     0x001
#define ADC_CH1     0x002
#define ADC_CH2     0x004
#define ADC_CH3     0x008
#define ADC_CH4     0x010
#define ADC_CH5     0x020
#define ADC_CH6     0x040
#define ADC_CH7     0x080
#define ADC_CH8     0x100
#define ADC_CH9     0x200
#define ADC_CH10    0x400
#define ADC_CH11    0x800

#define ADC_SEQ0    0x1
#define ADC_SEQ1    0x2
#define ADC_SEQ2    0x4
#define ADC_SEQ3    0x8

#define ADC_CLKSRC_HRC          ((0 << 2) | 0)
#define ADC_CLKSRC_XTAL         ((0 << 2) | 1)
#define ADC_CLKSRC_PLL          ((0 << 2) | 2)
#define ADC_CLKSRC_HRC_DIV4     ((2 << 2) | 0)
#define ADC_CLKSRC_XTAL_DIV4    ((2 << 2) | 1)
#define ADC_CLKSRC_PLL_DIV4     ((2 << 2) | 2)
#define ADC_CLKSRC_HRC_DIV8     ((3 << 2) | 0)
#define ADC_CLKSRC_XTAL_DIV8    ((3 << 2) | 1)
#define ADC_CLKSRC_PLL_DIV8     ((3 << 2) | 2)

#define ADC_AVG_SAMPLE1         0
#define ADC_AVG_SAMPLE2         1   //一次启动连续采样、转换2次，并计算两次结果的平均值作为转换结果
#define ADC_AVG_SAMPLE4         2
#define ADC_AVG_SAMPLE8         3

#define ADC_TRIGGER_NO          0
#define ADC_TRIGGER_SW          1   //软件启动
#define ADC_TRIGGER_TIMER2      2
#define ADC_TRIGGER_TIMER3      3
#define ADC_TRIGGER_EXTRIG0     4
#define ADC_TRIGGER_EXTRIG1     5
#define ADC_TRIGGER_PWM0        0x10
#define ADC_TRIGGER_PWM1        0x11
#define ADC_TRIGGER_PWM2        0x12
#define ADC_TRIGGER_PWM3        0x13
#define ADC_TRIGGER_PWM4        0x14

#define ADC_SAMPLE_1CLOCK       0
#define ADC_SAMPLE_2CLOCK       1
#define ADC_SAMPLE_4CLOCK       2
#define ADC_SAMPLE_8CLOCK       3
#define ADC_SAMPLE_16CLOCK      4
#define ADC_SAMPLE_32CLOCK      5
#define ADC_SAMPLE_64CLOCK      6
#define ADC_SAMPLE_128CLOCK     7


/* Interrupt Type */
#define ADC_IT_EOC          (1 << 0)    //End Of Conversion
#define ADC_IT_FIFO_OVF     (1 << 1)    //FIFO Overflow
#define ADC_IT_FIFO_HALF    (1 << 2)    //FIFO Half Full
#define ADC_IT_FIFO_FULL    (1 << 3)    //FIFO Full
#define ADC_IT_CMP_MAX      (1 << 4)    //转换结果大于COMP.MAX
#define ADC_IT_CMP_MIN      (1 << 5)    //转换结果小于COMP.MIN


void ADC_Init(ADC_TypeDef * ADCx, ADC_InitStructure * initStruct);      //ADC模数转换器初始化
void ADC_SEQ_Init(ADC_TypeDef * ADCx, uint32_t seq, ADC_SEQ_InitStructure * initStruct);    //ADC序列初始化
void ADC_CMP_Init(ADC_TypeDef * ADCx, uint32_t seq, ADC_CMP_InitStructure * initStruct);    //ADC比较功能初始化
void ADC_Open(ADC_TypeDef * ADCx);                          //ADC开启，可以软件启动、或硬件触发ADC转换
void ADC_Calibrate(ADC_TypeDef * ADCx);                     //ADC校准
void ADC_Close(ADC_TypeDef * ADCx);                         //ADC关闭，无法软件启动、或硬件触发ADC转换
void ADC_Start(ADC_TypeDef * ADCx, uint32_t seq);           //启动指定ADC，开始模数转换
void ADC_Stop(ADC_TypeDef * ADCx, uint32_t seq);            //关闭指定ADC，停止模数转换

uint32_t ADC_Read(ADC_TypeDef * ADCx, uint32_t seq, uint32_t *chn);     //从指定通道读取转换结果
uint32_t ADC_DataAvailable(ADC_TypeDef * ADCx, uint32_t seq);           //指定序列是否有数据可读取


void ADC_INTEn(ADC_TypeDef * ADCx, uint32_t seq, uint32_t it);
void ADC_INTEn(ADC_TypeDef * ADCx, uint32_t seq, uint32_t it);
void ADC_INTClr(ADC_TypeDef * ADCx, uint32_t seq, uint32_t it);
uint32_t ADC_INTStat(ADC_TypeDef * ADCx, uint32_t seq, uint32_t it);


#endif //__SWM341_ADC_H__