Step to UEFI (94）Source Level Debug

直接进行 Source Level的 Debug 对于学习过是非常有用，本文就介绍一下如何在 NT32Pkg的模拟环境下进行 Source Level Debug 的方法。使用的环境是 Windows7 + UDK2015+VS2013。调试的目标是 UDK2015 AppPkg 自带的 Hello。

在 Hello.INF 中加入下面的编译参数：

[BuildOptions]
MSFT:DEBUG_*_IA32_DLINK_FLAGS = /EXPORT:InitializeDriver=$(IMAGE_ENTRY_POINT) /ALIGN:4096 /FILEALIGN:4096 /SUBSYSTEM:CONSOLE

 

此外，在代码中加入_asm int 3 ，当编译器遇到这个命令时，会自动停止准备调试

INTN
EFIAPI
ShellAppMain (
  IN UINTN Argc,
  IN CHAR16 **Argv
  )
{
  _asm int 3  
  Print(L"Hello there fellow Programmer.\n");
  Print(L"Welcome to the world of EDK II.\n");

  return(0);
}

 

上述修改完成后，正常编译

Build –a IA32 –p AppPkg\AppPkg.dsc

编译完成之后，在NT32 模拟环境中运行 hello.efi, 会出现下面的错误信息，选择使用 VS2013 调试

然后就可以看到带着源码的调试界面了

我试验了一下，感觉还不错。

一般情况下BIOS工程师不会进行源码级别的调试，最直接的原因是：这样的调试过于复杂，必须额外的硬件支持，要么需要 AMI Debugger ，要么需要 XDP 之类的高级工具，单纯的准备就需要花费很多时间。

自从有了UEFI 的架构，串口 Debug 信息是 BIOS 工程师最忠实的伙伴。

【注释】：本文根据《UEFI 原理与编程》一书 P59 3.4 调试 UEFI 写成。只是这本书上给出来的方法我试验并不好用，疑惑之间搜索到了该书作者在他的Blog上提到这个问题，试验之后完全没有问题：

http://www.cppblog.com/djxzh/archive/2015/02/08/209766.html
“书中讲到了如何利用_asm int 3 调试代码。
_asm int 3需要配合Nt32Pkg使用。也就是说通过Nt32Pkg编译出的.efi文件才能够调试。
如果你带_asm int 3语句的工程是通过非Nt32Pkg编译出来的（例如AppPkg），在SecMain模拟器中调试会导致断点停在Image.c文件如下代码中
Image->Status = Image->EntryPoint (ImageHandle, Image->Info.SystemTable);
在模拟器控制台会输出
WARNING: No source level debug
表明SecMain在加载你的模块时没有成功加载调试符号。
解决方案
在.inf文件中添加如下代码
[BuildOptions]
MSFT:DEBUG_*_IA32_DLINK_FLAGS = /EXPORT:InitializeDriver=$(IMAGE_ENTRY_POINT) /ALIGN:4096 /FILEALIGN:4096 /SUBSYSTEM:CONSOLE
“