4. AURIX MCAL配置与量产集成准备

在AURIX TC3xx这类多核MCU上做AUTOSAR量产集成，MCAL配置不是“把外设点开就能用”的简单工作，而是把硬件资源、时钟树、引脚复用、中断路由和上层BSW需求一次性对齐的过程。EB tresos（或同类工具如DaVinci Configurator）承担的角色，是把这些硬件细节抽象成可生成代码的配置模型。本节围绕MCU、Port、Dio、Gpt、Adc、Pwm六个最常用驱动，讲清楚每个模块真正要配什么、生成代码长什么样、以及量产前必须核对哪些点。

一、MCU驱动：时钟与复位是整个系统的时间基准

MCU驱动是所有其他驱动的前提，因为它决定了系统时钟、外设时钟分频和复位行为。在EB tresos中，MCU模块的核心配置项包括：McuClockSettingConfig（PLL、分频、时钟源选择）、McuRamSectorSettingConfig（RAM初始化）、McuResetReason（复位原因读取）以及McuModeSettingConfig（运行/低功耗模式）。

以TC375为例，假设外部晶振20 MHz，目标系统时钟300 MHz，则PLL配置需要设置NDIV、PDIV、K2等分频系数，使VCO落在规定范围内。配置完成后，工具会生成Mcu_PBcfg.c中的时钟配置结构体，并在Mcu_Init()中按顺序执行：先切到备份时钟，再配置PLL，等待锁定，最后切换到PLL输出。量产集成时最容易出问题的是时钟安全机制——如果PLL失锁，MCU应触发复位或切换到备份时钟，这一行为必须在McuClockSettingConfig中显式配置，而不是依赖默认值。

二、Port与Dio：引脚复用与数字输入输出的分工

Port驱动负责引脚的方向、复用功能、上下拉和驱动能力；Dio驱动负责在Port配置好的基础上做通道级读写。两者是“先Port后Dio”的依赖关系。在EB tresos中，Port的配置粒度是PortPin，每个引脚要指定：PortPinDirection（输入/输出/双向）、PortPinMode（GPIO或外设复用，如CAN、PWM、ADC）、PortPinInitialMode（上电初始状态）、PortPinLevelValue（初始电平）以及PortPinOutputDriver（推挽/开漏）。

量产中一个典型陷阱是：某个引脚在Port里配成了PWM输出，但Dio又去写同一个通道，导致输出被覆盖。正确做法是——外设复用引脚只由对应驱动（Pwm/Adc/Can）控制，Dio只管理纯GPIO。生成代码中，Port_Cfg.c会包含每个引脚的寄存器配置值，Port_Init()按配置表逐脚写入。Dio则生成Dio_Cfg.c中的通道映射表，Dio_WriteChannel()通过查表定位到具体端口寄存器位。

三、Gpt：通用定时器的通道与通知机制

Gpt驱动用于提供定时基准，常见用途包括OS系统节拍、任务周期触发、超时监控。配置项包括：GptChannelConfig（通道号、定时器类型、计数方向）、GptChannelTickFrequency（tick频率）、GptChannelTickValueMax（最大计数值）以及GptNotification（到达通知回调）。

在TC3xx上，Gpt通常映射到STM或GPT12模块。假设系统tick为1 ms，STM时钟为100 MHz，则比较值应设为100000。配置时要注意：Gpt_StartTimer()启动后，通知回调在中断上下文中执行，回调函数必须短小，不能调用阻塞式服务。量产集成时，Gpt通道与OS的GetCounterValue必须一致，否则会出现节拍漂移。

四、Adc：采样组、通道与结果访问

Adc驱动配置的核心是AdcGroup和AdcChannel。一个Group代表一次转换序列，可以包含多个Channel，支持单次、连续或硬件触发模式。关键配置项包括：AdcGroupConversionMode（单次/连续）、AdcGroupAccessMode（单次访问/流式访问）、AdcGroupTrigSrc（软件触发或硬件触发，如PWM边沿）、AdcChannelRangeSelect（参考电压范围）以及AdcResultAlignment（左对齐/右对齐）。

量产中Adc最常见的两个问题是：采样时间不足导致结果偏低，以及Group优先级冲突导致高优先级组被低优先级组阻塞。配置时需根据信号源阻抗计算最小采样时间，并在AdcGroupPriority中明确排序。生成代码中，Adc_Cfg.c包含Group和Channel的配置表，Adc_ReadGroup()读取结果，Adc_SetupResultBuffer()绑定结果缓冲区。

五、Pwm：周期、占空比与输出通道

Pwm驱动用于生成可调占空比的方波，典型应用是电机控制、LED调光、加热控制。配置项包括：PwmChannelConfig（通道号、周期、占空比默认值）、PwmChannelClass（固定周期/可变周期）、PwmChannelPolarity（高有效/低有效）以及PwmChannelIdleState（空闲电平）。

在TC3xx上，Pwm通常映射到GTM的TOM/ATOM通道。假设PWM频率20 kHz，GTM时钟100 MHz，则周期值设为5000。配置时要注意：Pwm_SetDutyCycle()的占空比参数是0x0000到0x8000的定点数，对应0%到100%，不是直接写百分比。量产集成时，Pwm通道的初始状态必须与执行器安全状态一致，例如电机驱动默认输出0%占空比。

六、生成代码结构与集成顺序

EB tresos生成代码后，每个驱动通常包含三部分：Xxx_Cfg.c/h（配置表）、Xxx_PBcfg.c（Post-Build配置，可后期变体）、Xxx.c/h（驱动实现，通常来自MCAL库）。量产集成时，Xxx_PBcfg.c是唯一允许按项目变体替换的文件，驱动实现本身不应修改。

初始化顺序必须严格遵守：Mcu_Init() → Port_Init() → Dio_Init() → Gpt_Init() → Adc_Init() → Pwm_Init()。原因是MCU提供时钟，Port确定引脚方向，Dio依赖Port，Gpt/Adc/Pwm依赖时钟和引脚复用。如果顺序颠倒，可能出现外设时钟未使能就配置寄存器，导致写入无效。

最后，MCAL配置不是一次性的，量产阶段需要把Xxx_PBcfg.c纳入版本管理，并与硬件原理图、引脚分配表交叉核对。任何引脚变更都必须同步更新Port配置和对应的外设驱动配置，否则会出现“软件配置与硬件实际不符”的隐性故障。