WS2812B_RGB灯介绍以及驱动方法(STM32)

于 2025-04-08 21:27:44 发布
阅读量1k 收藏 26
点赞数 29
文章标签： stm32 嵌入式硬件 单片机 c语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_44929802/article/details/147077622
版权

一、硬件介绍

WS2812B控制IC下常见的相关模块(方形 / 圆形LED灯)
在这里插入图片描述
在这里插入图片描述

主要特点：

● IC控制电路与LED点光源共用一个电源。
● 控制电路与RGB芯片集成在一个5050封装的元器件中， 构成一个完整的外控像素点。
● 内置信号整形电路， 任何一个像素点收到信号后经过波形整形再输出， 保证线路波形畸变不会累加。
● 内置上电复位和掉电复位电路。
● 每个像素点的三基色颜色可实现256级亮度显示， 完成16777216种颜色的全真色彩显示。
● 端口扫描频率2KHz/s。
● 串行级联接口， 能通过一根信号线完成数据的接收与解码。
● 任意两点传输距离在不超过5米时无需增加任何电路。
● 当刷新速率30帧/秒时， 级联数不小于1024点。
● 数据发送速度可达800Kbps。
● 光的颜色高度一致， 性价比高

产品概述：

WS2812B是一个集控制电路与发光电路于一体的智能外控LED光源其外型与一个5050LED灯珠相同， 每个元件即为一个像素点。像素点内部包含了智能数字接口数据锁存信号整形放大驱动电路， 还包含有高精度的内部振荡器和可编程定电流控制部分， 有效保证了像素点光的颜色高度一致。

数据协议采用单线归零码的通讯方式， 像素点在上电复位以后， DIN端接受从控制器传输过来的数据。

首先送过来的24bit数据被第一个像素点提取后， 送到像素点内部的数据锁存器， 剩余的数据经过内部整形处理电路整形放大后通过DO端口开始转发输出给下一个级联的像素点， 每经过一个像素点的传输， 信号减少24bit。

像素点采用自动整形转发技术， 使得该像素点的级联个数不受信号传送的限制， 仅受限信号传输速度要求。高达 2KHz 的端口扫描频率， 在高清摄像头的捕捉下都不会出现闪烁现象， 非常适合高速移动产品的使用。280μs以上的RESET时间， 出现中断也不会引起误复位， 可以支持更低频率、 价格便宜的MCU。LED具有低电压驱动、 环保节能、 亮度高、 散射角度大、 一致性好超、 低功率及超长寿命等优点。 将控制电路集成于LED上面， 电路变得更加简单， 体积小， 安装更加简便。

在这里插入图片描述在这里插入图片描述
在这里插入图片描述

二、硬件引脚连接

硬件引脚连接：

VCC -> 5V

GND -> GND

IN -> PA15 ( 定时器2 PWM_CH1 )

OUT -> IN ( 若要构成级联，连接到下一个模块的IN端 )

每个灯珠全亮的功率：0.3W

每个灯珠全亮的电流：0.6mA

三、程序代码

以STM32F103C8T6_HAL库代码为例，驱动WS2812B_RGB模块。

1. WS2812B的通信协议要求

WS2812B使用一种特殊的单线通信协议，通过高低电平的持续时间来区分数据位（0和1）。

具体时序要求如下：

  • 逻辑0：高电平持续时间约为0.25µs，低电平持续时间约为1µs。
  • 逻辑1：高电平持续时间约为1µs，低电平持续时间约为0.25µs。
  • 复位信号：低电平持续时间至少为280µs。

这些时序要求非常严格，误差不能超过±150ns，否则WS2812B无法正确解析数据。

2.使用PWM控制电平时间

PWM（脉宽调制）是一种通过调节信号的占空比（高电平时间与周期的比例）来模拟特定波形的方法。

对于WS2812B：

  • PWM可以精确控制高电平和低电平的持续时间。
  • 通过调整PWM的占空比，可以生成符合WS2812B要求的逻辑0和逻辑1信号。

例如：

  • 使用800kHz的PWM频率（周期为1.25µs）：
    • 逻辑0：高电平占空比为20%（0.25µs高电平，1µs低电平）。
    • 逻辑1：高电平占空比为80%（1µs高电平，0.25µs低电平）。

通过PWM，可以轻松生成符合WS2812B要求的信号。

3.使用DMA传输数据

