简介：面向STM32F103ZET6开发者与多舵机控制场景，这套PCA9685测试工程直接解决16通道PWM驱动与I²C总线协议集成的常见问题。压缩包共133个文件，以C源文件与H头文件为主体，同时包含Keil工程配置（.uvprojx）、编译产物（.axf、.hex、.o）以及标准外设库中的定时器、复位、ADC等模块，整体大小约2.58MB，结构紧凑，便于导入工程直接参考。已有349人学习下载。资源不仅演示了STM32F103ZET6的I²C初始化与收发数据流程，还覆盖了PCA9685预分频寄存器、各通道占空比寄存器的写入方法，通过修改占空比即可控制舵机角度或LED亮度。对于无人机、机器人等需要多路PWM独立控制的开发任务，该测试工程提供了可复用的代码结构和调试验证思路，适合希望深入理解I²C协议与PWM生成原理的嵌入式开发者。

1. 先解决多路舵机不够用：用STM32F103ZET6把PWM通道扩展到16路

当舵机数量超过单片机能直接输出的PWM通道数，事情就开始变得麻烦。以STM32F103ZET6为例，定时器通道虽然多，真正要让16路舵机稳定工作，要么抢MCU中断资源，要么换主控，都不轻松。

这套pca9685-test-ZET6工程做的就是更简单的路子：用I2C两根线扩展出一片16通道12位PWM芯片，把舵机控制全部交给PCA9685，MCU只需要每隔几十毫秒更新一次目标角度，负担小、逻辑清楚。工程里包含了I2C初始化、PCA9685寄存器操作、频率设定、单路与多路舵机控制封装，适用做机器人关节、相机云台、六足或机械臂的开发者；新手能直接烧录看舵机扫动，老手可以拿它当多路PWM中间层继续往上叠逻辑。

2. 工程全局：先弄懂PCA9685为什么能用两根线输出16路PWM

2.1 从定时器通道到PCA9685：为什么需要外扩PWM

手头这块ZET6有4个通用定时器，每个定时器能出4路PWM，理论上16路刚好够，但实际做机器人项目时根本挤不出来。编码器要占用定时器、电机调速要占用定时器、超声波测距输入捕获也要占用，最后剩下的定时器通道七零八落，而且PWM引脚是固定的，布线上要绕很远。这就好比手里有16间屋子，但每间屋子的位置都定死了，人还不能只在固定的几间房活动，根本没法住。

PCA9685解决的是“把PWM生成这件事从MCU上卸载掉”。这颗芯片内部有一个25MHz振荡器，通过分频产生一个基准时钟，驱动16个独立的12位计数器做比较输出。每个通道可以单独设置高电平保持到第几个计数点，输出推挽或开漏的方波。MCU这边只需要通过I2C写入“哪个时间点变高、哪个时间点变低”两个数字，剩下的高精度方波生成完全由芯片自己搞定。

对比用定时器+DMA去模拟多路舵机信号的做法，PCA9685的优势非常明显：CPU占用低、逻辑简单、代码量少、多板级联容易。缺点也有，就是舵机信号线多了一颗芯片，故障排查多一个环节。整体来说，做多关节机械臂或者六足机器人，用这种方案比堆定时器省心得多。

2.2 硬件连接：引脚表和解开OE引脚的疑惑

拿到这个工程先别急着烧代码，连接错了后面全是玄学。我按常见的ZET6核心板加PCA9685模块的方式，列一张连接表：

这里最容易让人忽略的就是OE引脚。PCA9685模块上OE通常外接一个排针，如果悬空，芯片内部输出级是关闭的，你配置得再辛苦，示波器也看不到波形。翻车现场十有八九是这个引脚没接地。另外，V+和VCC是两套电源，V+是舵机电源的汇流排，5V还是6V取决于舵机规格，别把V+接到3.3V上，舵机根本没力气。

还有一个硬件细节：SCL和SDA需要上拉电阻。大多数成品的PCA9685模块板上已经焊了上拉，但如果你用的是裸芯片转接板，就得自己在总线上加两颗4.7kΩ电阻到3.3V。开漏模式下没人帮它拉高，信号根本出不来。

