简介：本资源面向嵌入式开发初学者与需要精细调光的工程师，围绕STM32F103C8T6驱动PCA9685实现16通道12位PWM调光展开，可用于LED灯板、照明控制及马达驱动等场景。压缩包共213个文件，约6.68MB，包含37个c源文件、38个h头文件、38个o目标文件与37个crf编译记录，另有uvprojx、uvoptx工程文件、hex烧录文件、sct分散加载文件及map映射文件，覆盖从源码到编译产物的完整Keil工程结构。资源中可见stm32f10x_i2c.c、stm32f10x_tim.c等标准外设库文件，便于理解I2C通信与PWM寄存器配置流程。已有1279人学习下载，读者可借此掌握PCA9685的占空比设定、频率预设与多通道扩展方法，并参考灯板项目的硬件连接与亮度渐变控制思路，快速搭建可运行的调光系统。

1. PCA9685PWM调灯：从一盏灯到十六路呼吸灯的落地路径

如果你手头有一块 PCA9685 模块和几路 LED，想用单片机做出丝滑的呼吸灯、渐变灯带或者多路独立调光，那这套 PCA9685PWM调灯 的代码就是直接能抄的作业。PCA9685 是 16 通道、12 位精度的 PWM 驱动芯片，通过 I2C 两线就能控制 16 路独立占空比，比单片机软件 PWM 省心得多，也不占用主循环时间。这份资源围绕它做了一套完整的调灯实现，覆盖初始化、频率设置、单通道亮度控制、多通道渐变和呼吸灯效果。适合刚接触 I2C 外设的新手照着跑通，也适合做灯控、氛围灯、舞台灯二次开发的熟手直接改参数。下面按「能干什么 → 怎么跑 → 怎么改」拆开讲。

2. 硬件接线与 I2C 初始化：先把芯片叫醒

2.1 模块引脚与供电的取舍

PCA9685 模块上通常有 VCC、GND、SCL、SDA、V+ 和 16 组 PWM 输出。VCC 是芯片逻辑供电，常见接 3.3V 或 5V；V+ 是 LED 驱动供电，可以独立接更高电压，比如 5V 或 12V，具体看灯珠规格。这里有个血泪经验：很多人把 V+ 和 VCC 短接后直接上 12V，芯片当场冒烟。逻辑侧和驱动侧一定要分开供电，共地即可。

I2C 地址由模块上的 A0~A5 焊盘决定，默认全不焊是 0x40。如果你挂多个 PCA9685，就要改地址，否则总线冲突，读回来全是 0xFF。常见做法是拿万用表量一下 A0~A5 对地通断，确认地址再写代码。

2.2 初始化寄存器配置

PCA9685 上电后处于睡眠模式，必须先把 MODE1 寄存器的 SLEEP 位清零才能写频率。下面这段初始化代码是这套资源的核心入口：

import time from smbus2 import SMBus PCA9685_ADDR = 0x40 MODE1 = 0x00 PRESCALE = 0xFE LED0_ON_L = 0x06 class PCA9685: def __init__(self, bus=1, addr=PCA9685_ADDR): self.bus = SMBus(bus) self.addr = addr self._init_chip() def _init_chip(self): # 复位：写 0x06 到 MODE1，等待振荡器稳定 self.bus.write_byte_data(self.addr, MODE1, 0x06) time.sleep(0.005) # 设置 PWM 频率为 1000Hz，prescale 计算公式见下文 prescale = int(25000000.0 / 4096.0 / 1000.0 - 1 + 0.5) old_mode = self.bus.read_byte_data(self.addr, MODE1) # 进入睡眠才能改 prescale self.bus.write_byte_data(self.addr, MODE1, (old_mode & 0x7F) | 0x10) self.bus.write_byte_data(self.addr, PRESCALE, prescale) # 唤醒并开启自动递增 self.bus.write_byte_data(self.addr, MODE1, old_mode & 0xEF) time.sleep(0.005) self.bus.write_byte_data(self.addr, MODE1, old_mode | 0xA1)

