STM32驱动全色灯（通常指RGB三色灯，可通过红、绿、蓝三基色混合出任意颜色）的核心是控制三原色通道的亮度比例，常见方式有两种：PWM调光驱动（通过脉冲宽度调制控制亮度）和专用驱动芯片驱动（如WS2812B等串行全彩LED）。以下分场景详细说明实现方法。

一、全色灯的类型与驱动原理

全色灯的核心是红（R）、绿（G）、蓝（B）三个LED通道，通过调整每个通道的亮度（0~100%）混合出任意颜色（如R=100%+G=100%+B=0%混合为黄色）。
常见类型：

• 普通RGB灯：三个独立LED（共阳极或共阴极），需分别控制三个通道的通断/亮度；
• 集成全彩LED：如WS2812B（内置驱动芯片，通过单线串行协议控制，单个芯片对应一个全色灯）。

二、驱动普通RGB灯（PWM调光方式）

普通RGB灯需通过STM32的GPIO配合PWM信号控制每个通道的亮度，适用于低功耗、小电流场景（如指示灯）。

1. 硬件电路设计

根据RGB灯的极性（共阳极/共阴极）设计电路：

（1）共阴极RGB灯（推荐，控制逻辑简单）

• 结构：三个LED的阴极共地，阳极分别接STM32的PWM输出引脚（需串联限流电阻，避免电流过大烧毁GPIO）。

• 原理：STM32输出高电平（PWM）时，LED导通；PWM占空比越高，亮度越亮。

  电路示意图：

  STM32 PWM引脚 (如PA0) → 限流电阻(220Ω) → RGB灯R阳极  
  STM32 PWM引脚 (如PA1) → 限流电阻(220Ω) → RGB灯G阳极  
  STM32 PWM引脚 (如PA2) → 限流电阻(220Ω) → RGB灯B阳极  
  RGB灯阴极 → GND  
  

（2）共阳极RGB灯

• 结构：三个LED的阳极共接电源（如3.3V），阴极分别接STM32的PWM输出引脚（串联限流电阻）。
• 原理：STM32输出低电平（PWM）时，LED导通；PWM占空比越高（低电平时间越长），亮度越亮。

2. STM32CubeMX配置（PWM生成）

需配置STM32的定时器生成3路独立PWM信号（分别控制R、G、B通道），步骤如下：

（1）选择定时器与PWM通道

• 打开STM32CubeMX，选择目标芯片（如STM32F103C8T6）；
• 在“Pinout & Configuration”→“Timers”中选择一个定时器（如TIM2），启用3个通道为“PWM Generation CHx”（如CH1、CH2、CH3）。

（2）配置PWM参数

• 定时器时钟：根据系统时钟配置（如72MHz），设置预分频器（Prescaler）和自动重载值（Counter Period），使PWM频率在1kHz~10kHz（人眼无闪烁）。
  例如：

  • 预分频器（PSC）=71 → 定时器时钟 = 72MHz / (71+1) = 1MHz；
  • 自动重载值（ARR）=999 → PWM频率 = 1MHz / (999+1) = 1kHz；
  • 占空比范围：0_{1000（对应0}100%亮度）。

• 配置PWM模式：选择“PWM Mode 1”（计数器小于比较值时输出有效电平）。

（3）配置GPIO引脚

• 定时器通道自动映射到对应GPIO（如TIM2_CH1→PA0，TIM2_CH2→PA1，TIM2_CH3→PA2），无需手动修改，确保引脚模式为“Alternate Function Push-Pull”。

3. 软件代码实现（PWM调光）

生成工程后，通过修改PWM比较值（CCR）调整占空比，控制RGB亮度。

（1）初始化PWM

CubeMX自动生成定时器初始化函数，在main.c中调用：

MX_TIM2_Init();  // 初始化TIM2，生成3路PWM
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);  // 启动R通道PWM
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_2);  // 启动G通道PWM
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_3);  // 启动B通道PWM

（2）定义颜色控制函数

通过设置TIMx->CCRx寄存器修改占空比（以共阴极为例，值越大亮度越高）：

// 定义亮度范围0~255（映射到PWM占空比0~1000）
#define RGB_MAX 255
#define PWM_MAX 1000

