简介基于STM32F4xx的光敏电阻自动灯光调节实验资料包面向正在学习STM32与嵌入式开发的单片机初学者解决环境光线检测与LED亮度自动调节的入门实践问题。项目以ARM Cortex-M4内核的STM32F4xx为主控光敏电阻将光照强弱转换为电阻变化经片内ADC采集后由定时器PWM输出控制LED亮度涉及GPIO、ADC、定时器PWM、HAL库配置等核心知识点并包含滤波与阈值判断等实用处理思路。压缩包共61个文件以Keil工程文件、C源文件与头文件为主同时包含.o、.crf等编译中间文件以及可直接烧录的.hex固件可在Keil MDK中直接打开工程查看配置并重新编译包体约1.71MB。已有3015人学习下载适合对照源码理解从光敏电阻采样到PWM调光的完整链路。通过该工程可直观掌握STM32外设初始化、ADC单通道采集、PWM占空比调整及工程组织方式对后续独立开发同类传感器项目有实际参考价值。1. 光敏电阻自动灯光调节用 STM32F4 把环境光变成 PWM 亮度做单片机项目做到第二年你会发现「传感器采集 执行器控制」是最常遇到的组合而光敏电阻自动调光就是这个组合里最典型、也最容易被低估的一题。你的板子可能只有一块 STM32F4、一个光敏电阻、一颗 LED却能实现从「环境越暗灯越亮」的硬逻辑到「白天微亮提示、夜晚满亮照明」的软策略。顺着这条线走一遍ADC 采样、PWM 输出、阈值处理、滤波去抖就全串起来了哪怕你之前只点过灯也能在半小时内让调光逻辑跑起来。这篇文就拆这个项目电路怎么搭、参数怎么定、代码怎么写以及我在 F4 上调这个板子时踩过的五个坑。2. 硬件电路与选型分压网络、ADC 引脚和 PWM 定时器的组合2.1 光敏电阻为什么不能直接接 ADC分压网络的必要性光敏电阻的阻值随光照变化但它的两端不能直接接到 STM32F4 的 ADC 引脚上。原因在于 ADC 采样的是电压而不是电阻。常见接法是光敏电阻和一个固定电阻串联形成一个分压网络把「阻值变化」转换成「电压变化」再把电压送入 PA 口对应的 ADC 通道。分压网络有两种接法方向正好相反光敏电阻接 VCC、固定电阻接地那么光照越强光敏电阻阻值越小分压点电压越低反过来接光照越强电压越高。以某实验室的模拟项目 X 为例它用的是「光敏电阻在上、固定电阻在下」的接法这意味着 ADC 值越大环境越暗后续 PWM 占空比应该越大——这条逻辑方向很容易在写代码时搞反我建议你在原理图上用红笔标出「ADC 大 暗」省得写映射时犯迷糊。固定电阻的阻值也不是随便选的。光敏电阻在常见室内光照下大约是 5kΩ 到 20kΩ暗环境下可能升到 200kΩ 以上。如果固定电阻选 10kΩ那么在室内光照下分压点大约在中点附近ADC 读数有足够的区分度如果固定选 1kΩ那么光敏电阻稍一变暗ADC 就会饱和到接近满量程动态范围被压得很窄。2.2 引脚选择ADC 通道和定时器通道的冲突规避STM32F4 的 ADC 引脚和定时器 PWM 引脚往往分布在同一个 GPIO 口的不同 Pin 上但如果选错了就会出现「想用 PA4 做 ADC却发现它已经被板上其他外设占用」的情况。我在某跨平台系统里用过 F401 的开发板默认 LED 接在 PB13 或 PC13而光敏电阻如果要接 PA1需要先确认板子上的排针是否把 PA1 引出来了。一个稳妥的选法是ADC 选 PA1ADC123_IN1PWM 选 PB0TIM3_CH3或 PA8TIM1_CH1。这两个引脚在绝大多数 F4 系列封装里都有引出而且不容易和 SWD 调试口PA13/PA14冲突。注意如果你用的是 STM32F4 的某个最小系统板PA9 和 PA10 可能已经被 USB 串口芯片占用别把 PWM 输出选到那里。另外要确认引脚复用关系。PA1 既能做 ADC也能做 TIM2_CH2 的 PWM 输出但同一个引脚不能同时做两件事。如果你在初始化代码里把 PA1 配置成了复用推挽输出那 ADC 就读不到任何数据而且这种问题不会被编译警告提示只会表现为光照变化时 ADC 值纹丝不动。2.3 硬件参数速查表一块面包板上该放哪些东西如果你是自己搭电路下面这个表可以直接照抄元件推荐型号/参数说明光敏电阻GL5528 或同类亮阻 10-20kΩ暗阻可达 1MΩ动态范围大固定电阻10kΩ ±5% 金属膜与光敏电阻分压取中点电压滤波电容100nF 陶瓷电容并联在 ADC 采样引脚与地之间LED5mm 直插或 0805 贴片PWM 驱动时需串 470Ω 限流电阻STM32F4任意带 ADC 通用定时器的型号F401/F411/F407 均可滤波电容这一项容易被忽略。光敏电阻对 50Hz 交流灯光有响应室内灯光下 ADC 值会以 100Hz 的纹波抖动并联一个 100nF 电容能把大部分纹波滤掉。如果不想加电容那后续代码里就必须要做均值滤波否则调光会在某一个亮度点附近来回跳。3. 核心代码实现ADC 采集、光强映射与 PWM 输出的完整链路3.1 初始化顺序先时钟、再 GPIO、后外设写 STM32F4 的代码初始化顺序是有讲究的。第一步开时钟第二步配 GPIO第三步配外设参数第四步使能外设。我见过不少新手把 ADC 使能放在 GPIO 配置之前结果寄存器写进去了又被复位所以这里给出一个可直接用的初始化函数void light_sensor_init(void) { // 1. 开启 ADC1 和 GPIOA 的时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1, ENABLE); RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // 2. 配置 PA1 为模拟输入不走复用 GPIO_InitTypeDef gpio; gpio.GPIO_Pin GPIO_Pin_1; gpio.GPIO_Mode GPIO_Mode_AN; gpio.GPIO_PuPd GPIO_PuPd_NOPULL; GPIO_Init(GPIOA, gpio); // 3. 配置 TIM3_CH3 对应引脚 PB0 为复用功能 gpio.GPIO_Pin GPIO_Pin_0; gpio.GPIO_Mode GPIO_Mode_AF; gpio.GPIO_Speed GPIO_Speed_50MHz; gpio.GPIO_OType GPIO_OType_PP; gpio.GPIO_PuPd GPIO_PuPd_NOPULL; GPIO_Init(GPIOB, gpio); GPIO_PinAFConfig(GPIOB, GPIO_PinSource0, GPIO_AF_TIM3); }这里最关键的是 PA1 的GPIO_Mode_AN和 PB0 的GPIO_Mode_AF要区分开。GPIO_Mode_AF还需要配合GPIO_PinAFConfig把引脚复用为 TIM3漏掉这一句PB0 上不会有 PWM 波形但代码编译和运行都不报错属于典型的静默故障。3.2 ADC 配置12 位分辨率、采样时间与软件触发F4 的 ADC 是 12 位的默认右对齐读取范围是 0 到 4095。采样时间越长内阻越大的传感器信号越准确。光敏电阻分压点的等效内阻在 10kΩ 量级采样时间我习惯配置为ADC_SampleTime_84Cycles不会让单个通道的转换时间过于拖沓又能保证读数稳定。void adc_init(void) { ADC_InitTypeDef adc; adc.ADC_Mode ADC_Mode_Independent; adc.ADC_ScanConvMode DISABLE; adc.ADC_ContinuousConvMode DISABLE; adc.ADC_ExternalTrigConv ADC_ExternalTrigConv_T1_CC1; adc.ADC_DataAlign ADC_DataAlign_Right; adc.ADC_NbrOfChannel 1; ADC_Init(ADC1, adc); ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_84Cycles); ADC_Cmd(ADC1, ENABLE); } uint16_t read_light_value(void) { ADC_SoftwareStartConv(ADC1); while (ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC) RESET); return ADC_GetConversionValue(ADC1); }去掉了 ADC 的外部触发只保留软件触发。每次调用read_light_value时启动一次转换等EOC标志置位后取数据。采样时间 84Cycles 对应的是 ADC 时钟域下的等待周期F4 的 ADC 时钟通常是 21MHz 到 30MHz84Cycles 大约是 3~4µs对光敏电阻这样慢变的信号完全够用。3.3 光强映射 PWM 占空比线性映射和反向逻辑同一个 ADC 值在不同接法下对应的物理含义不同。以 2.1 节说的「光敏电阻在上、固定电阻在下」接法为例ADC 值大 环境暗 灯光应该更亮。这样映射函数写出来就是uint16_t light_to_duty(uint16_t adc_val) { uint16_t dark_threshold 3000; // 超过这个值认为天黑 uint16_t bright_threshold 800; // 低于这个值认为天亮 if (adc_val bright_threshold) { return 0; // 白天灯熄灭 } if (adc_val dark_threshold) { return 4095; // 夜晚全亮 } // 中间区域按比例映射 return (uint16_t)((adc_val - bright_threshold) * 4095UL / (dark_threshold - bright_threshold)); }dark_threshold和bright_threshold之间的区间是线性过渡区。这个区间不宜过大否则灯会在傍晚很长一段时间内处于「半亮不亮」的状态也不宜过小否则像开关一样突变反而丢掉了「自动调光」的意义。两个阈值具体是多少取决于你的分压电阻和光敏电阻特性上板以后按实际 ADC 读数调。如果发现光线变亮时灯反而变亮那就是阈值方向反了。解决办法是把dark_threshold和bright_threshold互换而不是去改代码逻辑——因为映射逻辑本身没有错是物理接法决定了它的方向。3.4 PWM 初始化与输出TIM3_CH3 的完整配置映射出来的占空比是一个 0~4095 的原始 ADC 量纲用定时器的 ARR 值直接对应是最省事的办法void pwm_init(void) { TIM_TimeBaseInitTypeDef timer; TIM_OCInitTypeDef oc; // 以 84MHz 为参考预分频 84 - 1MHz 计数频率 timer.TIM_Prescaler 84 - 1; timer.TIM_CounterMode TIM_CounterMode_Up; timer.TIM_Period 4095; timer.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInit(TIM3, timer); oc.TIM_OCMode TIM_OCMode_PWM1; oc.TIM_OutputState TIM_OutputState_Enable; oc.TIM_Pulse 0; oc.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC3Init(TIM3, oc); TIM_OC3PreloadConfig(TIM3, TIM_OCPreload_Enable); TIM_Cmd(TIM3, ENABLE); }ARR 设成 4095 是为了让占空比的量纲和 ADC 的 12 位输出一一对应。这样light_to_duty返回的值可以直接塞进TIM_SetCompare3不经过二次换算减少了写代码时出错的环节。PWM 频率大约是 1MHz / 4096 ≈ 244Hz这个频率下 LED 的频闪肉眼不可见但如果你要驱动的是会产生啸叫的线圈负载就需要把频率抬到 1kHz 以上。主循环里的最终调用是这样一段while (1) { uint16_t light read_light_value(); uint16_t duty light_to_duty(light); TIM_SetCompare3(TIM3, duty); delay_ms(50); // 50ms 一次既不迟钝也不抖动 }4. 避坑排查我在这个项目里踩过的五个真实问题4.1 ADC 读数始终为 0GPIO 复用和调试器冲突现象程序编译下载正常但read_light_value()始终返回 0用手遮住光敏电阻也没有变化。原因PA1 虽然在官方引脚定义上是 ADC 通道但我当时用的那个最小系统板把 PA1 外部接了一个 0Ω 电阻到 GND等于硬件上把采样点直接拉低了不是代码问题。解决换通道。先把 PA1 飞线悬空再用万用表量 PA1 对地电压如果始终是 0V说明板子设计如此改到 PA0 或者 PC2 即可。从这以后我拿到新板子的第一步就是「测引脚电压」不再默认原理图丝印是准的。4.2 ADC 值跳变幅度大缺少硬件滤波和软件去抖现象把 ADC 值通过串口打印看到读数在 2000 到 2600 之间反复跳灯光下的跳变尤其明显。原因光敏电阻对低频纹波和杂散光敏感加上没有 100nF 电容工频干扰直接耦合进了采样引脚。解决硬件上在引脚对地并 100nF 电容软件上做滑动均值滤波取最近 8 次采样的平均值。注意 8 次平均不要用 int 累加再除直接用右移 3 位避免编译器生成除法调用库函数浪费几个时钟周期。4.3 PWM 输出没有波形忘记调 TIM_CtrlPWMOutputs现象代码里 PWM 初始化写得完整GPIO 也复用成功了但示波器量 PB0 始终是低电平。原因F4 的高级定时器 TIM1 和 TIM8 在初始化后需要额外调用TIM_CtrlPWMOutputs(TIM1, ENABLE)而 TIM2/TIM3/TIM4 不需要。如果我用的是 TIM3 的 CH3理论上不涉及这个问题但当时在某图像处理 Demo 上用的是 TIM1正好踩了这个坑。解决选择通用定时器TIM2、TIM3、TIM4而不是高级定时器作为 PWM 输出省一行配置也少一个理解成本。如果你非要使用 TIM1那就在TIM_Cmd之后加一行TIM_CtrlPWMOutputs(TIM1, ENABLE)。4.4 夜间灯光闪烁占空比在阈值附近来回摆动现象傍晚时分灯不是在两个亮度之间平滑过渡而是在某个位置快速闪烁频率大概 2Hz 到 5Hz。原因ADC 噪声落在映射区间附近当 ADC 值在bright_threshold两侧徘徊时占空比会在 0 和一个较大值之间来回跳。这是典型的「阈值抖动」问题映射函数是连续的但没有滞回特性。解决给映射加滞回。也就是「白天进入晚上」的跳变点和「晚上回到白天」的跳变点设为两个不同值。常见做法是设置night_on_threshold 2800、night_off_threshold 2200当 ADC 超过 2800 才切换为开灯低于 2200 才关灯中间区域保持原状态。这样即使 ADC 在某个点附近抖动也不会导致输出反复变化。4.5 LED 亮度不够但占空比已经到顶PWM 频率与 LED 驱动的匹配现象PWM 占空比设为 4095全亮时LED 亮度仍然不如直接用 GPIO 输出高电平时的亮度。原因当时用的是 TIM1ARR 值为 999PWM 频率约 84kHz。LED 驱动电路里的限流电阻和寄生电容构成了一个低通滤波在高频 PWM 下电流还没拉起来就被关断了。解决把 PWM 频率降到 1kHz 到 5kHz 区间或者改用 MOSFET 做开关驱动。低频率下 LED 视觉上没有可感知的闪烁但瞬时电流充足亮度明显提升。从那以后我每次换 PWM 通道都会先算一遍「周期 vs 负载响应时间」不多花两分钟但能省一晚上的调试时间。5. 进阶技巧灰度校准、滑动滤波和两段式状态机基础功能调通之后我一般会加三个增强第一个是灰度校准。把阈值从拍脑袋改成「实测校准」具体做法是在主循环完成前加一段校准过程上电后按下按键程序先持续采样 2 秒把最大值和最小值记录下来存到 Flash 的后 4 个字节里。之后运行时动态地把当前 ADC 值映射到一个归一化的 0~100% 区间。这样做的好处是当你把设备从室内挪到窗边不需要改代码重新烧录按一下校准键就行。第二个是滑动滤波。上面提到过 8 次均值这里给一个不占用内存队列的写法uint32_t adc_acc 0; uint16_t adc_filtered 0; void adc_filter_task(void) { adc_acc - adc_filtered; adc_filtered read_light_value(); adc_acc adc_filtered; adc_acc 3; // 这里右移 3 位相当于除 8得到新的均值 adc_filtered (uint16_t)adc_acc; }这个写法省去了队列的入队出队操作用一个累加器维护最近 8 次采样的总和。注意adc_acc的类型必须是uint32_t因为 8 个 12 位值累加最大是 8×409532760超出了uint16_t的范围。这个细节我当时没注意导致滤波后的数值经常出现离谱的毛刺。第三个是两段式状态机。用「白天、黄昏、夜晚」三个状态替代直接的线性映射在过渡状态用延时计数做渐变。核心代码如下typedef enum { STATE_DAY, STATE_DUSK, STATE_NIGHT } light_state_t; light_state_t current_state STATE_DAY; uint8_t transition_step 0; void light_control_task(void) { uint16_t adc adc_filtered; switch (current_state) { case STATE_DAY: TIM_SetCompare3(TIM3, 0); if (adc NIGHT_ON_THRESHOLD) current_state STATE_DUSK; break; case STATE_DUSK: transition_step; if (transition_step 20) { current_state STATE_NIGHT; transition_step 0; } TIM_SetCompare3(TIM3, transition_step * 32); // 20 步渐变每步约 205/4095 的占空比增幅 if (adc DAY_OFF_THRESHOLD) current_state STATE_DAY; break; case STATE_NIGHT: TIM_SetCompare3(TIM3, 4095); if (adc NIGHT_OFF_THRESHOLD) current_state STATE_DAY; break; } }状态机的核心价值是避免了「线性映射 滞回」在中间区域的调光速度不均匀问题。比如线性映射里 ADC 值变化 100 对应占空比变化 3%但不同光照变化速度下人眼感受到的亮度跳变差异很大而状态机里每一次状态转移都经过固定的 20 步渐变视觉上更平滑。三个增强做完这个项目的代码量大约在 400 行左右全部基于标准外设库不涉及 HAL。从那以后我每次在 F4 上做传感器采集类项目都会习惯性地先确认分压方向、再定 PWM 频率、最后才写映射函数——一套固定的顺序走下来调光项目从画板到跑通基本控制在半天以内。这套流程也顺带帮我避开了后续不少「看起来是代码问题、实际是硬件接反」的坑。希望帮到你。本文还有配套的精品资源点击获取