GD32F103学习笔记（8）——ADC接口使用

一、简介

ADC(Analog-to-Digital Converter)，即模拟-数字转换器，可以将连续变化的模拟信号转换为离散的数字信号，进而使用数字电路进行处理，称之为数字信号处理。

GD32F103 系列有 3 个 ADC，精度为 12 位，每个 ADC 最多有 18 个多路复用通道，可以转换来自 16个外部通道和 2 个内部通道的模拟信号。模拟看门狗允许应用程序来检测输入电压是否超出用户设定的高低阈值。各种通道的 A/D 转换可以配置成单次、连续、扫描或间断转换模式。ADC 转换的结果可以按照左对齐或右对齐的方式存储在 16 位数据寄存器中。

二、API说明

以下 ADC 接口位于 GD32F10x_Firmware_Library_V2.2.2\Firmware\GD32F10x_standard_peripheral\Include\gd32f10x_adc.h。

2.1 adc_mode_config

功能	配置ADC同步模式
函数定义	void adc_mode_config(uint32_t mode)
参数	mode：ADC运行模式
返回	无

mode：ADC运行模式，详细列表如下：

值	含义
ADC_MODE_FREE	所有ADC运行于独立模式
ADC_DAUL_REGULAL_PARALLEL_INSERTED_PARALLEL	ADC0和ADC1运行在规则并行+注入并行组合模式
ADC_DAUL_REGULAL_PARALLEL_INSERTED_ROTATION	ADC0和ADC1运行在规则并行+交替触发组合模式
ADC_DAUL_INSERTED_PARALLEL_REGULAL_FOLLOWUP_FAST	ADC0和ADC1运行在注入并行+快速交叉组合模式
ADC_DAUL_INSERTED_PARALLEL_REGULAL_FOLLOWUP_SLOW	ADC0和ADC1运行在注入并行+慢速交叉组合模式
ADC_DAUL_INSERTED_PARALLEL	ADC0和ADC1运行在注入并行模式
ADC_DAUL_REGULAL_PARALLEL	ADC0和ADC1运行在规则并行模式
ADC_DAUL_REGULAL_FOLLOWUP_FAST	ADC0和ADC1运行在快速交叉模式
ADC_DAUL_REGULAL_FOLLOWUP_SLOW	ADC0和ADC1运行在慢速交叉模式
ADC_DAUL_INSERTED_TRIGGER_ROTATION	ADC0和ADC1运行在交替触发模式

2.2 adc_special_function_config

功能	使能或除能ADC特殊功能
函数定义	void adc_special_function_config(uint32_t adc_periph, uint32_t function, ControlStatus newvalue)
参数	adc_periph：ADCx(x=0,1,2) function：功能配置 newvalue：功能使能ENABLE/除能DISABLE
返回	无

function：功能配置，详细列表如下：

值	含义
ADC_SCAN_MODE	扫描模式选择
ADC_INSERTED_CHANNEL_AUTO	注入组自动转换
ADC_CONTINUOUS_MODE	连续模式选择

2.3 adc_data_alignment_config

功能	配置ADCx数据对齐方式
函数定义	void adc_data_alignment_config(uint32_t adc_periph, uint32_t data_alignment)
参数	adc_periph：ADCx(x=0,1,2) data_alignment：数据对齐方式选择
返回	无

data_alignment：数据对齐方式选择，详细列表如下：

值	含义
ADC_DATAALIGN_RIGHT	LSB对齐
ADC_DATAALIGN_LEFT	MSB对齐

2.4 adc_channel_length_config

功能	配置规则通道组或注入通道组的长度
函数定义	void adc_channel_length_config(uint32_t adc_periph, uint8_t adc_channel_group, uint32_t length)
参数	adc_periph：ADCx(x=0,1,2) adc_channel_group：通道组选择 length：通道长度，规则通道组为1-16，注入通道组为1-4
返回	无

adc_channel_group：通道组选择，详细列表如下：

值	含义
ADC_REGULAR_CHANNEL	规则通道组
ADC_INSERTED_CHANNE	注入通道组

2.5 adc_external_trigger_source_config

功能	配置ADC外部触发源
函数定义	void adc_external_trigger_source_config(uint32_t adc_periph, uint8_t adc_channel_group, uint32_t external_trigger_source)
参数	adc_periph：ADCx(x=0,1,2) adc_channel_group：通道组选择 external_trigger_source：规则通道组或注入通道组触发源
返回	无

external_trigger_source：规则通道组或注入通道组触发源，详细列表如下：

