EmulatorPkg: Update package level Readme.md

Since the emulator under Windows is enabled, the patch changes
README to include the information of emulator under Windows.
It also changes README to Readme.md for better looking.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Reviewed-by: Hao A Wu <hao.a.wu@intel.com>
This commit is contained in:
Ruiyu Ni 2018-08-31 11:35:58 +08:00
parent 34c3405cb7
commit 289cb872ed
2 changed files with 68 additions and 35 deletions

View File

@ -1,35 +0,0 @@
=== EmulatorPkg Overview ===
EmulatorPkg provides an environment where a UEFI environment can be
emulated under an environment where a full UEFI compatible
environment is not possible. (For example, running under an OS
where an OS process hosts the UEFI emulation environment.)
https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg
=== Status ===
* Builds and runs under a posix-like environment with X windows
- Linux
- OS X
=== Future Plans ===
* Win32 and Win64 support
=== Build Scripts ===
On systems with the bash shell you can use EmulatorPkg/build.sh to simplify
building and running EmulatorPkg.
For example, to build + run:
$ EmulatorPkg/build.sh
$ EmulatorPkg/build.sh run
The build architecture will match your host machine's architecture.
On X64 host machines, you can build + run IA32 mode as well:
$ EmulatorPkg/build.sh -a IA32
$ EmulatorPkg/build.sh -a IA32 run

68
EmulatorPkg/Readme.md Normal file
View File

@ -0,0 +1,68 @@
## Overview
EmulatorPkg provides an environment where a UEFI environment can be
emulated under an environment where a full UEFI compatible
environment is not possible. (For example, running under an OS
where an OS process hosts the UEFI emulation environment.)
https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg
## Status
* Builds and runs under
* a posix-like environment with X windows
- Linux
- OS X
* Windows environment
- Win10 (verified)
- Win8 (not verified)
## How to Build & Run
**You can use the following command to build.**
* 32bit emulator in Windows:
`build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a IA32`
* 64bit emulator in Windows:
`build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a X64`
* 32bit emulator in Linux:
`build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a IA32`
* 64bit emulator in Linux:
`build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a X64`
**You can start/run the emulator using the following command:**
* 32bit emulator in Windows:
`cd Build\EmulatorIA32\DEBUG_VS2017\IA32\ && WinHost.exe`
* 64bit emulator in Windows:
`cd Build\EmulatorX64\DEBUG_VS2017\X64\ && WinHost.exe`
* 32bit emulator in Linux:
`cd Build/EmulatorIA32/DEBUG_GCC5/IA32/ && ./Host`
* 64bit emulator in Linux:
`cd Build/EmulatorX64/DEBUG_GCC5/X64/ && ./Host`
**On posix-like environment with the bash shell you can use EmulatorPkg/build.sh to simplify building and running
emulator.**
For example, to build + run:
`$ EmulatorPkg/build.sh`
`$ EmulatorPkg/build.sh run`
The build architecture will match your host machine's architecture.
On X64 host machines, you can build + run IA32 mode as well:
`$ EmulatorPkg/build.sh -a IA32`
`$ EmulatorPkg/build.sh -a IA32 run`