逻辑说明：MODE1写 0x06 是软件复位，让芯片回到已知状态。prescale决定 PWM 频率，公式是round(25MHz / (4096 * freq)) - 1，这里 25MHz 是内部振荡器标称值。改频率必须先置 SLEEP 位，否则写入无效，这是新手最容易翻车的地方。最后old_mode | 0xA1打开 AI（自动递增）和 RESTART，让后续连续写寄存器时地址自动加一，省去每次指定寄存器。

参数说明：bus是 I2C 总线号，树莓派上一般是 1；addr是 7 位地址；freq建议 100~1500Hz，太低灯会闪，太高部分 LED 驱动会发热。

2.3 频率与分辨率的权衡

12 位分辨率意味着每个通道有 4096 级。频率越高，每级时间越短，低亮度区越容易丢步。做呼吸灯一般 1000Hz 足够，做摄像头同步或消除频闪可以上 1500Hz。如果发现低亮度时灯直接灭，不是代码错，是频率太高导致最小占空比时间小于 LED 响应时间，降到 500Hz 试试。

3. 单通道与多通道调光：把亮度写进寄存器

3.1 单通道亮度写入

每个通道有四个寄存器：ON_L、ON_H、OFF_L、OFF_H，组成 12 位 ON 和 OFF 计数。要让通道输出占空比 D，通常把 ON 设为 0，OFF 设为D * 4096。下面是对应实现：

def set_pwm(self, channel, on, off): # 每个通道占 4 个寄存器，基地址 0x06 base = 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_level(self, channel, level): # level 取值 0~4095 level = max(0, min(4095, level)) self.set_pwm(channel, 0, level)

逻辑说明：set_pwm把 12 位值拆成低 8 位和高 4 位分别写入。set_level做了一次钳位，防止越界写坏寄存器。注意 ON 和 OFF 都是 12 位，如果 ON 大于 OFF，输出会反相，这是芯片特性，不是 bug。

参数说明：channel0~15；level0 全灭，4095 全亮。实际灯珠亮度非线性，人眼对低亮度更敏感，所以后面要做伽马校正。

3.2 多通道渐变与呼吸灯

呼吸灯本质是让 level 按正弦或三角波变化。下面这段用正弦查表做 16 通道同步呼吸：

import math def breathing(self, channels, period=2.0, steps=100): # channels 是通道列表，period 是呼吸周期秒 for i in range(steps): # 正弦映射到 0~4095 val = int((math.sin(2 * math.pi * i / steps - math.pi / 2) + 1) / 2 * 4095) for ch in channels: self.set_level(ch, val) time.sleep(period / steps)

逻辑说明：sin从 -π/2 开始，保证起始亮度为 0，避免上电瞬间全亮刺眼。steps决定平滑度，100 步在 2 秒周期下每步 20ms，肉眼基本看不出跳变。如果灯带出现阶梯感，把 steps 加到 200，或者降低周期。

参数说明：channels可以传range(16)做全通道，也可以只传[0, 1, 2]做局部。period太短会像频闪，建议 1.5~3 秒。

3.3 伽马校正让渐变更顺

直接线性写 level，低亮度区变化太快，高亮度区又看不出差别。常见做法是加一张伽马表：

GAMMA = 2.2 gamma_table = [int((i / 4095.0) ** GAMMA * 4095) for i in range(4096)] def set_level_gamma(self, channel, level): self.set_level(channel, gamma_table[level])

逻辑说明：伽马 2.2 接近人眼感知曲线，低亮度区被压缩，渐变看起来均匀很多。这张表在初始化时算一次，后续直接查表，不增加运行开销。

参数说明：GAMMA可以调，1.0 是线性，2.5 更暗部细腻。做白光照明建议 2.2，做彩色混光可以降到 1.8。

4. 避坑与排查：调灯路上最容易翻的五个坑

4.1 灯不亮，I2C 扫不到地址

现象：运行代码没报错，但灯全灭，i2cdetect看不到 0x40。 原因：SDA/SCL 接反，或者模块没共地，或者 VCC 没供上。 解决：先量 VCC 对 GND 是不是 3.3V/5V，再确认 SDA 接 SDA、SCL 接 SCL，最后跑i2cdetect -y 1确认地址。地址是 0x70 说明进了广播模式，检查 A0~A5 有没有虚焊。

