企业官网建设流程全解析

简介：这是一份面向STM32初学者的PCA9685驱动资源，基于STM32F103C8T6实现，核心代码精简到仅两个函数即可控制舵机角度与LED亮度，适合需要快速移植、不愿折腾复杂库函数的开发者。资源包共185个文件，以c/h源文件与Keil工程文件为主，同时包含编译生成的目标文件、链接映射文件及Hex烧录文件，压缩包约5.09MB。工程内还集成了定时器、ADC、I2C、USART等常见外设驱动文件，方便参考寄存器级配置与底层调用。目前已有6500余人学习下载，属于小型实用型代码包，复制c/h文件即可接入现有工程，亲测可用。对正在调试舵机控制板或想做LED呼吸灯效果的用户来说，能省去重复造轮子的时间，直接获得一套可运行的最小实现。

1. 一块小板子驱动16路舵机：PCA9685到底解决了什么问题

做机器人底盘或者六足的时候，最常见的翻车现场不是算法写不出来，而是单片机引脚不够用。某开发者的板子只有几个定时器输出通道，却要同时控制6个舵机加8个LED，最后只能拿一堆引脚硬凑，还得不断切换复用功能，代码乱成一团。PCA9685这种16路PWM驱动芯片，就是专门来终结这种局面的：它用I2C两根线挂在STM32上，最多级联62个芯片，扩展出近千路PWM输出。对STM32F103C8T6这种小容量芯片来说，用PCA9685控制舵机和LED是最省引脚、也最容易上手的方案。

本文要讲的是怎么用寄存器级、尽量少的代码把这块芯片跑起来。标题说“代码极简可用”，我不打算甩给你一个几千行的工程模板，而是把I2C读写、初始化、舵机角度映射和LED亮度控制拆成几个可以单独复制的函数。读完你手里的国产小板子就能动起来，后面想加平滑控制还是断电保持，也有明确的改动路径。

2. 先懂握手机制：I2C地址、寄存器映射与50Hz频率从哪来

2.1 PCA9685的7位地址：为什么默认是0x40

买到的PCA9685模块几乎都是地址0x40，这不是巧合，而是因为模块上A0到A5六个地址引脚全部接地。芯片的7位地址是固定的1000000（二进制），最低位由A2、A1、A0组合决定，接地时为0，所以I2C地址是0x40。如果你在一条总线上级联多块板子，把某一块的A0焊到高电平，它的地址就变成0x41，注意这里说的0x40是7位地址左移一位后的8位写法，很多人的困惑就出在这个左移上。

用模拟I2C自己拼起始位、应答位时，直接往总线发0x40 << 1作为写地址，读操作发(0x40 << 1) | 1。用硬件I2C外设时，设备地址寄存器填的是0x40（7位），不左移。这两种写法差一比特，我见过太多人在这上面折腾一下午。确认地址的方法也很简单：模块背面丝印或者万用表量A0到A5对地电压，全为0就是0x40。

2.2 关键寄存器：MODE1、PRE_SCALE与LED0_ON_L

PCA9685内部寄存器按地址从0x00到0xFE分布，控制舵机真正需要关心的只有三个区域。MODE1（0x00）是模式寄存器，上电后默认值0x00相当于芯片在运行状态，但内部振荡器还没按你想要的频率工作，所以第一步通常是写0x10进入休眠，再改预分频，最后写0x00唤醒。

LED0_ON_L（0x06）开始是16个通道的PWM寄存器组，每个通道占用4个字节：ON_L、ON_H、OFF_L、OFF_H。舵机控制只用到OFF寄存器就够了，意思是“在这个周期内关断的时间点”（计数点）；LED调光则要配合ON和OFF一起用，因为两个计数点的差值才是有效占空比。PRE_SCALE（0xFE）是预分频寄存器，决定PWM频率。

注意：MODE1里的SLEEP位（bit4）置1后，芯片会忽略所有通道寄存器写入，修改PRE_SCALE之前必须先进入休眠。很多人改完频率没反应，就是漏了这一步。

2.3 频率计算：给舵机的50Hz怎么算出来

