把HC-SR501接到STM32F103C8T6上再把检测结果实时刷到OLED屏幕这几乎是嵌入式入门里最有“即时反馈感”的小项目之一。传感器感应到人OLED立刻从“无人”变成“有人”整套链路包含GPIO输入采集、信号防抖、OLED显示驱动原理不复杂代码量也不大但真正动手做一遍你会发现坑全藏在细节里模块上电后要等接近一分钟输出才稳定、OLED的I2C地址偶尔不是0x3C、灵敏度旋钮拧反了感应距离只剩半米。这篇文章是我从接线到烧录再到反复调试的完整记录适合刚入手STM32F103C8T6最小系统板、想做人体检测或者单纯想搞定一块I2C接口OLED的读者参考。1. 先聊原理热释电效应、菲涅尔透镜和HC-SR501的输出机制1.1 热释电效应传感器为什么能“看见”人HC-SR501的核心是一个热释电红外传感器PIR。人体温度通常在36~37℃左右会持续向外辐射红外线峰值波长大约在9.4μm附近。传感器内部有两片敏感元都是能“感知温度变化”的材料温度一变化材料内部的极化状态就会改变在表面产生电荷进而输出一个微弱的电压变化。但这里有一个关键点热释电传感器对“温度变化”敏感准确说是对“红外辐射变化”敏感对静止不动的红外源反而不敏感。两块敏感元采用差分结构——把两个敏感元反相连接当人体从一片敏感元对应的探测区域移动到另一片时两片输出形成正负叠加产生的信号最强而环境温度慢慢变化时两片输出相同相互抵消以此抑制温漂。这也是HC-SR501本质上只能“检测运动的人”的原因。后面调试部分我会专门讲这个坑人一直在感应区域里坐着不动输出会消失不是传感器坏了而是物理原理决定的。1.2 菲涅尔透镜把人体变成“移动的光斑”传感器感应到的红外信号非常微弱而且依赖于人“走过”探测区域。HC-SR501表面上那一片乳白色、有波纹的面板就是菲涅尔透镜它做的事是把模块前方大范围的视野分割成很多个明暗相间的区域相当于许多小透镜把红外线聚焦到敏感元上。人一旦走动就会依次穿过这些明暗区域热释电敏感元上接收到的红外辐射就会周期性变化形成一串脉冲。所以菲涅尔透镜的作用不仅是“聚光”更关键的是“分光”——把人体的移动转化成传感器能识别的交变热信号。这也是为什么模块的探测角度能到120度左右、距离能到7米上下全靠这片透镜。我在调试中发现如果菲涅尔透镜表面被灰尘、油污或贴纸盖住检测距离会明显变短见过不少人贴了保护膜忘了撕然后怎么调灵敏度都没用。1.3 跳帽和电位器决定输出行为的三个开关HC-SR501板子上有三个可调部分一个触发模式跳帽两个电位器。跳帽在靠近OUT引脚一侧标着H和LH可重复触发人只要持续在感应范围内活动输出就一直保持高电平每次检测到运动会重新计时。L不可重复触发模块检测到人后输出高电平持续一段固定延时时间期间不管人怎么动延时结束就拉低。两个电位器分别标着RT延时和RG灵敏度RT调节输出高电平的持续时长顺时针拧延时变长常见可调范围从几秒到200秒左右。RG调节检测距离顺时针拧灵敏度变高、距离变远可调范围大概从3米到7米。不同批次模块的电位器方向可能略有差异但丝印和手感基本一致。实测中最稳的办法是把模块固定好后拿一个人从远处慢慢靠近边测试边拧用肉眼判断当前旋钮位置对应的实际距离。注意理解这三个配置很重要很多“程序逻辑不对”的问题根本不是代码问题而是跳帽模式和你设计的业务逻辑不匹配。比如你想做“人离开后延时10秒熄屏”的功能跳帽却放在L模式模块输出的高电平只会保持一个固定时间程序收不到持续有效的触发信号逻辑自然对不上。2. 接线方案与电源边界5V给传感器、3.3V给OLED别混在一起2.1 最小系统板的引脚分配与完整接线表我用的是最常见的STM32F103C8T6最小系统板OLED是0.96寸、SSD1306控制芯片、I2C接口的四针版本。这种OLED接线最省事只需四根线。整个项目只需要用到三个外设引脚一个GPIO输入接HC-SR501的OUT两个GPIO接OLED的I2C。我的选择是模块引脚接到STM32F103C8T6HC-SR501VCC5V引脚HC-SR501GNDGNDHC-SR501OUTPB0OLEDVCC3.3VOLEDGNDGNDOLEDSCLPB6OLEDSDAPB7PB6和PB7是STM32F103的I2C1_SCL和I2C1_SDA复用引脚即使我用软件模拟I2C也选这两个脚方便以后想切成硬件I2C时不用改板子。如果你用的是SPI接口的OLED接线会多几根但这个项目用I2C版足够画面更新频率不高I2C完全扛得住。2.2 供电和电平兼容5V、3.3V、共地分别怎么处理供电是新手最容易出错的地方用一句话概括HC-SR501必须用5V供电OLED必须用3.3V供电两者地线要共地。HC-SR501的工作电压范围是4.5~20V给3.3V虽然也能跑但内部运放动态范围不够实测感应距离会缩短很多甚至只有三五十厘米。所以直接接最小系统板的5V引脚。OLED的SSD1306控制器额定电压是3.3V虽然网上有人说接5V也能亮但那是因为模块上带了AMS1117-3.3稳压芯片。并不是所有卖家都焊了稳压而且即使有稳压一路5V供电也容易发热、影响寿命。按手册来OLED接3.3V最稳妥。关于HC-SR501输出电平很多资料标注是“高电平3.3V、低电平0V”。实测下来模块在5V供电时输出高电平确实在3.3V左右并没有到5V所以直接接STM32的GPIO是安全的不用加分压电阻。但如果你买的模块是其他厂牌、输出逻辑高电平接近电源电压那建议串一个1k电阻或者用两个电阻分压再进GPIO。这一点可以通过万用表实测OUT引脚电平确认花十秒钟就能避免烧引脚。共地问题所有模块的GND必须连到STM32F103C8T6的GND。如果没有共地传感器输出的高低电平对比的是它自己的地STM32读到的电平可能是错的。这是最常见的一类“时好时坏”问题大多是杜邦线松了或者地线没接。2.3 为什么我用软件I2C驱动OLED而不是硬件I2C关于OLED驱动我最终选择的是软件模拟I2C而不是STM32F103的硬件I2C外设。原因很现实第一SSD1306对I2C时序要求不高100kHz或400kHz都能跑软件模拟I2C完全足够OLED刷一屏才几十毫秒根本不需要高速。第二STM32F1系列的硬件I2C在标准库时代被很多人踩过坑卡BUSY、死锁的问题不少虽然有争议说HAL库已经好很多但对一个入门项目来说没必要把时间花在和I2C硬件状态机较劲上。软件I2C只要两根GPIO推挽输出代码逻辑透明出问题还容易定位。这个选择也影响了接线方案软件I2C对引脚没有复用要求理论上任意两个GPIO都行我选PB6/PB7纯粹是为了保留以后使用硬件I2C的可能性。3. 代码逻辑GPIO采样、防抖状态机与OLED渲染3.1 CubeMX配置工程搭建的五个关键点我用STM32CubeMX HAL库这套流程整体效率比标准库高代码结构也清晰。打开CubeMX新建工程选择STM32F103C8T6关键配置如下RCC的HSE选择Crystal/Ceramic Resonator。最小系统板上的晶振一般是8MHz如果不配置外部晶振HAL的时钟树没有正确时钟源后面延时和串口全都不准。SYS的Debug选择Serial Wire。不选的话烧录一次之后SWD接口容易被关闭第二次下载会失败。GPIO配置PB0设为Input。HC-SR501输出高电平是明确的可以用NOPULL但如果你线比较长、环境干扰大建议打开下拉电阻防止浮空误触发。时钟树配置为72MHz主频。很多人省略这一步直接默认8MHz程序能跑但所有HAL_Delay、串口波特率都不准。PB6、PB7配置为GPIO_Output。软件I2C通常用推挽输出因为要主动拉高拉低OLED模块一般自带I2C上拉电阻开漏输出同样可用但没有上拉的手工DIY板子则推挽更稳。3.2 防抖状态机为什么不能直接读一次引脚就下结论HC-SR501虽然在输出端集成了一定整形逻辑但它归根到底是模拟信号处理后得到的电平在触发瞬间、电源波动、附近有电磁干扰时输出可能会短暂抖动。如果代码直接读一次引脚就切换状态OLED上的显示可能会在“有人/无人”之间快速闪动面板计数器也会乱跳。我采用的方案是连续采样确认每10毫秒读一次引脚连续读到5次相同的电平才认为状态稳定。10ms×5次50ms这个时间既不会漏掉人的正常走动人走过传感器前至少持续几十毫秒又能滤掉大部分抖动。#define PIR_PORT GPIOB #define PIR_PIN GPIO_PIN_0 #define SAMPLE_COUNT 5 #define SAMPLE_PERIOD 10 // ms uint8_t pir_read_stable(uint8_t expect_level) { uint8_t match 0; for (uint8_t i 0; i SAMPLE_COUNT; i) { if (HAL_GPIO_ReadPin(PIR_PORT, PIR_PIN) expect_level) { match; } HAL_Delay(SAMPLE_PERIOD); } return (match SAMPLE_COUNT); }主程序里用状态变量切换typedef enum { STATE_EMPTY, STATE_OCCUPIED } PIR_STATE; PIR_STATE state STATE_EMPTY; uint32_t enter_time 0; uint32_t total_count 0; uint8_t last_show_state 0xFF; while (1) { if (state STATE_EMPTY) { if (pir_read_stable(1)) { state STATE_OCCUPIED; enter_time HAL_GetTick(); total_count; } } else { if (pir_read_stable(0)) { state STATE_EMPTY; } } // 渲染OLED仅在状态变化或定时刷新时更新 if (state ! last_show_state) { OLED_Clear(); if (state STATE_OCCUPIED) { OLED_ShowString(0, 0, Sta:IN ); } else { OLED_ShowString(0, 0, Sta:OUT); } last_show_state state; } // 每秒刷新计数和持续时间 if (HAL_GetTick() - last_refresh 1000) { char line2[16]; char line3[16]; snprintf(line2, sizeof(line2), Cnt:%lu, total_count); snprintf(line3, sizeof(line3), Time:%lus, (HAL_GetTick() - enter_time) / 1000); OLED_ShowString(0, 2, line2); OLED_ShowString(0, 4, line3); last_refresh HAL_GetTick(); } HAL_Delay(20); }这里把“状态切换”和“界面更新”拆开状态变了才刷屏避免OLED每轮循环都全屏刷新导致闪烁。OLED的刷新写入I2C本身就不快频繁全屏刷会让显示区域闪得厉害这种“按需刷新”的思路在单片机项目里很常见。3.3 OLED显示设计状态、计数与停留时长简单的几行字不满足完整教程的演示效果我把显示分成三块第一行显示当前状态第二行显示累计触发次数第三行显示本次有人状态的持续时间每秒更新一次用HAL_GetTick()减去enter_time换算成秒。OLED驱动用的是常见的SSD1306软件I2C驱动初始化、清屏、字符显示函数可以从开源的ssd1306_i2c驱动基础上整理。关键点是初始化顺序SSD1306要先发初始化序列、开启内部DC-DC电荷泵、设置对比度最后清屏否则屏幕可能不亮。另外I2C地址默认0x3C如果你买的OLED是0x3D地址版本显示函数里所有地址都要改。这里不贴完整驱动了它接近300行网上开源版本很多核心接入逻辑就是把SSD1306_I2C_WriteByte封装成自己的软件I2C读写函数每次操作前拉低起始信号、发送设备地址写位、再发送控制字节和数据字节。只要确认这几步对任何来源的驱动都能跑起来。注意OLED驱动里的数字显示函数如果传入一个很大的uint32_t转字符串时要处理好转字符串的长度避免显示乱码。可以用snprintf把数字格式化到缓冲区再调用显示字符串函数比直接传数字给显示函数更安全。4. 实测排坑日志预热期伪触发、OLED花屏、距离缩水的完整排查4.1 上电后乱报有人传感器有“预热期”第一次上电时OLED显示“有人”的频率高得离谱大概每几秒就触发一次旁边明明没有人。查了一圈程序没问题、接线没问题最后发现HC-SR501刚上电的30~60秒内内部放大器处在建立阶段输出电平不稳定模块说明书里管这个叫初始化时间也就是预热期。排查方法很简单上电后不要立刻进入正常检测流程先用一个变量记录启动时间在预热期内屏蔽所有PIR状态切换或者等预热期结束后再清屏显示。#define WARMUP_MS 60000 while (HAL_GetTick() WARMUP_MS) { HAL_Delay(10); } OLED_Clear();实际中预热时间受环境温度影响夏天可能30多秒就稳定冬天可能要一分钟以上。建议预留60秒到90秒或者看模块板载指示灯稳定后再开始检测。4.2 OLED不亮或花屏一套排查链路OLED不亮是最容易卡死人的问题。按下面的链路排查基本五分钟定位先用万用表量OLED的VCC对GND电压确认是不是3.3V。很多时候问题根本不是代码是杜邦线接触不良或面包板电源排没插紧。然后看屏幕背面丝印确认是I2C版本还是SPI版本I2C只有四个引脚SPI通常有七个以上接口版本不同接线和驱动完全不同。接着确认I2C地址用逻辑分析仪或写一段I2C扫描代码把0x3C和0x3D都测一遍。再检查SCL和SDA有没有接反这个失误率极高因为有些模块丝印SDA/SCL在背面插上杜邦线后字符方向是反的。最后检查软件I2C的GPIO时钟是否开启CubeMX勾选了GPIO_OUTPUT之后HAL库的MX_GPIO_Init里会帮开时钟手写初始化代码时漏掉__HAL_RCC_GPIOB_CLK_ENABLE()就会一直不亮。如果屏幕能亮但花屏大概率是I2C速率不匹配或者驱动初始化序列没完整执行。软件I2C的延时建议设置在半周期5~10微秒太快的GPIO翻转在OLED侧可能采样失败太慢则显示刷新会有可感知的慢。4.3 检测距离变短从灵敏度旋钮到环境温差我把板子放在桌面上测试传感器正前方一米处挥手输出正常再走远一点信号就没了。第一反应是灵敏度电位器没调用小螺丝刀顺时针拧了两圈距离确实变远了但还是达不到标称的7米。后来排查发现两个问题一是HC-SR501的感应距离本来就是以“人在探测区域内移动”为前提标称7米是在开阔环境、人横向走动的条件下测出来的实际在室内、正对方向缓慢移动距离打折到3~5米很正常二是环境温度高的时候人体辐射和环境的温差变小传感器灵敏度会显著下降夏天中午测和晚上测距离差很多。如果一定要追求更远的感应距离可以把灵敏度电位器顺时针拧到底然后把传感器固定在支架上、避免透镜前方有遮挡物。另外探头不要对着强红外源方向比如暖气片、热水管道这些会让传感器背景红外强度升高相当于“压低了”人体辐射的信号。4.4 反复误触发环境干扰与电源纹波另一种更烦人的问题是没人经过OLED却时不时报“有人”。这种反复误触发我遇到过两种典型原因。第一种是安装位置问题。传感器正对空调出风口或者门外走廊空调吹出的冷风会导致探测区域边缘出现快速温度变化正好被热释电传感器当成“有人移动”门口的余光也会让传感器“看到”路过的人。解决方法是调整安装位置或角度让传感器不要直接面对温度剧烈变化的气流。第二种是电源纹波。我的最小系统板早期直接用USB口供电又把一个ESP8266模块接到了同一路5V上ESP8266发射瞬间电流波动很大导致HC-SR501的电源出现几毫伏级的跌落输出就跟着抖动。排查方法是把传感器单独接到稳压后的5V排针或者用电容在模块电源两端滤波。我最后在HC-SR501的VCC和GND之间加了一个100μF的电解电容和一个0.1μF的陶瓷电容误触发频率基本归零。4.5 有人静静坐着就不亮热释电器件的物理边界测试到一半发现人坐在传感器面前一动不动时OLED从“有人”变回“无人”。第一次遇到还以为传感器坏了其实这是热释电原理的必然结果传感器只对红外辐射变化敏感人是恒温动物保持静止时身体表面温度分布几乎不变传感器输出的差分信号会衰减到零模块自然认为人离开了。如果项目需求只是“有没有人经过”HC-SR501完全够用如果要做“有没有人存在”就得换方案比如毫米波雷达模块可以检测微动甚至呼吸带来的胸腔起伏能力完全不一样。选型阶段想清楚这一点能避免后续返工。4.6 延时与封锁时间配合不良输出节奏不对最后一个坑是模块本身的时序参数主要涉及延时电位器RT和封锁时间。当我把RT调到几十秒长延时时发现人走过去之后输出高电平维持几十秒期间再有人经过模块可能不响应。原因在于HC-SR501在每次输出结束后会有一个封锁时间大约2.5秒在这段时间里模块会忽略新的触发信号目的是避免上电瞬间的干扰和输出抖动引起重复触发。正常使用这个时间很短感知不明显但如果延时设得很长人一直在触发区域内会看起来像“模块不理人”。处理思路是根据业务需要选择触发模式。如果希望检测区域内有人就持续输出把跳帽拨到H模式只要人在活动模块自动重新计时输出保持高电平如果只是做“人经过一次报一次”的门禁触发把延时调到最短后续计数由STM32程序自己判断。模块的延时只能调节输出持续时间不代表程序里不用再做防抖两者配合才能得到稳定的检测结果。整个项目调试下来我最大的体会是HC-SR501的可调元件看起来简单但它的每一个配置都直接影响程序逻辑。不要把模块当成一个“自动给出干净高低电平”的黑盒它输出的原始信号里带着热释电器件的物理特性——需要预热、需要运动、受环境温度影响。如果先花十分钟把传感器原理和旋钮含义搞明白后面接线、写代码、调错都会顺很多。这次我把调试过程完整记录下来希望对正在折腾STM32F103C8T6、HC-SR501和OLED的你有帮助至少少走一次我之前走过的弯路。