当前位置：首页 > news >正文

二十二、GD32F407VET6 ADC驱动光敏电阻模块实战：从时钟配置到数据采集

news 2026/3/27 18:01:35

二十二、GD32F407VET6 ADC驱动光敏电阻模块实战：从时钟配置到数据采集

最近在做一个智能台灯的项目，需要根据环境光线自动调节亮度，这就离不开光敏电阻了。光敏电阻的阻值会随着光照强度变化，我们怎么让单片机“感知”到这个变化呢？答案就是用ADC（模数转换器）把它输出的模拟电压信号转换成数字值。

今天我就以手头的这块天空星GD32F407VET6开发板为例，带你从头到尾走一遍ADC驱动光敏电阻的完整流程。这个过程其实挺有代表性的，学会了它，你就能举一反三，用ADC去读取各种模拟传感器了，比如电位器、温度传感器等等。

咱们的目标很简单：把光敏电阻模块接到板子上，写程序读取它输出的电压值，并通过串口打印出来，看看光线变化时数值怎么变。

1. 硬件连接与模块认识

首先，咱们得把硬件连对。我用的这个光敏电阻模块很小巧，工作电压是3.3V到5V，功耗也很低。

模块上有4个引脚：

VCC：接3.3V或5V电源（咱们开发板一般用3.3V）。
GND：接地。
DO：数字量输出，当光线超过或低于某个阈值时，会输出高或低电平。这个功能咱们这次不用。
AO：模拟量输出，这才是关键！它会输出一个0到VCC之间的电压，光线越强，电压越高（对于这种模块，通常是光线越强，光敏电阻阻值越小，分压后AO电压越高）。

我们要用的就是AO引脚。查一下GD32F407VET6的数据手册，找一个ADC通道引脚。我选择了PC1，它对应着ADC0的第11通道。所以，用杜邦线把模块的AO脚接到开发板的PC1引脚，VCC和GND也对应接好，硬件连接就完成了。

注意：ADC引脚配置有讲究，必须设置为模拟输入模式，如果错误地配置为上拉或下拉，读回来的电压值会不准。

2. ADC配置全流程详解

配置ADC是今天的重头戏，步骤稍微多一点，但别怕，咱们一步步来，每一步我都会说清楚为什么。整个过程可以总结为以下九步，我画了个图帮你理清思路：

1. 配置时钟 --> 2. 配置引脚 --> 3. 配置ADC模式 --> 4. 配置数据对齐 ^ | | v 使能ADC <-- 8. 配置触发方式 <-- 7. 配置采集通道 <-- 6. 配置分辨率 <-- 5. 配置数据对齐 | ^ v | 9. 开启校准 ----------------------------------------------------/

2.1 第一步：配置时钟——给ADC定个合适的工作节奏

单片机内部外设要工作，都得有时钟信号驱动，ADC也不例外。GD32F4的ADC时钟可以来自两个“源头”：高速的AHB总线（168MHz）或者APB2总线（84MHz）。

但是，芯片手册明确说了：ADC模块的最高工作频率不能超过40MHz。所以，我们得选一个源，再通过分频把频率降到40MHz以下。

我习惯用APB2（84MHz）作为时钟源。怎么分频呢？库函数提供了几种选择：2分频、4分频、6分频、8分频等。

如果2分频：84MHz / 2 = 42MHz > 40MHz，不行。
如果4分频：84MHz / 4 = 21MHz < 40MHz，完美。

所以，咱们的时钟配置代码就是：

// 使能ADC0的时钟 rcu_periph_clock_enable(RCU_ADC0); // 配置ADC时钟源为APB2，并做4分频 adc_clock_config(ADC_ADCCK_PCLK2_DIV4);

这一步确保了ADC在安全的频率下运行，是后续所有操作的基础。

2.2 第二步：配置引脚——告诉单片机哪个脚接传感器

刚才说了，我们用PC1（ADC0通道11）。配置一个GPIO引脚无非就是老三样：开时钟、设模式。

// 使能GPIOC的时钟 rcu_periph_clock_enable(RCU_GPIOC); // 将PC1引脚配置为模拟输入模式，无上拉下拉 gpio_mode_set(GPIOC, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO_PIN_1);

这里的关键是GPIO_MODE_ANALOG（模拟模式）。只有在这个模式下，引脚才会直接连接到内部的ADC模块，而不是被数字电路干扰。