值	含义
ADC0_1_EXTTRIG_REGULAR_T0_CH0	TIMER0 CH0事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T0_CH1	TIMER0 CH1事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T0_CH2	TIMER0 CH2事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T1_CH1	TIMER1 CH1事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T2_TRGO	TIMER2 TRGO事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T3_CH3	TIMER3 CH3事件（规则组）
ADC0_1_EXTTRIG_REGULAR_T7_TRGO	TIMER7 TRGO事件（规则组）
ADC0_1_EXTTRIG_REGULAR_EXTI_11	外部中断线11（规则组）
ADC0_1_2_EXTTRIG_REGULAR_NONE	软件触发（规则组）
ADC2_EXTTRIG_REGULAR_T2_CH0	TIMER2 CH0事件（规则组）
ADC2_EXTTRIG_REGULAR_T1_CH2	TIMER1 CH2事件（规则组）
ADC2_EXTTRIG_REGULAR_T0_CH2	TIMER0 CH2事件（规则组）
ADC2_EXTTRIG_REGULAR_T7_CH0	TIMER7 CH0事件（规则组）
ADC2_EXTTRIG_REGULAR_T7_TRGO	TIMER7 TRGO事件（规则组）
ADC2_EXTTRIG_REGULAR_T4_CH0	TIMER4 CH0事件（规则组）
ADC2_EXTTRIG_REGULAR_T4_CH2	TIMER4 CH2事件（规则组）
ADC0_1_EXTTRIG_INSERTED_T0_TRGO	TIMER0 TRGO事件（注入组）
ADC0_1_EXTTRIG_INSERTED_T0_CH3	TIMER0 CH3事件（注入组）
ADC0_1_EXTTRIG_INSERTED_T1_TRGO	TIMER1 TRGO事件（注入组）
ADC0_1_EXTTRIG_INSERTED_T1_CH0	TIMER1 CH0事件（注入组）
ADC0_1_EXTTRIG_INSERTED_T2_CH3	TIMER2 CH3事件（注入组）
ADC0_1_EXTTRIG_INSERTED_T3_TRGO	TIMER3 TRGO事件（注入组）
ADC0_1_EXTTRIG_INSERTED_EXTI_15	外部中断线15（注入组）
ADC0_1_EXTTRIG_INSERTED_T7_CH3	TIMER7 CH3事件（注入组）
ADC0_1_2_EXTTRIG_INSERTED_NONE	软件触发（注入组）
ADC2_EXTTRIG_INSERTED_T0_TRGO	TIMER0 TRGO事件（注入组）
ADC2_EXTTRIG_INSERTED_T0_CH3	TIMER0 CH3事件（注入组）
ADC2_EXTTRIG_INSERTED_T3_CH2	TIMER3 CH2事件（注入组）
ADC2_EXTTRIG_INSERTED_T7_CH1	TIMER7 CH1事件（注入组）
ADC2_EXTTRIG_INSERTED_T7_CH3	TIMER7 CH3事件（注入组）
ADC2_EXTTRIG_INSERTED_T4_TRGO	TIMER4 TRGO事件（注入组）
ADC2_EXTTRIG_INSERTED_T4_CH3	TIMER4 CH3事件（注入组）

2.6 adc_external_trigger_config

功能	配置ADC外部触发
函数定义	void adc_external_trigger_config(uint32_t adc_periph, uint8_t adc_channel_group, ControlStatus newvalue)
参数	adc_periph：ADCx(x=0,1,2) adc_channel_group：通道组选择 newvalue：通道使能ENABLE/禁能DISABLE
返回	无

2.7 adc_enable

功能	使能ADCx外设
函数定义	void adc_enable(uint32_t adc_periph)
参数	adc_periph：ADCx(x=0,1,2)
返回	无

2.8 adc_calibration_enable

功能	ADCx校准复位
函数定义	void adc_calibration_enable(uint32_t adc_periph)
参数	adc_periph：ADCx(x=0,1,2)
返回	无

2.9 adc_regular_channel_config

功能	配置ADC规则通道组
函数定义	void adc_regular_channel_config(uint32_t adc_periph, uint8_t rank, uint8_t adc_channel, uint32_t sample_time)
参数	adc_periph：ADCx(x=0,1,2) rank：规则组通道序列，取值范围为0~15 adc_channel：ADC通道x(x=0…17)(只有ADC0，可取值x=16和17) sample_time：采样时间
返回	无

sample_time：采样时间，详细列表如下：

值	含义
ADC_SAMPLETIME_1POINT5	1.5周期
ADC_SAMPLETIME_7POINT5	7.5周期
ADC_SAMPLETIME_13POINT5	13.5周期
ADC_SAMPLETIME_28POINT5	28.5周期
ADC_SAMPLETIME_41POINT5	41.5周期
ADC_SAMPLETIME_55POINT5	55.5周期
ADC_SAMPLETIME_71POINT5	71.5周期
ADC_SAMPLETIME_239POINT5	239.5周期

2.10 adc_software_trigger_enable

功能	ADC软件触发使能
函数定义	void adc_software_trigger_enable(uint32_t adc_periph, uint8_t adc_channel_group)
参数	adc_periph：ADCx(x=0,1,2) channel_group：通道组选择
返回	无