2.3 工程目录结构：这套测试代码是如何组织的

解压这个zip之后，工程的目录是典型的标准外设库风格，核心文件不多：

pca9685-test-ZET6/ ├── HARDWARE/ │ ├── pca9685.c │ ├── pca9685.h │ ├── myiic.c │ └── myiic.h ├── SYSTEM/ │ ├── delay/ │ ├── sys/ │ └── usart/ ├── USER/ │ ├── main.c │ └── stm32f10x_it.c └── pca9685-test.uvprojx

驱动部分集中在HARDWARE目录里：myiic.c是软件模拟I2C底层，pca9685.c是在I2C之上的寄存器操作和应用封装，main.c里写的是测试流程。这个分层思路对于学习的人来说很好：底层时序一个文件，芯片驱动一个文件，业务逻辑一个文件，想改成自己的应用时只需要动main.c，不需要碰底层。

如果你拿到的版本稍微有些差异，比如HARDWARE目录里多了oled.c之类，不用慌，核心找两个文件就行：一个是I2C底层，一个是pca9685驱动。剩下无非是串口打印或者显示，跟舵机主链路是并行的。

3. 核心驱动拆解：从I2C底层到寄存器写入的完整链路

3.1 软件模拟I2C：为什么不用STM32自带的硬件I2C

这个工程用的是软件模拟I2C，而不是STM32的硬件I2C外设。理由很现实：F103的硬件I2C在繁忙标志处理上比较麻烦，一旦出错就要清一堆错误标志，排查起来周期长，很多老项目干脆不上硬件I2C，直接用GPIO翻转把时序做出来。PCA9685的通信速率要求不高，100kHz、400kHz都行，软件模拟完全喂得饱。

引脚初始化很简单，PB6做SCL，PB7做SDA，都配成开漏输出：

void IIC_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); GPIO_SetBits(GPIOB, GPIO_Pin_6 | GPIO_Pin_7); }

开漏输出是I2C协议的硬性要求，总线靠外部上拉电阻才能把电平拉高。如果配成推挽输出，虽然单独通信也能工作，但总线上多个设备同时驱动时就可能互相打架，这在后续挂多个PCA9685或者EEPROM的时候很容易出问题，还是规范一点好。

有了GPIO之后，把电平操作抽成宏：

#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) != 0)

直接用BSRR/BRR寄存器置位和复位，好处是不用担心读改写被中断打断，速度也比调用库函数快。SDA_READ用于从机发ACK时读电平，后面发完一个字节要等从机把SDA拉低来确认。

3.2 I2C时序：起始、停止和发送一字节

I2C最关键的两个信号：SCL为高期间，SDA从高跳变到低是起始信号；SCL为高期间，SDA从低跳变到高是停止信号。从机靠这两个边沿对齐自己的字节边界，写错一个时序整条总线就废了。

void IIC_Start(void) { SDA_H(); SCL_H(); delay_us(5); SDA_L(); delay_us(5); SCL_L(); } void IIC_Stop(void) { SDA_L(); SCL_H(); delay_us(5); SDA_H(); delay_us(5); }

之所以每条操作后面都加几微秒延时，是为了让电平有足够的建立时间。F103主频72MHz，GPIO翻转极快，不加延时的话信号边沿太陡、保持时间太短，接近I2C规范里的极限甚至超限，长线缆下特别容易丢ACK。这个延时数值不需要精确，2到5微秒都能用，关键是每步都要有。

发送一个字节时，数据在SCL低电平期间变化，在SCL高电平期间被从机采样，从高位开始逐位移出：

void IIC_SendByte(uint8_t data) { uint8_t i; for (i = 0; i < 8; i++) { if (data & 0x80) SDA_H(); else SDA_L(); data <<= 1; SCL_H(); delay_us(2); SCL_L(); delay_us(2); } }

