1-wire单总线 LED 驱动技术
样式未加载。 请确认 assets/ 目录完整且与本页在同一目录层级;或改用本地 HTTP 服务打开。
01 / Fundamentals 口径 · WS2811 V2.1

协议原理:一根线上怎么分清 0 和 1

单线归零码(RZ)不用时钟线,靠「高电平持续多久」区分位值:高电平窄的是 0、宽的是 1,两者幅度完全一样,只有宽度不同,每 bit 末尾必回低电平,故称归零码。

本节所有时序窗口、字节顺序、级联上限与电阻取值,均取自《WS2811 规格书 V2.1》。同类归零码器件(WS2812B、SK6812 等)共用这套骨架,但高电平窗口、RES 下限与通道顺序并不一致,套用前须核对各自规格书。

Timing

一位怎么表示

全部信息压在时间轴上:T0H 与 T1H 的窗口不重叠,接收端量一下高电平多宽就知道是 0 还是 1。低电平由整位宽度减去高电平得到,不需要单独控制,但它同样有 580 ns ~ 1 µs 的规格窗口——6 MHz 映射下 0 码的 T0L 贴着上限、1 码的 T1L 贴着下限,这也是「时序实测」页要逐条核对的原因。

归零码时序波形图:0 码 T0H/T0L、1 码 T1H/T1L、RESET 码 Treset
归零码波形:0 码 / 1 码幅度相同,仅高电平宽度不同;帧间靠 ≥ 280 µs 低电平分隔
《WS2811 规格书 V2.1》第 3 页「数据传输时间」。
参数含义规格范围
T0H0 码,高电平时间220 ~ 380 ns
T1H1 码,高电平时间580 ns ~ 1 µs
T0L0 码,低电平时间580 ns ~ 1 µs
T1L1 码,低电平时间580 ns ~ 1 µs
RES帧间隔,低电平时间≥ 280 µs
帧结构 每颗芯片取 24 bit、高位先发,顺序为 R7..R0 → G7..G0 → B7..B0; 剩余数据经内部整形后由 DO 转发给下一级,每过一级减少 24 bit;DIN 拉低 ≥ 280 µs 后,所有芯片同步锁存刷新。 RESET 之前输出不变,这是最容易被忽略的一条。
Frame

一帧怎么排:三个字节各管一个颜色

每颗 WS2811 取走 24 bit,按 R→G→B、高位先发。每个通道 8 bit 对应 256 级灰度,由芯片内部 PWM(扫描频率不低于 400 Hz)转成 OUTR / OUTG / OUTB 的占空比。

依据:规格书第 4 页「注:高位先发,按照 RGB 的顺序发送数据」。
字节位控制输出取值说明
第 1 字节R7…R0OUTR(红)0x00~0xFF8 bit = 256 级灰度,高位先发
第 2 字节G7…G0OUTG(绿)0x00~0xFF同上
第 3 字节B7…B0OUTB(蓝)0x00~0xFF同上
举例 #FF8000(橙)→ R / G / B = 0xFF / 0x80 / 0x00, 线上依次发出 11111111 10000000 00000000。 注意它是逐位串行的:24 个 bit 之间没有任何间隔或分隔符,靠帧尾的 RESET 才知道一帧结束。
换料号要改顺序 WS2811 是 RGB 顺序;常见的 WS2812B 是 GRB。两者时序与外形相近,但字节顺序不同,不改发送顺序会红绿对调。
Encoding

编码怎么落到 SPI:0xC0 和 0xF8 从哪来

归零码没有时钟线,普通 SPI 却自带时钟——把 SPI 时钟调到 6 MHz,让 1 个灯带 bit 恰好占 8 个 SPI bit,那么「高电平占几个 SPI bit」就等于「T*H 有多宽」。

位宽换算6 MHz SPI
/* 1 个灯带 bit = 8 个 SPI bit = 1.3336 µs */
6 MHz → 1 SPI bit = 166.7 ns

0 码  0xC0 = 1100 0000 → T0H = 2 × 166.7 = 333 ns
1 码  0xF8 = 1111 1000 → T1H = 5 × 166.7 = 834 ns
判据 两个高电平值都落在窗口内(T0H 220~380 ns、T1H 580 ns~1 µs)。低电平自动成为整 1.3336 µs 的余量,不单独控制—— 但余量本身也有 580 ns ~ 1 µs 的窗口:0xC0 的 T0L ≈ 1 µs 贴着上限,0xF8 的 T1L ≈ 500 ns 低于下限。这两条边要靠实测确认,见「时序实测」。
位 → SPI 字节 映射演示

输入任意 0/1 串,看它逐位展开成 SPI 字节。1 个 SPI 字节模拟 1 个灯带 bit:bit=0 发 0xC0,bit=1 发 0xF8。

Next · 调色台

把 24 bit 拆开看:改颜色、翻比特、走完整帧波形

六颗芯片的 18 字节数据、144 个 SPI 字节、RESET 前后的锁存差异,都在调色台上一手验证,不用接硬件。

打开调色台 →
Cascade

级联:每级取 24 bit,剩下的整形转发

D1 是 MCU 发出的数据,D2 / D3 / D4 是各级芯片自动整形转发后的数据。级联数不受信号整形限制,只受刷新速率约束。

规格书数据传输方法:D1 发送多个 24bit,D2/D3/D4 逐级转发,帧间 RESET 大于 280µs
规格书第 4 页 · 数据传输方法:第一颗取走前 24 bit,其余整形转发;帧间 RESET > 280 µs
来源:《WS2811 规格书 V2.1》第 1、3、4 页。
项目规格书口径
级联能力刷新速率 30 帧/秒时,级联数不小于 1024 点(高速模式;低速模式 512 点)
传输距离任意两点不超过 4 米,无需增加任何电路
数据速率800 Kbps(开关特性表 FMAX 最小 600 Kbps,占空比 50%)
同步刷新RESET ≥ 280 µs 后,所有芯片把锁存的 24 bit PWM 数据同时送到 OUTR / OUTG / OUTB
Circuit

典型应用电路

规格书给出三种供电方案,区别只在每通道串联的 LED 颗数与 VDD 限流电阻 Rd;去耦电容 Ci 统一 1 µF。

来源:《WS2811 规格书 V2.1》第 5 页「典型应用电路」。
供电每通道 LEDRd(VDD 限流)Ci(去耦)
5 V1 颗150 Ω1 µF
12 V3 颗4.7 kΩ1 µF
24 V6 颗10 kΩ1 µF
三种电压的差别只在两处 每通道串联的 LED 颗数,以及 VDD 上的限流电阻 Rd:母线电压越高,一串灯珠越多、Rd 取值越大。外围拓扑完全相同,去耦电容 Ci 恒为 1 µF。
WS2811 5V 供电应用参考电路,每通道 1 颗 LED,Rd 150Ω,Ci 1µF
5 V 供电参考电路(规格书第 5 页);12 V / 24 V 拓扑相同,仅串联颗数与 Rd 不同