简介：本资源面向嵌入式开发初学者与LED调光应用开发者，围绕STM32F103C8T6驱动PCA9685实现16通道12位PWM调光展开，解决精细控制LED亮度与多路PWM输出的问题。资源包共213个文件，包含37个c源文件、38个头文件、38个编译中间文件及Keil工程文件（uvprojx、uvoptx、axf、hex等），另有少量htm、ini、lst、sct等配置与说明文件，整体约6.68MB，工程结构完整，可直接编译下载验证。内容涉及I2C通信初始化、PCA9685工作模式与PWM频率设置、各通道占空比写入等关键环节，并延伸至灯板LED阵列的亮度与颜色渐变效果设计。已有1279人学习下载，适合希望掌握STM32外设驱动与PWM调光技术的读者参考实践。
1. 从一块 16 路 PWM 板说起：PCA9685 调灯到底能解决什么
如果你玩过单片机调 LED 亮度，大概率经历过这种尴尬：用软件延时或者定时器中断去模拟 PWM，灯是亮了，但稍微多开几路就开始抖，颜色一跳一跳的，拍视频更明显。更别提同时驱动十几路 RGB 灯珠，普通 IO 口根本不够用。PCA9685 这块板子就是冲着这个痛点来的——它是一颗 I2C 接口的 16 通道 PWM 驱动芯片，每路 12 位分辨率，也就是 4096 级占空比调节，频率可编程，从几十赫兹到一千多赫兹都能设。你只需要两根线（SDA、SCL）就能挂上去，主控几乎不占资源，灯该多亮就多亮，稳得很。
它适合谁？做灯效的、搞氛围照明的、玩机械臂舵机顺便想调个指示灯的，还有那些被软件 PWM 折磨过的嵌入式新手。这篇笔记不扯芯片手册里的电气特性，只讲我实际接线、写代码、调参数、翻车再爬起来的全过程。你照着走，至少能少烧两片板子。
2. 硬件接线与 I2C 地址：先把物理层摁死
2.1 供电和电平的坑，比你想的深
PCA9685 模块通常有两种供电输入：一个是逻辑电平 VCC，一般是 3.3V 或 5V，给芯片内部逻辑用；另一个是 V+，专门给 LED 或舵机供电。很多人图省事，直接把 V+ 和 VCC 短接，用同一路 5V 带所有东西。小电流场景下能跑，但一旦你接上几路大功率 LED，电流一上来，芯片逻辑电压就被拉垮，I2C 直接掉线，灯闪得像接触不良。
我一般会这样接：主控板 3.3V 给 VCC，独立 5V 电源给 V+，两个电源的 GND 必须共地。LED 的限流电阻该加还得加，别指望芯片内部能扛。如果你用的是共阳 RGB 灯珠，注意 PCA9685 输出是开漏还是推挽——它输出级是图腾柱，可以直接驱动 LED 阴极，但灌电流能力有限，每路大概 25mA 左右，超了就得加三极管或者 MOS 管扩流。
提示：上电顺序尽量先给 VCC 再给 V+，断电反过来。热插拔 LED 灯珠的时候，最好把 V+ 断了再操作，不然瞬间电流冲击容易让芯片进入锁死状态，得重新上电才能恢复。
2.2 I2C 地址怎么改，别只会用默认的 0x40
PCA9685 的 I2C 地址由 A0 到 A5 六个引脚决定，默认全接地就是 0x40。如果你想挂多片，就得改地址。地址计算方式是：基础地址 0x40 加上 A5 到 A0 组成的二进制值。比如只把 A0 接 VCC，地址就是 0x41；A0 和 A1 都接 VCC，就是 0x43。实际接线时，这几个引脚别悬空，一定要明确拉到 VCC 或 GND，悬空会导致地址随机，I2C 扫描时有时能认到有时认不到，特别玄学。
我习惯在代码里先跑一遍 I2C 扫描，确认地址再初始化。下面这段 Python 代码用的是树莓派常见的 smbus2 库，扫描逻辑很直接：
from smbus2 import SMBus bus = SMBus(1) # 树莓派上 I2C-1 总线 found = [] for addr in range(0x03, 0x78): try: bus.read_byte(addr) found.append(hex(addr)) except OSError: pass print("I2C devices found:", found)逻辑说明：从 0x03 到 0x77 逐个地址尝试读一个字节，能读通的就是在线设备。参数上，bus 编号取决于你的主控，树莓派新版一般是 1，老版可能是 0。如果你扫出来一堆地址，检查是不是有别的 I2C 设备挂在同一条总线上。扫不到 0x40，先量 VCC 和 GND 之间电压，再查 SDA/SCL 有没有接反。
2.3 上拉电阻：不是板载了就万事大吉
很多 PCA9685 模块自带 10k 上拉电阻，短距离通信没问题。但如果你用杜邦线拉了一米以上，或者总线上挂了多个设备，波形上升沿会变缓，I2C 时钟频率一高就误码。常见做法是把上拉电阻换成 4.7k 甚至 2.2k，或者降低 I2C 速率到 100kHz。我遇到过灯板离主控两米远，调光数据偶尔丢包，灯突然全亮一下又恢复，后来把速率从 400kHz 降到 100kHz 就稳了。别迷信板载上拉，长线该加就加。
3. 寄存器配置与调光代码：把 12 位分辨率用起来
3.1 模式寄存器 MODE1 和 MODE2 到底设了什么
PCA9685 上电后默认处于睡眠状态，振荡器关闭。你要先写 MODE1 寄存器，把 SLEEP 位清零，等振荡器稳定，再决定要不要开 AI（自动递增）和 RESTART。我一般初始化流程是这样的：写 MODE1 为 0x00 唤醒，延时 500 微秒，然后写 MODE1 为 0x20 开启自动递增，这样后面写多路 PWM 时可以连续写寄存器，不用每次都发地址。MODE2 寄存器主要设输出驱动模式，默认是开漏，如果你驱动 LED 阴极，可以设成推挽输出，驱动能力强一点。具体值看你的硬件，我通常写 0x04，也就是 OUTDRV 置 1。
频率设置靠 PRE_SCALE 寄存器，公式是：prescale = round(25MHz / (4096 × freq)) - 1。比如你要 1000Hz，算出来约等于 5，写进去就行。注意这个寄存器只能在 SLEEP 模式下写，写完再唤醒。很多人忘了这点，频率死活改不了，还以为芯片坏了。
3.2 写一个能用的 Python 调光类
下面这段代码封装了初始化和设置占空比的方法，基于 smbus2，可以直接抄：
import time from smbus2 import SMBus class PCA9685: MODE1 = 0x00 MODE2 = 0x01 PRESCALE = 0xFE LED0_ON_L = 0x06 def __init__(self, bus_num=1, addr=0x40): self.bus = SMBus(bus_num) self.addr = addr self._init_chip() def _init_chip(self): # 唤醒并开启自动递增 self.bus.write_byte_data(self.addr, self.MODE1, 0x00) time.sleep(0.005) # 设置推挽输出 self.bus.write_byte_data(self.addr, self.MODE2, 0x04) # 设置频率为 1000Hz prescale = round(25000000 / (4096 * 1000)) - 1 old_mode = self.bus.read_byte_data(self.addr, self.MODE1) # 进入睡眠才能写 prescale self.bus.write_byte_data(self.addr, self.MODE1, (old_mode & 0x7F) | 0x10) self.bus.write_byte_data(self.addr, self.PRESCALE, prescale) self.bus.write_byte_data(self.addr, self.MODE1, old_mode & 0xEF) time.sleep(0.005) # 开启自动递增 self.bus.write_byte_data(self.addr, self.MODE1, (old_mode & 0xEF) | 0x20) def set_pwm(self, channel, on, off): # on 和 off 都是 0-4095 的 12 位值 base = self.LED0_ON_L + 4 * channel self.bus.write_byte_data(self.addr, base, on & 0xFF) self.bus.write_byte_data(self.addr, base + 1, on >> 8) self.bus.write_byte_data(self.addr, base + 2, off & 0xFF) self.bus.write_byte_data(self.addr, base + 3, off >> 8) def set_duty(self, channel, duty): # duty 范围 0.0 到 1.0 off = int(duty * 4095) self.set_pwm(channel, 0, off)逻辑说明：_init_chip里先唤醒，设 MODE2 为推挽，然后算 prescale 并在睡眠状态下写入，最后开自动递增。set_pwm里 on 一般设 0，off 决定占空比。set_duty把 0 到 1 的浮点数映射到 0 到 4095。参数上，channel 从 0 到 15，duty 别超过 1.0，否则 off 溢出会变成 0，灯反而全灭。如果你要相位偏移，可以调 on 的值，但一般调光用不上。
3.3 多路呼吸灯效果：别用 delay 硬等
想让 16 路 LED 同时呼吸，最忌讳在循环里用time.sleep逐路延时，那样各路相位不一致，看起来像波浪。正确做法是算一个全局相位，每路用同一个时间基准去算占空比。下面这个片段展示思路：
import math import time pca = PCA9685() start = time.time() while True: t = time.time() - start # 用正弦波做呼吸，周期 2 秒 duty = (math.sin(t * math.pi) + 1) / 2 for ch in range(16): # 每路稍微错开一点相位，形成流水感 phase = ch * 0.1 d = (math.sin(t * math.pi + phase) + 1) / 2 pca.set_duty(ch, d) time.sleep(0.02)逻辑说明：用time.time()做全局时间戳，每路加一个相位偏移，这样呼吸不同步但流畅。time.sleep(0.02)控制刷新率约 50Hz，再低会看出闪烁。参数上，相位偏移量决定流水速度，0.1 弧度大概对应每路延迟几十毫秒。注意别在循环里频繁写 I2C，16 路全写一遍大概几毫秒，如果主控性能弱，可以只写变化明显的通道。
4. 避坑与排查：那些让我重新焊线的瞬间
4.1 灯珠微亮关不掉
现象：设置占空比为 0，LED 还是微微发亮，暗环境下很明显。原因：PCA9685 输出级在 0 占空比时并不是完全关断，尤其是开漏模式下有漏电流。解决：把 MODE2 设成推挽输出，或者在 LED 两端并联一个几百欧的电阻泄放。如果还不行，检查 V+ 是不是偏高，适当降低供电电压。
4.2 I2C 通信随机失败
现象：程序跑着跑着报OSError: [Errno 121] Remote I/O error，重启又好了。原因：总线电容过大或者上拉太弱，长线时波形边沿变缓，高速下误码。解决：降低 I2C 速率到 100kHz，换 4.7k 上拉，缩短杜邦线，或者用屏蔽线。我后来直接给 SDA/SCL 各串了一个 100 欧电阻，抑制振铃，稳定很多。
4.3 频率设了没反应
现象：改了 prescale，用示波器量输出频率还是默认的 200Hz 左右。原因：prescale 寄存器只能在 SLEEP 位置 1 时写，写完必须清 SLEEP 并等待振荡器稳定。解决：严格按照「读 MODE1 → 置 SLEEP → 写 prescale → 清 SLEEP → 延时 500us」的顺序来。别偷懒直接写，芯片不认。
4.4 多片级联地址冲突
现象：挂了两片 PCA9685，只能控制其中一片，另一片没反应。原因：两片地址一样，I2C 总线冲突。解决：改 A0 到 A5 的接线，确保地址不同。改完重新扫描确认。如果懒得改硬件，也可以用 I2C 多路复用器，但成本高，不如改地址方便。
4.5 舵机抖动和调光互相干扰
现象：同一块板子上，几路接舵机，几路接 LED，舵机一动 LED 就闪。原因：舵机启动电流大，把 V+ 拉低，导致 LED 供电波动。解决：舵机和 LED 分开供电，或者给 V+ 加大电容（比如 1000uF 以上）。我一般会在 V+ 和 GND 之间并一个 2200uF 电解电容，再并一个 0.1uF 陶瓷电容，效果立竿见影。
5. 进阶技巧：用校准曲线把调光做顺滑
PCA9685 的 12 位分辨率是线性的，但人眼对亮度的感知是非线性的，近似对数关系。如果你直接按线性占空比调光，低亮度区变化太快，高亮度区又看不出差别。我一般会做一条伽马校正曲线，把占空比映射一下。下面这个函数把 0 到 1 的输入映射到校正后的占空比：
def gamma_correct(value, gamma=2.2): # value 范围 0.0 到 1.0 return value ** gamma逻辑说明：gamma 取 2.2 是常见显示标准，你也可以根据实际灯珠调成 1.8 到 2.8 之间。用法就是pca.set_duty(ch, gamma_correct(d))。这样低亮度时占空比压得更低，变化更细腻，高亮度时拉开差距，整体过渡顺滑很多。
另一个技巧是给每路 LED 做单独校准。因为灯珠个体差异，同样的占空比亮度可能差百分之十几。我习惯在产线或者组装完成后，用手机摄像头测一下每路在固定占空比下的亮度，然后给每路存一个系数，调光时乘上去。虽然麻烦，但做多灯阵列时效果提升明显。
验证方法很简单：写一个从 0 到 1 缓慢增加的循环，用肉眼观察有没有跳变。如果某一段突然变亮，说明 gamma 值不合适，微调再试。我一般会反复调三四次，直到过渡像呼吸一样自然。
从那以后我每次拿到新的 PCA9685 模块，都先跑一遍 I2C 扫描、量一遍供电、再写一个单路呼吸测试，确认没问题才上整机。这套流程帮我省了不少返工时间。希望帮到你。
本文还有配套的精品资源，点击获取
