📚 课程目录第3章 CANFD控制器配置实战（以STM32H7为例）

3、CANFD控制器配置实战（以STM32H7为例）：FDCAN外设初始化、时钟配置、滤波器设置、中断配置

好，咱们直接进入正题。STM32H7 系列用的 FDCAN 外设，和传统的 bxCAN 差别不小。说白了，FDCAN 是 Bosch 的 M_CAN 内核，功能更强，但配置也更绕。我刚开始从 bxCAN 切到 FDCAN 时，也踩过几个坑。今天就把这些经验掰开揉碎，讲清楚。

3.1 FDCAN 外设初始化流程

初始化 FDCAN，我习惯按这个顺序来：

时钟使能 —— 先让 FDCAN 模块和对应的 RAM 跑起来。
GPIO 配置 —— 把 TX/RX 脚配到正确的复用功能上。
FDCAN 参数初始化 —— 设置波特率、协议参数、工作模式。
滤波器配置 —— 决定哪些报文能进 FIFO。
中断配置 —— 使能接收、错误、状态变化等中断。
启动 FDCAN —— 进入运行状态。

嗯，这里要注意：顺序不能乱。尤其是滤波器和中断，必须在 FDCAN 退出初始化模式之前配好。我曾经在项目里先启动了 FDCAN 再配滤波器，结果前几帧报文全丢了，排查了半天。

3.2 时钟配置

FDCAN 的时钟源，在 H7 上有两个选择：

FDCAN1/2 共用 PLL1Q —— 通常配到 80MHz 或 100MHz。
FDCAN3 独立时钟 —— 可以用 PLL2Q 或外部时钟。

我个人习惯把 FDCAN 时钟统一配到 80MHz。为什么？因为 80MHz 下，时间量子（tq）是 12.5ns，算波特率时整数倍好配，不容易出现采样点偏差。

看一段 CubeMX 生成的时钟配置代码：

// 使能 FDCAN 时钟
__HAL_RCC_FDCAN_CLK_ENABLE();

// 配置时钟源为 PLL1Q，80MHz
RCC->D2CCIP2R |= RCC_D2CCIP2R_FDCANSEL_0;  // 选择 PLL1Q
// 确保 PLL1Q 输出 80MHz（具体配置在 SystemClock_Config 中）

你想想看，如果时钟源没配好，后面所有波特率计算都是错的。我遇到过一位同事，FDCAN 怎么都通不了，最后发现是 PLL1Q 输出只有 40MHz，他按 80MHz 算的波特率，差了一倍。

⚠ 时钟配置避坑：

FDCAN 时钟必须 ≤ 100MHz（H7 规格上限）。
如果同时用 FDCAN1 和 FDCAN2，它们共享同一个时钟源。
修改时钟后，务必用 HAL_RCC_GetPCLK1Freq() 确认实际频率。

3.3 波特率与位时序配置

FDCAN 的波特率由三部分组成：同步段 + 传播段 + 相位缓冲段1 + 相位缓冲段2。和传统 CAN 不同的是，FDCAN 支持 数据段加速（BRS），仲裁段和数据段可以用不同的波特率。

我常用的配置是：

仲裁段：500kbps，采样点 87.5%
数据段：2Mbps，采样点 75%

为什么这么配？仲裁段要兼容传统 CAN 节点，采样点靠后一点抗干扰好。数据段只在高信噪比的网络里用，采样点可以提前，留更多时间给收发器切换。

看代码：

hfdcan1.Instance = FDCAN1;
hfdcan1.Init.FrameFormat = FDCAN_FRAME_FD_BRS;  // 启用 BRS
hfdcan1.Init.Mode = FDCAN_MODE_NORMAL;

