4. DCM模块入门

好，咱们进入DCM模块最核心的入口——初始化。说实话，很多刚接触AUTOSAR诊断栈的工程师，上来就急着写诊断服务处理逻辑，结果发现车机死活连不上诊断仪。问题出在哪儿？十有八九是初始化没做对。

DCM的初始化，说白了就是给整个诊断模块“通电自检”。它不光要准备好内存、配置好通信接口，还得把协议版本、供应商数据、安全等级这些基础信息挂载好。今天我就把这几个关键函数掰开揉碎了讲。

4.1 Dcm_Init：诊断模块的“总开关”

Dcm_Init 是DCM模块的入口函数，在AUTOSAR架构里，它由 EcuM（ECU管理器）在启动阶段调用。我习惯把它比作“总开关”——不拧开它，后面所有诊断服务都跑不起来。

void Dcm_Init(const Dcm_ConfigType* ConfigPtr);

这个函数到底干了什么？我拆成三步来讲：

1. 配置数据加载——把ConfigPtr里的参数拷贝到内部全局变量中。注意，这里不是简单的memcpy，有些参数需要做合法性校验。我曾经遇到过一个坑：配置工具生成的波特率参数是0，结果Dcm_Init直接跑飞了。后来我加了个参数有效性检查，才把问题解决。
2. 通信接口初始化——根据配置激活对应的CAN/LIN/以太网通道。这一步会调用底层驱动（Can_Init、Lin_Init等），把诊断报文的路由打通。
3. 状态机复位——把DCM内部的状态机（比如会话状态、安全等级）全部重置到默认值。默认会话通常是“默认会话”（0x01），安全等级是“锁定”。

代码示例（简化版）：

/* Dcm_Init 内部实现示意 */
static boolean Dcm_InitDone = FALSE;

void Dcm_Init(const Dcm_ConfigType* ConfigPtr)
{
    if (Dcm_InitDone == TRUE)
    {
        /* 防止重复初始化 */
        return;
    }

    /* 1. 校验配置参数 */
    if (ConfigPtr == NULL_PTR)
    {
        Det_ReportError(DCM_MODULE_ID, 0, DCM_E_PARAM_CONFIG);
        return;
    }

    /* 2. 加载配置到内部变量 */
    Dcm_GlobalConfig = *ConfigPtr;

    /* 3. 初始化通信接口 */
    for (uint8 i = 0; i < Dcm_GlobalConfig.NumOfComChannels; i++)
    {
        Can_Init(&Dcm_GlobalConfig.ComChannelConfig[i].CanConfig);
    }

    /* 4. 复位状态机 */
    Dcm_SesCtrl_ResetToDefault();
    Dcm_SecLevel_ResetToLocked();

    Dcm_InitDone = TRUE;
}

4.2 Dcm_GetProtocolVersion：协议版本查询

这个函数很简单，但很重要。诊断仪在建立连接时，通常会先发一个 ReadDataByIdentifier 请求，读取ECU支持的诊断协议版本。如果版本不匹配，诊断仪可能直接断开连接。

Std_ReturnType Dcm_GetProtocolVersion(uint8* ProtocolVersion);

实现逻辑其实就一行：

Std_ReturnType Dcm_GetProtocolVersion(uint8* ProtocolVersion)
{
    if (ProtocolVersion == NULL_PTR)
    {
        return E_NOT_OK;
    }

    *ProtocolVersion = DCM_PROTOCOL_VERSION;  /* 通常为 0x01 或 0x02 */
    return E_OK;
}

嗯，这里要注意：DCM_PROTOCOL_VERSION 这个宏是在配置阶段由工具生成的。ISO 14229-1 定义了两种版本：

我个人习惯在配置工具里直接选 0x02，除非客户有特殊要求。你想想看，现在新出的诊断仪基本都支持2013版，没必要为了兼容老版本给自己找麻烦。

4.3 Dcm_GetVendorSpecificData：供应商数据获取

这个函数用来获取ECU的供应商自定义数据。比如，有些OEM会要求把“ECU硬件版本号”或“Bootloader版本号”放在这里。说白了，它就是一块“自定义数据缓冲区”，你想存什么就存什么。

Std_ReturnType Dcm_GetVendorSpecificData(uint8* Data, uint16* DataLength);

实现时要注意两点：

• 缓冲区溢出检查——如果调用者给的缓冲区太小，直接返回 E_NOT_OK，别硬塞数据。我曾经见过一个案例，调用者只给了4字节缓冲区，但供应商数据有16字节，结果memcpy把栈给踩了，ECU直接复位。
• 数据来源——供应商数据通常存储在NVM（非易失性存储器）中，比如EEPROM或Flash。Dcm_Init 时会把NVM中的数据读到RAM里，Dcm_GetVendorSpecificData 直接从RAM返回。

Std_ReturnType Dcm_GetVendorSpecificData(uint8* Data, uint16* DataLength)
{
    if ((Data == NULL_PTR) || (DataLength == NULL_PTR))
    {
        return E_NOT_OK;
    }

    /* 检查缓冲区大小 */
    if (*DataLength < DCM_VENDOR_DATA_LENGTH)
    {
        *DataLength = DCM_VENDOR_DATA_LENGTH;  /* 告诉调用者需要多大 */
        return E_NOT_OK;
    }

    /* 拷贝数据 */
    (void)memcpy(Data, Dcm_VendorDataBuffer, DCM_VENDOR_DATA_LENGTH);
    *DataLength = DCM_VENDOR_DATA_LENGTH;

    return E_OK;
}

4.4 Dcm_GetSecurityLevel：安全等级查询

安全等级是诊断协议里最敏感的东西。它决定了当前会话能访问哪些诊断服务。比如，“解锁”状态下才能执行 WriteDataByIdentifier 或 RoutineControl。

Std_ReturnType Dcm_GetSecurityLevel(uint8* SecurityLevel);

这个函数的实现非常直接：

Std_ReturnType Dcm_GetSecurityLevel(uint8* SecurityLevel)
{
    if (SecurityLevel == NULL_PTR)
    {
        return E_NOT_OK;
    }

    *SecurityLevel = Dcm_CurrentSecurityLevel;
    return E_OK;
}

但这里有个关键点：安全等级是谁在维护？ 答案是 Dcm_SecLevel 模块。DCM本身只负责查询，不负责修改。安全等级的修改是通过 SecurityAccess 服务（0x27）来完成的，那个服务会调用 Dcm_SecLevel_Set() 来更新内部变量。

我画了一张图，把这几个函数的关系理清楚：

4.5 初始化顺序与依赖关系

这几个函数之间有明确的依赖关系。我整理了一张表，方便你对照：

4.6 配置工具中的参数设置

最后，我简单说一下在配置工具里怎么设置这些参数。以Vector DaVinci为例：

• DcmGeneral > DcmProtocolVersion：选择 0x01 或 0x02，对应 ISO 14229-1 版本。
• DcmGeneral > DcmVendorSpecificData：这里可以添加自定义数据块，比如“ECU_HW_VERSION”、“SW_VERSION”等。每个数据块有独立的长度和存储位置。
• DcmSecurityLevel：在 DcmSecurityLevel 容器里定义所有安全等级，包括等级值（0x00~0xFF）和对应的访问权限。

嗯，配置工具生成的代码通常放在 Dcm_Cfg.c 和 Dcm_Cfg.h 里。你不需要手动修改这些文件，但最好能看懂它们——万一工具出了bug，你还能手动修复。