【UEFI】Windows下调试UEFI程序

已于 2024-04-16 14:12:03 修改
阅读量1.7k 收藏 37
点赞数 48
分类专栏： UEFI 文章标签： windows
于 2023-12-17 20:02:36 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ZuoYiranSky/article/details/135048631
版权

本文的调试代码均以C:\UEFIWorkspace\edk2\MdeModulePkg\Application\HelloWorld\为例

1 Windows下的调试方法

1.1 使用Visual Studio 2019进行调试

主逻辑：

① 在VS2019中新建Makefile工程

② 设置工程文件的目标路径

③ 修改工程文件的配置参数

④ 添加需要调试的代码

⑤ 编译代码并调试

1.1.1 新建Makefile工程

1.1.2 设置目标路径

我放在C:\UEFIWorkspace\edk2\MdeModulePkg\Application\HelloWorld\下

下方的needtomodfiy是在1.3节里会被修改的，可以直接理解成占位符。

注：上方的工作目录需要格外注意两点：第一，尽量使用绝对路径；第二，地址后的'\'不能省略。

1.1.3 修改工程文件

找到Win32和X64下的NMakeBuildCommandLine、NMakeCleanCommandLine和NMakeReBuildCommandLine，把needtomodify部分按照如下修改：

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">

    <NMakeBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b DEBUG

    </NMakeBuildCommandLine>

    <NMakeOutput>test.exe</NMakeOutput>

    <NMakeCleanCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b DEBUG clean

    </NMakeCleanCommandLine>

    <NMakeReBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b DEBUG clean

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b DEBUG

    </NMakeReBuildCommandLine>

    <NMakePreprocessorDefinitions>WIN32;_DEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>

  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">

    <NMakeBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b RELEASE

    </NMakeBuildCommandLine>

    <NMakeOutput>test.exe</NMakeOutput>

    <NMakeCleanCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b RELEASE clean

    </NMakeCleanCommandLine>

    <NMakeReBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b RELEASE clean

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32 -b RELEASE

    </NMakeReBuildCommandLine>

    <NMakePreprocessorDefinitions>WIN32;NDEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>

  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|X64'">

    <NMakeBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b DEBUG

    </NMakeBuildCommandLine>

    <NMakeOutput>test.exe</NMakeOutput>

    <NMakeCleanCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b DEBUG clean

    </NMakeCleanCommandLine>

    <NMakeReBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b DEBUG clean

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b DEBUG

    </NMakeReBuildCommandLine>

    <NMakePreprocessorDefinitions>X64;_DEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>

  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|X64'">

    <NMakeBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b RELEASE

    </NMakeBuildCommandLine>

    <NMakeOutput>test.exe</NMakeOutput>

    <NMakeCleanCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b RELEASE clean

    </NMakeCleanCommandLine>

    <NMakeReBuildCommandLine>

      cd /D C:\UEFIWorkspace

      set WORKSPACE=C:\UEFIWorkspace

      call mybuild.bat

      call edk2\edksetup.bat

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b RELEASE clean

      call build.bat -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64 -b RELEASE

    </NMakeReBuildCommandLine>

    <NMakePreprocessorDefinitions>X64;NDEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>

  </PropertyGroup>

1.1.4 添加代码

添加HelloWorld.c到Source下

1.1.5 编译代码并调试

在代码处增加一处断点用于调试

F5开始编译并调试，过程中注意观察log

1.2 使用WINDBG进行调试

主逻辑：

① 安装WINDBG、QEMU、Intel UDK Debugger Tool、OSFMount、UltralSO

② 创建QEMU虚拟硬盘

③ 编译OVMF镜像文件和HelloWorld.efi

④ 调试

1.2.1 安装必要工具

1.2.1.1 WINDBG

我使用的WINDBG版本是6.12.0002.633，这个部分在最开始就装好，因为后续在安装Intel UDK Debugger Tool的时候会检测WINDBG是否存在，否则会无法安装。

1.2.1.2 QEMU

我使用的QEMU版本是0.13.0，记得要把QEMU的实际安装地址编写进环境变量里。

1.2.1.3 Intel UDK Debugger Tool

Install地址不要修改，保持默认！