注意每次SCL拉高之前先把SDA放到正确的电平上，顺序不能反。SCL拉高之后不要再动SDA，否则从机会以为是一个起始/停止信号。发完8位之后主机释放SDA，等待从机拉低应答：

uint8_t IIC_WaitAck(void) { uint8_t timeout = 50; SDA_H(); delay_us(1); SCL_H(); delay_us(1); while (SDA_READ() && timeout--) { delay_us(1); } SCL_L(); return (timeout == 0) ? 1 : 0; }

这里加了超时计数，是从我踩过的坑里学来的。最早的版本是死循环等ACK，一旦从机掉线或者地址写错，整个程序就卡死在I2C里连串口输出都看不到。加一个超时返回错误码，后续才好排查。

3.3 PCA9685寄存器读写：地址和字节序

PCA9685的I2C地址值得单独说。芯片默认7位地址是0x40，A0到A5全部接GND时就是0x40。但在代码里发送时要把7位地址左移一位，最低位填上读/写标志，所以最终发送的8位地址是0x80。这个转换是新手最容易翻车的地方，后面排查章节还会细讲。

#define PCA9685_ADDR 0x80 void PCA9685_WriteReg(uint8_t reg, uint8_t data) { IIC_Start(); IIC_SendByte(PCA9685_ADDR); IIC_WaitAck(); IIC_SendByte(reg); IIC_WaitAck(); IIC_SendByte(data); IIC_WaitAck(); IIC_Stop(); } uint8_t PCA9685_ReadReg(uint8_t reg) { uint8_t data; IIC_Start(); IIC_SendByte(PCA9685_ADDR); IIC_WaitAck(); IIC_SendByte(reg); IIC_WaitAck(); IIC_Start(); IIC_SendByte(PCA9685_ADDR | 0x01); IIC_WaitAck(); data = IIC_ReceiveByte(); IIC_Stop(); return data; }

读取寄存器时用了一个重复起始信号，先以写方式发送寄存器地址，再以读方式把数据从从机拉出来。这一步如果漏掉重复起始，有的从机就等着收下一个字节而不是输出数据，读回来的就是0xFF。这套读写函数是整个驱动的地基，后面所有配置都建立在它们之上。

3.4 初始化与PWM频率：SLEEP位和PRE_SCALE的计算

PCA9685的频率配置有个特殊流程：先把MODE1寄存器置为睡眠模式，在睡眠状态下写PRE_SCALE分频值，写完再唤醒，最后置RESTART位重启PWM输出。顺序搞反，频率就写不进去。

void PCA9685_SetPWMFreq(uint8_t freq) { uint8_t prescale; uint8_t oldMode; prescale = (uint8_t)(25000000.0 / (4096 * freq) + 0.5) - 1; oldMode = PCA9685_ReadReg(0x00); PCA9685_WriteReg(0x00, oldMode | 0x10); PCA9685_WriteReg(0xFE, prescale); PCA9685_WriteReg(0x00, oldMode); delay_ms(1); PCA9685_WriteReg(0x00, oldMode | 0x80); }

pre_scale计算公式出自数据手册：25MHz内部时钟除以4096再除以目标频率，四舍五入后减1。舵机标准频率50Hz算出来是121，写进寄存器0xFE就是0x79。如果算出来的值和代码注释里的对不上，多半是忘记减1，或者乘除顺序反了。

MODE1寄存器0x10是SLEEP位，0x80是RESTART位。在SLEEP状态下可以安全地改分频寄存器，改完退出SLEEP后还要等内部振荡器稳定，最后还要触发一次RESTART，让PWM输出按新频率重新跑起来。整个流程不能省，省了第一步，输出频率就不对；省了最后一步，输出会停留在上次的状态。

初始化函数本身不复杂：

void PCA9685_Init(void) { PCA9685_WriteReg(0x00, 0x00); PCA9685_WriteReg(0x01, 0x04); PCA9685_SetPWMFreq(50); }

