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

STM32F10XX基于定时器与DMA的WS2812B灯带驱动：从零构建像素级可控方案

news 2026/3/26 19:11:13

1. 为什么需要定时器+DMA驱动WS2812B？

玩过LED灯带的朋友应该都遇到过这样的困扰：用普通GPIO直接驱动WS2812B时，稍微有个中断干扰就会导致颜色错乱。我之前用STM32的GPIO做过测试，当灯珠数量超过20个时，只要打开串口中断，灯带就会像打翻的调色盘一样乱闪。这就是为什么我们需要借助定时器和DMA这对黄金搭档。

WS2812B对时序的要求极其苛刻。每个bit需要1.25μs的精确时序，其中0码和1码的区别仅在于高电平持续时间不同（0码要求400ns高电平+850ns低电平，1码则是800ns高电平+450ns低电平）。普通GPIO翻转根本达不到这样的精度要求，而定时器的PWM输出配合DMA自动搬运数据，可以完美解决这个问题。

2. 硬件连接与基础配置

2.1 硬件准备清单

STM32F103C8T6最小系统板（其他F10XX系列也适用）
WS2812B灯带（建议先拿10个灯珠做测试）
3.3V转5V电平转换模块（重要！直接接3.3V可能信号不稳定）
470Ω电阻和100μF电容（用于信号整形和电源滤波）

接线时特别注意：数据线一定要串联电阻，我吃过亏，没加电阻时信号反射导致末尾几个灯珠经常显示异常。电源最好单独供电，单片机IO口的驱动能力有限。

2.2 定时器配置核心参数

在STM32CubeMX中配置定时器时，这几个参数是关键：

TIM_HandleTypeDef htim2; htim2.Instance = TIM2; htim2.Init.Prescaler = 0; // 不分频 htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 89; // 72MHz/(89+1)=800kHz htim2.Init.ClockDivision = 0;

这里有个坑要注意：Period值不是随便设的。计算公式是(主频/目标频率)-1。比如72MHz主频要产生800kHz的PWM波，(72M/800k)-1=89。如果主频不同，这个值也要相应调整。

3. 数据结构设计与DMA配置

3.1 灯珠数据的内存布局

每个WS2812B灯珠需要24bit数据（GRB各8bit），我们需要把这些数据转换成PWM占空比序列。我的做法是定义一个数组：

uint16_t ledData[LED_NUM * 24]; // 每个bit用16位表示

为什么是16位？因为DMA传输的是定时器的CCR值。以72MHz主频为例：

0码：400ns高电平对应CCR=29（72M*0.4us≈29）
1码：800ns高电平对应CCR=58（72M*0.8us≈58）
复位信号：持续50μs以上低电平

3.2 DMA的巧妙运用

配置DMA循环模式，将内存中的波形数据自动搬运到定时器CCR寄存器：

hdma_tim2_ch1.Init.Mode = DMA_NORMAL; // 不能用循环模式！ hdma_tim2_ch1.Init.Direction = DMA_MEMORY_TO_PERIPH; hdma_tim2_ch1.Init.MemInc = DMA_MINC_ENABLE;

这里有个性能优化技巧：开启DMA传输完成中断，在中断里关闭定时器。实测发现如果让DMA一直循环传输，会导致灯带出现轻微闪烁。

4. 像素级控制API实现

4.1 颜色转换函数

WS2812B使用GRB顺序，与常规RGB不同。我封装了这个转换函数：

void setPixel(uint16_t n, uint8_t r, uint8_t g, uint8_t b) { uint32_t grb = ((g << 16) | (r << 8) | b); for(int i=0; i<24; i++) { ledData[n*24 + i] = (grb & (1<<(23-i))) ? PWM_1 : PWM_0; } }

这个函数的妙处在于可以直接使用标准的RGB值，内部自动处理GRB转换和bit分解。比如要让第5个灯珠显示红色：

setPixel(4, 255, 0, 0); // 注意索引从0开始

4.2 批量更新机制

为了避免频繁刷新导致灯带闪烁，我设计了双缓冲机制：

void refreshLEDs() { DMA1_Channel2->CNDTR = LED_NUM * 24; DMA1_Channel2->CMAR = (uint32_t)ledData; DMA_Cmd(DMA1_Channel2, ENABLE); TIM_Cmd(TIM2, ENABLE); while(!DMA_GetFlagStatus(DMA1_FLAG_TC2)); TIM_Cmd(TIM2, DISABLE); }

实际测试发现，300个灯珠全刷耗时约1.8ms，完全满足实时性要求。如果灯珠更多，可以考虑分段刷新。

5. 高级应用技巧

5.1 渐变效果实现

利用HSV色彩空间可以轻松实现平滑渐变：

void rainbowEffect(uint8_t offset) { for(int i=0; i<LED_NUM; i++) { uint8_t hue = (i * 255 / LED_NUM + offset) % 255; uint8_t r, g, b; hsv2rgb(hue, 255, 255, &r, &g, &b); setPixel(i, r, g, b); } refreshLEDs(); }

通过改变offset参数就能实现彩虹流动效果，比直接操作RGB值简单多了。

5.2 低功耗优化

长时间静态显示时，可以关闭定时器节省功耗：

void enterLowPowerMode() { TIM_Cmd(TIM2, DISABLE); GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_0; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET); }

实测功耗从12mA降到3mA，对电池供电项目特别有用。