PCA9685内部振荡器标称25MHz，但实际有2%到3%的误差，所以手册给出的公式里带了一个校正项。输出频率f、预分频值prescale和振荡频率osc_clock的关系是prescale = osc_clock / (4096 * f) - 1。反过来，已知prescale时实际频率也能算出来。舵机通常需要50Hz，也就是20ms周期，代入25MHz算出prescale ≈ 121.3，取121。这个细微差别会在舵机角度标定时暴露出来，后面再讲。

osc_clock = 25000000 # PCA9685内部振荡器标称值，单位Hz target_freq = 50 # 舵机标准频率，单位Hz prescale = round(osc_clock / (4096 * target_freq)) - 1 print(f"PRE_SCALE 寄存器应写入: 0x{prescale:02X}") # 输出0x79，即121 actual_freq = osc_clock / (4096 * (prescale + 1)) print(f"实际输出频率: {actual_freq:.2f} Hz")

你说它是50Hz还是50.03Hz其实无所谓，但要注意prescale必须取整数，取整方向会影响最终频率。对舵机来说50Hz和49.9Hz在肉眼层面看不出差别，但对精确角度控制来说，同一个脉宽在不同频率下对应的角度会有差异，所以后面标定角度时不能只看代码里的公式。

3. 用GPIO模拟I2C把PCA9685跑起来：两个文件复制即用

3.1 模拟I2C的读写函数实现

STM32F103C8T6上有硬件I2C外设，但它的时钟配置和中断处理对新手不太友好，尤其是一不小心就会卡在BSY标志上。我在这类场景的常见做法是直接用GPIO模拟I2C，因为PCA9685的工作频率最高也就400kHz，单片机跑72MHz时用延时翻转GPIO完全来得及，而且代码量小、行为可预期。下面是我常用的一套极简模拟I2C实现：

// pca9685_i2c.c - 基于GPIO模拟I2C的最小实现 // SCL=PB6, SDA=PB7，使用开漏输出 + 外部上拉电阻 #include "stm32f10x.h" #include "pca9685_i2c.h" #define SCL_H() GPIOB->BSRR = GPIO_Pin_6 #define SCL_L() GPIOB->BRR = GPIO_Pin_6 #define SDA_H() GPIOB->BSRR = GPIO_Pin_7 #define SDA_L() GPIOB->BRR = GPIO_Pin_7 #define SDA_READ() (GPIOB->IDR & GPIO_Pin_7) static void i2c_delay(void) { for (volatile int i = 0; i < 20; i++); // 大约5us@72MHz } void i2c_init(void) { GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); gpio.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; gpio.GPIO_Mode = GPIO_Mode_Out_OD; // 开漏输出，必须配上拉电阻 gpio.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &gpio); SCL_H(); SDA_H(); } static void i2c_start(void) { SDA_H(); SCL_H(); i2c_delay(); SDA_L(); i2c_delay(); // SDA先拉低，建立起始条件 SCL_L(); i2c_delay(); } static void i2c_stop(void) { SDA_L(); SCL_H(); i2c_delay(); SDA_H(); i2c_delay(); // 空闲态必须SDA、SCL都为高 } static uint8_t i2c_write_byte(uint8_t data) { for (int i = 7; i >= 0; i--) { if (data & (1 << i)) SDA_H(); else SDA_L(); SCL_H(); i2c_delay(); SCL_L(); i2c_delay(); } SDA_H(); // 释放SDA，等待从机应答 SCL_H(); i2c_delay(); uint8_t ack = (SDA_READ() == 0) ? 0 : 1; SCL_L(); i2c_delay(); return ack; }

逻辑说明：起始条件必须是SCL高电平时SDA从高变低，所以严格按照SDA拉低、再拉低SCL的顺序执行。每个字节高位先发，发完第8位后释放SDA读取应答位。PCA9685正常应答时会把SDA拉低，所以读到低电平表示写入成功。开漏输出模式下，SDA_H只是让引脚不驱动，真正的高电平靠外部上拉电阻维持，因此4.7kΩ上拉是必须的，这点下面避坑章节会再强调。

3.2 初始化配置：复位、休眠、设置频率

有了基础I2C函数，PCA9685的初始化逻辑就非常直白了。先软复位让所有寄存器回到默认值，再进入休眠修改预分频，最后唤醒并设置MODE2的默认输出模式。代码里把写寄存器的操作封装成一个函数，后续控制舵机和LED都复用它。

