基于STM32F103C8T6驱动WS2812彩灯模块点亮RGB灯

于 2025-05-05 10:02:09 发布
阅读量966 收藏 15
点赞数 18
分类专栏： 电子模块测试 STM32专栏 文章标签： stm32 单片机 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42250136/article/details/147616441
版权

文章目录

一、WS2812模块简介

  WS2812是一个集控制电路与发光电路于一体的智能外控LED光源。其外型与一个5050LED灯珠相同，每个元件即为一个像素点。像素点内部包含了智能数字接口数据锁存信号整形放大驱动电路，还包含有高精度的内部振荡器和12V高压可编程定电流控制部分，有效保证了像素点光的颜色高度一致。
  数据协议采用单线归零码的通讯方式，像素点在上电复位以后，DIN端接受从控制器传输过来的数据，首先送过来的24bit数据被第一个像素点提取后，送到像素点内部的数据锁存器，剩余的数据经过内部整形处理电路整形放大后通过DO端口开始转发输出给下一个级联的像素点，每经过一个像素点的传输，信号减少24bit。像素点采用自动整形转发技术，使得该像素点的级联个数不受信号传送的限制，仅仅受限信号传输速度要求。
  LED具有低电压驱动，环保节能，亮度高，散射角度大，一致性好，超低功率，超长寿命等优点。将控制电路集成于LED上面，电路变得更加简单，体积小，安装更加简便。

二、主要特点与LED特性参数

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

三、模块引脚定义

VCC输入电压正极
GND输入电压负极
DI数据输入
DO数据输出，与下一联级的DI连接

四、工作原理与数据协议

工作原理

  1. 高度集成的像素级控制
    WS2812 本质上是将一个小型控制器和 3 颗小功率 LED 集成在一起的智能光源​。其封装内包含：
  • 精密振荡器：提供约 800 kHz 的时钟参考，确保协议时序稳定；​
  • 数字移位寄存器：按顺序接收并锁存 24 bit 的颜色数据；​
  • 信号重塑单元：对接收到的微弱信号进行再生放大，保证后级级联时信号不失真；​
  • 恒流驱动模块：为 R、G、B 三色 LED 提供精确的驱动电流，保证色彩一致性；​
  1. 信号重塑与级联能力
      当第一颗 WS2812 接收到完整的 24 bit 数据并将其锁存后，余下的数据（即除自身所用的 24 bit 外）会被 信号重塑电路 放大并输出到 DOUT，引入下一级的 DIN 端​。这一机制使得即使在长链（理论上可达数千点）中，每一级仍能收到清晰、符合时序的波形，无需额外的中继或放大器。

数据协议

  1. 单线编码
      WS2812 只需一根数据线即可传输所有信息，协议利用“高电平时长”区分 0/1：
      ‘0’ 码：高电平约 0.35 µs（±150 ns），低电平约 0.8 µs，总周期 ≈ 1.25 µs；​
      ‘1’ 码：高电平约 0.7 µs，低电平约 0.6 µs，总周期 ≈ 1.25 µs；​
      这种编码在高电平和低电平上都不归零于同一电平，不仅简化了硬件设计，还提升了抗抖动能力。

  2. 24 Bit 数据格式
    每个像素点需要 24 bit，按 G7…G0 → R7…R0 → B7…B0 的顺序依次发送​。例如，要显示纯绿（255，0，0），主控会发送：11111111 00000000 00000000；其中 11111111 对应十进制 255 的绿色通道，高位先发。
  3. 复位与数据锁存
      在一连串 24 bit 数据发送完毕后，必须将数据线拉低 > 50 µs，WS2812 内部的移位寄存器才会被复位并将新接收的数据输出到 LED 驱动单元，否则会出现刷新失败​。
  4. 总线级联
      WS2812 拥有内置信号整形功能，能将余下的数据完整透传至下一级，无需中断或额外控制。这使得在同一根数据线下，可以串联数十、乃至上千颗 WS2812，主控只需一次完整的数据发送即可更新整条链​。

通过上述工作原理与协议解读，在有多个led级联的情况下，先发送第一个led的数据，后第二个、第三个、以此类推。

五、STM32F103C8T6驱动示例

1.引脚接线