2.11 adc_flag_get

功能	获取ADC标志位
函数定义	FlagStatus adc_flag_get(uint32_t adc_periph, uint32_t adc_flag)
参数	adc_periph：ADCx(x=0,1,2) adc_flag：ADC标志位
返回	SET或RESET

adc_flag：ADC标志位，详细列表如下：

值	含义
ADC_FLAG_WDE	模拟看门狗事件标志位
ADC_FLAG_EOC	组转换结束标志位
ADC_FLAG_EOIC	注入通道组转换结束标志位
ADC_FLAG_STIC	注入通道组转换开始标志位
ADC_FLAG_STRC	规则通道组转换开始标志位

2.12 adc_flag_clear

功能	清除ADC标志位
函数定义	void adc_flag_clear(uint32_t adc_periph, uint32_t adc_flag)
参数	adc_periph：ADCx(x=0,1,2) adc_flag：ADC标志位
返回	无

2.13 adc_regular_data_read

功能	读ADC规则组数据寄存器
函数定义	uint16_t adc_regular_data_read(uint32_t adc_periph)
参数	adc_periph：ADCx(x=0,1,2)
返回	ADC转换值（0-0xFFFF）

2.14 adc_interrupt_flag_get

功能	获取ADC中断标志位
函数定义	FlagStatus adc_interrupt_flag_get(uint32_t adc_periph, uint32_t adc_interrupt)
参数	adc_periph：ADCx(x=0,1,2) adc_interrupt：ADC中断标志位
返回	SET或RESET

adc_interrupt：ADC中断标志位，详细列表如下：

值	含义
ADC_INT_WDE	模拟看门狗中断标志位
ADC_INT_EOC	组转换结束中断标志位
ADC_INT_EOIC	注入通道组转换结束中断标志位

2.15 adc_interrupt_flag_clear

功能	清除ADC中断标志位
函数定义	void adc_interrupt_flag_clear(uint32_t adc_periph, uint32_t adc_interrupt)
参数	adc_periph：ADCx(x=0,1,2) adc_interrupt：ADC中断标志位
返回	无

2.16 adc_interrupt_enable

功能	ADC中断使能
函数定义	void adc_interrupt_enable(uint32_t adc_periph, uint32_t adc_interrupt)
参数	adc_periph：ADCx(x=0,1,2) adc_interrupt：ADC中断标志位
返回	无

三、ADC电压采集

3.1 电压输入范围

ADC 输入范围为：$V_{REF-}\le V_{IN}\le V_{REF+}$。由 VREF-、VREF+ 、VDDA 、VSSA、这四个外部引脚决定。

我们在设计原理图的时候一般把 VSSA 和 VREF-接地，把 VREF+和 VDDA 接 3V3，得到 ADC 的输入电压范围为：0~3.3V。

如果我们想让输入的电压范围变宽，去到可以测试负电压或者更高的正电压，我们可以在外部加一个电压调理电路，把需要转换的电压抬升或者降压到 0~3.3V，这样 ADC 就可以测量。

3.2 ADC通道选择

GD32 的 ADC 多达 18 个通道，其中外部的 16 个通道就是框图中的 ADCx_IN0、ADCx_IN1…ADCx_IN5。这 16 个通道对应着不同的 IO 口，具体是哪一个 IO 口可以从手册查询到。其中 ADC0/1/2 还有内部通道：ADC0 的通道 16 连接到了芯片内部的温度传感器，Vrefint 连接到了通道 17。ADC1 的模拟通道 16 和 17 连接到了内部的 VSS。ADC2 的模拟通道 9、14、15、16 和 17 连接到了内部的 VSS。

	ADC0	ADC1	ADC2
通道0	PA0	PA0	PA0
通道1	PA1	PA1	PA1
通道2	PA2	PA2	PA2
通道3	PA3	PA3	PA3
通道4	PA4	PA4	PF6
通道5	PA5	PA5	PF7
通道6	PA6	PA6	PF8
通道7	PA7	PA7	PF9
通道8	PB0	PB0	PF10
通道9	PB1	PB1	连接内部VSS
通道10	PC0	PC0	PC0
通道11	PC1	PC1	PC1
通道12	PC2	PC2	PC2
通道13	PC3	PC3	PC3
通道14	PC4	PC4	连接内部VSS
通道15	PC5	PC5	连接内部VSS
通道16	连接内部温度传感器Vsense	连接内部VSS	连接内部VSS
通道17	连接内部参考电压输入Vrefint	连接内部VSS	连接内部VSS

3.3 编程要点

1. 初始 ADC 用到的 GPIO
2. 设置 ADC 的工作参数并初始化
3. 设置 ADC 工作时钟
4. 设置 ADC 转换通道顺序及采样时间
5. 配置使能 ADC 转换完成中断，在中断/轮询内读取转换完数据
6. 使能 ADC
7. 使能软件触发 ADC 转换

