ResetVector assembly implementation puts "ALIGN 16" in the end to guarantee the final executable file size is multiple of 16 bytes. Because the module uses a special GUID which guarantees it's put in the very end of a FV, which should be also the end of the FD. All of these (file size is multiple of 16B, and the module is put at end of FV, FV is put at end of FD) guarantee the "JMP xxx" instruction is at FFFF_FFF0h. This patch updates INF file and ReadMe.txt to add guidance of FDF ffs rule for the ResetVector. Signed-off-by: Ray Ni <ray.ni@intel.com> Reviewed-by: Eric Dong <eric.dong@intel.com> Cc: Rahul Kumar <rahul1.kumar@intel.com> Cc: Gerd Hoffmann <kraxel@redhat.com> Acked-by: Gerd Hoffmann <kraxel@redhat.com>
29 lines
910 B
Plaintext
29 lines
910 B
Plaintext
|
|
=== HOW TO USE VTF0 ===
|
|
Add this line to your DSC [Components.IA32] or [Components.X64] section:
|
|
UefiCpuPkg/ResetVector/Vtf0/ResetVector.inf
|
|
|
|
Add this line to your FDF FV section:
|
|
INF RuleOverride=RESET_VECTOR UefiCpuPkg/ResetVector/Vtf0/ResetVector.inf
|
|
|
|
In your FDF FFS file rules sections add:
|
|
[Rule.Common.SEC.RESET_VECTOR]
|
|
FILE RAW = $(NAMED_GUID) {
|
|
RAW BIN |.bin
|
|
}
|
|
|
|
=== 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
|