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

工程实现:代码与实物

分两部分看——代码给出 CubeMX 配置、编码映射与数值推导;实物与演示给出上电录像与点亮效果。

01 代码:外设配置与编码映射 02 实物与演示:录像 / 点亮效果
Code

代码:6 MHz SPI + DMA 怎么配

把「6 MHz SPI + DMA」从结论还原成可复现的外设配置,并给出字节 → 位型的映射代码口径。

SPI.ioc · 关键配置STM32F1 / HAL
# 时钟(分频档位随主频变化)
SPI1.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_2
SPI1.CalculateBaudRate = 6.0 MBits/s
SPI1.CLKPolarity       = SPI_POLARITY_HIGH
SPI1.CLKPhase          = SPI_PHASE_2EDGE
PA5 = SPI1_SCK   PA6 = SPI1_MISO   PA7 = SPI1_MOSI

# DMA:内存 → 外设,字节对齐,高优先级
Dma.Request0                    = SPI1_TX
Dma.SPI1_TX.0.Instance          = DMA1_Channel3
Dma.SPI1_TX.0.Direction         = DMA_MEMORY_TO_PERIPH
Dma.SPI1_TX.0.MemDataAlignment  = DMA_MDATAALIGN_BYTE
Dma.SPI1_TX.0.MemInc            = DMA_MINC_ENABLE
Dma.SPI1_TX.0.Mode              = DMA_NORMAL
Dma.SPI1_TX.0.Priority          = DMA_PRIORITY_HIGH

# 缓冲区:每灯 24 bit → 24 个 SPI 字节
gWs2812bDat_SPI[WS2812B_AMOUNT * 24]
编码映射 · 口径CODE0 / CODE1
/* 1 SPI 字节 = 1 灯带 bit
   6 MHz / 8 = 750 kHz → 1.333 µs */
#define CODE0  0xC0  /* 11000000: T0H=2bit=333ns */
#define CODE1  0xF8  /* 11111000: T1H=5bit=834ns */
/* 0xF0: T1H=T1L=4bit=667ns, 两项都进窗口 */

/* 24 bit / 灯,高位先发 */
for (led = 0; led < LED_N; led++) {
    color = (r[led] << 16) | (g[led] << 8) | b[led];
    for (i = 0; i < 24; i++) {
        bit = (color >> (23 - i)) & 1;
        buf[led * 24 + i] = bit ? CODE1 : CODE0;
    }
}
HAL_SPI_Transmit_DMA(&hspi1, buf, LED_N * 24);
/* 发完拉低 ≥ RES(280 µs) 锁存 */
注意 上方循环是口径示意,用于说明映射规则,并非现役工程源码逐字拷贝。 现役工程里的变量沿用 WS2812B_AMOUNT 等历史命名(板子先按 WS2812B 调的), 但字节顺序与时序一律按 WS2811 规格书核对——命名不代表口径。

数值怎么来的

750 kbps 是 6 MHz SPI 的折算值;手册额定 800 kbps 对应 1.25 µs 位宽,两者都在芯片可识别范围内。
量推导结果
SPI 时钟由 APB2 分频得到(档位见 SPI.ioc)6.0 MHz
单 SPI bit1 / 6 MHz166.7 ns
灯带位周期8 × 166.7(1 SPI 字节 = 1 灯带 bit)1333.6 ns
灯带位速率6 MHz / 8750 kbps
CODE0 高电平0xC0 前 2 位为 1 → 2 × 166.7333.4 ns
CODE1 高电平0xF8 前 5 位为 1 → 5 × 166.7833.5 ns
单帧数据量40 灯 × 24 bit × 1 字节/bit960 字节
单帧传输时长960 字节 × 1.333 µs1.28 ms
字节间的空隙必须压住 早期用轮询方式逐字节调用 SPI 时,每个字节之间会出现约 15 µs 的空隙——远超 1 µs 的位宽上限,灯带直接判错。 改用 SPI + DMA 后,空隙被压到 1 个 SCK 周期(167 ns),但并不是零,机理见「问题记录」。 两者是同一现象的不同量级:DMA 不是「消除」间隙,而是把它压进可接受范围。
Demo

实物与演示

代码跑起来的实际表现:先看录像,再看单色 / 逐灯控色的点亮效果。

上电演示 · 电源设定 3.05 V(低于手册 VDD 下限,仅作点亮验证),40 灯灯条整条按帧刷色
画面中电源显示的 3.05 V 是当时实测供电值,只说明「数据链路通了」,不是推荐工作点——WS2811 手册的电气参数是在 VDD = 4.5~5.5 V 下给出的。
40 灯灯条整条点亮绿色,验证 SPI + DMA 数据传输正常
单色绿 · 40 灯整条点亮:验证整帧 960 字节一次 DMA 发完、无段尾掉灯
40 灯灯条整条点亮红色
单色红 · 换通道值复测:确认 R / G / B 三字节顺序为 RGB,没有红绿对调
40 灯灯条逐灯点亮不同颜色,验证级联数据分发
逐灯控色 · 每条灯珠颜色不同:验证「每级取走 24 bit、余下转发」的级联分发正确