HonestQiao · 2022年11月25日 · 天津市

【GD32F427开发板试用】点亮WS2812B炫彩灯环

我有一个WS2812B炫彩灯环,搭配精选的背景,非常出镜:
image.png

在玩过的板子上,我都要把它点亮。

关于WS2812B的介绍资料,网上有很多,这里就不细说了,只说重点:

  1. WS2812B是单总线控制的:
    image.png
    image.png

控制一颗WS2812B与控制多颗WS2812B,方式是一样的,不同的只是每批传送的数据的多少。
我上面的这个灯环,就是24颗串联在一起,第一颗的DIN负责接收控信号,然后每一颗的DOUT,接下一颗的DIN,将控制信号传递过去,直到最后一颗。这种方式,可以连接上千颗一起控制。
需要注意的是,最后一颗的DOUT是留空的。所以上面这个炫彩灯环,首尾是不相连的。

  1. WS2812B控制一颗灯珠,需要24bits的数据,代表着GRB三种颜色值:
    image.png

控制多颗,则使用多组连续的24bits数据:
image.png
每颗WS2812B截取数据中最开始的24bits,然后把剩下的传递给后来者,直到数据发送完毕。

  1. 控制设备,不能直接发送这些bit位的信号,而是要按照一定的规则发送信号,才被检测为对应的bit位:
    image.png
    WS2812B规定了三种信号:0码、1码、reset码,这三种码,通过信号线上的高低电平的特定保持时间来做区分,具体如下:
    image.png
    也就是:
  • 1个码的信号时间长度位1.25us
  • 如果高电平保持0.4us,低电平保持0.85us,则判定为T0码
  • 如果高电平保持0.8us,低电平保持0.45us,则判定为T1码
  • 如果低电平持续至少50us,则判定位RESET码;例如传递第二批控制信号时,需要使用该码

上述数据,如图表所示,都有一定的容错范围,经过以往的测验经验,最终使用如下的值:

  • T0:高0.25us,低1.00us
  • T1:高1.00us,低0.25us
  • RESET:低50us

要实现0.25us的时间控制精度,那么换算成频率位:1/(0.25/1000000) = 4M。也就是控制设备,需要以4Mbits/s这么快的速度,来控制信号的变化,才能满足WS2812B控制信号的要求。

要满足上述的要求,可以有很多种方法。常用的有GPIO翻转,使用SPI的MOSI发送数据等。
有人可能有疑问,UART、I2C发送数据,也能带来信号线的高低电平变化,哪能使用吗?
UART的传送速度,通常波特率最高位1.5Mbits/s;I2C通信,超高速的能达到5M,但一般都达不到,通常可能为400kbits/s,快的位3.4Mbits/s。
而SPI,通常速度都能达到50Mbits/s。
但使用GPIO翻转来控制信号,并非所有的的设备都能达到,有的翻转的速率没有这么快。
经过实测,咱们的GD32F427开发板完全可以满足。所以,这篇分享,就直接使用GPIO翻转这种简单的方式来做了。
在实际使用中,有很多大佬,也研究了各种各样优化的方法,大家感兴趣的话,可以查找资料了解一下。

通过查看原理图和数据手册,可以使用PC1来进行控制,该引脚一般情况下没有直接复用:
image.png

具体接线如下:
image.png
因为我只打算一次点亮一颗灯珠,所以供电部分,直接使用板载的3.3V、GND即可。
如果需要点亮多颗灯珠,那么应该使用外部电源供电。点亮一颗灯珠的一种颜色,需要20mA电流,三种颜色都点亮,则需要60mA电流,24颗全部点亮,则需要1440mA电流。一般开发板的GPIO,是供不起的全部点亮的。

在前一篇文章Systick系统定时器的使用 种,探讨了SysTick的基础使用,可以达到us级别的精确控制。不过亚us级别的控制,就会有一些吃力了。
在MCU的精确时间控制中,还有一种使用nop指令来进行控制的。所谓nop,就是一条空指令,一个最小的机器周期。通过一定数量的nop,从而实现亚us级别的控时。

GD32F427开发板的运行频率高低200MHz,经过实测,每200个nop,刚好经过1us,也就是每个nop为0.005us。那么要达到0.25us的控时,就需要50个nop。

在system_gd32f4xx.c中,有系统时钟的定义:
image.png

在 core_cmInstr.h 中,有关于nop的符号定义:
image.png