STM32F103C8T6WS2812
5V5V，注意：如果多个级联要外接电源，不要用单片机的5V
GNDGND
PA0DI
  1. 代码示例
    WS2812.c
#include "ws2812.h"

void WS2812_Init(void) {
	GPIO_InitTypeDef GPIO_InitStructure;
	TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure;
	TIM_OCInitTypeDef TIM_OCInitStructure;
	DMA_InitTypeDef DMA_InitStructure;
	
    //使能 TIM2、DMA1 和 GPIOA 时钟
    RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE);   // TIM2 定时器时钟
    RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE);     // DMA1 总线时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);  // GPIOA 时钟
	
	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;		
	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
	GPIO_Init(GPIOA, &GPIO_InitStructure);

    TIM_InternalClockConfig(TIM2);
	
	TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;
	TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;
	TIM_TimeBaseInitStructure.TIM_Period = 90 - 1;		//ARR
	TIM_TimeBaseInitStructure.TIM_Prescaler = 1 - 1;		//PSC
	TIM_TimeBaseInitStructure.TIM_RepetitionCounter = 0;
	TIM_TimeBaseInit(TIM2, &TIM_TimeBaseInitStructure);
	
	TIM_OCStructInit(&TIM_OCInitStructure);
	TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;
	TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;
	TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;
	TIM_OCInitStructure.TIM_Pulse = 0;		//CCR
	TIM_OC1Init(TIM2, &TIM_OCInitStructure);
	
	DMA_DeInit(DMA1_Channel2);
	DMA_InitStructure.DMA_PeripheralBaseAddr = (uint32_t)&TIM2->CCR1;
	DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_HalfWord;
	DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable;
	DMA_InitStructure.DMA_MemoryBaseAddr = (uint32_t)My_ws_buf;
	DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_HalfWord;
	DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable;
	DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralDST;
	DMA_InitStructure.DMA_BufferSize = 0;
	DMA_InitStructure.DMA_Mode = DMA_Mode_Normal;
	DMA_InitStructure.DMA_M2M = DMA_M2M_Disable;
	DMA_InitStructure.DMA_Priority = DMA_Priority_High;
	DMA_Init(DMA1_Channel2, &DMA_InitStructure);
	
	TIM_DMACmd(TIM2, TIM_DMA_Update, ENABLE);
}

/**
 * @brief  设置单颗 WS2812B 灯的 RGB 颜色（十进制 0–255）
 * @param  r 红色分量，0 表示关闭，255 表示最大亮度
 * @param  g 绿色分量，0 表示关闭，255 表示最大亮度
 * @param  b 蓝色分量，0 表示关闭，255 表示最大亮度
 */
void WS2812B_SetColor(uint32_t r, uint32_t g, uint32_t b)
{
    uint16_t *p = My_ws_buf;         
    uint32_t mask, rep, bit;          
    uint32_t GRB_Data;
    
    GRB_Data = ((g & 0xFFU) << 16)
             | ((r & 0xFFU) << 8)
             |  (b & 0xFFU);         
 
    for (rep = 0; rep < LED_REPEAT; rep++) {
        mask = 1UL << (BITS_PER_LED - 1);
        for (bit = 0; bit < BITS_PER_LED; bit++, mask >>= 1) {
            *p++ = (GRB_Data & mask) ? WS2812_HIGH : WS2812_LOW;
        }
    }
}

//发送信号
void WS2812B_Send(void)
{
    //清除 DMA 标志、重载传输长度
    DMA_ClearFlag(DMA1_FLAG_TC2);
    DMA_SetCurrDataCounter(DMA1_Channel2, LED_REPEAT * BITS_PER_LED);

    //启动 DMA & 定时器
    DMA_Cmd(DMA1_Channel2, ENABLE);
    TIM_Cmd(TIM2, ENABLE);

    //等待传输完成
    while (!DMA_GetFlagStatus(DMA1_FLAG_TC2));

    //关闭 TIM & DMA 并清标志，产生 >50μs 复位低电平
    TIM_Cmd(TIM2, DISABLE);
    DMA_Cmd(DMA1_Channel2, DISABLE);
    DMA_ClearFlag(DMA1_FLAG_TC2);
}