MODE1写0x00是正常工作、不睡眠、不自动递增；MODE2写0x04是把输出配成推挽模式（totem pole），这样舵机信号到5V电平才有足够的驱动能力。如果MODE2保持默认的开漏模式，输出高电平完全依赖外部上拉，接到舵机信号线上就会变得半高不低。

4. 舵机控制实战：把0到180度映射成可控的PWM脉宽

4.1 脉宽计算：一个计数约等于4.88微秒

PCA9685每个通道输出的是12位精度的PWM，一个周期被分成4096个计数。50Hz对应的PWM周期是20毫秒，所以一个计数就是20ms/4096，约4.88us。标准舵机的控制脉宽是0.5ms到2.5ms，对应0度和180度：

• 0度对应约102个计数
• 90度对应约307个计数
• 180度对应约512个计数

中间任意角度按线性插值计算。这就是把角度转成计数值的全部秘密。

#define SERVO_PULSE_MIN 102 // 0度对应0.5ms #define SERVO_PULSE_MAX 512 // 180度对应2.5ms uint16_t PCA9685_AngleToPulse(float angle) { if (angle < 0) angle = 0; if (angle > 180) angle = 180; return (uint16_t)(SERVO_PULSE_MIN + angle / 180.0f * (SERVO_PULSE_MAX - SERVO_PULSE_MIN)); }

两个宏的值在不同的舵机上会有细微差别。有的舵机标称0.5ms到2.5ms，但极限位置反而进不去，需要把MIN放宽到90、把MAX放宽到525，这类属于舵机个体差异，改宏就行，不用动其他代码。注意不要直接给PWM赋0或者4095，那等于输出一直低或一直高，舵机收不到有效PWM信号会抖动甚至烧控制板。

4.2 单通道输出：把脉宽写进寄存器

PCA9685的16个通道各占4个寄存器，起始地址0x06，分别是ON_L、ON_H、OFF_L、OFF_H。LED0_ON_L在0x06，LED1_ON_L在0x0A，依次往后推。把角度转换好的计数写到OFF寄存器，ON保持0，也就是一个周期开始后立即打开输出，到设定计数点关闭。

void PCA9685_SetPWM(uint8_t channel, uint16_t on, uint16_t off) { PCA9685_WriteReg(0x06 + channel * 4, on >> 8); PCA9685_WriteReg(0x06 + channel * 4 + 1, on & 0xFF); PCA9685_WriteReg(0x06 + channel * 4 + 2, off >> 8); PCA9685_WriteReg(0x06 + channel * 4 + 3, off & 0xFF); } void PCA9685_SetServoAngle(uint8_t channel, float angle) { PCA9685_SetPWM(channel, 0, PCA9685_AngleToPulse(angle)); }

channel取值范围0到15，超过范围就是写到了下一个模块的寄存器空间，这种错误特别隐蔽，因为I2C通信本身不会报错，只是舵机没反应。建议在函数入口加一个channel > 15的判断，直接返回，省得后面排查半天。

on和off都是12位计数，0到4095，超出部分在数据手册里还有特殊含义：OFF为0表示整个周期都是低电平，OFF为4096表示整个周期都是高电平。这类特殊值在这套舵机驱动的场景中用不到，但写通用驱动时要注意别让计算值越界。

4.3 测试主程序：让16路按顺序扫动

工程里的测试逻辑是把16个通道全部接上舵机，然后统一赋值0度、90度、180度，每个位置停留1.5秒，循环往复。如果手上舵机不够，也可以只接几个，代码逻辑不变。

int main(void) { uint8_t ch; delay_init(); IIC_Init(); PCA9685_Init(); while (1) { for (ch = 0; ch < 16; ch++) PCA9685_SetServoAngle(ch, 0); delay_ms(1500); for (ch = 0; ch < 16; ch++) PCA9685_SetServoAngle(ch, 90); delay_ms(1500); for (ch = 0; ch < 16; ch++) PCA9685_SetServoAngle(ch, 180); delay_ms(1500); } }

