STM32F103 CAN总线调试实战：从实例代码到避坑指南

简介这份资源面向嵌入式开发初学者与需要快速上手CAN通信的工程师提供基于STM32F103系列微控制器的CAN实例代码帮助解决从CAN控制器配置到收发调试的入门难题。压缩包共81个文件约280KB以28个c源文件与30个h头文件为主体配合12个s启动文件及工程配置类文件覆盖应用层、CMSIS与标准外设库等目录结构完整可直接导入Keil工程。内容涉及CAN1/CAN2控制器初始化、波特率与滤波器寄存器配置、发送接收邮箱操作、中断回调及错误状态查询等关键环节读者可对照代码理解差分总线物理层、数据帧格式与HAL库API调用方式并在此基础上调试自己的CAN节点。目前已有2876人学习下载适合作为工业控制、汽车电子等场景下CAN通信实践的参考起点。1. 拿到一份 STM32F103 CAN 实例代码先别急着烧录CAN 总线调试最磨人的地方在于代码编译通过、板子上电、示波器看波形也正常但收发就是不通最后发现是终端电阻没接、波特率算错一个分频或者过滤器掩码把帧全挡了。这份 STM32F103 CAN 实例代码的价值就在这儿——它把 bxCAN 外设的初始化、过滤器配置、收发中断和回环自测串成一条能跑通的链路省去你从寄存器手册第 600 页开始啃的时间。适合手里有 F103 板子、要接车载或工控 CAN 节点、又不想在标准库和 HAL 之间反复试错的从业者。下面按「代码怎么组织、参数怎么定、坑在哪」拆开讲新手能照着改熟手能直接对参数边界。2. 拆开代码包bxCAN 初始化与过滤器配置的真实结构2.1 先看清这份实例的模块划分拿到代码包别一头扎进 main.c。F103 的 CAN 实例通常按「硬件抽象层 业务层」两层组织先摸清文件职责改起来才不会牵一发动全身。常见结构是一个 can.c/can.h 负责外设时钟、GPIO 复用、位时序和过滤器一个中断服务文件处理 RX0/RX1 和发送完成回调main 里只做初始化和一个最小收发循环。我一般会先看 can.h 里暴露了哪些函数——如果只有CAN_Init()一个入口说明过滤器是写死的接多节点时大概率要改如果拆出了CAN_FilterConfig()和CAN_SendMsg()说明作者考虑过复用这种包更值得留。以标准外设库版本为例核心初始化大致长这样HAL 版本逻辑等价、函数名不同/* can.c —— F103 bxCAN 初始化骨架标准库风格 */ void CAN_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; CAN_InitTypeDef CAN_InitStructure; CAN_FilterInitTypeDef CAN_FilterInitStructure; /* 1. 时钟CAN 挂在 APB1GPIO 挂在 APB2 */ RCC_APB1PeriphClockCmd(RCC_APB1Periph_CAN1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); /* 2. PA11CAN_RX 上拉输入PA12CAN_TX 复用推挽 */ GPIO_InitStructure.GPIO_Pin GPIO_Pin_11; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_12; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); /* 3. 位时序36MHz APB1500kbps采样点约 87.5% */ CAN_InitStructure.CAN_TTCM DISABLE; CAN_InitStructure.CAN_ABOM ENABLE; /* 自动离线恢复调试期必开 */ CAN_InitStructure.CAN_AWUM DISABLE; CAN_InitStructure.CAN_NART DISABLE; /* 允许自动重传 */ CAN_InitStructure.CAN_RFLM DISABLE; CAN_InitStructure.CAN_TXFP DISABLE; CAN_InitStructure.CAN_Mode CAN_Mode_Normal; CAN_InitStructure.CAN_SJW CAN_SJW_1tq; CAN_InitStructure.CAN_BS1 CAN_BS1_12tq; CAN_InitStructure.CAN_BS2 CAN_BS2_2tq; CAN_InitStructure.CAN_Prescaler 4; /* 36M / (1122) / 4 500k */ CAN_Init(CAN1, CAN_InitStructure); /* 4. 过滤器16 位掩码模式只放行 ID0x123 */ CAN_FilterInitStructure.CAN_FilterNumber 0; CAN_FilterInitStructure.CAN_FilterMode CAN_FilterMode_IdMask; CAN_FilterInitStructure.CAN_FilterScale CAN_FilterScale_16bit; CAN_FilterInitStructure.CAN_FilterIdHigh 0x123 5; CAN_FilterInitStructure.CAN_FilterIdLow 0x0000; CAN_FilterInitStructure.CAN_FilterMaskIdHigh 0xFFE0; CAN_FilterInitStructure.CAN_FilterMaskIdLow 0x0000; CAN_FilterInitStructure.CAN_FilterFIFOAssignment CAN_Filter_FIFO0; CAN_FilterInitStructure.CAN_FilterActivation ENABLE; CAN_FilterInit(CAN1, CAN_FilterInitStructure); }这段代码里最容易被忽略的是第 3 步的位时序和第 4 步的过滤器。位时序决定波特率算错一个 tq 就整条总线失步过滤器决定哪些帧能进 FIFO配错就是「发送正常、接收永远空」。参数含义后面两节展开这里先记住CAN_Prescaler是分频BS1BS2SJW决定一个位占多少 tq三者共同锁死波特率。2.2 位时序参数怎么算别照抄分频值F103 的 CAN 时钟来自 APB1默认 36MHz系统 72MHz 二分频。一个 CAN 位被拆成若干时间份额 tq公式是波特率 APB1时钟 / (Prescaler × (1 BS1 BS2))上面代码里 Prescaler4、BS112、BS22代入 36M/(4×15)600k不对是 36M/(4×15)600k这里就翻车了——正确写法应是 36M/(4×(1122))36M/60600k。要 500k 得让分母等于 72比如 Prescaler4、BS112、BS251125184×1872或者 Prescaler6、BS19、BS22。这就是血泪经验网上抄来的分频值经常和你的 APB1 时钟对不上必须自己代公式验算。采样点位置同样关键。CAN 规范建议采样点在位的 75%~87.5% 之间计算公式是(1BS1)/(1BS1BS2)。BS112、BS22 时采样点在 13/15≈86.7%偏晚但可接受如果 BS2 取太小、采样点逼近 90% 以上长线缆下容易误采样。我一般把目标定在 80%~85%BS1 取大、BS2 取 2~3 个 tqSJW 保持 1tq 用于时钟容差补偿。改完参数别只看编译通过拿示波器量一位宽度500k 对应 2μs量出来偏差超过 2% 就回去查分频。2.3 过滤器掩码模式和列表模式别混用F103 有 14 组过滤器每组可配成 16 位或 32 位、掩码或列表模式。实例代码默认多半是「16 位掩码、只收一个 ID」够跑通但不够用。掩码模式的逻辑是(收到的ID Mask) (FilterId Mask)Mask 里为 1 的位参与比较为 0 的位不关心。想收 0x120~0x12F 这一段就把低 4 位掩码置 0/* 收 0x120~0x12F高 11 位固定低 4 位不关心 */ CAN_FilterInitStructure.CAN_FilterIdHigh (0x120 5); CAN_FilterInitStructure.CAN_FilterMaskIdHigh (0xFFF0 5) 0xFFFF;注意 16 位模式下 ID 要左移 5 位对齐到寄存器高位这是标准库和 HAL 都一样的坑漏了移位就会「明明 ID 对却收不到」。列表模式则相反每个过滤器寄存器存一个精确 ID适合只关心几个固定报文的场景但数量受 14 组限制。选型上节点多、ID 连续用掩码ID 离散、数量少用列表。改过滤器后一定要清一次 FIFO 再使能否则残留帧会干扰判断。3. 收发链路跑通中断、回环与总线电平三道关3.1 发送与接收中断的最小闭环初始化过了不代表能收发。实例代码里通常有CAN_Transmit()和 RX 中断回调但很多人卡在「发了没反应、收了进不去中断」。先确认 NVIC 里开了USB_LP_CAN1_RX0_IRQnF103 的 CAN RX0 和 USB 共用中断向量名字容易看漏再确认CAN_ITConfig(CAN1, CAN_IT_FMP0, ENABLE)使能了 FIFO0 非空中断。发送侧建议先轮询邮箱状态再发避免三个邮箱全满时静默丢帧/* 发送一帧标准数据帧ID0x1238 字节 */ uint8_t CAN_SendStd(uint32_t id, uint8_t *data, uint8_t len) { CanTxMsg tx; tx.StdId id; tx.ExtId 0; tx.IDE CAN_Id_Standard; tx.RTR CAN_RTR_Data; tx.DLC len; for (uint8_t i 0; i len; i) tx.Data[i] data[i]; uint8_t box CAN_Transmit(CAN1, tx); /* 返回使用的邮箱号CAN_TxStatus_NoMailBox 表示满 */ if (box CAN_TxStatus_NoMailBox) return 1; uint32_t t0 0; while (CAN_TransmitStatus(CAN1, box) ! CAN_TxStatus_Ok) { if (t0 0xFFFFF) return 2; /* 超时保护别死等 */ } return 0; }接收中断里别做重活只把CAN_Receive()取出的帧塞进环形缓冲主循环再解析。中断里直接跑协议解析是另一个常见翻车点解析耗时超过下一帧到达间隔FIFO 溢出标志 OVR 置位之后所有帧都丢现象是「跑几分钟就断」。环形缓冲深度按总线负载估500k 满载时一秒约 4000 帧缓冲给 64~128 帧足够。3.2 先用回环模式自测再上真实总线板子单独调试时最省事的验证是回环模式CAN_Mode_LoopBack下发送的帧不经过收发器直接内部回环到接收过滤器能验证「位时序 过滤器 中断」整条软件链路排除硬件接线干扰。步骤是把CAN_InitStructure.CAN_Mode改成CAN_Mode_LoopBack发一帧 ID0x123看 RX 中断是否收到同样内容。收到说明软件链路通收不到就查过滤器和中断使能别去怀疑收发器。回环通过后切CAN_Mode_Normal接上收发器如 TJA1050 一类和另一节点。这时要量总线电平CAN_H 与 CAN_L 之间隐性态约 2.5V 附近、显性态差分约 2V两端各接 120Ω 终端电阻总线总阻值约 60Ω。只接一端电阻、或者节点多了没加电阻现象是「短距离能通、线一长就误码」。我习惯上电先用万用表量 CAN_H-CAN_L 阻值60Ω 左右才继续往下调。3.3 波特率与终端电阻的联合排查表收发不稳时按下面顺序过一遍比盲目改代码快检查项正常值/现象异常时的典型表现APB1 时钟36MHz72M 系统波特率整体偏移所有节点失步位时序分母Prescaler×(1BS1BS2) 匹配目标示波器位宽偏差 2%采样点75%~87.5%长线缆偶发误帧终端电阻总线约 60Ω短距通、长距断过滤器掩码目标 ID 能通过发送正常、接收恒空FIFO 溢出OVR 不置位跑一段时间后全丢帧这张表是我调试时的固定动作尤其「发送正常、接收恒空」这一条九成是过滤器 ID 没左移或掩码写反先查这里再查别的。4. 避坑清单五个让 CAN 调试原地打转的常见问题4.1 现象编译通过、发送无报错但总线上量不到波形原因多半是 GPIO 复用没配对。F103 的 CAN 默认走 PA11/PA12但这两个脚同时是 USB 引脚如果工程里开了 USB 时钟或重映射没关引脚会被抢。解决确认RCC_APB2PeriphClockCmd只开了 GPIOA检查有没有误开RCC_APB1Periph_USB并用GPIO_PinRemapConfig确认没有把 CAN 重映射到 PB8/PB9 却没改接线。改完重新上电量波形别只信编译结果。4.2 现象回环模式能收正常模式收不到原因通常是收发器供电或使能脚没拉对。很多收发器模块有 STB/EN 引脚悬空时处于待机总线呈隐性但不转发。解决查模块原理图把使能脚拉到有效电平量收发器 VCC 是否 5V/3.3V 正常再量 TX 脚在发送瞬间有没有跳变。这一步翻车最多因为代码完全正确问题全在板子外面。4.3 现象跑几分钟后接收中断再也不进原因是 FIFO 溢出后没清 OVR 标志。F103 的 RX FIFO 溢出时 OVR 置位若中断里只读帧不清标志后续帧继续丢。解决在 RX0 中断里判断CAN_GetFlagStatus(CAN1, CAN_FLAG_FOV0)置位时先CAN_ClearFlag再继续同时检查主循环解析是否太慢。血泪经验是中断里只搬数据、不解析把重活挪出去。4.4 现象多节点组网时随机丢帧单节点正常原因是波特率容差叠加或终端电阻缺失。每个节点的晶振误差、位时序采样点不一致单对单能容忍多节点就暴露。解决统一各节点位时序参数尤其采样点总线两端各 120Ω中间节点不接电阻用示波器看显性位宽度是否一致。别用「能通就行」的心态放过随机丢帧在量产里就是黑匣子。4.5 现象改了过滤器后完全收不到改回去也不行原因是过滤器激活顺序或 FIFO 残留。F103 要求先配过滤器再使能且改配置前最好进初始化模式。解决把CAN_FilterInit()放在CAN_Init()之后、使能中断之前改完调一次CAN_ClearFlag清 FIFO若仍不行把CAN_FilterActivation先 DISABLE 再 ENABLE 走一遍。这个坑隐蔽在于「看起来改了没生效」其实是旧配置还在寄存器里。5. 进阶把实例代码改成可复用的 CAN 收发框架实例代码跑通只是起点真正落地要把它变成能接多 ID、能统计错误、能自恢复的框架。我的做法是抽三层底层can_driver只管初始化和裸收发中间can_router按 ID 分发到回调上层业务注册回调。过滤器改成掩码收一段 ID 区间RX 中断里按 ID 查表调对应函数表项用静态数组避免动态内存。错误处理上开CAN_IT_ERR中断在回调里读CAN_GetLastErrorCode()遇到被动错误或总线关闭就触发重初始化——CAN_ABOM虽然能自动恢复但恢复后位时序和过滤器状态建议重走一遍别赌它。验证方法我固定用三步先回环自测软件链路再双节点对发压测连续发 10 万帧统计丢帧率最后接真实总线跑一晚看 OVR 和错误计数。压测脚本可以简单到主循环里for循环发递增值接收端比对序号丢一帧记一次。下面这段是分发骨架改 ID 表就能复用/* can_router.c —— 按标准 ID 分发表驱动无动态内存 */ typedef void (*can_handler_t)(uint8_t *data, uint8_t len); typedef struct { uint16_t id; can_handler_t handler; } can_route_t; static const can_route_t route_table[] { {0x123, on_motor_status}, {0x124, on_sensor_data}, /* 新增报文只加一行不动中断逻辑 */ }; void CAN_RX0_IRQHandler(void) { CanRxMsg rx; if (CAN_GetITStatus(CAN1, CAN_IT_FMP0) ! RESET) { CAN_Receive(CAN1, CAN_FIFO0, rx); for (uint8_t i 0; i sizeof(route_table)/sizeof(route_table[0]); i) { if (route_table[i].id rx.StdId) { route_table[i].handler(rx.Data, rx.DLC); break; } } CAN_ClearITPendingBit(CAN1, CAN_IT_FMP0); } }表驱动的好处是新增报文不改中断坏处是 ID 多了线性查找变慢超过 32 个 ID 就换二分或哈希。参数上注意rx.DLC最大 8别越界读回调里别阻塞耗时操作打标记回主循环。从那以后我每次拿到新的 CAN 实例代码都强制先跑回环、再量终端电阻、最后压测丢帧率三步不过不接真实总线。希望帮到你。本文还有配套的精品资源点击获取