简介：这份资源围绕STM32F103C8T6驱动PCA9685实现PWM调光展开，面向正在学习嵌入式外设通信与LED亮度控制的开发者，尤其适合想通过I2C总线掌握12位PWM调节的入门到中级学习者。压缩包共213个文件，约6.68MB，包含37个c源文件、38个h头文件、38个o目标文件与37个crf编译记录，另有uvprojx、uvoptx工程配置、hex烧录文件、sct分散加载及map映射文件，完整保留了Keil工程结构与编译中间产物，便于直接打开复现。资源中涉及I2C初始化、PCA9685工作模式与PWM频率设置、各通道占空比写入等关键环节，并延伸至灯板LED阵列的亮度与颜色渐变控制思路。目前已有1279人学习下载，可作为调光系统搭建与排错参考。

1. 从一次调光翻车说起：PCA9685 到底能解决什么问题

如果你手头有一块 PCA9685，多半是因为遇到了同一个问题：单片机的硬件 PWM 通道不够用了。我最早接触这颗芯片，是想给一组 LED 做呼吸灯阵列，结果发现主控能拿出来的 PWM 引脚只有三四个，而灯有十六路。当时第一反应是用软件延时模拟 PWM，写完跑起来才发现，主循环被占得死死的，串口响应都卡了，调光还一抖一抖的，典型的翻车现场。

PCA9685 就是冲着这个场景来的。它是一颗 16 通道、12 位分辨率的 PWM 驱动芯片，通过 I2C 总线控制，理论上一条 I2C 总线可以挂 62 片，也就是接近一千路 PWM。它内部有独立的振荡器，自己产生 PWM 波形，主控只负责通过 I2C 写寄存器告诉它「哪一路、占空比多少」，写完就可以去干别的事。这一点对调灯特别关键：调光是个持续输出的活儿，交给专用芯片扛，主控才腾得出手。

这篇笔记面向的是已经会点单片机、想用 PCA9685 做 LED 调光或者调亮度的人。我会从寄存器层面讲清楚它为什么能调、怎么接线、代码怎么写、参数怎么设，最后把我在实际调试里踩过的坑一条条摆出来。看完你应该能自己搭出一套稳定的多路调光方案，而不是停留在「抄个库能亮就行」的阶段。

2. PCA9685 调光的底层逻辑：12 位分辨率是怎么落到亮度上的

2.1 从 I2C 写寄存器到引脚输出波形

PCA9685 的调光本质，是它内部给每一路都维护了一对寄存器：ON 寄存器和 OFF 寄存器，各 12 位。芯片内部有一个 12 位的计数器，从 0 数到 4095 然后归零，循环往复。每一路输出在计数器等于 ON 值时拉高，等于 OFF 值时拉低。所以占空比就是 (OFF - ON) / 4096。

这里有个容易忽略的点：ON 和 OFF 都是 12 位，但寄存器是分两个字节存的，低 8 位在 LEDn_ON_L，高 4 位在 LEDn_ON_H 的低四位。写的时候要先写低字节再写高字节，因为芯片内部有个影子寄存器机制，高字节写入的那一刻才真正生效。如果你顺序写反了，会出现短暂的错误占空比，灯会闪一下。我一般封装成一个函数，把顺序固定死。

调光时最常用的模式是 ON 固定为 0，只改 OFF。这样占空比从 0 到 4095 线性变化，对应亮度从全灭到全亮。但要注意，LED 的亮度和占空比并不是线性关系，人眼对亮度的感知近似对数，所以如果你直接线性写 OFF 值，低亮度段会感觉变化很慢，高亮度段又跳得厉害。后面讲伽马校正会专门说这个。

2.2 频率、分辨率与 LED 驱动的三角关系

PCA9685 的 PWM 频率由内部振荡器和 PRESCALE 寄存器决定。公式是：

prescale = round(osc_clock / (4096 * freq)) - 1

osc_clock 典型值是 25MHz。比如你要 1000Hz 的 PWM 频率，prescale = round(25000000 / (4096 * 1000)) - 1 = round(6.1) - 1 = 5。

频率选多少，取决于你驱动的是什么。普通 LED 调光，200Hz 到 1000Hz 都行，太低会看到闪烁，太高则分辨率会受影响。因为 prescale 是整数，频率和分辨率是绑死的：频率越高，每个周期内的计数步数越少，实际可用的占空比档位就越少。比如你把频率拉到 5000Hz，prescale 会很小，12 位分辨率名存实亡，低亮度段基本没法细调。

