audk/UefiCpuPkg/ResetVector/Vtf0
Gao, Liming 9ddb2a2341 UefiCpuPkg: INF/DEC file updates to EDK II packages
2. Add MODULE_UNI_FILE file that contains the localized Abstract and Description of a module.
a. Addresses an information gap between INF files and the UEFI Distribution Packaging Specification XML schema
b. There will be an associated update to UPT in BaseTools to consume MODULE_UNI_FILE and associated UNI file during UDP creation that performs the INF -> XML conversion.
c. There will be an associated update to UPT in BaseTools to produce MODULE_UNI_FILE and associated UNI file during UDP installation that performs the XML -> INF conversion.

3. Add Module Extra UNI file that provides the localized Name of a module.
a. [UserExtensions.TianoCore."ExtraFiles"] provides an easy method for a module to specify extra files not listed in [Sources] or [Binaries] sections to be added to a UDP without having to list the files in the UPT package information data file.
b. There will be an associated update to UPT in BaseTools to package up files listed in [UserExtensions.TianoCore."ExtraFiles"] during UDP creation.
c. UNI file contains localized name of a module to go along with the localized Abstract and Description from the MODULE_UNI_FILE.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Gao, Liming <liming.gao@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15934 6f19259b-4bc3-4df7-8a09-765794883524
2014-08-28 05:11:06 +00:00
..
Bin UefiCpuPkg: INF/DEC file updates to EDK II packages 2014-08-28 05:11:06 +00:00
Ia16 UefiCpuPkg VTF0 X64: Build page tables in NASM code 2014-08-18 23:03:46 +00:00
Ia32 UefiCpuPkg VTF0 X64: Build page tables in NASM code 2014-08-18 23:03:46 +00:00
Tools UefiCpuPkg VTF0 X64: Build page tables in NASM code 2014-08-18 23:03:46 +00:00
X64 UefiCpuPkg VTF0 X64: Build page tables in NASM code 2014-08-18 23:03:46 +00:00
Build.py UefiCpuPkg: Support building VTF0 ResetVector during the EDK II build 2014-08-18 23:03:30 +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
ResetVector.uni UefiCpuPkg: INF/DEC file updates to EDK II packages 2014-08-28 05:11:06 +00:00
ResetVectorExtra.uni UefiCpuPkg: INF/DEC file updates to EDK II packages 2014-08-28 05:11:06 +00:00
SerialDebug.asm Update the copyright notice format 2010-04-24 12:25:26 +00:00
Vtf0.inf UefiCpuPkg: INF/DEC file updates to EDK II packages 2014-08-28 05:09:12 +00:00
Vtf0.nasmb UefiCpuPkg VTF0 X64: Build page tables in NASM code 2014-08-18 23:03:46 +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