4.2 改了频率没反应

现象：调用设置频率的函数后，示波器量出来还是默认 200Hz。 原因：没有先置 SLEEP 位就写 PRESCALE，芯片忽略写入。 解决：严格按「读 MODE1 → 置 SLEEP → 写 PRESCALE → 清 SLEEP → 等 5ms → 置 RESTART」的顺序，中间不能省。

4.3 低亮度直接熄灭

现象：level 设 1~50 时灯完全不亮，设 100 才亮。 原因：PWM 频率太高，最小脉宽小于 LED 驱动响应时间，或者 LED 本身有开启阈值。 解决：把频率降到 500Hz 以下，或者用伽马表把低亮度区抬起来。如果是恒流驱动，检查使能脚有没有拉高。

4.4 多通道呼吸不同步

现象：16 路呼吸灯有的快有的慢，像波浪。 原因：在循环里逐个set_level，I2C 写入有先后，通道多了累积延迟明显。 解决：用自动递增模式，一次性写连续寄存器；或者把 steps 调大，让每步延迟远大于 I2C 写入时间。常见做法是先把 16 通道的值算好放数组，再连续写。

4.5 灯珠发热严重

现象：运行几分钟后 LED 烫手，亮度还往下掉。 原因：V+ 电压超过灯珠额定，或者限流电阻没加，或者频率太低导致导通时间过长。 解决：确认灯珠规格，串限流电阻，频率提到 1000Hz 以上。如果是大功率 LED，必须用恒流驱动，PCA9685 只出 PWM 信号，不直接扛电流。

5. 二次开发：把调灯代码改成你自己的灯控逻辑

这套代码最值钱的地方不是呼吸灯本身，而是它把 PCA9685 的寄存器操作封成了一个干净的对象。你要做二次开发，第一步就是继承或组合这个类，把业务逻辑和底层驱动分开。我一般会这么做：新建一个LightController类，持有PCA9685实例，对外只暴露set_scene(name)、fade_to(channel, target, duration)这类语义接口，底层寄存器读写完全不外露。

改造时优先动三个地方。第一是频率，如果你的灯带是 WS2812 这类自带芯片的，PCA9685 不适用，但如果是普通 RGB 灯珠，把频率设到 1200Hz 可以配合摄像头拍摄不频闪。第二是伽马表，彩色混光时三通道伽马要一致，否则混出来的白色会偏绿或偏紫，我习惯用同一张表，再单独微调 R/B 通道的增益。第三是刷新策略，做动态场景时不要每帧全量写 16 通道，只写变化的通道，I2C 总线在 100kHz 下写 16 通道要 1ms 以上，场景复杂了会卡。

验证方法很简单：拿手机慢动作录像拍灯，看有没有条纹或跳变；再用示波器量 PWM 脚，确认频率和占空比跟设定一致。如果做多模块级联，记得每个模块地址不同，初始化时逐个复位，别指望一条 I2C 上电就全好。

下面是一个场景切换的改造示例：

class LightController: def __init__(self, pca): self.pca = pca self.scenes = { "warm": [(255, 180, 120)] * 16, "cool": [(180, 220, 255)] * 16, } def set_scene(self, name, gamma=True): colors = self.scenes.get(name) if not colors: return for ch, (r, g, b) in enumerate(colors): # 这里假设每 3 通道一组 RGB base = ch * 3 for i, v in enumerate((r, g, b)): level = int(v / 255 * 4095) if gamma: level = gamma_table[level] self.pca.set_level(base + i, level)

逻辑说明：场景表用 0~255 的 RGB 值，写寄存器前映射到 0~4095，再走伽马表。base = ch * 3是假设 16 通道里每 3 路接一组 RGB，实际接线按你的灯板来调。参数gamma留了开关，调试阶段可以关掉看原始线性效果。

从那以后我每次接新灯板，都强制先跑一遍i2cdetect和单通道全亮测试，确认地址和极性再写业务代码。这个习惯帮我省了至少三次通宵排查。希望帮到你。

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