设置Channel的时候要宣称Pipe，Port自定义为QemuPipeDbg。

1.2.1.4 OSFMount、UltralSO

我使用的OSFMount版本是3.1

我使用的UltralSO版本是9.7.6.3829

1.2.2 创建QEMU虚拟硬盘

1.2.2.1 打开UltralSO创建硬盘镜像

镜像大小根据自己的需要设定，我选择设定为512MB，然后将镜像另存为HDD_BOOT.IMA

1.2.2.2 打开OSFMount挂载虚拟硬盘并导入调试程序

挂载完毕如上，此时在我的电脑下会出现一个新的硬盘，盘符为HDD_BOOT。

1.2.3 编译OVMF镜像文件和HelloWorld.efi(使用x86/64 Native Tools Command Prompt for VS 2019)

1.2.3.1 编译OVMF镜像文件

基于OVMF镜像镜像源码级调试，编译edk2\OvmfPkg。

32位：

C:\UEFIWorkspace>build -p edk2\OvmfPkg\OvmfPkgIA32.dsc -t VS2019 -a IA32 -b NOOPT -D SOURCE_DEBUG_ENABLE

64位：

C:\UEFIWorkspace>build -p edk2\OvmfPkg\OvmfPkgX64.dsc -t VS2019 -a X64 -b NOOPT -D SOURCE_DEBUG_ENABLE

1.2.3.2 编译HelloWorld.efi

32位：

C:\UEFIWorkspace>build -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a IA32

64位：

C:\UEFIWorkspace>build -p edk2\MdeModulePkg\MdeModulePkg.dsc -m edk2\MdeModulePkg\Application\HelloWorld\HelloWorld.inf -t VS2019 -a X64

1.2.4 调试

1.2.4.1 文件准备

在UEFIWorkspace下新建一个文件夹并命名为QemuDebug。

将32位或者64位的OVMF.fd复制到QemuDebug文件夹下。

将32位或者64位的HelloWorld.efi复制到HDD_BOOT的盘符下，然后将HDD_BOOT.IMA复制到QemuDebug文件夹下，想偷懒的话可以直接将HDD_BOOT.IMA在1.2.2.1节中的另存为默认地址放置在QemuDebug文件夹下，这样就不需要再手动的搬移HDD_BOOT.IMA，做完这一步以后，把HDD_BOOT弹出，否则会在下面正式调试的时候报错。

从QEMU的根目录下复制qemu-x86_64.bat到QemuDebug文件夹下，并修改这个批处理文件如下：

即，注释掉最后一行，并添加新的命令，其中QemuPipeDbg要与1.2.1.3节中设置Pipe Port名称match：

C:\UEFIWorkspace\Tools\QEMU\qemu-system-x86_64.exe -bios OVMF.fd -usbdevice disk:HDD_BOOT.IMA -serial pipe:QemuPipeDbg

至此，文件准备完毕，QemuDebug文件夹下将会存在以下三个文件：

1.2.4.2 开始调试

运行Start WinDbg with Intel UDK Debugger Tool，UDK Debugger和WINDBG会一起弹出，如下：

打开CMD，cd到C:\UEFIWorkspace\QemuDebug\下，并运行qemu-x86_64.bat：

此时，QEMU的窗口已经弹出，WINDBG也会很快connected并进入第一个断点，此时在command bar中输入g，用于继续运行，等待QEMU进入UEFI SHELL：

为了要对HelloWorld.efi进行源码级调试，此时需要在WINDBG中暂时中断连接，并在command bar中输入bu helloworld，然后输入g继续连接：

在UEFI SHELL下定位到FS0:，运行HelloWorld.efi 

此时可以看到，efi的源代码自己跳出了，并且断点在函数的第一行，此时输入g，继续运行

 至此，整个WINDBG的通道就已经建立了，根据不同的函数自行调试即可。

