简介：这份资源围绕脉宽调制（PWM）实现LED亮度无级调节这一电子工程基础课题展开，面向单片机初学者与电子爱好者，帮助其理解占空比与LED平均电流、亮度之间的关系，并完成从原理到编程落地的完整实践。资源包共55个文件，约44KB，以C语言源文件、HEX烧录文件、Keil工程文件（uv2、opt、m51、lst）及编译中间文件（obj、bak）为主，另含少量工程配置与显示相关文件，覆盖STC12C2052单片机PWM初始化、通道配置、占空比动态调整等关键环节，可直接用于编译验证与二次修改。目前已有815人学习下载，适合作为PWM调光入门的参考工程，便于读者对照代码理解亮度调节逻辑、复现实验现象并迁移到室内照明、背光控制等场景。

1. 从“灯能亮”到“灯听话”：一套 PWM 调光代码包能省掉多少试错

很多刚接触单片机的朋友，点亮一颗 LED 只用一行代码，可一旦要做“呼吸灯”“无级调光”“按键调亮度”，就开始翻车：灯要么一闪一闪像接触不良，要么低亮度段直接跳变，要么调着调着单片机复位了。问题往往不在 LED，而在 PWM 参数没配对。这份资源围绕“用 PWM 调节 LED 灯控制”展开，核心就是 LED 灯的亮度调节：把定时器、占空比、频率、人眼感知这几件事串成一条能复现的链路。它适合正在做课程设计、小家电面板灯、氛围灯 Demo 的从业者，也适合想把“会点灯”升级成“会调光”的新手。下面按“资源是什么、怎么落地、坑在哪”的顺序拆开讲，参数和边界都给到能直接抄的程度。

2. PWM 调光的底层逻辑：为什么占空比不等于亮度

2.1 定时器怎么产生一路可调的 PWM

PWM 调光的本质，是用数字引脚快速切换高低电平，靠“高电平时间占整个周期的比例”来等效出不同的平均电压。LED 是电流驱动器件，平均电流变了，亮度就变了。常见实现分两类：一类是硬件 PWM，定时器比较输出直接挂到引脚上，CPU 不参与翻转；另一类是软件 PWM，靠定时中断里手动拉高拉低。前者稳定、抖动小，后者灵活但吃 CPU，频率一高就容易顾此失彼。

以常见的 16 位定时器为例，PWM 频率由时钟、预分频和自动重装值共同决定，占空比由比较寄存器决定。公式不复杂，但每一项都影响最终效果：

/* 以某 16 位定时器为例，仅示意参数关系，寄存器名按实际芯片替换 */ /* f_pwm = f_clk / ((PSC + 1) * (ARR + 1)) */ /* duty = CCR / (ARR + 1) */ #define F_CLK 72000000UL /* 定时器时钟，单位 Hz */ #define PSC 71U /* 预分频，72 分频后计数时钟 1 MHz */ #define ARR 999U /* 自动重装值，周期 1000 个计数 */ /* 目标：1 kHz PWM，分辨率 1000 级 */ /* f_pwm = 72M / (72 * 1000) = 1000 Hz */ void pwm_set_duty(unsigned int percent) { unsigned int ccr; if (percent > 100U) percent = 100U; /* 入参保护，防止越界写寄存器 */ ccr = (ARR + 1U) * percent / 100U; /* 百分比换算成比较值 */ if (ccr > ARR) ccr = ARR; /* 满占空比边界处理 */ TIMx->CCR1 = ccr; /* 写入比较寄存器，立即生效 */ }

这段代码里，PSC决定计数时钟快慢，ARR决定一个 PWM 周期有多少个计数刻度，CCR决定高电平持续多少个刻度。三者一改，频率和分辨率同时变，这是后面很多坑的根源。参数上我一般这样取：调光频率落在 1 kHz 到 5 kHz 之间，分辨率至少 256 级，做平滑呼吸灯就上 1000 级。频率太低会看到闪烁，太高则受限于定时器位宽，分辨率被压得很惨。

2.2 人眼感知是线性的吗：伽马校正为什么绕不开

把占空比从 10% 调到 20%，平均电流翻倍，但人眼并不会觉得“亮了一倍”。人眼对亮度的感知接近幂函数关系，低亮度区敏感、高亮度区迟钝。直接拿占空比当亮度档位，结果就是低档位跳变明显、高档位挤在一起，调光手感很“木”。这就是很多呼吸灯 Demo 看着别扭的原因。

