【GD32】TIMER+PWM+DMA 驱动 WS2812B：从零构建高效灯效引擎

1. 为什么需要TIMER+PWM+DMA驱动方案

第一次接触WS2812B灯带时，我用的是最基础的GPIO翻转方案。那会儿为了精确控制0.4us的高电平，不得不把整个系统时钟频率调到最高，还用了大量NOP指令做延时。实际跑起来发现两个致命问题：一是CPU被完全占用，二是时序抖动严重导致灯珠颜色错乱。后来改用TIMER中断方案，虽然解决了CPU占用问题，但中断响应延迟还是会让灯效出现肉眼可见的闪烁。

直到发现TIMER+PWM+DMA这个黄金组合，所有问题迎刃而解。这个方案的精妙之处在于：

• TIMER：提供精准的80kHz时基信号（每个PWM周期12.5us）
• PWM：通过占空比区分0码（0.4us高电平）和1码（0.8us高电平）
• DMA：自动搬运内存中的PWM占空比数据，实现CPU零干预

实测下来，这个架构能稳定驱动超过500颗WS2812B灯珠，且CPU占用率始终为0。下面这张对比表能清晰看出三种方案的差异：

2. 硬件电路设计与注意事项

2.1 最小系统搭建

我用的是GD32F303CBT6这块性价比神器，它的TIMER4_CH2正好对应PA2引脚。硬件连接非常简单：

• WS2812B的DI接PA2
• VCC接3.3V（注意：部分灯带需要5V电平，需加电平转换）
• GND共地

踩坑记录：第一次测试时灯带完全没反应，后来发现是忘记在数据线加220Ω电阻。虽然WS2812B手册没明确要求，但这个电阻能有效抑制信号反射。另外建议在VCC和GND之间并联一个100μF电容，防止上电瞬间的电流冲击。

2.2 时序精度保障

WS2812B对时序极其敏感，必须确保：

1. PWM频率=80kHz（周期12.5us）
2. 0码高电平时间=0.4us±150ns
3. 1码高电平时间=0.8us±150ns

通过GD32的定时器配置可以完美匹配：

c复制timer_initpara.period = 150;        // 12.5us = (150+1)*(1/12MHz)
timer_ocintpara.ocpolarity = TIMER_OC_POLARITY_HIGH; // 高电平有效

实际用逻辑分析仪测量，得到的波形如下：

• 0码：高电平0.402us（理论值0.4us）
• 1码：高电平0.798us（理论值0.8us）
• 复位信号：60.2us（理论值>50us）

3. 核心代码实现解析

3.1 内存缓冲区设计

WS2812B每个灯珠需要24bit数据（GRB顺序），我们将其转换为PWM占空比数组。这里有个精妙的设计技巧：额外增加3个空灯珠数据作为复位信号。

c复制#define RGB_BIT 24       // 每个灯珠24bit
#define LED_RGB_NUM 60   // 实际灯珠数量 

u16 led1_rgb_buf[LED_RGB_NUM+3][RGB_BIT]; // 多3组用于复位

内存布局示例（以2个灯珠为例）：

3.2 DMA传输配置

DMA是整个系统的搬运工，关键配置点：

c复制dma_init_struct.periph_addr = (uint32_t)(&TIMER_DMATB(TIMER4)); // PWM寄存器地址
dma_init_struct.memory_addr = (uint32_t)(led1_rgb_buf);        // 内存源地址
dma_init_struct.number = (LED_RGB_NUM+3)*RGB_BIT;              // 传输数据量
dma_init_struct.direction = DMA_MEMORY_TO_PERIPHERAL;          // 传输方向

特别注意：GD32的DMA传输完成中断不是必须的。我在实践中发现，只要配置好传输数量，DMA会自动停止，无需中断处理。但保留中断可用于错误检测。

4. 高级灯效实现技巧

4.1 颜色空间转换

WS2812B使用GRB格式，与常规RGB不同。这里分享一个颜色转换的优化算法：

c复制// 将24bit RGB颜色转换为占空比数组
void RGB_to_PWM(uint32_t rgb, uint16_t pwm_buf[24]) {
    uint32_t grb = ((rgb>>8)&0xFF00FF) | ((rgb<<8)&0x00FF00);
    for(int i=0; i<24; i++) {
        pwm_buf[i] = (grb & (1<<(23-i))) ? 112 : 38;
    }
}

实测这个算法比逐位判断快3倍，特别适合需要实时渲染的场景。

4.2 呼吸灯效果优化

传统呼吸灯直接用sin函数计算亮度，会大量消耗CPU资源。我的改进方案：

1. 预计算256级亮度表
2. DMA传输时直接查表
3. 使用硬件定时器触发亮度更新

c复制// 预计算亮度表
uint8_t gamma_table[256];
for(int i=0; i<256; i++) {
    gamma_table[i] = pow(i/255.0, 2.8) * 255;
}

// 定时器中断中更新亮度
void TIMER2_IRQHandler() {
    static uint8_t phase = 0;
    set_all_leds(0xFF0000, gamma_table[abs(128-phase)]); // 红色呼吸
    phase++;
}

5. 常见问题排查指南

问题1：灯珠显示颜色错乱

• 检查DMA传输方向是否配置为MEM→PERIPH
• 测量PWM输出频率是否为80kHz
• 确认GRB顺序是否正确

问题2：后半段灯珠不亮

• 检查DMA传输数量是否包含复位信号
• 确认内存缓冲区没有越界
• 测试电源电压是否足够（长灯带需分段供电）

问题3：灯效出现卡顿

• 关闭其他中断源测试
• 检查DMA优先级是否为ULTRA_HIGH
• 降低PWM频率到60kHz测试（某些国产灯珠兼容性更好）

记得第一次调试时，我遇到灯珠随机闪烁的问题。后来发现是忘记关闭定时器的自动重载影子寄存器：

c复制timer_auto_reload_shadow_disable(TIMER4); // 必须关闭！

这个方案已经成功应用在多个商业项目中，包括智能家居氛围灯和舞台灯光控制系统。最让我自豪的是有一次用500颗WS2812B做了个音乐频谱显示器，通过FFT算法实时分析音频频率，再用DMA传输灯效数据，整个过程CPU占用率不到5%。