当前位置：首页 > news >正文

STM32F103C8T6驱动WS2812B灯带：基于PWM+DMA的完整方案

news 2026/9/1 4:45:16

简介：面向嵌入式开发者的STM32F103C8T6 WS2812B彩灯驱动工程，解决单线串行协议时序敏感、缺少现成驱动库等痛点。工程基于Keil MDK构建，完整给出定时器时钟源、预分频器、自动重装载寄存器与PWM占空比配置，可精确生成WS2812B所需的高低电平信号；同时加入DMA搬运与GRB数据发送逻辑，帮助降低CPU占用并保证多灯珠级联时的数据顺序。压缩包共571个文件、约10.09MB，以C源码、头文件、Keil工程配置、链接脚本、hex/bin固件及调试映射文件为主，目录结构清晰，便于直接导入工程对照阅读。资源已有117人学习，适合需要快速点亮并控制WS2812B灯珠的STM32开发者；参考时可重点理解定时器PWM参数的推导方式和DMA通道配置，也可借鉴引脚定义、硬件接线与模块化驱动代码，减少底层踩坑及信号异常排查时间。做嵌入式这几年，灯效控制一直是个让人又爱又恨的活。最近帮朋友调了一套用STM32F103C8T6驱动WS2812B灯带的小项目，从时序分析到代码落地踩了不少坑，正好借这个机会把整套方案整理出来。不管你是刚接触单片机的小白，还是想快速给产品加灯效的工程师，这篇文章都能给你一套可以直接用的驱动思路。

STM32F103C8T6这颗芯片大家再熟悉不过——蓝板最小系统板几块钱一片，72MHz主频、20KB RAM、64KB Flash，做常规控制绰绰有余。WS2812B则是智能灯珠里的明星产品，单线级联、内置驱动IC，一颗一颗串起来，一条数据线就能控制几十上百颗灯。把这两者结合，就是典型的“小芯片干大事”场景：用F103的定时器PWM加DMA，在不占用CPU的情况下把WS2812B的时序精确喂出来，实现流水灯、呼吸灯、音乐律动这些效果。

这篇文章会从协议底层讲起，然后是硬件准备、工程配置、代码实现，最后把“第一个灯永远是绿的”“灯带颜色乱跳”这类高频问题一次性说透。

1. 项目背景与驱动方案选型

1.1 WS2812B能做什么，为什么选它

先聊聊WS2812B本身。它是一颗5050封装的RGB灯珠，内部集成了控制IC和三个颜色的LED晶片，外部只引出VCC、GND、DIN、DOUT四个引脚。DIN进、DOUT出，后一颗灯的DIN接前一颗的DOUT，这样就形成了一条级联链。数据从第一颗灯流入，每颗灯吃下自己的24bit数据（绿色8bit、红色8bit、蓝色8bit），然后把剩余数据整形后从DOUT转发出去。

这种设计的价值在于：控制端只需要一根GPIO就能驱动整条灯带，不需要额外的锁存器、移位寄存器，布线成本极低。对比传统的74HC595方案，WS2812B省掉了大量外围器件，而且每颗灯颜色独立可寻址，能实现的效果丰富得多。实际项目里，我见过有人拿它做桌面氛围灯、电脑机箱灯带、店铺招牌，甚至舞台道具的矩阵屏，一片F103驱动几百颗灯都没问题。

1.2 STM32F103C8T6资源盘点

做驱动之前，先看手上有什么牌。STM32F103C8T6的关键资源如下：

主频最高72MHz，指令周期约13.9ns
1个高级定时器TIM1，带PWM和DMA请求
3个通用定时器TIM2/TIM3/TIM4
2个DMA控制器，DMA1有7个通道
20KB SRAM、64KB Flash
多个5V容忍的GPIO

对于WS2812B驱动来说，最核心的是TIM1的PWM输出和DMA搬运能力。TIM1是高级定时器，输出PWM时可以配合DMA自动修改比较寄存器值，实现“硬件自己发波形”的效果。这比用延时函数在中断里翻转IO要优雅得多——CPU从头到尾只负责把颜色数据填进缓冲区，剩下的交给DMA和定时器。

1.3 三种常见驱动方案对比

驱动WS2812B的思路不止一条，我实际用过三种方案，各有优缺点：

