企业官网建设流程全解析

简介：基于STM32F4xx的光敏电阻自动灯光调节项目，是一套面向嵌入式入门者的完整单片机工程。它以ARM Cortex-M4内核的STM32F4xx为控制核心，利用光敏电阻阻值随光照强度变化的特性，由模数转换器采样将环境光线转化为数字信号，再通过定时器脉宽调制输出占空比可调的驱动信号，使发光二极管亮度随环境光自动变化。工程覆盖通用输入输出模拟配置、模数转换器初始化与读取、脉宽调制输出、中断与定时器等关键模块，同时展示了标准外设库的调用方式与代码组织思路，适合课程设计、毕业设计或自学实践。压缩包内共六十一个文件，整体大小约一点七一兆字节，主要包含工程配置文件、主程序源码、外设头文件与库文件、编译生成的机器码与列表文件，以及说明文档，目录层次清楚，可以直接打开工程查看代码并烧录到开发板运行。目前已有三千零一十五人学习下载，对于想快速掌握光线检测与亮度调节流程的开发者，是一份具有参考价值的实战工程。

1. 为什么一件“读个 ADC 就能干”的小事，实际调起来却让人挠头

用 STM32F4xx 做光敏电阻自动灯光调节，看起来无非是拿 ADC 读一个电阻分压，再按亮度控制 LED 开合，很多入门教程十分钟就能讲完。但真正上手你会发现，麻烦全在“什么时候切换”和“切换得够不够稳”上：黄昏时分灯在临界点反复闪、暗光下 ADC 数值像喝醉了乱跳、上电瞬间灯先亮一下再灭掉。这个项目最核心的价值不在 ADC 采样的基本操作，而在于完整走一遍“物理量采样 → 滤波 → 阈值决策 → 平滑输出”的小闭环。本文按硬件搭建、数据换算、迟滞比较、PWM 过渡和避坑排查的顺序展开，适合刚学完 F4xx 基础外设、想拿一个完整小项目练手的开发者，也适合需要快速把“感光控制”塞进现有产品里的从业者。

2. 硬件搭建：光敏电阻分压电路、引脚选择与 ADC 初始化

光敏电阻本身不是一个标准传感器，它没有数字接口，也不输出固定电压，能直接读到的只是阻值变化。而 STM32F4xx 的 ADC 只认识电压，所以硬件上必须先做一个分压电路，把“阻值变化”翻译成“电压变化”。这一章从电路选型讲到寄存器配置，看完你就能在一个 F4xx 开发板上稳定读到光敏电压。

2.1 分压电路选型：把电阻变化变成电压变化

常见做法是用光敏电阻和一个固定电阻串联，中间抽头接 STM32 的 ADC 引脚。光敏电阻的特点是暗光时阻值高（常见几百 kΩ 甚至上 MΩ），亮光时阻值低（几 kΩ 到几十 kΩ）。固定电阻选多大，直接决定了电压变化的范围和灵敏度。

有两种接法：一是光敏电阻接 3.3V、固定电阻接地，中间抽头输出；二是反过来固定电阻接 3.3V、光敏电阻接地。两种接法都能工作，区别只在于“ADC 数值随着光照增强而变大还是变小”。我一般把光敏电阻放在上方（接电源）、固定电阻放在下方（接地），这样环境越亮，ADC 读数越大，更符合直觉。

固定电阻的取值需要估算。以某款暗阻约 300kΩ、亮阻约 10kΩ 的光敏电阻为例，如果固定电阻取 10kΩ，分压输出范围大约是 0.1V 到 1.6V 左右，动态范围偏窄；如果固定电阻取 47kΩ，输出范围会被拉宽，但代价是暗光时分压节点阻抗变高，ADC 采样时更容易被采样保持电容“抽走电荷”造成读数不稳。我的习惯是第一版先用 10kΩ 或 20kΩ 电阻，等确认了实际环境照度范围再调。很多成品光敏电阻模块上带的那个蓝色电位器，本质上就是“可变固定电阻”，方便你后期调灵敏度。

2.2 F4xx 的 ADC 通道和引脚分配

