简介面向STM32嵌入式开发者与NeoPixel灯带爱好者这套WS2812B控制工程包聚焦PWMDMA驱动方式提供可直接编译运行的固件源码解决单线通信协议时序严格、刷新过程占用处理器资源过高等工程痛点。包内共216个文件压缩后约7.53MB以C语言源码和头文件为主体同时包含启动文件、项目工程配置、烧录固件、链接映射与编译列表等文件便于查看构建过程并快速移植到自己的硬件平台目前已有1699人学习下载。代码示范了定时器单脉冲模式的配置方法通过直接存储器访问将预置的RGB数据序列自动送入PWM输出寄存器从而在满足WS2812B脉冲宽度要求的同时使处理器可以并行处理其他任务。读者可以借此掌握从底层时序生成、DMA缓冲区设计到流水灯与渐变效果实现的一整套思路适合希望深入理解PWM、DMA与智能LED协同工作的嵌入式开发者参考。1. WS2812B 用 PWMDMA 而不是 GPIO 翻转先想清楚为什么拿到一个命名成WS2812BPWMDMA.zip的 STM32 工程时通常打开就是定时器、DMA、一个 uint16_t 数组外加注释里写着的 NeoPixel。这个组合解决的不是“能不能点亮”而是灯多了以后 CPU 还干不干别的事。WS2812B 是单总线灯珠0 码和 1 码只是高电平宽度不同但每颗灯要 24 bit 数据60 颗灯一帧就是 1440 bit全部靠 GPIO 翻转加延时中断一来时序立刻乱。PWMDMA 的思路是让硬件接管这个过程定时器保持 800kHz 的位周期DMA 每个周期把 CCR 比较值换成新的PWM 输出的高电平宽度自然就成了 0 码或 1 码。CPU 只需要把这一帧的 CCR 序列写进内存剩下全是外设自己在跑。适合从 Arduino NeoPixel 代码迁移到 STM32、以及对裸机时序稳定性有要求的开发者。2. WS2812B 时序与 STM32 定时器 PWM 的映射关系2.1 0 码和 1 码的区别在于高电平持续时间WS2812B 看起来是一根信号线串行发数据实际上它的物理层是“单线归零码”。每个 bit 的周期固定不变判断 0 还是 1 只看高电平在这个周期里占多长。下表是各版本手册里比较常见的一组参考值参数参考值说明T0H0.35us ± 0.15us0 码高电平宽度T0L0.80us ± 0.15us0 码低电平宽度T1H0.70us ± 0.15us1 码高电平宽度T1L0.55us ± 0.15us1 码低电平宽度位周期1.25us对应 800kHzRES大于 50us帧间复位信号整条低电平注意这里的 T0L 和 T1L 是从位周期里减出来的不同批次官方文档会给不同表述但位周期 1.25us 和两个高电平窗口基本一致。灯珠内部在每位周期的 250ns 附近采样一次电平所以 0.35us 和 0.70us 只要稳定落在窗口内就不会误判。2.2 为什么 GPIO 翻转方案很难维持 800kHz 时序很多人第一次点亮 WS2812B 用的是 GPIO 拉高、延时、拉低、再延时这个做法在 Arduino 上能跑是因为 Arduino 没有复杂中断环境。STM32 上不同72MHz 主频下一个位周期只有 90 个时钟周期。一次 GPIO 翻转加一个空循环大约要 20 到 30 个周期本来够用但系统里只要有定时器中断、串口中断、ADC 中断插进来某一位的高电平宽度就会被拉长或缩短。灯珠对单个位的容忍范围通常在几百纳秒一次 1us 的中断打断就会让这一位失效。更麻烦的是 GPIO 方案下 CPU 必须全程参与每一 bit 的翻转灯带长度增加时刷新率会被拉低。常见做法是把数据算好后一次性交给外设这也是 PWMDMA 方案存在的根本原因。2.3 PWM 用占空比表达 0/1 码但位周期必须锁死用定时器 PWM 模拟 WS2812B 时让定时器工作在 800kHz也就是每个 PWM 周期都是 1.25us。在这个固定周期里把 CCR 比较值改小高电平就短输出的是 0 码把 CCR 比较值改大高电平就长输出的是 1 码。从外部看这就是一个占空比约 28% 和约 56% 的 PWM 波但本质上每一位仍然是完整的一个位周期。这里的隐藏约束是ARR 值一旦定下来就不能动位周期必须始终是 1.25us 左右。如果只想着调占空比而把 ARR 改大改小T0H 和 T1H 会一起偏移灯珠可能把整个数据流当成无效信号。后面 4.3 会说明WS2812B 也不能像普通 LED 那样靠调 PWM 占空比调亮度所有亮度处理都必须在颜色数据层面做。2.4 72MHz 主频下 PSC、ARR、CCR 怎么配以 STM32F103 或 F401 这类 72MHz 主频的芯片为例定时器时钟取 72MHz预分频 PSC 设 0那么一个计数周期是 1/72MHz。要得到 1.25us 的位周期ARR 1.25us / (1/72MHz) - 1 90 - 1 890 码高电平 0.35us 对应 25.2 个计数周期取整为 251 码高电平 0.70us 对应 50.4 个计数周期取整为 50。于是推荐参数如下参数推荐值说明PSC0不分频ARR89位周期 90 个 tick共 1.25usCCR_ZERO25高电平约 347ns落在 0 码窗口CCR_ONE50高电平约 694ns落在 1 码窗口手头几份 WS2812B 中文资料里有的会把周期写成 1.3us 或把 T1H 上限放宽到 1.0us实际驱动时不必逐字对齐只要高电平落进 0.2us 到 0.85us 这个区间就能稳定工作。最怕的是 CCR_ONE 太大导致高电平接近甚至超过一个位周期灯带会把一串 1 码当成复位段。提示如果用 HAL 库必须先确认 SystemCoreClock 和 APB1 定时器时钟倍频关系。F1 系列 APB1 预分频为 1 时定时器时钟是 36MHz预分频为 2 时定时器时钟反而回到 72MHz。把 PSC 算错一倍是这类驱动最常见的起步错误。3. 搭建最小驱动TIM PWM 和 DMA 的初始化与缓冲区3.1 引脚和定时器选型通用定时器 TIM2、TIM3、TIM4、TIM5 的通道都可以输出 PWM也都有对应的 DMA 请求线。示例选择 PA6 作为 TIM3_CH1 输出DMA1 通道 6 对应 TIM3_CH1 的请求。选引脚时注意避开调试口、USB 引脚和晶振引脚同时确认该引脚在这个系列芯片上的 AF 编号。F4 系列可以把 PA6 配置成GPIO_AF2_TIM3F1 系列没有 AF 寄存器直接把引脚配置成复用推挽输出即可。命名成WS2812BPWMDMA的工程包大多是网上流传的 HAL 工程沿用的也是这个套路一个定时器通道加一条 DMA 请求线不改动其他外设。3.2 TIM PWM 初始化代码TIM_HandleTypeDef htim3; TIM_OC_InitTypeDef soc; void WS2812_TIM_PWM_Init(void) { __HAL_RCC_TIM3_CLK_ENABLE(); htim3.Instance TIM3; htim3.Init.Prescaler 0; htim3.Init.Period 89; /* 位周期 1.25us 72MHz */ htim3.Init.CounterMode TIM_COUNTERMODE_UP; htim3.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; HAL_TIM_PWM_Init(htim3); soc.OCMode TIM_OCMODE_PWM1; soc.Pulse 0; /* 初始 CCR0避免上电误亮 */ soc.OCPolarity TIM_OCPOLARITY_HIGH; soc.OCFastMode TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(htim3, soc, TIM_CHANNEL_1); }PSC 为 0ARR 为 89计数从 0 到 89溢出周期正好是 90 个 tick。Period89对应的是 1.25us 而不是 90us因为每个 tick 约 13.9ns。Pulse0让 CCR1 初始为 0PWM1 模式下输出常低上电瞬间灯带不会有杂波。等 DMA 把第一个值送进 CCR1 后输出才开始按数据位跳变。3.3 DMA 配置和缓冲区结构#define PIXEL_NUM 60 #define BITS_EACH 24 #define RESET_BITS 48 #define BUF_LEN (PIXEL_NUM * BITS_EACH RESET_BITS) uint16_t pwm_buf[BUF_LEN] __attribute__((aligned(4))); DMA_HandleTypeDef hdma_tim3_ch1; void WS2812_DMA_Init(void) { __HAL_RCC_DMA1_CLK_ENABLE(); hdma_tim3_ch1.Instance DMA1_Channel6; /* TIM3_CH1 的 DMA 映射 */ hdma_tim3_ch1.Init.Direction DMA_MEMORY_TO_PERIPHERAL; hdma_tim3_ch1.Init.PeriphInc DMA_PINC_DISABLE; /* 外设地址固定为 CCR1 */ hdma_tim3_ch1.Init.MemInc DMA_MINC_ENABLE; /* 每次读取 pwm_buf 下一项 */ hdma_tim3_ch1.Init.PeriphDataAlignment DMA_PDATAALIGN_HALFWORD; hdma_tim3_ch1.Init.MemDataAlignment DMA_MDATAALIGN_HALFWORD; hdma_tim3_ch1.Init.Mode DMA_CIRCULAR; /* 循环模式相当于 continuous requests */ hdma_tim3_ch1.Init.Priority DMA_PRIORITY_HIGH; HAL_DMA_Init(hdma_tim3_ch1); __HAL_LINKDMA(htim3, hdma[TIM_DMA_ID_CC1], hdma_tim3_ch1); }pwm_buf 里每个元素是一个 uint16_t这个值最终会被 DMA 写进 TIM3 的 CCR1 寄存器。CCR1 是 16 位寄存器所以外设和内存的数据宽度都必须配置成 HALFWORD如果配置成字宽度DMA 会把相邻寄存器一起覆盖掉表现就是灯带完全乱掉。DMA_PINC_DISABLE很关键因为要写入的外设地址永远是同一个 CCR1而不是连续地址。内存地址要递增所以MemInc打开。Mode 选 CIRCULARDMA 发送完整个缓冲区后会自动从头开始灯带才能持续刷新这也是数据手册里说的 DMA continuous requests 的含义。GPIO 复用输出配置同样不能省GPIO_InitTypeDef gpio; __HAL_RCC_GPIOA_CLK_ENABLE(); gpio.Pin GPIO_PIN_6; gpio.Mode GPIO_MODE_AF_PP; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_HIGH; gpio.Alternate GPIO_AF2_TIM3; /* F4/F7 写法F1 改用 GPIO_MODE_AF_PP 即可 */ HAL_GPIO_Init(GPIOA, gpio);这里必须是复用推挽输出而不是普通推挽输出否则定时器不能控制引脚电平。上拉和下拉都关掉避免在信号线上叠加多余的充放电时间影响高电平宽度。3.4 把 RGB 颜色转换成 CCR 序列#define CCR_ZERO 25 #define CCR_ONE 50 void SetPixelColor(uint16_t idx, uint8_t r, uint8_t g, uint8_t b) { uint32_t base idx * 24; uint8_t grb[3] { g, r, b }; /* WS2812B 数据顺序是 GRB */ for (int i 0; i 24; i) { uint8_t bit (grb[i / 8] (7 - (i % 8))) 0x01; pwm_buf[base i] bit ? CCR_ONE : CCR_ZERO; } }每次调用只更新对应灯珠的 24 个半字。循环里从每个字节的最高位开始取i/8决定当前取的是 G、R 还是 B7 - (i % 8)决定是字节里的第几位。颜色顺序写成 GRB 是 WS2812B 最常见的坑上位机传来的颜色对不上时先改这里而不是改驱动。缓冲区末尾的 48 个元素保持 0那是复位段。这个长度后面会算。4. 从 1 颗灯到 N 颗灯帧缓冲、复位段与亮度控制4.1 帧缓冲的长度怎么算缓冲区长度由三部分组成灯珠数乘每颗 24 bit加上复位段占用的 bit 数。以 60 颗灯、复位段 48 bit 为例#define BUF_LEN (60 * 24 48) /* 1488 个 uint16_t */不同灯珠数量对应的内存占用如下灯珠数数据半字数SRAM 占用307681536 字节6014882976 字节14435047008 字节60014448约 28KBDMA 的传输计数器是 16 位单轮最多传 65535 个半字也就是最多约 2730 颗灯。实际工程中一般不会到极限因为大容量灯带更常见的是多条并联每条用独立的定时器通道和 DMA 通道。4.2 复位段长度50us 低电平要留余量WS2812B 要求相邻两帧之间至少 50us 低电平。一个复位位是 1.25us50us 对应 40 个 bit工程上一般多留一点空间50us / 1.25us 40 bit 取 48 bit实际低电平 60us每帧发送完成后这 48 个元素的 CCR 都是 0PWM 输出保持低电平。由于用的是循环 DMA 模式48 个零位之后下一帧第一颗灯的数据立即开始空档正好是 60us满足灯珠复位条件。启动传输的函数可以写成void WS2812_Show(void) { HAL_TIM_PWM_Stop_DMA(htim3, TIM_CHANNEL_1); HAL_TIM_PWM_Start_DMA(htim3, TIM_CHANNEL_1); }Stop 后再 Start确保 DMA 从头开始发送。如果已经在 CIRCULAR 模式下运行停止后再启动不会破坏复位段长度因为复位段就在缓冲区末尾。要注意别在主循环里频繁调用这两个函数每次调用都会让 DMA 重新装载帧率会受影响。注意Stop_DMA 只是停止 DMA 搬运PWM 输出不会立刻变成固定低电平引脚状态由此时 CCR1 的值决定。为了确保复位段干净初始化时就把 pwm_buf 清零并且每次更新完所有灯珠数据后再调用 Show。4.3 调亮度不能改 CCR要用 Gamma LUTWS2812B 的数据位高电平宽度必须落在 0 码或 1 码的判定窗口内所以不能靠把 CCR_ONE 从 50 改成 30 来降低亮度这样会被灯珠识别成 0 码。亮度的唯一正确做法是修改传递给灯珠的颜色值。常见的做法是预计算一张 256 项的 Gamma 查找表uint8_t gamma8[256]; void BuildGammaTable(float gamma) { for (int i 0; i 256; i) { float v (float)i / 255.0f; gamma8[i] (uint8_t)(powf(v, gamma) * 255.0f 0.5f); } }gamma 取 2.2 到 2.8 之间的值低灰阶的跳变会平滑很多。在 SetPixelColor 里调用前先过一遍表r gamma8[r]; g gamma8[g]; b gamma8[b];这样亮度控制全部集中在数据映射层PWM 的 CCR_ONE 和 CCR_ZERO 始终保持不变。环形缓冲区的刷帧频率也可以通过降低主循环的更新频率来控制但不要把刷新率降到 20fps 以下否则灯带会有可见闪烁。5. 排错与验证这些配置会让灯只亮第一颗或整条闪5.1 只亮第一颗灯的检查顺序只亮第一颗灯颜色还不对绝大多数问题在 DMA 配置或缓冲区填充。按照下面的顺序排查现象最常见原因检查点只有第一颗亮DMA 方向配反Direction 应为 MEMORY_TO_PERIPHERAL第一颗灯颜色错乱数据位顺序反了检查 7 - (i % 8) 的移位方向第一颗亮一下后全灭GPIO 复用没配对对照芯片 AF 表查 Alternate 值整条灯带随机闪DMA 模式配成 NormalMode 应为 CIRCULAR颜色为红色却显示绿色GRB / RGB 顺序确认 grb[3] 的顺序如果缓冲区里每一位都正确但物理上只有第一颗收到数据最可能的原因是 DMA 没进循环模式发送完一轮后不再触发后续灯珠收不到完整数据。5.2 高级定时器的 PWM 故障保护别忽略使用 TIM1 或 TIM8 这类高级定时器时如果 BRK 功能被意外打开输出会被故障信号强制拉低。现象是灯带偶尔亮一瞬就灭或者完全没输出。通用定时器 TIM2/TIM3 没有这个机制所以很多驱动例子刻意避开 TIM1。必须用 TIM1 时初始化后确认 BDTR 寄存器的 MOE 位为 1。HAL 的HAL_TIM_PWM_Start会自动打开 MOE但如果用户代码里又配置了 BreakInput 并使能了极性不正确的信号输出仍然会被关闭。最简单的方法是先检查原理图上有没有外部故障信号接到 BKIN 引脚没有的话别在HAL_TIMEx_ConfigBreak里使能任何 break 源。5.3 用逻辑分析仪验证位宽而不是靠人眼人眼只能判断灯带亮不亮判断不了 0 码和 1 码是否落在窗口内。信号线上放一个 24MHz 采样率以上的逻辑分析仪抓一段已知数据例如让第一颗灯显示纯绿色期望波形应是24 位里先看到 1 码GRB 顺序下 G 是 0xFF所以 G 的 8 位全是长高电平R 和 B 都是 0x00对应 16 个短高电平帧尾能看到一段 60us 左右的低电平。如果逻辑分析仪不支持解码 WS2812 协议可以直接量两个值1 码高电平是否在 0.55us 到 0.85us 之间、0 码高电平是否在 0.20us 到 0.50us 之间。只要这两个窗口对灯带就能稳定工作。最后一个实用的验证技巧启动前把 CCR1 预置成 pwm_buf[0] 的值DMA 启动后的第一个位周期就不会出现一次未知宽度的毛刺。做法是在HAL_TIM_PWM_Start_DMA之前执行一行寄存器写入TIM3-CCR1 pwm_buf[0];这样整个缓冲区的第一帧从第一个数据位开始就是干净的示波器上看不到起始位的异常拉高灯带首尾的颜色也不会出现一位偏移。本文还有配套的精品资源点击获取