方案	原理	优点	缺点	适用场景
定时器PWM + DMA	TIM1产生800kHz PWM，DMA逐字节修改CCR值	实时性好，几乎不占CPU，波形精准	需占用1个定时器和1个DMA通道	几十到几百颗灯，项目正式方案
SPI + DMA	SPI时钟18MHz，4个SPI bit模拟1个WS2812B bit	代码简单，逻辑清晰，占用资源少	需要额外对数据进行编解码，频率受限	灯带较长、刷新率要求不高时
IO模拟时序	GPIO翻转加延时	代码最直观，任何引脚都能用	严重占用CPU，中断会卡时序	只有少量灯珠，或调试阶段

我最终选的是定时器PWM + DMA方案，原因有三：第一，WS2812B的时序要求精确到亚微秒级别，定时器硬件输出比延时翻转可靠得多；第二，DMA搬运不占CPU，灯数多的时候主程序还能干别的事；第三，这套思路后续移植到FreeRTOS或带系统的项目里非常顺滑，不会因为中断延迟导致灯带闪屏。

2. 通信协议拆解：时序才是驱动核心

2.1 WS2812B单总线协议

WS2812B用的是单线归零码协议，数据线默认低电平，高电平脉冲的宽度决定是“0”还是“1”。严格来说，协议要求如下：

0码：高电平时间约0.35us，低电平时间约0.8us，周期1.25us
1码：高电平时间约0.7us，低电平时间约0.55us，周期1.25us
复位码：数据线拉低至少50us（建议80us以上），表示一帧数据传输结束

每一位的周期是1.25us，对应频率800kHz。发送顺序是从第一颗灯开始，每颗灯吃24bit，顺序是绿色高位先发、然后红色、最后蓝色。注意，这里不是常见的RGB顺序，而是GRB，很多新手在这里翻车，发出来颜色全乱。

当数据通过DIN进入第一颗灯后，灯珠内部的IC会把前24bit数据锁存到自己的寄存器里，并将剩余数据整形后从DOUT输出。这意味着整条灯带的数据长度必须是“灯数 × 24bit”，少发一位整条链都会错位。

2.2 定时器PWM+DMA为什么是黄金组合

既然WS2812B要求每位周期1.25us，那就让定时器工作在800kHz。每产生一次更新事件，就通过DMA从内存中搬一个字节到TIM1的CCR寄存器，改变PWM占空比。高电平宽度由CCR值决定——设置CCR=25时高电平约0.347us，对应0码；设置CCR=50时高电平约0.694us，对应1码。

这样做的巧妙之处在于：DMA每次搬运一个字节，而这个字节恰好就是这一位对应的CCR值。我们预先在内存里把每一个bit都换算成CCR值，例如0变成25、1变成50，形成一个“展开后的波形缓冲区”。DMA按顺序把缓冲区里的数据一个个搬到CCR寄存器，定时器就自动把WS2812B的完整波形发出来了。

整个过程CPU只负责准备缓冲区数据，发送期间可以去做别的事情，比如处理传感器数据、刷新OLED屏幕。只有在DMA传输完成时才会产生一次中断，通知CPU“这一帧发完了”。

2.3 72MHz下PWM参数计算公式

F103的主频是72MHz，定时器预分频设为0，则计数频率也是72MHz。要让PWM周期为1.25us，需要：

ARR = 1.25us × 72MHz - 1 = 90 - 1 = 89

0码的CCR值为：

CCR0 = 0.35us × 72MHz ≈ 25

1码的CCR值为：

CCR1 = 0.7us × 72MHz ≈ 50

这里有个细节值得注意：不同厂家的WS2812B时序容限略有差异，有些灯珠对0码高电平的要求更苛刻，如果出现颜色不稳定，可以把CCR0在20~28之间微调，CCR1在45~55之间微调。我实测下来CCR0=25、CCR1=52在大多数灯带上都很稳。

复位码不用定时器专门生成，最简单的方式是DMA发送完毕后，在DMA传输完成中断里把PWM比较值设为0，让它输出低电平，同时延时80us以上。如果用的是HAL库，可以直接调用HAL_Delay(1)来保证足够的复位时间。

3. 硬件准备与工程配置

3.1 最小系统板和接线清单

这套方案硬件上非常简单，核心器件就四样：

STM32F103C8T6最小系统板一块
WS2812B灯带或灯珠若干
5V电源（具体电流按灯珠数量算，下文会讲）
ST-Link V2下载调试器一个