ADC 转换结果数据使用中断/轮询方式读取，这里没有使用 DMA 进行数据传输。

3.4 ADC初始化

使用到 GPIO 时候都必须开启对应的 GPIO 时钟，GPIO 用于 AD 转换功能必须配置为模拟输入模式。

ADC 工作参数具体配置为：独立模式、单通道采集不需要扫描、启动连续转换、使用内部软件触发无需外部触发事件、使用右对齐数据格式、转换通道为 1。

rcu_adc_clock_config() 函数用来配置 ADC 的工作时钟，接收一个参数，设置的是 PCLK2 的分频系数，ADC 的时钟最大不能超过 14M。

adc_enable() 函数控制 ADC 转换启动。最后，进行 ADC 校准。

/*------------------时钟配置------------------*/
// GPIO时钟使能
rcu_periph_clock_enable(RCU_GPIOC);
// ADC时钟使能
rcu_periph_clock_enable(RCU_ADC1);
// ADC时钟8分频，最大14MHz
rcu_adc_clock_config(RCU_CKADC_CKAPB2_DIV8);
    
/*------------------ADC GPIO配置------------------*/
// 必须为模拟输入
gpio_init(GPIOC, GPIO_MODE_AIN, GPIO_OSPEED_50MHZ, GPIO_PIN_3);
    
/*------------------ADC工作模式配置------------------*/
// 只使用一个ADC,属于独立模式
adc_mode_config(ADC_MODE_FREE);
// 多通道用扫描模式
//    adc_special_function_config(ADC1, ADC_SCAN_MODE, ENABLE);
// 单通道用连续转换模式
adc_special_function_config(ADC1, ADC_CONTINUOUS_MODE, ENABLE);
    
// 结果转换右对齐
adc_data_alignment_config(ADC1, ADC_DATAALIGN_RIGHT);
// 转换通道1个
adc_channel_length_config(ADC1, ADC_REGULAR_CHANNEL, 1);
    
// 不用外部触发转换，软件开启即可
adc_external_trigger_source_config(ADC1, ADC_REGULAR_CHANNEL, ADC0_1_2_EXTTRIG_REGULAR_NONE);
adc_external_trigger_config(ADC1, ADC_REGULAR_CHANNEL, ENABLE);
    
// 使能ADC
adc_enable(ADC1);
delay_1ms(1);                                                   // 等待1ms
// 使能ADC校准
adc_calibration_enable(ADC1);

3.5 获取ADC转化值

adc_regular_channel_config() 函数用来绑定 ADC 通道的转换顺序和时间。它接收 4 个形参，第一个形参选择 ADC 外设，可为 ADC0、ADC1 或 ADC2；第二个形参为通道的转换顺序，可选为 1 到 16；第三个形参通道选择，总共可选 18 个通道；第四个形参为采样周期选择，采样周期越短，ADC 转换数据输出周期就越短但数据精度也越低，采样周期越长，ADC 转换数据输出周期就越长同时数据精度越高。

调用 adc_software_trigger_enable() 函数进行软件触发 ADC 开始转换。

adc_regular_data_read() 函数是获取 ADC 转换结果值的库函数，只有一个形参为 ADC 外设，可选为 ADC0、ADC1 或 ADC2，该函数还返回一个 16 位的 ADC 转换结果值。

uint16_t adcValue = 0;
    
// 配置ADC通道转换顺序，采样时间为55.5个时钟周期
adc_regular_channel_config(ADC1, 0, ADC_CHANNEL_13, ADC_SAMPLETIME_55POINT5);
// 由于没有采用外部触发，所以使用软件触发ADC转换
adc_software_trigger_enable(ADC1, ADC_REGULAR_CHANNEL);   
    
while(!adc_flag_get(ADC1, ADC_FLAG_EOC));                       // 等待采样完成
adc_flag_clear(ADC1, ADC_FLAG_EOC);                             // 清除结束标志
    
adcValue = adc_regular_data_read(ADC1);                         // 读取ADC数据

3.6 ADC中断初始化

利用 ADC 转换完成中断可以非常方便的保证我们读取到的数据是转换完成后的数据而不用担心该数据可能是 ADC 正在转换时“不稳定”的数据。我们使用 adc_interrupt_enable() 函数使能 ADC 转换完成中断，并在中断服务函数中读取转换结果数据。

// 使能ADC中断
nvic_irq_enable(ADC0_1_IRQn, 0, 0);
// 清除ADC规则组转换结束中断标志
adc_interrupt_flag_clear(ADC1, ADC_INT_FLAG_EOC);
// 使能ADC规则组转换结束中断
adc_interrupt_enable(ADC1, ADC_INT_EOC);

3.7 ADC中断处理函数