我一般给 LED 调光用 1000Hz 左右，兼顾无闪烁和分辨率。如果是驱动舵机，那是另一套逻辑，舵机要 50Hz，prescale 会大很多，这里不展开。

下面是一段初始化频率的代码，基于常见的 I2C 读写封装：

# 假设 i2c 是一个已初始化的 I2C 对象，地址 0x40 PCA9685_ADDR = 0x40 MODE1 = 0x00 PRESCALE = 0xFE def set_pwm_freq(freq_hz): # 计算 prescale，osc 取 25MHz prescale_val = int(round(25000000.0 / (4096 * freq_hz)) - 1) old_mode = i2c.read_byte_data(PCA9685_ADDR, MODE1) # 进入睡眠模式才能改 prescale i2c.write_byte_data(PCA9685_ADDR, MODE1, (old_mode & 0x7F) | 0x10) i2c.write_byte_data(PCA9685_ADDR, PRESCALE, prescale_val) # 唤醒 i2c.write_byte_data(PCA9685_ADDR, MODE1, old_mode) # 等待振荡器稳定，典型 500us time.sleep(0.005) # 重启 PWM 输出 i2c.write_byte_data(PCA9685_ADDR, MODE1, old_mode | 0x80)

这段代码里有两个关键动作：改 prescale 前必须让芯片进入 sleep（MODE1 的 bit4 置 1），否则 prescale 写不进去；改完之后要等振荡器稳定，再通过 RESTART 位（MODE1 的 bit7）重启。很多人只写了前半段，结果频率没生效，灯还是默认频率在闪，查半天查不出来。

2.3 亮度曲线：为什么你的灯低亮度段像没反应

前面说了，人眼感知非线性。如果你直接把 0 到 4095 线性映射到亮度，低亮度段（比如 OFF 值 0 到 500）人眼几乎看不出变化，而到了高亮度段，稍微动一点就感觉亮很多。解决办法是做伽马校正，把目标亮度值先做一次幂运算再写入 OFF 寄存器。

常用公式是：

off_value = int(4095 * (brightness / 4095) ** gamma)

gamma 一般取 2.2 到 2.8 之间。我实测 2.5 左右对普通 LED 比较舒服。这个运算可以在主控里做，也可以预先算好一张查找表存起来，运行时直接查表，省去浮点运算。如果你用的是资源紧张的单片机，强烈建议用查找表。

# 预生成伽马查找表，gamma=2.5 GAMMA = 2.5 gamma_table = [int(4095 * ((i / 4095.0) ** GAMMA)) for i in range(4096)] def set_brightness(channel, brightness): # brightness 范围 0-4095 off_val = gamma_table[brightness] # 写 ON 为 0，OFF 为 off_val base = 0x06 + 4 * channel i2c.write_byte_data(PCA9685_ADDR, base, 0) # ON_L i2c.write_byte_data(PCA9685_ADDR, base + 1, 0) # ON_H i2c.write_byte_data(PCA9685_ADDR, base + 2, off_val & 0xFF) # OFF_L i2c.write_byte_data(PCA9685_ADDR, base + 3, off_val >> 8) # OFF_H

注意这里写寄存器的顺序：先写 ON_L、ON_H，再写 OFF_L、OFF_H。因为 OFF_H 写入时才生效，所以把 OFF_H 放最后，保证一次更新是原子的。如果你先写了 OFF_H 再写 OFF_L，中间会有一个瞬间占空比错误，灯会闪。

3. 从零搭一套 16 路调光：接线、地址与最小验证

3.1 硬件连接与 I2C 地址配置

PCA9685 模块通常引出 VCC、GND、SCL、SDA 四根控制线，以及 V+ 和 16 路输出。这里有个大坑：VCC 是芯片逻辑供电，一般 3.3V 或 5V；V+ 是 LED 的驱动电源，可以独立供电，电压范围看模块上的稳压和电容耐压。如果你用 12V 灯带，V+ 接 12V，但 VCC 必须接 3.3V 或 5V，千万别把 12V 灌到 VCC 上，芯片会直接烧。

I2C 地址由模块上的 A0 到 A5 六个焊盘决定，默认全不接是 0x40。如果你要挂多片，就通过焊接不同组合来改地址。地址范围是 0x40 到 0x7F，共 62 个可用地址。注意 0x70 到 0x7F 这一段和某些 I2C 设备冲突，实际用的时候尽量避开。

