4、MCAL之DIO与PORT驱动：通用输入输出配置、端口复用与电气特性设置，实战点亮气囊故障灯
好，我们进入第四章。这一章讲的是MCAL层最基础、也最绕不开的两个模块——DIO和PORT。
说白了，就是怎么让芯片的引脚听话。你让它输出高电平它就高，让它检测外部信号它就老老实实去读。听起来简单？嗯，我当年刚入行时也这么想，结果第一个项目就被引脚复用给坑了一把。
4.1 DIO驱动：最朴素的输入输出
DIO，Digital Input Output。它的任务很纯粹：把引脚配置成输入或者输出，然后读它或者写它。
在AUTOSAR架构里，DIO驱动位于MCAL最底层。它不关心你接的是传感器还是执行器，它只管电平高低。
核心API就这几个：
Dio_ReadChannel()—— 读一个引脚Dio_WriteChannel()—— 写一个引脚Dio_ReadPort()—— 读整个端口Dio_WritePort()—— 写整个端口
举个例子。气囊故障灯，通常就是一个LED，接在某个GPIO上。高电平点亮，低电平熄灭。代码怎么写？
/* 点亮气囊故障灯 */
Dio_WriteChannel(DIO_CHANNEL_AIRBAG_WARN_LAMP, STD_HIGH);
/* 熄灭 */
Dio_WriteChannel(DIO_CHANNEL_AIRBAG_WARN_LAMP, STD_LOW);你看，就这么简单。但实际项目中，麻烦从来不在API调用上，而在配置上。
4.2 PORT驱动：引脚的老大
PORT驱动管什么？管引脚的模式、方向、上下拉、驱动能力、初始电平……说白了，DIO只管读写，PORT管“这个引脚到底是个什么角色”。
我个人的习惯是：先配PORT，再用DIO。顺序搞反了，引脚可能根本不工作。
4.2.1 端口复用
现在的MCU引脚，很少只有一个功能。同一个引脚，可能是GPIO，也可能是SPI的SCK，还可能是PWM输出。怎么选？靠端口复用寄存器。
在AUTOSAR的PORT驱动里，有一个关键配置叫PortPinMode。你把它设成PORT_PIN_MODE_DIO，它就是普通IO。设成PORT_PIN_MODE_ALT1，它就变成某个外设功能。
我曾经踩过的坑：
有一次，我把一个本该做UART TX的引脚，配成了DIO模式。结果调试时发现数据发不出去，查了两天才发现是PortPinMode配错了。嗯，从那以后，我每次配引脚都会先看一眼数据手册的复用表。
4.2.2 电气特性设置
电气特性，听起来高大上，其实就几件事：
- 上下拉：输入引脚悬空时，是拉高还是拉低？我一般给个上拉，防止浮动电平。
- 驱动能力：输出引脚能提供多大电流？2mA、4mA、8mA？驱动LED的话，2mA通常够了。
- 输出类型：推挽还是开漏？推挽用得最多，开漏一般用于I2C这类总线。
- 初始电平：上电瞬间，引脚是高还是低？这个很关键，尤其是控制继电器的场合。
| 配置项 | 典型值 | 说明 |
|---|---|---|
| PortPinDirection | PORT_PIN_IN / PORT_PIN_OUT | 输入还是输出 |
| PortPinMode | PORT_PIN_MODE_DIO | 功能复用选择 |
| PortPinOutputCurrent | PORT_PIN_CURRENT_2mA | 驱动能力 |
| PortPinInternalPull | PORT_PIN_PULL_UP | 内部上下拉 |
| PortPinInitialLevel | PORT_PIN_LEVEL_LOW | 初始电平 |
4.3 实战：点亮气囊故障灯
好，理论说完了，咱们来点实际的。目标：上电后，气囊故障灯亮2秒，然后熄灭。
4.3.1 硬件连接
假设故障灯接在MCU的PB0引脚上。高电平点亮，低电平熄灭。外部串联一个330Ω限流电阻。
4.3.2 PORT配置
首先，把PB0配成输出模式，推挽输出，驱动电流2mA，初始电平为低。
/* PORT配置结构体 */
Port_ConfigType portConfig = {
.PortPin = PORT_PIN_PB0,
.PortPinDirection = PORT_PIN_OUT,
.PortPinMode = PORT_PIN_MODE_DIO,
.PortPinOutputCurrent = PORT_PIN_CURRENT_2mA,
.PortPinInternalPull = PORT_PIN_PULL_OFF,
.PortPinInitialLevel = PORT_PIN_LEVEL_LOW
};
/* 初始化PORT */
Port_Init(&portConfig);4.3.3 DIO操作
然后，在应用代码里控制它。
/* 点亮故障灯 */
Dio_WriteChannel(DIO_CHANNEL_AIRBAG_WARN_LAMP, STD_HIGH);
/* 延时2秒（假设有OsDelay函数） */
OsDelay(2000);
/* 熄灭故障灯 */
Dio_WriteChannel(DIO_CHANNEL_AIRBAG_WARN_LAMP, STD_LOW);一个小技巧：
实际项目中，故障灯的点亮和熄灭往往不是简单延时，而是由诊断状态机控制的。比如，自检通过就灭，检测到故障就闪烁。但底层驱动，始终就是这两行代码。
4.4 避坑指南
最后，分享几个我亲身经历过的坑：
- 引脚初始化顺序：先初始化PORT，再初始化DIO。反过来可能导致DIO配置被PORT覆盖。
- 复用功能冲突：同一个引脚，不能同时配成DIO和SPI。配置前一定要看数据手册的引脚功能表。
- 初始电平的重要性：如果故障灯是低电平点亮，而初始电平配成了高，上电瞬间灯会闪一下。这在安全气囊系统中是不允许的。
- 驱动能力不足：LED需要几毫安电流，如果驱动能力配成0.5mA，灯会非常暗。我见过有人查了半天硬件，结果是软件配置错了。
嗯，这一章就到这里。DIO和PORT看似简单，但它们是所有上层功能的基础。配好了，后面一路顺畅。配错了，调试能让你怀疑人生。
下一章，我们会聊ADC驱动。气囊系统中，碰撞传感器的模拟信号采集就靠它了。