我们使能了 ADC 转换完成中断，在 ADC 转换完成后就会进入中断服务函数，我们在中断服务函数内直接读取 ADC 转换结果保存在变量(在 main.c 中定义)中。

extern uint16_t adcValue;
/*!
    \brief      this function handles ADC0 and ADC1 interrupt
    \param[in]  none
    \param[out] none
    \retval     none
*/
void ADC0_1_IRQHandler(void)
{
    
    
    adc_interrupt_flag_clear(ADC1, ADC_INT_FLAG_EOC);               // 清除ADC规则组转换结束中断标志
    adcValue = adc_regular_data_read(ADC1);                             // 读取ADC数据
}

ADC 中断处理函数名称要与 ADC外设 相对应，可在 startup_gd32f10x_hd.s 启动文件中查看：

;                   /* external interrupts handler */
                    DCD     WWDGT_IRQHandler                  ; 16:Window Watchdog Timer
                    DCD     LVD_IRQHandler                    ; 17:LVD through EXTI Line detect
                    DCD     TAMPER_IRQHandler                 ; 18:Tamper Interrupt   
                    DCD     RTC_IRQHandler                    ; 19:RTC through EXTI Line
                    DCD     FMC_IRQHandler                    ; 20:FMC
                    DCD     RCU_IRQHandler                    ; 21:RCU
                    DCD     EXTI0_IRQHandler                  ; 22:EXTI Line 0
                    DCD     EXTI1_IRQHandler                  ; 23:EXTI Line 1
                    DCD     EXTI2_IRQHandler                  ; 24:EXTI Line 2
                    DCD     EXTI3_IRQHandler                  ; 25:EXTI Line 3
                    DCD     EXTI4_IRQHandler                  ; 26:EXTI Line 4
                    DCD     DMA0_Channel0_IRQHandler          ; 27:DMA0 Channel 0
                    DCD     DMA0_Channel1_IRQHandler          ; 28:DMA0 Channel 1
                    DCD     DMA0_Channel2_IRQHandler          ; 29:DMA0 Channel 2
                    DCD     DMA0_Channel3_IRQHandler          ; 30:DMA0 Channel 3
                    DCD     DMA0_Channel4_IRQHandler          ; 31:DMA0 Channel 4
                    DCD     DMA0_Channel5_IRQHandler          ; 32:DMA0 Channel 5 
                    DCD     DMA0_Channel6_IRQHandler          ; 33:DMA0 Channel 6
                    DCD     ADC0_1_IRQHandler                 ; 34:ADC0 and ADC1
                    DCD     USBD_HP_CAN0_TX_IRQHandler        ; 35:USBD and CAN0 TX
                    DCD     USBD_LP_CAN0_RX0_IRQHandler       ; 36:USBD and CAN0 RX0
                    DCD     CAN0_RX1_IRQHandler               ; 37:CAN0 RX1
                    DCD     CAN0_EWMC_IRQHandler              ; 38:CAN0 EWMC
                    DCD     EXTI5_9_IRQHandler                ; 39:EXTI Line 5 to EXTI Line 9
                    DCD     TIMER0_BRK_IRQHandler             ; 40:TIMER0 Break
                    DCD     TIMER0_UP_IRQHandler              ; 41:TIMER0 Update
                    DCD     TIMER0_TRG_CMT_IRQHandler         ; 42:TIMER0 Trigger and Commutation
                    DCD     TIMER0_Channel_IRQHandler         ; 43:TIMER0 Channel Capture Compare
                    DCD     TIMER1_IRQHandler                 ; 44:TIMER1
                    DCD     TIMER2_IRQHandler                 ; 45:TIMER2
                    DCD     TIMER3_IRQHandler                 ; 46:TIMER3
                    DCD     I2C0_EV_IRQHandler                ; 47:I2C0 Event
                    DCD     I2C0_ER_IRQHandler                ; 48:I2C0 Error
                    DCD     I2C1_EV_IRQHandler                ; 49:I2C1 Event
                    DCD     I2C1_ER_IRQHandler                ; 50:I2C1 Error
                    DCD     SPI0_IRQHandler                   ; 51:SPI0
                    DCD     SPI1_IRQHandler                   ; 52:SPI1
                    DCD     USART0_IRQHandler                 ; 53:USART0
                    DCD     USART1_IRQHandler                 ; 54:USART1
                    DCD     USART2_IRQHandler                 ; 55:USART2
                    DCD     EXTI10_15_IRQHandler              ; 56:EXTI Line 10 to EXTI Line 15
                    DCD     RTC_Alarm_IRQHandler              ; 57:RTC Alarm through EXTI Line
                    DCD     USBD_WKUP_IRQHandler              ; 58:USBD WakeUp from suspend through EXTI Line
                    DCD     TIMER7_BRK_IRQHandler             ; 59:TIMER7 Break Interrupt
                    DCD     TIMER7_UP_IRQHandler              ; 60:TIMER7 Update Interrupt
                    DCD     TIMER7_TRG_CMT_IRQHandler         ; 61:TIMER7 Trigger and Commutation Interrupt
                    DCD     TIMER7_Channel_IRQHandler         ; 62:TIMER7 Channel Capture Compare 
                    DCD     ADC2_IRQHandler                   ; 63:ADC2
                    DCD     EXMC_IRQHandler                   ; 64:EXMC
                    DCD     SDIO_IRQHandler                   ; 65:SDIO
                    DCD     TIMER4_IRQHandler                 ; 66:TIMER4
                    DCD     SPI2_IRQHandler                   ; 67:SPI2
                    DCD     UART3_IRQHandler                  ; 68:UART3
                    DCD     UART4_IRQHandler                  ; 69:UART4
                    DCD     TIMER5_IRQHandler                 ; 70:TIMER5
                    DCD     TIMER6_IRQHandler                 ; 71:TIMER6
                    DCD     DMA1_Channel0_IRQHandler          ; 72:DMA1 Channel0
                    DCD     DMA1_Channel1_IRQHandler          ; 73:DMA1 Channel1
                    DCD     DMA1_Channel2_IRQHandler          ; 74:DMA1 Channel2
                    DCD     DMA1_Channel3_4_IRQHandler        ; 75:DMA1 Channel3 and Channel4

