4、Port与Dio模块：Port引脚功能配置、Dio通道配置、代码生成与验证、实战：点亮LED

好，咱们进入第四讲。这一讲非常关键，因为我们要开始真正动手操作硬件了。

前面几章我们搭建了工程、认识了工具界面，但说实话，那都是热身。今天我们要做的，是让芯片上的一个引脚输出高电平，点亮一颗LED。这件事背后，牵扯到AUTOSAR里两个最基础的模块：Port和Dio。

我个人习惯把这两个模块比作「开关」和「灯座」的关系。Port模块负责定义这个引脚是输入还是输出、要不要上拉、驱动能力多大——说白了，就是把这个引脚配置成「灯座」。而Dio模块呢，就是去拧那个开关，让灯亮或者灭。

4.1 Port模块：先把引脚的功能定下来

在EB tresos里配置Port模块，其实就是在回答几个问题：这个引脚用来干嘛？是普通GPIO，还是复用的串口、PWM？如果是GPIO，方向是输入还是输出？

我记得刚入行那会儿，有个同事把串口TX引脚配成了输出高电平，结果调试了一天都发不出数据。后来发现是Port配置里把引脚功能选成了GPIO，而不是ALT1模式。嗯，这种坑踩过一次就忘不了了。

配置步骤：

1. 在左侧的模块列表里双击 Port，打开配置界面。
2. 找到 PortContainer，这里会列出芯片上所有的Port（比如PortA、PortB...）。
3. 展开你要用的那个Port，比如 PortA，然后找到 PortPin 列表。
4. 添加一个新的 PortPin，给它起个名字，比如 LED_Pin。
5. 关键配置项：
   • PortPinDirection：选 PORT_PIN_OUT（输出）。
   • PortPinMode：选 PORT_PIN_MODE_GPIO（普通GPIO模式）。
   • PortPinOutputDrive：根据硬件原理图选，一般推挽输出 PUSH_PULL 就行。
   • PortPinInitialMode：上电初始状态，我习惯设成 LOW，防止上电瞬间LED闪一下。

4.2 Dio模块：定义通道，准备控制

Port配置好了，相当于把「灯座」装好了。接下来我们要用Dio模块来定义「开关」。

Dio模块的配置比Port简单很多。它只关心一件事：哪个PortPin对应哪个DioChannel。说白了，就是给硬件引脚起一个软件里能用的名字。

配置步骤：

1. 双击 Dio 模块，打开配置界面。
2. 找到 DioConfig，然后进入 DioPort 列表。
3. 添加一个 DioPort，选择你刚才配置的那个Port（比如PortA）。
4. 在 DioChannel 列表里添加一个新通道：
   • DioChannelId：填引脚号，比如5（对应PA5）。
   • DioPort：选择刚才创建的DioPort。
5. 保存配置，然后按 Ctrl + Shift + G 生成代码。

生成后，你会在输出目录里看到 Dio.h 和 Port.h。打开看看，里面会有类似这样的宏定义：

/* Dio.h 中生成的宏 */
#define DioConf_DioChannel_LED_Pin   (5U)

/* Port.h 中生成的配置结构体 */
extern const Port_ConfigType PortConfigData[];

看到没？工具已经帮我们把硬件引脚和软件名字绑定好了。接下来写代码就简单了。

4.3 代码生成与验证：检查生成的配置对不对

代码生成后，别急着往芯片里烧。先做两件事：

• 检查头文件：打开 Port_Lcfg.c，看看里面有没有你配置的那个引脚。我一般会搜一下 LED_Pin，确认它出现在配置数组里。
• 检查宏定义：在 Dio.h 里找到 DioConf_DioChannel_LED_Pin，确认它的值等于你期望的引脚号。

4.4 实战：点亮LED

好了，配置完成，代码生成完毕。现在我们来写真正的应用代码。

在 SchM_Os.c 或者你的主循环里，加入以下代码：

#include "Dio.h"
#include "Port.h"

void main(void)
{
    /* 初始化Port配置（这一步必须做！） */
    Port_Init(&PortConfigData[0]);

    /* 点亮LED：往Dio通道写高电平 */
    Dio_WriteChannel(DioConf_DioChannel_LED_Pin, STD_HIGH);

    while(1)
    {
        /* 主循环可以干点别的 */
    }
}

这里有个细节我要强调一下：Port_Init 必须在任何Dio操作之前调用。为什么？因为Port_Init负责把引脚从默认的复位状态切换到我们配置的模式。如果不调，引脚可能还是高阻输入，你写Dio根本没反应。

我记得第一次调这个的时候，LED死活不亮。查了半天，发现是忘了调Port_Init。嗯，从那以后我写代码第一件事就是检查初始化顺序。

编译、下载、复位。如果一切正常，你应该能看到LED亮起来。如果没亮，别慌，按这个顺序排查：

1. 万用表量引脚电压，看是不是高电平（3.3V或5V）。
2. 检查LED极性，是不是接反了。
3. 检查限流电阻，阻值对不对。
4. 回到EB tresos，确认PortPinDirection真的是OUTPUT。

这一章的内容就到这里。下一章我们会讲PWM模块，到时候就能让LED呼吸起来了。先把这个点亮LED的流程跑通，后面就顺了。