2.26 基于梁山派GD32F470的MS1100 VOC气体传感器驱动移植与甲醛检测实战

基于梁山派GD32F470的MS1100 VOC气体传感器驱动移植与甲醛检测实战

最近在做一个室内空气质量监测的小项目，需要检测甲醛浓度。网上找了一圈，发现MS1100（也叫CJMCU-1100）这个传感器模块挺合适的，价格便宜，灵敏度也不错。正好手头有立创的梁山派GD32F470开发板，就想着把这两个搭配起来用。

今天我就把整个驱动移植和甲醛检测的实现过程整理出来，分享给大家。如果你也在用GD32做环境监测相关的项目，或者想学习如何将传感器模块移植到自己的工程中，这篇教程应该能帮到你。

1. 认识MS1100 VOC气体传感器

在开始动手之前，咱们先了解一下今天的主角——MS1100传感器模块。

1.1 模块简介与用途

MS1100是一款半导体原理的VOC（挥发性有机化合物）气体传感器。简单来说，它内部有一个对特定气体敏感的半导体材料，当接触到目标气体时，材料的电阻会发生变化，这个变化会被转换成电压信号输出。

它能检测哪些气体呢？主要是甲醛、甲苯、苯这些装修后常见的有机挥发物。灵敏度很高，能检测到0.1ppm（百万分之一）以上的浓度。因为这个特点，它被广泛用在空气净化器、新风系统、换气扇这些家电产品里。

注意：ppm是浓度单位，1ppm相当于在100万份空气中含有1份目标气体。

1.2 模块规格与工作方式

先看看模块的基本参数：

这个模块有两个输出信号，理解清楚这两个信号的区别很重要：

1. AOUT（模拟输出）：这是最核心的信号。传感器检测到的气体浓度会转换成对应的电压值，浓度越高，电压越高。这个电压信号需要连接到单片机的ADC引脚，通过ADC读取具体的电压值。

2. DOUT（数字输出）：这是一个比较器输出。模块上有个4K的可调电阻，可以设置一个阈值电压。当AOUT的电压超过这个阈值时，DOUT输出高电平（同时模块上的LED灯会亮）；反之输出低电平（LED灭）。你可以把它理解成一个简单的“超标报警”信号。

模块上还有个LED指示灯，当DOUT输出高电平时会亮起，方便直观判断。

重要提示：MS1100传感器需要预热！刚上电时读数不稳定，需要等待3-5分钟让传感器稳定后再进行测量。这个时间一定要留足，不然测出来的数据不准。

2. 硬件连接与引脚配置

2.1 模块引脚说明

MS1100模块有4个引脚，接线很简单：

为什么选PC1和PF10这两个引脚？这里有个小细节：MS1100的AOUT需要ADC功能，GD32F470的PC1引脚对应的是ADC0的第11通道。PF10就是个普通GPIO，用来读取数字信号。

2.2 实际接线图

接线的时候注意：

• 电源一定要接5V，接3.3V可能无法正常工作
• 地线要接好，避免干扰
• 模拟信号线（AOUT）尽量远离数字信号线，减少干扰

3. 驱动代码移植与解析

接下来是核心部分——把驱动代码移植到你的工程中。我按照实际操作的步骤来讲解。

3.1 创建驱动文件

首先在你的工程里创建两个文件：

• bsp_ms1100.c- 驱动源文件
• bsp_ms1100.h- 驱动头文件

如果你用的是Keil、IAR或者VSCode+GCC，创建文件的方法都差不多。这里假设你已经有了一个基本的GD32工程框架。

3.2 头文件定义（bsp_ms1100.h）

头文件主要是定义引脚和函数声明，咱们先看看完整的代码：