四、ADC多通道轮询读取

4.1 board_adc.c

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x.h"
#include "systick.h"

#include "board_adc.h"

/*********************************************************************
 * PUBLIC FUNCTIONS
 */
/**
 @brief ADC驱动初始化
 @param 无
 @return 无
*/
void ADC_Init(void)
{
    
    
    /*------------------时钟配置------------------*/
    // GPIO时钟使能
    rcu_periph_clock_enable(RCU_GPIOC);
    // ADC时钟使能
    rcu_periph_clock_enable(RCU_ADC1);
    // ADC时钟8分频，最大14MHz
    rcu_adc_clock_config(RCU_CKADC_CKAPB2_DIV8);
    
    /*------------------ADC GPIO配置------------------*/
    // 必须为模拟输入
    gpio_init(GPIOC, GPIO_MODE_AIN, GPIO_OSPEED_50MHZ, GPIO_PIN_3);
    gpio_init(GPIOC, GPIO_MODE_AIN, GPIO_OSPEED_50MHZ, GPIO_PIN_4);
    
    /*------------------ADC工作模式配置------------------*/
    // 只使用一个ADC,属于独立模式
    adc_mode_config(ADC_MODE_FREE);
    // 多通道用扫描模式
    adc_special_function_config(ADC1, ADC_SCAN_MODE, ENABLE);
    // 单通道用连续转换模式
//    adc_special_function_config(ADC1, ADC_CONTINUOUS_MODE, ENABLE);
    
    // 结果转换右对齐
    adc_data_alignment_config(ADC1, ADC_DATAALIGN_RIGHT);
    // 转换通道1个
    adc_channel_length_config(ADC1, ADC_REGULAR_CHANNEL, 1);
    
    // 不用外部触发转换，软件开启即可
    adc_external_trigger_source_config(ADC1, ADC_REGULAR_CHANNEL, ADC0_1_2_EXTTRIG_REGULAR_NONE);
    adc_external_trigger_config(ADC1, ADC_REGULAR_CHANNEL, ENABLE);
    
    // 使能ADC
    adc_enable(ADC1);
    delay_1ms(1);                                                   // 等待1ms
    // 使能ADC校准
    adc_calibration_enable(ADC1);
}

/**
 @brief ADC读取
 @param channel -[in] ADC通道
 @return ADC采样值
*/
uint16_t ADC_Read(uint8_t channel)
{
    
    
    uint16_t adcValue = 0;
    
    // 配置ADC通道转换顺序，采样时间为55.5个时钟周期
    adc_regular_channel_config(ADC1, 0, channel, ADC_SAMPLETIME_55POINT5);
    // 由于没有采用外部触发，所以使用软件触发ADC转换
    adc_software_trigger_enable(ADC1, ADC_REGULAR_CHANNEL);   
    
    while(!adc_flag_get(ADC1, ADC_FLAG_EOC));                       // 等待采样完成
    adc_flag_clear(ADC1, ADC_FLAG_EOC);                             // 清除结束标志
    
    adcValue = adc_regular_data_read(ADC1);                         // 读取ADC数据
    return adcValue;
}

/****************************************************END OF FILE****************************************************/

4.2 board_adc.h

#ifndef _BOARD_ADC_H_
#define _BOARD_ADC_H_

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x_adc.h"
 
/*********************************************************************
 * DEFINITIONS
 */

/*********************************************************************
 * API FUNCTIONS
 */
void ADC_Init(void);
uint16_t ADC_Read(uint8_t channel);

#endif /* _BOARD_ADC_H_ */

4.3 main.c

