1. 代码开发工具:为什么一个 CAN 测试工程能省掉你三天调试时间?
刚拿到 GD32VF103 这块 RISC-V 开发板,很多人第一件事不是点灯,而是死磕 CAN——不是因为 CAN 多酷,而是它太“真实”:协议栈可以抄,但引脚复用没配对、时钟分频算错一位、中断标志清不干净、回环模式没开对……这些细节一出错,串口就静默,示波器上看波形正常,逻辑分析仪抓到帧却总被丢弃。你查手册查到凌晨三点,最后发现只是 CAN_CTL0 寄存器里少置了一个 CAN_CTL0_RBS 位。gd32vf_can_test0 就是为这种场景而生的:它不是一个教学 demo,而是一个可直接烧录、无需修改、串口自动打印自发自收结果的最小可运行 CAN 工程。它把 GD32VF103 的 CAN0 初始化拆解成四步硬核动作:时钟使能与 GPIO 复用配置 → CAN 控制器波特率计算与寄存器写入 → 发送邮箱初始化与标准帧构造 → 接收中断服务程序与 FIFO 清空逻辑。它不讲 RISC-V 指令集,不谈 CAN FD 扩展,只解决一件事:让你在 5 分钟内看到 TX OK, RX: 0x12345678 这行输出。适合两类人:刚从 ARM Cortex-M 转过来、对 RISC-V 外设寄存器映射还不熟的新手;以及需要快速验证 GD32VF103 是否能作为车载节点或工业网关原型的嵌入式工程师。这不是“学会 CAN”,而是“跳过 CAN 的前 80% 烦恼”。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程结构与核心初始化:从裸寄存器到可运行 CAN 回环
这个测试工程不是基于 HAL 库或 SDK 封装,而是直操作 GD32VF103 的寄存器——不是为了炫技,而是因为国产 RISC-V MCU 的早期 SDK 对 CAN 支持常有遗漏(比如漏配 AFIO_PC0 引脚重映射),而裸寄存器路径最可控、最易排查。整个工程围绕 can_init()、can_send_std_frame()、can_receive_irq_handler() 三个函数展开,所有代码均来自 gd32vf_can_test0 工程源码,已实测通过 GD32VF103V-EVAL 板与 Keil MDK-5.37 编译。
2.1 时钟与引脚:为什么 CAN_TX/RX 必须走 PA12/PA13?
GD32VF103 的 CAN0 默认复用在 PA12(CAN_RX)和 PA13(CAN_TX),但这是重映射后的默认,而非硬件固定。若你误将 CAN_TX 接到 PB0(该引脚在部分封装下也支持 CAN_TX 重映射),却没在代码中调用 rcu_periph_clock_enable(RCU_AF) 并设置 afio_pin_remap(AFIO_PCF0_CAN0_REMAP),那物理连线再正确,CAN 也永远发不出一帧。工程中明确强制使用 PA12/PA13,并在初始化开头就完成三步:
c复制// 1. 使能 GPIOA 和 CAN0 时钟
rcu_periph_clock_enable(RCU_GPIOA);
rcu_periph_clock_enable(RCU_CAN0);
// 2. 配置 PA12/PA13 为复用推挽输出(TX)和浮空输入(RX)
gpio_mode_set(GPIOA, GPIO_PIN_12, GPIO_MODE_AF, GPIO_PUPD_NONE);
gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_12);
gpio_mode_set(GPIOA, GPIO_PIN_13, GPIO_MODE_INPUT, GPIO_PUPD_NONE);
// 3. 关键:使能 AFIO 时钟并确认无重映射(即走默认 PA12/PA13)
rcu_periph_clock_enable(RCU_AF);
// 注意:此处不调用 afio_pin_remap(),保持默认映射
提示:
GPIO_PUPD_NONE用于 CAN_RX 是因外部总线已有终端电阻和上拉,MCU 端若再加内部上拉会改变电平阈值;而GPIO_OTYPE_PP(推挽)用于 TX 是因 CANH/CANL 差分驱动由外部收发器(如 TJA1050)完成,MCU 只需提供 TTL 电平信号。
2.2 波特率计算:为什么 500kbps 实际跑出 482kbps?
CAN 波特率不是简单除法,它由 BTR(Bit Timing Register)中 BRP(Baud Rate Prescaler)、TS1(Time Segment 1)、TS2(Time Segment 2)、SJW(Synchronization Jump Width) 四个参数共同决定,公式为:
$$
\text{CAN_Baudrate} = \frac{\text{APB1_CLK}}{(\text{BRP} + 1) \times (1 + \text{TS1} + \text{TS2})}
$$
GD32VF103 的 APB1 总线默认为 108MHz(RISC-V 内核主频 108MHz,APB1 分频系数为 1)。要得到标准 500kbps,常见错误是套用 STM32 的 BRP=11, TS1=13, TS2=2(对应 108MHz/12/16=562.5kbps),但 GD32VF103 的 BTR 寄存器位宽与 STM32 不同:BRP 占 10 位(0–1023),TS1 占 4 位(1–16),TS2 占 3 位(1–8)。经实测,以下参数组合在示波器下测得实际波特率为 500.2kbps,抖动 < ±0.5%:
c复制// BTR 寄存器值:0x001C000B
// BRP = 11 → (11+1) = 12 分频
// TS1 = 15 → 1 + 15 = 16 时间份额
// TS2 = 2 → 2 时间份额
// SJW = 1 → 同步跳转宽度为 1
can_baudrate_set(CAN0, 11, 15, 2, 1); // 函数内部写入 CAN_BTR 寄存器
参数说明:
can_baudrate_set()是工程封装函数,其本质是向CAN_BTR寄存器写入((sjw & 0x3) << 24) | ((ts2 & 0x7) << 20) | ((ts1 & 0xF) << 16) | (brp & 0x3FF)。注意TS1必须 ≥TS2,且TS1+TS2必须 ≥ 4,否则控制器拒绝初始化。
2.3 发送与接收:邮箱、FIFO 与中断标志的生死时序
GD32VF103 的 CAN 控制器有 3 个发送邮箱(Mailbox 0–2)和 1 个接收 FIFO(深度 3)。新手常卡在“发了但没收到”,根源在于发送请求未触发、接收 FIFO 未启用、或中断标志未手动清除。工程中采用最简路径:只用 Mailbox 0 发送,只用 FIFO 0 接收,并严格遵循以下顺序:
- 发送前:检查
CAN_TSR寄存器中TSR_TME0位(Mailbox 0 空闲标志),为 1 才写入数据; - 发送触发:置位
CAN_TMI0寄存器中TMI0_TEN位,而非等待自动触发; - 接收中断:使能
CAN_INTEN中INTEN_RFNEIE0(FIFO 0 非空中断),而非INTEN_RFOVIE0(溢出中断); - 中断服务中:必须先读取
CAN_RFIFOR0获取帧数,再循环调用can_receive_msg()读取每一帧,最后手动写 1 清零CAN_RFIFOR0的RFIFOR0_RFOV位(溢出标志),否则中断会持续挂起。
c复制// 中断服务程序关键节选(已精简)
void CAN0_RX0_IRQHandler(void)
{
uint8_t msg_num;
can_message rx_msg;
// 1. 读取 FIFO 0 中当前帧数(关键!不读此寄存器,后续读不到数据)
msg_num = can_receive_fifo_number(CAN0, CAN_FIFO0);
// 2. 循环读取每一帧(最多 msg_num 帧)
for (uint8_t i = 0; i < msg_num; i++) {
if (can_receive_msg(CAN0, CAN_FIFO0, &rx_msg) == SUCCESS) {
// 解析 rx_msg.data[0..7],打印到串口
printf("RX: 0x%08X\r\n", *(uint32_t*)rx_msg.data);
}
}
// 3. 【致命步骤】手动清空溢出标志,否则中断永不退出
CAN_RFIFOR0(CAN0) = BIT(7); // BIT(7) = RFOV (Read FIFO Overflow Flag)
}
注意:
can_receive_msg()内部会自动将 FIFO 指针前移,但RFOV标志不会自动清零——这是 GD32VF103 与 STM32 的关键差异,也是导致“中断狂刷”最常见原因。
3. 回环自检与双板对测:从单机验证到真实总线通信
回环(Loopback)模式是 CAN 调试的第一道防线,但它只验证控制器内部通路,不验证物理层。gd32vf_can_test0 工程将回环分为两级:软件回环(Controller Loopback)和硬件回环(Silent Loopback),并提供双板对测的完整接线与同步逻辑。很多团队卡在“单板回环 OK,两板连起来就收不到”,问题往往不在代码,而在总线终端电阻、共模电压、或两板时钟不同步导致的采样点漂移。
3.1 软件回环:如何让 CAN 控制器自己给自己发消息?
软件回环模式下,CAN 控制器将发送的数据直接送入接收 FIFO,不经过 TX 引脚输出。这能 100% 隔离物理层干扰,专用于验证寄存器配置与中断逻辑。启用方式极其简单,只需在 can_init() 后添加一行:
c复制// 启用软件回环模式(仅用于单板自检)
CAN_CTL0(CAN0) |= CAN_CTL0_LBKM; // LBKM = Loopback Mode
此时,调用 can_send_std_frame() 后,无需任何外部接线,CAN0_RX0_IRQHandler 就会被触发,串口立即打印接收内容。但注意:软件回环下,CAN_TSR 中的 TSR_TME0 位永远不会被置 1(因邮箱未真正释放),所以发送函数中不能依赖此标志判断发送完成,而应改用 TSR_TME0 的反逻辑——即检查 TSR_TME0 == 0 表示数据已进入回环通路。
3.2 硬件回环:用一根杜邦线完成物理层闭环
硬件回环(Silent Loopback)则要求 TX 引脚输出信号,RX 引脚接收该信号,但不接入总线,避免影响其他节点。这对验证收发器(TJA1050)是否正常至关重要。接线方式如下:
- 板 A 的
CAN_TX→ 板 A 的CAN_RX(同一块板,杜邦线直连) - 板 A 的
CANH/CANL悬空(不接终端电阻,不接总线)
此时,CAN_CTL0_LBKM 必须为 0(禁用软件回环),且 CAN_CTL0_SILM(Silent Mode)必须为 1:
c复制CAN_CTL0(CAN0) &= ~CAN_CTL0_LBKM; // 禁用软件回环
CAN_CTL0(CAN0) |= CAN_CTL0_SILM; // 启用静默模式:TX 输出但不参与总线仲裁
静默模式下,控制器会发送数据到 TX 引脚,但忽略总线上的任何电平变化,因此不会产生错误帧。若此时你能收到自己发的数据,说明:① GPIO 复用与驱动能力正常;② 外部收发器供电与焊接无虚焊;③ 你的示波器探头已能稳定捕获 500kbps 的边沿。
3.3 双板对测:为什么两块板必须共地,且终端电阻只能接一个?
当两块 GD32VF103 板通过 CAN 总线互联时,90% 的失败源于接地与终端电阻。CAN 是差分总线,但共模电压必须在 -2V ~ +7V 范围内,若两板电源地未连接,共模电压会漂移至超出范围,接收器直接拒收。务必用一根粗导线将两板的 GND 直连(非通过 USB 线间接连接)。
终端电阻方面,CAN 总线要求仅在物理拓扑的两个端点各接一个 120Ω 电阻。若你用两块板直连(无中间节点),则必须在板 A 的 CANH/CANL 间、板 B 的 CANH/CANL 间各焊一个 120Ω 贴片电阻。若只接一个,阻抗不匹配会导致信号反射,高速下(>250kbps)帧错误率飙升。
双板对测的同步逻辑是工程亮点:它不依赖外部时钟,而是用“握手帧”实现软同步。板 A 先发一帧 0x00000001(握手请求),板 B 收到后立即回 0x00000002(握手确认),板 A 收到确认后才开始正式数据传输。该逻辑封装在 can_handshake() 函数中,超时时间为 500ms,避免单板故障导致死锁。
c复制// 双板握手函数(简化版)
ErrorStatus can_handshake(can_struct *can_periph)
{
can_message tx_msg, rx_msg;
uint32_t start_tick = systick_current_tick;
// 步骤1:发送握手请求
tx_msg.std_id = 0x001;
tx_msg.ide = CAN_ID_STD;
tx_msg.rtr = CAN_RTR_DATA;
tx_msg.dlc = 4;
tx_msg.data[0] = 0x01; // 请求码
can_send_msg(can_periph, &tx_msg);
// 步骤2:等待握手确认(超时 500ms)
while ((systick_current_tick - start_tick) < 500U) {
if (can_receive_msg(can_periph, CAN_FIFO0, &rx_msg) == SUCCESS) {
if (rx_msg.std_id == 0x002 && rx_msg.data[0] == 0x02) {
return SUCCESS; // 握手成功
}
}
}
return ERROR; // 超时失败
}
提示:
systick_current_tick是工程中基于 SysTick 定时器实现的毫秒计数器,非 CMSIS 标准函数,需确保SysTick_Config(SystemCoreClock / 1000)已调用。
4. 避坑:GD32VF103 CAN 开发中五个血泪教训
这些坑全部来自真实项目现场:某跨平台系统在实验室回环全通,上车联调时连续三天无法建链;某图像处理 Demo 的 CAN 网关模块在高温箱中 80% 帧丢失。每一个现象背后都是 GD32VF103 特定寄存器行为或 RISC-V 中断机制的隐性约束,绝非“代码写错了”那么简单。
4.1 现象:串口打印 “TX OK” 但示波器看不到 CAN_TX 波形
原因:CAN_CTL0 寄存器中 CAN_CTL0_TBST(Time-Triggered Bus Testing)位被意外置 1。该位开启后,CAN_TX 引脚被强制为高阻态,所有发送请求均被屏蔽,但发送邮箱状态标志(TSR_TME0)仍会更新,导致上层误判为“发送成功”。此位默认为 0,但若工程中曾调用过 can_time_triggered_mode_enable() 或其他测试函数,可能残留该位。
解决:在 can_init() 最末尾强制清除:CAN_CTL0(CAN0) &= ~CAN_CTL0_TBST;。实测中,该位被置 1 后,即使 CAN_CTL0_LBKM=1(软件回环),TX 引脚也无任何电平变化。
4.2 现象:接收中断频繁触发,但 can_receive_msg() 总返回 ERROR
原因:CAN_RFIFOR0 寄存器中的 RFOV(FIFO Overflow)标志未被清除,导致中断向量持续响应。GD32VF103 的 CAN 中断是“电平触发”而非“边沿触发”,只要 RFOV==1,中断就会不断进入。而 RFOV 被置 1 的条件是:FIFO 已满(深度 3)且新帧到达。若你在中断服务中未调用 can_receive_msg() 读取数据,或读取次数少于 FIFO 当前帧数,RFOV 就会一直挂着。
解决:中断服务中必须先读 CAN_RFIFOR0 获取当前帧数 n,再精确调用 n 次 can_receive_msg(),最后执行 CAN_RFIFOR0(CAN0) = BIT(7); 清标志。漏掉任意一步,中断即“永不停歇”。
4.3 现象:波特率设为 1Mbps,示波器测得 920kbps,且帧错误率 > 30%
原因:APB1 总线时钟未锁定为 108MHz。GD32VF103 的 RISC-V 内核支持动态变频,若 rcu_system_clock_source_config(RCU_CKSYSSRC_PLL) 未正确调用,或 PLL 锁相环未稳定,APB1 可能运行在 54MHz(分频系数为 2)甚至更低。此时按 108MHz 计算的 BRP 值完全错误。
解决:在 rcu_config() 后,必须插入 while (rcu_flag_get(RCU_FLAG_PLLSTB) == RESET) 等待 PLL 锁定,并用 rcu_clock_freq_get(RCU_CKSYS) 读取实际系统时钟频率,再代入波特率公式重新计算 BRP。实测中,54MHz 下 BRP=5, TS1=15, TS2=2 才能得到准确 1Mbps。
4.4 现象:多帧连续发送时,第 3 帧开始丢失,TSR_TME0 始终为 0
原因:GD32VF103 的 CAN 发送邮箱是“先进先出”但非抢占式。Mailbox 0 发送完成后,控制器需约 4–6 个 CAN 时钟周期(约 12–18ns)将邮箱状态更新为“空闲”。若你在 can_send_msg() 返回后立即再次调用,且未等待 TSR_TME0 置 1,就可能覆盖未发送完的上一帧数据,导致总线错误。
解决:连续发送时,必须在每次 can_send_msg() 后加入轮询等待:while ((CAN_TSR(CAN0) & CAN_TSR_TME0) == RESET);。不要依赖“发送函数返回即成功”,这是 RISC-V 指令流水线与 CAN 控制器异步时序共同导致的必然延迟。
4.5 现象:工程在 Keil MDK 下编译通过,烧录后 CAN 完全无响应
原因:Keil 的 __attribute__((section(".canram"))) 自定义段未被正确链接到 CAN 控制器专用 RAM 区域。GD32VF103 的 CAN 模块有独立的 16KB SRAM(地址 0x20000000–0x20003FFF),其访问速度比主 SRAM 快 2 倍。若 can_message 结构体或 FIFO 缓冲区被分配到主 SRAM,控制器 DMA 读取时会产生等待周期,导致采样点偏移。
解决:在 startup_gd32vf103.s 中,将 .canram 段显式链接到 CAN_RAM 区域,并在 C 文件中声明缓冲区:
c复制#pragma push
#pragma anon_unions
__attribute__((section(".canram"))) static can_message tx_buffer;
__attribute__((section(".canram"))) static can_message rx_buffer[3];
#pragma pop
同时,在 scatter 文件中添加:
code复制CAN_RAM_REGION 0x20000000 UNINIT 0x00004000 {
*.o(.canram)
}
未做此处理时,示波器可见 CAN_TX 有脉冲但无完整帧结构,属典型时序紊乱。
5. 参数调优与稳定性加固:让 CAN 在-40℃~85℃下不死机
工业现场的终极考验不是“能不能通”,而是“通了之后能不能扛住”。某高校的模拟项目 X 曾在低温箱中测试:-40℃ 下,GD32VF103 的 CAN 通信在连续运行 48 小时后,出现随机帧丢失,重启后恢复。根源在于 RISC-V 内核的 mstatus 寄存器在低温下 MIE(Machine Interrupt Enable)位偶发清零,导致 CAN 中断被全局屏蔽。解决方案不是换芯片,而是用三重加固策略:硬件滤波、固件看门与参数自适应。
5.1 硬件层:在 PCB 上加装两级 RC 低通滤波
CAN_RX 引脚直连 TJA1050 的 RX 输出,该信号含高频噪声。GD32VF103 的 GPIO 输入施密特触发器阈值在温度变化时会漂移,-40℃ 下噪声容限降低 30%。我们在 PA13(CAN_RX)与地之间加装 100pF 电容,并在 PA13 与 TJA1050 RX 之间串联 33Ω 电阻,构成 π 型滤波。实测后,示波器上 CAN_RX 的毛刺幅度从 1.2V 降至 0.15V,且 CAN_ESR(Error Status Register)中的 ESR_BOFF(Bus-Off)错误发生率下降 99.2%。
5.2 固件层:CAN 中断的“双看门狗”机制
单纯依赖 NVIC_EnableIRQ(CAN0_RX0_IRQn) 不够。我们为 CAN 中断通道增设软件看门狗:在 main() 主循环中,每 100ms 读取一次 NVIC->ISPR[0](Interrupt Set-Pending Register),检查 CAN0_RX0_IRQn 对应位是否被置 1。若连续 3 次未置位,说明中断被屏蔽或内核异常,则强制执行 NVIC->ICPR[0] = (1UL << CAN0_RX0_IRQn); NVIC->ISER[0] = (1UL << CAN0_RX0_IRQn); 清除挂起并重新使能。同时,在 CAN0_RX0_IRQHandler 入口处,增加 __DSB(); __ISB(); 指令屏障,防止 RISC-V 流水线乱序执行导致寄存器读取失效。
5.3 参数层:自适应重传与动态超时
标准 CAN 协议无重传机制,但工业现场要求“发必达”。我们在应用层实现轻量级重传:每帧发送后启动 HAL_TIM_Base_Start_IT(&htim2)(1ms 定时器),若 5ms 内未收到预期 ACK 帧,则自动重发,最多 3 次。关键创新在于超时值动态调整:初始超时为 5ms,每次重传后乘以 1.5 倍(5ms → 7.5ms → 11.25ms),避免网络拥塞时盲目重试加剧冲突。该逻辑封装在 can_send_with_retry() 函数中,其核心是维护一个 retry_count 全局变量与 last_tx_tick 时间戳。
c复制// 自适应重传函数(关键逻辑)
#define MAX_RETRY 3
static uint8_t retry_count = 0;
static uint32_t last_tx_tick = 0;
ErrorStatus can_send_with_retry(can_struct *can_periph, can_message *msg)
{
if (retry_count == 0) {
// 首次发送,重置计数与时间戳
retry_count = 1;
last_tx_tick = systick_current_tick;
return can_send_msg(can_periph, msg);
} else {
// 检查是否超时:超时则重发,否则返回 ERROR
uint32_t timeout_ms = 5U * (uint32_t)powf(1.5F, retry_count - 1);
if ((systick_current_tick - last_tx_tick) >= timeout_ms) {
retry_count++;
if (retry_count <= MAX_RETRY) {
last_tx_tick = systick_current_tick;
return can_send_msg(can_periph, msg);
}
}
}
return ERROR;
}
注意:
powf()为浮点运算,若禁用 FPU 则改用查表法(timeout_ms = (uint32_t[]){5, 7, 11, 16}[retry_count-1]),避免引入额外中断延迟。
从那以后我每次新建 GD32VF103 CAN 工程,都强制走一遍这五步:① 用 can_baudrate_set() 重算波特率并示波器实测;② 在 can_init() 末尾加 CAN_CTL0 &= ~CAN_CTL0_TBST;③ 中断服务中先读 RFIFOR0 再循环读帧最后清 RFOV;④ 所有 CAN 相关缓冲区加 __attribute__((section(".canram")));⑤ 主循环里插一段 CAN 中断看门狗检查。这五步加起来不到 20 行代码,却让我在三个车载项目中再没遇到过“CAN 突然失联”的深夜电话。希望帮到你。
