WS2812B：5050 封装，RGB‑LED + 驱动 IC 集成；5V 供电，单线 800Kbps 归零码，数据顺序 GRB。

https://www.bilibili.com/video/BV1c9fhY5EPk

一、引脚定义（单颗 WS2812B）

表格

引脚	符号	功能
1	VDD	电源 +5V
2	DOUT	数据输出（级联下一颗 DIN）
3	VSS	GND 地
4	DIN	数据输入

灯条实物丝印箭头 = 数据流向：DIN → DOUT，不能反向接。

二、单线通信协议（800kHz NRZ 归零码）

1. 每一颗像素：24bit = G(8bit) + R(8bit) + B(8bit)，⚠️不是 RGB，是GRB，颜色错乱首要原因。
2. 位时序（典型）

   表格

   bit	T_H 高电平	T_L 低电平	周期
   Bit‑0	0.35 μs	0.80 μs	1.25 μs
   Bit‑1	0.70 μs	0.60 μs	1.25 μs

3. RESET 复位锁存：全部像素数据发送完毕后，拉低 DIN ≥50μs；复位到来，整串锁存显示，准备下一帧接收。
4. 数据流：MCU → DIN；第 1 颗取走 24bit，剩下数据从 DOUT 转发给第 2 颗，流水线向后传递。N 颗灯，需要发送 N×24 bit。

三、硬件原理图说明

1）单颗 WS2812B 最简原理图

plaintext

5V ────┬── VDD(WS2812B)
       │
      C=0.1μF(104)
       │
GND ───┴── VSS(WS2812B)

MCU_GPIO → R=330‑470Ω → DIN
DOUT → 下一级DIN

• C=0.1μF：每颗灯就近电源去耦，抑制大电流跳变噪声CSDN博...。
• R=330‑470Ω：串联在 DIN 靠近灯端，抑制信号反射，减少乱码。

2）多颗级联（WS2812B 灯条内部原理）

plaintext

MCU GPIO → 470Ω → D1.DIN
D1.DOUT → D2.DIN
D2.DOUT → D3.DIN
……
所有D1‑Dn的VDD全部并联接5V；VSS全部并联接GND。
每颗VDD‑VSS就近并0.1μF电容。

商品 WS2812B 柔性 RGB 灯条就是 PCB 上大量灯珠按此级联；对外引出 3 根线：5V、GND、DIN，部分带 DOUT 输出座用于再接下一段灯条。

3）完整系统原理图（MCU 3.3V → WS2812B 5V 灯条）

重点：STM32/ESP32 是 3.3V IO，WS2812B 供电 5V 时逻辑高电平阈值≈3.5V；3.3V 直接驱动长灯条容易随机花屏。

方案 A：短距离（≤20 灯）简易接法（工程凑合）

plaintext

3.3V‑GPIO → 470Ω → WS2812B‑DIN
MCU‑GND 必须与灯条GND直接相连（共地！）
灯条VDD接外部5V电源，不要从MCU开发板5V取电（大电流烧毁板载LDO）
电源输入端并联 1000μF电解电容防上电冲击。

方案 B：长距离 / 大量灯珠，正规电平转换（推荐）

3.3V 信号 →电平转换（74HCT245 / TXS0102）→输出 5V 逻辑电平 →470Ω →DINCSDN博...

plaintext

MCU(3.3V域)
GPIO →74HCT245(A1)
74HCT245 VCCA=3.3V, VCCB=5V, GND共地
74HCT245(B1) →470Ω → WS2812B DIN

灯条电源：独立5V大功率电源，1000μF输入端滤波。
所有GND全部连在一起。

4）长灯条补电原理图（压降问题）

灯条越长，铜箔压降越大，尾部变暗偏色。

大于 30‑50 颗灯，建议两端供电：灯条首端 5V/GND；灯条末端再接入一组 5V/GND，数据线只接首端 DIN，GND 必须连通。

四、WS2812B 数字 RGB 灯条 vs 普通模拟 RGB 灯条对比

表格

项目	WS2812B 数字 RGB 灯条	普通模拟 RGB 灯条 (共阳 / 共阴)
控制线	1 根 DATA	R/G/B 3 路 PWM
单点控制	每颗灯独立颜色	整条统一颜色，无法单点控色
供电	5V	常见 12V
协议	单线归零码 800Kbps	无协议，纯 PWM 占空比
功耗	每颗最大～60mA	由外部 MOS 决定

五、高频硬件踩坑清单

1. 不共 GND：最常见，现象灯完全乱闪。MCU、灯条电源必须共地。
2. 颜色红绿颠倒：代码数据顺序写为 RGB，硬件协议是GRB。
3. 3.3V IO 直接驱动长灯带：偶尔乱码，加电平转换。
4. 电源功率不足：全白每颗 60mA；60 珠 / 米，一米最大 3.6A，必须外置电源，不要单片机板供电。
5. RESET 时间太短：复位低电平小于 50μs，灯不刷新。
6. DOUT/DIN 接反，顺着箭头方向接。
7. 缺少输入端大电解，缺少每颗灯 0.1μF 去耦，上电瞬间烧毁灯珠。