用GD32F103C8T6的PWM做个呼吸灯，保姆级代码配置详解（附源码）

用GD32F103C8T6实现呼吸灯：从PWM原理到完整项目实战

第一次看到呼吸灯效果时，那种柔和的光线渐变总让人着迷——从完全熄灭到最亮，再缓缓暗下去，周而复始。这种效果在智能设备上随处可见，比如笔记本的睡眠指示灯、手机充电提示灯。今天我们就用GD32F103C8T6这款国产单片机，配合PWM技术亲手打造一个呼吸灯项目。

1. 呼吸灯背后的PWM原理

呼吸灯的核心在于LED亮度的平滑变化，而实现这一效果的关键就是**脉冲宽度调制(PWM)**技术。PWM通过快速开关LED来控制其平均亮度，这种开关速度远超肉眼能感知的范围（通常几百Hz到几kHz），所以我们看到的是亮度变化而非闪烁。

1.1 PWM关键参数解析

理解PWM需要掌握三个核心参数：

• 频率(Frequency)：每秒完整的PWM周期数，单位Hz。对于LED控制，通常选择200Hz-5kHz。
• 周期(Period)：一个完整PWM波的时间长度，是频率的倒数。例如1kHz对应1ms周期。
• 占空比(Duty Cycle)：高电平时间占整个周期的比例，决定LED亮度。0%表示常灭，100%表示最亮。

在GD32的定时器中：

• TIMERx_CAR寄存器设置周期值
• TIMERx_CHxCV寄存器设置比较值（决定占空比）

1.2 呼吸灯算法设计

要实现呼吸效果，我们需要动态调整占空比。常见方法有：

1. 线性变化：占空比从0%线性增加到100%，再线性减少
2. 指数变化：更符合人眼对亮度感知的非线性变化
3. 正弦波变化：最自然的呼吸效果

// 简单的线性呼吸算法示例 void breathing_linear(void) { static uint16_t pulse = 0; static int8_t dir = 1; pulse += dir; if(pulse >= 1000) dir = -1; else if(pulse == 0) dir = 1; timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, pulse); delay_ms(1); }

2. 硬件准备与工程搭建

2.1 所需材料清单

2.2 开发环境配置

1. 安装工具链：

   • Keil MDK或PlatformIO
   • GD32 Firmware Library
   • ST-Link驱动

2. 创建新工程：

   # PlatformIO初始化命令示例 pio init --board gd32f103c8t6

3. 硬件连接：

   • LED正极接PA1（TIMER1_CH1）
   • LED负极通过电阻接地
   • ST-Link的SWD接口连接开发板

提示：GD32与STM32引脚兼容，但库函数有所不同，注意区分。

3. PWM配置详解

3.1 时钟树配置

GD32F103运行在108MHz主频时，定时器时钟也是108MHz。要产生1kHz PWM：

PWM频率 = 定时器时钟 / (预分频值 + 1) / (周期值 + 1)

设预分频为107：

1kHz = 108MHz / (107 + 1) / (999 + 1)

对应代码：

timer_initpara.prescaler = 107; // 预分频值 timer_initpara.period = 999; // 自动重装载值

3.2 完整PWM初始化代码