常见做法是加一张伽马校正表，把“想要的亮度等级”映射成“实际占空比”。下面是一段 8 位查表实现，表项按 2.2 左右伽马值生成，实际项目里可以按灯珠和面板透光率微调：

/* 8 位伽马校正表：输入亮度等级 0~255，输出占空比 0~255 */ static const unsigned char gamma_table[256] = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 6, 6, 6, 7, 7, 7, 8, 8, 8, 9, 9, 9, 10, 10, 11, 11, 11, 12, 12, 13, 13, 14, 14, 15, 15, 16, 16, 17, 17, 18, 18, 19, 19, 20, 21, 21, 22, 22, 23, 24, 24, 25, 26, 26, 27, 28, 28, 29, 30, 31, 31, 32, 33, 34, 34, 35, 36, 37, 38, 39, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 69, 70, 72, 73, 74, 75, 77, 78, 79, 80, 82, 83, 84, 86, 87, 88, 90, 91, 93, 94, 96, 97, 99, 100, 102, 103, 105, 106, 108, 110, 111, 113, 115, 116, 118, 120, 121, 123, 125, 127, 128, 130, 132, 134, 136, 138, 140, 142, 144, 146, 148, 150, 152, 154, 156, 158, 160, 162, 164, 167, 169, 171, 173, 175, 178, 180, 182, 185, 187, 189, 192, 194, 197, 199, 202, 204, 207, 209, 212, 214, 217, 220, 222, 225, 228, 231, 233, 236, 239, 242, 245, 248, 251, 254, 257, 260, 263, 266, 269, 272, 275, 278, 281, 285, 288, 291, 294, 298, 301, 304, 308, 311, 315, 318, 322, 325, 329, 333, 336, 340, 344, 348 }; void led_set_brightness(unsigned char level) { unsigned char duty = gamma_table[level]; /* 亮度等级映射为占空比 */ pwm_set_duty(duty * 100U / 255U); /* 再换算成百分比交给 PWM */ }

表里前 16 项几乎全是 0，这是正常的：极低亮度下占空比太小，灯珠本身有导通阈值，给再小的占空比也不亮，强行给反而会出现“第一档就刺眼”的错觉。参数说明上，level是用户看到的档位，duty是真正写进比较寄存器的值，两者之间隔着这张表。我一般会先用示波器看占空比波形，再上眼判断平滑度，光看代码容易自我感觉良好。

2.3 调光频率怎么选：闪烁、啸叫和分辨率的三角关系

频率选择是这套资源里最容易被忽略、又最影响体验的一环。低于 100 Hz，人眼在余光里能捕捉到频闪，拍视频更明显；落在 200 Hz 到 2 kHz 之间，某些灯珠和驱动电路会发出轻微啸叫；再往上走，定时器位宽不够，分辨率就掉下来了。常见做法是把调光频率定在 1 kHz 附近，兼顾无频闪、无啸叫和足够的分辨率。

这里有个反直觉的点：不是频率越高越好。假设定时器时钟 1 MHz，要 20 kHz 的 PWM，一个周期只有 50 个计数刻度，占空比最小步进就是 2%，低亮度段根本调不细。反过来，1 kHz 下一个周期 1000 个刻度，步进 0.1%，呼吸灯才顺滑。所以选型顺序应该是：先定分辨率需求，再反推频率上限，最后确认定时器位宽够不够。下面这张表是我常用的取舍参考：

表格里的数字不是死规定，但能帮你快速判断“我这个参数组合到底还剩多少调节余地”。如果发现低亮度段只有两三档可用，多半是频率定高了或者ARR给小了，回头改预分频比硬调代码更省事。

3. 把调光落到工程里：从单灯到多档位的实现路径

3.1 呼吸灯与按键调光的状态机写法

单灯呼吸和按键调光看着简单，写进工程里最容易变成一堆delay堆砌，结果按键响应迟钝、呼吸节奏还被主循环拖累。稳妥的做法是把“亮度变化”做成状态机，由定时器节拍驱动，主循环只负责扫按键和改目标值。下面是一个不依赖阻塞延时的骨架：

