第3章 CANFD驱动开发

CANFD驱动开发：STM32H7的初始化与配置实战

大家好，我是你们的老朋友。今天我们来聊聊STM32H7上的CANFD驱动开发。说实话，这块内容我当年啃了很久，踩过的坑能写满一个小本子。但别担心，我会把最核心的东西掰开揉碎了讲给你听。

CANFD相比传统CAN，最大的变化就是速率能飙上去了。仲裁段还是用原来的速率，但数据段可以跑到8Mbps甚至更高。嗯，这里要注意，速率上去了，时序配置就变得特别敏感。

CANFD初始化流程

我个人习惯把初始化分成三步走：时钟使能、引脚配置、控制器参数设置。顺序不能乱，否则容易出怪问题。

/* 第一步：使能CANFD时钟 */
__HAL_RCC_CAN1_CLK_ENABLE();
__HAL_RCC_GPIOB_CLK_ENABLE();

/* 第二步：配置CANFD引脚 */
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_8|GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF9_CAN1;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

/* 第三步：CANFD控制器初始化 */
hcan1.Instance = CAN1;
hcan1.Init.TimeTriggeredMode = DISABLE;
hcan1.Init.AutoBusOff = ENABLE;
hcan1.Init.AutoWakeUp = DISABLE;
hcan1.Init.AutoRetransmission = ENABLE;
hcan1.Init.ReceiveFifoLocked = DISABLE;
hcan1.Init.TransmitFifoPriority = DISABLE;
HAL_CAN_Init(&hcan1);

你看，代码其实不复杂。但我在项目中遇到过一个问题：引脚复用功能选错了。当时查了半天，最后发现是GPIO_AF9_CAN1写成了GPIO_AF9_CAN2。这种低级错误，排查起来最费时间。

仲裁速率与数据速率的配置

这是CANFD的核心。仲裁速率通常用250kbps或500kbps，数据速率可以到2Mbps、5Mbps甚至8Mbps。为什么能这么快？因为数据段用了更短的位时间。

STM32H7的CANFD内核用的是FDCAN模块，时序配置比传统CAN灵活很多。我们来看一个实际配置：

/* 仲裁段：500kbps */
hcan1.Init.NominalSyncJumpWidth = 1;
hcan1.Init.NominalTimeSeg1 = 13;
hcan1.Init.NominalTimeSeg2 = 2;
hcan1.Init.NominalPrescaler = 2;

/* 数据段：2Mbps */
hcan1.Init.DataSyncJumpWidth = 1;
hcan1.Init.DataTimeSeg1 = 5;
hcan1.Init.DataTimeSeg2 = 2;
hcan1.Init.DataPrescaler = 2;

这里有个关键点：数据段的采样点位置。我建议数据段采样点设在75%左右，仲裁段设在80%左右。为什么？因为数据段速率高，信号上升沿更陡，采样点靠后一点更稳定。

核心公式：

仲裁段波特率 = 时钟频率 / ( (1 + NominalTimeSeg1 + NominalTimeSeg2) × NominalPrescaler )

数据段波特率 = 时钟频率 / ( (1 + DataTimeSeg1 + DataTimeSeg2) × DataPrescaler )

我曾经在一个项目里，把数据速率配到了5Mbps，结果总线一直报错。后来用示波器一看，信号质量很差。降回2Mbps就稳了。所以，不要盲目追求高速率，要看实际硬件环境。

FIFO与DMA模式的选择

FIFO模式是默认的，简单可靠。DMA模式适合大数据量传输，能减轻CPU负担。但DMA也有坑，我后面会讲。

先看FIFO配置：

/* 配置FIFO0 */
sFilterConfig.IdType = CAN_FILTER_IDTYPE_STD;
sFilterConfig.FilterIndex = 0;
sFilterConfig.FilterMode = CAN_FILTERMODE_IDMASK;
sFilterConfig.FilterScale = CAN_FILTERSCALE_32BIT;
sFilterConfig.FilterIdHigh = 0x0000;
sFilterConfig.FilterIdLow = 0x0000;
sFilterConfig.FilterMaskIdHigh = 0x0000;
sFilterConfig.FilterMaskIdLow = 0x0000;
sFilterConfig.FilterFIFOAssignment = CAN_FILTER_FIFO0;
sFilterConfig.SlaveStartFilterBank = 14;
HAL_CAN_ConfigFilter(&hcan1, &sFilterConfig);