接线方面，数据线我用的是PA8引脚，它复用为TIM1_CH1，直接输出PWM。PA8接WS2812B的DIN，GND和电源共地即可。如果你手头的板子PA8被占了，也可以改用PA11（TIM1_CH4），不过DMA通道要相应调整。

强烈建议在灯带靠近电源输入端并联一个470uF以上的电解电容和一个0.1uF的瓷片电容。WS2812B全亮时瞬间电流很大，电容能有效抑制电压跌落，防止灯带头部颜色偏暗、尾部颜色发白。

3.2 电源设计的关键点

WS2812B单颗灯珠在白色全亮时电流约60mA，注意这是最极端的情况。假设你接了60颗灯，最大电流就是3.6A，普通的USB线根本扛不住。我的习惯是每30颗灯预留2A余量，电源选电流至少为“灯数 × 60mA × 1.2”的5V开关电源。

还有一点容易被忽略：如果灯带比较长（超过1米），建议在灯带中间和末端同时供电，避免铜箔电阻造成压降。数据线方面，STM32的3.3V电平一般可以直接驱动WS2812B，但如果线长超过20cm，串一个100~300欧姆的电阻能减少信号反射和振铃。我在项目里就遇到过线太长导致首尾灯颜色不一致的情况，加电阻后问题消失。

3.3 开发环境搭建注意事项

开发环境可以用标准外设库，也可以用HAL库，我个人更推荐HAL库——这套代码后续如果要移植到GD32等国产替代芯片，HAL风格改动最小。如果你习惯手工创建HAL库工程，注意在CubeMX里把TIM1的Channel1配置为PWM Generation，并在DMA Settings里添加TIM1_UP作为DMA请求，数据方向是Memory To Peripheral。

调试工具方面，ST-Link V2驱动装上后，如果电脑识别不到设备，多半是驱动没装好或BOOT0跳线帽没设置正确。F103C8T6的BOOT0默认接一个10K电阻下拉到GND，也就是Flash启动模式，正常下载程序不需要改。如果下载失败或者“连接不上”，先检查是不是把BOOT0接到了3.3V，那是串口ISP模式，ST-Link下载会失败。

4. 驱动代码实现全流程

4.1 定时器PWM初始化

我用的是HAL库，配置如下。这段代码的核心是让TIM1工作在PWM模式，输出800kHz的PWM波形，初始占空比为0（数据线保持低电平）。