// 设置R通道亮度（0~255）
void rgb_set_red(uint8_t brightness) {
    uint32_t pwm_val = (brightness * PWM_MAX) / RGB_MAX;
    __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, pwm_val);
}

// 设置G通道亮度
void rgb_set_green(uint8_t brightness) {
    uint32_t pwm_val = (brightness * PWM_MAX) / RGB_MAX;
    __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_2, pwm_val);
}

// 设置B通道亮度
void rgb_set_blue(uint8_t brightness) {
    uint32_t pwm_val = (brightness * PWM_MAX) / RGB_MAX;
    __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_3, pwm_val);
}

// 混合颜色（r, g, b范围0~255）
void rgb_set_color(uint8_t r, uint8_t g, uint8_t b) {
    rgb_set_red(r);
    rgb_set_green(g);
    rgb_set_blue(b);
}

（3）测试示例（循环显示彩虹色）

int main(void) {
    HAL_Init();
    MX_TIM2_Init();
    HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);
    HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_2);
    HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_3);

    while (1) {
        rgb_set_color(255, 0, 0);    // 红色
        HAL_Delay(500);
        rgb_set_color(0, 255, 0);    // 绿色
        HAL_Delay(500);
        rgb_set_color(0, 0, 255);    // 蓝色
        HAL_Delay(500);
        rgb_set_color(255, 255, 0);  // 黄色
        HAL_Delay(500);
        rgb_set_color(255, 0, 255);  // 紫色
        HAL_Delay(500);
        rgb_set_color(0, 255, 255);  // 青色
        HAL_Delay(500);
        rgb_set_color(255, 255, 255);// 白色
        HAL_Delay(500);
    }
}

三、驱动集成全彩LED（以WS2812B为例）

WS2812B是常用的串行全彩LED（内置控制芯片），单个灯珠可独立控制，多个灯珠可串联成灯带，仅需1根信号线控制，适用于复杂灯光效果（如流水灯、渐变）。

1. WS2812B特性与通信协议

• 结构：每个灯珠包含R/G/B LED和控制芯片，支持级联（数据从第一个灯珠传到最后一个）；
• 通信协议：单线归零码（NRZ），无需时钟线，通过不同的高电平时间区分“0”和“1”：
  • 逻辑“0”：高电平0.4μs + 低电平0.85μs；
  • 逻辑“1”：高电平0.8μs + 低电平0.45μs；
  • 复位信号：低电平≥50μs（用于刷新显示）。
• 颜色编码：每个灯珠的颜色数据为24位（GRB顺序：绿色8位 + 红色8位 + 蓝色8位，注意不是RGB）。

2. 硬件电路设计

• 信号线：WS2812B的DI（数据输入）接STM32的任意GPIO（如PA0），需串联100Ω限流电阻；

• 电源：WS2812B工作电压3.3V~5V，每个灯珠最大电流约60mA（全亮），多个灯珠需外接电源（避免STM32供电不足）；

• 接地：WS2812B的GND与STM32的GND共地。

  电路示意图：

  STM32 PA0 → 100Ω电阻 → WS2812B DI  
  WS2812B VCC → 5V电源（或3.3V，根据灯珠规格）  
  WS2812B GND → GND（与STM32共地）  
  （多个灯珠级联：前一个DO接后一个DI）
  

3. 软件实现（精确时序控制）

WS2812B对时序要求极高（μs级），需通过GPIO位操作+延时函数或DMA+定时器生成精确信号（推荐后者，避免CPU阻塞）。

（1）基于GPIO位操作的简易实现（适合少量灯珠）

通过nop指令实现微秒级延时（需根据STM32主频校准）：

#include "stm32f1xx_hal.h"

#define WS2812_GPIO_PORT GPIOA
#define WS2812_GPIO_PIN GPIO_PIN_0

// 延时约0.4μs（针对72MHz主频，1个nop≈13.89ns）
#define DELAY_0_4US() do { \
    __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); \
    __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); \
    __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); __NOP(); \
} while(0)

// 延时约0.8μs
#define DELAY_0_8US() do { DELAY_0_4US(); DELAY_0_4US(); } while(0)

// 发送1位逻辑0
static void ws2812_send_0(void) {
    HAL_GPIO_WritePin(WS2812_GPIO_PORT, WS2812_GPIO_PIN, GPIO_PIN_SET);
    DELAY_0_4US();  // 高电平0.4μs
    HAL_GPIO_WritePin(WS2812_GPIO_PORT, WS2812_GPIO_PIN, GPIO_PIN_RESET);
    DELAY_0_8US();  // 低电平0.85μs（近似）
}