接线时 SCL 和 SDA 要接上拉电阻，一般 4.7k 到 10k。很多模块已经自带上拉，如果你挂多片或者线拉得长，可能需要额外加。我遇到过 SDA 被拉死的情况，最后查出来是某一片模块的上拉和主控的上拉叠加，阻值太小，波形上升沿太陡导致振铃。后来把模块上的上拉拆了，只留主控端一组，就稳了。

3.2 最小验证：让第 0 路亮起来

在写复杂逻辑之前，先做最小验证：让第 0 路输出一个固定占空比，确认硬件和 I2C 通路没问题。

import time PCA9685_ADDR = 0x40 MODE1 = 0x00 LED0_ON_L = 0x06 def init_chip(): # 复位 MODE1，关闭 sleep，开启 auto-increment i2c.write_byte_data(PCA9685_ADDR, MODE1, 0x00) time.sleep(0.005) # 设置 prescale 为 1000Hz 对应的值 set_pwm_freq(1000) def set_channel(channel, on, off): base = LED0_ON_L + 4 * channel i2c.write_byte_data(PCA9685_ADDR, base, on & 0xFF) i2c.write_byte_data(PCA9685_ADDR, base + 1, on >> 8) i2c.write_byte_data(PCA9685_ADDR, base + 2, off & 0xFF) i2c.write_byte_data(PCA9685_ADDR, base + 3, off >> 8) init_chip() # 第 0 路，ON=0，OFF=2048，即 50% 占空比 set_channel(0, 0, 2048)

跑完这段，第 0 路应该以一半亮度亮起。如果没亮，先量 V+ 有没有电压，再量 SCL/SDA 有没有波形。我一般会先用 I2C 扫描工具确认地址能不能扫到，扫不到就是接线或上拉问题，扫到了但不亮就是 V+ 或输出通道问题。这个排查顺序能省很多时间。

3.3 多路同步与相位设置

16 路同时调光时，如果所有通道的 ON 都设为 0，它们会在同一个时刻一起拉高，瞬间电流很大，电源会被拉出一个坑，灯会闪。解决办法是给不同通道设置不同的 ON 相位，错开开启时刻。

比如 16 路均分 4096 个计数，每路 ON 值间隔 256：

for ch in range(16): on_val = ch * 256 off_val = on_val + 2048 # 保持 50% 占空比 if off_val > 4095: off_val -= 4096 set_channel(ch, on_val, off_val)

注意 OFF 值超过 4095 时要回绕。这种相位错开的方式对电源友好，尤其是驱动大功率 LED 时，能明显减少闪烁和电源纹波。代价是每一路的实际开启时刻不同，如果你要做严格的同步闪烁，就不能这么干，得另想办法。

4. 避坑与排查：调光不亮、闪烁、发热的 5 个真实原因

4.1 灯不亮但 I2C 能扫到地址

现象：I2C 扫描工具能看到 0x40，但所有通道都没输出。

原因：最常见的是 MODE1 的 sleep 位没清掉，芯片还在睡眠，PWM 输出关闭。其次是 prescale 没设置，芯片用默认值，但默认值也能输出，只是频率不对，不至于完全不亮。还有一种可能是输出通道的 ON 和 OFF 都写成了 0，占空比为 0，自然不亮。

解决：先读回 MODE1 寄存器，确认 bit4 是 0。再读回某一通道的 OFF 寄存器，确认不是 0。如果 MODE1 的 bit4 是 1，重新写一次唤醒序列，注意唤醒后要等 500us 再写通道值。

4.2 低亮度段闪烁或抖动

现象：占空比设得很低时，灯不是稳定微亮，而是一闪一闪的。

原因：PWM 频率太低，比如低于 200Hz，人眼能感知到闪烁。另一个原因是电源纹波太大，低占空比时驱动电流小，电源进入非连续工作模式，输出不稳。

解决：把频率提到 1000Hz 以上。如果是电源问题，在 V+ 端并一个大电容，比如 1000uF 电解加 0.1uF 陶瓷。我一般会在 V+ 和 GND 之间直接并一个 2200uF 的低阻电容，低亮度抖动基本就没了。

4.3 多路同时亮时电源被拉垮

现象：单独亮一路正常，16 路一起亮时整体变暗，甚至主控复位。

