audk/UefiCpuPkg/ResetVector/Vtf0
Jordan Justen a63f2e2450 UefiCpuPkg/ResetVector/Vtf0: Move Page Table/CR3 setting to a new file
Now, Transition32FlatTo64Flat calls SetCr3ForPageTables64
which is located in Ia32/PageTables64.asm.

This change is required so OVMF can replace the code in
Ia32/PageTables64.asm with code that generates page tables in
RAM.

Note: Since this change does not impact the functionality of the
current VTF0 binaries, they are not being updated. The resulting
new binaries were tested to verify there is no regression.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@14714 6f19259b-4bc3-4df7-8a09-765794883524
2013-09-24 18:23:09 +00:00
..
Bin UefiCpuPkg VTF0: Fix support for finding SEC image of type TE. 2011-09-28 01:36:33 +00:00
Ia16 UefiCpuPkg: Replace the un-necessary WBINVD instruction at the reset vector with two NOPs in VTF0. 2011-08-04 03:25:14 +00:00
Ia32 UefiCpuPkg/ResetVector/Vtf0: Move Page Table/CR3 setting to a new file 2013-09-24 18:23:09 +00:00
Tools Update the copyright notice format 2010-04-24 12:25:26 +00:00
Build.py Update the copyright notice format 2010-04-24 12:25:26 +00:00
CommonMacros.inc Update the copyright notice format 2010-04-24 12:25:26 +00:00
DebugDisabled.asm Update the copyright notice format 2010-04-24 12:25:26 +00:00
Main.asm Update the copyright notice format 2010-04-24 12:25:26 +00:00
Port80Debug.asm Update the copyright notice format 2010-04-24 12:25:26 +00:00
PostCodes.inc Update the copyright notice format 2010-04-24 12:25:26 +00:00
ReadMe.txt UefiCpuPkg VTF0: Rename README to ReadMe.txt, add nasm version 2011-09-20 01:49:52 +00:00
ResetVectorCode.asm UefiCpuPkg/ResetVector/Vtf0: Move Page Table/CR3 setting to a new file 2013-09-24 18:23:09 +00:00
SerialDebug.asm Update the copyright notice format 2010-04-24 12:25:26 +00:00

ReadMe.txt

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.


=== HOW TO USE VTF0 ===

Add this line to your FDF FV section:
INF  RuleOverride=RESET_VECTOR USE = IA32 UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVector.inf
(For X64 SEC/PEI change IA32 to X64 => 'USE = X64')

In your FDF FFS file rules sections add:
[Rule.Common.SEC.RESET_VECTOR]
  FILE RAW = $(NAMED_GUID) {
    RAW RAW                |.raw
  }

=== VTF0 Boot Flow ===

1. Transition to IA32 flat mode
2. Locate BFV (Boot Firmware Volume) by checking every 4kb boundary
3. Locate SEC image
4. X64 VTF0 transitions to X64 mode
5. Call SEC image entry point

== VTF0 SEC input parameters ==

All inputs to SEC image are register based:
EAX/RAX - Initial value of the EAX register (BIST: Built-in Self Test)
DI      - 'BP': boot-strap processor, or 'AP': application processor
EBP/RBP - Pointer to the start of the Boot Firmware Volume

=== HOW TO BUILD VTF0 ===

Dependencies:
* Python 2.5~2.7
* Nasm 2.03 or newer

To rebuild the VTF0 binaries:
1. Change to VTF0 source dir: UefiCpuPkg/ResetVector/Vtf0
2. nasm and python should be in executable path
3. Run this command:
   python Build.py
4. Binaries output will be in UefiCpuPkg/ResetVector/Vtf0/Bin