typedef enum { LED_MODE_BREATH = 0, /* 呼吸灯模式 */ LED_MODE_MANUAL /* 按键手动调光模式 */ } led_mode_t; static led_mode_t g_mode = LED_MODE_BREATH; static int g_level = 0; /* 当前亮度等级 0~255 */ static int g_dir = 1; /* 呼吸方向：1 渐亮，-1 渐暗 */ static unsigned int g_tick = 0; /* 节拍计数 */ /* 每 10 ms 调用一次，由定时器中断或软定时器驱动 */ void led_task_10ms(void) { g_tick++; if (g_mode == LED_MODE_BREATH) { if (g_tick % 2U) return; /* 20 ms 调一级，呼吸速度可调 */ g_level += g_dir * 2; if (g_level >= 255) { g_level = 255; g_dir = -1; } if (g_level <= 0) { g_level = 0; g_dir = 1; } led_set_brightness((unsigned char)g_level); } } /* 按键回调：短按切模式，长按或连按调档 */ void on_key_short_press(void) { g_mode = (g_mode == LED_MODE_BREATH) ? LED_MODE_MANUAL : LED_MODE_BREATH; } void on_key_step(int delta) { if (g_mode != LED_MODE_MANUAL) return; g_level += delta * 16; /* 每档 16 级，共 16 档 */ if (g_level < 0) g_level = 0; if (g_level > 255) g_level = 255; led_set_brightness((unsigned char)g_level); }

逻辑上，led_task_10ms只做“按节拍推进亮度”，不碰按键；按键回调只改模式和目标等级。这样呼吸节奏和按键响应互不阻塞，也不会因为某个delay把整个系统卡住。参数上，g_tick % 2控制呼吸速度，改成% 1更快、% 4更慢；delta * 16控制每档跨度，档位多了手感细但按键次数多，档位少了调光粗，我一般取 8 到 16 档之间。

3.2 多路 LED 共用定时器的资源分配

做面板灯、RGB 氛围灯时，往往要同时调多路。硬件 PWM 通道数有限，常见做法是一个定时器出多路比较输出，共用同一个频率和ARR，各自独立改CCR。这意味着几路灯的调光频率被绑死，不能一路 1 kHz、一路 5 kHz。资源分配时先数通道：定时器有几个比较通道、引脚有没有冲突、有没有被串口或编码器占用。

如果通道不够，退而求其次是软件 PWM 分时复用，但要注意刷新率和 CPU 占用。下面是一个多路占空比批量更新的写法，核心是把“改值”和“生效”分开，避免中途出现半更新状态：

#define LED_CH_NUM 3 static unsigned int g_duty_shadow[LED_CH_NUM]; /* 影子寄存器，先算好 */ static volatile unsigned char g_update_flag = 0; void led_multi_set(unsigned char ch, unsigned int ccr) { if (ch >= LED_CH_NUM) return; if (ccr > ARR) ccr = ARR; g_duty_shadow[ch] = ccr; g_update_flag = 1; /* 标记有待生效数据 */ } /* 在 PWM 周期更新中断里统一提交，避免撕裂 */ void pwm_period_isr(void) { if (!g_update_flag) return; TIMx->CCR1 = g_duty_shadow[0]; TIMx->CCR2 = g_duty_shadow[1]; TIMx->CCR3 = g_duty_shadow[2]; g_update_flag = 0; }

影子寄存器的作用是让多路在同一时刻切换，否则三路先后生效，混色时会看到一瞬间的偏色。参数上，LED_CH_NUM按实际通道改，ARR必须和初始化时一致，否则边界判断会失准。这套写法在 RGB 混色里尤其重要，红绿蓝三路不同步，肉眼是能看出闪色的。

3.3 用示波器和万用表验证调光效果

代码写完不等于调光对了。我习惯先上示波器看三件事：频率是否落在设计值、占空比是否随档位单调变化、高低电平有没有明显过冲。再看万用表测 LED 平均电流，确认低档位没有“假亮”或“死区”。如果手头没有示波器，退一步用逻辑分析仪抓引脚波形也能看个大概。