FIFO的好处是即插即用，不需要额外配置。但如果你要处理大量报文，比如每秒几千帧，那CPU就会被频繁中断。这时候DMA就派上用场了。

DMA配置稍微复杂一点：

/* 使能CANFD的DMA请求 */
HAL_CAN_ActivateNotification(&hcan1, CAN_IT_RX_FIFO0_MSG_PENDING);

/* 配置DMA */
hdma_can1_rx.Instance = DMA1_Stream0;
hdma_can1_rx.Init.Request = DMA_REQUEST_CAN1;
hdma_can1_rx.Init.Direction = DMA_PERIPH_TO_MEMORY;
hdma_can1_rx.Init.PeriphInc = DMA_PINC_DISABLE;
hdma_can1_rx.Init.MemInc = DMA_MINC_ENABLE;
hdma_can1_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_WORD;
hdma_can1_rx.Init.MemDataAlignment = DMA_MDATAALIGN_WORD;
hdma_can1_rx.Init.Mode = DMA_CIRCULAR;
HAL_DMA_Init(&hdma_can1_rx);

注意：DMA模式有个隐藏问题——缓存一致性。如果你用了D-Cache，DMA传输完成后，CPU读到的可能是旧数据。我当年在这个问题上折腾了两天，最后加了SCB_CleanInvalidateDCache()才解决。

中断处理机制

中断处理是CANFD驱动的灵魂。STM32H7的FDCAN模块有多个中断源，最常用的是接收中断和错误中断。

先看接收中断的处理：

void HAL_CAN_RxFifo0MsgPendingCallback(CAN_HandleTypeDef *hcan)
{
    CAN_RxHeaderTypeDef rxHeader;
    uint8_t rxData[8];
    
    if (HAL_CAN_GetRxMessage(hcan, CAN_RX_FIFO0, &rxHeader, rxData) != HAL_OK)
    {
        /* 错误处理 */
        Error_Handler();
    }
    
    /* 处理接收到的数据 */
    ProcessCanMessage(&rxHeader, rxData);
}

这里有个小技巧：中断函数里不要做耗时操作。我见过有人直接在中断里做协议解析、数据存储，结果系统响应变慢，丢帧严重。正确的做法是：中断里只做数据搬运，处理逻辑放到任务里。

错误中断也很重要：

void HAL_CAN_ErrorCallback(CAN_HandleTypeDef *hcan)
{
    uint32_t errorCode = HAL_CAN_GetError(hcan);
    
    if (errorCode & HAL_CAN_ERROR_ACK)
    {
        /* 应答错误：总线上可能只有这一个节点 */
        HandleAckError();
    }
    
    if (errorCode & HAL_CAN_ERROR_BOF)
    {
        /* 总线关闭：需要手动恢复 */
        HAL_CAN_Stop(hcan);
        HAL_CAN_Start(hcan);
    }
}

我曾经在一个项目中，总线突然关闭了，但代码里没有做恢复处理。结果整个系统瘫痪，直到看门狗复位才恢复。从那以后，我每个项目都会加上总线关闭的自动恢复逻辑。

核心知识体系

为了让你更直观地理解，我画了一张图：

我的经验之谈：

初始化时，先确认时钟树配置是否正确。我见过有人把CANFD时钟配成了低速时钟，结果速率怎么都上不去。
速率配置时，用示波器实测一下信号质量。理论计算只是第一步，实际波形才是王道。
FIFO和DMA的选择没有绝对好坏。报文少用FIFO，报文多用DMA，就这么简单。
中断处理里，千万不要调用HAL_Delay()。中断里做延时，整个系统都会卡住。

好了，CANFD驱动开发的核心内容就这些。你可能会觉得代码量不大，但每个细节都值得深挖。我当年学的时候，光是时序配置就反复调了一周。但一旦理解了背后的原理，后面就顺了。

记住一句话：CANFD的难点不在代码，而在时序和信号完整性。多动手，多测试，你也能成为CANFD高手。