3. MCAL工程创建与配置流程

在AURIX TC3xx项目中，MCAL配置不是“打开工具点几下”就能完成的工作，它本质上是在EB tresos中建立一套与硬件资源、启动流程和上层BSW需求严格对应的静态配置数据库。本节以MCU、Port、Dio、Gpt四个基础模块为主线，说明从新建工程到生成配置代码的完整操作路径，并给出可复现的示例参数与判断依据。

一、工程创建前的准备

EB tresos Studio本身只是配置容器，真正决定可配置内容的是导入的MCAL插件包。以英飞凌AURIX TC3xx为例，需要准备三类输入：

• MCAL插件包：通常为 AURIX2G_MCAL_<版本>.zip 或按模块拆分的插件目录，包含MCU、Port、Dio、Gpt、Mcu等模块的 .xdm 描述文件与生成模板。
• 目标派生型号：例如 TC387QP，它决定可用外设实例、时钟树节点和引脚数量。
• 编译器与派生宏：如 Tasking 或 GHS，以及 TC387QP 对应的派生宏，用于生成条件编译代码。

建议在磁盘上建立独立工作区，例如 D:\AURIX_WS\TC387_MCAL，避免路径中出现中文和空格，否则部分生成脚本会因路径解析失败而中断。

二、新建工程与导入MCAL插件

启动EB tresos后，选择 File → New → Project，在向导中指定工程名（如 TC387_MCAL_Demo）和工程路径。工程创建完成后，通过 Window → Preferences → Tresos → Module Plugins 或工程右键菜单中的 Import Module Plugins 导入MCAL插件目录。导入成功后，在工程的 Modules 视图中应能看到 Mcu、Port、Dio、Gpt 等模块节点。

此时需要先建立“派生型号”与“编译器”两个全局约束。在 Project Settings 中设置 Derivative = TC387QP、Compiler = Tasking，并勾选 Generate MCAL Configuration。这一步决定了后续各模块中可选的时钟源、引脚和中断向量范围。

三、MCU模块：时钟与复位配置

MCU模块是其他模块的“时间基准”。在 Mcu 节点下依次配置：

• McuClockSettingConfig：选择PLL作为系统时钟源，示例目标为 fPLL = 300 MHz，fSPB = 100 MHz。
• McuRamSectorSettingConfig：按需划分RAM初始化区域，示例保留默认。
• McuResetSettingConfig：使能上电复位与看门狗复位源。

配置完成后，可在 McuClockSettingConfig 的 McuClockReferencePoint 中看到 MCU_CLOCK_REF_300MHZ 等引用点，后续Gpt的时基即引用该点。判断配置是否合理，主要看PLL输出频率是否与目标派生型号手册中的最大频率一致，以及SPB分频后是否满足外设时钟上限。

四、Port与Dio模块：引脚方向与电平控制

Port模块负责引脚的方向、初始电平和复用功能，Dio模块负责运行时读写。两者必须成对配置：Port中把某引脚设为GPIO输出，Dio中才能对该通道调用 Dio_WriteChannel。

示例：将 P33.0 配置为推挽输出，初始电平为低，用于驱动一颗状态LED；将 P33.1 配置为输入，用于读取按键。在Port模块中，PortPin 节点下设置 PortPinDirection = PORT_PIN_OUT、PortPinLevelValue = PORT_PIN_LEVEL_LOW、PortPinMode = GPIO。在Dio模块中，DioChannel 节点下将 P33.0 映射为 DioChannel_0，P33.1 映射为 DioChannel_1。

需要特别注意的是，Port的初始化必须在Dio读写之前完成，否则Dio操作可能作用在未定义方向的引脚上。这一顺序在生成代码中由 Port_Init 与 Dio_Init 的调用次序保证。

五、Gpt模块：定时器通道与通知

Gpt模块用于产生周期性中断或单次延时。以 GPT_CH_0 为例，配置为周期模式，时基引用MCU的 MCU_CLOCK_REF_300MHZ，预分频设为 300，则计数时钟为 1 MHz，即每计数1次为 1 µs。若目标周期为 1 ms，则 GptChannelTickFrequency = 1000000、GptChannelTickValueMax = 1000。

在 GptChannelConfig 中使能 GptNotification，并绑定到 Gpt_Notification_0 回调函数。生成代码后，该回调会在每次周期到达时被调用，可用于翻转LED或计数。

六、生成配置代码与结果检查

完成上述模块配置后，点击 Generate 按钮，EB tresos会依据各模块的 .xdm 模板生成 Mcu_Cfg.c/h、Port_Cfg.c/h、Dio_Cfg.c/h、Gpt_Cfg.c/h 等文件。生成目录通常为工程下的 generate 或 output 文件夹。

检查生成结果时，重点看三处：一是 Mcu_Cfg.c 中 Mcu_ClockSettingConfig 的频率值是否与设定一致；二是 Port_Cfg.c 中 P33.0 的方向和电平是否与配置匹配；三是 Gpt_Cfg.c 中 GptChannelTickValueMax 是否为 1000。若生成失败，优先检查插件版本与派生型号是否匹配，以及路径中是否含特殊字符。

七、常见问题与判断依据

实际工程中，最容易出问题的不是单个模块的参数，而是模块之间的引用关系。例如Gpt的时基引用了MCU中不存在的时钟引用点，生成时不会报错，但运行时定时器频率会偏离预期。判断方法是：在 Gpt_Cfg.c 中确认 GptChannelClockReference 指向的引用点名称，与 Mcu_Cfg.c 中 McuClockReferencePoint 的名称完全一致。

另一个常见问题是Port与Dio的通道映射错位。若Dio中 DioChannel_0 实际映射到了 P33.1，则写LED时按键输入会受影响。判断方法是：在 Dio_Cfg.c 中查看 DioChannelConfig 的 DioChannelId 与 PortPinId 的对应关系，确保与Port中的引脚编号一致。

完成以上步骤后，工程已经具备可编译的MCAL配置代码。下一步是在集成环境中调用 Mcu_Init、Port_Init、Dio_Init、Gpt_Init，并按照 Mcu → Port → Dio → Gpt 的顺序初始化，才能保证引脚方向和定时器时基在运行前已就绪。