// 仲裁段：500kbps，80MHz 时钟
hfdcan1.Init.NominalPrescaler = 2;   // 预分频
hfdcan1.Init.NominalSyncJumpWidth = 1;
hfdcan1.Init.NominalTimeSeg1 = 79;   // TSEG1 = 79 tq
hfdcan1.Init.NominalTimeSeg2 = 20;   // TSEG2 = 20 tq
// 总 tq = 1 + 79 + 20 = 100，tq = 25ns，波特率 = 1/(100*25ns) = 400kbps？
// 等等，这里有问题！

  💡 经验之谈：
  上面这段代码是我故意写错的。实际计算时，同步段固定为 1 tq，TSEG1 包含传播段和相位缓冲段1。正确的公式是：

  波特率 = 时钟频率 / (预分频 × (1 + TSEG1 + TSEG2))

  所以 80MHz / (2 × (1 + 79 + 20)) = 80M / 200 = 400kbps，不是 500k。要配 500k，得把 TSEG1+TSEG2 调到 79 才行。

我建议你直接用 CubeMX 的图形化工具算，算好了再抄到代码里。手动算容易翻车，我翻过不止一次。

3.4 滤波器设置

FDCAN 的滤波器比传统 CAN 灵活得多。它支持：

经典滤波器：ID 掩码模式，和 bxCAN 类似。
扩展滤波器：支持 11 位和 29 位 ID 混合过滤。
范围滤波器：可以设一个 ID 范围，比如只收 0x100~0x1FF。

我项目中用得最多的是 扩展滤波器 + 列表模式。把需要接收的 ID 列个表，简单粗暴，不容易漏。

配置代码示例：

FDCAN_FilterTypeDef sFilterConfig;

sFilterConfig.IdType = FDCAN_FILTER_STANDARD;       // 11 位 ID
sFilterConfig.FilterIndex = 0;                       // 滤波器 0
sFilterConfig.FilterType = FDCAN_FILTER_MASK;        // 掩码模式
sFilterConfig.FilterConfig = FDCAN_FILTER_TO_RXFIFO0; // 匹配的帧进 FIFO0
sFilterConfig.FilterID1 = 0x321;                     // 期望 ID
sFilterConfig.FilterID2 = 0x7FF;                     // 掩码（全匹配）

HAL_FDCAN_ConfigFilter(&hfdcan1, &sFilterConfig);

嗯，这里有个细节：FilterID2 在掩码模式下是掩码，0x7FF 表示全匹配，0x000 表示通配。我见过有人把 FilterID2 当成了第二个 ID 来用，结果滤波器怎么配都不对。

🔧 实用技巧： FDCAN 有 28 个专用滤波器（0~27），每个都可以独立配置。我习惯把高优先级 ID 放在小索引的滤波器里，因为硬件会按索引顺序匹配，匹配到第一个就停止。

3.5 中断配置

FDCAN 的中断系统比传统 CAN 复杂不少。它把中断分成了几类：

中断类型	标志位	典型用途
接收 FIFO 0/1 新消息	RF0N / RF1N	收到报文后读取
发送完成	TC	确认发送成功
错误警告	EW	总线错误计数超限
总线关闭	BO	节点离线，需要恢复
协议错误	PED / PEA	格式错误、位错误等

我通常只开 接收中断 和 错误中断。发送完成用轮询或 DMA，因为发送频率不高，没必要进中断。

中断配置代码：

// 使能接收中断（FIFO0 新消息）
HAL_FDCAN_ActivateNotification(&hfdcan1, FDCAN_IT_RX_FIFO0_NEW_MESSAGE, 0);

// 使能错误中断
HAL_FDCAN_ActivateNotification(&hfdcan1, FDCAN_IT_BUS_OFF | FDCAN_IT_ERROR_WARNING, 0);

// 配置 NVIC
HAL_NVIC_SetPriority(FDCAN1_IT0_IRQn, 5, 0);
HAL_NVIC_EnableIRQ(FDCAN1_IT0_IRQn);

中断服务函数里，我习惯先读状态寄存器，再清标志，最后处理数据。顺序错了容易丢中断。

