嵌入式周记1

Duration：12月8日（周一）----10月14日（周日）

总结：

（基于MSPM0G3507的例程学习）

• Timer定时器中断例程
• Timer输出PWM例程

例程

1、timg_32bit_timer_mode_periodic_sleep

（1）简介

timg_32bit_timer_mode_periodic_sleep例程展示了MSPM0G3507平台上 TimerG（TIMG）在低功耗周期定时场景中的典型用法，重点在于 “定时器中断唤醒+ SLEEP 低功耗运行” 的完整应用模式。下面按工程逻辑对该例程进行系统性介绍。

但是我手动删除了SLEEP 低功耗运行相关内容。

（2）应用源文件（main.c）（Application & ISR Layer代码）

#include"ti_msp_dl_config.h"intmain(void){SYSCFG_DL_init();NVIC_EnableIRQ(TIMER_0_INST_INT_IRQN);//使能中断函数DL_TimerG_startCounter(TIMER_0_INST);//手动开启通用定时器（TIMG）计数器while(1){//不考虑低功耗模式切换}}voidTIMER_0_INST_IRQHandler(void){//多中断模式下，switch选择/* DL_TIMER_IIDX_ZERO参数来自文件dl_timer.h 地址为C：\ti\mspm0_sdk_2_07_00_05\source\ti\driverlib\dl_timer.h 在该文件中搜索DL_TIMER_IIDX，即可看到中断对应的DriverLib枚举， 例如：DL_TIMER_IIDX_ZERO，DL_TIMER_IIDX_LOAD，DL_TIMER_IIDX_CC0_DN等。 */switch(DL_TimerG_getPendingInterrupt(TIMER_0_INST)){caseDL_TIMER_IIDX_ZERO:DL_GPIO_togglePins(GPIO_LEDS_PORT,GPIO_LEDS_USER_LED_1_PIN|GPIO_LEDS_USER_TEST_PIN);break;default:break;}}

1. 中断使能函数

NVIC_EnableIRQ(TIMER_0_INST_INT_IRQN);

• 函数名：NVIC_EnableIRQ()
  为 CMSIS 提供的 NVIC 中断使能接口。

• 参数：TIMER_0_INST_INT_IRQN
  为定时器对应的IRQ 中断号宏定义，
  其定义位于DriverLib 配置头文件ti_msp_dl_config.h中，由 SysConfig 自动生成。

2. 定时器启动函数

DL_TimerG_startCounter(TIMER_0_INST);

• 函数名：DL_TimerG_startCounter()
  用于启动通用定时器（TIMG）计数器。

• 参数：TIMER_0_INST
  为定时器外设实例句柄，同样定义于ti_msp_dl_config.h。

3. 中断源读取函数

DL_TimerG_getPendingInterrupt(TIMER_0_INST);

• 函数名：DL_TimerG_getPendingInterrupt()
  用于读取当前定时器挂起的中断索引（Interrupt Index）。

• 返回值：DL_TIMER_IIDX_xxx枚举类型
  用于区分不同的定时器中断事件。

• 参数：TIMER_0_INST
  定时器外设实例，来源同上。

4. 中断服务函数（ISR）命名规则

voidTIMER_0_INST_IRQHandler(void)

• ISR 函数名必须与NVIC 向量表中对应的中断入口名称完全一致。

• 该名称由 SysConfig 根据定时器实例自动生成，并在
  ti_msp_dl_config.h中进行声明。

• 若 ISR 命名不匹配，中断将无法正确响应。

（3）DriverLib 配置头文件（ti_msp_dl_config.h）

/* Defines for TIMER_0 */#defineTIMER_0_INST(TIMG12)#defineTIMER_0_INST_IRQHandlerTIMG12_IRQHandler#defineTIMER_0_INST_INT_IRQN(TIMG12_INT_IRQn)#defineTIMER_0_INST_LOAD_VALUE(15999999U)

这组宏把具体硬件定时器 TIMG12，包装成一个逻辑上的 “TIMER_0”，用于统一初始化、统一中断、统一参数配置。

这组宏的命名遵循的是典型的嵌入式驱动层命名约定（driver-level naming convention）。

第一层是逻辑功能名。
TIMER_0并不等同于某个具体的硬件外设，而是工程中定义的“第 0 号逻辑定时器”。它代表“这个工程中用来完成某一功能的定时器实例”，而不是芯片手册里的 TIMG12、TIM2 之类的物理编号。这样做的好处是，业务代码只依赖TIMER_0，当硬件映射发生变化时，只需修改宏定义而无需改动逻辑代码。

第二层是实例/角色后缀
_INST、_IRQHandler、_INT_IRQN、_LOAD_VALUE分别明确指出该宏在系统中的“角色”：

• INST表示“外设实例本身”（通常是寄存器基地址或结构体指针）
• IRQHandler表示“该实例对应的中断服务函数名”
• INT_IRQN表示“该实例在 NVIC 中使用的中断号”
• LOAD_VALUE表示“该实例的关键配置参数（装载值）”
  这种后缀命名方式使读代码的人无需查上下文就能知道这个宏该用在什么位置。

第三层是全大写 + 下划线的风格
全大写明确表明这些是编译期常量或配置宏，而不是变量或函数；下划线分隔单词是 C 语言和嵌入式领域长期形成的事实标准，有利于跨团队、跨平台阅读。

2、timx_timer_mode_pwm_edge_sleep

（1）简介

timx_timer_mode_pwm_edge是一个使用 MSPM0 的 TimerX 生成边沿对齐 PWM 波形的标准示例，展示了如何通过硬件定时器比较机制，在几乎不占用 CPU 的情况下稳定输出可控占空比的 PWM 信号。

学习重心在于syscfg的配置上。

（2）应用源文件（main.c）

#include"ti_msp_dl_config.h"intmain(void){SYSCFG_DL_init();DL_TimerG_startCounter(PWM_0_INST);while(1){}}

DL_TimerG_startCounter(PWM_0_INST);开启定时器即可。

（3）syscfg配置

下面展示一个新工程的TIM关于PWM的配置。

其中Basic Configuration配置如下：

其中PinMux配置如下：

该新工程DEBUG后试运行：