DMA（直接内存访问）是一种硬件功能，允许外设直接访问内存，而不需要CPU的干预。

使用DMA的好处包括：

  • 减少CPU负担：CPU不需要参与每个PWM周期的数据传输，可以执行其他任务。
  • 高精度：DMA可以确保数据传输的精确性和实时性，避免因CPU中断或任务切换导致的时序误差。
  • 高效传输：DMA可以一次性传输大量数据（如多个LED的颜色数据），而不需要CPU逐字节处理。

在驱动WS2812B时：

  • 每个LED需要24个PWM周期（每个颜色位一个周期）。

  • 多个LED的数据需要连续传输，且不能中断。

  • DMA可以将所有LED的数据一次性传输到定时器的PWM寄存器中，确保信号的连续性和精确性。

4、HAL库相关配置

时钟树配置：主频为72Mhz，不分频

1、TIM2定时器配置

需要配置定时器生成800kHz的PWM信号。(WS2812B的通信频率为800kHz，详见硬件介绍章节)

  • 定时器预分频器（Prescaler）设置为0（不分频）。
  • 定时器周期（Period）设置为89 (90 - 1)，以生成800kHz的PWM信号。

PWM频率 = 系统时钟 / (Prescaler + 1) / (Period + 1)
800kHz = 72MHz / 1 / (89 + 1)

2、DMA配置

TIM的CCR为16位(Half Word)

5、相关代码

WS2812B.c：

WS2812B.c：
    
#include "ws2812b.h" 
extern TIM_HandleTypeDef htim2;
extern DMA_HandleTypeDef hdma_tim2_ch1;

//每一行24个bit代表一个RGB数据
volatile uint16_t RGB_Buf[ LED_COUNT + 1 ][ RGB_COUNT ];  // 最后一组数据为低电平，复位数据。

/*
功能：GRB -> RGB颜色转换
WS2812B的发送顺序为 GRB顺序(高位在前)，需转换将要发送的 RGB(常用) [ 255,255,255 ] -> GRB
Brightness：亮度设置(0~1f)
*/
static void RGB_Color(uint8_t LED_Num,RGB_Color_TypeDef Color,float Brightness){    
    
    Brightness = (Brightness > 1.0f) ? 1.0f : Brightness;
    Brightness = (Brightness < 0.0f) ? 0.0f : Brightness;
    
        // Gamma校正 + 亮度调整
    float gamma = 2.2f;
    uint8_t g_out = (uint8_t)(powf(Color.G / 255.0f, gamma) * Brightness * 255.0f + 0.5f);
    uint8_t r_out = (uint8_t)(powf(Color.R / 255.0f, gamma) * Brightness * 255.0f + 0.5f);
    uint8_t b_out = (uint8_t)(powf(Color.B / 255.0f, gamma) * Brightness * 255.0f + 0.5f);
    
	//颜色转换    
    for(uint8_t i=0;i<24;i++){
        if(i<8)  RGB_Buf[LED_Num][i] = ( g_out ) & (1 << (7 -i)) ? HIGH : LOW;          
            else if(i<16) RGB_Buf[LED_Num][i] = ( r_out ) & (1 << (15 -i)) ? HIGH : LOW;
                else
                    RGB_Buf[LED_Num][i] = ( b_out ) & (1 << (23 -i)) ? HIGH : LOW;    
    }
}

/*
功能：所有LED关闭(清屏)
*/
static void RGB_BLACK_All(void){
    for(uint8_t Led =0;Led<LED_COUNT;Led++)
        RGB_Color(Led,BLACK,0);
}
/*
功能：设置多个LED (固定颜色)
Led_Arr：要设置的LED (每行所在的位置)
Color：颜色RGB {255,255,255}
Brightness：亮度设置(0~1f)
*/
void Led_Single_Color(uint8_t Led_Arr[],RGB_Color_TypeDef Color,float Brightness)
{   
    
    for (uint8_t y = 0; y < LED_HEIGHT; y++) {         // 8 * 8
        for (uint8_t x = 0; x < LED_WIDTH; x++) {
            uint8_t led_index = y * LED_WIDTH + x; // 0~63
            if (Led_Arr[y] & (1 << (7-x))) {
                RGB_Color(led_index, Color,Brightness);
            }else{
                 RGB_Color(led_index, BLACK,0);            
            }
        }
    }
    /* 传输设置好的颜色数据
    功能：发送数组RGB_Buf内的所有数据，包含Reset数据    
    发送8位数据，需要1.25us；发送LED_COUNT个数据需要：LED_COUNT * 24 * 1.25us + Reset
    Reset: 24 * 1.25us = 30us;
    30us足够。
    */
    HAL_TIM_PWM_Start_DMA(&htim2, TIM_CHANNEL_1, (uint32_t *)RGB_Buf,(LED_COUNT + 1)*24);     
}

