tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
audk/UefiCpuPkg/ResetVector/Vtf0
History
Oliver Smith-Denny f0390f7bf1 UefiCpuPkg: Make the ResetVector USER_DEFINED 
The x86 reset vector is the initial FW code to run on an
AP. It should not link to any libraries and is implemented
entirely in assembly. This module is currently labled as
SEC, because it runs during the SEC phase, but by having it
SEC, it will be linked to all NULL libraries linked globally.
This causes issue with StackCheckLib (though any NULL
library being applied globally has the same issue) because
BaseTools will attempt to link the library and add an
extern to _ModuleEntryPoint, which does not exist for this
module.

Moving this module to USER_DEFINED instructs BaseTools to
not link any NULL libraries to it, which is the desired
behavior, and leads to a much cleaner global NULL library
implementation, in this case for StackCheckLib.

This change was tested on OVMF IA32/X64 and proved to work
as before.

Signed-off-by: Oliver Smith-Denny <osde@linux.microsoft.com>
 		2024-11-13 21:01:46 +00:00
..
Ia16 UefiCpuPkg/ResetVector: Remove AP waking vector from ResetVector 2023-09-18 02:39:25 +00:00
Ia32 UefiCpuPkg/ResetVector: Support 5 level page table in ResetVector 2023-05-30 05:55:44 +00:00
X64 UefiCpuPkg/ResetVector: Support 5 level page table in ResetVector 2023-05-30 05:55:44 +00:00
CommonMacros.inc
…
DebugDisabled.asm
…
Main.asm
…
PageTables.inc UefiCpuPkg: VTF0 Linear-Address Translation to a 1-GByte Page till 512GB 2021-09-16 14:18:27 +00:00
Port80Debug.asm
…
PostCodes.inc
…
ReadMe.txt UefiCpuPkg/ResetVector: Add guidance of FDF ffs rule 2023-06-27 10:16:25 +00:00
ResetVector.uni
…
ResetVectorExtra.uni
…
SerialDebug.asm
…
Vtf0.inf UefiCpuPkg: Make the ResetVector USER_DEFINED 2024-11-13 21:01:46 +00:00
Vtf0.nasmb UefiCpuPkg/ResetVector: Combine PageTables1G.asm and PageTables2M.asm 2023-05-30 05:55:44 +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 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