这里有个容易被忽略的问题：16个通道同时从0度跳到180度，瞬间电流会非常大。舵机堵转时单路电流能到1A以上，就算空载，16路同时动也很容易把电源电压拖垮。所以更稳的写法是循环里加一点错峰延时，比如每设置4个通道就等50ms，让电流曲线平缓一些。这个在测试时看不出来，接了机械臂负载以后就明显了。

实际跑测试时建议打开串口看打印，用printf在每个动作切换时输出当前角度值。F103上需要把fputc重定向到USART1，这一步在USART初始化里完成。看到串口有输出但舵机没动，问题一定在硬件或接线；串口没输出，问题在代码流程。

4.4 多芯片级联：把16路扩展成更多路

机器人项目里16路舵机往往不够，这时候PCA9685的地址扩展就派上用场。芯片有A0到A5六个地址引脚，接GND代表0，接VCC代表1，组合出来的7位地址从0x40到0x7F，减去若干保留地址，一条I2C总线上可以挂几十片。地址公式：

uint8_t base = 0x40 | (A5 << 5) | (A4 << 4) | (A3 << 3) | (A2 << 2) | (A1 << 1) | A0;

级联时每一片PCA9685的SCL、SDA并联到同一条总线，VCC、GND并联，V+可以各自接电源也可以共用。需要注意总线上拉电阻要适当减小，挂着十几片芯片后总线电容变大，4.7kΩ换2.2kΩ，否则信号边沿变缓，通信误码率上升。

工程里虽然没有把多片级联封装成完整代码，但驱动函数上件地址都是宏定义，改成把addr作为参数传入就有余量。后面第6章我会直接给出改造思路。

5. 常见问题排查：I2C锁死到舵机抖动的那几条踩坑记录

5.1 现象：I2C扫描不到PCA9685的地址

程序跑起来后串口一直没打印，或者卡在IIC_WaitAck里出不来。先用万用表量SCL和SDA电压，发现都停在0V不动。

原因基本是三个：一是地址算错，把7位的0x40直接当成8位地址发送，从机当然不应答；二是SDA、SCL缺少上拉电阻，开漏模式下没人把电平拉高；三是A0到A5引脚悬空，地址和默认值不一致。

解决方法是先写个I2C扫描函数，从0x40到0x7F逐个发地址试ACK，打印出能应答的设备。然后确认A0到A5全部接GND，确认板上有没有上拉电阻（没有就自己焊两颗4.7kΩ），最后检查地址宏是不是0x80。这三步走完，90%的扫描不到问题都能解决。

5.2 现象：舵机抖动或者偏到一边

舵机接上去左右乱抖，或者明明命令是90度，实际停在某个角度还发出嗡嗡声。

这种抖动多半是PWM频率不对。PCA9685输出的是连续方波，频率不是50Hz时，舵机内部的脉冲识别逻辑就会混乱。先查SetPWMFreq(50)有没有真正生效，把prescale算一遍是不是121。还有一个常见情况是角度映射算出的脉宽超出了舵机有效范围，比如把0度算成了0计数，PWM直接变成常低电平，舵机没有识别信号就会抖。

解决：确认PRE_SCALE寄存器读到0x79；把角度映射函数限制在102到512之间；如果舵机依然抖，换一个已知正常的舵机排除个体故障。舵机供电不足也会表现出抖动，这个问题和第5.5条一起看。

5.3 现象：寄存器配置都执行了，但16路输出全无

I2C通信正常，读寄存器也能读到数值，但示波器看输出引脚，一点波形都没有。

原因多半是OE引脚。OE是输出使能，低电平有效，很多模块把这个引脚引出来但默认悬空，悬空状态下芯片内部输出级完全不工作，配置得再多也白搭。另外MODE2的OUTDRV位如果保持开漏模式，输出高电平要靠外部上拉，舵机信号线阻抗不匹配，波形也可能异常。

解决：OE直接接地，或者用一个GPIO控制它，平时拉低使能。MODE2写入0x04切到推挽输出。这两个检查点做完，输出基本就有了。

5.4 现象：运行一段时间后I2C总线卡死

设备工作几分钟后突然全部无响应，串口也打印不出东西，按复位又能恢复。