/*
功能：设置多个LED (自定义颜色)
Led_Arr：要设置的LED (每行所在的位置)
Color[]：颜色RGB数组 {255,255,255}...
Brightness：亮度设置(0~1f)
*/
void Led_Multiple_Colors(uint8_t Led_Arr[],RGB_Color_TypeDef Color[],float Brightness)
{
    uint8_t RGB_Num = 0;
    for (uint8_t y = 0; y < LED_HEIGHT; y++) {  
        for (uint8_t x = 0; x < LED_WIDTH; x++) {
            uint8_t led_index = y * LED_WIDTH + x; 
            if (Led_Arr[y] & (1 << (7-x))) {  
                RGB_Color(led_index, Color[RGB_Num++],Brightness);
            }else{
                 RGB_Color(led_index, BLACK,0);             
            }
        }
    }
    
    HAL_TIM_PWM_Start_DMA(&htim2, TIM_CHANNEL_1, (uint32_t *)RGB_Buf,(LED_COUNT + 1)*24);    
}

//清除所有LED颜色(清屏)
void RGB_Off(void){
    RGB_BLACK_All();
    HAL_TIM_PWM_Start_DMA(&htim2, TIM_CHANNEL_1, (uint32_t *)RGB_Buf,(LED_COUNT + 1)*24);
}

// PWM DMA 完成回调函数 停止
void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim)
{
		if(htim == &htim2)
	{
		HAL_TIM_PWM_Stop_DMA(&htim2, TIM_CHANNEL_1);
         
	}

}

WS2812B.h：

WS2812B.h：
    
#ifndef __WS2812B_H__
#define __WS2812B_H__

#include "main.h"
#include "Stdbool.h"
#include <string.h>
#include <math.h>


#define LED_WIDTH  8
#define LED_HEIGHT 8
#define LED_COUNT (LED_WIDTH * LED_HEIGHT)  // 总的LED的数量

#define RGB_COUNT 24 //每个LED所需的RGB 24位
#define HIGH 72// PWM占空比表示高电平，逻辑1： [ 高电平时间 = x / 90 × 1.25μs = 1μs ] => x = 72
#define LOW 18        // PWM占空比表示低电平，逻辑0： [ 高电平时间 = x / 90 × 1.25μs = 0.25μs ] => x = 18

#define WHITE  (RGB_Color_TypeDef){255, 255, 255}   //全白 #255
#define BLACK  (RGB_Color_TypeDef){0, 0, 0}   //全黑 #0

#define RED   (RGB_Color_TypeDef){255, 0, 0}  
#define GREEN (RGB_Color_TypeDef){0, 255, 0}   
#define BLUE  (RGB_Color_TypeDef){0, 0, 255}  

//单个LED的颜色控制结构体
typedef struct
{
	uint8_t R;
	uint8_t G;
	uint8_t B;
}RGB_Color_TypeDef; 
 

void Led_Single_Color(uint8_t Led_Arr[],RGB_Color_TypeDef Color,float Brightness);
void Led_Multiple_Colors(uint8_t Led_Arr[],RGB_Color_TypeDef Color[],float Brightness);
void RGB_Off(void);

#endif

main.c

...
    
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "ws2812b.h" 
/* USER CODE END Includes */

