第4章 模块配置入门：CAN Driver模块配置实战
好，咱们今天来聊聊CAN Driver模块的配置。说实话，这是AUTOSAR底层配置里最基础也最关键的一环。我刚开始接触EB tresos时，第一个上手的就是CAN Driver。为什么？因为CAN总线在汽车里太常见了，发动机、变速箱、车身控制，哪哪都有它。
你想想看，如果CAN Driver配错了，上层协议栈跑得再漂亮也没用。就像盖房子，地基没打好，装修再豪华也白搭。今天我就带你一步步走通这个配置流程。
4.1 CAN Driver在AUTOSAR里的位置
先搞清楚一件事：CAN Driver属于MCAL层，直接跟硬件打交道。它上面是CanIf（CAN接口层），再往上才是CanTp、CanNm这些。
我习惯把CAN Driver比作「翻译官」——它把上层发来的数据帧，翻译成硬件能理解的寄存器操作。反过来，硬件收到的CAN报文，也由它翻译成标准格式往上送。
核心职责：
- 初始化CAN控制器和收发器
- 发送和接收CAN报文
- 处理中断和错误
- 管理硬件对象（Hardware Object）
4.2 EB tresos里的CAN Driver配置项
打开EB tresos，新建一个工程后，你会看到CAN Driver的配置界面。嗯，第一次看可能会有点懵，参数太多了。别急，咱们一个一个来。
4.2.1 CanConfigSet（配置集）
这是最顶层的容器。一个工程里可以配多个配置集，但实际运行时只会激活一个。我个人习惯只配一个，省得切换时出问题。
| 参数名 | 说明 | 我的建议 |
|---|---|---|
| CanMaxBufferSize | 最大缓冲区大小（字节） | 一般设64，够用 |
| CanVersionInfoApi | 是否使能版本信息API | 开发阶段打开，量产关掉 |
| CanIndex | CAN模块的索引号 | 从0开始，别重复 |
这里有个坑：CanMaxBufferSize 不是越大越好。我在一个项目里设成了256，结果RAM占用飙升，MCU直接跑不起来。后来查了半天才发现是这里的问题。一般64字节足够应付大部分场景了。
4.2.2 CanController（CAN控制器）
每个CAN控制器对应一个硬件CAN模块。比如你用的芯片有3路CAN，这里就要配3个Controller。
注意：Controller的索引必须跟硬件一致。我曾经见过有人把CAN0和CAN1的索引搞反了，结果报文死活发不出去。调试了整整两天才发现是索引配错了。
关键参数：
- CanControllerBaudRate：波特率。常用的是500Kbps和250Kbps。高速CAN用500K，车身控制用250K。
- CanControllerWakeupSource：唤醒源。支持本地唤醒和远程唤醒。我建议远程唤醒打开，这样总线有活动时MCU能自动醒来。
- CanControllerPropagationDelay：传播延迟。这个参数跟硬件布线有关，一般保持默认就行。
4.2.3 CanHardwareObject（硬件对象）
这是CAN Driver配置里最复杂的部分。硬件对象说白了就是硬件里的邮箱（Mailbox），用来存放待发送或已接收的报文。
硬件对象分两种：
- CanHardwareObjectType = BASIC：基本型，一个对象对应一个报文ID。适合报文数量少的场景。
- CanHardwareObjectType = FULL：全功能型，一个对象可以处理多个报文ID（通过掩码匹配）。适合报文数量多的场景。
我个人经验：发送用BASIC，接收用FULL。为什么？发送报文通常固定ID，一个对象一个ID很清晰。接收报文可能来自不同节点，用FULL加掩码可以灵活过滤。
小技巧：配置硬件对象时，记得把CanObjectId跟硬件邮箱编号对应起来。比如硬件有32个邮箱，ObjectId就从0到31。别跳着配，否则代码生成后可能访问到无效地址。
4.3 配置参数详解（重点）
好，咱们深入看看几个容易出错的参数。
4.3.1 CanIdType
标准帧（11位ID）还是扩展帧（29位ID）？这个得看你的网络设计。我见过有人把标准帧配成了扩展帧，结果CANoe里抓到的报文ID全不对。嗯，这种低级错误其实很容易犯。
4.3.2 CanObjectId
硬件对象的唯一标识。注意：这个ID不是报文ID，而是硬件邮箱的编号。别搞混了。
4.3.3 CanFilterMask
接收过滤掩码。配合CanFilterCode使用。掩码为0表示不过滤，接收所有报文。掩码为全1表示精确匹配。
举个例子：
// 假设你想接收ID为0x123的报文
CanFilterCode = 0x123
CanFilterMask = 0x7FF // 11位掩码，精确匹配
// 如果想接收0x120到0x12F范围内的报文
CanFilterCode = 0x120
CanFilterMask = 0x7F0 // 低4位忽略我在一个项目中用过范围过滤，效果很好。但要注意：掩码设置不当会导致收不到该收的报文，或者收到不该收的报文。调试时可以用CANoe先抓一下总线，确认报文ID范围再配。
4.4 生成代码初探
配置完成后，点击生成代码按钮。EB tresos会生成一堆文件，主要关注这几个：
- Can.c / Can.h：CAN Driver的主文件，包含所有API实现
- Can_Cfg.h：配置头文件，你配的参数都定义在这里
- Can_PBcfg.c：配置数据，运行时用到的常量表
打开Can_Cfg.h，你会看到类似这样的内容：
#define CAN_CONTROLLER_COUNT 2U
#define CAN_HARDWARE_OBJECT_COUNT 16U
#define CAN_0_BAUDRATE 500000U
#define CAN_1_BAUDRATE 250000U这些宏定义就是你在EB tresos里配的参数。代码生成器把它们变成了C代码。嗯，这里要注意：不要手动修改生成的文件。如果你改了，下次重新生成时会被覆盖。所有修改都应该在EB tresos的配置界面里完成。
生成代码后的验证步骤：
- 检查Can_Cfg.h里的宏定义是否跟配置一致
- 检查Can_PBcfg.c里的配置数据是否完整
- 编译工程，看有没有语法错误
- 下载到开发板，用CANoe或PCAN抓一下总线，确认报文能正常收发
4.5 避坑指南
最后，分享几个我踩过的坑：
- 波特率不匹配：CAN网络上的所有节点波特率必须一致。我曾经把CAN0配成500K，CAN1配成250K，结果两个节点互相通信时全是错误帧。后来统一成500K就正常了。
- 中断优先级：CAN中断优先级不能设得太低，否则高优先级中断会一直抢占，导致CAN报文丢失。我一般设成中等偏上。
- 硬件对象数量：别把硬件对象配得比硬件实际邮箱多。比如硬件只有16个邮箱，你配了32个对象，代码生成时不会报错，但运行时访问到不存在的邮箱就会出问题。
好了，CAN Driver的配置入门就讲到这里。下一章咱们聊聊CanIf模块的配置，那是连接CAN Driver和上层协议栈的桥梁。到时候我会分享更多实战经验。
记住：配置工具只是辅助，真正理解每个参数的含义才是关键。多动手，多调试，慢慢就有感觉了。