简介一套基于STM32单片机与MQ4气体传感器的天然气浓度监测报警系统完整工程代码面向嵌入式入门开发者及电子设计爱好者可用于家庭、工厂等场景的可燃气体泄漏检测。压缩包共232个文件大小仅6.48MB以C语言源码.c/.h、编译中间文件.o/.d/.crf及Keil工程文件.uvprojx为主并包含OLED驱动、定时器、ADC等底层模块源码结构清晰便于直接查阅与二次开发。目前已有588人学习下载。工程覆盖系统初始化、MQ4数据采集与阈值判断、OLED屏实时显示、蜂鸣器报警以及串口数据上传等核心环节代码注释与模块划分较规范可帮助读者快速掌握STM32的GPIO、ADC、I2C、串口等外设编程方法同时为完整的嵌入式软硬件联调提供实践参考。1. 从一颗甲烷传感器讲起为什么这个工程值得拆开看做嵌入式这几年真正把采集-处理-显示-报警-上报一条链路完整跑通的例子其实不多。很多项目停留在点灯或者读个温湿度一旦涉及模拟量前端、阈值联动和串口交互就暴露出各种接地问题。这个STM32MQ4OLED蜂鸣器的工程恰好覆盖了完整闭环MQ4输出模拟电压STM32通过ADC采样换算成浓度OLED实时绘制超限时蜂鸣器动作同时把数据送往串口调试助手。它看起来像一个课设实际却把工业气体报警器的最小可行模型做出来了——硬件上省掉了运放和比较器完全依赖MCU内部ADC和软件滤波这种做法的边界在哪里、精度能到多少、现场部署要改什么正是值得逐层拆解的内容。工程本身基于标准外设库而非HAL这对想从寄存器层面理解ADC和串口的人反而是优势。文件列表里的stm32f10x_adc.c、stm32f10x_tim.c、OLED.c和i2c驱动基本对应了该项目最核心的四个功能模块。接下来按硬件接线与初始化顺序→ADC采集与浓度换算→串口上报与OLED联动→蜂鸣器驱动与抗干扰这条路径展开代码可以直接抄参数也能直接改。2. 硬件选型与引脚分配先看懂这张接线表再动手MQ4传感器的输出特性决定了整个软件架构它内部是加热电阻和二氧化锡气敏层空气中甲烷浓度升高时电导率变化通过负载电阻转化为0~5V的模拟电压。注意MQ4模块分数字输出和模拟输出两路本项目必须接模拟输出通常标着AO数字输出DO只接比较器阈值精度完全不能用。STM32F103的ADC输入范围是0~3.3V所以MQ4模块的VCC不能接5V要接3.3V否则ADC会削顶。这是新手最容易摔的第一个跟头接5V供电、输出超过3.3V、ADC读数满量程、浓度曲线完全失真。OLED用的是I2C接口的0.96寸屏SSD1306控制器SDA和SCL分别接到PB7和PB6I2C1蜂鸣器建议用有源蜂鸣器接PC13高电平驱动即可——有源蜂鸣器内部带振荡源只要给电平就响不需要PWM。如果想用无源蜂鸣器就要把PC13改成TIM定时器输出PWM这个后面单独讲。以下是完整的引脚分配表照这个接线可以少走一半弯路外设引脚STM32端口说明MQ4模块AOPA1模拟输入接ADC1通道1MQ4模块VCC3.3V严禁接5V会超ADC量程OLEDSDAPB7I2C1数据线需上拉OLEDSCLPB6I2C1时钟线需上拉蜂鸣器I/OPC13高电平触发有源蜂鸣器串口TXPA9USART1发送接USB转TTL的RX串口RXPA10USART1接收接USB转TTL的TX地线GNDGND所有模块共地2.1 初始化顺序时钟、GPIO、ADC、I2C、USART一个都不能乱我见过很多人先初始化外设再配时钟结果I2C通信死活拉不起来。标准外设库的初始化顺序有一个隐性要求必须先开RCC时钟再配置GPIO模式最后初始化外设功能。下面这段是工程初始化逻辑的精简版覆盖了ADC和I2C的时钟使能关键点void Init_All_Peripherals(void) { // 1. 开启各外设时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_AFIO, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_USART1, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // 2. 配置调试端口释放PC13避免JTAG占用 GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 初始化USART1115200-8-N-1 USART_InitTypeDef usart; usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE); // 4. ADC1初始化PA1模拟输入软件触发单次转换 ADC_InitTypeDef adc; adc.ADC_Mode ADC_Mode_Independent; adc.ADC_ScanConvMode DISABLE; adc.ADC_ContinuousConvMode ENABLE; adc.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; adc.ADC_DataAlign ADC_DataAlign_Right; adc.ADC_NbrOfChannel 1; ADC_Init(ADC1, adc); ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); }逻辑说明时钟顺序上先APB2后APB1因为ADC1、USART1、GPIO都在APB2总线上而I2C1挂在APB1GPIO_Remap_SWJ_JTAGDisable这一行特别关键STM32F103的PC13默认被JTAG调试口占用不关闭JTAG复用PC13拉高会失败蜂鸣器永远不会响。采样时间取239.5个周期是针对MQ4这种高内阻传感器的常见配置——MQ4的输出阻抗在几K到几十K之间采样时间太短比如1.5周期会导致采样电容充不满ADC读数跳动剧烈。校准流程里ADC_Cmd之后要等校准完成位跳过这步读出的值会有固定偏移整个浓度曲线会整体平移。2.2 OLED的I2C地址与初始化0x78还是0x7A取决于模块电阻0.96寸OLED模块的I2C地址由背面的R8电阻决定默认是0x787位地址0x3C也有模块焊了R7变成0x7A。工程里OLED.c的初始化函数开头通常会有这个宏#define OLED_ADDRESS 0x78 // 如果显示乱码或没反应改成0x7A试试 static void OLED_WriteCmd(uint8_t cmd) { I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, OLED_ADDRESS, I2C_Direction_Transmitter); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); I2C_SendData(I2C1, 0x00); // 控制字节0x00表示后续是命令 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(I2C1, cmd); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_GenerateSTOP(I2C1, ENABLE); }逻辑说明这个函数是I2C写寄存器的标准时序——起始位、7位地址加写位、控制字节0x00代表后面跟的是命令0x40代表后面是显示数据、数据字节、停止位。每个步骤都有对应的事件标志位需要查询。0x78是8位地址形式它包含最后一位写标志0所以7位地址实际是0x3C。如果OLED没显示用逻辑分析仪抓I2C波形先看ACK位有没有拉低再看地址对不对硬件排查就这两步。初始化时序上SSD1306要求先发0xAE关显示、0x20设内存寻址模式推荐页寻址0x02这样逐页写数据不跳行、0xA8设多路复用比、0xD3设显示偏移、0x40设显示起始行、0x8D开电荷泵、0xA1段重映射完整序列大约30条命令工程里OLED_Init()已经写好不需要改唯一要确认的是地址和I2C速率工程一般设400K如果杜邦线超过20cm建议降到100K否则数据线振铃会导致花屏。3. ADC采样与浓度换算从原始值到PPM的完整链路MQ4的数据手册里有一条敏感度特性曲线横轴是气体浓度PPM纵轴是Rs/R0比值传感器电阻与清洁空气中电阻的比值并且是双对数坐标。这意味着ADC读到什么值对应多少PPM不能直接线性换算必须走对数插值或者查表。工程里常见的做法是分段线性插值在双对数坐标上取几个校准点然后按对数线性关系计算。先看最基础的ADC读取函数uint16_t MQ4_ReadADC(void) { ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); return ADC_GetConversionValue(ADC1); } float MQ4_GetVoltage(void) { uint16_t adc_val MQ4_ReadADC(); // STM32F103 ADC是12位参考电压3.3V return (float)adc_val * 3.3f / 4096.0f; }逻辑说明ADC_RegularChannelConfig在每次转换前重新配置通道是防止多通道切换时通道残留的稳妥写法——虽然本工程只有一路模拟输入但这样写让代码在后面加温湿度传感器时不用改结构。读取电压后下一步是换算Rs。MQ4模块的电路本质上是一个分压器气敏电阻Rs与负载电阻RL模块上通常印有10K标记串联3.3V供电时Vout 3.3 × RL / (Rs RL)所以推导出Rs RL × (3.3 - Vout) / Vout。这个公式的物理意义是Vout越高Rs越小说明气体浓度越大。注意Vout不能等于0否则分母为0所以MQ4上电后需要预热至少3分钟让Rs稳定在清洁空气的基准值R0附近这个预热时间直接影响零点的准确性。3.1 双对数坐标系下的浓度插值计算有了Rs/R0比值后浓度换算利用双对数坐标上的线性关系。数据手册给出的典型曲线可以用两个关键点近似甲烷在200PPM时Rs/R0约等于1.7在10000PPM时Rs/R0约等于0.5。在双对数坐标上这两个点确定一条直线浓度取对数后与Rs/R0的对数呈线性关系。代码实现就是用对数插值#define MQ4_RL 10.0f // 模块负载电阻单位KΩ #define MQ4_R0_CLEAN 9.8f // 清洁空气中实测Rs值预热后标定 float MQ4_GetRs(float voltage) { // 分压公式反推Rs RL * (Vcc - Vout) / Vout float rs MQ4_RL * (3.3f - voltage) / voltage; return rs; } float MQ4_GetPPM(float rs) { // 双对数坐标线性插值取(200, 1.7)和(10000, 0.5)两个校准点 float ratio rs / MQ4_R0_CLEAN; // 对数坐标下的斜率log(PPM) log(PPM1) (log(ratio) - log(ratio1)) // * (log(PPM2) - log(PPM1)) / (log(ratio2) - log(ratio1)) float slope (log(10000.0f) - log(200.0f)) / (log(0.5f) - log(1.7f)); float ppm exp(log(200.0f) (log(ratio) - log(1.7f)) * slope); // 低于下限直接截断 if (ppm 10.0f) ppm 0.0f; if (ppm 10000.0f) ppm 10000.0f; return ppm; }参数说明log和exp是C标准库的数学函数需要包含math.h编译时在Keil里勾选Use MicroLIB可以缩小浮点运算的代码体积。斜率是负数——浓度越高、比值越小所以斜率是负的这个负号保证了PPM随Rs/R0下降而上升。两个校准点决定精度但出厂模块和真实环境差异很大实际工程中应该在洁净空气下标定R0——把MQ4放到室外通风处上电预热10分钟后连续读50次Rs取平均值作为R0_CLEAN这个值每家模块都有差异范围大约在8K到15K之间不能用固定的9.8。另外还有一个工程技巧MQ4对温度湿度敏感同一浓度下夏天和冬天的读数可能偏差30%以上所以在严谨的检测设备里会加温湿度补偿本工程没有这个传感器只能靠软件滤波抵消部分噪声。3.2 滑动平均滤波为什么单次采样值不能直接用MQ4的模拟输出叠加了加热丝带来的工频噪声和气流扰动单次采样值跳动幅度可以达到±150mV换算成PPM就是几百的波动。直接拿这个值做阈值判断蜂鸣器会频繁误触发。工程里常见的处理是滑动平均滤波维护一个环形缓冲区每次采样替换最旧的数据再取均值#define FILTER_LEN 10 static uint16_t filter_buf[FILTER_LEN]; static uint8_t filter_index 0; uint16_t MQ4_ReadFiltered(void) { uint32_t sum 0; filter_buf[filter_index] MQ4_ReadADC(); filter_index (filter_index 1) % FILTER_LEN; for (int i 0; i FILTER_LEN; i) { sum filter_buf[i]; } return (uint16_t)(sum / FILTER_LEN); }逻辑说明环形缓冲区的巧妙之处在于只需要一次取模运算就能让索引回绕每次平均都遍历整个缓冲区计算量是O(N)级别N取10在72MHz主频下几乎不耗时。滤波长度与响应速度存在矛盾滤波窗口越大、曲线越平滑但对浓度突变的响应越慢。10次采样在连续转换模式下大约耗时10×239.5周期÷72MHz≈33微秒这个延迟可以忽略。但要注意如果开启连续转换模式且没有软件延时ADC会以最快速度刷新滤波缓冲区此时滤波窗口在时间轴上只覆盖几十微秒对工频噪声50Hz对应周期20ms没有任何抑制效果。正确的做法是控制采样间隔比如每100ms采样一次让滤波窗口覆盖1秒的噪声周期。实现方式可以在主循环加delay更稳妥的是用定时器触发ADC// TIM2定时100ms触发一次ADC转换伪代码示意 void TIM2_IRQHandler(void) { if (TIM_GetITStatus(TIM2, TIM_IT_Update)) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); uint16_t val MQ4_ReadFiltered(); float volt (float)val * 3.3f / 4096.0f; float rs MQ4_GetRs(volt); float ppm MQ4_GetPPM(rs); // 这里把ppm存到全局变量供主循环使用 } }参数说明定时器中断里做浮点计算是嵌入式开发要尽量避免的——如果PPM计算耗时超过中断周期会阻塞其他中断。更合理的拆分是中断里只采样和滤波整数运算主循环里做浮点换算、OLED刷新和串口发送。100ms的采样间隔对气体检测足够了甲烷扩散速度远慢于这个周期。如果要做更精细的滤波可以在滑动平均之后再加一阶低通滤波y[n] y[n-1] alpha × (x[n] - y[n-1])alpha取0.3左右这样能进一步压低脉冲噪声。4. 串口上报与OLED显示双通道输出的完整链路这个工程的价值在于它同时打通了人机界面和远程调试两条输出通道。OLED负责现场显示串口负责把数据交给上位机做记录和分析。两块功能在代码层面是独立的但共享同一份浓度数据所以数据流设计成定时器中断里采样滤波 → 全局变量存储 → 主循环里消费数据。主循环的结构决定了这个系统能不能扩展出按键设置阈值、Wi-Fi上报等功能——建议用状态机而不是顺序执行的while(1)。串口部分先用最基础的方式演示查询发送工程里的串口初始化已经配置好USART1的GPIO复用注意TXPA9要配置为AF_PP复用推挽RXPA10配置为IN_FLOATING浮空输入这个差异是GPIO模式的经典考点void USART1_SendString(char *str) { while (*str) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)(*str)); str; } // 等待发送完成避免最后一字节被关断 while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); } void Report_PPM(float ppm) { char buf[64]; // 格式CH4: 1250 PPM回车换行结尾 sprintf(buf, CH4: %.0f PPM\r\n, ppm); USART1_SendString(buf); }逻辑说明TXE标志位表示发送数据寄存器已空可以写入下一个字节TC标志位表示整个移位寄存器已经发送完毕。只等TXE就关USART的话最后一字节还在移位寄存器里没发出去上位机就会丢最后一个字符。sprintf的浮点格式化在MicroLIB下能正常工作但如果关闭了MicroLIB浮点会引入约1KB的代码开销建议格式化前先把浮点转成整数int ppm_int (int)(ppm 0.5f); // 四舍五入取整 sprintf(buf, CH4: %d PPM\r\n, ppm_int);4.1 串口调试助手乱码与数据格式115200-8-N-1必须对齐串口调试助手的设置界面里波特率必须与代码一致本工程是115200数据位8位、停止位1位、无校验也就是常说的115200-8-N-1。配置不对最常见的现象是收到一堆乱码——比如波特率差一点就会把每个字节的位错位显示成²Ä¸之类的变形字符。如果确认波特率正确但首字节丢失检查PA9的GPIO配置是不是复用推挽以及USB转TTL模块的TX/RX是否交叉连接——串口必须交叉接STM32的TX接模块的RXRX接模块的TX很多人在这里直接对接导致收不到数据。如果要在上位机做曲线监控建议把数据格式改成CSV方式便于XCOM或者sscom的图形化插件直接解析。XCOM的波形显示功能支持自定义分隔符所以代码可以改成这样void Report_PPM_CSV(float ppm, float voltage) { char buf[64]; int ppm_int (int)(ppm 0.5f); // 逗号分隔电压,浓度方便上位机按逗号拆分 sprintf(buf, %.2f,%d\r\n, voltage, ppm_int); USART1_SendString(buf); }4.2 OLED屏幕显示六位大字显示与自绘进度条OLED显示浓度比较直观的做法是把PPM值做粗体放大——OLED默认8×16字体只有像素点阵放大两倍需要自己写缩放函数。工程里如果提供的是标准库函数OLED_ShowString它内部是查字库点阵直接改大小不可行需要自己实现一个放大函数。另一种思路是保持数字不变在浓度超阈值时整屏变色反色显示这对现场告警更有效void OLED_ShowGasStatus(float ppm) { char buf[16]; int ppm_int (int)(ppm 0.5f); // 第一行标题 OLED_ShowString(0, 0, CH4 DETECTOR, 16); // 第二行浓度值5位数字 sprintf(buf, %05d, ppm_int); OLED_ShowString(10, 3, buf, 16); // 坐标(10,3)为中心两倍大字 // 第三行报警状态OLED自带反色显示 if (ppm_int 2000) { OLED_ShowString(0, 6, !! ALARM !!, 16); } else { OLED_ShowString(0, 6, SAFE , 16); } }OLED坐标说明0.96寸OLED是128×64像素OLED_ShowString的y参数一般取值0~7对应8页每页8像素高16号字体占两页高度。上述代码里(y3)实际是从第24像素行开始显示如果线宽超出64像素会截断所以显示字符串最多16个字符128÷816。反色显示需要SSD1306支持命令是0xA7反色和0xA6正常工程里可以加一个切换函数。OLED的刷新要注意一点SSD1306是写一次全屏刷新一次如果在主循环里高频刷新肉眼能看到闪烁。工程做法是只在数值变化超过一定范围时才刷新比如PPM变化超过10才更新屏幕显示这样既降低I2C总线负载也消除闪烁。4.3 主循环的调度逻辑按键、刷新、上报互不阻塞有了串口和OLED两个输出设备主循环如果串行执行刷新和上报每次sprintf加I2C写入会耗时好几个毫秒这期间如果有按键事件就会被漏掉。参考常见的做法主循环尽量用非阻塞条件判断而不是delayvolatile uint16_t g_adc_value 0; volatile uint8_t g_new_data_flag 0; int main(void) { Init_All_Peripherals(); OLED_Init(); OLED_Clear(); // 上电预热提示 OLED_ShowString(0, 0, WARM UP 3MIN, 16); uint32_t last_report 0; uint32_t last_display 0; while (1) { if (g_new_data_flag) { g_new_data_flag 0; float volt (float)g_adc_value * 3.3f / 4096.0f; float rs MQ4_GetRs(volt); float ppm MQ4_GetPPM(rs); // 串口每秒上报一次 if (HAL_GetTick() - last_report 1000) { Report_PPM_CSV(ppm, volt); last_report HAL_GetTick(); } // OLED每500ms刷新一次 if (HAL_GetTick() - last_display 500) { OLED_ShowGasStatus(ppm); last_display HAL_GetTick(); } // 阈值判断超过2000PPM拉高蜂鸣器 if (ppm 2000) { GPIO_SetBits(GPIOC, GPIO_Pin_13); } else { GPIO_ResetBits(GPIOC, GPIO_Pin_13); } } } }逻辑说明g_new_data_flag在定时器中断里置1主循环检测到标志后做数据处理。HAL_GetTick是HAL库的毫秒计数器标准外设库工程可以自己维护一个SysTick计数器实现同样的功能。这样设计的好处是每个外设的刷新节奏相互独立——串口1秒发一帧OLED 500ms刷一次屏蜂鸣器实时响应互不阻塞。如果要加阈值按键设置只需要在主循环里增加按键扫描分支。5. 无源蜂鸣器与PWM驱动从固定频率到音乐告警的进阶工程默认用的有源蜂鸣器接高低电平就能响但它的声音是单频的在嘈杂工厂环境里容易被环境噪声掩盖。无源蜂鸣器需要外部提供一定频率的方波才能发声频率不同音调就不同。这个进阶改造正好用上STM32的定时器PWM功能——工程文件列表里有stm32f10x_tim.c说明定时器资源已经预留。把PC13从GPIO输出改成TIM的PWM通道输出需要查引脚复用表PC13对应TIM8_CH1或者TIM1_CH1的复用功能但具体要用哪个得看芯片封装。更常见的做法是用PB0对应TIM3_CH3PB1对应TIM3_CH4这两个脚不需要重映射。接线改动也很小把蜂鸣器正极从PC13挪到PB0即可。无源蜂鸣器驱动频率和音调对应关系400Hz是低沉警报1000Hz是标准警报2000Hz是尖锐提示。实现多段报警可以利用定时器直接修改PWM频率不用重启定时器void Buzzer_SetFreq(uint16_t freq) { // 假设TIM3时钟72MHzPSC72-1那么计数频率1MHz // ARR 1000000 / freq uint16_t arr 1000000 / freq; TIM_SetAutoreload(TIM3, arr); // 占空比50% TIM_SetCompare3(TIM3, arr / 2); }5.1 非阻塞的报警旋律不用delay也能播放多段音调如果想让报警声音有节奏感比如响0.2秒、停0.2秒、再响0.5秒常见做法是维护一个音符序列在定时器中断里切换频率。这种设计让主循环完全不需要照顾蜂鸣器在工业现场非常实用——报警的同时主循环还能继续刷新屏幕、上报串口// 报警音序频率(Hz), 持续时间(ms)0表示结束 const uint16_t alarm_seq[][2] { {1000, 200}, {0, 150}, {1500, 200}, {0, 150}, {0, 0} }; volatile uint8_t alarm_seq_index 0; volatile uint16_t alarm_tick 0; void Buzzer_Update(void) { if (alarm_seq_index 5) return; // 播完则停 if (alarm_tick alarm_seq[alarm_seq_index][1]) { alarm_tick 0; alarm_seq_index; if (alarm_seq_index 5) { TIM_Cmd(TIM3, DISABLE); // 停止PWM输出 return; } uint16_t f alarm_seq[alarm_seq_index][0]; if (f 0) { TIM_Cmd(TIM3, DISABLE); // 静音段 } else { Buzzer_SetFreq(f); TIM_Cmd(TIM3, ENABLE); } } }参数说明alarm_tick在SysTick中断里每1ms加一次这样整个音序的时基从主循环中解耦。如果同时有多个报警级别可以把alarm_seq数组扩展成二维按不同浓度区间选择不同的旋律——比如浓度超过2000PPM用急促音超过5000PPM用持续长音。这套逻辑本质上就是简易的播放器状态机理解了它后面再扩展播放一段音乐旋律也只是改数组内容的事。注意无源蜂鸣器驱动电流大约30mASTM32的GPIO灌电流能力有限如果直接用引脚驱动蜂鸣器可能会拉低VDD导致MCU复位建议加一个NPN三极管如S8050做开关基极串联1K电阻集电极接蜂鸣器负极发射极接地蜂鸣器正极接3.3V——这是无源蜂鸣器电路图里比较标准的驱动结构。5.2 阈值与回差防止临界浓度时蜂鸣器反复通断气体浓度在阈值附近波动时如果代码只做简单的超过就响、低于就关会出现蜂鸣器几十秒内反复通断的抖动现象。解决方法是引入回差滞回比较浓度超过上限比如2000PPM才启动报警但必须回落到下限比如1500PPM才停止报警。这个差值400PPM就是回差带宽度要大于噪声波动幅度但不能太大否则实际已经安全了报警还在响。#define ALARM_ON_THRESHOLD 2000 // 报警启动阈值PPM #define ALARM_OFF_THRESHOLD 1500 // 报警解除阈值PPM uint8_t alarm_active 0; void Update_Alarm(float ppm) { if (alarm_active 0) { if (ppm ALARM_ON_THRESHOLD) { alarm_active 1; alarm_seq_index 0; alarm_tick 0; TIM_Cmd(TIM3, ENABLE); } } else { if (ppm ALARM_OFF_THRESHOLD) { alarm_active 0; TIM_Cmd(TIM3, DISABLE); } } // 把报警状态发到串口方便上位机记录 if (alarm_active) { USART1_SendString(ALARM ACTIVE\r\n); } }这个回差机制的实际意义在于如果现场很安静、没有人在附近反复通断的蜂鸣器只会加速继电器和蜂鸣器老化更重要的是持续报警比断续报警更容易被注意。回差值要根据MQ4的噪声水平标定通常是阈值的10%~20%。调试时在串口调试助手里观察浓度曲线如果发现某个PPM值附近频繁跨越阈值就把回差加大到噪声峰峰值的2倍。6. 现场标定与串口日志分析让测量数据可信的最后一步把工程跑通很容易难的是让测出来的浓度值可靠。MQ4出厂特性一致性差同一个浓度的气体不同模块输出的电压可能差30%。所以任何交付给客户或者写进论文的数据都要经过现场标定。标定的核心是修正R0找一个确定是洁净空气的环境比如室外通风处让系统预热至少10分钟——MQ4内部加热丝需要这么长时间达到热平衡之后连续记录200个Rs值取中位数作为R0_CLEAN。注意这里要用中位数不是平均值因为环境里偶尔飘来的汽车尾气会产生尖峰平均值会被拉偏中位数天然抗离群点。标定完成后建议做一次响应测试用打火机放气不点火靠近传感器观察串口输出的PPM曲线。正常应该在5秒内开始上升松开后20~60秒回落。这个过程用串口调试助手记录日志可以把数据导出成TXT再导入Excel画曲线。一个简单的验证方法是计算从10%上升到90%响应值的时间MQ4对甲烷的响应时间通常在10秒以内如果超过30秒才响应说明传感器的加热电压不对或者采样的滤波窗口太大——检查是不是把采样间隔改成了1秒导致每个数据点是上一秒的平均、掩盖了快速变化。关于标定的精度极限要说清楚MQ4本身不是精密仪器它的精度在±20%以内就算合格用来做是否泄漏的定性判断足够但不要把它当成计量级仪器去出检测报告。如果需要精确浓度数据应该换电化学传感器或者红外传感器比如MH-Z14代码结构只需改采集函数——因为工程已经做了数据分层采集在中断、换算在函数、显示上报在主循环替换传感器时只需要改MQ4_GetRs和MQ4_GetPPM两个函数后面的链路基本不用动。最后补一个验证手段在串口调试助手里开启时间戳功能每隔1秒记录一条数据持续运行一晚上第二天看曲线是否平稳。如果夜间曲线波动超过±50PPM检查供电是不是用了USB供电导致纹波大如果曲线缓慢漂移可能是加热丝老化或者环境温湿度变化需要在代码里加周期性自校准——比如每隔24小时在凌晨自动把当前Rs作为新的R0这样系统就不怕季节变化了。本文还有配套的精品资源点击获取
STM32+MQ4气体检测报警器：ADC采样、OLED显示与串口上报全链路实现
简介一套基于STM32单片机与MQ4气体传感器的天然气浓度监测报警系统完整工程代码面向嵌入式入门开发者及电子设计爱好者可用于家庭、工厂等场景的可燃气体泄漏检测。压缩包共232个文件大小仅6.48MB以C语言源码.c/.h、编译中间文件.o/.d/.crf及Keil工程文件.uvprojx为主并包含OLED驱动、定时器、ADC等底层模块源码结构清晰便于直接查阅与二次开发。目前已有588人学习下载。工程覆盖系统初始化、MQ4数据采集与阈值判断、OLED屏实时显示、蜂鸣器报警以及串口数据上传等核心环节代码注释与模块划分较规范可帮助读者快速掌握STM32的GPIO、ADC、I2C、串口等外设编程方法同时为完整的嵌入式软硬件联调提供实践参考。1. 从一颗甲烷传感器讲起为什么这个工程值得拆开看做嵌入式这几年真正把采集-处理-显示-报警-上报一条链路完整跑通的例子其实不多。很多项目停留在点灯或者读个温湿度一旦涉及模拟量前端、阈值联动和串口交互就暴露出各种接地问题。这个STM32MQ4OLED蜂鸣器的工程恰好覆盖了完整闭环MQ4输出模拟电压STM32通过ADC采样换算成浓度OLED实时绘制超限时蜂鸣器动作同时把数据送往串口调试助手。它看起来像一个课设实际却把工业气体报警器的最小可行模型做出来了——硬件上省掉了运放和比较器完全依赖MCU内部ADC和软件滤波这种做法的边界在哪里、精度能到多少、现场部署要改什么正是值得逐层拆解的内容。工程本身基于标准外设库而非HAL这对想从寄存器层面理解ADC和串口的人反而是优势。文件列表里的stm32f10x_adc.c、stm32f10x_tim.c、OLED.c和i2c驱动基本对应了该项目最核心的四个功能模块。接下来按硬件接线与初始化顺序→ADC采集与浓度换算→串口上报与OLED联动→蜂鸣器驱动与抗干扰这条路径展开代码可以直接抄参数也能直接改。2. 硬件选型与引脚分配先看懂这张接线表再动手MQ4传感器的输出特性决定了整个软件架构它内部是加热电阻和二氧化锡气敏层空气中甲烷浓度升高时电导率变化通过负载电阻转化为0~5V的模拟电压。注意MQ4模块分数字输出和模拟输出两路本项目必须接模拟输出通常标着AO数字输出DO只接比较器阈值精度完全不能用。STM32F103的ADC输入范围是0~3.3V所以MQ4模块的VCC不能接5V要接3.3V否则ADC会削顶。这是新手最容易摔的第一个跟头接5V供电、输出超过3.3V、ADC读数满量程、浓度曲线完全失真。OLED用的是I2C接口的0.96寸屏SSD1306控制器SDA和SCL分别接到PB7和PB6I2C1蜂鸣器建议用有源蜂鸣器接PC13高电平驱动即可——有源蜂鸣器内部带振荡源只要给电平就响不需要PWM。如果想用无源蜂鸣器就要把PC13改成TIM定时器输出PWM这个后面单独讲。以下是完整的引脚分配表照这个接线可以少走一半弯路外设引脚STM32端口说明MQ4模块AOPA1模拟输入接ADC1通道1MQ4模块VCC3.3V严禁接5V会超ADC量程OLEDSDAPB7I2C1数据线需上拉OLEDSCLPB6I2C1时钟线需上拉蜂鸣器I/OPC13高电平触发有源蜂鸣器串口TXPA9USART1发送接USB转TTL的RX串口RXPA10USART1接收接USB转TTL的TX地线GNDGND所有模块共地2.1 初始化顺序时钟、GPIO、ADC、I2C、USART一个都不能乱我见过很多人先初始化外设再配时钟结果I2C通信死活拉不起来。标准外设库的初始化顺序有一个隐性要求必须先开RCC时钟再配置GPIO模式最后初始化外设功能。下面这段是工程初始化逻辑的精简版覆盖了ADC和I2C的时钟使能关键点void Init_All_Peripherals(void) { // 1. 开启各外设时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOC | RCC_APB2Periph_AFIO, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_USART1, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // 2. 配置调试端口释放PC13避免JTAG占用 GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 初始化USART1115200-8-N-1 USART_InitTypeDef usart; usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE); // 4. ADC1初始化PA1模拟输入软件触发单次转换 ADC_InitTypeDef adc; adc.ADC_Mode ADC_Mode_Independent; adc.ADC_ScanConvMode DISABLE; adc.ADC_ContinuousConvMode ENABLE; adc.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; adc.ADC_DataAlign ADC_DataAlign_Right; adc.ADC_NbrOfChannel 1; ADC_Init(ADC1, adc); ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); }逻辑说明时钟顺序上先APB2后APB1因为ADC1、USART1、GPIO都在APB2总线上而I2C1挂在APB1GPIO_Remap_SWJ_JTAGDisable这一行特别关键STM32F103的PC13默认被JTAG调试口占用不关闭JTAG复用PC13拉高会失败蜂鸣器永远不会响。采样时间取239.5个周期是针对MQ4这种高内阻传感器的常见配置——MQ4的输出阻抗在几K到几十K之间采样时间太短比如1.5周期会导致采样电容充不满ADC读数跳动剧烈。校准流程里ADC_Cmd之后要等校准完成位跳过这步读出的值会有固定偏移整个浓度曲线会整体平移。2.2 OLED的I2C地址与初始化0x78还是0x7A取决于模块电阻0.96寸OLED模块的I2C地址由背面的R8电阻决定默认是0x787位地址0x3C也有模块焊了R7变成0x7A。工程里OLED.c的初始化函数开头通常会有这个宏#define OLED_ADDRESS 0x78 // 如果显示乱码或没反应改成0x7A试试 static void OLED_WriteCmd(uint8_t cmd) { I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, OLED_ADDRESS, I2C_Direction_Transmitter); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); I2C_SendData(I2C1, 0x00); // 控制字节0x00表示后续是命令 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(I2C1, cmd); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_GenerateSTOP(I2C1, ENABLE); }逻辑说明这个函数是I2C写寄存器的标准时序——起始位、7位地址加写位、控制字节0x00代表后面跟的是命令0x40代表后面是显示数据、数据字节、停止位。每个步骤都有对应的事件标志位需要查询。0x78是8位地址形式它包含最后一位写标志0所以7位地址实际是0x3C。如果OLED没显示用逻辑分析仪抓I2C波形先看ACK位有没有拉低再看地址对不对硬件排查就这两步。初始化时序上SSD1306要求先发0xAE关显示、0x20设内存寻址模式推荐页寻址0x02这样逐页写数据不跳行、0xA8设多路复用比、0xD3设显示偏移、0x40设显示起始行、0x8D开电荷泵、0xA1段重映射完整序列大约30条命令工程里OLED_Init()已经写好不需要改唯一要确认的是地址和I2C速率工程一般设400K如果杜邦线超过20cm建议降到100K否则数据线振铃会导致花屏。3. ADC采样与浓度换算从原始值到PPM的完整链路MQ4的数据手册里有一条敏感度特性曲线横轴是气体浓度PPM纵轴是Rs/R0比值传感器电阻与清洁空气中电阻的比值并且是双对数坐标。这意味着ADC读到什么值对应多少PPM不能直接线性换算必须走对数插值或者查表。工程里常见的做法是分段线性插值在双对数坐标上取几个校准点然后按对数线性关系计算。先看最基础的ADC读取函数uint16_t MQ4_ReadADC(void) { ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); return ADC_GetConversionValue(ADC1); } float MQ4_GetVoltage(void) { uint16_t adc_val MQ4_ReadADC(); // STM32F103 ADC是12位参考电压3.3V return (float)adc_val * 3.3f / 4096.0f; }逻辑说明ADC_RegularChannelConfig在每次转换前重新配置通道是防止多通道切换时通道残留的稳妥写法——虽然本工程只有一路模拟输入但这样写让代码在后面加温湿度传感器时不用改结构。读取电压后下一步是换算Rs。MQ4模块的电路本质上是一个分压器气敏电阻Rs与负载电阻RL模块上通常印有10K标记串联3.3V供电时Vout 3.3 × RL / (Rs RL)所以推导出Rs RL × (3.3 - Vout) / Vout。这个公式的物理意义是Vout越高Rs越小说明气体浓度越大。注意Vout不能等于0否则分母为0所以MQ4上电后需要预热至少3分钟让Rs稳定在清洁空气的基准值R0附近这个预热时间直接影响零点的准确性。3.1 双对数坐标系下的浓度插值计算有了Rs/R0比值后浓度换算利用双对数坐标上的线性关系。数据手册给出的典型曲线可以用两个关键点近似甲烷在200PPM时Rs/R0约等于1.7在10000PPM时Rs/R0约等于0.5。在双对数坐标上这两个点确定一条直线浓度取对数后与Rs/R0的对数呈线性关系。代码实现就是用对数插值#define MQ4_RL 10.0f // 模块负载电阻单位KΩ #define MQ4_R0_CLEAN 9.8f // 清洁空气中实测Rs值预热后标定 float MQ4_GetRs(float voltage) { // 分压公式反推Rs RL * (Vcc - Vout) / Vout float rs MQ4_RL * (3.3f - voltage) / voltage; return rs; } float MQ4_GetPPM(float rs) { // 双对数坐标线性插值取(200, 1.7)和(10000, 0.5)两个校准点 float ratio rs / MQ4_R0_CLEAN; // 对数坐标下的斜率log(PPM) log(PPM1) (log(ratio) - log(ratio1)) // * (log(PPM2) - log(PPM1)) / (log(ratio2) - log(ratio1)) float slope (log(10000.0f) - log(200.0f)) / (log(0.5f) - log(1.7f)); float ppm exp(log(200.0f) (log(ratio) - log(1.7f)) * slope); // 低于下限直接截断 if (ppm 10.0f) ppm 0.0f; if (ppm 10000.0f) ppm 10000.0f; return ppm; }参数说明log和exp是C标准库的数学函数需要包含math.h编译时在Keil里勾选Use MicroLIB可以缩小浮点运算的代码体积。斜率是负数——浓度越高、比值越小所以斜率是负的这个负号保证了PPM随Rs/R0下降而上升。两个校准点决定精度但出厂模块和真实环境差异很大实际工程中应该在洁净空气下标定R0——把MQ4放到室外通风处上电预热10分钟后连续读50次Rs取平均值作为R0_CLEAN这个值每家模块都有差异范围大约在8K到15K之间不能用固定的9.8。另外还有一个工程技巧MQ4对温度湿度敏感同一浓度下夏天和冬天的读数可能偏差30%以上所以在严谨的检测设备里会加温湿度补偿本工程没有这个传感器只能靠软件滤波抵消部分噪声。3.2 滑动平均滤波为什么单次采样值不能直接用MQ4的模拟输出叠加了加热丝带来的工频噪声和气流扰动单次采样值跳动幅度可以达到±150mV换算成PPM就是几百的波动。直接拿这个值做阈值判断蜂鸣器会频繁误触发。工程里常见的处理是滑动平均滤波维护一个环形缓冲区每次采样替换最旧的数据再取均值#define FILTER_LEN 10 static uint16_t filter_buf[FILTER_LEN]; static uint8_t filter_index 0; uint16_t MQ4_ReadFiltered(void) { uint32_t sum 0; filter_buf[filter_index] MQ4_ReadADC(); filter_index (filter_index 1) % FILTER_LEN; for (int i 0; i FILTER_LEN; i) { sum filter_buf[i]; } return (uint16_t)(sum / FILTER_LEN); }逻辑说明环形缓冲区的巧妙之处在于只需要一次取模运算就能让索引回绕每次平均都遍历整个缓冲区计算量是O(N)级别N取10在72MHz主频下几乎不耗时。滤波长度与响应速度存在矛盾滤波窗口越大、曲线越平滑但对浓度突变的响应越慢。10次采样在连续转换模式下大约耗时10×239.5周期÷72MHz≈33微秒这个延迟可以忽略。但要注意如果开启连续转换模式且没有软件延时ADC会以最快速度刷新滤波缓冲区此时滤波窗口在时间轴上只覆盖几十微秒对工频噪声50Hz对应周期20ms没有任何抑制效果。正确的做法是控制采样间隔比如每100ms采样一次让滤波窗口覆盖1秒的噪声周期。实现方式可以在主循环加delay更稳妥的是用定时器触发ADC// TIM2定时100ms触发一次ADC转换伪代码示意 void TIM2_IRQHandler(void) { if (TIM_GetITStatus(TIM2, TIM_IT_Update)) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); uint16_t val MQ4_ReadFiltered(); float volt (float)val * 3.3f / 4096.0f; float rs MQ4_GetRs(volt); float ppm MQ4_GetPPM(rs); // 这里把ppm存到全局变量供主循环使用 } }参数说明定时器中断里做浮点计算是嵌入式开发要尽量避免的——如果PPM计算耗时超过中断周期会阻塞其他中断。更合理的拆分是中断里只采样和滤波整数运算主循环里做浮点换算、OLED刷新和串口发送。100ms的采样间隔对气体检测足够了甲烷扩散速度远慢于这个周期。如果要做更精细的滤波可以在滑动平均之后再加一阶低通滤波y[n] y[n-1] alpha × (x[n] - y[n-1])alpha取0.3左右这样能进一步压低脉冲噪声。4. 串口上报与OLED显示双通道输出的完整链路这个工程的价值在于它同时打通了人机界面和远程调试两条输出通道。OLED负责现场显示串口负责把数据交给上位机做记录和分析。两块功能在代码层面是独立的但共享同一份浓度数据所以数据流设计成定时器中断里采样滤波 → 全局变量存储 → 主循环里消费数据。主循环的结构决定了这个系统能不能扩展出按键设置阈值、Wi-Fi上报等功能——建议用状态机而不是顺序执行的while(1)。串口部分先用最基础的方式演示查询发送工程里的串口初始化已经配置好USART1的GPIO复用注意TXPA9要配置为AF_PP复用推挽RXPA10配置为IN_FLOATING浮空输入这个差异是GPIO模式的经典考点void USART1_SendString(char *str) { while (*str) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)(*str)); str; } // 等待发送完成避免最后一字节被关断 while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); } void Report_PPM(float ppm) { char buf[64]; // 格式CH4: 1250 PPM回车换行结尾 sprintf(buf, CH4: %.0f PPM\r\n, ppm); USART1_SendString(buf); }逻辑说明TXE标志位表示发送数据寄存器已空可以写入下一个字节TC标志位表示整个移位寄存器已经发送完毕。只等TXE就关USART的话最后一字节还在移位寄存器里没发出去上位机就会丢最后一个字符。sprintf的浮点格式化在MicroLIB下能正常工作但如果关闭了MicroLIB浮点会引入约1KB的代码开销建议格式化前先把浮点转成整数int ppm_int (int)(ppm 0.5f); // 四舍五入取整 sprintf(buf, CH4: %d PPM\r\n, ppm_int);4.1 串口调试助手乱码与数据格式115200-8-N-1必须对齐串口调试助手的设置界面里波特率必须与代码一致本工程是115200数据位8位、停止位1位、无校验也就是常说的115200-8-N-1。配置不对最常见的现象是收到一堆乱码——比如波特率差一点就会把每个字节的位错位显示成²Ä¸之类的变形字符。如果确认波特率正确但首字节丢失检查PA9的GPIO配置是不是复用推挽以及USB转TTL模块的TX/RX是否交叉连接——串口必须交叉接STM32的TX接模块的RXRX接模块的TX很多人在这里直接对接导致收不到数据。如果要在上位机做曲线监控建议把数据格式改成CSV方式便于XCOM或者sscom的图形化插件直接解析。XCOM的波形显示功能支持自定义分隔符所以代码可以改成这样void Report_PPM_CSV(float ppm, float voltage) { char buf[64]; int ppm_int (int)(ppm 0.5f); // 逗号分隔电压,浓度方便上位机按逗号拆分 sprintf(buf, %.2f,%d\r\n, voltage, ppm_int); USART1_SendString(buf); }4.2 OLED屏幕显示六位大字显示与自绘进度条OLED显示浓度比较直观的做法是把PPM值做粗体放大——OLED默认8×16字体只有像素点阵放大两倍需要自己写缩放函数。工程里如果提供的是标准库函数OLED_ShowString它内部是查字库点阵直接改大小不可行需要自己实现一个放大函数。另一种思路是保持数字不变在浓度超阈值时整屏变色反色显示这对现场告警更有效void OLED_ShowGasStatus(float ppm) { char buf[16]; int ppm_int (int)(ppm 0.5f); // 第一行标题 OLED_ShowString(0, 0, CH4 DETECTOR, 16); // 第二行浓度值5位数字 sprintf(buf, %05d, ppm_int); OLED_ShowString(10, 3, buf, 16); // 坐标(10,3)为中心两倍大字 // 第三行报警状态OLED自带反色显示 if (ppm_int 2000) { OLED_ShowString(0, 6, !! ALARM !!, 16); } else { OLED_ShowString(0, 6, SAFE , 16); } }OLED坐标说明0.96寸OLED是128×64像素OLED_ShowString的y参数一般取值0~7对应8页每页8像素高16号字体占两页高度。上述代码里(y3)实际是从第24像素行开始显示如果线宽超出64像素会截断所以显示字符串最多16个字符128÷816。反色显示需要SSD1306支持命令是0xA7反色和0xA6正常工程里可以加一个切换函数。OLED的刷新要注意一点SSD1306是写一次全屏刷新一次如果在主循环里高频刷新肉眼能看到闪烁。工程做法是只在数值变化超过一定范围时才刷新比如PPM变化超过10才更新屏幕显示这样既降低I2C总线负载也消除闪烁。4.3 主循环的调度逻辑按键、刷新、上报互不阻塞有了串口和OLED两个输出设备主循环如果串行执行刷新和上报每次sprintf加I2C写入会耗时好几个毫秒这期间如果有按键事件就会被漏掉。参考常见的做法主循环尽量用非阻塞条件判断而不是delayvolatile uint16_t g_adc_value 0; volatile uint8_t g_new_data_flag 0; int main(void) { Init_All_Peripherals(); OLED_Init(); OLED_Clear(); // 上电预热提示 OLED_ShowString(0, 0, WARM UP 3MIN, 16); uint32_t last_report 0; uint32_t last_display 0; while (1) { if (g_new_data_flag) { g_new_data_flag 0; float volt (float)g_adc_value * 3.3f / 4096.0f; float rs MQ4_GetRs(volt); float ppm MQ4_GetPPM(rs); // 串口每秒上报一次 if (HAL_GetTick() - last_report 1000) { Report_PPM_CSV(ppm, volt); last_report HAL_GetTick(); } // OLED每500ms刷新一次 if (HAL_GetTick() - last_display 500) { OLED_ShowGasStatus(ppm); last_display HAL_GetTick(); } // 阈值判断超过2000PPM拉高蜂鸣器 if (ppm 2000) { GPIO_SetBits(GPIOC, GPIO_Pin_13); } else { GPIO_ResetBits(GPIOC, GPIO_Pin_13); } } } }逻辑说明g_new_data_flag在定时器中断里置1主循环检测到标志后做数据处理。HAL_GetTick是HAL库的毫秒计数器标准外设库工程可以自己维护一个SysTick计数器实现同样的功能。这样设计的好处是每个外设的刷新节奏相互独立——串口1秒发一帧OLED 500ms刷一次屏蜂鸣器实时响应互不阻塞。如果要加阈值按键设置只需要在主循环里增加按键扫描分支。5. 无源蜂鸣器与PWM驱动从固定频率到音乐告警的进阶工程默认用的有源蜂鸣器接高低电平就能响但它的声音是单频的在嘈杂工厂环境里容易被环境噪声掩盖。无源蜂鸣器需要外部提供一定频率的方波才能发声频率不同音调就不同。这个进阶改造正好用上STM32的定时器PWM功能——工程文件列表里有stm32f10x_tim.c说明定时器资源已经预留。把PC13从GPIO输出改成TIM的PWM通道输出需要查引脚复用表PC13对应TIM8_CH1或者TIM1_CH1的复用功能但具体要用哪个得看芯片封装。更常见的做法是用PB0对应TIM3_CH3PB1对应TIM3_CH4这两个脚不需要重映射。接线改动也很小把蜂鸣器正极从PC13挪到PB0即可。无源蜂鸣器驱动频率和音调对应关系400Hz是低沉警报1000Hz是标准警报2000Hz是尖锐提示。实现多段报警可以利用定时器直接修改PWM频率不用重启定时器void Buzzer_SetFreq(uint16_t freq) { // 假设TIM3时钟72MHzPSC72-1那么计数频率1MHz // ARR 1000000 / freq uint16_t arr 1000000 / freq; TIM_SetAutoreload(TIM3, arr); // 占空比50% TIM_SetCompare3(TIM3, arr / 2); }5.1 非阻塞的报警旋律不用delay也能播放多段音调如果想让报警声音有节奏感比如响0.2秒、停0.2秒、再响0.5秒常见做法是维护一个音符序列在定时器中断里切换频率。这种设计让主循环完全不需要照顾蜂鸣器在工业现场非常实用——报警的同时主循环还能继续刷新屏幕、上报串口// 报警音序频率(Hz), 持续时间(ms)0表示结束 const uint16_t alarm_seq[][2] { {1000, 200}, {0, 150}, {1500, 200}, {0, 150}, {0, 0} }; volatile uint8_t alarm_seq_index 0; volatile uint16_t alarm_tick 0; void Buzzer_Update(void) { if (alarm_seq_index 5) return; // 播完则停 if (alarm_tick alarm_seq[alarm_seq_index][1]) { alarm_tick 0; alarm_seq_index; if (alarm_seq_index 5) { TIM_Cmd(TIM3, DISABLE); // 停止PWM输出 return; } uint16_t f alarm_seq[alarm_seq_index][0]; if (f 0) { TIM_Cmd(TIM3, DISABLE); // 静音段 } else { Buzzer_SetFreq(f); TIM_Cmd(TIM3, ENABLE); } } }参数说明alarm_tick在SysTick中断里每1ms加一次这样整个音序的时基从主循环中解耦。如果同时有多个报警级别可以把alarm_seq数组扩展成二维按不同浓度区间选择不同的旋律——比如浓度超过2000PPM用急促音超过5000PPM用持续长音。这套逻辑本质上就是简易的播放器状态机理解了它后面再扩展播放一段音乐旋律也只是改数组内容的事。注意无源蜂鸣器驱动电流大约30mASTM32的GPIO灌电流能力有限如果直接用引脚驱动蜂鸣器可能会拉低VDD导致MCU复位建议加一个NPN三极管如S8050做开关基极串联1K电阻集电极接蜂鸣器负极发射极接地蜂鸣器正极接3.3V——这是无源蜂鸣器电路图里比较标准的驱动结构。5.2 阈值与回差防止临界浓度时蜂鸣器反复通断气体浓度在阈值附近波动时如果代码只做简单的超过就响、低于就关会出现蜂鸣器几十秒内反复通断的抖动现象。解决方法是引入回差滞回比较浓度超过上限比如2000PPM才启动报警但必须回落到下限比如1500PPM才停止报警。这个差值400PPM就是回差带宽度要大于噪声波动幅度但不能太大否则实际已经安全了报警还在响。#define ALARM_ON_THRESHOLD 2000 // 报警启动阈值PPM #define ALARM_OFF_THRESHOLD 1500 // 报警解除阈值PPM uint8_t alarm_active 0; void Update_Alarm(float ppm) { if (alarm_active 0) { if (ppm ALARM_ON_THRESHOLD) { alarm_active 1; alarm_seq_index 0; alarm_tick 0; TIM_Cmd(TIM3, ENABLE); } } else { if (ppm ALARM_OFF_THRESHOLD) { alarm_active 0; TIM_Cmd(TIM3, DISABLE); } } // 把报警状态发到串口方便上位机记录 if (alarm_active) { USART1_SendString(ALARM ACTIVE\r\n); } }这个回差机制的实际意义在于如果现场很安静、没有人在附近反复通断的蜂鸣器只会加速继电器和蜂鸣器老化更重要的是持续报警比断续报警更容易被注意。回差值要根据MQ4的噪声水平标定通常是阈值的10%~20%。调试时在串口调试助手里观察浓度曲线如果发现某个PPM值附近频繁跨越阈值就把回差加大到噪声峰峰值的2倍。6. 现场标定与串口日志分析让测量数据可信的最后一步把工程跑通很容易难的是让测出来的浓度值可靠。MQ4出厂特性一致性差同一个浓度的气体不同模块输出的电压可能差30%。所以任何交付给客户或者写进论文的数据都要经过现场标定。标定的核心是修正R0找一个确定是洁净空气的环境比如室外通风处让系统预热至少10分钟——MQ4内部加热丝需要这么长时间达到热平衡之后连续记录200个Rs值取中位数作为R0_CLEAN。注意这里要用中位数不是平均值因为环境里偶尔飘来的汽车尾气会产生尖峰平均值会被拉偏中位数天然抗离群点。标定完成后建议做一次响应测试用打火机放气不点火靠近传感器观察串口输出的PPM曲线。正常应该在5秒内开始上升松开后20~60秒回落。这个过程用串口调试助手记录日志可以把数据导出成TXT再导入Excel画曲线。一个简单的验证方法是计算从10%上升到90%响应值的时间MQ4对甲烷的响应时间通常在10秒以内如果超过30秒才响应说明传感器的加热电压不对或者采样的滤波窗口太大——检查是不是把采样间隔改成了1秒导致每个数据点是上一秒的平均、掩盖了快速变化。关于标定的精度极限要说清楚MQ4本身不是精密仪器它的精度在±20%以内就算合格用来做是否泄漏的定性判断足够但不要把它当成计量级仪器去出检测报告。如果需要精确浓度数据应该换电化学传感器或者红外传感器比如MH-Z14代码结构只需改采集函数——因为工程已经做了数据分层采集在中断、换算在函数、显示上报在主循环替换传感器时只需要改MQ4_GetRs和MQ4_GetPPM两个函数后面的链路基本不用动。最后补一个验证手段在串口调试助手里开启时间戳功能每隔1秒记录一条数据持续运行一晚上第二天看曲线是否平稳。如果夜间曲线波动超过±50PPM检查供电是不是用了USB供电导致纹波大如果曲线缓慢漂移可能是加热丝老化或者环境温湿度变化需要在代码里加周期性自校准——比如每隔24小时在凌晨自动把当前Rs作为新的R0这样系统就不怕季节变化了。本文还有配套的精品资源点击获取
