STM32+PWM+DMA驱动WS2812 —— 2024年9月24日

一、项目简介

        采用STM32f103C8t6单片机,使用HAL库编写。项目中针对初学者驱动WS2812时会遇到的一些问题,给出了解决方案。

二、ws2812驱动原理

        WS2812采用单线归零码的通讯方式,即利用高低电平的持续时间来确定0和1。这种通信方式优点是只需要一根通信线,缺点是对通信的时序要求较高。

        以官方数据手册的时序图为例,通信速率为800kbit/s,也就是PWM波的速率为800Kbit/s,每个PWM的周期为1.25微妙。PWM的一个周期即为一个数据帧,每个数据帧由一段高电平和一段低电平组成。下图为官方规定的数据传输时间:

T0H 0码,高电平时间 0.22 us~0.35 us
T0L 0码,低电平时间 0.58 us~1.0 us
T1H 1码,高电平时间 0.58 us~1.0 us
T1L 1码,低电平时间 0.22 us~0.42 us
RES 帧间隔,低电平时间 50us以上

        也就是说:一个1码,由2/3左右的高电平 和 1/3左右的低电平组成。

                           一个0码,由1/3左右的高电平 和 2/3左右的低电平组成。

        若定时器的时钟频率为72MHz,那么预分频值设置为0,比较值设置为89,这样产生的PWM波的频率就为800KHz,周期为1.25us。要发送1码时,设置占空比为60。要发送0码时,设置占空比为29。

        每个WS2812需要用24bit的数据来控制,当n个ws2812进行级联的时候,第一个灯会将第一个24bit的数据拦截,将后面的数据进行转发。第二个灯又会拦截第二个24bit的数据,将后面的数据进行转发。后面的逻辑也是一样,数据每经过一个灯,数据的前24bit就会被拦截下来,作为这个灯的显示内容。数据传输方法如下图所示:

        代码编写逻辑:初始化的时候,需生成一个显存数组,由DMA将数组中的内容实时搬运到定时器的比较寄存器中,DMA要开启循环模式。之后我们只需要更新显存数组中的数据,WS2812的显示内容就会被实时更新。

三、Cube MX 生成底层代码

1、配置Debug的模式

2、配置外部晶振

3、配置时钟

4、配置定时器

5、配置定时器的DMA

6、生成代码

四、代码编写

1、下面ws2812.c的代码

#include "ws2812.h"

//显存数组,长度为 灯的数量*24+复位周期
uint16_t WS2812_RGB_Buff[LED_NUM*DATA_LEN+WS2812_RST_NUM] = {0}; 

/**
 * 函数:WS2812单灯设置函数
 * 参数:num:灯的位置,R、G、B分别为三个颜色通道的亮度,最大值为255
 * 作用:单独设置每一个WS2812的颜色
***/
void WS2812_Set(uint16_t num,uint8_t R,uint8_t G,uint8_t B)
{
  uint32_t indexx=(num*(3*8));
  for (uint8_t i = 0;i < 8;i++)
  {
	//填充数组
	WS2812_RGB_Buff[indexx+i]      = (G << i) & (0x80)?WS_H:WS_L;
	WS2812_RGB_Buff[indexx+i + 8]  = (R << i) & (0x80)?WS_H:WS_L;
	WS2812_RGB_Buff[indexx+i + 16] = (B << i) & (0x80)?WS_H:WS_L;
  }
}

//WS2812初始化函数
void WS2812_Init()
{
	//设置关闭所有灯
  for(int i=0;i<8;i++)
  {
	WS2812_Set(i,0,20,0);
  }
  //作用:调用DMA将显存中的内容实时搬运至定时器的比较寄存器
  HAL_TIM_PWM_Start_DMA(&htim2,TIM_CHANNEL_1,(uint32_t *)WS2812_RGB_Buff,sizeof(WS2812_RGB_Buff)/sizeof(uint16_t)); 
}

 2、下面为ws2812.h的代码

#include "main.h"
#include "tim.h"

#define WS_H           60   // 1 码相对计数值
#define WS_L           29   // 0 码相对计数值
#define WS_REST        40   // 复位信号脉冲数量
#define LED_NUM         8   // WS2812灯个数
#define DATA_LEN       24   // WS2812数据长度,单个需要24个字节
#define WS2812_RST_NUM 50   // 官方复位时间为50us(40个周期),保险起见使用50个周期

void WS2812_Init(void);
void WS2812_Set(uint16_t num,uint8_t R,uint8_t G,uint8_t B);

3.下面为main.c中调用的代码,效果为流水灯
 

/**
  * @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_TIM2_Init();
  /* USER CODE BEGIN 2 */
  WS2812_Init();
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
	//效果一,流水灯
	for(int i=0;i<8;i++)
	{
		HAL_Delay(100);
		WS2812_Set(i,2*(i+1),4*(i+1),10*(i+1));
	}
	HAL_Delay(300);
	for(int i=0;i<8;i++)
	{
		WS2812_Set(i,0,0,0);
	}
	HAL_Delay(100);

	//效果二,跑马灯
//	for(int i=0;i<8;i++)
//	{
//		HAL_Delay(100);
//		WS2812_Set(i,0,20,0);
//		if(i==0) WS2812_Set(7,0,0,0);
//		else     WS2812_Set(i-1,0,0,0);	
//	}
		
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

五、烧录效果

六、注意事项

1、DMA的搬运方向为 内存(Memory) 到 外设(Peripheral)

2、DMA的模式为循环模式

3、DMA设置内存地址自增

七、其他问题请留言

上一篇:论文阅读 - SWATTING Spambots: Real-time Detection of Malicious Bots on X


下一篇:【计算机网络最全知识点问答】第二章 物理层