3 EmulatorPkg provides an environment where a UEFI environment can be
4 emulated under an environment where a full UEFI compatible
5 environment is not possible. (For example, running under an OS
6 where an OS process hosts the UEFI emulation environment.)
8 https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg
12 * Builds and runs under
13 * a posix-like environment with X windows
21 **You can use the following command to build.**
22 * 32bit emulator in Windows:
24 `build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a IA32`
26 * 64bit emulator in Windows:
28 `build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a X64`
30 * 32bit emulator in Linux:
32 `build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a IA32`
34 * 64bit emulator in Linux:
36 `build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a X64`
38 **You can start/run the emulator using the following command:**
39 * 32bit emulator in Windows:
41 `cd Build\EmulatorIA32\DEBUG_VS2017\IA32\ && WinHost.exe`
43 * 64bit emulator in Windows:
45 `cd Build\EmulatorX64\DEBUG_VS2017\X64\ && WinHost.exe`
47 * 32bit emulator in Linux:
49 `cd Build/EmulatorIA32/DEBUG_GCC5/IA32/ && ./Host`
51 * 64bit emulator in Linux:
53 `cd Build/EmulatorX64/DEBUG_GCC5/X64/ && ./Host`
55 **On posix-like environment with the bash shell you can use EmulatorPkg/build.sh to simplify building and running
58 For example, to build + run:
60 `$ EmulatorPkg/build.sh`
61 `$ EmulatorPkg/build.sh run`
63 The build architecture will match your host machine's architecture.
65 On X64 host machines, you can build + run IA32 mode as well:
67 `$ EmulatorPkg/build.sh -a IA32`
68 `$ EmulatorPkg/build.sh -a IA32 run`