基于TI MSPM0 MCU的MQ-6丙烷传感器驱动移植与浓度检测实战
最近在做一个智能家居安全监测的小项目，需要检测厨房的燃气泄漏，于是就用上了MQ-6气体传感器。很多刚开始接触嵌入式或者准备电赛的朋友，可能对怎么把传感器接到单片机上、怎么读取数据感到头疼。今天，我就以TI的MSPM0系列MCU（比如立创的开发板）为例，手把手带你走一遍完整的流程，从硬件连接到软件配置，再到数据读取和浓度计算，让你彻底搞明白。
咱们的目标很明确：让MQ-6传感器在MSPM0开发板上跑起来，通过串口实时打印出环境中丙烷气体的浓度百分比。整个过程会涉及到ADC采集模拟信号、GPIO读取数字信号，以及在SYSCONFIG工具里的配置。别担心，我会把每一步的原理和操作都讲清楚。
1. 认识我们的“鼻子”：MQ-6气体传感器
在写代码之前，咱们得先了解要驱动的对象。MQ-6传感器就像是一个电子鼻子，专门用来“闻”可燃气体。
它的核心是一层二氧化锡(SnO2)材料。在干净的空气里，这层材料的导电性很差（电阻大）。一旦周围出现了像丙烷、丁烷、甲烷这样的可燃气体，气体分子会和材料发生反应，导致它的导电性变好（电阻变小）。传感器模块内部有个简单的电路，能把这个电阻变化转换成电压信号输出给我们单片机。
注意：MQ-6对多种可燃气体都敏感，尤其擅长检测液化石油气（主要成分是丙烷）。它是一款性价比很高的传感器，但要注意，它不能区分具体是哪种气体，只能告诉我们“有可燃气体”以及“大概有多少”。
模块通常有4个引脚（2.54mm间距，方便插在面包板或杜邦线上）：
- VCC：供电脚，接3.3V或5V。
- GND：接地脚。
- AO：模拟量输出。直接输出一个随气体浓度变化的电压值，浓度越高，电压通常越高。这个引脚需要连接到单片机的ADC（模数转换器）引脚。
- DO：数字量输出。模块上一般有个蓝色的电位器（可调电阻），可以设定一个浓度阈值。当气体浓度超过这个阈值时，DO引脚会输出一个低电平（0），否则输出高电平（1）。这个引脚可以直接连接到单片机的普通GPIO引脚，用于快速报警。
简单来说，AO引脚用于精确测量浓度，DO引脚用于简单的超标报警。咱们这次两个都用上，把功能做完整。
2. 硬件连接与引脚规划
首先，把传感器模块和你的MSPM0开发板（比如立创开发板）用杜邦线连起来。连接非常简单：
| 传感器引脚 | 连接到开发板 | 说明 |
|---|---|---|
| VCC | 3.3V 或 5V 电源引脚 | 根据模块和开发板情况选择 |
| GND | GND (地) | 共地非常重要！ |
| AO | 任选一个具有ADC功能的GPIO引脚 | 例如原文中使用的PA27 |
| DO | 任选一个普通GPIO输入引脚 | 例如PA25 |
这里重点说一下AO引脚的连接。MSPM0的很多GPIO口都内置了ADC功能，但不是所有引脚都有。你需要查阅你所使用开发板的原理图或引脚复用表，找一个标有ADC功能的引脚。原文例程里用的是PA27，我们就沿用这个。
DO引脚就随意多了，几乎任何一个GPIO都可以配置成输入模式来读取它的高低电平。
3. 使用SYSCONFIG工具配置外设
TI为MSPM0系列提供了非常方便的图形化配置工具——SYSCONFIG。它集成在Code Composer Studio (CCS)或IAR等开发环境里，咱们可以用它来可视化地配置ADC和GPIO，它会自动生成对应的初始化代码，省去了我们手动查寄存器、写配置字的麻烦。
下面是在CCS环境中操作的步骤：
- 打开工程：在你的CCS工程里，找到并双击
empty.syscfg文件（或者类似名称的.syscfg文件），这个文件就是SYSCONFIG的配置文件。 - 添加ADC配置：在打开的图形界面中，点击
ADD按钮，在搜索框里输入“ADC”，找到并添加ADC12组件（MSPM0使用ADC12模块）。 - 配置ADC通道：
- 在ADC12组件的属性栏里，找到
Channel 0相关的设置。 - 将
Analog Input选择为你连接的引脚，比如PA27。 - 其他参数如采样周期、参考电压等，初学者可以先保持默认。参考电压通常选内部参考
VREF（例如2.5V或1.4V），这决定了ADC测量的电压范围。
- 在ADC12组件的属性栏里，找到
- 添加GPIO配置：再次点击
ADD，搜索“GPIO”，添加一个GPIO组件。- 在属性栏里，找到你连接DO引脚的端口（例如
Port A），找到对应的引脚（例如PA25）。 - 将其
Direction设置为Input（输入模式）。 - 如果需要内部上拉或下拉电阻，可以在这里设置。MQ-6模块的DO输出通常是推挽输出，这里可以不启用内部上下拉。
- 在属性栏里，找到你连接DO引脚的端口（例如
- 保存并生成代码：点击保存按钮。这里有个关键的坑点：保存时，软件可能会弹出对话框询问是否要更新相关文件，一定要选择
Yes to All，确保所有配置都生效。 - 处理编译警告：保存后，点击编译工程。SYSCONFIG工具可能会修改一些底层文件，有时会伴随一些编译警告，通常不影响功能，可以暂时忽略。
完成这些步骤后，SYSCONFIG工具会自动在工程里生成一个ti_msp_dl_config.h文件，里面就定义了我们刚刚配置的ADC和GPIO引脚。我们的工程已经通过board.h文件包含了这个配置头文件，所以后续编程中，我们直接#include “board.h”就能使用这些定义好的引脚了，非常方便。
4. 编写传感器驱动代码
配置好硬件抽象层，接下来就是写应用层的驱动逻辑了。我们需要创建两个文件：bsp_mq6.c（源文件）和bsp_mq6.h（头文件）。
4.1 头文件定义 (bsp_mq6.h)
头文件主要做宏定义和函数声明。
#ifndef _BSP_MQ6_H_ #define _BSP_MQ6_H_ #include "board.h" // 包含SYSCONFIG生成的配置 // 读取DO引脚电平的宏定义 // 原理：读取GPIO端口引脚状态，并进行逻辑判断 #define MQ_DO ( ( DL_GPIO_readPins( MQ_PORT, MQ_DO_PIN ) & MQ_DO_PIN ) ? 1 : 0 ) // ADC采样次数，多次采样取平均可以减小噪声干扰 #define SAMPLES 30 // 函数声明 void ADC_MQ6_Init(void); // 初始化ADC（主要是中断） unsigned int Get_Adc_MQ6_Value(void); // 获取ADC原始值（平均值） unsigned int Get_MQ6_Percentage_value(void); // 获取气体浓度百分比 char Get_MQ6_DO_value(void); // 获取DO引脚报警状态 #endif这里注意MQ_PORT和MQ_DO_PIN需要你在别处定义，或者直接替换成SYSCONFIG为你生成的宏，比如GPIO_PORT_PA和GPIO_PIN_25。
4.2 核心驱动函数 (bsp_mq6.c)
源文件是实现所有功能的地方，咱们一个一个函数来看。
首先，初始化ADC并开启中断：
volatile bool gCheckADC = false; // ADC转换完成标志位，volatile防止编译器优化 void ADC_MQ6_Init(void) { // 开启ADC转换完成中断 // ADC12_0_INST_INT_IRQN 这个中断号是由SYSCONFIG工具定义好的 NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); }这个函数很简单，就是让CPU能够响应ADC转换完成时产生的中断。中断是单片机高效工作的重要机制，ADC转换需要一点时间，用中断方式可以避免CPU傻等。
然后，是ADC中断服务函数：
void ADC12_0_INST_IRQHandler(void) { // 查询是哪个中断源触发了 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 检查是否是通道0的ADC转换完成了 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC = true; // 设置全局标志位，告诉主程序“数据准备好了” break; default: break; } }当中断发生时，这个函数会被自动调用。它检查中断原因，如果是我们关心的ADC转换完成，就把标志位gCheckADC设为true。
接着，是读取一次ADC数据的函数：
uint32_t ADC_GET(void) { unsigned int gAdcResult = 0; int timeout = 20; // 超时计数器，防止程序卡死 // 软件触发ADC开始一次转换 DL_ADC12_startConversion(ADC12_0_INST); // 等待转换完成标志位被置位 while (false == gCheckADC) { delay_us(1); // 短暂延时 timeout--; if(timeout <= 0) // 如果超时，打印错误并退出 { printf("ADC转换超时错误！ LINE:%d\r\n",__LINE__); return 0; // 返回0或一个错误值 } } // 从ADC结果存储器中读取通道0的数据 gAdcResult = DL_ADC12_getMemResult(ADC12_0_INST, ADC12_0_ADCMEM_ADC_CH0); // 清除标志位，为下一次转换做准备 gCheckADC = false; return gAdcResult; }这个函数是ADC读数的核心。它启动转换，然后等待中断发生（通过检查gCheckADC标志），最后读取转换结果。timeout是个好习惯，避免程序因意外死循环。
为了得到稳定的读数，我们需要多次采样取平均值：
unsigned int Get_Adc_MQ6_Value(void) { uint32_t Data = 0; for(int i = 0; i < SAMPLES; i++) // 循环采样SAMPLES次（前面定义为30次） { Data += ADC_GET(); // 累加每次的采样值 delay_ms(5); // 每次采样间隔5ms，让传感器稳定 } Data = Data / SAMPLES; // 计算平均值 return Data; }传感器信号可能会有波动，取平均值是最简单有效的滤波方法。
把ADC原始值转换成百分比浓度：
unsigned int Get_MQ6_Percentage_value(void) { int adc_max = 4095; // 假设ADC是12位的，最大值是2^12 -1 = 4095 int adc_new = 0; int Percentage_value = 0; adc_new = Get_Adc_MQ6_Value(); // 获取平均ADC值 // 核心计算公式：(当前ADC值 / 最大ADC值) * 100% Percentage_value = ((float)adc_new / (float)adc_max) * 100.f; return Percentage_value; }这里假设ADC是12位分辨率（MSPM0的ADC12模块就是12位），量程是0-4095。这个百分比表示当前电压占参考电压的比例。注意：这个百分比并不是气体浓度的真实ppm值，而是一个相对值。要得到真实浓度，需要根据传感器数据手册进行标定和公式换算。但对于很多报警或趋势观察的应用，这个相对值已经足够。
最后，读取DO引脚的数字报警信号：
char Get_MQ6_DO_value(void) { // 直接使用头文件中定义的宏 MQ_DO 进行读取和判断 if( MQ_DO == 0 ) // 通常DO引脚在检测到气体时输出低电平 { return 1; // 返回1表示检测到气体（报警） } else { return 0; // 返回0表示安全 } }模块上的蓝色电位器就是用来调节这个报警阈值的。顺时针拧，灵敏度降低（需要更高浓度才报警）；逆时针拧，灵敏度升高。
5. 主程序验证与效果
驱动写好了，最后在主函数里调用它们，看看效果。
#include "board.h" #include <stdio.h> #include "bsp_mq6.h" int main(void) { // 开发板初始化（时钟、串口等） board_init(); // 初始化MQ-6传感器（主要是ADC中断） ADC_MQ6_Init(); printf("MQ-6丙烷传感器检测Demo开始...\r\n"); while(1) { // 读取并打印浓度百分比 printf("丙烷含量 = %d%%\r\n", Get_MQ6_Percentage_value() ); // 读取并打印报警状态 if(Get_MQ6_DO_value()) { printf("警告：检测到可燃气体超标！\r\n"); } else { printf("状态：安全\r\n"); } printf("\n"); // 空行分隔 delay_ms(1000); // 每秒检测一次 } }将代码编译下载到开发板，打开串口调试助手（比如Putty、SecureCRT），设置好波特率（通常是115200），你就能看到每秒输出一次的气体浓度百分比和报警状态了。
你可以尝试向传感器附近呼一口气（含二氧化碳）或者用打火机（不点火）释放少量丁烷气体，观察ADC百分比值的变化和DO报警状态的变化。通过调节模块上的电位器，你可以改变DO报警的触发点。
整个流程走下来，你会发现，驱动一个模拟传感器并不复杂，核心就是ADC配置、数据读取和转换。希望这篇实战教程能帮你打通思路，下次遇到其他模拟传感器，比如温湿度、光照强度等，你也能举一反三，快速上手。
