保姆级教程：用STM32F103的PWM驱动WS2812B彩灯，附完整代码与波形分析-编程阁

STM32F103驱动WS2812B全流程实战：从时序解析到灯效编程

第一次看到WS2812B灯带变幻出彩虹般的光效时，我就被这种智能LED的魔力吸引了。作为创客项目中最受欢迎的RGB灯珠之一，它只需要一根信号线就能控制数百个灯珠，但精确的时序要求也让不少初学者在驱动时踩坑。本文将用STM32F103的PWM功能，带你完整实现WS2812B的驱动控制。

1. 硬件设计关键点

WS2812B是集成了控制电路和RGB芯片的智能LED，每个灯珠都能独立编程。在开始编码前，需要特别注意几个硬件细节：

电压匹配问题：WS2812B的工作电压是5V，而STM32F103的GPIO输出高电平只有3.3V。虽然实践中3.3V信号也能驱动，但为了稳定性建议：

使用电平转换芯片（如74HCT245）
简单分压电路（330Ω+680Ω电阻分压）
直接使用开漏输出模式（需外部上拉电阻到5V）

注意：直接连接时若出现灯珠闪烁或颜色异常，首先检查电平匹配

PCB布局建议：

每3-5个灯珠增加一个100μF电容滤波
信号线长度超过30cm时加100Ω终端电阻
避免信号线与高频线路平行走线

典型连接方式：

STM32F103 PWM引脚 → 电平转换电路 → WS2812B DIN WS2812B VCC → 5V电源（每米灯带需3A电流） WS2812B GND → 与MCU共地

2. 时序原理深度解析

WS2812B采用单线归零码协议，每个bit用不同占空比的PWM波形表示。理解时序规格是成功驱动的关键：

2.1 比特编码机制

根据WS2812B datasheet，信号周期固定为1.25μs（800kHz速率）：

逻辑"0"：高电平220-380ns + 低电平580-1μs
逻辑"1"：高电平580-1μs + 低电平220-380ns

实测发现最佳参数：

// 逻辑0: 高电平350ns, 低电平900ns #define T0H (TIM_CLOCK / (1000000000 / 350)) #define T0L (TIM_CLOCK / (1000000000 / 900)) // 逻辑1: 高电平700ns, 低电平550ns #define T1H (TIM_CLOCK / (1000000000 / 700)) #define T1L (TIM_CLOCK / (1000000000 / 550))

2.2 复位信号要求

每个数据帧结束后需要至少280μs的低电平复位信号。常见错误：

复位时间不足导致灯珠不更新
复位期间误发数据导致显示错乱
多个复位信号叠加引起闪烁

3. PWM配置实战

使用STM32F103的TIM4 CH1（PB6）生成PWM波形：

3.1 定时器初始化

void PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; TIM_TimeBaseInitTypeDef TIM_TimeBaseStruct; TIM_OCInitTypeDef TIM_OCInitStruct; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // PB6 as TIM4 CH1 GPIO_InitStruct.GPIO_Pin = GPIO_Pin_6; GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStruct); // 72MHz / 8 = 9MHz计数频率 TIM_TimeBaseStruct.TIM_Prescaler = 8 - 1; TIM_TimeBaseStruct.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseStruct.TIM_Period = 90 - 1; // 9MHz/90=100kHz(10μs周期) TIM_TimeBaseStruct.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseInit(TIM4, &TIM_TimeBaseStruct); // PWM模式1 TIM_OCInitStruct.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStruct.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStruct.TIM_Pulse = 0; TIM_OCInitStruct.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC1Init(TIM4, &TIM_OCInitStruct); TIM_Cmd(TIM4, ENABLE); TIM_CtrlPWMOutputs(TIM4, ENABLE); }

3.2 数据发送算法

通过DMA实现高效数据传输：

void WS2812_Send(uint8_t (*color)[3], uint16_t len) { static uint16_t pwmBuffer[24 * MAX_LEDS + 50]; // 每个bit用1个PWM周期表示 // 转换RGB数据到PWM波形 for(int i=0; i<len; i++) { uint32_t grb = ((uint32_t)color[i][1]<<16) | ((uint32_t)color[i][0]<<8) | (uint32_t)color[i][2]; for(int j=0; j<24; j++) { pwmBuffer[i*24 + j] = (grb & (1<<(23-j))) ? T1H : T0H; } } // 添加复位信号（50个0） for(int i=0; i<50; i++) { pwmBuffer[len*24 + i] = 0; } DMA_Config(pwmBuffer, len*24 + 50); }

4. 高级灯效实现

掌握了基础驱动后，可以创造各种炫酷效果：

4.1 彩虹渐变算法

void RainbowEffect(uint8_t (*colors)[3], uint16_t len) { static uint16_t hue = 0; for(int i=0; i<len; i++) { uint16_t hue_val = (hue + i * 360 / len) % 360; HSVtoRGB(hue_val, 100, 100, colors[i]); } hue = (hue + 1) % 360; WS2812_Send(colors, len); } // HSV转RGB函数 void HSVtoRGB(uint16_t h, uint8_t s, uint8_t v, uint8_t *rgb) { uint8_t region = h / 60; uint8_t remainder = (h % 60) * 255 / 60; uint8_t p = (v * (255 - s)) >> 8; uint8_t q = (v * (255 - ((s * remainder) >> 8))) >> 8; uint8_t t = (v * (255 - ((s * (255 - remainder)) >> 8))) >> 8; switch(region) { case 0: rgb[0]=v; rgb[1]=t; rgb[2]=p; break; case 1: rgb[0]=q; rgb[1]=v; rgb[2]=p; break; case 2: rgb[0]=p; rgb[1]=v; rgb[2]=t; break; case 3: rgb[0]=p; rgb[1]=q; rgb[2]=v; break; case 4: rgb[0]=t; rgb[1]=p; rgb[2]=v; break; default:rgb[0]=v; rgb[1]=p; rgb[2]=q; break; } }

4.2 音乐频谱可视化

通过ADC采集音频信号，转换为灯带效果：

void AudioSpectrumEffect(void) { static uint8_t colors[LED_NUM][3]; static uint8_t height[LED_NUM] = {0}; // 获取音频幅值（0-100） uint8_t audio_level = Get_Audio_Level(); // 更新高度数组 for(int i=LED_NUM-1; i>0; i--) { height[i] = height[i-1]; } height[0] = audio_level; // 生成颜色 for(int i=0; i<LED_NUM; i++) { uint8_t val = height[i] * 255 / 100; colors[i][0] = val; colors[i][1] = 255 - val; colors[i][2] = 0; } WS2812_Send(colors, LED_NUM); }