为了方便以后修改，我们可以先定义好相关的宏：

/* PC1 ADC0_IN11 */ #define BSP_ADC_GPIO_RCU RCU_GPIOC #define BSP_ADC_GPIO_PORT GPIOC #define BSP_ADC_GPIO_PIN GPIO_PIN_1 #define BSP_ADC_RCU RCU_ADC0 #define BSP_ADC ADC0 #define BSP_ADC_CHANNEL ADC_CHANNEL_11

这样上面的代码就可以用这些宏来写，更清晰，也更容易移植。

2.3 第三步：配置ADC工作模式

GD32的ADC功能挺强，有好几种模式。咱们这个实验比较简单，只用一个通道，所以主要关注两个模式设置：

扫描模式 (Scan Mode)：如果使能，ADC会按照你设定的通道列表，一个接一个地自动转换。哪怕咱们现在只用一个通道，也先把它打开，为以后扩展留个余地。
```
// 使能扫描模式 adc_special_function_config(BSP_ADC, ADC_SCAN_MODE, ENABLE);
```
同步模式 (Sync Mode)：这是针对有多路ADC（比如ADC0, ADC1, ADC2）的高级功能，可以让它们同时采样，提高精度。我们只用一路ADC0，所以选择最常用的独立模式，让它自己干自己的活就行。
```
// 配置ADC为独立模式 adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT);
```

2.4 第四步：配置数据对齐方式

ADC转换完成后，会得到一个12位的数字（因为我们后面会设12位分辨率）。这个数字存放在一个16位的寄存器里。是紧挨着右边放，还是紧挨着左边放？这就是对齐方式。

右对齐：数据放在寄存器的低12位，高4位是0。这是我们最常用的方式，读出来的值就是0-4095（2^12 - 1），非常直观。
左对齐：数据放在寄存器的高12位。有些特殊处理场景可能会用到。

咱们毫无疑问用右对齐：

// 数据右对齐 adc_data_alignment_config(BSP_ADC, ADC_DATAALIGN_RIGHT);

2.5 第五步：配置分辨率

分辨率就是ADC的“精细度”。GD32F407的ADC最高支持12位分辨率，也就是说能把参考电压（比如3.3V）分成 2^12 = 4096 份。每一份对应一个电压值（3.3V / 4095 ≈ 0.0008V）。分辨率越低（比如8位），转换速度越快，但精度也越低。对于光敏电阻，12位精度足够了。

// ADC0设置为12位分辨率 adc_resolution_config(BSP_ADC, ADC_RESOLUTION_12B);

2.6 第六步：配置采集通道

我们需要告诉ADC，要转换的是哪个通道组，以及组里有多少个通道。ADC有“规则组”和“注入组”之分，规则组用于常规按顺序转换，注入组可以“插队”。咱们用规则组，并且只转换1个通道（就是通道11）。

// ADC0规则组通道长度设置为1（即只有1个通道需要转换） adc_channel_length_config(BSP_ADC, ADC_ROUTINE_CHANNEL, 1);

这里只是设置了通道数量，具体是哪个通道，是在每次启动转换前设置的（后面会看到）。

2.7 第七步：使能ADC

配置了一大堆，现在得把ADC的“电源开关”打开，它才能开始准备工作。

// ADC0使能 adc_enable(BSP_ADC);

重要顺序：必须先使能ADC，才能进行下一步的校准操作。

2.8 第八步：配置触发方式——谁来下令开始转换？

ADC转换需要一个“开始”信号，这个信号就叫触发。触发方式有两种：

外部触发：比如用一个定时器定时触发，或者用一个外部引脚的电平变化来触发。适合需要精确、周期性采样的场景。
软件触发：就是我们写一句代码adc_software_trigger_enable()来让它开始转换。适合像咱们这样手动读取一次的场景。

咱们用软件触发：

// 禁用ADC规则通道的外部触发，只用软件触发 adc_external_trigger_config(BSP_ADC, ADC_ROUTINE_CHANNEL, EXTERNAL_TRIGGER_DISABLE); // 注意：使能软件触发的函数我们放在每次启动转换的时候调用，这里不写。

2.9 第九步：开启校准

这是非常关键且容易忽略的一步！ADC内部电路存在微小的误差，校准就是让ADC自己测量一下这个误差，并在后续转换中自动修正，从而得到更准确的结果。校准只需要在ADC初始化时做一次。

