RGB LED · WS2812B / SK6812

5V RGB 5050 幻彩灯通用说明

适用于 5V WS2812B、SK6812、5050 RGB 灯带、灯板、圆环、矩阵屏等产品的通用接线、供电、安全和 Arduino 测试说明。

查看接线下载代码技术支持

Quick Facts

  • 电压：只能接 5V DC
  • 信号：DIN 输入，DOUT 串接输出
  • 供电：大数量灯珠必须独立供电
  • 提醒：GND 必须共地
WS2812 RGB LED 内置全彩驱动彩灯通用资料SKU：1013708732888、1013713320521 均待确认是否作为正式 SKU。
淘宝链接 1淘宝链接 2

Overview

适用范围

本页用于灯带、灯板、圆环、多位灯板、8x8/16x16/8x32 矩阵屏等 5V 内置驱动 RGB 灯珠产品。具体灯珠数量、颜色顺序、接口线序和是否带控制器仍以所选规格实物为准。

三根主线

5V、GND、DIN 是最基本接线；DOUT 用于串接下一块灯板。

大电流

单颗全白满亮约 60mA，256 颗理论最大约 15.36A。

低亮度先测

首次测试建议亮度 30%~50%，确认供电和方向后再提高亮度。

Wiring

通用接线图

5V RGB 5050 WS2812 幻彩灯通用接线图
灯板接口连接说明
5V / VCC外部 5V 电源 +不能接 12V/24V
GND电源 - 与控制器 GND必须共地
DIN / DI控制器 DATA建议串 330Ω~470Ω
DOUT / DO下一块 DIN按箭头方向串接

Power

供电电流估算

灯珠数量理论最大电流建议电源
16 颗0.96A5V 2A
64 颗3.84A5V 5A
100 颗6A5V 8A~10A
256 颗15.36A5V 20A，多点供电

Arduino Code

FastLED 测试代码

默认 D6、256 颗、亮度 80、GRB、WS2812B。不同灯板需要改 NUM_LEDS、COLOR_ORDER 和数据脚。

⚠ 用 ESP32（非S2/S3/C3）测试时，数据脚不能用默认的GPIO6

代码里默认的LED_PIN 6是按普通Arduino(Uno/Nano)写的。普通ESP32的GPIO6~11被内部Flash芯片占用，不能当数据脚用，接了大概率点不亮甚至死机。用ESP32测试时把LED_PIN改成板子上空闲的GPIO——比如用本站ESP32 2.8寸黄屏(CYD)测试，用CN1排针的IO27这个口（跟站内其它CN1项目同一个引脚）。ESP32-S2/S3/C3没有这个限制，GPIO6可以正常用。

下载 Arduino .ino
#include <FastLED.h>

#define LED_PIN      6
#define NUM_LEDS     256
#define BRIGHTNESS   80
#define LED_TYPE     WS2812B
#define COLOR_ORDER  GRB

CRGB leds[NUM_LEDS];

void setup() {
  delay(1000);
  FastLED.addLeds<LED_TYPE, LED_PIN, COLOR_ORDER>(leds, NUM_LEDS);
  FastLED.setBrightness(BRIGHTNESS);
  FastLED.clear(true);
}

void loop() {
  static uint8_t hue = 0;
  fill_rainbow(leds, NUM_LEDS, hue, 7);
  FastLED.show();
  hue++;
  delay(20);
}

FAQ

常见问题

不亮

检查电源是否 5V、正负极、GND 是否共地、DATA 是否接 DIN，程序中的灯珠数量是否正确。

只亮第一个

常见是 DIN/DOUT 接反、数据线接触不良、程序数量错误或后续灯珠线路异常。

颜色乱

先改颜色顺序 GRB/RGB/BRG 测试，再检查供电不足、线太长和是否共地。

闪烁

换更大电流 5V 电源，DATA 串 330Ω~470Ω，电源端并 470µF~1000µF 电容，大灯板多点供电。

20A 电源会不会烧灯？

不会。20A 是电源最大供电能力，不是强行输出。只要电压是 5V、正负极接对，灯板按实际亮度取电。

Support

需要技术支持时，把这几项一起发来

复制下面这段填一下发给客服，我们一次就能定位，不用来回问。

【5V RGB 5050 幻彩灯通用说明 技术支持】
主控型号：            （如 Arduino UNO / ESP32 / STM32）
供电接的是：          □ 3.3V   □ 5V
用的是哪份代码：      □ 本页示例   □ 其他（请说明）
接线照片：            （请附一张能看清接线的照片）

Files

资料文件说明

下载 Word 说明书查看 PNG 接线图下载 Arduino 测试代码查看多规格示例图查看灯环灯板示例图
文件用途
5V_RGB_5050幻彩灯通用使用说明书_含Arduino测试代码.docxWord 版完整说明书，可用于打印、发客户、内部归档
5V_RGB_5050幻彩灯_通用接线图.png通用接线图，可用于客服回复
RGB_5050_WS2812_Arduino_Test.inoArduino FastLED 测试代码
产品示例_多规格幻彩灯.png / 产品示例_灯环灯板.png产品形态示例，具体规格仍以所选 SKU 为准