#ifndef _BSP_MS1100_H_ #define _BSP_MS1100_H_ #include "gd32f4xx.h" // AO引脚定义（PC1，ADC功能） #define RCU_MS1100_AO RCU_GPIOC #define PORT_MS1100_AO GPIOC #define GPIO_MS1100_AO GPIO_PIN_1 // DO引脚定义（PF10，数字输入） #define RCU_MS1100_DO RCU_GPIOF #define PORT_MS1100_DO GPIOF #define GPIO_MS1100_DO GPIO_PIN_10 // ADC定义（使用ADC0，通道11） #define RCU_MS1100_ADC RCU_ADC0 #define PORT_MS1100_ADC ADC0 #define CHANNEL_MS1100_ADC ADC_CHANNEL_11 // 采样通道数（我们只用1个通道） #define CHANNEL_NUM 1 // 读取DO引脚状态的宏 #define MS1100_DO gpio_input_bit_get(PORT_MS1100_DO, GPIO_MS1100_DO) // 函数声明 void MS1100_GPIO_Init(void); // 初始化函数 unsigned int Get_ADC_Value(unsigned int num); // 读取ADC值（多次平均） unsigned char Get_DO_Num(void); // 读取DO状态 #endif

这里有几个关键点：

• 引脚定义要和你实际接线一致
• CHANNEL_MS1100_ADC设置为ADC_CHANNEL_11，因为PC1对应ADC0的通道11
• MS1100_DO宏直接调用GD32的库函数读取引脚状态

3.3 初始化函数详解（bsp_ms1100.c）

初始化函数是驱动里最复杂的部分，我一步步拆开讲：

#include "bsp_ms1100.h" #include "systick.h" #include "bsp_usart.h" #include "stdio.h" void MS1100_GPIO_Init(void) { /* 1. 开启相关时钟 */ rcu_periph_clock_enable(RCU_MS1100_AO); // 开启GPIOC时钟 rcu_periph_clock_enable(RCU_MS1100_DO); // 开启GPIOF时钟 rcu_periph_clock_enable(RCU_MS1100_ADC); // 开启ADC0时钟 /* 2. 配置DO引脚（PF10）为输入模式，上拉 */ gpio_mode_set(PORT_MS1100_DO, GPIO_MODE_INPUT, GPIO_PUPD_PULLUP, GPIO_MS1100_DO); /* 3. 配置AO引脚（PC1）为模拟输入模式 */ gpio_mode_set(PORT_MS1100_AO, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO_MS1100_AO); /* 4. ADC基础配置 */ adc_sync_mode_config(ADC_SYNC_MODE_INDEPENDENT); // 独立模式（只有一个ADC） adc_special_function_config(PORT_MS1100_ADC, ADC_CONTINUOUS_MODE, ENABLE); // 连续转换模式 adc_special_function_config(PORT_MS1100_ADC, ADC_SCAN_MODE, ENABLE); // 扫描模式 adc_data_alignment_config(PORT_MS1100_ADC, ADC_DATAALIGN_RIGHT); // 数据右对齐 /* 5. 配置ADC通道 */ adc_channel_length_config(PORT_MS1100_ADC, ADC_REGULAR_CHANNEL, CHANNEL_NUM); // 规则通道数 adc_regular_channel_config(PORT_MS1100_ADC, 0, CHANNEL_MS1100_ADC, ADC_SAMPLETIME_15); // 通道11，采样时间15周期 /* 6. 其他ADC设置 */ adc_resolution_config(PORT_MS1100_ADC, ADC_RESOLUTION_12B); // 12位分辨率 adc_external_trigger_config(PORT_MS1100_ADC, ADC_REGULAR_CHANNEL, EXTERNAL_TRIGGER_DISABLE); // 禁用外部触发 /* 7. 使能ADC并校准 */ adc_enable(PORT_MS1100_ADC); delay_1ms(1); // 等待ADC稳定 adc_calibration_enable(PORT_MS1100_ADC); // ADC自校准（很重要！） /* 8. 启动转换 */ adc_software_trigger_enable(PORT_MS1100_ADC, ADC_REGULAR_CHANNEL); }

这里有几个容易出错的地方，我特别说明一下：

关于采样时间：ADC_SAMPLETIME_15表示采样保持时间为15个ADC时钟周期。对于MS1100这种变化不快的模拟信号，15个周期足够了。如果信号变化很快，可能需要增加采样时间。

