引言

在嵌入式开发中，WS2812B 这类单总线协议 LED 对时序要求极为严格。传统 bit-banging 方式占用 CPU 且难以保证时序。利用 STM32 等单片机的 SPI 外设配合 DMA，可以高效地将数据“搬运”到 LED，实现高刷新率。但许多开发者在 Arduino 环境下（如使用 STM32duino 或 ESP32 核心）移植此方案时，会遇到颜色偏移（例如红色变暗、绿色异常）的诡异问题。本文将以 STM32 为例，深入剖析 SPI 时钟相位（CPHA）误差如何导致 WS2812B 颜色偏移，并提供完整的排查与修复方案。

原理剖析

WS2812B 的时序要求

WS2812B 采用单线归零码通信，每个数据位（0 或 1）由不同占空比的高电平脉冲表示：

0 码：高电平持续 0.4μs，低电平 0.85μs（周期 1.25μs）
1 码：高电平持续 0.8μs，低电平 0.45μs（周期 1.25μs）

实际允许误差在 ±150ns 左右。

SPI 模拟 WS2812B 的原理

SPI 外设可以产生精确的时钟和数据信号。通常我们配置 SPI 为主模式，发送 8 位数据。通过将每个 WS2812B 位映射为 SPI 字节（例如 0b11000000 表示 1 码，0b10000000 表示 0 码），利用 MOSI 引脚输出。但 SPI 时钟极性（CPOL）和相位（CPHA）决定了数据在时钟的哪个边沿被采样。

CPOL=0, CPHA=0：数据在时钟上升沿采样（空闲时时钟为低）
CPOL=0, CPHA=1：数据在时钟下降沿采样（空闲时时钟为低）

对于 WS2812B，其数据采样点在高电平的中间。若 SPI 配置的相位不匹配，会导致 MOSI 输出的数据位在时间上偏移，从而改变高电平的占空比，最终造成颜色偏移。

相位误差的根源

在 Arduino 的 SPI 库中，默认配置通常为 SPI_MODE0（CPOL=0, CPHA=0）。但 WS2812B 的时序要求数据在时钟上升沿后保持稳定，而 SPI 在 CPHA=0 时，数据在第一个时钟沿（上升沿）被采样，此时 MOSI 可能尚未稳定（尤其在高速传输时），导致有效高电平时间缩短，表现为 1 码的占空比不足，颜色变暗或偏色。

排查步骤

1. 确认硬件连接

确保 WS2812B 的 DIN 引脚连接到 SPI 的 MOSI（例如 STM32 的 PA7），且共地。使用示波器或逻辑分析仪观察 DIN 引脚波形。

2. 检查 SPI 配置

在 Arduino 代码中，初始化 SPI 时明确设置模式：

SPI.begin();
SPI.beginTransaction(SPISettings(8000000, MSBFIRST, SPI_MODE0)); // 常见默认

尝试切换为 SPI_MODE1（CPOL=0, CPHA=1）或 SPI_MODE2/SPI_MODE3，观察颜色变化。

3. 分析波形

用示波器测量 MOSI 引脚，对比不同模式下的波形。重点观察 1 码的高电平持续时间。

解决方案

方案一：调整 SPI 模式

根据实测，对于 WS2812B，通常 SPI_MODE1（CPOL=0, CPHA=1）能获得更准确的时序。因为 CPHA=1 时，数据在时钟下降沿被采样，而 MOSI 在上升沿后已稳定，高电平持续时间更接近理想值。

SPI.beginTransaction(SPISettings(8000000, MSBFIRST, SPI_MODE1));

方案二：使用硬件定时器微调（高级）

若调整模式仍不理想，可考虑使用定时器输出比较功能，精确控制每个位的时序，但复杂度较高。

方案三：使用专用库

推荐使用成熟的库，如 Adafruit_NeoPixel 或 FastLED，它们内部已处理了时序细节，但可能无法利用 DMA。若需 DMA，可参考 WS2812B_SPI_DMA 类库，其已针对相位问题做了优化。

完整代码示例

以下代码展示了如何在 Arduino（STM32 核心）上使用 SPI+DMA 驱动 WS2812B，并采用 SPI_MODE1 修复颜色偏移。

#include <SPI.h>
#include <DMA.h>  // 假设使用 STM32duino 的 DMA 库

#define LED_COUNT 10
#define DATA_PIN PA7  // SPI1 MOSI

uint8_t ledData[LED_COUNT * 3];  // 每个 LED 3 字节（GRB）

void setup() {
  // 初始化 SPI，使用 SPI_MODE1
  SPI.begin();
  SPI.beginTransaction(SPISettings(8000000, MSBFIRST, SPI_MODE1));
  
  // 配置 DMA 传输（此处为伪代码，具体依赖平台）
  // dmaConfig();
  
  // 填充测试数据：第一个 LED 为红色，其余关闭
  for (int i = 0; i < LED_COUNT * 3; i++) {
    ledData[i] = 0x00;
  }
  ledData[0] = 0x80;  // 红色（GRB 顺序，G=0, R=0x80, B=0）
  ledData[1] = 0x00;
  ledData[2] = 0x00;
}

void loop() {
  // 发送数据（使用 DMA）
  // dmaStart(ledData, sizeof(ledData));
  // 等待传输完成
  delay(1000);
}

注意：实际 DMA 配置需根据平台调整，上述代码仅为示意。

注意事项

时钟频率：SPI 时钟频率需保证每个位周期在 1.25μs 左右，8MHz 时每个 SPI 字节周期为 1μs，但实际映射后需计算。通常使用 2.5MHz 或 5MHz 更安全。
数据映射：每个 WS2812B 位需映射为 SPI 字节，例如 1 码映射为 0b11000000，0 码映射为 0b10000000。映射表需根据实际 SPI 模式调整。
DMA 缓冲区：确保 DMA 缓冲区在传输期间不被修改，使用 volatile 或双缓冲。
电源去耦：WS2812B 电流大，需在电源端加电容，否则电压波动也会导致颜色异常。

结语

SPI 时钟相位误差是嵌入式开发中常见的“隐形杀手”，尤其在驱动 WS2812B 这类时序敏感器件时。通过理解原理、使用示波器验证，并合理配置 SPI 模式，可以轻松解决颜色偏移问题。希望本文能帮助你在 Arduino 上稳定高效地驱动 LED 灯带，让创意不受硬件限制。

Arduino 上 DMA 驱动 WS2812B 的 SPI 时钟相位误差：颜色偏移的深度排查与修复

引言