#include <stdio.h>
#include "gd32f10x.h"
#include "systick.h"

#include "board_adc.h"
#include "board_usart.h"

static volatile uint16_t s_adcValue = 0;
static volatile uint16_t s_volValue = 0;
static volatile uint16_t s_adcValue2 = 0;
static volatile uint16_t s_volValue2 = 0;

int main(void)
{
    
    
    systick_config();//系统主频108MHZ,采用外部晶振,由两个宏决定(__SYSTEM_CLOCK_108M_PLL_HXTAL与HXTAL_VALUE)
    
    ADC_Init();
    USART_Init();
	
    while(1)
    {
    
    
        s_adcValue = ADC_Read(ADC_CHANNEL_13);  // 读取ADC采样值
        printf("adc1_13: %d ", s_adcValue);
        s_volValue = s_adcValue * 3300 / 4095;  // 转换成电压值
        printf("vol: %d\r\n", s_volValue);
        
        s_adcValue2 = ADC_Read(ADC_CHANNEL_14); // 读取ADC采样值
        printf("adc1_14: %d ", s_adcValue2);
        s_volValue2 = s_adcValue2 * 3300 / 4095; // 转换成电压值
        printf("vol: %d\r\n", s_volValue2);
        delay_1ms(500);
    }
}

串口打印添加查看：GD32F103学习笔记（7）——USART串口使用
查看打印：

4.4 工程代码

百度网盘：https://pan.baidu.com/s/1pMFKeyZDeIZ1ejBfpc-Y0Q?pwd=lp1j 提取码：lp1j

五、ADC单通道中断读取

5.1 board_adc.c

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x.h"
#include "systick.h"

#include "board_adc.h"

/*********************************************************************
 * PUBLIC FUNCTIONS
 */
/**
 @brief ADC驱动初始化
 @param 无
 @return 无
*/
void ADC_Init(void)
{
    
    
    /*------------------时钟配置------------------*/
    // GPIO时钟使能
    rcu_periph_clock_enable(RCU_GPIOA);
    // ADC时钟使能
    rcu_periph_clock_enable(RCU_ADC1);
    // ADC时钟8分频，最大14MHz
    rcu_adc_clock_config(RCU_CKADC_CKAPB2_DIV8);
    
    /*------------------ADC GPIO配置------------------*/
    // 必须为模拟输入
    gpio_init(GPIOA, GPIO_MODE_AIN, GPIO_OSPEED_50MHZ, GPIO_PIN_0);
    
    /*------------------ADC工作模式配置------------------*/
    // 只使用一个ADC,属于独立模式
    adc_mode_config(ADC_MODE_FREE);
    // 多通道用扫描模式
//    adc_special_function_config(ADC1, ADC_SCAN_MODE, ENABLE);
    // 单通道用连续转换模式
    adc_special_function_config(ADC1, ADC_CONTINUOUS_MODE, ENABLE);
    
    // 结果转换右对齐
    adc_data_alignment_config(ADC1, ADC_DATAALIGN_RIGHT);
    // 转换通道1个
    adc_channel_length_config(ADC1, ADC_REGULAR_CHANNEL, 1);
    // 配置ADC通道转换顺序，采样时间为55.5个时钟周期
    adc_regular_channel_config(ADC1, 0, ADC_CHANNEL_0, ADC_SAMPLETIME_55POINT5);
    
    // 不用外部触发转换，软件开启即可
    adc_external_trigger_source_config(ADC1, ADC_REGULAR_CHANNEL, ADC0_1_2_EXTTRIG_REGULAR_NONE);
    adc_external_trigger_config(ADC1, ADC_REGULAR_CHANNEL, ENABLE);
    
    // 使能ADC
    adc_enable(ADC1);
    delay_1ms(1);                                                   // 等待1ms
    // 使能ADC校准
    adc_calibration_enable(ADC1);
    
    // 使能ADC中断
    nvic_irq_enable(ADC0_1_IRQn, 1, 1);
    // 清除ADC规则组转换结束中断标志
    adc_interrupt_flag_clear(ADC1, ADC_INT_FLAG_EOC);
    // 使能ADC规则组转换结束中断
    adc_interrupt_enable(ADC1, ADC_INT_EOC);
    
    // 由于没有采用外部触发，所以使用软件触发ADC转换
    adc_software_trigger_enable(ADC1, ADC_REGULAR_CHANNEL);
}

/**
 @brief ADC读取
 @param 无
 @return ADC采样值
*/
uint16_t ADC_Read(void)
{
    
     
    adc_interrupt_flag_clear(ADC1, ADC_INT_FLAG_EOC);               // 清除ADC规则组转换结束中断标志
    return adc_regular_data_read(ADC1);                             // 读取ADC数据
}

/****************************************************END OF FILE****************************************************/

5.2 board_adc.h

#ifndef _BOARD_ADC_H_
#define _BOARD_ADC_H_