void pwm_init(void) { timer_oc_parameter_struct timer_ocintpara; timer_parameter_struct timer_initpara; // 使能时钟 rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_AF); rcu_periph_clock_enable(RCU_TIMER1); // GPIO配置为复用功能 gpio_init(GPIOA, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_1); // 定时器基础配置 timer_struct_para_init(&timer_initpara); timer_initpara.prescaler = 107; timer_initpara.alignedmode = TIMER_COUNTER_EDGE; timer_initpara.counterdirection = TIMER_COUNTER_UP; timer_initpara.period = 999; timer_initpara.clockdivision = TIMER_CKDIV_DIV1; timer_init(TIMER1, &timer_initpara); // 输出通道配置 timer_oc_struct_para_init(&timer_ocintpara); timer_ocintpara.ocpolarity = TIMER_OC_POLARITY_HIGH; timer_ocintpara.outputstate = TIMER_CCX_ENABLE; timer_channel_output_config(TIMER1, TIMER_CH_1, &timer_ocintpara); // PWM模式配置 timer_channel_output_mode_config(TIMER1, TIMER_CH_1, TIMER_OC_MODE_PWM0); timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, 0); // 初始占空比0% // 启动定时器 timer_auto_reload_shadow_enable(TIMER1); timer_enable(TIMER1); }

4. 实现平滑呼吸效果

4.1 指数变化算法

人眼对亮度的感知是非线性的，指数变化比线性变化看起来更自然：

// 指数呼吸算法 void breathing_exponential(void) { static float alpha = 0; static float step = 0.01; uint16_t pulse; alpha += step; if(alpha > 2*PI) alpha = 0; // 利用正弦函数平方实现指数效果 pulse = (uint16_t)(999 * (0.5 - 0.5*cos(alpha))); timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, pulse); delay_ms(10); }

4.2 呼吸速度控制

通过调整两个参数控制呼吸节奏：

1. 步长(step)：每次占空比变化的增量
2. 延时(delay)：每次变化后的等待时间

// 可调参数的呼吸函数 void breathing_control(uint16_t max_pulse, uint16_t step, uint16_t delay_ms) { static uint16_t pulse = 0; static int8_t dir = 1; pulse += dir * step; if(pulse >= max_pulse) dir = -1; else if(pulse <= 0) dir = 1; timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, pulse); delay_ms(delay_ms); }

4.3 多LED呼吸效果

扩展使用TIMER1的多个通道控制多个LED：

// 三色LED呼吸灯 void rgb_breathing(void) { static uint16_t r=0, g=333, b=666; static int8_t r_dir=1, g_dir=1, b_dir=1; // 红色LED r += r_dir * 3; if(r >= 999) r_dir = -1; else if(r <= 0) r_dir = 1; // 绿色LED g += g_dir * 5; if(g >= 999) g_dir = -1; else if(g <= 0) g_dir = 1; // 蓝色LED b += b_dir * 2; if(b >= 999) b_dir = -1; else if(b <= 0) b_dir = 1; timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, r); timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_2, g); timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_3, b); delay_ms(10); }

5. 进阶技巧与问题排查

5.1 常见问题解决方案

5.2 使用中断优化呼吸效果

避免使用delay函数阻塞CPU，改用定时器中断更新占空比：

// 在timer_config()后添加 void timer_interrupt_config(void) { nvic_irq_enable(TIMER1_IRQn, 0, 0); timer_interrupt_enable(TIMER1, TIMER_INT_UP); } // 中断服务函数 void TIMER1_IRQHandler(void) { if(timer_interrupt_flag_get(TIMER1, TIMER_INT_FLAG_UP)) { static uint16_t pulse = 0; static int8_t dir = 1; pulse += dir; if(pulse >= 999) dir = -1; else if(pulse <= 0) dir = 1; timer_channel_output_pulse_value_config(TIMER1, TIMER_CH_1, pulse); timer_interrupt_flag_clear(TIMER1, TIMER_INT_FLAG_UP); } }

5.3 使用硬件PWM输出

对于更精确的控制，可以启用硬件PWM模式：

timer_primary_output_config(TIMER1, ENABLE); timer_channel_output_fast_config(TIMER1, TIMER_CH_1, TIMER_OC_FAST_ENABLE);

6. 完整项目源码与扩展思路

6.1 项目文件结构

breathing_led/ ├── GD32F10x_Firmware_Library // GD32标准库 ├── User/ │ ├── main.c // 主程序 │ ├── pwm.c // PWM配置 │ └── pwm.h // 头文件 └── Project.uvprojx // Keil工程文件

6.2 主程序示例

#include "gd32f10x.h" #include "pwm.h" #include <math.h> void delay_ms(uint32_t ms) { for(uint32_t i=0; i<ms*8000; i++) __NOP(); } int main(void) { // 系统时钟配置 rcu_apb2_clock_config(RCU_APB2_CKAHB_DIV1); systick_config(); // PWM初始化 pwm_init(); while(1) { // 选择一种呼吸算法 breathing_exponential(); // breathing_linear(); // rgb_breathing(); } }

6.3 扩展应用方向

1. 音乐频谱可视化：根据音频频率改变呼吸节奏
2. 环境光感应：根据环境亮度自动调节LED亮度
3. 无线控制：通过蓝牙/WiFi远程调节呼吸参数
4. 多级亮度预设：实现不同场景的灯光模式