void FDCAN1_IT0_IRQHandler(void)
{
    // 检查是否是接收中断
    if (HAL_FDCAN_GetRxFifoFillLevel(&hfdcan1, FDCAN_RX_FIFO0) > 0)
    {
        HAL_FDCAN_GetRxMessage(&hfdcan1, FDCAN_RX_FIFO0, &rxHeader, rxData);
        // 处理接收到的报文
        ProcessCanMessage(&rxHeader, rxData);
    }

    // 检查是否是总线关闭
    if (__HAL_FDCAN_GET_FLAG(&hfdcan1, FDCAN_FLAG_BUS_OFF))
    {
        __HAL_FDCAN_CLEAR_FLAG(&hfdcan1, FDCAN_FLAG_BUS_OFF);
        // 执行总线恢复流程
        HAL_FDCAN_Stop(&hfdcan1);
        HAL_Delay(10);
        HAL_FDCAN_Start(&hfdcan1);
    }
}

⚠ 中断优先级注意： FDCAN 中断有两条线：IT0 和 IT1。IT0 处理接收和状态变化，IT1 处理发送完成。如果两个中断都用，要分别配优先级。我建议把 IT0 优先级设高，因为接收报文不能丢。

3.6 完整初始化流程总结

把上面所有步骤串起来，一个完整的 FDCAN 初始化函数大概长这样：

void FDCAN_Init(void)
{
    // 1. 时钟使能
    __HAL_RCC_FDCAN_CLK_ENABLE();

    // 2. GPIO 配置（PB8=TX, PB9=RX）
    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = GPIO_PIN_8 | GPIO_PIN_9;
    gpio.Mode = GPIO_MODE_AF_PP;
    gpio.Pull = GPIO_NOPULL;
    gpio.Speed = GPIO_SPEED_FREQ_HIGH;
    gpio.Alternate = GPIO_AF9_FDCAN1;
    HAL_GPIO_Init(GPIOB, &gpio);

    // 3. FDCAN 参数初始化
    hfdcan1.Instance = FDCAN1;
    hfdcan1.Init.FrameFormat = FDCAN_FRAME_FD_BRS;
    hfdcan1.Init.Mode = FDCAN_MODE_NORMAL;
    hfdcan1.Init.NominalPrescaler = 1;
    hfdcan1.Init.NominalSyncJumpWidth = 1;
    hfdcan1.Init.NominalTimeSeg1 = 79;
    hfdcan1.Init.NominalTimeSeg2 = 20;
    hfdcan1.Init.DataPrescaler = 1;
    hfdcan1.Init.DataSyncJumpWidth = 1;
    hfdcan1.Init.DataTimeSeg1 = 19;
    hfdcan1.Init.DataTimeSeg2 = 10;
    HAL_FDCAN_Init(&hfdcan1);

    // 4. 配置滤波器
    FDCAN_FilterTypeDef filter;
    filter.IdType = FDCAN_FILTER_STANDARD;
    filter.FilterIndex = 0;
    filter.FilterType = FDCAN_FILTER_MASK;
    filter.FilterConfig = FDCAN_FILTER_TO_RXFIFO0;
    filter.FilterID1 = 0x321;
    filter.FilterID2 = 0x7FF;
    HAL_FDCAN_ConfigFilter(&hfdcan1, &filter);

    // 5. 使能中断
    HAL_FDCAN_ActivateNotification(&hfdcan1, FDCAN_IT_RX_FIFO0_NEW_MESSAGE, 0);
    HAL_NVIC_SetPriority(FDCAN1_IT0_IRQn, 5, 0);
    HAL_NVIC_EnableIRQ(FDCAN1_IT0_IRQn);

    // 6. 启动 FDCAN
    HAL_FDCAN_Start(&hfdcan1);
}

这段代码我实际用过，在 H743 上跑过 500k/2M 的混合速率，稳得很。你直接复制过去，改一下 GPIO 脚位和滤波器 ID 就能用。

3.7 FDCAN 初始化流程结构图

下面这张图把整个初始化流程串起来了，方便你对照代码看：

这张图里，我把仲裁段和数据段的波特率配置单独拆出来了。你实际写代码时，这两个参数都在 HAL_FDCAN_Init() 的结构体里一起配，但理解上要分开想。

好了，FDCAN 控制器配置的核心内容就这些。时钟、波特率、滤波器、中断，四个模块环环相扣。你只要按这个流程走，基本不会出大问题。如果调试时发现收不到报文，先查时钟频率对不对，再看滤波器掩码有没有写反——这两个坑我替你们踩过了。