void ws2812_OFF(void)
{
	WS2812B_SetColor(0, 0, 0);
	WS2812B_Send();
}

main.c

#include "stm32f10x.h"                  // Device header
#include "ws2812.h"
#include "delay.h"

static const uint8_t color_list[][3] = {
    {255,    0,   0},  // 红
    {255,  125,   0},  // 橙
    {255,  255,   0},  // 黄
    {  0,  255,   0},  // 绿
    {  0,  255, 255},  // 青
    {  0,    0, 255},  // 蓝
    {255,    0, 255},  // 紫
    {  0,    0,   0}   // 关灯
};

uint16_t NUM_COLORS = sizeof(color_list) / sizeof(color_list[0]);
uint32_t idx = 0;

int main(void)
{
    WS2812_Init(); 
//	ws2812_OFF();
	
	while(1){
		uint8_t r = color_list[idx][0];
        uint8_t g = color_list[idx][1];
        uint8_t b = color_list[idx][2];
        
        WS2812B_SetColor(r, g, b);
        WS2812B_Send();
		
		Delay_ms(1000);
		idx = (idx + 1) % NUM_COLORS;
	}
}
  1. 效果展示

总结

  WS2812 是一款将控制电路、信号整形放大和恒流驱动与 RGB 发光单元集成于 5050 封装中的智能化全彩 LED 模块，仅需一根数据线即可以 800 kbps 单线协议传输精确的色彩控制信号，从而实现链式级联上千点的独立寻址与显示​。内部集成的数字移位寄存器与精密振荡器可按 GRB 顺序（G7…G0→R7…R0→B7…B0）接收并锁存 24 bit 颜色数据，随后通过恒流驱动电路根据不同位的高低电平宽度产生对应亮度，并将余下数据重塑后输出到下一颗，实现信号级联​。可广泛应用于灯带、灯环、可穿戴灯效、舞台装饰等场景​。
注意事项：

  • 严格时序控制：软件模拟易受中断或系统抖动影响，易导致亮度不稳定或色偏，推荐使用定时器+DMA、SPI 或 RMT（ESP32）等硬件外设生成 PWM 波形，以确保 T0H/T1H 与 T0L/T1L 宽度的高精度​。
  • 复位低电平：发送完 24 bit 数据后，必须将数据线保持低电平 > 50 µs，WS2812 内部才会将新数据锁存并更新输出；低于此时长可能导致刷新失败或出现残影​。
  • 链式级联能力：得益于内部信号整形，单线级联可支持 ≥ 1 024 个像素刷新（30 fps 条件下）；在更高刷新率或更长链长场景下，建议分段布线并选用多路输出或并行总线以降低时延和信号累积失真​。

以上仅为个人观点供参考，如有问题欢迎大家留言讨论，如需源码可点赞收藏加关注，在评论留下邮箱获取！！！

