简介：本资源面向嵌入式开发初学者与需要精细调光的工程师，围绕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和单通道全亮测试，确认地址和极性再写业务代码。这个习惯帮我省了至少三次通宵排查。希望帮到你。本文还有配套的精品资源，点击获取
简介：本资源面向嵌入式开发初学者与需要精细调光的工程师，围绕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和单通道全亮测试，确认地址和极性再写业务代码。这个习惯帮我省了至少三次通宵排查。希望帮到你。本文还有配套的精品资源，点击获取