基于立创TJX-TMS320F28P550开发板的MQ-7一氧化碳传感器驱动移植与数据采集实战
基于立创TJX-TMS320F28P550开发板的MQ-7一氧化碳传感器驱动移植与数据采集实战
最近在做一个环境监测的小项目，需要用到MQ-7一氧化碳传感器。手头正好有立创的TJX-TMS320F28P550开发板，这是一块基于TI C2000系列DSP的板子，性能不错。网上关于MQ-7和普通单片机（比如STM32）搭配的教程很多，但和这块C2000开发板结合的资料就比较少了。我花了一些时间把驱动调通，把整个过程和踩过的坑整理出来，希望能帮到同样在用这块板子做项目的朋友。
这篇教程会手把手带你完成MQ-7传感器在立创TJX-TMS320F28P550开发板上的完整驱动移植，包括硬件接线、SysConfig图形化配置、ADC采样和数字IO读取，最后实现模拟量和数字量双模式的数据采集。即使你是C2000的初学者，跟着步骤走也能搞定。
1. 认识你的“搭档”：MQ-7传感器与开发板
在动手写代码之前，咱们得先搞清楚要用的两个“主角”是谁，以及它们要怎么“对话”。
1.1 MQ-7传感器模块简介
MQ-7是一个专门用来检测一氧化碳（CO）浓度的半导体气敏传感器。它的核心是二氧化锡（SnO₂）材料，这种材料在清洁空气中导电性比较差，但是当空气中一氧化碳浓度增加时，它的电导率会随之增大。
这个模块有两个关键的工作特点：
- 高低温循环检测：它内部有个加热丝，需要周期性地切换电压。在**低温（1.5V加热）阶段，它用来检测一氧化碳，此时电导率变化与CO浓度相关。在高温（5.0V加热）**阶段，则用来“清洗”传感器，清除低温时吸附的气体，为下一次检测做准备。不过好消息是，我们买的这个模块板已经把加热电路集成好了，我们只需要提供稳定的电源，模块自己会管理这个循环，我们只管读数据就行。
- 双输出接口：模块提供了两种读取数据的方式，非常方便。
- AO（模拟输出）：直接输出一个电压信号，这个电压值会随着传感器电导率（也就是气体浓度）的变化而连续变化。我们需要用开发板的ADC（模数转换器）来读取这个电压。
- DO（数字输出）：模块上自带了一个LM393电压比较器芯片。它会把AO的电压和一个可调的阈值电压进行比较。当气体浓度超过你设定的阈值时，DO引脚就会输出一个数字信号（比如从高电平变成低电平）。你可以通过模块上的一个蓝色电位器来调节这个报警阈值。
模块的主要规格参数如下：
- 工作电压：3.3V ~ 5V （咱们的开发板有5V和3.3V输出，可以直接用）
- 工作电流：约150mA （功耗不算小，供电要稳定）
- 输出方式：AO（模拟量）、DO（数字量）
- 管脚：4个排针（VCC, GND, DO, AO）
1.2 立创TJX-TMS320F28P550开发板准备
这块开发板的核心是TI的TMS320F28P550 DSP芯片，性能强劲，外设丰富。我们这次主要用到它的两个功能：
- ADC模块：用来读取MQ-7的AO模拟电压。F28P550的ADC是12位精度的，也就是说它能把0到3.3V的电压分成4096个等级，分辨率足够我们用了。
- GPIO：用来读取MQ-7的DO数字电平状态，配置为输入模式即可。
开发环境我使用的是TI的Code Composer Studio (CCS)，并且工程已经配置好了SysConfig图形化配置工具，这个工具能大大简化引脚和外设的初始化，后面我们会用到。
2. 硬件连接与SysConfig图形化配置
硬件连接是第一步，一定要接对，不然代码写得再好也没用。
2.1 引脚连接
根据开发板的引脚资源，我们进行如下连接：
| MQ-7传感器模块引脚 | 连接至TJX-TMS320F28P550开发板 |
|---|---|
| VCC | 5V0 电源引脚 |
| GND | GND 地引脚 |
| DO (数字输出) | GPIO54 |
| AO (模拟输出) | GPIO-A6 (这是一个复用为ADC输入通道的引脚) |
注意：GPIO-A6这个引脚名称可能有点特别。在C2000系列里，很多GPIO引脚除了做普通的数字输入输出，还复用了ADC输入功能。GPIO-A6就是指可以配置为ADC通道的某个引脚，具体对应哪个物理引脚，我们需要在SysConfig里查看和确认。
连接好之后，给开发板上电。MQ-7模块上的指示灯应该会亮起，并且可能会微微发热（这是正常的加热过程）。
2.2 使用SysConfig配置引脚功能
这是C2000开发的一个便利工具，我们可以用图形界面来配置引脚，不用去手动查手册写复杂的寄存器代码。
- 打开配置文件：在你的CCS工程里，找到并双击
c2000.syscfg这个文件。SysConfig界面就会在CCS中打开。 - 添加ADC配置：在左侧的组件列表里，找到或搜索“ADC”。点击“ADD”按钮，为工程添加一个ADC配置实例（比如叫
Module_ADC）。 - 配置ADC通道：在添加的ADC实例配置中，找到SOC（Start-Of-Conversion）配置。我们需要配置一个SOC，比如SOC0，并设置其触发源（为了简单，可以先选“软件触发”），然后最关键的一步：将它的通道（Channel）选择为连接我们AO线的那个ADC引脚。根据之前的规划，就是
GPIO-A6对应的ADC通道（例如可能是ADCA2，具体以引脚图为准）。 - 添加GPIO配置：同样，在组件列表中找到“GPIO”，点击“ADD”添加一个GPIO配置实例。
- 配置GPIO54为输入：在GPIO配置中，找到
GPIO54这个引脚。将其功能（Mode）设置为“GPIO”，方向（Direction）设置为“Input”（输入），因为我们只是读取DO引脚的状态。 - 保存并生成代码：按下
Ctrl + S保存SysConfig配置。然后按下Ctrl + B编译一次工程。这里可能会弹出一些警告，可以先忽略。编译完成后，SysConfig会根据你的图形化配置，自动在后台生成对应的C语言初始化代码。 - 查看生成的定义：生成的引脚和模块的宏定义都在
board.h这个文件里。因为我们的工程模板通常已经在tjx_init.h中包含了board.h，所以后续我们只需要在代码里#include "tjx_init.h"，就可以使用像GPIO_DO(对应GPIO54)、Module_ADC_BASE这样的宏了，非常方便。
3. 手把手编写MQ-7驱动代码
配置好硬件和引脚，接下来就是写代码的逻辑了。我们在工程里新建一个文件夹module_driver，专门放各种外设模块的驱动。在里面创建两个文件：bsp_mq7.c和bsp_mq7.h(“bsp”是板级支持包的意思)。记得把module_driver这个路径添加到工程的编译器头文件包含路径里。
3.1 头文件定义 (bsp_mq7.h)
头文件主要进行宏定义和函数声明。
#ifndef _BSP_MQ7_H_ #define _BSP_MQ7_H_ #include "tjx_init.h" // 包含了board.h，里面有了我们SysConfig配置的所有宏 // 读取DO引脚电平状态的宏。GPIO_DO就是在SysConfig里为GPIO54定义的宏 #define MQ_DO GPIO_readPin( GPIO_DO ) // 定义ADC采样次数，通过多次采样取平均可以滤除一些偶然干扰 #define SAMPLES 5 // 函数声明 uint16_t Get_Adc_MQ7_Value(void); // 获取ADC原始值 uint8_t Get_MQ7_Percentage_value(void); // 获取ADC值换算的百分比 char Get_MQ7_DO(void); // 获取DO数字引脚状态 #endif3.2 核心驱动实现 (bsp_mq7.c)
这里是具体的函数实现，我们拆解开来一步步看。
首先，需要一个基础的ADC读取函数。这个函数负责触发一次ADC转换，并等待转换完成，返回结果。
#include "bsp_mq7.h" #include "stdio.h" // 为了使用lc_printf调试输出 /** * @brief 读取一次ADC数据 * @param 无 * @retval ADC转换结果（0-4095），如果超时返回0 * @note 这是一个静态函数，只在本文件内使用 */ static uint16_t ADC_GET(void) { uint16_t gAdcResult = 0; uint16_t timeOut = 200; // 设置一个超时计数器，防止死等 // 1. 软件触发ADC开始转换。Module_ADC_BASE等宏由SysConfig生成 ADC_forceMultipleSOC(Module_ADC_BASE, Module_ADC_FORCE_SOC0); // 2. 等待ADC转换完成 while(ADC_isBusy(Module_ADC_BASE) && timeOut--) { delay_us(5); // 稍微延迟一下，这个函数需要你自己实现或使用库函数 } // 3. 检查是否超时 if(!timeOut) { lc_printf("ADC_GET Failed!!!\r\n"); // 打印错误信息 return 0; } // 4. 读取转换结果。Module_ADC_RESULT_BASE是结果寄存器基地址 gAdcResult = ADC_readResult(Module_ADC_RESULT_BASE, Module_ADC_SOC0); return gAdcResult; }然后，实现获取MQ-7模拟值的函数。直接读一次ADC可能不稳定，我们采用多次采样取平均的方法。
/** * @brief 获取MQ-7的ADC采样值（平均值） * @param 无 * @retval 多次采样平均后的ADC值（0-4095） */ uint16_t Get_Adc_MQ7_Value(void) { uint16_t Data = 0; int i; // 循环采样SAMPLES次（前面定义为5次） for(i = 0; i < SAMPLES; i++) { Data += ADC_GET(); // 累加每次的采样值 delay_ms(5); // 每次采样间隔5ms，让传感器和ADC稳定一下 } Data = Data / SAMPLES; // 计算平均值 return Data; }接着，提供一个将ADC值转换为百分比的函数。有时候我们更关心相对浓度变化，这个函数把0-4095的ADC值映射到0-100%。
/** * @brief 读取MQ-7值，并转换为百分比 * @param 无 * @retval 浓度百分比 (0-100) */ uint8_t Get_MQ7_Percentage_value(void) { int adc_max = 4095; // 12位ADC的最大值 int adc_new = 0; float Percentage_value = 0; adc_new = Get_Adc_MQ7_Value(); // 先获取原始ADC值 // 计算百分比：(当前值 / 最大值) * 100 Percentage_value = ((float)adc_new / (float)adc_max) * 100.f; return (uint8_t)Percentage_value; // 强制转换为整数返回 }最后，数字输出DO的读取函数非常简单，因为我们在头文件里已经用宏定义好了。
/** * @brief 获取MQ-7 DO引脚的电平状态 * @param 无 * @retval DO引脚的电平状态（0或1） * @note 模块上的蓝色电位器可以调节灵敏度，从而改变DO翻转的阈值 */ char Get_MQ7_DO(void) { return MQ_DO; // 直接使用宏，读取GPIO54的电平 }4. 在主程序中测试与验证
驱动写好了，最后就是在主函数里调用它们，看看数据是否正常。我们在main.c（可能是empty_driverlib_main.c）中编写测试代码。
#include "driverlib.h" #include "device.h" #include "board.h" #include "c2000ware_libraries.h" #include "tjx_init.h" #include "bsp_mq7.h" // 包含我们自己的驱动头文件 void main(void) { // 以下是CCS自动生成的系统初始化代码 Device_init(); Device_initGPIO(); Interrupt_initModule(); Interrupt_initVectorTable(); Board_init(); C2000Ware_libraries_init(); EINT; ERTM; lc_printf("\r\n=== MQ-7 Sensor Test Start ===\r\n"); while(1) { // 1. 打印ADC原始值 lc_printf("MQ7 ADC Value = %d\r\n", Get_Adc_MQ7_Value()); // 2. 打印百分比浓度 lc_printf("MQ7 Percentage = [%d%%]\r\n", Get_MQ7_Percentage_value()); // 3. 打印数字输出状态 lc_printf("MQ7 DO State = %d\r\n", Get_MQ7_DO()); // DO为0通常表示浓度超过阈值（报警），为1表示安全 lc_printf("-------------------\r\n"); // 这里加一个简单的LED闪烁，表示程序在运行 GPIO_writePin(RGB_B, 0); // 蓝灯亮 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(500); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 0); // 绿灯亮 delay_ms(500); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(500); } }将代码编译下载到开发板，打开串口调试助手（波特率等参数根据你的板子UART配置设置），应该就能看到周期性地打印出三行数据：
MQ7 ADC Value：原始的ADC数值，在清洁空气中会有一个相对稳定的基准值。MQ7 Percentage：换算后的百分比，更直观。MQ7 DO State：数字输出状态，你可以尝试向传感器附近呼一口气（含二氧化碳）或者用打火机（勿点燃）放出微量气体，观察ADC值和百分比上升，当超过一定阈值时，DO状态可能会从1变为0。这个阈值可以通过调节模块上的蓝色电位器来改变。
5. 实际使用中的几点心得
- 预热时间：MQ-7传感器通电后需要一段时间预热才能稳定输出，通常要1-2分钟。刚上电时的读数是不准的，要在程序里忽略这段时间的数据，或者等预热完成后再开始采样。
- 环境基准：在洁净空气中读取一个ADC值作为“零点”或“基准值”。实际检测时，用当前值减去这个基准值，更能反映浓度的变化。
- DO阈值的调节：那个蓝色电位器用螺丝刀轻轻旋转即可。顺时针旋转通常提高灵敏度（更容易报警），逆时针降低灵敏度。调到什么位置，需要你在实际应用环境中测试确定。
- ADC参考电压：确保你的开发板ADC参考电压稳定（通常是3.3V），这是ADC转换准确的基础。
- 代码中的延时：驱动代码里的
delay_ms(5)很重要，它给了ADC通道和传感器一定的稳定时间。如果采样频率要求很高，可以适当减小，但要注意数据稳定性。
整个移植过程就是这样。核心思路就是：硬件连线 -> 图形化配置引脚 -> 编写ADC采样和GPIO读取函数 -> 在主循环中调用并打印。希望这篇教程能让你顺利地在立创TJX-TMS320F28P550开发板上把MQ-7传感器用起来。