基于天空星GD32F407的MQ-4甲烷传感器ADC+DMA数据采集实战
基于天空星GD32F407的MQ-4甲烷传感器ADC+DMA数据采集实战
最近在做一个智能家居环境监测的小项目，需要检测厨房的天然气泄漏，于是就用上了MQ-4甲烷传感器。很多刚开始接触嵌入式开发的朋友，一看到传感器、ADC、DMA这些词就有点发怵，觉得配置起来很复杂。其实只要把流程理清楚，一步步来，你会发现并没有想象中那么难。
今天我就以国产的天空星GD32F407开发板为例，手把手带你完成MQ-4传感器的数据采集。咱们的目标很明确：把传感器输出的模拟电压信号，通过ADC转换成数字量，再用DMA自动搬运到内存里，最后换算成浓度百分比显示出来。我会把代码的每一部分都掰开揉碎了讲，保证你跟着做一遍就能完全掌握。
1. 认识你的“侦察兵”：MQ-4传感器
在写代码之前，咱们得先了解要驱动的对象。MQ-4传感器就像是一个专门侦察甲烷气体的“电子鼻子”。
它的核心是一层对气体敏感的材料——二氧化锡。在干净的空气里，这层材料的导电性比较差。一旦周围有甲烷、天然气这类可燃气体，材料的导电性就会随着气体浓度的增加而变强。传感器内部有个简单的电路，能把这个导电性的变化，转换成咱们单片机可以测量的电压信号。
MQ-4模块通常有4个引脚，工作电压3.3V到5V都行，和咱们的开发板正好匹配。它有两条输出“战线”：
- AO（模拟输出）：直接输出一个连续的电压值，气体浓度越高，电压越高。这是我们获取精确浓度数据的关键。
- DO（数字输出）：模块上有个比较器电路和一个可调电阻。当AO端的电压超过你设定的阈值（通过拧动电阻调整），DO就会从低电平跳变成高电平，相当于一个简单的“超标报警”开关。
所以，我们的任务就是读取AO引脚的电压，并通过计算得到浓度信息。DO引脚可以作为一个简单的报警指示灯来用。
提示：模块资料和驱动源码可以在提供的网盘链接（提取码：9966）里找到，里面有原理图、说明书等，动手前可以先下载下来看看。
2. 硬件连接与引脚规划
硬件连接很简单，就是给传感器供电，并把信号线接到开发板上。
- 供电：将MQ-4模块的
VCC和GND分别接到开发板的3.3V和GND。 - 信号线连接：
AO引脚：需要连接到具有ADC（模数转换器）功能的单片机引脚上。根据GD32F407的数据手册，我们选择PC1引脚，它对应着ADC0模块的第11号输入通道。DO引脚：这是一个普通的数字信号，接任意一个GPIO引脚都可以，我们把它接到PA1。
为什么选PC1？因为不是所有引脚都能做ADC输入。你必须去查芯片的数据手册（Datasheet），在引脚定义表里找到标有ADCx_INy功能的引脚才行。这一步是硬件设计的基础，千万不能搞错。
为了方便后续编程，我们先在代码里把这些硬件连接关系用宏定义确定下来，后面就直接用这些宏，不用老去记具体的引脚号了。
// bsp_mq4.h 中部分宏定义 #define PORT_MQ4_AO GPIOC // AO引脚所在的端口 #define GPIO_MQ4_AO GPIO_PIN_1 // AO引脚是PC1 #define PORT_MQ4_DO GPIOA // DO引脚所在的端口 #define GPIO_MQ4_DO GPIO_PIN_1 // DO引脚是PA1 #define PORT_ADC ADC0 // 使用的ADC模块编号 #define CHANNEL_ADC ADC_CHANNEL_11 // 使用的ADC通道号（对应PC1）3. 核心武器：ADC与DMA的协同配置
这是本次实战最核心的部分。如果让CPU一次次去ADC那里读取数据，会占用大量时间。我们的策略是让ADC专心转换，让DMA（直接存储器访问）这个“搬运工”自动把转换好的数据存到数组里，CPU只需要偶尔去数组里取处理好的数据就行，效率大大提升。
3.1 初始化流程总览
整个初始化过程就像启动一条自动化生产线：
- 打开各个部件的时钟（GPIO、ADC、DMA）。
- 配置GPIO引脚的模式（AO为模拟输入，DO为数字输入）。
- 配置ADC的工作模式（独立、连续转换、扫描等）。
- 配置DMA，告诉它从哪里搬（ADC数据寄存器），搬到哪里去（内存数组），怎么搬。
- 校准ADC，然后启动DMA和ADC，开始生产数据。
下面我们来看具体的代码实现。
3.2 代码逐行解析
首先，在bsp_mq4.c里，我们定义一个数组作为DMA的“目的地”仓库。这里计划对1个通道采样30次，所以定义了一个二维数组（实际代码中数组维度需根据实际情况补全，例如uint16_t gt_adc_val[1][30]）。
uint16_t gt_adc_val[][]; // DMA缓冲区，用于存储ADC转换结果接下来是重头戏ADC_DMA_Init()函数。
第一步：开启时钟任何外设要工作，必须先打开它的时钟。这就像给设备通电。
rcu_periph_clock_enable(RCU_MQ4_GPIO_AO); // 打开GPIOC时钟 rcu_periph_clock_enable(RCU_MQ4_GPIO_DO); // 打开GPIOA时钟 rcu_periph_clock_enable(RCU_MQ4_ADC); // 打开ADC0时钟 rcu_periph_clock_enable(RCU_MQ4_DMA); // 打开DMA1时钟第二步：配置GPIO引脚AO引脚用于测量模拟电压，必须设置为模拟输入模式，这样引脚内部电路才会连接到ADC模块。DO是数字输入，就设为浮空输入模式。
gpio_mode_set(PORT_MQ4_DO, GPIO_MODE_INPUT, GPIO_PUPD_NONE, GPIO_MQ4_DO); gpio_mode_set(PORT_MQ4_AO, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO_MQ4_AO); // PC1: 模拟输入模式第三步：配置ADC核心参数这里配置ADC的工作方式，是关键所在。
adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT); // ADC独立模式 adc_special_function_config(PORT_ADC, ADC_CONTINUOUS_MODE, ENABLE); // 使能连续转换模式 adc_special_function_config(PORT_ADC, ADC_SCAN_MODE, ENABLE); // 使能扫描模式（多通道时才需） adc_data_alignment_config(PORT_ADC, ADC_DATAALIGN_RIGHT); // 数据右对齐 adc_resolution_config(PORT_ADC, ADC_RESOLUTION_12B); // 12位分辨率- 连续转换模式：ADC完成一次转换后，立刻开始下一次转换，源源不断。
- 扫描模式：如果使能了多个通道，ADC会按顺序自动扫描这些通道。我们虽然只有一个通道，但也按这个模式配置。
- 12位分辨率：意味着ADC输出的数字量范围是0-4095，对应输入电压0-3.3V。
然后，告诉ADC规则组（可以理解为一个待转换的通道列表）里有多少个通道，并把我们的PC1（通道11）加到这个列表的第0个位置。
adc_channel_length_config(PORT_ADC, ADC_ROUTINE_CHANNEL, 1); // 规则组通道数为1 adc_routine_channel_config(PORT_ADC, 0, ADC_CHANNEL_11, ADC_SAMPLETIME_15); // 第0个顺序，通道11，采样时间15周期第四步：配置DMA——自动化搬运的关键这是解放CPU的核心。我们配置DMA1的通道0来为ADC0服务。
dma_single_data_parameter_struct dma_single_data_parameter; // 清除DMA通道旧配置 dma_deinit(DMA1, DMA_CH0); // 配置DMA参数 dma_single_data_parameter.periph_addr = (uint32_t)(&ADC_RDATA(ADC0)); // 源头：ADC0数据寄存器地址 dma_single_data_parameter.periph_inc = DMA_PERIPH_INCREASE_DISABLE; // 源头地址固定（总是从同一个寄存器读） dma_single_data_parameter.memory0_addr = (uint32_t)(gt_adc_val); // 目标：内存数组地址 dma_single_data_parameter.memory_inc = DMA_MEMORY_INCREASE_ENABLE; // 目标地址自增（数据依次存入数组） dma_single_data_parameter.periph_memory_width = DMA_PERIPH_WIDTH_16BIT; // 数据宽度16位（ADC是12位，用16位变量存） dma_single_data_parameter.direction = DMA_PERIPH_TO_MEMORY; // 传输方向：外设到内存 dma_single_data_parameter.number = 30 * 1; // 传输数据量：30个样本 * 1个通道 dma_single_data_parameter.priority = DMA_PRIORITY_HIGH; // DMA优先级高 // 初始化DMA通道 dma_single_data_mode_init(DMA1, DMA_CH0, &dma_single_data_parameter);配置好传输任务后，还要选择这个DMA通道是为哪个外设服务的。查数据手册可知，ADC0对应的是DMA_SUBPERI0。
dma_channel_subperipheral_select(DMA1, DMA_CH0, DMA_SUBPERI0);第五步：启动流水线所有配置完毕，依次启动各个部件。特别注意顺序：先使能DMA相关功能，再校准和使能ADC，最后开启ADC转换。
// 使能DMA循环模式（搬完指定数量后自动从头开始，实现循环缓冲） dma_circulation_enable(DMA1, DMA_CH0); // 使能ADC的DMA请求（每次转换完成就请求DMA来搬） adc_dma_request_after_last_enable(PORT_ADC); adc_dma_mode_enable(PORT_ADC); // 启动DMA通道 dma_channel_enable(DMA1, DMA_CH0); // 使能ADC，等待稳定，然后进行校准（提高精度） adc_enable(ADC0); delay_ms(1); adc_calibration_enable(ADC0); // 最后，用软件触发ADC开始转换。一旦开始，由于是连续模式，它将永不停歇。 adc_software_trigger_enable(ADC0, ADC_ROUTINE_CHANNEL);至此，一个由ADC采样、DMA搬运的自动化数据流水线就开始运行了。gt_adc_val数组里会自动填充最新的ADC采样值。
4. 数据处理与浓度计算
数据自动存好了，我们怎么用呢？首先，写一个函数去计算一段时间内采样的平均值，这样可以过滤掉一些偶然的干扰。
unsigned int Get_Adc_Dma_Value(char CHx) { unsigned char i = 0; unsigned int AdcValue = 0; // 假设我们采样了30次，对它们求和 for(i=0; i<30; i++) { AdcValue += gt_adc_val[0][i]; // 从缓冲区取数据 } // 再求平均 AdcValue = AdcValue / 30; return AdcValue; }拿到稳定的ADC值（0-4095）后，就可以把它换算成百分比了。这个百分比代表当前电压值占ADC量程（3.3V）的比例。对于MQ-4传感器，这个电压比例间接反映了气体浓度的相对大小。
unsigned int Get_MQ4_Percentage_value(void) { int adc_max = 4095; // 12位ADC最大值 int adc_new = 0; int Percentage_value = 0; adc_new = Get_Adc_Dma_Value(0); // 获取ADC平均值 // 计算百分比：(当前值 / 最大值) * 100% Percentage_value = ((float)adc_new / adc_max) * 100; return Percentage_value; }注意：这里计算的是电压百分比，并非精确的甲烷浓度ppm值。要得到精确浓度，需要根据传感器数据手册提供的灵敏度特性曲线（通常是指数关系）进行更复杂的换算，并且需要进行校准。本例的百分比输出适用于对浓度进行相对比较或阈值报警的场景。
另外，数字输出DO的状态可以直接读取，用于快速报警。
char Get_MQ4_DO_value(void) { // 读取DO引脚电平，RESET为低电平，SET为高电平 if(gpio_input_bit_get(GPIOA, GPIO_PIN_1) == RESET) { return 0; // 未检测到高浓度气体 } else { return 1; // 检测到气体浓度超过模块设定阈值 } }5. 实战验证：让代码跑起来
最后，我们在主函数里把上面的功能整合起来，进行验证。
#include "board.h" #include "bsp_mq4.h" #include <stdio.h> // 为了使用printf int main(void) { board_init(); // 开发板基础初始化（系统时钟、延时等） bsp_uart_init(); // 初始化串口，用于打印数据 ADC_DMA_Init(); // 初始化ADC和DMA printf("MQ-4 ADC DMA Demo Start\r\n"); while(1) { // 每秒读取并打印一次甲烷浓度的百分比值 printf("Methane Concentration: %d%%\r\n", Get_MQ4_Percentage_value()); // 也可以检查数字输出状态 // if(Get_MQ4_DO_value()) { // printf("Warning: High concentration detected!\r\n"); // } delay_ms(1000); // 延时1秒 } }将代码编译下载到天空星GD32F407开发板，连接好传感器，打开串口助手。你应该能看到终端里每秒打印一个百分比数值。对着传感器吹口气（含二氧化碳）或者靠近打火机（注意安全）释放少量气体，观察数值的变化。数字输出DO的状态也可以通过模块上的电位器调整灵敏度来测试。
这个项目把ADC采样、DMA传输、传感器应用串了起来，是一个很典型的嵌入式数据采集案例。掌握了这个流程，你再遇到其他模拟传感器，比如温湿度、光照强度等，思路都是一样的，只需要根据具体传感器调整计算方式即可。