// 写一个寄存器：reg为寄存器地址，val为要写入的值 void pca9685_write_reg(uint8_t reg, uint8_t val) { i2c_start(); i2c_write_byte(0x40 << 1); // 设备写地址，0x40左移一位 i2c_write_byte(reg); i2c_write_byte(val); i2c_stop(); } uint8_t pca9685_read_reg(uint8_t reg) { uint8_t val = 0; i2c_start(); i2c_write_byte(0x40 << 1); // 仍是写方向，先发寄存器地址 i2c_write_byte(reg); i2c_start(); // 重复起始位 i2c_write_byte((0x40 << 1) | 1); // 读方向 val = i2c_read_byte(0); // 最后一个字节回NACK i2c_stop(); return val; } void pca9685_init(void) { pca9685_write_reg(0x00, 0x00); // MODE1正常模式 pca9685_write_reg(0x00, 0x10); // 进入SLEEP，准备改PRE_SCALE pca9685_write_reg(0xFE, 0x79); // PRESCALE=121，对应约50Hz pca9685_write_reg(0x00, 0x80); // 退出SLEEP，RESTART=1 pca9685_write_reg(0x01, 0x04); // MODE2: OUTDRV=1，开漏输出带驱动能力 }

参数说明：0x79是121的十六进制写法，对应50Hz。MODE2写入0x04的含义是输出驱动方式配置为推挽驱动模式，这样每个PWM输出脚的拉电流能力更强，驱动LED时亮度更稳定。有人喜欢在MODE2写0x00，后续接LED时会出现亮度反向，第5章会详细讲。

3.3 舵机角度映射函数：把0到180度换算成计数值

舵机角度和脉宽不是线性对应占空比的绝对值，而是对应脉宽本身。常见舵机的脉宽范围是0.5ms到2.5ms，对应0°到180°，中间值1.5ms是90°。PCA9685的计数器从0走到4095对应一个完整的PWM周期，在50Hz下周期20ms，所以每个计数单位约4.88us。用脉宽除以单计数时间就能得到OFF计数。

// 舵机角度0~180映射到计数值，以20ms周期为基准 // 0.5ms=102, 1.5ms=307, 2.5ms=512（取整后） uint16_t servo_angle_to_pwm(uint8_t angle) { // 脉宽范围0.5ms~2.5ms，按线性比例扩展到1.0ms~2.0ms以内更安全 uint32_t pulse_us = 500 + (uint32_t)angle * 1000 / 180; // 单位us return (uint16_t)(pulse_us * 4096 / 20000); // 转换为12位计数 } void servo_set_angle(uint8_t channel, uint8_t angle) { uint16_t off = servo_angle_to_pwm(angle); // 对应寄存器地址 LED0_ON_L + channel * 4 pca9685_write_reg(0x06 + channel * 4, 0x00); // ON_L = 0 pca9685_write_reg(0x06 + channel * 4 + 1, 0x00); // ON_H = 0 pca9685_write_reg(0x06 + channel * 4 + 2, off & 0xFF); // OFF_L pca9685_write_reg(0x06 + channel * 4 + 3, (off >> 8) & 0x0F); // OFF_H只用到低4位 }

逻辑说明：ON值固定为0意味着每个周期从计数0开始输出高电平，OFF值决定了高电平持续到哪个计数点，这样输出的脉宽就是OFF乘以4.88us。计算中我把0.5ms到2.5ms的跨度直接按角度比例插值，实际舵机在中位附近的线性度最好，两端的0度和180度通常会差几个计数，等第5章再讲标定。OFF_H寄存器只有低4位有效，写之前要跟0x0F做与运算，防止高位多余数据污染。

3.4 LED控制：常亮、熄灭与PWM调光

LED和舵机的寄存器写法不同，舵机只用OFF，LED则利用ON和OFF两个计数点的差值。如果希望LED按某个占空比点亮，就把ON设为0、OFF设为目标占空比对应计数；如果希望常亮，可以把ON_L写0x00、ON_H写0x10（即第4096个计数），OFF写0。ON_H最高位（bit4）为1表示ON计数等于4096，也就是周期起始点前触发，这样PWM输出在整个周期都保持高。

