← 全部文章 · 2026-11-15

RISC-V MCU GDB 调试技巧总结

整理 RISC-V MCU 上用 GDB 调异常、断点、寄存器与死机现场的一套实操命令和排查套路。

技术笔记最后修订:2026-11-15约 6 分钟

基础调试命令

PC寄存器操作

# 查看当前PC寄存器值
(gdb) i r pc

# 手动设置PC寄存器(跳过当前指令)
(gdb) set $pc=$pc+2    # RISC-V压缩指令为2字节
(gdb) set $pc=$pc+4    # 标准RISC-V指令为4字节

异常调试

# 查看异常返回地址寄存器
(gdb) i r mepc
mepc           0x10000340    268436288

# 查看异常发生位置的内存内容
(gdb) x /64x 0x10000340

# 查看其他重要的CSR寄存器
(gdb) i r mcause    # 异常原因
(gdb) i r mstatus   # 机器状态寄存器
(gdb) i r mtval     # 异常值寄存器

断点和控制技巧

代码内断点

// 在代码中强制停止执行
asm volatile ("jal .\n");   // 无限循环,等待调试器介入
// 介入后,执行 set $pc=$pc+2,即可往下执行到jal 的下一条指令
//+2是因为这条指令是16位,需要跳过2个字节到下一条指令,不+2就会永远停在这条指令,如果是用break断点,就不需要

条件断点

# 设置条件断点
(gdb) break *0x10000340 if $a0 == 0x123

# 在函数入口设置断点
(gdb) break main
(gdb) break function_name

界面和显示

GDB TUI界面

# 切换调试窗口布局
(gdb) layout next
(gdb) layout prev

# 具体布局选项
(gdb) layout src     # 源码窗口
(gdb) layout asm     # 汇编窗口
(gdb) layout split   # 源码+汇编
(gdb) layout regs    # 寄存器窗口

# 刷新窗口
(gdb) refresh

RISC-V特有的调试技巧

寄存器查看

# 查看所有通用寄存器
(gdb) i r

# 查看特定寄存器组
(gdb) i r a0-a7      # 函数参数寄存器
(gdb) i r s0-s11     # 保存寄存器
(gdb) i r t0-t6      # 临时寄存器

# 查看CSR寄存器
(gdb) i r all        # 显示所有寄存器包括CSR

内存操作

# 查看内存内容(不同格式)
(gdb) x/64x 0x10000340    # 十六进制格式
(gdb) x/32w 0x10000340    # 32位字格式
(gdb) x/16i 0x10000340    # 指令格式

# 修改内存内容
(gdb) set {int}0x10000340 = 0x12345678

栈回溯

# 显示调用栈
(gdb) bt
(gdb) where

# 显示详细栈信息
(gdb) bt full

# 切换栈帧
(gdb) frame 0
(gdb) up
(gdb) down

RISC-V 内核特有优化技巧

性能分析

# 单步执行(适合分析性能关键路径)
(gdb) stepi    # 单步执行一条机器指令
(gdb) nexti    # 执行下一条指令(不进入函数)

# 查看汇编代码优化
(gdb) disas main
(gdb) disas /m main    # 混合显示源码和汇编

中断和异常调试

# 设置异常处理断点
(gdb) break trap_handler
(gdb) break exception_handler

# 查看中断向量表
(gdb) x/32x 0x0    # 假设中断向量表在地址0

低功耗调试

# 查看睡眠相关寄存器
(gdb) i r mie      # 中断使能寄存器
(gdb) i r mip      # 中断挂起寄存器

# 在WFI指令处设置断点
(gdb) break *address_of_wfi_instruction

常见问题和解决方案

结合编译生成的汇编文件 firmware.asm 分析

  • 并且注意某些代码是在flash上进行xip,某些代码是在sram上,一个函数的调用链路应该尽量全部整条链路的代码都存储在同一个存储介质上
  • 看是否有指令错位或者某些变更,如果有,说明可能sram 电压不稳,导致电平跳变

调试步骤

主动断点

asm volatile ("jal .\n"); // 无限循环,等待调试器介入 启动 Debugger Server riscv64-unknown-elf-gdb output/firmware.elf开始调试

死机调试

死机现场直接开Debugger Server 然后gdb,看是否能介入

勘误与修订记录

  1. 2026-11-15:由 Obsidian 导入

公众号与视频里的版本不跟随修订,最新版永远在本页。