那么我们要定义0.25us,可以参考使用如下的方式:

#define NOP                                         \
    {                                               \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
    }

当然,也可以通过nop辅助多重循环,用更为简介的代码来实现。这里就先用直接nop的方式,更简洁明了。

前面要求的两个时间分别为0.25us,1.00us,就分别为1个NOP和4个NOP。

经过以上的准备工作,就可以编写实际的控制代码了,具体代码如下:

/*!
    \file    main.c
    \brief   GPIO running WS2812B demo

    \version 2022-11-24, V1.0.0, demo for GD32F4xx
*/


#include "gd32f4xx.h"
#include "gd32f427v_start.h"
#include "systick.h"
#include <stdio.h>

#define NOP                                         \
    {                                               \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
        __NOP();__NOP();__NOP();__NOP();__NOP();    \
    }
    
void GPIO_Init(void)
{
    rcu_periph_clock_enable(RCU_GPIOC);                                                //使能外部时钟

    gpio_mode_set(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_PIN_1);                //配置端口模式
    gpio_output_options_set(GPIOC, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_1);    //输出选项配置
    gpio_bit_reset(GPIOC, GPIO_PIN_1);                                                //PC1复位

}

#define LOW 0
#define HIGH 1
#define DIN PC1
#define NUM 24

//拉低DIN保持50us以上
void ws2812_init() {
  unsigned char i;
  gpio_bit_reset(GPIOC, GPIO_PIN_1);
  for (i = 0; i <= 200; i++) {
    NOP;
  }
}

//高电平0.25us,低电平1us
void ws2812_write_0() {
  gpio_bit_set(GPIOC, GPIO_PIN_1);
  NOP;
  gpio_bit_reset(GPIOC, GPIO_PIN_1);
  NOP;
  NOP;
  NOP;
  NOP;
}

//高电平1us,低电0.25us
void ws2812_write_1() {
  gpio_bit_set(GPIOC, GPIO_PIN_1);
  NOP;
  NOP;
  NOP;
  NOP;
  gpio_bit_reset(GPIOC, GPIO_PIN_1);
  NOP;
}


// 写入24bits
void ws2812_write_24bits(unsigned long dat) {
  unsigned char t[NUM] = {0};
  unsigned char i;

  for (i = 0; i < NUM; i++) {
    if (dat >> i & 1) {
      t[i] = HIGH;
    } else {
      t[i] = LOW;
    }
  }

  for (i = 0; i < NUM; i++) {
    if (t[i]) {
      ws2812_write_1();
    } else {
      ws2812_write_0();
    }
  }
}


void ws2812_test() {
  unsigned int i = 0;
  unsigned int j = 0;
  unsigned int index = 1;
  unsigned long colors[8] = {0x000000, 0xff0000, 0x00ff00, 0x0000ff,
                             0xffff00, 0xff00ff, 0x00ffff, 0xffffff};

  ws2812_init();

  while (1) {
    for (i = 0; i < NUM; i++) {
      if (index % NUM == i) {
        ws2812_write_24bits(colors[index % 7 + 1]);
      } else {
        ws2812_write_24bits(colors[0]);
      }
    }
    index++;
    if (index >= NUM) {
      index = 0;
    }
    // 延时0.1秒
    for (i = 0; i <= 200*50*100; i++) {
      NOP;
    }
  }
}

int main(void)
{
    systick_config();    //配置系统时钟
    GPIO_Init();
    
    ws2812_test();
}

上述代码中,关键调用说明如下:

  • gpio_bit_set(GPIOC, GPIO_PIN_1):设置高电平
  • gpio_bit_reset(GPIOC, GPIO_PIN_1):重置为低电平
  • ws2812_init():重置WS2812B控制,拉低,保持50us
  • ws2812_write_0():输出T0码,高0.25us,低0.25us
  • ws2812_write_1():输出T1码,高1.00us,低0.25us
  • ws2812_write_24bits():批量生成和输出T0、T1
  • ws2812_test():使用index自增,表示当前需要点亮的灯珠,一次发送24组数据,每组24bits,且使用colors预定义8种颜色,colors[0]实际上表示熄灭。

编译以上代码,然后下载到开发板中,就可以看到炫彩的灯光,在灯环上欢快的跳跃了:
GD32_灯环效果.GIF

推荐阅读
关注数
10707
内容数
187
中国高性能通用微控制器领域的领跑者兆易创新GD系列芯片技术专栏。
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息