Getting and Installing the Required Tools for Building EDK II

Name	Version	URL
Cygwin1	Current	http://www.cygwin.com
Microsoft Visual Studio2	2005 Professional	http://msdn2.microsoft.com/en-us/vstudio
Microsoft Visual Studio3	2005 Team Suite	http://msdn2.microsoft.com/en-us/vstudio
Microsoft Visual Studio4	2003 .NET	http://msdn2.microsoft.com/en-us/vstudio
Intel C++ Compiler for Windows	9.1	http://www.intel.com
Intel C Compiler for EFI Byte Code	1.2	http://www.intel.com/cd/software/products /asmo-na/eng/compilers/efibc/index.htm
Microsoft Driver Development Kit5 (DDK)	3790.1830	http://www.microsoft.com/whdc/devtools/ddk/orderddkcd.mspx
Microsoft ACPI Source Language Assembler	3.0.0NT or later	http://www.microsoft.com/whdc/system/pnppwr/powermgmt/default.mspx
Intel ACPI Component Architecture	20060113 or later	http://www.intel.com/technology/iapc/acpi/downloads.htm

¹ Instructions for installation of GCC are included in the BaseTools\gcc directory.
² The default tool chain for the IA32 and X64 builds.
³ Needed for building IPF targets if the DDK is not installed.
⁴ May only be available through a MSDN subscription.
⁵ The default tool chain for IPF builds.

 Back to Top

Install and Configure Tools on Windows XP or Windows Vista

Software Installation Order

After installing the compiler tools and your Subversion client, download the edk2, read the BuildNotes2.txt file and you will be ready to build an image.

All builds are started from a command prompt window.

Cygwin

If you optionally install cygwin (for gcc support) you should install it in "Unix" mode. The gcc tool chain will not compile in "DOS" mode.

 Back to Top

Environment Variables

Environment variables are case sensitive. You must use the exact case as in the examples of this document. Even though windows does not care about case, other operating systems that are supported do care about case.

You need to set WORKSPACE to the location of the edk2 directory that you pulled from Subversion. For example:

set WORKSPACE=c:\workspace\edk2

It is recommended that you wrap up all the environment variables above into a script that you can launch each time you begin to do development in your EDK II workspace.

 Back to Top

First Build

You will need to edit the text file, tools_def.txt which is created the first time you run the edksetup script⁶. The file is located in the %WORKSPACE%\Conf directory. This file contains the names of the compiler tool chains and the location of the compiler binaries. It has been pre-populated with the standard location for the Microsoft tool chains and includes the standard location of the Intel C Compiler for EFI Byte Code (EBC).

Once the external tools are installed and the environment variables are set, you can try a build.

1. cd %WORKSPACE%
2. edksetup.bat --nt32 newbuild
   This will set the PATH to point to the directory containing the Win32 binaries of the EDK II tools used in edk2 development. It will fail if the external tools above are not properly installed.
   Using the --nt32 switch will run "%VS80COMNTOOLS%\vsvars32" (VS2005) or "%VS71COMNTOOLS%\vsvars32" (VS2003.NET) to setup standard C FLAGS, Library and Include locations to build the Nt32 emulation environment.
   Note: If you do not want to build the Nt32 emulation environment, you do not need to use the --nt32 switch or run vsvars32.bat.
3. Modify Conf/tools_def.txt⁷
4. cd Nt32Pkg
5. build

   The default build output directory is: %WORKSPACE%\Build\NT32\DEBUG_MYTOOLS\