第4章 GPIO模块配置详解：从Dio到点亮LED
GPIO，说白了就是芯片的“手脚”。你让它高它就高，你让它低它就低。但真正做项目时，你会发现事情没那么简单——引脚复用、上下拉、驱动能力，哪个没配好都可能让你抓狂。
这一章，我们重点讲三个东西：Dio模块、Port模块，以及怎么用它们点亮一颗LED。我会结合EB Tresos的实际配置界面来讲，也会穿插一些我踩过的坑。
4.1 Dio模块：最直接的IO读写接口
Dio模块，全称Digital Input/Output。它的任务很简单：读引脚电平，写引脚电平。没有花里胡哨的功能，就是快、直接。
在EB Tresos里配置Dio，你需要关注这几个东西：
- DioChannel：每个引脚对应一个通道，比如DioChannel_0对应PA0
- DioPort：端口分组，比如PORTA、PORTB
- DioLevelType：电平类型，HIGH或LOW
DioConf_DioChannel_LED。别用DioChannel_0这种默认名，不然三个月后你自己都看不懂。
4.1.1 Dio核心API
Dio模块提供的API不多，但个个实用。我列个表，你一看就明白：
| API函数 | 功能 | 参数 | 返回值 |
|---|---|---|---|
Dio_ReadChannel |
读取单个引脚电平 | ChannelId | HIGH/LOW |
Dio_WriteChannel |
设置单个引脚电平 | ChannelId, Level | 无 |
Dio_ReadPort |
读取整个端口电平 | PortId | PortLevelType |
Dio_WritePort |
设置整个端口电平 | PortId, Level | 无 |
Dio_FlipChannel |
翻转引脚电平 | ChannelId | 无 |
你看，就这么几个函数。但别小看它们——我见过有人用Dio_WritePort不小心把整个端口都改了，结果把别的引脚也带偏了。所以，操作单个引脚就用Dio_WriteChannel，别偷懒。
4.1.2 EB Tresos中Dio配置步骤
打开EB Tresos，找到Dio模块。配置流程大概是这样的：
- 添加DioPort：选择你用的端口，比如PortA
- 添加DioChannel：在端口下添加引脚，比如Pin0
- 配置ChannelId：这个ID是全局唯一的，后面代码里要用
- 设置默认电平：上电后引脚是什么状态，建议设成高阻或确定电平
4.2 Port模块：引脚功能的“总开关”
Port模块比Dio复杂一些。它负责的是引脚的功能选择和电气属性配置。说白了，Dio只管读写，Port管这个引脚是当GPIO用，还是当UART、SPI、I2C用。
在EB Tresos里，Port模块的配置项很多。我挑几个最重要的说：
- PinDirection：输入还是输出
- PinMode：复用功能选择，比如ALT0是GPIO，ALT1是UART
- PinLevelValue：初始电平，输出模式下有效
- PinOutputDrive：驱动能力，一般选PUSH_PULL
- PinPull：上下拉电阻，输入模式常用PULL_UP或PULL_DOWN
- PinSpeed：引脚速率，高频信号需要配高
4.2.1 Port核心API
Port模块的API主要用于初始化，运行时一般不动它：
| API函数 | 功能 | 说明 |
|---|---|---|
Port_Init |
初始化所有Port引脚 | 在系统启动时调用一次 |
Port_SetPinDirection |
运行时改变引脚方向 | 慎用，可能影响其他功能 |
Port_SetPinMode |
运行时改变引脚复用 | 一般不用，初始化配好就行 |
我个人建议：所有引脚配置在初始化时一次性搞定。运行时改方向或模式，容易出问题。除非你有特殊需求，比如模拟I2C需要切换方向。
4.3 引脚复用与电气属性：细节决定成败
引脚复用，就是同一个引脚可以干不同的事。比如PA9可以是GPIO，也可以是UART1_TX。怎么选？靠PinMode。
在EB Tresos里，每个引脚都有多个Alternate Function（ALT）选项。你需要查芯片手册，找到你要的功能对应的ALT编号。
4.3.1 电气属性配置要点
电气属性这块，很多人容易忽略。但恰恰是这些细节，决定了你的板子稳不稳定。
- 上下拉电阻：输入引脚一定要配上拉或下拉，防止浮空。我习惯用内部上拉，省一个外部电阻。
- 驱动能力：输出引脚选PUSH_PULL，开漏输出用于I2C等总线。
- 引脚速率：普通GPIO用低速就行，高速信号（比如SPI时钟）要配高速，否则波形会变形。
4.4 实战：点亮一颗LED
理论说完了，咱们来点实际的。点亮一颗LED，是嵌入式开发的“Hello World”。
假设我们的LED接在PA0上，高电平点亮。配置步骤如下：
4.4.1 EB Tresos配置
- Port模块配置：
- 找到PortPin_0（对应PA0）
- PinDirection设为PORT_PIN_OUT
- PinMode设为ALT0（GPIO模式）
- PinLevelValue设为LOW（上电默认灭）
- PinOutputDrive设为PUSH_PULL
- PinSpeed设为LOW（LED不需要高速）
- Dio模块配置：
- 添加DioChannel，关联到PortPin_0
- ChannelId设为0（或你喜欢的ID）
- 默认电平设为LOW
- 生成代码：点击生成，EB Tresos会自动生成Port和Dio的配置代码。
4.4.2 应用代码
配置完成后，写应用代码就很简单了：
/* 头文件 */
#include "Dio.h"
#include "Port.h"
/* 主函数 */
int main(void)
{
/* 初始化Port模块（配置引脚功能） */
Port_Init(&Port_ConfigSet);
/* 初始化Dio模块（配置通道） */
Dio_Init(&Dio_ConfigSet);
/* 点亮LED */
Dio_WriteChannel(DioConf_DioChannel_LED, STD_HIGH);
while(1)
{
/* 主循环，啥也不干 */
}
return 0;
}你看，代码就这么几行。但背后，EB Tresos帮你生成了几百行的配置代码。这就是AUTOSAR的好处——配置驱动开发，代码自动生成。
4.4.3 常见问题排查
点亮LED看似简单，但实际项目中我见过不少人卡在这里。我列几个常见问题：
- LED不亮：检查Port的PinDirection是不是OUT，PinMode是不是GPIO，Dio的ChannelId对不对。
- LED微亮：可能是引脚浮空，或者驱动能力不够。检查上下拉配置和输出驱动类型。
- LED闪烁：可能是代码里其他地方在操作这个引脚，或者看门狗复位了。
Dio_ReadChannel读一下引脚电平，确认配置是否生效。如果读出来是HIGH但LED不亮，那问题大概率在硬件上。
嗯，这一章的内容就到这里。GPIO配置是嵌入式开发的基础，但基础不牢，地动山摇。Dio和Port的配合，引脚复用和电气属性的细节，都是你后面做复杂项目时的基石。多练练，自然就熟了。