博客
优信电子所有博客汇总(导航搜索)
08-15 8365
本文用于汇总我们发布过的所有有关传感器、单片机、模块以及调试学习心得的文章，优信粉们可以使用 ctrl+F 搜索相关的内容以便快速寻找文章，CSDN为目前我们与用户共同分享学习进步的一个平台，更多的学习内容我们技术人员会逐步更新发布，评论区也可以提交大家需求以便我们有针对性的更新文章！...
博客
ESP32驱动MFRC522 RFID模块读写IC卡数据
05-12 1015
文章详细说明了ESP32与MFRC522的SPI接线方式，并提供了Arduino代码示例，展示了如何读取IC卡的存储数据、获取UID以及将用户数据写入指定存储块。
博客
STM32驱动ADXL345三轴加速度传感器
05-12 938
ADXL345是一款完整的3轴加速度测量系统，可选测量范围有±2 g，±4 g，±8 g或±16 g。既能测量运动或冲击导致的动态加速度，也能测量静止加速度，例如重力加速度，使得器件可作为倾斜传感器使用。该传感器可以在倾斜检测应用中测量静态重力加速度，还可以测量运动或冲击导致的动态加速度。其高分辨率(3.9mg/LSB)，能够测量不到1.0°的倾斜角度变化。
博客
ESP32 I2S音频总线学习笔记（三）：I2S音频输出
05-08 1023
前面文章我们介绍了通过I2S读取INMP441音频数据，是关于I2S协议的数据读取，本篇我们介绍关于I2S协议的数据输出，通过I2S输出数据，即通过I2S进行音频输出。对于ESP32可以有两种I2S音频输出的方式，一种是 使用外部I2S进行音频输出，另一种是 使用片上DAC进行I2S音频输出。对于这两种方式，这里结合上篇文章对WAV文件格式的介绍，分别通过I2S协议播放不同音频，一个是我们自己放进去SD卡里的WAV音频，另一个是我们上篇文章生成的1秒正弦波音频。
博客
STM32 驱动 INA226 测量电流电压功率
04-27 1383
INA226 是一款分流/功率监视器，具有 I2C或SMBUS 兼容接口。该器件 监视分流压降和总线电源电压。可编程校准值、转换时间和取平均值功能与内部乘法器相结合，可实现电流值（单位为安培）和功率值（单位为瓦）的直接读取。本文将 用stm32驱动INA226做电参数测试。
博客
STM32驱动SGP30气体传感器CO2/TVOC检测
04-23 1286
SGP30是一款具有多个传感元件的金属氧化物气体传感器，内集成4个气体传感元件，具有完全校准的空气质量输出信号。另外，SGP30能够将金属氧化物气体传感器集成到移动设备中，为智能家居、家电和物联网应用中的环境监测开辟了新的可能性。它通过I2C总线与MCU通信，可以轻松地集成到各种不同的嵌入式系统中，本文将用STM32获取SGP30的数据并且分别在串口和OLED屏幕输出。
博客
ESP8266_ESP32 Smartconfig一键配网功能
04-21 1113
SmartConfig 是由 TI 开发的配网技术，用于将新的 Wi-Fi 设备连接到 Wi-Fi 网络。它使用移动应用程序将无线网凭据从智能手机或平板电脑端广播给未配网的 Wi-Fi 设备。这目前， ESP32 支持三种类型的 SmartConfig 配网： Airkiss、ESPTouch 和 ESPTouch v2。本文将接收ESP32- SmartConfig 配网
博客
基于esp32驱动CCS811模块监测eCO2/TVOC环境空气质量
04-18 735
CCS811 是一款超低功耗数字气体传感器，集成了用于监测室内空气质量 (IAQ)（包括多种挥发性有机化合物 (VOC)）的金属氧化物 (MOX) 气体传感器、微控制器单元 (MCU)。通过 I²C 接口实时输出等效（eCO₂）及总挥发性有机物（TVOC）浓度，并在片内完成算法处理，显著简化主控系统设计与功耗管理。本文将对CCS811作详解并用ESP32开发板驱动获取数据。
博客
【ESP32|音频】一文读懂WAV音频文件格式【详解】
04-17 1157
本文主要为后面ESP32 I2S音频系列文章做铺垫，所以本篇将介绍WAV音频文件格式，并通过C代码生成一段1S的正弦波WAV音频写入到SD卡里面。
博客
ESP32驱动读取ADXL345三轴加速度传感器实时数据
04-15 695
ADXL345是一款由Analog Devices公司推出的三轴数字加速度计，分辨率高(13位)，测量范围达± 16g，可通过SPI(3线或4线)或I2C数字接口访问。
博客
JDY-24M模块基本使用说明（主从透传、MESH组网、BLE等数据传输）
04-07 1072
  JDY-24M 超级蓝牙功能支持主从透传，iBeacon，BLE 探针，iBeacon 探测，MESH 组网，MESH 组网数量最大支持 65280 设备组网，采用多跳无线防碰撞技术，组网通信速度支持 50ms发 12 字节数据，单模块支持路由节点与终端节点，路由节点支持数据中继（不支持低功耗），终端节点支持低功耗（按键唤醒发完数据后自动睡眠），JDY-24M 组网一般只需要配置好组网 NETID、MADDR 短地址后，模块将会自动组网，组网模块与 APP 通信时相当于透传，这样极大的方便用户开发 AP