/*********************************************************************
 * INCLUDES
 */
#include "gd32f10x_adc.h"
 
/*********************************************************************
 * DEFINITIONS
 */

/*********************************************************************
 * API FUNCTIONS
 */
void ADC_Init(void);
uint16_t ADC_Read(void);

#endif /* _BOARD_ADC_H_ */

5.3 gd32f10x_it.c

/*!
    \file    gd32f10x_it.c
    \brief   interrupt service routines

    \version 2014-12-26, V1.0.0, firmware for GD32F10x
    \version 2017-06-20, V2.0.0, firmware for GD32F10x
    \version 2018-07-31, V2.1.0, firmware for GD32F10x
    \version 2020-09-30, V2.2.0, firmware for GD32F10x
*/

/*
    Copyright (c) 2020, GigaDevice Semiconductor Inc.

    Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this 
       list of conditions and the following disclaimer.
    2. Redistributions in binary form must reproduce the above copyright notice, 
       this list of conditions and the following disclaimer in the documentation 
       and/or other materials provided with the distribution.
    3. Neither the name of the copyright holder nor the names of its contributors 
       may be used to endorse or promote products derived from this software without 
       specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY 
OF SUCH DAMAGE.
*/
#include "gd32f10x_it.h"
#include "systick.h"

#include "board_adc.h"

/*!
    \brief      this function handles NMI exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void NMI_Handler(void)
{
    
    
}

/*!
    \brief      this function handles HardFault exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void HardFault_Handler(void)
{
    
    
    /* if Hard Fault exception occurs, go to infinite loop */
    while(1){
    
    
    }
}

/*!
    \brief      this function handles MemManage exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void MemManage_Handler(void)
{
    
    
    /* if Memory Manage exception occurs, go to infinite loop */
    while(1){
    
    
    }
}

/*!
    \brief      this function handles BusFault exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void BusFault_Handler(void)
{
    
    
    /* if Bus Fault exception occurs, go to infinite loop */
    while(1){
    
    
    }
}

/*!
    \brief      this function handles UsageFault exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void UsageFault_Handler(void)
{
    
    
    /* if Usage Fault exception occurs, go to infinite loop */
    while(1){
    
    
    }
}

/*!
    \brief      this function handles SVC exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void SVC_Handler(void)
{
    
    
}

/*!
    \brief      this function handles DebugMon exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void DebugMon_Handler(void)
{
    
    
}

/*!
    \brief      this function handles PendSV exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void PendSV_Handler(void)
{
    
    
}

/*!
    \brief      this function handles SysTick exception
    \param[in]  none
    \param[out] none
    \retval     none
*/
void SysTick_Handler(void)
{
    
    
    delay_decrement();
}

/*!
    \brief      this function handles USART RBNE interrupt request and TBE interrupt request
    \param[in]  none
    \param[out] none
    \retval     none
*/
void USART0_IRQHandler(void)
{
    
    
    unsigned char data;
    if(RESET != usart_interrupt_flag_get(USART0, USART_INT_FLAG_RBNE))
    {
    
    
        data = usart_data_receive(USART0);
            
        usart_data_transmit(USART0, (uint8_t)data);
        while(RESET == usart_flag_get(USART0, USART_FLAG_TBE));//发送完成判断
    }
}

extern uint16_t adcValue;
/*!
    \brief      this function handles ADC0 and ADC1 interrupt
    \param[in]  none
    \param[out] none
    \retval     none
*/
void ADC0_1_IRQHandler(void)
{
    
    
    adcValue = ADC_Read();
}

5.4 main.c

#include <stdio.h>
#include "gd32f10x.h"
#include "systick.h"

#include "board_adc.h"
#include "board_usart.h"

volatile uint16_t adcValue = 0;
volatile uint16_t volValue = 0;

int main(void)
{
    
    
    systick_config();//系统主频108MHZ,采用外部晶振,由两个宏决定(__SYSTEM_CLOCK_108M_PLL_HXTAL与HXTAL_VALUE)
    
    ADC_Init();
    USART_Init();
	
    while(1)
    {
    
    
        printf("adc1_0: %d ", adcValue);
        volValue = adcValue * 3300 / 4095;  // 转换成电压值
        printf("vol: %d\r\n", volValue);

        delay_1ms(500);
    }
}

串口打印添加查看：GD32F103学习笔记（7）——USART串口使用
查看打印：

5.5 工程代码

百度网盘：https://pan.baidu.com/s/1pMFKeyZDeIZ1ejBfpc-Y0Q?pwd=lp1j 提取码：lp1j

---

• 由 Leung 写于 2022 年 4 月 20 日

• 参考：15. GD32F103C8T6入门教程-adc单通道轮训采集
　　　　19. GD32F103C8T6入门教程-adc使用教程6-外部中断线11触发adc0