STM32F4xx 的 ADC 有 12 位分辨率，支持多个外部通道，但通道不是随便选的，每个通道对应固定的 GPIO 引脚。以 ADC1 为例，其外部通道主要分布在 PA0~PA7 和 PB0、PB1 这些引脚上，配置时先要把引脚设置成模拟输入模式（MODER 对应位设为 0b11），再使能对应 ADC 和 GPIO 的时钟。

选引脚时要注意两个约束：一个是别和调试口、晶振引脚冲突，另一个是尽量避开你后续要用的 PWM 输出、串口引脚。很多初学者在最小系统板上贪方便把光敏电阻接到 PA5，结果 PA5 同时又想复用 SPICLK，两边打架，最后只能飞线。做自动灯光调节这类小项目，芯片引脚资源并不紧张，选一个单独的通道就行。另外，F4xx 的 ADC 输入引脚内部没有可靠的上拉或下拉能力，模拟输入模式下也不需要开上拉，外部电路的分压电阻本身就固定了引脚的直流电位。

2.3 最小采样代码：配置一个可靠的单次转换

下面用 HAL 库写一个最简配置，重点看两个参数窗口。第一个是 ADC 分辨率，F4xx 默认 12 位，数值范围 0~4095；第二个是采样时间，直接影响读数的稳定性。

