单片机与物联网 / 系统课时

通过 R0 至 R15 追踪函数调用

通过 R0 至 R15 追踪函数调用

调试 Cortex-M 裸机程序时,函数参数为什么会出现在 R0,返回地址为什么保存在 LR,执行完函数后 SP 又如何恢复?本课通过一个可编译的 C 与 Thumb 汇编示例,追踪函数调用前后的关键寄存器,学会利用调试器定位参数错误、返回异常和栈问题。

学习目标

  • 识别 R0~R15 的基本职责,区分参数、返回值、栈指针、链接寄存器和程序计数器。
  • 按 Arm AAPCS 调用约定追踪一次函数调用,解释 BL、BX LR 和栈保存操作。
  • 使用 GDB 观察寄存器与栈内存,判断函数调用是否符合预期。

认识 R0 至 R15 的职责

Cortex-M 的基本整数寄存器视图包含 R0~R12,以及具有专门用途的 R13~R15。函数调用遵循 Arm AAPCS(Procedure Call Standard for the Arm Architecture)时,寄存器并非可以随意分配。

寄存器 主要职责 调用约定
R0~R3 前四个整数或指针参数、部分返回值 调用者保存,调用后可能改变
R4~R8 保存需要跨调用保留的数据 被调用者负责恢复
R9 平台相关寄存器 是否作为被调用者保存寄存器取决于平台 ABI
R10~R11 保存需要跨调用保留的数据 被调用者负责恢复
R12 临时寄存器 IP 调用者保存
R13(SP) 当前栈指针 函数返回时恢复调用前的栈状态
R14(LR) 链接寄存器,通常保存返回地址 BL 写入返回地址
R15(PC) 程序计数器 控制下一段执行流程

这里的“调用者保存”不是说调用者必须每次压栈,而是调用者如果还需要旧值,就必须在调用前自行保存。R4~R8、R10~R11 则由使用它们的被调用函数负责保持原值。

例如,函数 add(7, 5) 进入时通常将 7 放入 R0、5 放入 R1,计算结果 12 返回到 R0。返回后不能假设 R1~R3 仍保留调用前的内容。

追踪 BL 指令和返回地址

对于常见的同步函数调用,BL(Branch with Link)负责跳转到目标函数,同时把返回位置写入 LR。被调用函数可以使用 BX LR 返回;如果内部还要调用其他函数,往往需要先保存自己的 LR。

Cortex-M 函数调用时的寄存器与控制流

下面是适用于支持 Thumb-2 的 Cortex-M3/M4/M7 等内核的 GNU 汇编示例。保存为 add.S,使用 GNU Arm Embedded Toolchain 编译;该文件仅定义函数,需由其他代码调用。

asm
.syntax unified
.thumb
.text
.align 2
.global add
.type add, %function
.thumb_func
add:
    adds r0, r0, r1   @ R0 接收两个参数的32位加法结果
    bx lr             @ 使用 LR 返回调用者
.size add, .-add

片段示例依赖调用者按 AAPCS 将参数放入 R0、R1。adds 进行 32 位加法并更新条件标志,若结果超出 32 位则按模 2322^{32} 截断。

假设进入 add 时 R0=7、R1=5、SP=0x20001000,则可以逐步得到:

执行位置 R0 R1 SP LR
进入 add 7 5 0x20001000 调用者返回地址
执行 adds 后 12 5 0x20001000 不变
执行 bx lr 后 12 5 0x20001000 不变

这里的 SP 地址仅用于演示,并非某块开发板的固定值。此函数不访问栈,因此没有必要修改 SP。BX LR 会根据 LR 中的返回地址恢复执行位置;Thumb 状态通常通过地址最低位表示,调试器显示 PC 时可能使用清除该状态位后的指令地址。

观察嵌套调用如何保存 LR 和栈

当 outer 调用 add 时,BL add 会覆盖 outer 原先的 LR。如果 outer 还想返回自己的调用者,就需要在调用前保存原 LR。

下面使用一个完整的 Thumb 汇编函数演示。它接收 R0、R1 两个参数,调用 add 后再给结果加 1。依赖上一节定义的 add 函数,且假设入口 SP 满足 AAPCS 的 8 字节对齐约束。