验证顺序建议这样走：先把占空比固定 50%，确认频率和理论值误差在可接受范围；再扫一遍 0 到 100% 占空比，记录每个档位的平均电流，画一条曲线看是否单调；最后上眼做主观平滑度判断。常见问题是低占空比段电流几乎不变，那多半是灯珠导通阈值或驱动三极管压降吃掉了小信号，需要换驱动方式或抬高最低档位，而不是继续在代码里硬调。

4. 调光翻车现场：五条踩坑记录与排查路径

4.1 灯在低亮度段一跳一跳

现象：亮度从 0 往上调，前几档几乎不亮，某一档突然变亮，之后又变平滑。原因通常是占空比步进太粗，叠加灯珠导通阈值，低段被“压缩”了。解决：提高 PWM 分辨率（加大ARR、降低频率），并在伽马表里把低段映射得更密；必要时设一个最低有效档位，跳过完全不亮的区间。

4.2 调光时听到轻微啸叫

现象：某些亮度档位下，灯板或驱动电感发出细小声响。原因是 PWM 频率落在人耳可闻段，或者频率与驱动电路谐振。解决：把调光频率挪到 1 kHz 以上并避开谐振点，优先选 2 kHz 到 4 kHz；如果是电感啸叫，检查驱动回路布局和器件选型，光改代码未必压得住。

4.3 呼吸灯节奏忽快忽慢

现象：呼吸灯看着不顺，快慢不均。原因多是亮度更新挂在主循环里，主循环被其他任务拖慢，节拍就不稳。解决：把亮度推进放到定时器节拍里，主循环只改目标值；同时确认伽马表让亮度变化在感知上均匀，否则“代码匀速、眼睛觉得变速”。

4.4 多路混色出现闪色

现象：RGB 调色时，颜色切换瞬间有偏色闪烁。原因是多路CCR先后写入，没有同步生效。解决：用影子寄存器加周期中断统一提交，保证同一 PWM 周期内多路一起切换；另外确认三路共用同一ARR，否则周期不同步。

4.5 调到大占空比时单片机复位

现象：亮度越高越容易死机或复位。原因常见于驱动电流过大导致电源跌落，或者 PWM 引脚直驱 LED 超出引脚灌拉电流。解决：加三极管或恒流驱动，PWM 只做控制信号；检查电源去耦和地线回流，别让调光电流从单片机地线上走。这类问题改代码没用，得回到硬件。

5. 进阶技巧：把调光曲线做成可配置参数

做到能调光只是及格线，真正拉开差距的是“调光曲线可配置”。我一般会把伽马表从代码里挪出来，做成一张可替换的参数表，按灯珠型号、面板透光率、使用场景各存一份。这样换物料时不用改逻辑，只换表。下面是一个把曲线参数化的思路，用指数近似替代大表，适合 Flash 紧张的小容量芯片：

/* 指数近似伽马：level 0~255 -> duty 0~255，gamma 可调 */ unsigned char gamma_approx(unsigned char level, float gamma) { float x = level / 255.0f; float y = 1.0f; int i; /* 简易幂运算，避免引入数学库；迭代次数按精度取舍 */ for (i = 0; i < 8; i++) { y = y * (1.0f + (gamma - 1.0f) * x * (1.0f - y)); } if (y < 0.0f) y = 0.0f; if (y > 1.0f) y = 1.0f; return (unsigned char)(y * 255.0f + 0.5f); }

这段近似不是数学上严格的幂函数，但胜在不依赖浮点库、可在线调gamma。参数上，gamma取 2.0 到 2.4 之间比较接近人眼感知，偏小则低段更亮、偏大则低段更暗。实际项目里我会先用它快速试手感，定下来再生成正式查表，兼顾调试效率和运行开销。

另一个值得做的进阶点是“调光状态可回读”。把当前模式、档位、目标亮度存成结构体，掉电前写入非易失存储，上电恢复。这样面板灯断电再开不会跳回默认亮度，体验上了一个台阶。验证方法也简单：反复断电上电十几次，看恢复值是否稳定；再人为写坏一个字段，确认有边界保护不会越界点灯。

血泪经验是，调光这类“看起来只是改个数字”的活，最容易被跳过验证直接交付，结果在现场被频闪、跳变、啸叫轮番教育。从那以后我每次改完 PWM 参数，都强制走一遍“示波器看波形、万用表看电流、眼睛看平滑度”三件套，再谈收工。希望帮到你。

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