📚 课程目录第4章 GPT（通用定时器）模块配置

4. GPT（通用定时器）模块配置：时钟源选择、通道配置、中断配置

好，咱们进入第四章。GPT模块，说白了就是芯片里的“闹钟”和“秒表”。在汽车嵌入式系统里，你几乎找不到一个不用定时器的项目——从PWM生成、周期唤醒、到超时检测，全得靠它。

EB Tresos里配置GPT，核心就三件事：时钟从哪来、通道怎么用、中断怎么响应。咱们一个一个拆开讲。

4.1 时钟源选择：定时器的“心跳”

定时器要跑起来，首先得有时钟。GPT模块的时钟源通常有两个层级：模块时钟和通道时钟。

时钟层级	说明	典型来源
GPT模块时钟 (GptModuleClk)	整个GPT外设的基准时钟	系统PLL、外部晶振、内部RC振荡器
GPT通道时钟 (GptChannelClk)	每个通道独立的分频后时钟	模块时钟经过预分频器得到

在EB Tresos里，你需要在 GptConfigSet 下找到 GptClockReferencePoint 这个配置项。我个人习惯是先确认芯片的时钟树——比如TC3xx系列，GPT模块通常挂在 SPB 总线上，时钟频率可能高达100MHz甚至更高。但你的应用可能只需要1kHz的定时中断，这时候就要靠预分频器来降频。

小技巧： 预分频器的值不是随便填的。你得算一下：目标频率 = 模块时钟 / (预分频值 + 1)。比如模块时钟80MHz，想要1MHz的通道时钟，预分频值就设79。

我在项目中遇到过一个问题：同事把预分频值设成了0，结果通道时钟直接等于模块时钟，计数器跑得飞快，还没进中断服务函数呢，定时器已经溢出了好几次。嗯，这种低级错误，排查起来还挺费时间的。

4.2 通道配置：定时器的“工作模式”

时钟选好了，接下来配置通道。GPT的通道模式主要有两种：连续计数模式和单次计数模式。

连续计数模式 (Continuous)：计数器从0计到最大值，然后自动回0重新开始。适合周期性的任务，比如每1ms触发一次ADC采样。
单次计数模式 (One-Shot)：计数器从0计到设定值，停下来。适合延时、超时检测这类一次性需求。

在EB Tresos里，通道配置主要涉及以下几个参数：

参数名	作用	我的建议值
GptChannelMode	选择连续还是单次	周期性任务用Continuous，一次性用OneShot
GptChannelTickFrequency	通道时钟频率（Hz）	根据预分频计算后填入
GptChannelTickValueMax	计数器的最大值	32位定时器通常设0xFFFFFFFF
GptChannelTimeOut	超时值（单位：tick）	根据需要的定时时间换算

举个例子：你需要一个10ms的定时中断。通道时钟是1MHz（1 tick = 1us），那么超时值就是 10ms / 1us = 10000。在EB Tresos里，GptChannelTimeOut 就填10000。

注意： 超时值不能超过计数器的最大值。如果你用16位定时器，最大值是65535。1MHz时钟下，最长定时也就65.535ms。想定更长时间？要么降低时钟频率，要么换32位定时器。

4.3 中断配置：定时器的“闹铃”

定时器计到目标值了，总得通知CPU吧？这就是中断的活。GPT的中断配置在EB Tresos里分两步：使能中断源和关联中断服务函数。

首先，在 GptChannelConfigSet 里找到 GptChannelInterrupt，把它使能。然后，在MCU的中断管理器（比如 Irq 模块）里，把GPT通道的中断向量号绑定到你的回调函数。

我曾经踩过一个坑：在EB Tresos里使能了GPT中断，但忘了配置中断优先级。结果系统里其他高优先级中断一多，GPT中断就一直被抢占，定时器超时了但CPU根本不理它。后来我用逻辑分析仪一看，中断标志位都置起来了，就是没进ISR。查了半天，原来是优先级默认是0（最高），被别的中断给“饿死”了。

    避坑指南： 配置GPT中断时，一定要检查中断优先级。建议给GPT分配一个中等优先级（比如3或4），既不会被低频任务耽误，也不会抢占关键控制中断。

另外，中断服务函数里要记得清中断标志。AUTOSAR的GPT驱动通常提供 Gpt_GetTimeElapsed() 和 Gpt_GetTimeRemaining() 这两个API，但中断标志的清除一般由硬件自动完成，或者通过调用 Gpt_EnableWakeup() 等函数隐式处理。具体看芯片手册，别想当然。

4.4 实战：一个10ms周期定时器的配置流程

光说不练假把式。咱们走一遍完整的配置流程，假设芯片是Infineon TC3xx，EB Tresos版本25.0。

创建GPT模块实例：在EB Tresos的模块列表里添加 Gpt 模块。
配置模块时钟：GptClockReferencePoint 选择系统时钟，比如80MHz。
配置通道0：
- GptChannelId = 0
- GptChannelMode = Continuous
- GptChannelTickFrequency = 1000000 (1MHz)
- GptChannelTickValueMax = 0xFFFFFFFF
- GptChannelTimeOut = 10000 (10ms)
使能中断：GptChannelInterrupt = Enabled。
配置中断优先级：在 Irq 模块里，把GPT0的中断优先级设为3。
生成代码：点击生成，EB Tresos会帮你生成 Gpt_Cfg.c 和 Gpt_Cfg.h。
写应用代码：在 Gpt_Notification_GptChannel_0() 里放你的周期任务。

代码大概长这样：

/* 在Gpt_Notification_GptChannel_0()中 */
void Gpt_Notification_GptChannel_0(void)
{
    /* 每10ms执行一次 */
    Adc_TriggerConversion(AdcGroup_0);
    /* 注意：这里不要做耗时操作，中断里要快进快出 */
}

4.5 GPT配置核心逻辑图

下面这张图帮你理清GPT配置的整个脉络，从时钟源到中断响应，一目了然。

这张图把配置流程串起来了：系统时钟 -> 预分频 -> 通道时钟 -> 选择模式 -> 触发中断。你配置的时候，按这个顺序走，基本不会漏项。

4.6 常见问题与排查思路

最后，分享几个我实际调试中遇到过的问题，你以后碰到了可以少走弯路。

现象	可能原因	排查方法
定时器不计数	时钟源未使能或预分频配置错误	检查SCU时钟门控，用示波器测GPT时钟引脚
中断不触发	中断优先级被抢占或中断标志未清	查看中断挂起寄存器，确认ISR地址是否正确
定时时间不准	时钟频率计算错误或预分频值不对	用逻辑分析仪抓GPIO翻转，反推实际频率
连续模式不循环	超时值设成了最大值，计数器回0后不匹配	检查GptChannelTickValueMax是否合理

嗯，GPT配置其实不难，但细节多。时钟源、通道模式、中断优先级，这三个点你抓住了，剩下的就是按部就班填参数。下次咱们聊PWM模块，那个跟GPT关系很近，很多配置思路是相通的。