MdeModulePkg/Core/DxeIplPeim/Ia32/DxeLoadFunc.c

   1 /** @file
   2   Ia32-specifc functionality for DxeLoad.
   3
   4 Copyright (c) 2006 - 2008, Intel Corporation. <BR>
   5 All rights reserved. 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
   9
  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.
  12
  13 **/
  14
  15 #include "DxeIpl.h"
  16 #include "VirtualMemory.h"
  17
  18 //
  19 // Global Descriptor Table (GDT)
  20 //
  21 GLOBAL_REMOVE_IF_UNREFERENCED IA32_GDT gGdtEntries [] = {
  22 /* selector { Global Segment Descriptor                              } */
  23 /* 0x00 */  {{0,      0,  0,  0,    0,  0,  0,  0,    0,  0, 0,  0,  0}}, //null descriptor
  24 /* 0x08 */  {{0xffff, 0,  0,  0x2,  1,  0,  1,  0xf,  0,  0, 1,  1,  0}}, //linear data segment descriptor
  25 /* 0x10 */  {{0xffff, 0,  0,  0xf,  1,  0,  1,  0xf,  0,  0, 1,  1,  0}}, //linear code segment descriptor
  26 /* 0x18 */  {{0xffff, 0,  0,  0x3,  1,  0,  1,  0xf,  0,  0, 1,  1,  0}}, //system data segment descriptor
  27 /* 0x20 */  {{0xffff, 0,  0,  0xa,  1,  0,  1,  0xf,  0,  0, 1,  1,  0}}, //system code segment descriptor
  28 /* 0x28 */  {{0,      0,  0,  0,    0,  0,  0,  0,    0,  0, 0,  0,  0}}, //spare segment descriptor
  29 /* 0x30 */  {{0xffff, 0,  0,  0x2,  1,  0,  1,  0xf,  0,  0, 1,  1,  0}}, //system data segment descriptor
  30 /* 0x38 */  {{0xffff, 0,  0,  0xa,  1,  0,  1,  0xf,  0,  1, 0,  1,  0}}, //system code segment descriptor
  31 /* 0x40 */  {{0,      0,  0,  0,    0,  0,  0,  0,    0,  0, 0,  0,  0}}, //spare segment descriptor
  32 };
  33
  34 //
  35 // IA32 Gdt register
  36 //
  37 GLOBAL_REMOVE_IF_UNREFERENCED CONST IA32_DESCRIPTOR gGdt = {
  38   sizeof (gGdtEntries) - 1,
  39   (UINTN) gGdtEntries
  40   };
  41
  42 GLOBAL_REMOVE_IF_UNREFERENCED  IA32_DESCRIPTOR gLidtDescriptor = {
  43   sizeof (X64_IDT_GATE_DESCRIPTOR) * 32 - 1,
  44   0
  45 };
  46
  47
  48
  49
  50
  51 /**
  52    Transfers control to DxeCore.
  53
  54    This function performs a CPU architecture specific operations to execute
  55    the entry point of DxeCore with the parameters of HobList.
  56    It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.
  57
  58    @param DxeCoreEntryPoint         The entrypoint of DxeCore.
  59    @param HobList                   The start of HobList passed to DxeCore.
  60    @param EndOfPeiSignal            The PPI descriptor for EFI_END_OF_PEI_PPI.
  61
  62 **/
  63 VOID
  64 HandOffToDxeCore (
  65   IN EFI_PHYSICAL_ADDRESS   DxeCoreEntryPoint,
  66   IN EFI_PEI_HOB_POINTERS   HobList,
  67   IN EFI_PEI_PPI_DESCRIPTOR *EndOfPeiSignal
  68   )
  69 {
  70   EFI_STATUS                Status;
  71   EFI_PHYSICAL_ADDRESS      BaseOfStack;
  72   EFI_PHYSICAL_ADDRESS      TopOfStack;
  73   UINTN                     PageTables;
  74   X64_IDT_GATE_DESCRIPTOR   *IdtTable;
  75   UINTN                     SizeOfTemplate;
  76   VOID                      *TemplateBase;
  77   EFI_PHYSICAL_ADDRESS      VectorAddress;
  78   UINT32                    Index;
  79
  80   Status = PeiServicesAllocatePages (EfiBootServicesData, EFI_SIZE_TO_PAGES (STACK_SIZE), &BaseOfStack);
  81   ASSERT_EFI_ERROR (Status);
  82
  83   if (FeaturePcdGet(PcdDxeIplSwitchToLongMode)) {
  84     //
  85     // Compute the top of the stack we were allocated, which is used to load X64 dxe core.
  86     // Pre-allocate a 32 bytes which confroms to x64 calling convention.
  87     //
  88     // The first four parameters to a function are passed in rcx, rdx, r8 and r9.
  89     // Any further parameters are pushed on the stack. Furthermore, space (4 * 8bytes) for the
  90     // register parameters is reserved on the stack, in case the called function
  91     // wants to spill them; this is important if the function is variadic.
  92     //
  93     TopOfStack = BaseOfStack + EFI_SIZE_TO_PAGES (STACK_SIZE) * EFI_PAGE_SIZE - 32;
  94
  95     //
  96     //  X64 Calling Conventions requires that the stack must be aligned to 16 bytes
  97     //
  98     TopOfStack = (EFI_PHYSICAL_ADDRESS) (UINTN) ALIGN_POINTER (TopOfStack, 16);
  99
 100     //
 101     // Load the GDT of Go64. Since the GDT of 32-bit Tiano locates in the BS_DATA
 102     // memory, it may be corrupted when copying FV to high-end memory
 103     //
 104     AsmWriteGdtr (&gGdt);
 105     //
 106     // Create page table and save PageMapLevel4 to CR3
 107     //
 108     PageTables = CreateIdentityMappingPageTables ();
 109
 110     //
 111     // End of PEI phase singal
 112     //
 113     Status = PeiServicesInstallPpi (EndOfPeiSignal);
 114     ASSERT_EFI_ERROR (Status);
 115
 116     AsmWriteCr3 (PageTables);
 117
 118     //
 119     // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
 120     //
 121     UpdateStackHob (BaseOfStack, STACK_SIZE);
 122
 123     if (FeaturePcdGet (PcdDxeIplEnableIdt)) {
 124       SizeOfTemplate = AsmGetVectorTemplatInfo (&TemplateBase);
 125
 126       Status = PeiServicesAllocatePages (
 127                  EfiBootServicesData,
 128                  EFI_SIZE_TO_PAGES((SizeOfTemplate + sizeof (X64_IDT_GATE_DESCRIPTOR)) * 32),
 129                  &VectorAddress
 130                  );
 131
 132       ASSERT_EFI_ERROR (Status);
 133
 134       IdtTable      = (X64_IDT_GATE_DESCRIPTOR *) (UINTN) (VectorAddress + SizeOfTemplate * 32);
 135       for (Index = 0; Index < 32; Index++) {
 136         IdtTable[Index].Ia32IdtEntry.Bits.GateType    =  0x8e;
 137         IdtTable[Index].Ia32IdtEntry.Bits.Reserved_0  =  0;
 138         IdtTable[Index].Ia32IdtEntry.Bits.Selector    =  SYS_CODE64_SEL;
 139
 140         IdtTable[Index].Ia32IdtEntry.Bits.OffsetLow   = (UINT16) VectorAddress;
 141         IdtTable[Index].Ia32IdtEntry.Bits.OffsetHigh  = (UINT16) (RShiftU64 (VectorAddress, 16));
 142         IdtTable[Index].Offset32To63                  = (UINT32) (RShiftU64 (VectorAddress, 32));
 143         IdtTable[Index].Reserved                      = 0;
 144
 145         CopyMem ((VOID *) (UINTN) VectorAddress, TemplateBase, SizeOfTemplate);
 146         AsmVectorFixup ((VOID *) (UINTN) VectorAddress, (UINT8) Index);
 147
 148         VectorAddress += SizeOfTemplate;
 149       }
 150
 151       gLidtDescriptor.Base = (UINTN) IdtTable;
 152       AsmWriteIdtr (&gLidtDescriptor);
 153     }
 154     //
 155     // Go to Long Mode. Interrupts will not get turned on until the CPU AP is loaded.
 156     // Call x64 drivers passing in single argument, a pointer to the HOBs.
 157     //
 158     AsmEnablePaging64 (
 159       SYS_CODE64_SEL,
 160       DxeCoreEntryPoint,
 161       (EFI_PHYSICAL_ADDRESS)(UINTN)(HobList.Raw),
 162       0,
 163       TopOfStack
 164       );
 165   } else {
 166     //
 167     // Compute the top of the stack we were allocated. Pre-allocate a UINTN
 168     // for safety.
 169     //
 170     TopOfStack = BaseOfStack + EFI_SIZE_TO_PAGES (STACK_SIZE) * EFI_PAGE_SIZE - CPU_STACK_ALIGNMENT;
 171     TopOfStack = (EFI_PHYSICAL_ADDRESS) (UINTN) ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);
 172
 173     //
 174     // End of PEI phase singal
 175     //
 176     Status = PeiServicesInstallPpi (EndOfPeiSignal);
 177     ASSERT_EFI_ERROR (Status);
 178
 179     //
 180     // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
 181     //
 182     UpdateStackHob (BaseOfStack, STACK_SIZE);
 183
 184     SwitchStack (
 185       (SWITCH_STACK_ENTRY_POINT)(UINTN)DxeCoreEntryPoint,
 186       HobList.Raw,
 187       NULL,
 188       (VOID *) (UINTN) TopOfStack
 189       );
 190   }
 191 }
 192