4. MULTI调试器基础

MULTI 的调试能力建立在“调试会话”这一概念之上。一个调试会话把三样东西绑定在一起：待调试的可执行文件（.elf）、调试后端（目标板上的 gdbserver/Green Hills 探针驱动，或本地模拟器）、以及一组调试配置（连接方式、复位行为、下载策略）。理解这三者的绑定关系，是后续所有断点、单步、变量查看操作能够生效的前提。

下面这张图给出了一次典型 MULTI 调试会话从启动到各调试窗口协同工作的整体结构，重点标出“宿主机侧”与“目标侧”的分工，以及断点、单步、变量、寄存器、内存五类操作分别作用于哪一层。

启动调试会话与连接目标

在 MULTI 中启动调试通常有两种入口：一是通过 Project → Debug 菜单，二是直接运行 multi -debug 命令行并指定工程。无论哪种方式，MULTI 都会读取工程中的调试配置，决定使用哪个后端。对于目标板调试，配置里最关键的是连接方式（例如以太网 IP 与端口、USB 探针序列号、串口设备名）以及复位策略（上电复位、软复位、不复位）。对于模拟器调试，则要指定模拟器型号与内存映射文件。

连接成功的判断依据不是“窗口打开了”，而是调试引擎能够读取到目标状态。一个实用的检查顺序是：先看 MULTI 底部状态栏是否显示 Connected；再在命令窗口执行 info registers，若能返回 PC、SP 等寄存器值，说明通信层与调试代理已正常工作；最后执行 load 或确认镜像已下载，并用 x/4xw 0x00000000 之类的命令读取复位向量区，验证存储器访问通路。若 info registers 超时，问题通常出在连接参数或探针驱动，而不是断点设置。

断点设置：软件断点与硬件断点的选择

MULTI 支持在源码行、函数入口和绝对地址上设置断点。在源码窗口左侧边栏点击即可设置行断点，也可在命令窗口使用 break main.c:42 或 break func_name。断点设置后，MULTI 会尝试将其写入目标。这里有一个容易被忽略的约束：软件断点通过替换指令为断点指令实现，因此只能放在可写的 RAM 代码区；如果代码运行在 Flash 中，软件断点无法直接写入，必须改用硬件断点。

硬件断点依赖 CPU 的断点寄存器，数量有限（常见为 2～8 个）。在 MULTI 中可通过断点属性面板将某个断点标记为硬件断点，或使用命令 hbreak main.c:42。实际调试中建议把硬件断点留给 Flash 中的关键位置，例如启动代码、中断向量入口或只在特定条件下才执行的错误分支，其余断点尽量使用软件断点。条件断点则在此基础上增加表达式判断，例如 break process_data if count > 100，它会在每次到达该位置时由调试引擎求值，只有条件为真才真正停下。

单步执行与变量查看

单步执行分为“步过”（Step Over，不进入被调函数）、“步入”（Step Into，进入被调函数）和“步出”（Step Out，执行完当前函数并返回调用处）。在 MULTI 中分别对应工具栏按钮与命令 next、step、finish。单步时最值得观察的是 PC 的变化与调用栈的深度：步入时调用栈会增加一层，步出时会减少一层。如果单步后 PC 跳到了一个与源码行不对应的地址，通常说明当前执行流进入了没有调试信息的内核或库代码，此时应结合反汇编窗口判断。

变量查看窗口用于观察局部变量、全局变量和表达式。MULTI 的变量窗口支持展开结构体、数组和指针。一个常见问题是变量显示为 <optimized out>，这是因为编译时开启了较高优化等级，变量被寄存器复用或消除。解决办法是在调试构建中使用 -O0 或 -Og，并保留 -g 调试信息。对于指针变量，可以将其拖入内存窗口，直接查看它指向的地址内容。

寄存器与内存窗口的使用

寄存器窗口按组显示 CPU 寄存器，包括通用寄存器、PC、SP 和状态寄存器。调试中断服务程序时，寄存器窗口是判断现场是否正确的第一手依据：例如进入中断后 SP 是否指向预期的栈顶、状态寄存器中的中断屏蔽位是否符合预期。MULTI 允许直接编辑可写寄存器的值，这在构造特定测试场景时很有用，但修改 PC 或 SP 需要格外谨慎，错误的取值会导致程序跑飞。

内存窗口以地址为索引显示原始数据，支持按字节、半字、字以及不同进制显示。使用内存窗口时，地址表达式可以直接写符号名，例如 &buffer 或 0x20000000。一个实用的排查手法是：当变量窗口显示的值可疑时，用内存窗口读取该变量的地址，确认底层存储是否真的被改写。如果内存窗口读取失败，先检查该地址是否属于目标板实际映射的区域，未映射地址的访问会触发总线错误。

把上述操作串起来，一次完整的调试闭环通常是：连接目标并确认寄存器可读 → 在可疑位置设置断点 → 运行至断点 → 用变量窗口和寄存器窗口检查现场 → 单步执行若干条指令观察状态变化 → 必要时用内存窗口核对底层数据 → 修正代码后重新构建并重新加载。MULTI 的调试会话会保持这些窗口的状态，重新加载后断点仍然有效，这能显著减少重复设置的工作量。