// 发送1位逻辑1
static void ws2812_send_1(void) {
    HAL_GPIO_WritePin(WS2812_GPIO_PORT, WS2812_GPIO_PIN, GPIO_PIN_SET);
    DELAY_0_8US();  // 高电平0.8μs
    HAL_GPIO_WritePin(WS2812_GPIO_PORT, WS2812_GPIO_PIN, GPIO_PIN_RESET);
    DELAY_0_4US();  // 低电平0.45μs（近似）
}

// 发送24位颜色数据（GRB格式）
static void ws2812_send_color(uint8_t green, uint8_t red, uint8_t blue) {
    // 发送绿色8位（高位在前）
    for (int i = 7; i >= 0; i--) {
        if (green & (1 << i)) ws2812_send_1();
        else ws2812_send_0();
    }
    // 发送红色8位
    for (int i = 7; i >= 0; i--) {
        if (red & (1 << i)) ws2812_send_1();
        else ws2812_send_0();
    }
    // 发送蓝色8位
    for (int i = 7; i >= 0; i--) {
        if (blue & (1 << i)) ws2812_send_1();
        else ws2812_send_0();
    }
}

// 刷新显示（发送复位信号）
static void ws2812_reset(void) {
    HAL_GPIO_WritePin(WS2812_GPIO_PORT, WS2812_GPIO_PIN, GPIO_PIN_RESET);
    HAL_Delay(1);  // 低电平≥50μs
}

// 控制n个灯珠（colors为GRB数组，每个元素3字节：green, red, blue）
void ws2812_set_colors(uint8_t *colors, uint16_t n) {
    for (uint16_t i = 0; i < n; i++) {
        ws2812_send_color(colors[3*i], colors[3*i+1], colors[3*i+2]);
    }
    ws2812_reset();  // 刷新显示
}

（2）测试示例（控制3个灯珠显示红、绿、蓝）

int main(void) {
    HAL_Init();
    MX_GPIO_Init();  // 初始化PA0为推挽输出

    uint8_t led_colors[9] = {
        0, 255, 0,    // 灯珠1：红色（G=0, R=255, B=0）
        255, 0, 0,    // 灯珠2：绿色（G=255, R=0, B=0）
        0, 0, 255     // 灯珠3：蓝色（G=0, R=0, B=255）
    };

    while (1) {
        ws2812_set_colors(led_colors, 3);
        HAL_Delay(1000);
    }
}

4. 进阶优化（DMA+定时器，适合多灯珠）

当灯珠数量较多（如50个以上），GPIO位操作会占用大量CPU时间，可通过定时器+DMA实现无阻塞发送：

• 定时器配置为PWM模式，通过修改比较值生成不同宽度的脉冲；
• DMA将颜色数据（预转换为脉冲序列）自动发送到GPIO，不占用CPU。

四、常见问题与注意事项

1. 电流限制：

   • STM32 GPIO最大输出电流约20mA，普通RGB灯每个通道电流需控制在10_{20mA（通过220Ω}330Ω限流电阻）；
   • 多个WS2812B需外接电源（如5V/2A），并在电源端并联100μF电容稳定电压。

2. 时序精度：

   • WS2812B对时序敏感，需校准延时函数（可通过示波器测量实际高/低电平时间）；
   • 中断会干扰时序，发送数据时需关闭全局中断（__disable_irq()），发送完成后再开启。

3. 颜色格式：

   • 普通RGB灯通常为RGB格式，WS2812B为GRB格式，编程时需注意顺序，否则颜色会错乱。

4. PWM频率：

   • 普通RGB灯的PWM频率建议1kHz~10kHz（低于50Hz会有闪烁，高于20kHz可能影响LED寿命）。

总结

STM32驱动全色灯的核心是控制三原色通道的亮度比例：

• 普通RGB灯通过定时器PWM实现，电路简单，适合指示灯；
• 集成全彩LED（如WS2812B）通过串行协议控制，适合复杂灯带效果，需注意时序精度。

实际应用中需根据灯珠类型、数量和效果需求选择驱动方式，并关注电流、时序和电源稳定性。