static void MX_ADC1_Init(void) { hadc1.Instance = ADC1; hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4; // ADC 时钟分频 hadc1.Init.Resolution = ADC_RESOLUTION_12B; // 12 位分辨率 hadc1.Init.ScanConvMode = DISABLE; // 单通道，不扫描 hadc1.Init.ContinuousConvMode = DISABLE; // 单次转换 hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE; // 软件触发 hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion = 1; // 转换通道数量 HAL_ADC_Init(&hadc1); } static void MX_ADC1_Channel_Config(void) { sConfig.Channel = ADC_CHANNEL_5; // PA5 对应的模拟通道 sConfig.Rank = 1; sConfig.SamplingTime = ADC_SAMPLETIME_480CYCLES; // 最长的采样时间 HAL_ADC_ConfigChannel(&hadc1, &sConfig); }

初始化完成后，每次读取用“启动 → 等待转换完成 → 拿到数值 → 停止”的流程。这里我特意没有使用 ContinuousConvMode，因为主循环里光敏电阻的采样频率只有十几 Hz，连续转换反而会让 CPU 一直在中断里等数据，增加无谓的开销。

uint16_t ldr_read_raw(void) { uint16_t raw = 0; HAL_ADC_Start(&hadc1); if (HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { raw = HAL_ADC_GetValue(&hadc1); } HAL_ADC_Stop(&hadc1); return raw; }

关于采样时间为什么直接拉满到 480 周期，很多人只记得“采样时间越长越稳”，却不清楚原因。ADC 采样保持电容的充电时间取决于源阻抗，光敏电阻分压节点等效阻抗通常有几十 kΩ 甚至更高，RC 充电常数偏大，太短的采样时间会导致电容还没充到实际电压就结束采样，读数偏低且不稳定。以 ADCCLK 约 21MHz 为例，480 周期换算下来大约 22.9 微秒，对常规的光敏电阻电路完全够用。F4xx 的 ADC 时钟最大不允许超过 36MHz（超了线性度和精度会明显劣化），分频系数按系统时钟去配，不要去极端追求高速转换，光敏电阻本身响应就慢，转换速度远不是瓶颈。

3. 从 ADC 数值到环境亮度：换算、滤波和稳定性处理

拿到原始 ADC 数值只是第一步，接下来要解决“这个值代表多亮”和“这个值能不能信”两个问题。光敏电阻对光照的响应是非线性的，而且阻值随温度也会漂一点，加上电路噪声和电源纹波，直接拿单次采样结果去做控制一定会踩坑。这一章把换算思路和滤波方法一次讲透。

3.1 阻值-照度非线性：为什么不能把 ADC 值直接当亮度

光敏电阻的阻值与照度之间的关系并不是线性的，在典型的数据手册里通常用一条双对数曲线表示，横轴照度（lux）、纵轴阻值，斜率和材料有关。阻值变化规律大概可以写成 R = A * (1/E)^γ，其中 E 是照度，γ 通常在 0.6~1.0 之间。这意味着从阻值换算到照度需要涉及对数运算，如果从 ADC 电压换算回阻值再换算到 lux，小数运算和查表都跑不掉。

但做自动灯光调节，其实大多数场景根本不需要精确的 lux 数值。你真正关心的是“现在该开灯还是关灯”以及“灯光该调到多亮”。直接拿 ADC 值做阈值判断，本质上是在“电压域”做控制，而电压域和亮度域之间存在单调映射，只要这个映射关系稳定，控制效果就能保证。硬要换算成 lux 反而会增加麻烦：光敏电阻批次差异大，你算出来的 lux 未必准，别人照着复现还会因为电阻批次不同得到完全不同的结果。

我一般的做法是先把 ADC 值当作无量纲的“亮度指示量”处理，后期如果需要标定，再做两点校准映射（见第 6 章）。这个思路能避免很多无意义的复杂度，也让代码在更换硬件后只需要重新标定，不用重写算法。

3.2 软件滤波：中值 + 滑动平均的取舍

光敏电阻信号的主要噪声来源是环境光的快速变化（比如云层飘过、开关电源闪烁）和 ADC 自身采样误差。单次采样的值可能在几百个 LSB 范围内跳动，直接拿去和阈值比较会让控制逻辑无所适从。

我推荐先做“去极值均值滤波”：连续采样 N 次，去掉一个最大值、一个最小值，剩下的取平均。这套组合对脉冲型噪声很有效，实现又简单，适合光敏电阻这类变化速度远低于 CPU 速度的信号。N 取 5 到 11 之间比较合适，太小滤波效果弱，太大会让响应变慢。

#define SAMPLE_COUNT 7 uint16_t ldr_read_filtered(void) { uint16_t values[SAMPLE_COUNT]; uint16_t min = 0xFFFF, max = 0; uint32_t sum = 0; uint8_t i; for (i = 0; i < SAMPLE_COUNT; i++) { values[i] = ldr_read_raw(); if (values[i] < min) min = values[i]; if (values[i] > max) max = values[i]; HAL_Delay(2); // 每次采样间隔 2ms，总耗时约 14ms } for (i = 0; i < SAMPLE_COUNT; i++) { if (values[i] == min || values[i] == max) { continue; // 丢弃一个最大值和一个最小值 } sum += values[i]; } return (uint16_t)(sum / (SAMPLE_COUNT - 2)); }

这段代码的取舍之处在于“去掉一个最大、一个最小”而不是“动态剔除所有偏离均值过大的点”。后者虽然更平滑，但判断逻辑复杂，而且光敏电阻本身的“正常跳变”幅度就很大，统计方法的阈值反而需要为每个硬件现场单独调。去极值滤波虽然在连续多脉冲噪声下效果打折，但在大多数室内和室外场景下已经足够。需要注意 HAL_Delay(2) 的间隔不能太短，至少要保证上一次 ADC 转换完全结束、内部电容恢复到稳态，否则连续转换之间会互相干扰。

3.3 采样参数与基准电压：数值跳动的另一个来源

有些时候滤波算法本身没毛病，ADC 数值还是跳得厉害，问题出在电源和基准上。F4xx 的 ADC 使用 VREF+ 引脚作为满量程参考，很多最小系统板直接把 VREF+ 接在 3.3V 电源上。此时如果板上稳压输出纹波较大，或者 LED 负载直接从同一路 3.3V 取电，LED 亮起瞬间电源跌落就会让 ADC 读数整体漂移，造成“灯越亮读数越低”的奇怪现象。

排查办法很简单：把电源和 ADC 采样分开观察，用示波器量 VREF+ 的纹波，或者用另一个稳定电压源单独给 MCU 供电试试。另外 F4xx 的 ADC 还有一个硬件平均模式，粗略说它是在硬件层面把多次转换结果取平均，能降低一部分高频噪声，但会使转换时间变长，适合对响应速度要求不高的光敏采样。软件里如果用到了 DMA 搬运多通道数据，还要注意每个通道都有独立的采样时间寄存器，别把通道配置写串了。

基准电压这一项还有一个容易被人忽略的细节：如果系统在运行中切换了系统时钟或进入了低功耗模式，重新唤醒后 ADC 可能需要一段稳定时间才能恢复精度。我的习惯是在每次初始化后主动丢弃前两次转换结果，实测能减少异常读数的概率。

4. 自动调节策略：迟滞比较与 PWM 平滑过渡

前面把采样的底子打好之后，真正的控制逻辑要登场了。自动灯光调节有两个层面：一个是怎么避免灯在临界照度下反复开关，另一个是怎么让亮度变化看起来自然。直接拿一个固定阈值比较是最容易想到但效果最差的方案，下面详细展开。

4.1 单个阈值为什么一定闪灯

假设你把阈值设在 ADC 值 1500，环境亮度在阈值附近缓慢波动，比如从 1490 缓缓升到 1510 又跌回 1490，那么控制逻辑会反复触发“开灯→关灯→开灯”，这就是黄昏时楼道灯疯狂闪的原因。波动幅度稍微大于你设定的阈值间隔，人眼就很容易察觉。

解决方向有两条：一是加滤波，让送到比较逻辑的数值更平滑；二是加迟滞，让开灯和关灯使用不同的阈值。第二条是工业控制里的经典做法，在光敏场景中效果尤其明显。迟滞的本质是引入“记忆”：一旦开灯后，要等环境明显变亮到另一个更高阈值才关灯；一旦关灯后，要等环境明显变暗到更低阈值才开灯。两个阈值之间的区间就像一道缓冲区，亮度在这个区间里来回滑动时，灯的开关状态保持不变。

4.2 迟滞状态机实现

假设环境越暗 ADC 读数越大，设计一组双阈值：

#define LDR_TH_ON 1900 // 亮度掉到 1900 以下，环境偏暗，开灯 #define LDR_TH_OFF 1300 // 亮度升到 1300 以上，环境够亮，关灯 uint8_t light_state = 0; // 0=关灯 1=开灯 uint16_t ldr_value; void light_control_update(uint16_t raw) { if (light_state == 0) { if (raw > LDR_TH_ON) { // 暗到阈值，开灯 light_state = 1; led_set_brightness_target(900); } } else { if (raw < LDR_TH_OFF) { // 亮过阈值，关灯 light_state = 0; led_set_brightness_target(0); } } }

注意这里的 1900 和 1300 之间留了 600 个 LSB 的迟滞区间。只要环境亮度不是极端剧烈地来回跳，灯的开关状态就能稳定下来。阈值间隔要根据实际环境的波动幅度来定，我一般先观察滤波后的 ADC 值在临界区域的噪声幅度，然后取噪声幅度的 3 倍左右作为迟滞窗口。太小会突破噪声包络，太大则会让“开”和“关”对应的环境亮度差异过于明显，黄昏时会出现灯开了之后要等到天很亮才灭的现象。

4.3 PWM 调光和亮度过渡

从关灯直接跳变到满亮度，晚上会比较刺眼。更好的做法是用 PWM 平滑过渡。F4xx 上的高级定时器和通用定时器都能输出 PWM，配置重点在定时器分频、周期和比较值。以某款主频 84MHz 的 F4xx 为例，若使用 TIM3 通道 1，选择预分频 8-1、自动重载值 1049，PWM 频率约 10kHz，这个频率高于人耳可听范围，也基本不会让 LED 驱动器产生啸叫。

static void MX_TIM3_Init(void) { htim3.Instance = TIM3; htim3.Init.Prescaler = 8 - 1; // 84MHz / 8 = 10.5MHz htim3.Init.Period = 1049 - 1; // 约 10kHz htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_PWM_Init(&htim3); sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; // 初始占空比 0，避免上电瞬间全亮 sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); }

渐变过程不要在定时器中断里做重活，用一个非阻塞的递增/递减函数更好：

uint16_t current_duty = 0; uint16_t target_duty = 0; uint8_t duty_busy = 0; void led_set_brightness_target(uint16_t target) { target_duty = target; duty_busy = 1; } void led_brightness_tick(void) { if (!duty_busy) return; if (current_duty < target_duty) { current_duty += 24; // 每 20ms 调一次，约 1.5 秒走完线性渐变 } else if (current_duty > target_duty) { current_duty -= 24; } else { duty_busy = 0; return; } __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, current_duty); }

渐变步长 24、调用间隔 20ms，对应从 0 到 1000 大约 0.83 秒左右，这个速度既不会让人察觉“一顿一顿”，也不会慢到让人着急。想要更顺滑的呼吸感可以把步长减小，但要相应增加调用频率。渐变过程中如果目标又改变了，可以直接覆盖 target_duty，当前亮度会在原有基础上继续朝新目标走，不会出现先回零再重启的突兀感。

5. 光敏电阻自动灯避坑指南：5 个高频问题与排查路径

这一类项目看起来简单，翻车点却非常集中。很多开发者把 ADC 连通、代码编译通过后就以为大功告成，结果在现场调了一下午。基于常见社区反馈和实操经验，把下面 5 个高频问题列成“现象 → 原因 → 解决”的排查清单，供你直接对照。

5.1 灯在临界照度附近反复闪烁或者干脆频闪

现象：黄昏或者阴天时，灯在开与关之间来回跳，甚至在某一瞬间以人眼可见的频率闪烁。

原因：绝大多数情况是“单阈值 + 未滤波”的组合。环境亮度本身在噪声波动，单阈值比较逻辑把噪声放大成了开关信号。少数情况是 PWM 频率选择不当，比如用了 1kHz 的 PWM 去驱动 LED，人眼虽然不敏感，但和室内的荧光灯频闪叠加后会产生让人难受的视觉跳动。

解决：先做 3.2 节的去极值均值滤波，再按 4.2 节加迟滞区间。PWM 频率低于 2kHz 的，把频率提到 10kHz 以上再观察。如果调整后还是闪，用万用表或示波器确认一下电源在 LED 开合瞬间的跌落幅度，必要时给 LED 驱动加独立电源或加一个较大容量的电解电容。

5.2 ADC 数值在暗光下乱跳，像喝醉了

现象：环境变暗后，滤波后的 ADC 值仍然在几百个 LSB 范围内无规律跳动，亮度越低跳得越厉害。

原因：暗光下光敏电阻阻值很高，分压节点的等效阻抗可能到几十 kΩ 甚至几百 kΩ。ADC 采样保持电容充电时，如果采样时间太短，电容电压来不及达到真实值，读数就会随上一次转换结果和电路噪声随机漂移。另一个来源是高阻节点本身容易拾取周围环境的工频干扰。

解决：确认采样时间设置，直接拉到 480 周期；检查分压固定电阻是不是取得太大，如果固定电阻超过 100kΩ 就需要考虑换一个更小的阻值设计；在 ADC 引脚和对地之间加一个 0.1μF 的陶瓷电容，注意电容不能太大，否则会拖慢响应速度。还有一种玄学情况是板子表面有助焊剂残留、受潮后在暗光高阻条件下形成漏电流路径，可以用无水乙醇清洗采样引脚周围，烘干后再试。

5.3 上电瞬间 LED 闪了一下，然后才恢复正常

现象：每次给系统上电，LED 都会先亮一下，随后由于控制逻辑接管而熄灭或调整到正常状态。

原因：定时器和 GPIO 的输出默认状态在初始化完成前处于不定状态，PWM 通道使能后，如果比较寄存器里是默认的 0xFFFF 或上一次程序残留的值，就会输出一个意想不到的高电平脉冲。另外如果 LED 直接接在 MCU 引脚上，GPIO 在配置成复用功能之前的默认推挽输出也可能瞬间拉高。

解决：初始化顺序上把“PWM 初始占空比设为 0”放在使能输出之前。具体到代码里，就是先配置好定时器的预分频、周期和比较值寄存器，再调用 HAL_TIM_PWM_Start；如果还是不放心，可以在外部电路把 LED 的驱动管基极默认拉到低电平，让上电瞬间即使是高阻状态也不会导通。对低成本批量产品来说，这个“闪一下”虽然不至于损坏硬件，但会给用户一种“这灯有毛病”的第一印象，值得花时间抹掉。

5.4 白天该灭不灭，晚上该亮不亮，总是慢半拍

现象：早晨天已经亮了，灯还在那里亮着；傍晚天已经很暗了，灯还没打开，而且不是差一点点，是明显滞后。

原因：迟滞区间设置得过宽。有人看到阈值窗口能防抖动，就图省事把两个阈值拉得很远，比如开灯阈值 1500、关灯阈值 2900，结果从“决定开灯”到“决定关灯”需要光照变化跨越 1400 个 LSB，自然慢半拍。另一个原因是滤波窗口太长，比如连续采样 30 次且每次间隔 50ms，整个滤波过程超过 1.5 秒，和光照变化速度叠加后响应明显迟钝。

解决：把迟滞窗口压缩到噪声幅度的 3 倍左右，配合 5~9 次采样、每次间隔 2~5ms 的滤波参数。调整时可以打开串口，把滤波后的 ADC 值和开关状态打印出来，在临界时段观察真实波动幅度，再以波动幅度的 2~3 倍设定窗口。不要在一个封闭环境里调好就不动了，不同朝向、不同季节的光照变化速度差异很大，参数要留一定的可调节空间。

5.5 阈值一开始好用，几天后整条曲线漂了

现象：同一个光敏电阻模块，刚调好时晚上 19:00 准时开灯，过了几天同一亮度的 ADC 读数整体偏移，需要重新调阈值。

原因：光敏电阻本身存在温漂和老化现象，阻值随温度变化，在户外环境长期受紫外线照射后阻值曲线也会改变。很多光敏电阻模块的电路还会受模块本身发热影响，如果模块紧挨着 LED 驱动电路，时间长了读数偏移会更明显。

解决：设计时预留软件校准入口，比如在系统里做一个“自动学习”功能：用户按一下按钮记录当前 ADC 值作为开灯阈值，再按一下记录关灯阈值，把校准结果存到内部 Flash 或外部 EEPROM。产品量产时也建议保留这个小按钮，现场安装人员就可以根据实际环境微调，不用重新烧录程序。传感器尽量远离 LED 和电源等发热源，或者用遮光罩隔离环境光之外的热辐射。

6. 进阶：两点校准、映射表和调参习惯

基础版本跑通之后，如果你想让这个系统从“能用”变成“好用”，下面两个进阶方向值得做。它们不改变整体架构，但能显著提升控制精度和可维护性。

第一个是两点校准。虽然光敏电阻的阻值-照度曲线是非线性的，但在我们关心的窄亮度区间内，可以近似当线性处理。做法是找两个已知照度的环境，比如暗室（约 10 lux）和普通办公桌台灯下（约 300 lux），分别记录滤波后的 ADC 值，然后做线性映射：

#define CAL_DARK_LUX 10 #define CAL_BRIGHT_LUX 300 #define CAL_DARK_RAW 1500 #define CAL_BRIGHT_RAW 750 int32_t ldr_raw_to_lux(uint16_t raw) { if (raw <= CAL_BRIGHT_RAW) return CAL_BRIGHT_LUX; if (raw >= CAL_DARK_RAW) return CAL_DARK_LUX; return CAL_DARK_LUX + (int32_t)(CAL_BRIGHT_LUX - CAL_DARK_LUX) * (raw - CAL_DARK_RAW) / (CAL_BRIGHT_RAW - CAL_DARK_RAW); }

这套映射不求精确，只求可控。你可以在代码里把开灯条件写成“lux 低于某个值”，而不是“ADC 值低于某个值”。好处是更换光敏电阻批次或者调整硬件电路后，只需要重新校准两个点，控制逻辑里的阈值不用改动。注意两点校准的暗点和亮点差距不要太小，至少要让 ADC 原始值拉开三五百个 LSB，否则映射斜率会非常敏感，一点噪声都会被放大。

第二个是映射表驱动调光。如果你希望灯光亮度随环境亮度连续变化，而不是只有开和关两档，可以在 PWM 和 ADC 值之间做一个查表映射。比如环境越暗 PWM 占空比越大，把 0~4095 的 ADC 范围切成若干段，每段对应一个目标占空比，段与段之间做线性插值。查表的好处是你可以手动在目标曲线上调整“哪个亮度配哪挡灯”，比套公式直观得多。表直接放在 Flash 里，运行时只读，不占 RAM。

调参这件事，我最后想分享一个习惯：永远不要靠肉眼盯着 LED 调阈值。把串口打开，周期打印滤波后的 ADC 值和当前的开关状态，然后在黄昏时段对着日志记录真实的数值范围和噪声幅度。数值落在什么区间、阈值该设多大，一眼就能看清楚，比反复烧录试错快得多。我自己每次做这种小项目都会先花十分钟把串口打印加上，很多看似需要示波器的排查，其实看日志就能定位到原因。这个习惯帮我少走了不少弯路，也希望帮到你。

本文还有配套的精品资源，点击获取