原因：所有通道同相位开启，瞬间电流是单路的 16 倍，电源和走线扛不住。另外 V+ 和 VCC 如果共用一根细线，压降会直接影响到芯片逻辑供电。

解决：用相位错开的方式设置 ON 值，把开启时刻分散开。V+ 和 VCC 分开走线，V+ 用粗线，VCC 单独从主控取。如果电流实在大，考虑分组供电，每片 PCA9685 带一部分灯。

4.4 芯片发热明显

现象：没接负载或者只接了小负载，PCA9685 芯片就烫手。

原因：输出通道的驱动能力有限，每路持续电流一般不超过 25mA，峰值 100mA。如果你直接驱动大功率 LED 没加三极管或 MOS，芯片内部输出级会过流发热。另一个原因是 VCC 电压过高，比如接了 5V 但芯片是 3.3V 版本。

解决：大功率负载必须外加驱动管，PCA9685 只负责出 PWM 信号。确认 VCC 电压和芯片规格匹配。如果只是微温，那是正常的，烫到摸不住就是有问题。

4.5 调光曲线不线性，低亮度跳变

现象：从 0 往上调，前 20% 亮度几乎没变化，然后突然亮起来。

原因：没有做伽马校正，直接线性写 OFF 值。人眼感知非线性，低占空比段的变化看不出来。

解决：用前面说的伽马查找表，把亮度值先做幂运算再写入。gamma 取 2.2 到 2.8，根据实际灯珠和观感微调。如果主控资源够，也可以用浮点实时算，但查找表更稳。

5. 进阶技巧：用查找表与相位错开把调光做稳

5.1 预生成伽马表并固化到 Flash

如果你的主控是单片机，每次上电都算一遍伽马表太浪费。我一般会在开发阶段用脚本生成一张 4096 项的查找表，直接以数组形式写进代码，固化到 Flash 里。运行时只做一次查表，速度快且不占 RAM。

生成脚本可以这样写：

GAMMA = 2.5 table = [int(4095 * ((i / 4095.0) ** GAMMA)) for i in range(4096)] # 输出成 C 数组 print("const uint16_t gamma_table[4096] = {") for i in range(0, 4096, 8): print(" " + ", ".join(str(v) for v in table[i:i+8]) + ",") print("};")

生成的数组直接贴进单片机工程，调光时off_val = gamma_table[brightness]就行。注意表是 4096 项，每项 2 字节，一共 8KB，对大多数单片机来说可以接受。如果 Flash 紧张，可以降到 1024 项，中间做线性插值，精度也够用。

5.2 相位错开的参数怎么定

相位错开的核心是让 16 路的 ON 值均匀分布在 0 到 4095 之间。间隔就是 4096 / 16 = 256。但如果你只用了 8 路，间隔可以取 512，让开启时刻更分散。

实际调的时候，我会先按均分设一遍，然后用示波器看 V+ 上的电流波形。如果还有明显的尖峰，就把间隔再调大，或者把相邻通道的 ON 值错开更多。这个没有固定公式，跟你的电源和走线关系很大，得实测。

另外，相位错开会影响占空比的精确性。因为 OFF 值要跟着 ON 值偏移，回绕处理要小心。我一般会写一个辅助函数，输入目标占空比和相位偏移，自动算出 ON 和 OFF：

def set_channel_phase(channel, duty, phase_offset): # duty 范围 0-4095 on_val = phase_offset off_val = on_val + duty if off_val > 4095: off_val -= 4096 set_channel(channel, on_val, off_val)

这样调用时只需要关心占空比和相位，不容易出错。

5.3 用示波器验证调光线性度

调光做完了，怎么确认它真的按预期工作？我一般会做两件事：一是用示波器看输出引脚的波形，确认频率和占空比跟设定值一致；二是用照度计或者手机的光传感器，测不同亮度设定下的实际光照，画一条曲线，看是不是接近伽马曲线。

如果没有示波器，也可以用逻辑分析仪抓 I2C 波形，确认寄存器写入的值正确。最土的办法是拿手机慢动作录像拍灯，看有没有闪烁。这些手段结合起来，基本能定位大部分问题。

我自己的习惯是，每次改完调光参数，先跑一遍从 0 到 4095 的扫描，用眼睛看一遍有没有跳变或者闪烁，再用示波器抽几个点确认。这个流程走下来，后面批量生产或者长期运行就很少出玄学问题。希望帮到你。

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