05 / Implementation
工程实现:代码与实物
分两部分看——代码给出 CubeMX 配置、编码映射与数值推导;实物与演示给出上电录像与点亮效果。
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 规格书核对——命名不代表口径。
数值怎么来的
| 量 | 推导 | 结果 |
|---|---|---|
| SPI 时钟 | 由 APB2 分频得到(档位见 SPI.ioc) | 6.0 MHz |
| 单 SPI bit | 1 / 6 MHz | 166.7 ns |
| 灯带位周期 | 8 × 166.7(1 SPI 字节 = 1 灯带 bit) | 1333.6 ns |
| 灯带位速率 | 6 MHz / 8 | 750 kbps |
| CODE0 高电平 | 0xC0 前 2 位为 1 → 2 × 166.7 | 333.4 ns |
| CODE1 高电平 | 0xF8 前 5 位为 1 → 5 × 166.7 | 833.5 ns |
| 单帧数据量 | 40 灯 × 24 bit × 1 字节/bit | 960 字节 |
| 单帧传输时长 | 960 字节 × 1.333 µs | 1.28 ms |
字节间的空隙必须压住
早期用轮询方式逐字节调用 SPI 时,每个字节之间会出现约 15 µs 的空隙——远超 1 µs 的位宽上限,灯带直接判错。
改用 SPI + DMA 后,空隙被压到 1 个 SCK 周期(167 ns),但并不是零,机理见「问题记录」。
两者是同一现象的不同量级:DMA 不是「消除」间隙,而是把它压进可接受范围。
Demo
实物与演示
代码跑起来的实际表现:先看录像,再看单色 / 逐灯控色的点亮效果。
画面中电源显示的 3.05 V 是当时实测供电值,只说明「数据链路通了」,不是推荐工作点——WS2811 手册的电气参数是在 VDD = 4.5~5.5 V 下给出的。