CubeMX CAN 总线配置详细步骤

原创于 2025-12-07 09:12:21 发布 · 742 阅读

12 ·

CC 4.0 BY-SA版权

文章标签：

#STM32 #CubeMX #CAN总线

AI助手已提取文章相关产品：

STM32 CubeMX 配置 CAN 总线：从零开始的实战指南 🛠️

你有没有遇到过这样的情况：手头项目急着联调，CAN 总线却死活收不到数据？示波器看了半天，代码查了一遍又一遍，最后发现——原来是过滤器配错了，或者波特率差了那么一点点。😅

别担心，这几乎是每个嵌入式开发者都会踩的坑。

尤其是当你第一次用 STM32CubeMX 配置 CAN 外设时，面对那堆“Prescaler”、“TS1”、“Filter Scale”之类的术语，简直像在看天书。明明只是想发个 ID 为 0x123 的报文，怎么搞得像是要破解通信协议一样？

今天我们就来 彻底拆解这个过程 ——不讲空话，不套模板，就从一个真实开发者的视角出发，带你一步步把 STM32 的 CAN 控制器从“无法通信”变成“稳定跑通”。🚗💨

为什么选内置 CAN？它真的比外挂芯片香吗？

市面上有不少方案使用 MCP2515 + SPI 来实现 CAN 功能，听起来很灵活。但说实话，在大多数 STM32 项目中， 直接用片上 bxCAN 模块才是更优解 。

为什么？

✅ 成本更低：省掉一颗 IC 和配套电路；
✅ 响应更快：中断响应和 DMA 支持无缝集成；
✅ 开发更简单：CubeMX 几乎帮你搞定所有底层配置；
✅ 资源更少占用：不用再分心处理 SPI 轮询或 FIFO 管理。

更重要的是， ST 提供的 HAL 库已经高度封装了发送/接收逻辑 ，配合 CubeMX 图形化配置，几分钟就能生成可用代码。

当然，如果你要做多路 CAN 或者需要特殊协议支持（比如 CAN FD），那另当别论。但对于绝大多数工业控制、电机驱动、车载节点应用来说， 片内 CAN 完全够用，甚至更好用 。

先搞清楚：STM32 的 CAN 到底是怎么工作的？

很多问题其实源于对硬件机制理解不够深。我们先花两分钟理清几个关键点：

bxCAN 是什么？

STM32 内部的 bxCAN （basic Extended CAN）模块并不是一个简单的 UART 替代品。它是一个完整的 CAN 协议控制器，支持：
- CAN 2.0A（标准帧，11位ID）
- CAN 2.0B（扩展帧，29位ID）
- 最高 1 Mbps 波特率
- 双 FIFO 接收队列（FIFO0/FIFO1）
- 三个发送邮箱（可自动仲裁优先级）
- 28 组可编程过滤器（F1/F4系列）

这意味着你可以同时监听多个设备的消息，并根据 ID 自动分流到不同 FIFO，完全不需要 CPU 主动轮询。

数据是怎么流动的？

想象一下 CAN 总线就像一条高速公路，而你的 MCU 就是路边的一个收费站。

发车（发送） ：你要发消息时，把“车辆”（报文）放进三个“出发车道”（发送邮箱）。一旦总线空闲，控制器会自动抢道发出，按 ID 优先级排队。
收车（接收） ：外面来的消息先经过“入口闸机”（过滤器），只有符合规则的才能进入“停车场”（FIFO0 或 FIFO1）。然后系统告诉你：“有新车到了！”——这就是中断的作用。

所以， 只要过滤器没放行，哪怕总线上跑满了数据，你也什么都收不到 。这也是初学者最常见的“收不到数据”原因。

实战第一步：创建工程 & 启用 CAN

打开 STM32CubeMX，别急着点下一步，先确认一件事：

🔍 你选的芯片到底支不支持 CAN？

常见支持 CAN 的系列包括：
- STM32F1xx（如 F103RCT6）
- STM32F4xx（如 F407VG）
- STM32L4/L5
- STM32H7

以经典的 STM32F407VGT6 为例：

在搜索栏输入型号 → 双击进入引脚图；
找到 CAN1_RX 和 CAN1_TX 引脚（默认可能是 PB8/PB9 或 PA11/PA12）；
点击引脚 → 选择复用功能为 CAN1_RX / CAN1_TX ；
- 或者直接在左侧 Connectivity 栏里把 CAN1 设为 Active。

📌 注意事项：
- 如果要用 CAN2 ，必须先把 CAN1 启用！因为寄存器地址依赖关系决定了这点。
- 不同封装可用引脚不同，务必查手册确认 AF 功能映射。

这时候你会发现，Pinout 图上出现了绿色连线，说明外设已激活 ✅

第二步：设置工作模式 —— 调试阶段千万别用 Normal！

刚上电就想连真实网络？Too young.

建议你在 开发初期一律使用 Loopback 模式 。这是什么意思？

👉 Loopback Mode = 自己发的数据自己能收到 ，相当于“局域网自嗨”，不用接任何物理总线。

