4. Port与Dio模块详解：Port模块配置（引脚复用功能）、Dio模块配置（高低电平读写）、实战点亮LED
好，我们正式开始第4章。前面几章我们把工具链、工程结构和基础概念都捋了一遍。从这章开始，要动真格的了——配置BSW模块，然后让硬件听我们的话。
这一章的核心就两件事：Port模块和Dio模块。说白了，Port管引脚的功能选择，Dio管引脚的电平读写。两个模块配合，才能让一个LED亮起来。
本章核心目标：通过配置Port和Dio，实现一个最简单的硬件输出——点亮开发板上的LED。这是所有嵌入式开发的“Hello World”。
4.1 Port模块：引脚功能的“总闸”
Port模块在AUTOSAR里负责什么？我个人的理解是：它管理着芯片引脚的所有复用功能。一个物理引脚，可能是GPIO，也可能是SPI的SCK，还可能是UART的TX。到底当什么用，由Port模块的配置决定。
你想想看，如果Port没配好，后面Dio、Spi、Can这些模块就算配置得再完美，也根本没法工作。因为信号根本到不了正确的引脚上。
4.1.1 Port配置的核心参数
在EB tresos或Davinci工具里，打开Port模块的配置界面，你会看到一堆参数。别慌，核心的就这几个：
| 参数名（常用缩写） | 含义 | 典型值 |
|---|---|---|
| PortPinId | 引脚编号，比如PortPin_PA0 | 由芯片手册定义 |
| PortPinDirection | 引脚方向：输入还是输出 | PORT_PIN_IN / PORT_PIN_OUT |
| PortPinMode | 引脚复用模式，对应芯片的AF选择 | PORT_PIN_MODE_GPIO / PORT_PIN_MODE_AF1... |
| PortPinLevelValue | 初始输出电平（仅输出模式有效） | STD_LOW / STD_HIGH |
| PortPinPad | 上下拉、驱动能力等电气属性 | PULL_UP / PULL_DOWN / PUSH_PULL |
我的习惯：每次新建工程，我都会先把所有用到的引脚在Port里配好方向、模式和初始电平。这一步做扎实了，后面调试能省一半时间。
4.1.2 引脚复用模式（PortPinMode）
这个参数是Port模块的灵魂。芯片厂商会把每个引脚的功能编号成不同的Alternate Function（AF）。比如PA9，AF1可能是UART1_TX，AF2可能是SPI2_SCK。
在AUTOSAR里，PortPinMode就是用来选这些AF的。配置时，你需要对照芯片手册，找到你想要的复用功能对应的模式号。
我曾经踩过的坑：有一次配SPI，我明明把PortPinMode设成了AF2，但SPI就是没波形。查了半天，发现芯片手册里SPI_SCK的复用功能是AF5，不是AF2。所以，一定要以芯片手册为准，别想当然。
4.2 Dio模块：高低电平的“开关”
Port管好了引脚的功能，Dio就负责具体的电平读写。Dio模块的API非常简洁，就几个函数：
- Dio_ReadChannel：读一个引脚的电平
- Dio_WriteChannel：写一个引脚的电平
- Dio_ReadPort：读一组引脚（一个Port）的电平
- Dio_WritePort：写一组引脚的电平
Dio的配置比Port简单得多，核心就是定义DioChannel，把Dio通道和Port引脚绑定起来。
4.2.1 Dio配置的关键参数
| 参数名 | 含义 | 说明 |
|---|---|---|
| DioPortId | 所属的Port编号 | 比如DioPort_A |
| DioChannelId | 通道编号，对应Port内的引脚序号 | 比如DioChannel_0 对应PA0 |
| DioLevelType | 电平类型，STD_LOW或STD_HIGH | 用于初始化和读写 |
注意：Dio模块只负责读写，不负责引脚功能切换。所以，必须先配好Port，再配Dio。顺序反了，Dio读写的就是一个功能未定义的引脚，结果不可控。
4.3 实战：点亮LED的完整配置流程
好，理论说完了，我们直接上手。假设开发板上有一个LED，连接在PA5引脚上，高电平点亮。
4.3.1 第一步：配置Port模块
在工具中，找到Port模块的配置界面，新建一个PortPin：
- PortPinId：设为
PortPin_PA5 - PortPinDirection：设为
PORT_PIN_OUT（因为我们要输出高电平点亮LED） - PortPinMode：设为
PORT_PIN_MODE_GPIO（用GPIO功能，不是复用外设） - PortPinLevelValue：设为
STD_LOW（初始状态先让LED灭着，安全） - PortPinPad：设为
PUSH_PULL（推挽输出，驱动能力强）
4.3.2 第二步：配置Dio模块
在Dio模块的配置界面，新建一个DioChannel：
- DioPortId：设为
DioPort_A（对应GPIOA） - DioChannelId：设为
DioChannel_5（对应PA5）
嗯，这里要注意：DioChannelId的数字必须和PortPin里的引脚序号一致。比如PA5，DioChannelId就是5。
4.3.3 第三步：生成代码并编写应用
配置完成后，生成代码。你会得到 Port_PBcfg.c、Dio_PBcfg.c 等文件。然后在你的应用代码里，调用Dio的API：
/* 点亮LED */
Dio_WriteChannel(DioConf_DioChannel_DioChannel_LED, STD_HIGH);
/* 延时一会儿 */
Os_CounterTick(/* 延时参数 */);
/* 熄灭LED */
Dio_WriteChannel(DioConf_DioChannel_DioChannel_LED, STD_LOW);我建议：在应用代码里，不要直接写数字5或PA5。用工具生成的宏定义，比如 DioConf_DioChannel_DioChannel_LED。这样代码可读性强，而且如果以后换引脚，只需要改配置，不用改代码。
4.4 知识体系与配置流程
下面这张图，把Port和Dio的关系、以及点亮LED的完整流程画出来了。你可以对照着看，思路会更清晰。
4.5 避坑指南与个人经验
最后，分享几个我实际项目中遇到的坑，希望能帮你少走弯路。
我曾经犯过的错：
- Port和Dio配置不一致：有一次我Port里配了PA5为输出，但Dio里不小心把ChannelId写成了6。结果Dio_WriteChannel怎么都控制不了那个引脚。排查了半天，才发现是ID对不上。
- 忘了配初始电平：LED在系统启动瞬间闪了一下，然后才正常。这是因为Port的初始电平没配，默认可能是高电平。后来我把PortPinLevelValue设为STD_LOW，问题解决。
- 复用模式搞错：前面提过，SPI的AF号看错了。从那以后，我每次配复用功能，都会把芯片手册的那一页截图贴在配置工具旁边。
我的调试小技巧：点亮LED是验证Port和Dio配置是否正确的黄金方法。如果LED不亮，先检查Port的Direction和Mode，再检查Dio的ChannelId。90%的问题出在这两个地方。
好了，这一章的内容就到这里。Port和Dio是BSW配置的入门，也是基础。把这两个模块吃透，后面配Spi、Can、Lin这些复杂模块时，你会有一种“万变不离其宗”的感觉。