// LED亮度0~100，0为灭，100为全亮 void led_set_brightness(uint8_t channel, uint8_t percent) { if (percent == 0) { // 完全熄灭：OFF=0，周期内无高电平 pca9685_write_reg(0x06 + channel * 4, 0x00); pca9685_write_reg(0x06 + channel * 4 + 1, 0x00); pca9685_write_reg(0x06 + channel * 4 + 2, 0x00); pca9685_write_reg(0x06 + channel * 4 + 3, 0x00); } else if (percent >= 100) { // 常亮：ON计数置为4096，OFF计数为0 pca9685_write_reg(0x06 + channel * 4, 0x00); pca9685_write_reg(0x06 + channel * 4 + 1, 0x10); // bit4=1, ON=4096 pca9685_write_reg(0x06 + channel * 4 + 2, 0x00); pca9685_write_reg(0x06 + channel * 4 + 3, 0x00); } else { uint16_t off = (uint16_t)(percent * 4096 / 100); pca9685_write_reg(0x06 + channel * 4, 0x00); // ON=0 pca9685_write_reg(0x06 + channel * 4 + 1, 0x00); pca9685_write_reg(0x06 + channel * 4 + 2, off & 0xFF); pca9685_write_reg(0x06 + channel * 4 + 3, (off >> 8) & 0x0F); } }

参数说明：percent换算的off值就是12位占空比计数值，比如50%对应2048。把ON设为0、OFF设为2048时，每个周期前一半输出高电平，LED亮度约为一半。这里我特别处理了全亮和全灭两个边界，因为ON计数为4096这个特殊值是很多人容易忽略的，想让LED全亮却写成OFF=4096，反而会造成一个周期内输出一直为低。

4. 把角度写进寄存器：三行代码驱动舵机转起来

4.1 写通道寄存器的位序规则

每个通道4个寄存器按连续地址排列，通道0从0x06开始，通道1从0x0A开始，依此类推。ON_L、ON_H、OFF_L、OFF_H四个寄存器共同组成两个12位计数，写入时必须把低8位写进_L，高4位写进_H。这里有个容易出错的细节：OFF_H和ON_H都只用了低4位，高4位保留，所以写值时必须做& 0x0F掩码。

有些模块的手册里会写“当ON=4096且OFF=0时输出常高”，而ON=0且OFF=4096时输出常低。我的经验是优先使用常亮走ON=4096这条路，因为把OFF设为4096在某些固件版本里会和下一个周期的输出产生一拍延迟，表现为LED闪烁一下。位序这个东西不看手册很容易踩坑，尤其是从51单片机移植过来的朋友，容易按字节连续写导致通道错乱。

4.2 设置舵机角度与LED亮度的完整调用

初始化完成之后，主循环里的调用代码可以精简到一个函数一行：

