ionescu007/VisualUefi
GitHub: ionescu007/VisualUefi
在Visual Studio中原生开发调试UEFI固件的一站式解决方案，无需EDK-II复杂构建工具链。
Stars: 594 | Forks: 135
## 概要
VisualUEFI 是
* 一个解决方案和一组 Visual Studio 项目文件，允许构建官方 EDK-II（包括 OpenSSL 1.1.0e），而无需使用 inf 文件、Python 和其他 50 种构建工具、自定义依赖项跟踪器和构建系统，以及其他二十种自定义代码片段。
EDK-II 和 OpenSSL 作为子模块存在，直接来自官方 TianoCore 树，且未对它们进行任何更改。
* 一个解决方案和几个 Visual Studio 项目文件，用于展示四个 UEFI 示例组件：一个 UEFI 应用程序及其关联的 UEFI 启动驱动程序、EDK-II 示例 FtdiUsbSerialDxe 驱动程序，以及使用 OpenSSL 1.1.0e 的 EDK-II 示例 Cryptest 应用程序。该代码 100% 兼容 EDK-II，但改用 VisualUEFI 构建。
* 一个可在 Windows 上运行且快速的 QEMU64 2.10 副本，带有最新的 UEFI 2.6 OVMF 安全启动 ROM，其中包括 SMM 支持和实际受保护的闪存，用于注册 PK/KEK/DB/DBX 密钥。这些将根据需要持续更新。这与 Visual Studio 示例解决方案集成在一起，因此按 F5 即可启动实例进行测试。
如果您想了解更多关于我的研究或工作的信息，邀请您查看我的博客 http://www.alex-ionescu.com 以及我的培训与咨询公司 Winsider Seminars & Solutions Inc.，网址是 http://www.windows-internals.com。
## 代码示例
这是一个非常简单的 UEFI 应用程序与 UEFI 驱动程序协议通信的示例。此示例是 VisualUefi 的一部分。
```
//
// Basic UEFI Libraries
//
#include
#include
#include
#include
//
// Boot and Runtime Services
//
#include
#include
//
// Custom Driver Protocol
//
#include "../UefiDriver/drvproto.h"
EFI_GUID gEfiSampleDriverProtocolGuid = EFI_SAMPLE_DRIVER_PROTOCOL_GUID;
//
// We run on any UEFI Specification
//
extern CONST UINT32 _gUefiDriverRevision = 0;
//
// Our name
//
CHAR8 *gEfiCallerBaseName = "UefiApplication";
EFI_STATUS
EFIAPI
UefiUnload (
IN EFI_HANDLE ImageHandle
)
{
//
// This code should be compiled out and never called
//
ASSERT(FALSE);
}
EFI_STATUS
EFIAPI
UefiMain (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE* SystemTable
)
{
EFI_STATUS efiStatus;
SHELL_FILE_HANDLE fileHandle;
UINT8 buffer[4];
UINTN readSize;
EFI_SAMPLE_DRIVER_PROTOCOL* sampleProtocol;
//
// Print stuff out
//
fileHandle = NULL;
Print(L"Hello World! My handle is %lx and System Table is at %p\n",
ImageHandle, SystemTable);
//
// Initialize the shell library
//
efiStatus = ShellInitialize();
if (EFI_ERROR(efiStatus))
{
Print(L"Failed to initialize shell: %lx\n", efiStatus);
goto Exit;
}
//
// Open ourselves
//
efiStatus = ShellOpenFileByName(L"fs1:\\UefiApplication.efi",
&fileHandle,
EFI_FILE_MODE_READ,
0);
if (EFI_ERROR(efiStatus))
{
Print(L"Failed to open ourselves: %lx\n", efiStatus);
fileHandle = NULL;
goto Exit;
}
//
// Read 4 bytes at the top (MZ header)
//
readSize = sizeof(buffer);
efiStatus = ShellReadFile(fileHandle, &readSize, &buffer);
if (EFI_ERROR(efiStatus))
{
Print(L"Failed to read ourselves: %lx\n", efiStatus);
goto Exit;
}
//
// Print it
//
Print(L"Data: %lx\n", *(UINT32*)buffer);
//
// Check if the sample driver is loaded
//
efiStatus = gBS->LocateProtocol(&gEfiSampleDriverProtocolGuid, NULL, &sampleProtocol);
if (EFI_ERROR(efiStatus))
{
Print(L"Failed to locate our driver: %lx\n", efiStatus);
goto Exit;
}
//
// Print the value and exit
//
Print(L"Sample driver is loaded: %lx\n", sampleProtocol->SampleValue);
Exit:
//
// Close our file handle
//
if (fileHandle != NULL)
{
ShellCloseFile(&fileHandle);
}
//
// Sample complete!
//
return efiStatus;
}
```
## 动机
虽然 EDK-II 的构建子系统支持 Visual Studio，但它不支持“IDE 内部”构建。相反，它使用特殊的 .inf 文件和其他模板来定义项目，并且必须运行由多个第三方工具（包括对 Python、Ruby 和 Perl 的依赖）组成的自定义构建。对于已经熟悉 Visual Studio 项目文件/MSBUILD 及其提供的 IDE 的开发人员来说，这可能既繁琐又受限，从而降低了快速投入 UEFI 开发的能力。此外，EDK-II 的默认“测试”环境是在应用程序周围构建一个 Windows “NT32” 层，并将其作为命令行可执行文件运行。虽然这对于非常简单的应用程序可能有效，但它无法可靠地提供用于测试 DXE 驱动程序、运行时服务等的环境。
VisualUefi 旨在通过使用适当的 Visual Studio 构建环境编译 100% 未修改的 EDK-II 库来弥补这些差距，添加一些 VisualUefi 特定的粘合代码以支持在 Visual Studio 内部构建而无需第三方工具，并包含最新的 QEMU 和带 SecureBoot 的 OVMF 包用于 UEFI 的裸机测试，而无需依赖 Windows 仿真。
## 安装说明
首先安装 NASM (
标签：Bootloader, EDK-II, OpenSSL, OVMF, QEMU, Secure Boot, SMM, TianoCore, UEFI, Visual Studio, Windows开发, 内联执行, 固件开发, 安全启动, 安全测试工具, 客户端加密, 开发环境, 引导程序, 系统底层, 网络安全监控, 虚拟化, 身份验证强制, 驱动开发