void WS2812_PWM_Init(void) { GPIO_InitTypeDef gpio = {0}; TIM_OC_InitTypeDef oc = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_TIM1_CLK_ENABLE(); __HAL_RCC_DMA1_CLK_ENABLE(); // PA8 复用为TIM1_CH1输出 gpio.Pin = GPIO_PIN_8; gpio.Mode = GPIO_MODE_AF_PP; gpio.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, &gpio); // TIM1: 72MHz / 90 = 800kHz htim1.Instance = TIM1; htim1.Init.Prescaler = 0; htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 89; // ARR = 89 htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter = 0; HAL_TIM_PWM_Init(&htim1); // PWM1模式，初始CCR=0 oc.OCMode = TIM_OCMODE_PWM1; oc.Pulse = 0; oc.OCPolarity = TIM_OCPOLARITY_HIGH; oc.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim1, &oc, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); }

注意，HAL_TIM_PWM_Init内部会调用HAL_TIM_PWM_MspInit，如果你用CubeMX生成的代码，DMA和GPIO初始化会自动跑到MspInit里。手工创建工程的话，记得把DMA时钟和GPIO初始化放在MspInit中，否则配置不生效。

4.2 DMA通道配置与缓冲区设计

DMA的作用是每次TIM1更新事件产生时，自动从内存搬运1字节到TIM1的CCR寄存器。在F103上，TIM1_UP的DMA请求映射到DMA1的Channel2，这一点要记清楚。

void WS2812_DMA_Init(void) { hdma_tim1_up.Instance = DMA1_Channel2; hdma_tim1_up.Init.Direction = DMA_MEMORY_TO_PERIPHERAL; hdma_tim1_up.Init.PeriphInc = DMA_PINC_DISABLE; hdma_tim1_up.Init.MemInc = DMA_MINC_ENABLE; hdma_tim1_up.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; hdma_tim1_up.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; hdma_tim1_up.Init.Mode = DMA_NORMAL; hdma_tim1_up.Init.Priority = DMA_PRIORITY_HIGH; HAL_DMA_Init(&hdma_tim1_up); __HAL_LINKDMA(&htim1, hdma[TIM_DMA_ID_UPDATE], hdma_tim1_up); HAL_NVIC_SetPriority(DMA1_Channel2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(DMA1_Channel2_IRQn); }

缓冲区设计是整个驱动最需要想清楚的地方。WS2812B每颗灯需要24bit数据，而每个bit对应缓冲区里一个字节的CCR值，所以缓冲区大小 = 灯数 × 24 字节。例如8颗灯需要192字节，64颗灯需要1536字节，这在20KB RAM的F103上完全不是问题。

#define LED_NUM 8 // 灯珠数量 #define BUF_SIZE (LED_NUM * 24) // 展开后的波形缓冲区 uint8_t dma_buf[BUF_SIZE]; // 存放CCR值，0码=25，1码=52 uint8_t color_buf[LED_NUM][3]; // 存放GRB颜色值

发送一帧数据时，先把color_buf里的GRB数据展开成dma_buf，然后启动DMA传输。DMA传输完一帧后，在中断里把CCR设为0，拉低数据线80us以上，让灯带完成复位。

4.3 GRB数据打包与gamma校正

颜色数据打包有个大坑：WS2812B的格式是GRB，不是RGB。也就是说第一个字节是绿色、第二个字节是红色、第三个字节是蓝色。发送时从每颗灯的最高位（bit7）开始。

另外，人眼对亮度的感知是非线性的，如果直接线性控制亮度，低亮度区域会看到明显的跳变。我的做法是加一张gamma校正表，以2.8为gamma值，把8bit亮度映射到实际输出值。这样从0到255的渐变会柔和很多。

const uint8_t gamma8[] = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, // ... 实际工程中生成完整256项，可按 gamma=2.8 计算 }; void WS2812_SetPixel(uint16_t index, uint8_t r, uint8_t g, uint8_t b) { color_buf[index][0] = gamma8[g]; // 绿色 color_buf[index][1] = gamma8[r]; // 红色 color_buf[index][2] = gamma8[b]; // 蓝色 }

展开函数的核心逻辑是把每个字节拆成8个bit，bit为1时填入CCR1=52，bit为0时填入CCR0=25。注意这里是按高位到低位的顺序填入：

void WS2812_Update(void) { uint16_t idx = 0; for (uint16_t i = 0; i < LED_NUM; i++) { for (uint8_t bit = 0; bit < 8; bit++) dma_buf[idx++] = (color_buf[i][0] & (0x80 >> bit)) ? CCR1 : CCR0; for (uint8_t bit = 0; bit < 8; bit++) dma_buf[idx++] = (color_buf[i][1] & (0x80 >> bit)) ? CCR1 : CCR0; for (uint8_t bit = 0; bit < 8; bit++) dma_buf[idx++] = (color_buf[i][2] & (0x80 >> bit)) ? CCR1 : CCR0; } HAL_TIM_PWM_Stop_DMA(&htim1, TIM_CHANNEL_1); HAL_TIM_PWM_Start_DMA(&htim1, TIM_CHANNEL_1, dma_buf, BUF_SIZE); }

4.4 完整调用与中断处理

DMA传输完成中断是必须的，否则DMA工作在Normal模式，一帧发完就停了，第二帧发不出去。中断里要做的事很简单：把CCR置0，让数据线保持低电平，再延时80us完成复位。

void DMA1_Channel2_IRQHandler(void) { HAL_DMA_IRQHandler(&hdma_tim1_up); } void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM1) { __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 0); HAL_Delay(1); // 80us以上复位，1ms保险 } }

注意，如果用HAL_TIM_PWM_Start_DMA启动传输，传输完成时会回调HAL_TIM_PWM_PulseFinishedCallback，这个回调函数在HAL库的弱定义里，在用户文件里重写即可。

到这里，核心驱动就完成了。调用方式非常直观：设置颜色用WS2812_SetPixel，刷新显示用WS2812_Update。主循环里可以随便写动画逻辑，不用关心底层波形细节。

5. 常见问题排查与经验实录

5.1 第一个灯永远是绿色的

“第一个灯永远是绿的”这个问题我见得太多了，排查方向基本有四个：

第一，检查GPIO初始化。PA8如果没被正确配置为复用推挽输出，引脚处于浮空状态，上电瞬间可能被外部干扰拉到高电平，WS2812B就会误把第一个数据锁存成绿色。解决方案是确保初始化代码里把PA8设为AF_PP模式，并确认TIM1时钟已打开。

第二，检查数据线是否在MCU复位期间有脉冲。如果PA8悬空，MCU在上电或复位时引脚电平不确定，就可能在DIN上产生毛刺。最有效的办法是加一个10K下拉电阻到GND，让数据线在CPU启动前保持低电平。

第三，检查DMA缓冲区有没有重复发送。如果DMA配置错误，或者缓冲区数据填充顺序不对，第一颗灯吃到的24bit可能全是低电平，对应的是颜色0x000000，也就是黑色。但如果你看到的是纯绿色，说明它把某个0x00FF00的数据吃了进去，大概率是缓冲区里混入了不该有的数据。

第四，也是最容易忽略的：如果你只是使用了某颗灯的DOUT但后面没接灯，那这最后一颗灯的数据永远在“等待转发”，它的颜色可能会随机变化。这不是故障，是正常的协议行为。

5.2 灯带颜色错乱或闪烁

颜色错乱最常见的原因是时序不稳定，也就是CCR0和CCR1的值设置不当。不同批次的WS2812B对高电平时间的判定有偏差，如果0码高电平时间超过0.5us，灯珠会把它误判成1码。遇到整条灯带显示混乱时，先把CCR0从25往下调到20左右，再观察。

另一个高频原因是中断干扰。如果在DMA发送过程中，CPU频繁响应高优先级中断，虽然PWM波形由硬件输出，但DMA的搬运时机可能被其他DMA请求抢占。F103的DMA1不能同时服务两个请求，所以务必确认没有其他外设在频繁使用DMA1通道。我把DMA1_Channel2的优先级设为最高，并把其他不用的DMA通道关闭，问题就消失了。

如果使用的是HAL库，还有一个隐藏坑：HAL_TIM_PWM_Start_DMA内部会先调用HAL_TIM_PWM_Stop_DMA，如果在发送过程中再次调用WS2812_Update，可能导致DMA被强行重置。我的习惯是加一个发送标志位，在上一帧DMA传输完成之前，不启动新一帧的传输。

5.3 灯数多时尾部颜色偏暗

这个问题几乎都是供电造成的。WS2812B亮白色时单颗电流60mA，60颗灯接近3.6A，如果用的是电脑USB口或细的杜邦线，线路压降会非常明显。靠近电源端的灯电压正常，末端的灯电压可能已经跌到4.2V以下，白灯就变成了暗黄。

我的排查方法是：先用万用表量灯带末端VCC与GND之间的电压，如果低于4.8V，就说明供电不足。解决方案有三个：一是加大电源电流，建议用5V/5A以上的开关电源；二是在灯带中间和末尾分别并一组电源线；三是把灯带长度控制在2米以内并选择合适线径（AWG22以上）。

还有一个软件层面的技巧：如果你只是做氛围灯而不是高亮度照明，可以把最大亮度限制在80%左右，255映射到200，不仅省电，灯珠的寿命也会更长。50颗灯全白时，限制亮度后电流能降到2.4A左右。

5.4 调试工具驱动与连接问题

很多初学者卡在“ST-Link连接不上”，其实大部分情况不是程序问题，而是驱动或BOOT配置问题。

ST-Link V2装好驱动后，在设备管理器里应该能看到“STLink dongle”设备。如果始终显示未知设备，可能是淘宝山寨ST-Link的固件异常，可以重新刷一下ST-Link固件。J-Link同样要注意驱动版本，老版本驱动对F103C8T6的支持反而更稳定，驱动装不上时优先考虑权限问题——右键以管理员身份安装。

CH340和CP2102是串口下载和调试用的USB转TTL芯片。如果你打算用串口ISP方式下载程序，CH340驱动要装好，BOOT0要拉高，BOOT1拉低，然后通过串口工具下载，下载完成后把BOOT0跳回低电平再复位。这里有个小坑：CH340的TXD要接F103的RX（PA10），RXD接F103的TX（PA9），交叉连接，接反了会收不到任何数据。

如果出现“连接不上”或者“下载后程序不运行”，先检查BOOT0跳线帽，再检查复位电路。F103的最小系统板NRST引脚一般默认拉高，如果外接电路把NRST拉低，芯片会一直处于复位状态，程序自然跑不起来。