好处是什么？
- 可以验证代码逻辑是否正确；
- 不怕干扰其他节点；
- 快速测试过滤器、中断、回调函数能否正常触发。

具体操作：
- 进入 CAN1 Configuration 页面；
- Mode → 选择 Loopback Mode ；
- 后续调试无误后再切回 Normal。

顺带一提，还有几个实用模式：
- Silent Mode ：只听不说，适合监听分析；
- Loopback + Silent ：纯软件仿真，连差分信号都不输出；
- Normal Mode ：正式上线模式，参与总线竞争。

等你确定程序没问题了，再换回去也不迟。

第三步：波特率怎么算？别再手动掰公式了！

这才是最让人头疼的部分。

我们知道，CAN 波特率由 APB1 时钟分频而来，计算公式如下：

$$
\text{Bit Rate} = \frac{PCLK1}{(BRP + 1) \times (TS1 + TS2 + 1)}
$$

其中：
- PCLK1 ：APB1 总线时钟（F4 系列为 HCLK/2，通常为 42MHz 或 45MHz）
- BRP ：预分频系数（Prescaler）
- TS1 ：时间片段1（传播段 + 相位缓冲段1）
- TS2 ：时间片段2（相位缓冲段2）
- SJW ：同步跳转宽度（一般设为 1）

🎯 目标：配置成 1 Mbps

假设 PCLK1 = 42 MHz，代入试试：

42,000,000 / ((BRP+1)*(TS1+TS2+1)) = 1,000,000
=> (BRP+1)*(TS1+TS2+1) = 42

找一组整数解：
- BRP = 5 → 分母需为 7 → TS1+TS2+1=7 → 比如 TS1=5, TS2=1

但这样采样点位置可能偏移。理想情况下， 采样点应在 bit 时间的 75%~85% 区间内 才稳定。

与其手动试错，不如……

✅ 绝招：让 CubeMX 自动帮你算！

在 Bit Timing 区域点击 “ Calculate ” 按钮，输入目标波特率（比如 1000 kbps），工具会自动推荐一组合理参数！

而且它还会显示：
- 实际波特率（Actual Bit Rate）
- 重同步跳转宽度（SJW）
- 采样点百分比（Sample Point %）

例如：

参数	值
Prescaler (BRP)	4
Time Segment 1	6 TQ
Time Segment 2	1 TQ
SJW	1 TQ

计算得：
$$
\frac{42\,MHz}{(4+1)\times(6+1+1)} = \frac{42M}{5 \times 8} = 1.05\,Mbps
$$

接近但略高。如果主频是 45MHz，则 BRP=9, TS1=5, TS2=2 正好得到 1 Mbps。

💡 小技巧：若实际波特率偏差 < ±1%，通常仍可通信；超过则可能导致误码。

第四步：过滤器配置 —— 90% 的“收不到数据”都出在这！

这是我见过最多人栽跟头的地方。

很多人以为：“我开了 CAN，接了线，应该啥都能收到。” 错！🚫

所有进入 FIFO 的数据都要先过过滤器这一关 。就像机场安检，不符合条件的一律拦下。

两种模式怎么选？

STM32 提供两种过滤方式：

模式	特点	适用场景
Mask Mode（掩码模式）	一对“ID + Mask”，灵活匹配范围	多 ID 接收、动态过滤
List Mode（列表模式）	列出允许通过的具体 ID	固定少数 ID，精确控制

对于新手，推荐先用 32-bit Mask Mode ，配置简单直观。

场景实战：只想接收标准帧 ID = 0x123 的报文

目标：仅接收 StdId 为 0x123 的数据帧。

配置步骤：

Filter Bank = 0（编号从 0 开始）
Filter Mode = Mask Mode
Filter Scale = 32-bit
FIFO Assignment = FIFO 0
Activation = Enable

接下来填两个关键寄存器：

❓ Filter ID High/Low 怎么算？

标准帧 ID 是 11 位，存在高位，低 21 位补 0。

所以：
- 0x123 << 21 = 0x12300000
- 拆分为：
- High: 0x1230 （高 16 位）
- Low: 0x0000 （低 16 位）

但在 CubeMX 中， 不需要手动左移 ！GUI 会自动处理格式。

更常见的做法是直接填写原始 ID 值，让工具转换。

❓ Mask 怎么设？

Mask 决定了哪些位必须匹配。

我们要精确匹配 0x123 ，所以 mask 应该让高 11 位有效，其余忽略。

即：
- Mask ID = 0x7FF << 21 → 表示前 11 位参与比较
- 拆分为：
- High: 0x7FF0
- Low: 0x0000

最终配置如下：

参数	值
Filter ID High	0x1230
Filter ID Low	0x0000
Filter Mask ID High	0x7FF0
Filter Mask ID Low	0x0000

✅ 效果：只有 ID 为 0x123 的标准帧能进入 FIFO0。