int main(void){
    
  const uint8_t Num_0[] = {0x00,0x1C,0x22, 0x22,0x22,0x1C,0x00,0x00}; // 0
  const uint8_t Num_1[] = {0x00,0x10,0x10,0x10,0x1C,0x10,0x00,0x00}; //	 1
  const uint8_t Num_2[] = {0x00,0x3E,0x0C,0x10,0x22,0x3C,0x00,0x00}; //	 2
  const uint8_t Num_3[] = {0x00,0x1E,0x20,0x1C,0x20,0x3E,0x00,0x00}; //	 3
  const uint8_t Num_4[] = {0x00,0x20,0x7E,0x24,0x28,0x30,0x00,0x00}; //	 4
  const uint8_t Num_5[] = {0x00,0x1E,0x20,0x1E,0x02,0x3E,0x00,0x00}; //	 5
  const uint8_t Num_6[] = {0x00,0x1C,0x22,0x3E, 0x06,0x1C,0x00,0x00}; // 6
  const uint8_t Num_7[] = {0x00,0x08,0x08,0x10,0x20,0x7E,0x00,0x00};//	 7
  const uint8_t Num_8[] = {0x00,0x1C,0x22,0x1C,0x22,0x3E,0x00,0x00};//	 8
  const uint8_t Num_9[] = {0x00,0x1E,0x30,0x3C,0x22,0x1C,0x00,0x00};//	 9

  uint8_t *ptr[] = {Num_0, Num_1, Num_2, Num_3, Num_4, Num_5, Num_6, Num_7, Num_8, Num_9};

  uint8_t i = 0;
  float light = 0.01;
  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE BEGIN 3 */
    if (i >= 10)  i = 0;

    if (light > 1.0)  light = 0.01;

    Led_Single_Color(ptr[i++], BLUE, light += 0.02);

    HAL_Delay(500);
  }
  /* USER CODE END 3 */
}

四、演示效果

0~9数字（500ms / 亮度逐渐增加）

在这里插入图片描述

