2 Ia32-specific functionality for DxeLoad.
4 Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #include "VirtualMemory.h"
18 #define IDT_ENTRY_COUNT 32
20 typedef struct _X64_IDT_TABLE
{
22 // Reserved 4 bytes preceding PeiService and IdtTable,
23 // since IDT base address should be 8-byte alignment.
26 CONST EFI_PEI_SERVICES
**PeiService
;
27 X64_IDT_GATE_DESCRIPTOR IdtTable
[IDT_ENTRY_COUNT
];
31 // Global Descriptor Table (GDT)
33 GLOBAL_REMOVE_IF_UNREFERENCED IA32_GDT gGdtEntries
[] = {
34 /* selector { Global Segment Descriptor } */
35 /* 0x00 */ {{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}}, //null descriptor
36 /* 0x08 */ {{0xffff, 0, 0, 0x2, 1, 0, 1, 0xf, 0, 0, 1, 1, 0}}, //linear data segment descriptor
37 /* 0x10 */ {{0xffff, 0, 0, 0xf, 1, 0, 1, 0xf, 0, 0, 1, 1, 0}}, //linear code segment descriptor
38 /* 0x18 */ {{0xffff, 0, 0, 0x3, 1, 0, 1, 0xf, 0, 0, 1, 1, 0}}, //system data segment descriptor
39 /* 0x20 */ {{0xffff, 0, 0, 0xa, 1, 0, 1, 0xf, 0, 0, 1, 1, 0}}, //system code segment descriptor
40 /* 0x28 */ {{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}}, //spare segment descriptor
41 /* 0x30 */ {{0xffff, 0, 0, 0x2, 1, 0, 1, 0xf, 0, 0, 1, 1, 0}}, //system data segment descriptor
42 /* 0x38 */ {{0xffff, 0, 0, 0xa, 1, 0, 1, 0xf, 0, 1, 0, 1, 0}}, //system code segment descriptor
43 /* 0x40 */ {{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}}, //spare segment descriptor
49 GLOBAL_REMOVE_IF_UNREFERENCED CONST IA32_DESCRIPTOR gGdt
= {
50 sizeof (gGdtEntries
) - 1,
54 GLOBAL_REMOVE_IF_UNREFERENCED IA32_DESCRIPTOR gLidtDescriptor
= {
55 sizeof (X64_IDT_GATE_DESCRIPTOR
) * IDT_ENTRY_COUNT
- 1,
60 Transfers control to DxeCore.
62 This function performs a CPU architecture specific operations to execute
63 the entry point of DxeCore with the parameters of HobList.
64 It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.
66 @param DxeCoreEntryPoint The entry point of DxeCore.
67 @param HobList The start of HobList passed to DxeCore.
72 IN EFI_PHYSICAL_ADDRESS DxeCoreEntryPoint
,
73 IN EFI_PEI_HOB_POINTERS HobList
77 EFI_PHYSICAL_ADDRESS BaseOfStack
;
78 EFI_PHYSICAL_ADDRESS TopOfStack
;
80 X64_IDT_GATE_DESCRIPTOR
*IdtTable
;
83 EFI_PHYSICAL_ADDRESS VectorAddress
;
85 X64_IDT_TABLE
*IdtTableForX64
;
87 Status
= PeiServicesAllocatePages (EfiBootServicesData
, EFI_SIZE_TO_PAGES (STACK_SIZE
), &BaseOfStack
);
88 ASSERT_EFI_ERROR (Status
);
90 if (FeaturePcdGet(PcdDxeIplSwitchToLongMode
)) {
92 // Compute the top of the stack we were allocated, which is used to load X64 dxe core.
93 // Pre-allocate a 32 bytes which confroms to x64 calling convention.
95 // The first four parameters to a function are passed in rcx, rdx, r8 and r9.
96 // Any further parameters are pushed on the stack. Furthermore, space (4 * 8bytes) for the
97 // register parameters is reserved on the stack, in case the called function
98 // wants to spill them; this is important if the function is variadic.
100 TopOfStack
= BaseOfStack
+ EFI_SIZE_TO_PAGES (STACK_SIZE
) * EFI_PAGE_SIZE
- 32;
103 // x64 Calling Conventions requires that the stack must be aligned to 16 bytes
105 TopOfStack
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) ALIGN_POINTER (TopOfStack
, 16);
108 // Load the GDT of Go64. Since the GDT of 32-bit Tiano locates in the BS_DATA
109 // memory, it may be corrupted when copying FV to high-end memory
111 AsmWriteGdtr (&gGdt
);
113 // Create page table and save PageMapLevel4 to CR3
115 PageTables
= CreateIdentityMappingPageTables ();
118 // End of PEI phase signal
120 Status
= PeiServicesInstallPpi (&gEndOfPeiSignalPpi
);
121 ASSERT_EFI_ERROR (Status
);
123 AsmWriteCr3 (PageTables
);
126 // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
128 UpdateStackHob (BaseOfStack
, STACK_SIZE
);
130 SizeOfTemplate
= AsmGetVectorTemplatInfo (&TemplateBase
);
132 Status
= PeiServicesAllocatePages (
134 EFI_SIZE_TO_PAGES(sizeof (X64_IDT_TABLE
) + SizeOfTemplate
* IDT_ENTRY_COUNT
),
135 (EFI_PHYSICAL_ADDRESS
*) &IdtTableForX64
137 ASSERT_EFI_ERROR (Status
);
140 // Store EFI_PEI_SERVICES** in the 4 bytes immediately preceding IDT to avoid that
141 // it may not be gotten correctly after IDT register is re-written.
143 IdtTableForX64
->PeiService
= GetPeiServicesTablePointer ();
145 VectorAddress
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) (IdtTableForX64
+ 1);
146 IdtTable
= IdtTableForX64
->IdtTable
;
147 for (Index
= 0; Index
< IDT_ENTRY_COUNT
; Index
++) {
148 IdtTable
[Index
].Ia32IdtEntry
.Bits
.GateType
= 0x8e;
149 IdtTable
[Index
].Ia32IdtEntry
.Bits
.Reserved_0
= 0;
150 IdtTable
[Index
].Ia32IdtEntry
.Bits
.Selector
= SYS_CODE64_SEL
;
152 IdtTable
[Index
].Ia32IdtEntry
.Bits
.OffsetLow
= (UINT16
) VectorAddress
;
153 IdtTable
[Index
].Ia32IdtEntry
.Bits
.OffsetHigh
= (UINT16
) (RShiftU64 (VectorAddress
, 16));
154 IdtTable
[Index
].Offset32To63
= (UINT32
) (RShiftU64 (VectorAddress
, 32));
155 IdtTable
[Index
].Reserved
= 0;
157 CopyMem ((VOID
*) (UINTN
) VectorAddress
, TemplateBase
, SizeOfTemplate
);
158 AsmVectorFixup ((VOID
*) (UINTN
) VectorAddress
, (UINT8
) Index
);
160 VectorAddress
+= SizeOfTemplate
;
163 gLidtDescriptor
.Base
= (UINTN
) IdtTable
;
166 // Disable interrupt of Debug timer, since new IDT table cannot handle it.
168 SaveAndSetDebugTimerInterrupt (FALSE
);
170 AsmWriteIdtr (&gLidtDescriptor
);
173 // Go to Long Mode and transfer control to DxeCore.
174 // Interrupts will not get turned on until the CPU AP is loaded.
175 // Call x64 drivers passing in single argument, a pointer to the HOBs.
180 (EFI_PHYSICAL_ADDRESS
)(UINTN
)(HobList
.Raw
),
186 // Compute the top of the stack we were allocated. Pre-allocate a UINTN
189 TopOfStack
= BaseOfStack
+ EFI_SIZE_TO_PAGES (STACK_SIZE
) * EFI_PAGE_SIZE
- CPU_STACK_ALIGNMENT
;
190 TopOfStack
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) ALIGN_POINTER (TopOfStack
, CPU_STACK_ALIGNMENT
);
193 // End of PEI phase signal
195 Status
= PeiServicesInstallPpi (&gEndOfPeiSignalPpi
);
196 ASSERT_EFI_ERROR (Status
);
199 // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
201 UpdateStackHob (BaseOfStack
, STACK_SIZE
);
204 // Transfer the control to the entry point of DxeCore.
207 (SWITCH_STACK_ENTRY_POINT
)(UINTN
)DxeCoreEntryPoint
,
210 (VOID
*) (UINTN
) TopOfStack