UefiCpuPkg/ResetVector/Vtf0/ReadMe.txt

   1
   2 === HOW TO USE VTF0 ===
   3
   4 Add this line to your FDF FV section:
   5 INF  RuleOverride=RESET_VECTOR USE = IA32 UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVector.inf
   6 (For X64 SEC/PEI change IA32 to X64 => 'USE = X64')
   7
   8 In your FDF FFS file rules sections add:
   9 [Rule.Common.SEC.RESET_VECTOR]
  10   FILE RAW = $(NAMED_GUID) {
  11     RAW RAW                |.raw
  12   }
  13
  14 === VTF0 Boot Flow ===
  15
  16 1. Transition to IA32 flat mode
  17 2. Locate BFV (Boot Firmware Volume) by checking every 4kb boundary
  18 3. Locate SEC image
  19 4. X64 VTF0 transitions to X64 mode
  20 5. Call SEC image entry point
  21
  22 == VTF0 SEC input parameters ==
  23
  24 All inputs to SEC image are register based:
  25 EAX/RAX - Initial value of the EAX register (BIST: Built-in Self Test)
  26 DI      - 'BP': boot-strap processor, or 'AP': application processor
  27 EBP/RBP - Pointer to the start of the Boot Firmware Volume
  28
  29 === HOW TO BUILD VTF0 ===
  30
  31 Dependencies:
  32 * Python 3 or newer
  33 * Nasm 2.03 or newer
  34
  35 To rebuild the VTF0 binaries:
  36 1. Change to VTF0 source dir: UefiCpuPkg/ResetVector/Vtf0
  37 2. nasm and python should be in executable path
  38 3. Run this command:
  39    python Build.py
  40 4. Binaries output will be in UefiCpuPkg/ResetVector/Vtf0/Bin
  41