_Code_Loser
关注
  • 48
    点赞
  • 踩
  • 37
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
《UEFI内核导读》VS2019社区版EDK2开发环境搭建
业余电子爱好者的日常
11-21 619
以前的开发环境因更换电脑被破坏，重新基于最新的版本在Windows环境下使用VS2019社区版搭建UEFI/EDK2开发环境，简单记录。
一个UEFI引导程序的实现.pdf
10-16
一个UEFI引导程序的实现文字版 一个UEFI引导程序的实现文字版 一个UEFI引导程序的实现文字版
UEFI开发探索53 – VS2015调试UEFI代码（续第27篇）
04-05 1356
(请保留-> 作者: 罗冰) 在开发网络代码的时候，光用Print打印信息不足以满足开发要求，必须源代码级别的跟踪。我所测试的环境，大部分是在TianCore的模拟环境下。因此，如何在这个环境中，实现源码级跟踪，成为了很迫切的需求。 当然，我可以在Linux下开发，使用Qemu+gdb的方式来调试。不过，每次都要编译好，然后拷贝到镜像文件中，再启动调试，略嫌麻烦。我还是希望能在Windo...
【WinDbg通过QEMU调试OVMF】
最新发布
David唐辉的博客
05-17 910
本文介绍了在 Windows 平台上使用 WinDbg 通过 QEMU 调试 OVMF 的方法。本文读者需要具备 Windows 平台的开发经验，并对 QEMU 系统仿真有一定的使用经验。本文搭建了 WinDbg 通过 QEMU 对 OVMF 的调试环境。
UEFI开发历程4—串口调试功能的探索
qq_40945626的博客
12-17 2610
前言 现如今，由于BIOS代码在生成bin文件烧录进板子后，我们无法看见程序变量的变化，故而导致调试困难。我们都知道，大部分语言程序都有几种方法：日志打印、单步调试等方法。然而BIOS是一个开机过程中的用于初始化的系统，它不是一个软件，因此没有实体界面可以观察变量的改变。但由于主板上存在着串口，因此，串口调试对于BIOS来说是一种非常重要的调试手段。 串口调试实现方法 串口调试功能的打开有三种方式：IO配置寄存器并通过寄存器发送/接收数据的方式、Protocol配置寄存器并通过Protocol提供的读
Windows下调试UEFI程序：Visual Studio调试
小鹰信息技术服务部
08-07 817
以edk2\MdeModulePkg\Application\HelloWorld这个项目作为调试目标。
使用DCI单步调试Intel CPU，调试运行在其上的UEFI代码
systemino的博客
06-14 3160
在本文中，我们将为读者详细介绍下列内容： ·配置ASRock H370M-ITX/ac，以允许进行DCI DbC调试 ·使用Intel System Studio和System Debugger单步执行Coffee Lake-S i7-8700 CPU ·在硬件上调试含有安全漏洞的UEFI应用程序示例 USB DCI DbC调试技术（JTAG over USB3） 对于使用更新的C...
利用 UEFI 实现 内存测试，仅为方法总结，程序未提供。
02-17
利用 UEFI 实现 内存测试，仅为方法总结，程序未提供。涵盖页面设计，单核，多核测试。
EasyUEFI安装程序
10-02
【EasyUEFI安装程序】是专为Windows操作系统设计的一款实用工具，主要用于管理和配置UEFI（统一可扩展固件接口）引导程序。UEFI是现代计算机系统中替代传统BIOS的一种新型固件接口，它提供了更高效、更安全的启动...
系统UEFI启动修复程序BCDrepair.zip
01-04
1. **BCDEdit命令行工具**：这是Windows内置的一个命令行实用程序，用于查看和修改BCD存储。用户可以通过BCDEdit修复启动项、设置启动顺序、添加新的操作系统入口等。 2. **自动修复脚本**：可能包含预设的批处理...
UEFI windows8.1 + ubuntu 双系统安装
10-28
windows8.1和Ubuntu的双系统安装，完美兼容，再也不用担心UEFI的锁定了~
如何使用Visual Studio环境进行UEFI Image的build及调试
Code-Ninja的专栏
10-10 4029
对于使用Intel Tiano EDKII的Code Base进行image的source build时，官方发布的最常用的方法是使用VS自带的Command Prompt命令行工具。以下步骤则是直接利用VS环境进行build，以及对如何对生成的Image进行Debug。 1. 安装VS环境。本人安装的为Visual Studio Ultimate 2012。 2. 下载EDKII Code
[UEFI]使用QEMU运行EDK2编译结果并显示DEBUG的输出
qq_37778515的博客
07-19 1396
Qemu显示EDK2代码中的DEBUG信息
UEFI调试环境搭建
yao00037的博客
12-19 716
步骤1中添加的内容会被打印出来，同时去debug.log中查看HelloWorld.efi加载的位置，后面会用到。以上是一个UEFI application的调试例子，驱动和应用的调试一样，都可以用上述的方法进行调试。首先将HelloWorl添加到OvmfPkg中，方便一起编译。主要是为了辅助调试，比如确定符号是否正确加载、程序是否正确执行等。接下来可以加载符号，设定断点，并将GDB挂载到QEMU上准备调试。在主程序UefiMain中添加获取程序入口地址的日志。计算完成后可以卸载GDB加载的efi文件。
UEFI下Windows引导过程
热门推荐
yeshahayes的博客
10-13 2万+
引导文件 在UEFI安装完操作系统后，Windows至少使用两个分区，一个叫做ESP分区（EFI SYSTEM PARTITION），用于存放启动文件，另一个则是BIOS下正常的系统分区，不同的是，BIOS下引导文件是winload.exe，UEFI下引导文件式winload.efi，两者都是pecoff格式的，但UEFI用的是各种固件接口，而BIOS使用的是中断。有时还会有一个MSR分区，不过这
Debug: The property NMakebuildCommandline does not exist
Chester_ieee的博客
09-07 1209
Go 语言被设计成一门应用于搭载 Web 服务器，存储集群或类似用途的巨型中央服务器的系统编程语言。 对于高性能分布式系统领域而言，Go 语言无疑比大多数其它语言有着更高的开发效率。它提供了海量并行的支持，这对于游戏服务端的开发而言是再好不过了。 ...
MSBuild MSB3073 error in VS Android|Linux Makefile Project
怪咖先森的博客
06-04 486
背景 在 VS 中创建 Visual C++ --&gt; Cross Platform --&gt; Android | Linux --&gt; Makefile Project 后，只是在项目中有这样一段代码： LOGD("data length error: %d", datalen); &lt;-- 字符串： “error:” 编译的时候就会报...
Visual Studio 2010中C++项目升级指南
Xunixing的专栏
08-24 2242
工程中总会遇到些 工程升级问题，发现一篇 指南 原文链接： http://developer.51cto.com/art/201003/187791.htm 【51CTO经典译文】大家好，我叫李韶（音）。我是C++小组的软件开发测试工程师。正如许多博客文（例如，Felix Huang最近的这篇博客， Andreea Issac 的这篇博客，还有我之前的这篇博客）所介绍的那样，这
ami uefi程序源码
08-17
AMI UEFI程序是由美国微软公司（AMI）开发的一种UEFI固件程序。AMI是全球最大的BIOS支持和固件解决方案提供商之一。UEFI是一种新一代的固件接口，取代了传统的BIOS接口。AMI UEFI程序是在这种新接口下运行的操作系统启动引导程序。 AMI UEFI程序的源码是由AMI公司编写的，它包括了所有启动引导所需的功能和技术。这些源码通常是以C语言为基础编写的，包含了各种驱动程序和模块。它们通过编译和链接生成可执行的UEFI应用程序。 AMI UEFI程序源码包含了UEFI规范所要求的各种组件，例如PEI（Pre-EFI Initialization）阶段的PEI核心驱动程序和模块，DXE（Driver Execution Environment）阶段的DXE驱动程序，以及可被操作系统加载的UEFI应用程序。这些源码通过一系列的函数调用和交互来实现系统的初始化、硬件检测、驱动加载和操作系统启动等功能。 AMI UEFI程序的源码通常由硬件厂商或系统集成商使用，在他们的产品中进行定制和修改。他们可以根据自己的需求添加、删除或修改源码来实现特定的功能。通过修改源码，用户可以添加新的驱动程序、修改操作系统的启动选项、优化性能等。 总的来说，AMI UEFI程序的源码是一种开放的、可定制的固件程序，通过修改和定制源码，可以满足各种不同的硬件和软件需求。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值