关于校准：adc_calibration_enable()这个函数一定要调用！ADC模块内部有偏移误差，校准可以消除这个误差，让测量更准确。我刚开始调试时忘了校准，结果电压值总是偏几十毫伏。

关于触发方式：我们用的是软件触发（adc_software_trigger_enable），这样可以在需要的时候手动启动转换。如果设置成连续转换模式+软件触发，ADC会不停地转换，我们只需要读取最新的值就行。

3.4 ADC数据读取函数

ADC读取函数做了个简单的平均值滤波，提高数据稳定性：

unsigned int Get_ADC_Value(unsigned int num) { unsigned int Data = 0; int i = 0; for(i = 0; i < num; i++) { Data += adc_regular_data_read(ADC0); // 读取ADC值 delay_1ms(1); // 每次读取间隔1ms } Data = Data / num; // 计算平均值 return Data; }

这个函数的num参数表示采样次数。比如传30，就会连续读取30次ADC值，然后取平均。为什么要这么做？因为ADC读数会有微小波动，取平均值可以平滑这些波动，让数据更稳定。

实际使用中，我一般取20-30次平均，效果不错。如果对实时性要求高，可以适当减少次数。

3.5 数字输出读取函数

这个函数很简单，就是读取DOUT引脚的状态：

unsigned char Get_DO_Num(void) { if(MS1100_DO == 1) // 使用前面定义的宏读取引脚状态 { return 1; // DOUT为高，表示气体浓度超过阈值 } else { return 0; // DOUT为低，表示气体浓度正常 } }

模块上的可调电阻就是用来调整这个阈值的。顺时针拧电阻，阈值电压升高（更不容易触发）；逆时针拧，阈值电压降低（更容易触发）。你可以根据实际需求调整。

4. 在主函数中使用传感器

驱动写好了，现在看看怎么在主程序里调用。这里我写了一个完整的示例：

#include "gd32f4xx.h" #include "systick.h" #include "bsp_usart.h" #include "stdio.h" #include "bsp_ms1100.h" int main(void) { float voltage = 0; unsigned char gas_status = 0; // 系统初始化 nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2); // 中断优先级分组 systick_config(); // 系统滴答定时器，用于delay MS1100_GPIO_Init(); // MS1100初始化 usart_gpio_config(115200U); // 串口初始化，用于打印 printf("MS1100传感器测试开始\r\n"); printf("请等待3-5分钟传感器预热...\r\n"); // 等待传感器预热 delay_1ms(300000); // 等待5分钟（300秒） printf("预热完成，开始测量\r\n"); while(1) { // 1. 读取ADC值并转换为电压 // 采集30次取平均，提高稳定性 voltage = (Get_ADC_Value(30) / 4095.0) * 3.3; // 2. 读取数字输出状态 gas_status = Get_DO_Num(); // 3. 通过串口打印结果 printf("电压值: %.2fV, ", voltage); if(gas_status == 1) { printf("状态: 超标报警（LED亮）\r\n"); } else { printf("状态: 正常（LED灭）\r\n"); } // 4. 等待1秒后再次测量 delay_1ms(1000); } }

这里有几个实际操作中的要点：

预热等待：我用了delay_1ms(300000)来等待5分钟。在实际项目中，你可能需要更优雅的方式，比如用定时器计时，或者让系统先做其他初始化工作。

电压计算公式：(ADC值 / 4095.0) * 3.3。为什么是4095？因为ADC是12位的，最大值是2^12 - 1 = 4095。3.3是GD32F470的ADC参考电压（VREF+）。

打印格式：%.2f表示保留两位小数，对于电压值来说精度足够了。

5. 数据解读与浓度换算

现在能读到电压值了，但这个电压值代表什么浓度呢？这是最关键的一步。

5.1 理解传感器特性

MS1100的输出电压和气体浓度不是简单的线性关系。根据数据手册，它们的关系大致如下：

• 在清洁空气中（无目标气体）：电压 < 1.0V
• 随着气体浓度增加，电压逐渐升高
• 浓度越高，电压上升的趋势会变缓

具体到甲醛检测，需要参考传感器厂家提供的校准曲线。不同批次的传感器可能会有微小差异，所以最准确的方法是实际校准。

5.2 简单的浓度估算方法

如果你没有厂家的精确校准数据，可以先用这个经验公式估算：

// 简单的甲醛浓度估算（仅供参考，需要实际校准） float estimate_formaldehyde_concentration(float voltage) { float concentration = 0; if(voltage < 1.0) { concentration = 0; // 清洁空气 } else if(voltage < 1.5) { // 假设1.0V对应0ppm，1.5V对应0.5ppm concentration = (voltage - 1.0) * 1.0; } else if(voltage < 2.0) { // 假设1.5V对应0.5ppm，2.0V对应1.0ppm concentration = 0.5 + (voltage - 1.5) * 1.0; } else { // 更高浓度，增长变缓 concentration = 1.0 + (voltage - 2.0) * 0.5; } return concentration; }

重要提醒：这个公式是我根据典型特性估算的，只能作为参考！实际项目中一定要用标准气体进行校准，或者使用厂家提供的校准数据。

5.3 实际校准建议

如果你要做正式的产品，建议这样校准：

1. 准备标准气体：购买已知浓度的甲醛标准气体（如0.5ppm、1.0ppm）
2. 搭建测试环境：在密闭容器中通入标准气体
3. 记录数据：测量传感器在不同浓度下的输出电压
4. 建立曲线：用这些数据点拟合出电压-浓度曲线
5. 存储参数：把曲线参数（如斜率、截距）保存在单片机的Flash中

6. 调试技巧与常见问题

最后分享几个我在调试过程中遇到的坑和解决方法：

6.1 电压读数不稳定

现象：ADC读到的电压值跳变很大，每次读数都不一样。

可能原因和解决：

1. 电源噪声：确保给传感器供电的5V电源干净。可以在VCC和GND之间加一个100uF的电解电容和一个0.1uF的陶瓷电容。
2. ADC参考电压不稳：检查开发板的3.3V电源质量。
3. 采样次数不够：增加Get_ADC_Value()函数的采样次数，比如从30次增加到50次。
4. 软件滤波：在平均值滤波的基础上，可以加上滑动平均滤波或者中值滤波。

6.2 传感器响应慢

现象：气体浓度变化了，但传感器读数变化很慢。

可能原因：

1. 预热时间不足：确保预热3-5分钟，冬天可能需要更长时间。
2. 传感器老化：MS1100的寿命约2-3年，老化的传感器响应会变慢。
3. 物理保护：传感器表面的防尘网如果被灰尘堵塞，会影响响应速度。

6.3 DOUT状态不对

现象：明明浓度很高了，DOUT还是低电平（LED不亮）。

解决方法：

1. 调整可调电阻：用螺丝刀逆时针慢慢旋转模块上的蓝色可调电阻，降低触发阈值。
2. 检查接线：确认DOUT引脚确实接到了PF10，并且程序里读取的是正确的引脚。
3. 上拉电阻：程序中配置了上拉模式（GPIO_PUPD_PULLUP），如果硬件上也有上拉电阻，可能会冲突。

6.4 实际项目中的优化建议

1. 定期自检：每次上电后，先读取清洁空气中的电压值作为基准。
2. 温度补偿：半导体传感器受温度影响较大，如果项目环境温度变化大，建议加入温度传感器进行补偿。
3. 长期稳定性：长时间使用后，传感器会有漂移，建议定期（如每月）用清洁空气校准一次零点。
4. 多传感器融合：对于重要的环境监测，可以用2-3个传感器同时测量，取平均值或中值，提高可靠性。

按照上面的步骤，你应该能在梁山派GD32F470上成功驱动MS1100传感器了。实际测试时，可以用酒精棉片靠近传感器（不要直接接触），应该能看到电压明显上升，DOUT输出高电平，LED灯亮起。

这个方案我已经在几个室内空气质量监测的项目中用过，稳定性还不错。关键是价格便宜，MS1100模块才十几块钱，对于预算有限的项目来说是个不错的选择。