asm
.syntax unified
.thumb
.text
.align 2
.global outer
.type outer, %function
.thumb_func
outer:
    push {r4, lr}     @ 保存被调用者保存寄存器和返回地址
    bl add            @ R0、R1 作为参数,结果从 R0 返回
    adds r0, r0, #1   @ 将结果加一
    pop {r4, pc}      @ 恢复 R4 并返回 outer 的调用者
.size outer, .-outer

片段示例需要与 add.S 一同链接。这里保存 R4 只是为了构造 8 字节栈帧并演示其恢复规则,函数实际并没有修改 R4;工程中也可根据目标指令集与编译器策略选择其他符合 ABI 的保存方式。

假设调用 outer(7, 5) 时 SP=0x20001000,执行过程如下:

  1. push {r4, lr} 使 SP 减少 8 字节,变为 0x20000FF8,将原 R4 与 LR 保存到栈中。
  2. bl add 覆盖 LR,使其指向 outer 内 bl add 后面的指令位置。
  3. add 返回 R0=12,随后 outer 执行加一操作,令 R0=13。
  4. pop {r4, pc} 恢复 R4,将栈中保存的返回地址装载到 PC,并令 SP 恢复为 0x20001000。

Cortex-M 嵌套函数调用的栈帧与 LR 保存

使用 GDB 实际观察寄存器

使用 Cortex-M3 及兼容目标内核调试时,可以通过 arm-none-eabi-gdb 连接已经启动的 GDB Server。以下命令假设本地 GDB Server 监听 3333 端口,固件 ELF 文件名为 firmware.elf,且 ELF 含有 outer 与 add 符号。

bash
arm-none-eabi-gdb firmware.elf

预期结果:GDB 启动并读取 ELF 的符号信息,进入 (gdb) 提示符;具体启动版权信息因版本而异。

然后在 GDB 内依次执行:

text
(gdb) target extended-remote localhost:3333
(gdb) break outer
(gdb) continue
(gdb) info registers r0 r1 r4 sp lr pc
(gdb) x/4wx $sp
(gdb) disassemble outer
(gdb) stepi
(gdb) info registers sp lr pc

以上为 GDB 命令示例,依赖目标已停止在可继续执行的状态、固件正在运行且会调用 outer。如果当前程序停在复位入口,应先按调试场景启动或复位并运行目标。stepi 一次只执行一条机器指令,因此能精确比较寄存器变化。

预期结果:断点命中 outer 后可以观察传入的 R0、R1。若第一条实际指令是 push {r4, lr},单步后 SP 应减少 8,栈中保存的值可使用 x/2wx $sp 检查。具体 PC、LR 数值由链接地址与实际执行位置决定,不应与演示地址强行对齐。

可继续使用 stepi 跨过 bl add,在 add 入口检查 LR,确认它保存了返回到 outer 后续指令的位置。调试器也支持 info registers 查看全部通用寄存器,以及 bt 查看可解析的调用栈。

根据寄存器异常定位问题

函数返回异常时,先区分参数错误、调用约定违反和栈损坏,避免看到 HardFault 就直接修改中断配置。

观察现象 优先检查 修复方向
函数入口 R0、R1 不符合预期 调用点、参数类型和函数声明 保证调用声明与 ABI 一致
内层函数调用后无法返回外层 调用前 LR 是否保存 非叶子函数正确保存并恢复返回地址
函数返回后 R4 意外变化 被调用函数是否修改 R4 却未恢复 遵守被调用者保存规则
SP 返回后比调用前小 8 字节 PUSH 与 POP 是否配对 修复栈平衡并保持必要对齐
PC 指向无效区域 栈中保存的 LR、函数指针 检查越界写入和异常返回上下文

还要区分普通函数返回与异常返回:中断入口由硬件自动保存部分执行上下文;异常处理程序的 LR 可能包含特殊的 EXC_RETURN 值,而不是普通函数的返回地址。不能直接将这种值按普通代码地址解释。

实际练习可在 outer 入口、add 入口及 outer 返回前分别记录 R0、R1、SP、LR 和 PC。若调用参数为 7、5,正常返回值应为 13,且 outer 返回后 SP 应恢复到调用前的值。只要能解释这五个寄存器在三个位置的变化,就已经具备跟踪大多数简单裸机函数调用的基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

通过 R0 至 R15 追踪函数调用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通