手把手教你玩转WS2812B灯

手把手教你玩转WS2812B灯
效果展示WS2812B简介CubeMX配置代码实现
这是一起关于WS2812B灯带的驱动教学,带你玩转WS2812B灯带,下面我们先来看看效果吧
效果展示
WS2812B测试
WS2812B简介
WS2812B是一种数字可编程LED灯条,也被称为NeoPixel。它由RGB(红、绿、蓝)三种颜色的LED组成,并集成了控制电路和信号处理功能。每个WS2812B LED都有一个唯一的地址,并可以通过单个数据线进行串联连接。
WS2812B具有以下特点:
高度可编程性:每个LED可以独立地设置颜色和亮度,因此可以实现各种动态效果和彩色变化。简单的控制接口:WS2812B使用单个数据线进行通信,通过发送特定的序列来控制每个LED的颜色和亮度。低功耗:WS2812B采用高效的LED驱动技术,具有较低的功耗,适合电池供电的应用。灵活的应用:WS2812B可广泛应用于室内装饰、灯光艺术、电子产品原型设计等领域,具有丰富的创意空间和应用场景。需要注意的是,WS2812B是商业产品,如果你有任何具体的问题或需求,请提供更多细节,我将尽力为您提供帮助。
具体参数如下(了解5V供电即可):
引脚图:
当然,在使用的过程中,我们往往会使用不止一个LED灯,会将多个灯级联成灯带或者灯板,我们这次使用的就是灯板。
具体级联方式如下:
其中DIN作为数据的输入端,每个LED需要24位数据控制,多出的数据会通过DOUT引脚传递给下一个LED,以此类推,当WS2812接收到280us以上的低电平时,数据被写入LED,灯的颜色改变。
以下是数据的表示方法:
通常使用PWM波的方式驱动WS2812B,PWM的信号频率为800KHz,即一个数据表示的周期为1.25us
数据0由一个TOH和TOL表示数据1由一个T1H和T1L表示0码和1码的差别就是在一个周期内高电平持续时间不同,我们粗略的认为0码高电平时间为周期的1/3,1码高电平时间为周期的2/3这样的话,只需要设置PWM信号频率为800KHz,当占空比为33%时,数据为0;当占空比为66%时,数据为1.RSSET时间为280us以上的低电平,但我在其他的资料里面看到好像不需要那么久,24us即可,这个我们这里不管,当作24us即可。
在有多个led级联的情况下,先发送第一个led的数据,后第二个、第三个、以此类推。
CubeMX配置
其他部分的配置,我们这里不做介绍,重点展示tim1的PWM输出配置
使用定时器内部时钟,通道1PWM输出模式
设置时钟不分频,自动重装载值为125,则PWM波频率 = 100MHz / 125 = 800KHz,刚好符合WS2812B的数据写入频率。
开启定时器DMA请求,数据传输方向为内存到外设,内存地址递增模式。字长为32位。
代码实现
RGB.c
#include "RGB.h"
#include "tim.h"
#include "stdlib.h"
/*Some Static Colors------------------------------*/
const RGB_Color_TypeDef RED = {255,0,0}; //红色
const RGB_Color_TypeDef GREEN = {0,255,0}; //绿色
const RGB_Color_TypeDef BLUE = {0,0,255}; //深蓝色
const RGB_Color_TypeDef SKY = {0,255,255}; //天蓝色
const RGB_Color_TypeDef MAGENTA = {255,0,220}; //粉色
const RGB_Color_TypeDef YELLOW = {128,216,0}; //黄色
const RGB_Color_TypeDef OEANGE = {127,106,0}; //橘色
const RGB_Color_TypeDef BLACK = {0,0,0}; //无颜色
const RGB_Color_TypeDef WHITE = {255,255,255}; //白色
//将好看的颜色封装成数组,便于集中管理和访问
RGB_Color_TypeDef table[16] =
{
{254,67,101},
{76,0,10},
{249,15,173},
{128,0,32},
{158,46,36},
{184,206,142},
{227,23,13},
{178,34,34},
{255,99,71},
{99,38,18},
{255,97,0},
{21,161,201},
{56,94,15},
{50,205,50},
{160,32,240},
{218,60,90}
};
//这些是好看的颜色
const RGB_Color_TypeDef color1 = {254,67,101};
//const RGB_Color_TypeDef color2 = {76,0,10};
//const RGB_Color_TypeDef color3 = {249,15,173};
//const RGB_Color_TypeDef color4 = {128,0,32};
//const RGB_Color_TypeDef color5 = {158,46,36};
//const RGB_Color_TypeDef color6 = {184,206,142};
//const RGB_Color_TypeDef color7 = {227,23,13};
//const RGB_Color_TypeDef color8 = {178,34,34};
//const RGB_Color_TypeDef color9 = {255,99,71};
//const RGB_Color_TypeDef color10 ={99,38,18};
//const RGB_Color_TypeDef color11= {255,97,0};
//const RGB_Color_TypeDef color12= {21,161,201};
//const RGB_Color_TypeDef color13= {56,94,15};
//const RGB_Color_TypeDef color14= {50,205,50};
//const RGB_Color_TypeDef color15= {160,32,240};
//const RGB_Color_TypeDef color16= {218,60,90};
/*二维数组存放最终PWM输出数组,每一行24个数据代表一个LED,最后一行24个0用于复位*/
uint32_t Pixel_Buf[Pixel_NUM+1][24];
/*
功能:最后一行装在24个0,输出24个周期占空比为0的PWM波,作为最后reset延时,这里总时长为24*1.25=37.5us > 24us(要求大于24us)
//如果出现无法复位的情况,只需要在增加数组Pixel_Buf[Pixel_NUM+1][24]的行数,并改写Reset_Load即可,这里不做演示了,
*/
static void Reset_Load(void)
{
uint8_t i;
for(i=0;i<24;i++)
{
Pixel_Buf[Pixel_NUM][i] = 0;
}
}
/*
功能:发送数组Pixel_Buf[Pixel_NUM+1][24]内的数据,发送的数据被存储到定时器1通道1的CCR寄存器,用于控制PWM占空比
参数:(&htim1)定时器1,(TIM_CHANNEL_1)通道1,((uint32_t *)Pixel_Buf)待发送数组,
(Pixel_NUM+1)*24)发送个数,数组行列相乘
*/
static void RGB_SendArray(void)
{
HAL_TIM_PWM_Start_DMA(&htim1, TIM_CHANNEL_1, (uint32_t *)Pixel_Buf,(Pixel_NUM+1)*24);
}
/*
功能:设定单个RGB LED的颜色,把结构体中RGB的24BIT转换为0码和1码
参数:LedId为LED序号,Color:定义的颜色结构体
*/
//刷新WS2812B灯板显示函数
static void RGB_Flush(void)
{
Reset_Load(); //复位
RGB_SendArray(); //发送数据
}
void RGB_SetOne_Color(uint8_t LedId,RGB_Color_TypeDef Color)
{
uint8_t i;
if(LedId > Pixel_NUM)return; //avoid overflow 防止写入ID大于LED总数
//这里是对 Pixel_Buf[LedId][i]写入一个周期内高电平的持续时间(或者说时PWM的占空比寄存器CCR1),
for(i=0;i<8;i++) Pixel_Buf[LedId][i] = ( ((Color.G/5) & (1 << (7 -i)))? (CODE_1):CODE_0 );//数组某一行0~7转化存放G
for(i=8;i<16;i++) Pixel_Buf[LedId][i] = ( ((Color.R/5) & (1 << (15-i)))? (CODE_1):CODE_0 );//数组某一行8~15转化存放R
for(i=16;i<24;i++) Pixel_Buf[LedId][i] = ( ((Color.B/5) & (1 << (23-i)))? (CODE_1):CODE_0 );//数组某一行16~23转化存放B
}
//调用RGB_SetOne_Color函数,完成对多个LED的颜色设置。
void RGB_SetMore_Color(uint8_t head, uint8_t heal,RGB_Color_TypeDef color)
{
uint8_t i=0;
for(i=head;i<=heal;i++)
{
RGB_SetOne_Color(i,color) ;
}
}
//用来显示单个颜色的函数,只能从第一个开始显示,不好用
//void RGB_RED(uint16_t Pixel_Len)
//{
// uint16_t i;
// for(i=0;i // { // RGB_SetOne_Color(i,RED); // } //} // //灯管实现函数(完成本期效果的实现) void RGB_Show_64(void) { RGB_SetMore_Color(0,63,BLACK); //清空所有的LED数据 RGB_SetMore_Color(0,rand()%8,table[rand()%16]); //第一行随机个灯亮随机颜色 RGB_SetMore_Color(8,rand()%8+8,table[rand()%16]); //第二行。。。。以此类推 RGB_SetMore_Color(16,rand()%8+16,table[rand()%16]); RGB_SetMore_Color(24,rand()%8+24,table[rand()%16]); RGB_SetMore_Color(32,rand()%8+32,table[rand()%16]); RGB_SetMore_Color(40,rand()%8+40,table[rand()%16]); RGB_SetMore_Color(48,rand()%8+48,table[rand()%16]); RGB_SetMore_Color(56,rand()%8+56,table[rand()%16]); RGB_Flush(); //刷新WS2812B的显示 } RGB.h #ifndef __RGB_H__ #define __RGB_H__ #include "main.h" //0码和1码的定义,设置的时CCR寄存器的值 //由于使用的思PWM输出模式1,计数值 #define CODE_1 (84) //1码定时器计数次数,控制占空比为84/125 = 66% #define CODE_0 (42) //0码定时器计数次数,控制占空比为42/125 = 33% //单个LED的颜色控制结构体 typedef struct { uint8_t R; uint8_t G; uint8_t B; }RGB_Color_TypeDef; #define Pixel_NUM 64 //LED数量宏定义,我们灯板上有64个, static void Reset_Load(void); //该函数用于将数组最后24个数据变为0,代表RESET_code //发送最终数组 static void RGB_SendArray(void); static void RGB_Flush(void); //刷新RGB显示 void RGB_SetOne_Color(uint8_t LedId,RGB_Color_TypeDef Color);//给一个LED装载24个颜色数据码(0码和1码) //void RGB_RED(uint16_t Pixel_Len); //显示红灯 //控制多个LED显示相同的颜色 void RGB_SetMore_Color(uint8_t head, uint8_t heal,RGB_Color_TypeDef color); void RGB_Show_64(void); //RGB写入函数 #endif main.c /* USER CODE END Header */ /* Includes ------------------------------------------------------------------*/ #include "main.h" #include "dma.h" #include "tim.h" #include "gpio.h" /* Private includes ----------------------------------------------------------*/ /* USER CODE BEGIN Includes */ #include "RGB.h" //包含RGB.h头文件 /* USER CODE END Includes */ /* Private typedef -----------------------------------------------------------*/ /* USER CODE BEGIN PTD */ /* USER CODE END PTD */ /* Private define ------------------------------------------------------------*/ /* USER CODE BEGIN PD */ /* USER CODE END PD */ /* Private macro -------------------------------------------------------------*/ /* USER CODE BEGIN PM */ /* USER CODE END PM */ /* Private variables ---------------------------------------------------------*/ /* USER CODE BEGIN PV */ /* USER CODE END PV */ /* Private function prototypes -----------------------------------------------*/ void SystemClock_Config(void); /* USER CODE BEGIN PFP */ /* USER CODE END PFP */ /* Private user code ---------------------------------------------------------*/ /* USER CODE BEGIN 0 */ /* USER CODE END 0 */ /** * @brief The application entry point. * @retval int */ int main(void) { /* USER CODE BEGIN 1 */ /* USER CODE END 1 */ /* MCU Configuration--------------------------------------------------------*/ /* Reset of all peripherals, Initializes the Flash interface and the Systick. */ HAL_Init(); /* USER CODE BEGIN Init */ /* USER CODE END Init */ /* Configure the system clock */ SystemClock_Config(); /* USER CODE BEGIN SysInit */ /* USER CODE END SysInit */ /* Initialize all configured peripherals */ MX_GPIO_Init(); MX_DMA_Init(); MX_TIM1_Init(); /* USER CODE BEGIN 2 */ /* USER CODE END 2 */ /* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { RGB_Show_64(); //调用RGB灯板显示函数 HAL_Delay(200); //延时200ms, /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */ } 以上就是本期的所有内容。