博客
STM32驱动Pulsesensor传感器心率检测
04-02 899
PulseSensor是一款用于脉搏心率测量的光电反射式模拟传感器。将其佩戴于手指、耳垂等处，通过单片机将采集到的模拟信号转换为数字信号，再通过单片机简单计算后就可以得到心率数值。其适用于心率方面的科学研究和教学演示，也非常适合用于二次开发。
博客
51 驱动 INA219 电流电压功率测量
03-31 1023
INA219是一个电流分流和电源监视器与I2C或smbus兼容的接口。该设备监测分流电压降和总线电源电压，可编程转换时间和滤波。可编程的校准值与内部乘法器相结合，可直接读出以安培为单位的电流。一个附加的相乘寄存器计算功率，单位为瓦。I2C或smbus兼容接口具有16个可编程地址。用于配置传感器的量程及工作模式等等Bit字段类型默认值(二进制)描述15RSTR/W0设置成1 复位14NCR/W0无功能 保留13BRNGR/W1总线电压量程范围11 12PGR/W。
博客
ESP32通过OTA无线局域网远程升级下载程序
03-25 1240
ESP32 的 OTA 升级功能允许通过无线网络Wi-Fi远程更新设备固件程序，无需USB/UART物理连接。比如ESP32设备在机壳内部不好拆卸，人离设备比较远，不好接线的环境可用到OTA方式给ESP32设备下载程序。
博客
关于BQ25570太阳能量收集器的工作流程及实测
03-21 1084
BQ25570可以有效地提取光电（太阳能）或热电发电机(TEG)等各种高输出阻抗直流源产生的微瓦(µW)至毫瓦(mW)级的电能。集成了高效率、微功耗的降压转换器，可为系统（例如有严格功率和操作要求的无线传感器网络(WSN)）提供第二个电源轨。本篇文章将快速测试和验证BQ25570模块的功能
博客
STM32驱动DS1302时钟模块（串口和OLED显示）
03-20 1140
DS1302是涓流充电时钟芯片内含有一个实时时钟/日历和31字节静态RAM，通过简单的串行接口与单片机进行通信 实时时钟/日历电路提供秒、分、时、日、日期、月和年的信息每月的天数和闰年的天数可自动调整，它广泛应用于电话、传真、便携式仪器以及电池供电的仪器仪表等产品领域。
博客
基于Arduino驱动 SI4703 FM 收音机模块接收无线电台
03-19 1093
本文将介绍如何在 Arduino 平台上使用 SI4703 FM 收音机模块，并结合完整的驱动代码进行讲解。通过串口监视器我们可以控制模块并查看调试信息。本文内容包括模块简介、引脚定义、通讯时序、主要寄存器和驱动代码以及总结介绍，适合对 FM 收音机模块感兴趣的开发者参考。SI4703 是一款低功耗 FM 收音机芯片，支持 RDS广播数据，具有简单的 I2C 接口，主要用于便携式无线音频接收。支持全球 FM 频段 (76–108MHz)集成 VCO 的频率合成器搜索调谐自动频率控制 (AFC)
博客
ESP32驱动SPIFFS进行文件操作
03-18 1079
在这之前我们需要安装插件，并对SPIFFS文件系统的相关操作有一些了解。如果由于网络原因插件下载不了，可以评论区留言哦！
博客
基于STM32F103C8T6驱动MPU9250传感器读取九轴数据
03-10 2256
MPU9250是一款高集成度的九轴惯性测量单元（IMU），它集成了三轴陀螺仪、三轴加速度计和三轴磁力计（通常集成的磁力计为AK8963）。由于其体积小、功耗低、性能稳定，MPU9250广泛应用于无人机、机器人、智能穿戴设备、虚拟现实以及运动追踪等领域。MPU9250采用MEMS（微机电系统）技术制造，能够同时采集角速度、线性加速度和地磁场数据，从而实现九自由度测量。模块内部还集成了数字运动处理器（DMP），用于执行复杂的传感器融合算法，从而降低了主控芯片的运算负担。
博客
GM65 二维码扫描模块使用说明
02-21 1674
GM65 条码识读模块，不仅能够轻松读取各类一维条码，而且可以高速读取二维条码，对线性条形码具有非常高的扫描速率，纸质条码及显示屏上的条码都能轻松扫描；GM65 条码识读模块是在图像智能识别算法及在此基础上开发出先进的条码解码算法，可容易且准确地识读条码符号，简化条码识读产品的开发难度。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值