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    Transfers control to DxeCore.
  49
  50    This function performs a CPU architecture specific operations to execute
  51    the entry point of DxeCore with the parameters of HobList.
  52    It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.
  53
  54    @param DxeCoreEntryPoint         The entrypoint of DxeCore.
  55    @param HobList                   The start of HobList passed to DxeCore.
  56    @param EndOfPeiSignal            The PPI descriptor for EFI_END_OF_PEI_PPI.
  57
  58 **/
  59 VOID
  60 HandOffToDxeCore (
  61   IN EFI_PHYSICAL_ADDRESS   DxeCoreEntryPoint,
  62   IN EFI_PEI_HOB_POINTERS   HobList,
  63   IN EFI_PEI_PPI_DESCRIPTOR *EndOfPeiSignal
  64   )
  65 {
  66   EFI_STATUS                Status;
  67   EFI_PHYSICAL_ADDRESS      BaseOfStack;
  68   EFI_PHYSICAL_ADDRESS      TopOfStack;
  69   UINTN                     PageTables;
  70   X64_IDT_GATE_DESCRIPTOR   *IdtTable;
  71   UINTN                     SizeOfTemplate;
  72   VOID                      *TemplateBase;
  73   EFI_PHYSICAL_ADDRESS      VectorAddress;
  74   UINT32                    Index;
  75
  76   Status = PeiServicesAllocatePages (EfiBootServicesData, EFI_SIZE_TO_PAGES (STACK_SIZE), &BaseOfStack);
  77   ASSERT_EFI_ERROR (Status);
  78
  79   if (FeaturePcdGet(PcdDxeIplSwitchToLongMode)) {
  80     //
  81     // Compute the top of the stack we were allocated, which is used to load X64 dxe core.
  82     // Pre-allocate a 32 bytes which confroms to x64 calling convention.
  83     //
  84     // The first four parameters to a function are passed in rcx, rdx, r8 and r9.
  85     // Any further parameters are pushed on the stack. Furthermore, space (4 * 8bytes) for the
  86     // register parameters is reserved on the stack, in case the called function
  87     // wants to spill them; this is important if the function is variadic.
  88     //
  89     TopOfStack = BaseOfStack + EFI_SIZE_TO_PAGES (STACK_SIZE) * EFI_PAGE_SIZE - 32;
  90
  91     //
  92     //  x64 Calling Conventions requires that the stack must be aligned to 16 bytes
  93     //
  94     TopOfStack = (EFI_PHYSICAL_ADDRESS) (UINTN) ALIGN_POINTER (TopOfStack, 16);
  95
  96     //
  97     // Load the GDT of Go64. Since the GDT of 32-bit Tiano locates in the BS_DATA
  98     // memory, it may be corrupted when copying FV to high-end memory
  99     //
 100     AsmWriteGdtr (&gGdt);
 101     //
 102     // Create page table and save PageMapLevel4 to CR3
 103     //
 104     PageTables = CreateIdentityMappingPageTables ();
 105
 106     //
 107     // End of PEI phase singal
 108     //
 109     Status = PeiServicesInstallPpi (EndOfPeiSignal);
 110     ASSERT_EFI_ERROR (Status);
 111
 112     AsmWriteCr3 (PageTables);
 113
 114     //
 115     // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
 116     //
 117     UpdateStackHob (BaseOfStack, STACK_SIZE);
 118
 119     if (FeaturePcdGet (PcdDxeIplEnableIdt)) {
 120       SizeOfTemplate = AsmGetVectorTemplatInfo (&TemplateBase);
 121
 122       Status = PeiServicesAllocatePages (
 123                  EfiBootServicesData,
 124                  EFI_SIZE_TO_PAGES((SizeOfTemplate + sizeof (X64_IDT_GATE_DESCRIPTOR)) * 32),
 125                  &VectorAddress
 126                  );
 127       ASSERT_EFI_ERROR (Status);
 128
 129       IdtTable      = (X64_IDT_GATE_DESCRIPTOR *) (UINTN) (VectorAddress + SizeOfTemplate * 32);
 130       for (Index = 0; Index < 32; Index++) {
 131         IdtTable[Index].Ia32IdtEntry.Bits.GateType    =  0x8e;
 132         IdtTable[Index].Ia32IdtEntry.Bits.Reserved_0  =  0;
 133         IdtTable[Index].Ia32IdtEntry.Bits.Selector    =  SYS_CODE64_SEL;
 134
 135         IdtTable[Index].Ia32IdtEntry.Bits.OffsetLow   = (UINT16) VectorAddress;
 136         IdtTable[Index].Ia32IdtEntry.Bits.OffsetHigh  = (UINT16) (RShiftU64 (VectorAddress, 16));
 137         IdtTable[Index].Offset32To63                  = (UINT32) (RShiftU64 (VectorAddress, 32));
 138         IdtTable[Index].Reserved                      = 0;
 139
 140         CopyMem ((VOID *) (UINTN) VectorAddress, TemplateBase, SizeOfTemplate);
 141         AsmVectorFixup ((VOID *) (UINTN) VectorAddress, (UINT8) Index);
 142
 143         VectorAddress += SizeOfTemplate;
 144       }
 145
 146       gLidtDescriptor.Base = (UINTN) IdtTable;
 147       AsmWriteIdtr (&gLidtDescriptor);
 148     }
 149     //
 150     // Go to Long Mode and transfer control to DxeCore.
 151     // Interrupts will not get turned on until the CPU AP is loaded.
 152     // Call x64 drivers passing in single argument, a pointer to the HOBs.
 153     //
 154     AsmEnablePaging64 (
 155       SYS_CODE64_SEL,
 156       DxeCoreEntryPoint,
 157       (EFI_PHYSICAL_ADDRESS)(UINTN)(HobList.Raw),
 158       0,
 159       TopOfStack
 160       );
 161   } else {
 162     //
 163     // Compute the top of the stack we were allocated. Pre-allocate a UINTN
 164     // for safety.
 165     //
 166     TopOfStack = BaseOfStack + EFI_SIZE_TO_PAGES (STACK_SIZE) * EFI_PAGE_SIZE - CPU_STACK_ALIGNMENT;
 167     TopOfStack = (EFI_PHYSICAL_ADDRESS) (UINTN) ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);
 168
 169     //
 170     // End of PEI phase singal
 171     //
 172     Status = PeiServicesInstallPpi (EndOfPeiSignal);
 173     ASSERT_EFI_ERROR (Status);
 174
 175     //
 176     // Update the contents of BSP stack HOB to reflect the real stack info passed to DxeCore.
 177     //
 178     UpdateStackHob (BaseOfStack, STACK_SIZE);
 179
 180     //
 181     // Transfer the control to the entry point of DxeCore.
 182     //
 183     SwitchStack (
 184       (SWITCH_STACK_ENTRY_POINT)(UINTN)DxeCoreEntryPoint,
 185       HobList.Raw,
 186       NULL,
 187       (VOID *) (UINTN) TopOfStack
 188       );
 189   }
 190 }
 191