从零开始玩转TMS320F280049的EPWM：手把手教你配置一个呼吸灯（附完整代码）

1. 项目概述与硬件准备

呼吸灯作为嵌入式开发的经典入门项目，能直观展示PWM调光效果。使用TI C2000系列MCU的增强型PWM模块（EPWM）实现这一功能，不仅能学习寄存器配置，还能深入理解工业级PWM控制器的工作原理。

所需硬件组件 ：

• TMS320F280049C LaunchPad开发板
• 5mm LED（建议使用低电流型号）
• 220Ω限流电阻
• 面包板与连接线

开发环境搭建步骤 ：

1. 安装最新版Code Composer Studio (CCS)
2. 下载并导入C2000ware库
3. 创建新工程，选择F280049C芯片型号
4. 配置调试器为XDS110

提示：使用LaunchPad板载调试器时，无需额外仿真设备。若LED接在GPIO31（板载LED），可省去外部电路搭建。

2. EPWM核心模块解析

2.1 时基模块（TB）配置要点

时基模块决定PWM波形的周期和计数模式，关键参数包括：

• TBPRD ：周期寄存器值，决定PWM频率
• TBCTR ：实时计数器值
• 计数模式 ：
  • 向上计数（Up-count）：用于非对称波形
  • 向下计数（Down-count）：较少使用
  • 上下计数（Up-down-count）：生成对称波形，适合呼吸灯

// 时基模块初始化示例
EPWM_setTimeBasePeriod(EPWM1_BASE, 1000);  // 设置周期值
EPWM_setTimeBaseCounter(EPWM1_BASE, 0);    // 计数器归零
EPWM_setTimeBaseCounterMode(EPWM1_BASE, EPWM_COUNTER_MODE_UP_DOWN); // 上下计数模式

2.2 计数器比较模块（CC）实战

比较模块通过CMPA/CMPB寄存器控制占空比，呼吸灯效果通过动态调整CMPA实现：

寄存器	功能描述	呼吸灯应用
CMPA	主比较值	控制LED亮度变化
CMPB	辅助比较	本项目中未使用
CMPCTL	比较控制	配置影子寄存器加载时机

// 动态更新比较值的代码片段
void updateBreathingEffect(volatile uint32_t base, uint16_t *direction, uint16_t *brightness) {
    if (*direction) {
        (*brightness)++;
        if (*brightness >= EPWM_getTimeBasePeriod(base)) *direction = 0;
    } else {
        (*brightness)--;
        if (*brightness == 0) *direction = 1;
    }
    EPWM_setCounterCompareValue(base, EPWM_COUNTER_COMPARE_A, *brightness);
}

2.3 动作限定符（AQ）配置技巧

AQ模块将定时器事件转换为具体的IO动作，呼吸灯需要配置：

• 向上计数达到CMPA时：拉高输出
• 向下计数达到CMPA时：拉低输出

典型配置流程 ：

1. 清除时基零点动作
2. 设置比较匹配动作
3. 配置输出极性

EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A,
    EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA);
EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A,
    EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA);

3. 完整呼吸灯实现

3.1 硬件电路连接

推荐两种连接方式：

1. 板载LED方案 ：

   • 使用GPIO31（EPWM1A）
   • 无需外部元件

2. 外部LED方案 ：

   EPWM1A → 220Ω电阻 → LED阳极
   LED阴极 → GND
   

3.2 软件实现步骤

1. 初始化系统时钟和外设：

void InitSysCtrl(void) {
    InitPLL(DSP28_PLLCR, DSP28_DIVSEL);
    InitPeripheralClocks();
}

2. EPWM模块完整配置：

void initEPWM1(void) {
    // 时基配置
    EPWM_setClockPrescaler(EPWM1_BASE, EPWM_CLOCK_DIVIDER_1, EPWM_HSCLOCK_DIVIDER_1);
    EPWM_setTimeBasePeriod(EPWM1_BASE, 1000);
    EPWM_setTimeBaseCounter(EPWM1_BASE, 0);
    EPWM_setTimeBaseCounterMode(EPWM1_BASE, EPWM_COUNTER_MODE_UP_DOWN);
    
    // 比较模块配置
    EPWM_setCounterCompareShadowLoadMode(EPWM1_BASE, 
        EPWM_COUNTER_COMPARE_A, EPWM_COMP_LOAD_ON_CNTR_ZERO);
    EPWM_setCounterCompareValue(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, 500);
    
    // 动作限定符配置
    EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A,
        EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA);
    EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A,
        EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA);
    
    // 启用PWM输出
    EPWM_enableOutput(EPWM1_BASE);
}

3. 主循环实现呼吸效果：

int main(void) {
    InitSysCtrl();
    InitEPwm1Gpio();
    initEPWM1();
    
    uint16_t brightness = 0;
    uint16_t direction = 1;  // 1=渐亮, 0=渐暗
    
    while(1) {
        updateBreathingEffect(EPWM1_BASE, &direction, &brightness);
        DELAY_US(1000);  // 控制呼吸速度
    }
}

4. 高级优化与调试技巧

4.1 性能优化方案

频率与分辨率平衡 ：

• 提高TBPRD值 → 增加亮度级数但降低刷新率
• 降低TBPRD值 → 提高刷新率但减少亮度级数

推荐参数组合：

// 200Hz PWM频率，1000级亮度控制
EPWM_setTimeBasePeriod(EPWM1_BASE, 1000);  // 200MHz/1000 = 200kHz
SysCtl_setClock(200000000);  // 设置系统时钟为200MHz

4.2 常见问题排查

LED不亮检查清单 ：

1. 确认GPIO已配置为EPWM功能
2. 检查EPWM输出使能标志
3. 验证时基计数器是否运行
4. 测量PWM输出引脚波形

使用CCS调试技巧 ：

• 在Watch窗口监控TBCTR寄存器
• 使用Graph工具观察CMPA值变化
• 设置断点在AQ事件触发点

4.3 扩展应用思路

多LED控制方案 ：

// 使用EPWM1A和EPWM1B驱动双色LED
EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B,
    EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA);
EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B,
    EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA);

加入中断控制 ：

// 配置ET模块在TBCTR=0时触发中断
EPWM_enableInterrupt(EPWM1_BASE);
EPWM_setInterruptSource(EPWM1_BASE, EPWM_INT_TBCTR_ZERO);
EPWM_setInterruptEventCount(EPWM1_BASE, 1);