这是I2C总线的经典死锁：某个从机在通信中途看到异常时序，把SDA拉低不放，所有后续通信都无法开始。常见诱因是热插拔、总线收到干扰、或者主机发送字节时SCL/SDA顺序不对。

解决：给软件I2C加一个总线复位函数，把SCL翻转若干次，给从机一个完整的脉冲序列，让它释放SDA：

void IIC_BusReset(void) { uint8_t i; SDA_H(); for (i = 0; i < 16; i++) { SCL_L(); delay_us(2); SCL_H(); delay_us(2); } }

然后在每次I2C操作前检查SDA状态，发现被拉低就调用总线复位。这个方法能救回大部分死锁场景，要是还不行就检查接线长度和外部干扰源，把I2C线剪短到20厘米以内试试。

5.5 现象：舵机一多系统就复位

4路以内一切正常，加到8路或者12路，一上电STM32就掉电重启，或者舵机动作变得毫无规律。

这基本是电源问题。舵机启动瞬间电流很大，堵转时单路能到1A，多路一起动，电源电压被拉低到MCU复位阈值以下，程序就重启了。舵机和MCU共用一路电源时尤其明显，USB口的500mA根本扛不住。

解决方法是舵机单独供电：5V或6V电源直接接到V+，GND和MCU共地，但电源回路分开。在舵机电源端并一颗1000uF以上的电解电容吸收瞬态，软件上做错峰启动，把16路的动作时间分散到几百毫秒内。

6. 二次开发：把测试工程改造成通用多路舵机控制中间层

6.1 用结构体抽象设备句柄，为多片PCA9685铺路

拿到工程后第一件事，把驱动函数里的全局地址宏全部换成参数化写法。定义一个设备结构体，把地址和通道数装进去：

typedef struct { uint8_t addr; uint8_t channel_num; } PCA9685_Dev; void PCA9685_InitDev(PCA9685_Dev *dev, uint8_t addr, uint8_t channel_num) { dev->addr = addr; dev->channel_num = channel_num; PCA9685_SetPWMFreq(dev, 50); }

这样后续要做四足机器人、挂四片PCA9685，只需维护一个dev数组，循环初始化，主逻辑里按关节编号找到对应的设备和通道，不用为每片芯片复制一份代码。这是从测试工程走向正式项目最值得先做的一步。

6.2 给舵机加一个渐变缓冲，避免硬跳

直接设置目标角度，舵机是瞬间跳过去的，机械结构承受冲击，电源电流也会出现尖锐脉冲。常见做法是加入渐变步进：每10ms往目标值移动一小步，让舵机平滑过渡。

void PCA9685_RampTo(PCA9685_Dev *dev, uint8_t ch, uint16_t target, uint16_t step) { uint16_t cur = PCA9685_GetPulse(dev, ch); while (cur != target) { if (cur < target) cur += step; else cur -= step; PCA9685_SetServoPulse(dev, ch, cur); delay_ms(10); } }

step取值3到5时，90度行程大概几百毫秒完成；step越小运动越平滑但CPU占用越多。这是做机械臂时非常实用的功能，能让整个动作看起来自然很多，也能明显降低电源瞬态压力。

6.3 改造后的验证三板斧

改完驱动不要直接上负载，先按三步验证：第一步I2C扫描，确认每片PCA9685的地址都在线，把扫描结果打印出来；第二步单通道点动，用0度、90度、180度三个位置确认每个舵机的方向和限位；第三步全通道压力测试，把所有舵机接上负载连续动作十分钟，观察电源电压有没有跌落、有没有复位、有没有抖动。

从那以后我每次改完驱动，都会强制走一遍这三板斧，尤其是第三步，很多在空载下发现不了的问题，接上负载就会浮现。驱动代码本身倒简单，真正考验人的是电源和机械。这套工程把PCA9685的驱动链路跑通了，剩下的扩展空间其实很大，从16路舵机到几十路舵机，从单板到多板级联，都在你能掌控的范围里。希望帮到你。

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