如果你想接收多个 ID（比如 0x123 , 0x124 , 0x125 ），可以用更大的 mask，例如只固定前 9 位。

自动生成的初始化代码长什么样？

CubeMX 最爽的地方就是——你点几下鼠标，它给你生成完整初始化代码。

static void MX_CAN1_Init(void)
{
    hcan1.Instance = CAN1;
    hcan1.Init.Prescaler = 4;
    hcan1.Init.Mode = CAN_MODE_LOOPBACK;  // 调试用
    hcan1.Init.SyncJumpWidth = CAN_SJW_1TQ;
    hcan1.Init.TimeSeg1 = CAN_BS1_6TQ;
    hcan1.Init.TimeSeg2 = CAN_BS2_1TQ;
    hcan1.Init.TimeTriggeredMode = DISABLE;
    hcan1.Init.AutoBusOff = ENABLE;
    hcan1.Init.AutoWakeUp = DISABLE;
    hcan1.Init.AutoRetransmission = ENABLE;
    hcan1.Init.ReceiveFifoLocked = DISABLE;
    hcan1.Init.TransmitFifoPriority = DISABLE;

    if (HAL_CAN_Init(&hcan1) != HAL_OK)
    {
        Error_Handler();
    }
}

这段代码干了啥？
- 设置了波特率相关参数（来自 GUI 配置）；
- 启用了自动重传（AutoRetransmission），避免单次错误导致失败；
- 开启 AutoBusOff 恢复，防止总线异常后锁死；
- 使用默认优先级策略。

⚠️ 注意： HAL_CAN_Init() 内部会调用 MspInit() ，你需要确保在那里完成了 GPIO 和时钟使能：

void HAL_CAN_MspInit(CAN_HandleTypeDef* hcan)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    /* 使能时钟 */
    __HAL_RCC_CAN1_CLK_ENABLE();
    __HAL_RCC_GPIOB_CLK_ENABLE();

    /**CAN1 GPIO Configuration    
    PB8     ------> CAN1_RX
    PB9     ------> CAN1_TX 
    */
    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);
}

这部分也可以由 CubeMX 自动生成，记得勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”。

中断怎么加？别再轮询了！

Polling（轮询）是最容易想到的方式，但效率极低。

正确的做法是： 开启接收中断，来了数据再处理 。

如何启用中断？

回到 CubeMX → NVIC Settings 标签页；
勾选：
- CAN1 RX0 interrupt → FIFO0 有数据时触发
- CAN1 RX1 interrupt → FIFO1 触发（可选）
- CAN1 TX interrupt → 发送完成通知（用于确认）

保存后生成代码，中断向量表会自动注册。

编写回调函数

在用户代码中添加：

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)
    {
        // 成功读取一帧数据
        switch (rxHeader.StdId)
        {
            case 0x123:
                // 处理命令帧
                break;
            case 0x200:
                // 处理状态反馈
                break;
            default:
                break;
        }
    }
}

📌 关键点：
- 回调函数名不能错！必须是 HAL_CAN_RxFifo0MsgPendingCallback ；
- 必须调用 HAL_CAN_GetRxMessage() 清除 FIFO，否则中断会反复触发；
- 可结合 FreeRTOS 发送消息队列，避免在中断中做复杂运算。

实际组网时要注意什么？这些坑我都替你踩过了 💣

现在你已经能在 loopback 下跑通代码了，下一步就是接入真实总线。

别急，先看看这几个经典问题：

🔴 问题1：一切正常，但就是收不到外部数据？

排查清单：
- ✅ 是否启用了正确的过滤器？检查 ID 和 Mask 是否匹配；
- ✅ 波特率是否和其他节点一致？差一点都会丢包；
- ✅ 物理连接是否可靠？CAN_H/CAN_L 是否反接？
- ✅ 终端电阻有没有？ 总线两端各加一个 120Ω 电阻 ，否则信号反射严重；
- ✅ 收发器供电是否正常？常见如 TJA1050、SN65HVD230。

🔧 工具建议：用 USB-CAN 适配器（如 ZLG USBCAN-I）发测试帧，辅助定位问题。

🔴 问题2：运行一会儿突然“Bus-Off”？

现象： HAL_CAN_GetState() 返回 HAL_CAN_STATE_BUS_OFF ，再也发不了数据。

原因： 错误计数器累计超标 ，控制器自我保护关闭了总线访问。

常见诱因：
- 电磁干扰强（工业现场常见）；
- 某个节点持续发送错误帧（硬件故障）；
- 波特率不准导致频繁 CRC 校验失败。

✅ 解决办法：
- 启用 AutoBusOff 和 AutoWakeUp ，允许自动恢复；
- 在主循环中检测状态，必要时重启 CAN：

if (HAL_CAN_GetState(&hcan1) == HAL_CAN_STATE_BUS_OFF)
{
    HAL_CAN_Stop(&hcan1);
    HAL_CAN_Start(&hcan1);
    HAL_CAN_ActivateNotification(&hcan1, CAN_IT_RX_FIFO0_MSG_PENDING);
}