今日待办
关注
【(内置IC)LED-WS2812 B驱动方法】
liu的博客
09-10 4050
通过WS2812B手册了解：该灯内置控制IC，仅需要一根控制线，称为单线串行控制；每一颗灯有四个引脚，分别为DIN、DOUT、VCC、GND，DOUT存在的意义是当存在多颗灯珠时，可以将它们以：DOUT接DIN的方式，首尾互相串接起来，即第一颗LED的DIN接入控制器信号，它的DOUT接到第二颗的DIN引脚，第二颗的DOUT又接入下一颗LED的DIN，以此无限（手册说的，有条件可测试看看）级联串接下去。实际应用也不会是一栋楼就一条灯带。。。所以这里说的无限连接，理解为能接很多很多LED便是。
ws2812B+stm32定时器方式驱动程序
04-24
靠定时器产生通信时序的WS2812B驱动程序，相较于靠spi产生通讯信号的方案，具有准确和稳定的优点，数据传输使用DMA模式，最少占用处理器资源
基于STM32F103的WS2812B彩灯驱动程序PWM+DMA（复制可用）
最新发布
小蜗牛的博客
02-27 1564
​一款集成了控制电路和RGB三色LED的智能外控LED光源的驱动程序，型号WS2812B，代码基于stm32f103，复制可直接使用，使用了pwm+dma实现
STM32F 驱动WS2812B (3) SPI+DMA
06-15
芯片使用STM32F107VC 理清思路，上一期通过TIM方式驱动灯组的时候说过，对于灯带的逻辑1就是一个高电平800ns低电平450ns的脉冲，逻辑0就是一个高电平400ns低电平850ns的脉冲。脉冲周期为1250ns。所以理论上通过SPI的方式可以产生这两种脉冲就可以实现控制灯带。
使用STM32单片机驱动WS2812B【外设篇】
刘老刘的博客
11-15 4298
注：带三角形的一头是VSS rgb.c文件 rgb.h文件 END~~
STM32CubeMX WS2812B灯驱动
weixin_46286415的博客
06-21 4681
一、WS2812B数据发送速度可达800Kbps。数据协议采用单线归零码的通讯方式，像素点在上电复位以后，DIN端接受从控制器传输过来的数据，首先送过来的24bit数据被第一个像素点提取后，送到像素点内部的数据锁存器，剩余的数据经过内部整形处理电路整形放大后通过DO端口开始转发输出给下一个级联的像素点，每经过一个像素点的传输，信号减少24bit。像素点采用自动整形转发技术，使得该像素点的级联个数不受信号传送的限制，仅受限信号传输速度要求。
[STM32]驱动WS2812b（TIM+DMA）
weixin_54557953的博客
04-23 2895
● 智能反接保护，电源反接不会损坏IC。● IC控制电路与LED点光源公用一个电源。● 控制电路与RGB芯片集成在一个5050封装的元器件中，构成一个完整的外控像素点。● 内置信号整形电路，任何一个像素点收到信号后经过波形整形再输出，保证线路波形畸变不会累加。● 内置上电复位和掉电复位电路。● 每个像素点的三基色颜色可实现256级亮度显示，完成16777216种颜色的全真色彩显示，扫描频率不低于400Hz/s。● 串行级联接口，能通过一根信号线完成数据的接收与解码。
STM32单片机WS2812B驱动程序灯效程序
06-06
代码主要是基于stm32开发，包括两路ws2812b初始化代码，以及呼吸灯、跑马灯、彩虹灯等灯效程序，均是用pwm+dma的方式发送数据，不占用内存，本程序已用在项目中，可稳定运行。
stm32_WS2812B
qq_59527512的博客
08-27 2796
这1.25us可以表示高位或低位，24个1.25us就是一个灯的颜色，发完一个灯的颜色后需要发送大于280us的低电平让数据从锁存器表现在灯上。：数据传输的顺序是先发送最低有效位（LSB），然后依次发送更高的位，对于颜色数据，首先是绿色（G），然后是红色（R），最后是蓝色（B）。当控制两个WS2812B灯珠时，数据缓冲区需要容纳两个灯珠的数据，即48位数据（每个灯珠24位）。：在连续的数据帧之间，需要有一个至少50微秒的低电平间隔，以标识数据帧的结束和下一个数据帧的开始。
WS2812B_STM32F4-master.zip_STM32F4驱动WS2812_WS2812 STM32F4_ws2812
07-13
这个压缩包"WS2812B_STM32F4-master.zip"包含了一套针对STM32F4的驱动程序，专门用于驱动WS2812B LED灯串。WS2812B是一款常见的智能RGB LED，它内置了控制电路，可以独立设置每个LED的颜色和亮度，常用于各种灯光...
STM32驱动彩灯模块---WS2812B
10-30
STM32驱动---WS2812B，工程文件，自己用过，控制没用问题，自己改引脚就随意移植了。
STM32驱动WS2812
10-12
STM32驱动WS2812，基于STM32CubeMX，输出90个串联的WS2812 LED
STM32F系列IO控制WS2812B
09-06
使用定时器2控制IO口，可以控制10盏WS2812灯，使用按键
STM32-WS2812B-RGBLED灯.zip
11-15
STM32控制WS2812B全彩LED灯闪烁，这个灯对时序要求比较严格，所以针对不同芯片需要调整，我这边还有CC2530和F4系列的程序资料，需要的可以私聊我。
WS2812B（PWM+DMA）_rgb灯_RGB呼吸灯_PWM控制LED_ws2812b_rgb灯全彩
09-30
在本文中，我们将深入探讨使用PWM（脉宽调制）和DMA（直接存储器访问）技术来控制WS2812B RGB呼吸灯的工作原理和实现方法。 首先，让我们理解PWM技术。PWM是一种通过改变信号占空比（高电平持续时间与总周期的比例...
WS2812B（PWM+DMA）.zip_NeoPixel stm32_WS2812 灯 控制_pwm ws2812_pwm控
07-14
在本文中，我们将深入探讨如何使用STM32微控制器通过PWM和DMA来控制WS2812B LED灯串，也被称为NeoPixel灯。这种控制方法可以实现高效、精确的色彩变化和动态效果。 首先，WS2812B是一款流行的智能LED灯，集成了RGB...
STM32_DMA_WS2812B_PWMWS2812_pwm_WS2812_stm32_dma_
10-02
本项目涉及的主题是利用STM32的DMA（直接内存访问）功能来控制PWM（脉宽调制）信号，进而驱动WS2812B这种智能LED灯。WS2812B是一种流行的RGB LED灯珠，它内置了驱动电路和控制逻辑，可以通过单根数据线进行串行通信...
ws2812b驱动方法(普通io延时驱动/spi驱动)
qq_57071547的博客
12-17 3387
记录一下这个当时制作ws2812驱动的心得，这是我自己的理解，如果有什么错误的话，希望广大网友可以及时发出来进行改正。首先不同的厂家的制作的ws28112b灯的时序也是不一样的，这个时序的话最好是不要在网上找ws2812b灯的时序，最好是问厂家要来数据手册，然后按照手册上的时序是最好的。下图是我当时使用的一款灯的时序表给第一次使用这个类型灯的小伙伴解释一下 ws2812b灯发送数据靠的是高低电平发送的时间来决定发送的数据是0还是1。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值