// 开启ADC自校准 adc_calibration_enable(BSP_ADC);

这个函数会阻塞一小段时间，等待校准完成。

好了，把上面所有的步骤整合到一个初始化函数里，看起来就是这样：

void bsp_adc_init(void) { // 1. 使能时钟 rcu_periph_clock_enable(BSP_ADC_GPIO_RCU); rcu_periph_clock_enable(BSP_ADC_RCU); adc_clock_config(ADC_ADCCK_PCLK2_DIV4); // 2. 配置引脚 gpio_mode_set(BSP_ADC_GPIO_PORT, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, BSP_ADC_GPIO_PIN); // 3. 配置ADC模式 adc_special_function_config(BSP_ADC, ADC_SCAN_MODE, ENABLE); adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT); // 4. & 5. 配置数据对齐和分辨率 adc_data_alignment_config(BSP_ADC, ADC_DATAALIGN_RIGHT); adc_resolution_config(BSP_ADC, ADC_RESOLUTION_12B); // 6. 配置采集通道数 adc_channel_length_config(BSP_ADC, ADC_ROUTINE_CHANNEL, 1); // 7. 使能ADC adc_enable(BSP_ADC); // 8. 配置触发方式（禁用外部触发） adc_external_trigger_config(BSP_ADC, ADC_ROUTINE_CHANNEL, EXTERNAL_TRIGGER_DISABLE); // 9. 校准ADC adc_calibration_enable(BSP_ADC); }

这个bsp_adc_init()函数就是咱们ADC驱动的核心，在主程序开始时调用一次就行了。

3. 编写数据采集函数

初始化完成后，ADC就处于待命状态了。我们需要写一个函数，在需要的时候去读取光敏电阻的电压值。这个函数要完成三件事：1. 指定转换哪个通道；2. 下令开始转换；3. 等待转换完成并读取结果。

/** * @brief 读取指定ADC通道的转换值 * @param ADC_CHANNEL_x: 要采集的ADC通道，例如 ADC_CHANNEL_11 * @retval 12位ADC转换值，范围0-4095 */ unsigned int Get_ADC_Value(uint8_t ADC_CHANNEL_x) { unsigned int adc_value = 0; // 1. 设置本次要转换的规则组通道（第0个顺序，通道号，采样时间） adc_routine_channel_config(BSP_ADC, 0, ADC_CHANNEL_x, ADC_SAMPLETIME_15); // 2. 软件触发，启动一次转换 adc_software_trigger_enable(BSP_ADC, ADC_ROUTINE_CHANNEL); // 3. 等待转换结束标志位EOC置位 while( adc_flag_get(BSP_ADC, ADC_FLAG_EOC) == RESET ) { // 空循环等待，实际项目中可以加超时判断 } // 4. 读取ADC数据寄存器中的值 adc_value = adc_routine_data_read(BSP_ADC); return adc_value; }

这里有个参数ADC_SAMPLETIME_15是采样时间，可以简单理解为ADC“测量”引脚电压的持续时间。时间越长，采样越稳定，抗干扰越好，但转换速度越慢。对于光敏电阻这种变化不快的信号，15个周期足够了。

4. 主程序与实验现象

最后，我们在主函数里把上面这些模块串起来。假设你已经初始化好了系统时钟和串口（用于打印数据）。

#include "gd32f4xx.h" #include "bsp_adc.h" // 假设上面两个函数写在这个头文件里 #include "bsp_uart.h" // 串口初始化函数 #include <stdio.h> // 用于printf int main(void) { // 系统时钟、延时等初始化 board_init(); // 串口初始化，用于打印数据 bsp_uart_init(); uint16_t adc_raw_value = 0; float voltage = 0.0f; // ADC初始化 bsp_adc_init(); while(1) { // 1. 读取ADC原始值 (0-4095) adc_raw_value = Get_ADC_Value(BSP_ADC_CHANNEL); // BSP_ADC_CHANNEL 就是 ADC_CHANNEL_11 // 2. 将原始值换算成电压值 (假设参考电压是3.3V) voltage = adc_raw_value / 4095.0f * 3.3f; // 3. 通过串口打印出来 printf("ADC Raw Value = %d\r\n", adc_raw_value); printf("Voltage = %.3f V\r\n", voltage); // 延时500ms再读下一次 delay_ms(500); } }

把程序编译下载到开发板，打开串口助手，你就能看到不断打印的数据了。

实验现象：