int main(void) { i2c_init(); // 初始化模拟I2C引脚 pca9685_init(); // 复位、设50Hz、唤醒 // 通道0接舵机，通道15接LED servo_set_angle(0, 90); // 舵机转到90度 led_set_brightness(15, 60); // LED亮度60% while (1) { // 分阶段转动：0度 -> 180度 -> 90度 for (uint8_t a = 0; a <= 180; a += 10) { servo_set_angle(0, a); delay_ms(50); } for (uint8_t a = 180; a > 0; a -= 10) { servo_set_angle(0, a); delay_ms(50); } } }

逻辑说明：这里故意每次转10度而不是1度，是为了让你先跑通功能再谈平滑。如果直接用a++且不加延时，舵机会因为速度跟不上控制指令而出现啸叫或过载，这是给舵机供电的第一课。led_set_brightness放在主循环前设置一次，后续不需要反复写相同寄存器，本身PCA9685会保持输出状态。

4.3 多路同时控制的顺序问题

如果你要同时控制多个舵机，最直接的做法是按顺序调用servo_set_angle，PCA9685会等最后一个寄存器写完后的下一个周期统一更新输出。这意味着函数返回时，舵机并没有立刻转到目标角度，而是等到当前PWM周期结束。这种设计的好处是多路舵机在同一个周期内切换到新脉宽，不会出现一路先动、一路后动的割裂感。

我一般会把多路角度打包进一个结构体，再统一写入：

typedef struct { uint8_t ch; // 通道号 uint8_t angle; } servo_cmd_t; void servo_set_batch(servo_cmd_t *cmds, uint8_t count) { for (uint8_t i = 0; i < count; i++) { uint16_t off = servo_angle_to_pwm(cmds[i].angle); uint8_t base = 0x06 + cmds[i].ch * 4; pca9685_write_reg(base + 2, off & 0xFF); pca9685_write_reg(base + 3, (off >> 8) & 0x0F); } }

参数说明：批量写比逐个调用serve_set_angle少了两次ON寄存器的写入，对性能提升有限，但对I2C总线生命周期有好处，减少了总线上不必要的流量。对STM32F103C8T6来说，软件模拟I2C跑在5us每比特的速度，写一个通道需要约200us，批量写可以在一个周期内完成全部通道更新，避免舵机不同步。

5. 避坑：供电、地址与抖动的几个血泪经验

5.1 现象：舵机抖得像筛糠，第一反应该查电源

舵机转动瞬间电流很大，一个9g舵机堵转电流能到700mA以上，开发板的3.3V稳压芯片根本带不动。常见错误是把舵机电源接在STM32板的5V输出引脚上，结果一转动电压跌落，PCA9685也进入欠压复位，表现就是舵机来回抖动、LED同时闪。

原因：PCA9685的逻辑供电和舵机电源共用一个不稳压电源，电流瞬变把逻辑电压拉低到欠压阈值以下。

解决：分开供电，PCA9685的VCC接3.3V或者5V都可以，舵机的V+单独接一个5V稳压模块，且共地。我通常还会在舵机电源两端并一个470uF电解电容，再加一个0.1uF陶瓷电容，这能吸收大部分瞬时电流冲击，故障率肉眼可见地下降。

5.2 现象：I2C总是NACK，地址和上拉电阻谁在捣鬼

排查I2C通信时，先分清楚是不应答还是根本没数据。如果你用模拟I2C且没有在SCL和SDA上接上拉电阻，总线高电平靠引脚开漏输出是拉不上去的，设备自然就检测不到起始条件。模块上自带有上拉电阻的版本还好，裸芯片或者某些精简模块通常不带，需要你自己加两个4.7kΩ电阻到3.3V。

原因：芯片地址或者上拉缺失都会表现为写寄存器后读不到ACK。前者是地址写错，比如把0x40左移后又多移了一次；后者是电气层面根本没有通信条件。

解决：先用万用表量SCL、SDA对地电压，空闲时应该接近3.3V。如果明显偏低，查上拉电阻。再用示波器或者逻辑分析仪看起始位波形，确认SDA确实拉低了。最后核对代码里的设备地址，我甚至建议先读一次MODE1寄存器，能读回0x00就说明通信建立。

5.3 现象：LED亮度完全反向，MODE2的INVRT位要背锅

有次实测让我差点怀疑芯片坏了：写亮度80%，LED反而很暗；写20%却是高亮。查了半天发现是初始化时MODE2写了0x00，而手册里默认的OUTDRV=0表示开漏输出，INVRT=0表示输出不反向，看起来没问题，但真正能点亮LED的是后续的寄存器值，问题出在LED接法上。

原因：PCA9685的推挽输出模式（OUTDRV=1）下，LED负极接输出脚、正极接电源，这是一个完整的驱动回路。如果初始化里写了OUTDRV=0，输出脚靠外部上拉才能输出高电平，驱动能力不足，亮度表现就不对。

解决：初始化时MODE2写0x04（OUTDRV=1），同时确认LED接到输出脚和地之间，而不是接在输出脚和电源之间。如果一定要把LED接在电源和输出脚之间，那就得用低电平点亮，对应寄存器逻辑要反过来，把ON和OFF互换。

5.4 现象：硬件I2C一接就卡死，换成模拟I2C反而稳定

某项目里用STM32的硬件I2C1（PB6、PB7）驱动PCA9685，程序跑起来总是随机卡在while等待总线释放那里。查资料才知道这个系列硬件I2C在异常时序下会把总线锁死，需要重新初始化外设才能恢复。

原因：硬件I2C外设对总线状态机要求严格，一旦SDA或SCL有毛刺，状态寄存器会停留在忙状态，接着程序死循环。

解决：要么给I2C总线加超时保护，要么干脆换成模拟I2C。我的习惯是裸机简单应用全部用模拟I2C，代码量只多十行，但稳定性和可控性大幅提升。只要你不用跑高于100kHz的总线速度，模拟方案完全够用，这个选择能让你少很多玄学问题。

5.5 现象：舵机归位不准确，频率标定别只用默认值

明明代码里90度对应1.5ms脉宽，实际舵机却偏了好几度。这跟osc_clock的误差有关，PCA9685的25MHz晶振实际频率不会刚好25.000MHz，有的模块偏差3%，导致输出频率不是精确的50Hz。

原因：PRE_SCALE计算用的是标称25MHz，但实际振荡器频率可能偏高或偏低。如果随便把prescale取整数，偏差会直接映射到舵机角度误差上。

解决：用逻辑分析仪测一下实际PWM频率，反推真实osc_clock，再代入prescale公式。还有一个更实用的标定方式：不追求理论频率，而是直接调整servo_angle_to_pwm里的映射范围，让0°和180°落到实处。比如用可调电源给一个固定电压，不断微调映射参数直到舵机两端极限位准确，然后用这个参数标定中间各点。

6. 把这套代码改造成多路舵机控制：平滑运动和波形验证

6.1 平滑运动函数：用细分步进避免大角度甩动

直接调用servo_set_angle从0°跳变到180°，舵机会以最大速度甩过去，机械结构容易受损，外观也突兀。常见做法是把大角度拆成小步进，每步之间加延时，延时越大动作越柔和。

// 平滑转动到目标角度，每步2度，每步延时20ms void servo_smooth_to(uint8_t channel, uint8_t target, uint16_t step_delay_ms) { uint8_t cur = servo_current_angle[channel]; // 记录当前角度的全局数组 while (cur != target) { if (cur < target) cur += 2; // 每次加2度 else cur -= 2; if (cur > target) cur = target; // 防止过冲 servo_set_angle(channel, cur); delay_ms(step_delay_ms); } }

这段代码的思路很简单：每次只走2度，两次写入间隔20ms，整个180°行程大约1.8秒。如果你想让舵机先快后慢，可以把step_delay_ms动态调整，越接近目标延时越长，模拟出减速缓冲的体感。还有一个容易被忽略的细节：servo_current_angle数组初始值必须和上电时舵机实际位置一致，否则平滑函数第一次运行会直接跳变。

6.2 用逻辑分析仪验证PWM波形的习惯

控制舵机、LED这类PWM外设，眼睛看现象永远只能确认“动了”和“亮了”，确认不了脉宽和频率是否正确。我的习惯是每次接线新模块时，先把逻辑分析仪的通道夹在PCA9685的某个输出脚和GND之间，抓一帧波形再看占空比。

确定的基础验证步骤有三步：第一步看频率，确认是不是50Hz左右；第二步看脉宽，把光标移到高电平的中点，看是否为1.5ms（对应90°）；第三步给舵机发一个已知角度，比如45°，量脉宽应该是约1.08ms。如果这些都符合，再接到舵机上做机械标定，否则直接改代码里的映射参数就行。逻辑分析仪不是每个项目必备，但只要你做过一次这种验证，后续就不会再被“舵机转是转了但角度不对”这种问题折磨。

6.3 断电后恢复上次角度的习惯

舵机本身没有角度反馈，断电再上电后会回到机械零位，而你的程序如果启动时不主动写一次角度，舵机会停在启动前的状态。做好这个细节的方法是每次初始化后，把上次保存的角度值从片内Flash读取出来，调一次servo_set_angle。断电瞬间来不及操作Flash没关系，可以在每次舵机到位后写入一个临时变量，再按需存入Flash。这个功能的代价不高，却能显著提升整机的完整度。

我踩过最痛的一次坑，是在一个演示项目里忘了保存舵机位置，每次重新上电六足机器人都会抽搐一下全部归零，场面十分难堪。后来我养成了两个习惯：一是所有能保存的状态都在初始化时回读；二是任何新模块上车前必抓波形。这两个习惯让我少花了数不清的排查时间，也把“能用”变成了“稳用”。希望这套PCA9685的极简驱动思路能帮你把舵机和LED控制的坑一次填平。

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