DuetPkg/DxeIpl/DxeInit.c

   1 /*++
   2
   3 Copyright (c) 2006 - 2007, Intel Corporation
   4 All rights reserved. This program and the accompanying materials
   5 are licensed and made available under the terms and conditions of the BSD License
   6 which accompanies this distribution.  The full text of the license may be found at
   7 http://opensource.org/licenses/bsd-license.php
   8
   9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  11
  12 Module Name:
  13   DxeInit.c
  14
  15 Abstract:
  16
  17 Revision History:
  18
  19 --*/
  20
  21 #include "DxeIpl.h"
  22
  23 #include "LegacyTable.h"
  24 #include "HobGeneration.h"
  25 #include "PpisNeededByDxeCore.h"
  26 #include "Debug.h"
  27
  28 /*
  29 --------------------------------------------------------
  30  Memory Map: (XX=32,64)
  31 --------------------------------------------------------
  32 0x0
  33         IVT
  34 0x400
  35         BDA
  36 0x500
  37
  38 0x7C00
  39         BootSector
  40 0x10000
  41         EfiLdr (relocate by efiXX.COM)
  42 0x15000
  43         Efivar.bin (Load by StartXX.COM)
  44 0x20000
  45         StartXX.COM (E820 table, Temporary GDT, Temporary IDT)
  46 0x21000
  47         EfiXX.COM (Temporary Interrupt Handler)
  48 0x22000
  49         EfiLdr.efi + DxeIpl.Z + DxeMain.Z + BFV.Z
  50 0x86000
  51         MemoryFreeUnder1M (For legacy driver DMA)
  52 0x90000
  53         Temporary 4G PageTable for X64 (6 page)
  54 0x9F800
  55         EBDA
  56 0xA0000
  57         VGA
  58 0xC0000
  59         OPROM
  60 0xE0000
  61         FIRMEWARE
  62 0x100000 (1M)
  63         Temporary Stack (1M)
  64 0x200000
  65
  66 MemoryAbove1MB.PhysicalStart <-----------------------------------------------------+
  67         ...                                                                        |
  68         ...                                                                        |
  69                         <- Phit.EfiMemoryBottom -------------------+               |
  70         HOB                                                        |               |
  71                         <- Phit.EfiFreeMemoryBottom                |               |
  72                                                                    |     MemoryFreeAbove1MB.ResourceLength
  73                         <- Phit.EfiFreeMemoryTop ------+           |               |
  74         MemoryDescriptor (For ACPINVS, ACPIReclaim)    |    4M = CONSUMED_MEMORY   |
  75                                                        |           |               |
  76         Permament 4G PageTable for IA32 or      MemoryAllocation   |               |
  77         Permament 64G PageTable for X64                |           |               |
  78                         <------------------------------+           |               |
  79         Permament Stack (0x20 Pages = 128K)                        |               |
  80                         <- Phit.EfiMemoryTop ----------+-----------+---------------+
  81         DxeCore                                                                    |
  82                                                                                 DxeCore
  83         DxeIpl                                                                     |
  84                         <----------------------------------------------------------+
  85         NvFV + FtwFV                                                               |
  86                                                                                  MMIO
  87         BFV                                                                        |
  88                         <- Top of Free Memory reported by E820 --------------------+
  89         ACPINVS        or
  90         ACPIReclaim    or
  91         Reserved
  92                         <- Memory Top on RealMemory
  93
  94 0x100000000 (4G)
  95
  96 MemoryFreeAbove4G.Physicalstart <--------------------------------------------------+
  97                                                                                    |
  98                                                                                    |
  99                                                                   MemoryFreeAbove4GB.ResourceLength
 100                                                                                    |
 101                                                                                    |
 102                                 <--------------------------------------------------+
 103 */
 104
 105 VOID
 106 EnterDxeMain (
 107   IN VOID *StackTop,
 108   IN VOID *DxeCoreEntryPoint,
 109   IN VOID *Hob,
 110   IN VOID *PageTable
 111   );
 112
 113 VOID
 114 DxeInit (
 115   IN EFILDRHANDOFF  *Handoff
 116   )
 117 /*++
 118
 119   Routine Description:
 120
 121     This is the entry point after this code has been loaded into memory.
 122
 123 Arguments:
 124
 125
 126 Returns:
 127
 128     Calls into EFI Firmware
 129
 130 --*/
 131 {
 132   VOID                  *StackTop;
 133   VOID                  *StackBottom;
 134   VOID                  *PageTableBase;
 135   VOID                  *MemoryTopOnDescriptor;
 136   VOID                  *MemoryDescriptor;
 137   VOID                  *NvStorageBase;
 138
 139 /*
 140   ClearScreen();
 141   PrintString("handoff:\n");
 142   PrintString("Handoff.BfvBase = ");
 143   PrintValue64((UINT64)(UINTN)Handoff->BfvBase);
 144   PrintString(", ");
 145   PrintString("BfvLength = ");
 146   PrintValue64(Handoff->BfvSize);
 147   PrintString("\n");
 148   PrintString("Handoff.DxeIplImageBase = ");
 149   PrintValue64((UINT64)(UINTN)Handoff->DxeIplImageBase);
 150   PrintString(", ");
 151   PrintString("DxeIplImageSize = ");
 152   PrintValue64(Handoff->DxeIplImageSize);
 153   PrintString("\n");
 154   PrintString("Handoff.DxeCoreImageBase = ");
 155   PrintValue64((UINT64)(UINTN)Handoff->DxeCoreImageBase);
 156   PrintString(", ");
 157   PrintString("DxeCoreImageSize = ");
 158   PrintValue64(Handoff->DxeCoreImageSize);
 159   PrintString("\n");
 160 */
 161   //
 162   // Hob Generation Guild line:
 163   //   * Don't report FV as physical memory
 164   //   * MemoryAllocation Hob should only cover physical memory
 165   //   * Use ResourceDescriptor Hob to report physical memory or Firmware Device and they shouldn't be overlapped
 166
 167   PrepareHobCpu ();
 168   //
 169   // 1. BFV
 170   //
 171   PrepareHobBfv (Handoff->BfvBase, Handoff->BfvSize);
 172
 173   //
 174   // 2. Updates Memory information, and get the top free address under 4GB
 175   //
 176   MemoryTopOnDescriptor = PrepareHobMemory (Handoff->MemDescCount, Handoff->MemDesc);
 177
 178   //
 179   // 3. Put [NV], [Stack], [PageTable], [MemDesc], [HOB] just below the [top free address under 4GB]
 180   //
 181
 182   //   3.1 NV data
 183   NvStorageBase = PrepareHobNvStorage (MemoryTopOnDescriptor);
 184   //   3.2 Stack
 185   StackTop = NvStorageBase;
 186   StackBottom = PrepareHobStack (StackTop);
 187   //   3.3 Page Table
 188   PageTableBase = PreparePageTable (StackBottom, gHob->Cpu.SizeOfMemorySpace);
 189   //   3.4 MemDesc (will be used in PlatformBds)
 190   MemoryDescriptor = PrepareHobMemoryDescriptor (PageTableBase, Handoff->MemDescCount, Handoff->MemDesc);
 191   //   3.5 Copy the Hob itself to EfiMemoryBottom, and update the PHIT Hob
 192   PrepareHobPhit (StackTop, MemoryDescriptor);
 193
 194   //
 195   // 4. Register the memory occupied by DxeCore and DxeIpl together as DxeCore
 196   //
 197   PrepareHobDxeCore (
 198     Handoff->DxeCoreEntryPoint,
 199     (EFI_PHYSICAL_ADDRESS)(UINTN)Handoff->DxeCoreImageBase,
 200     (UINTN)Handoff->DxeIplImageBase + (UINTN)Handoff->DxeIplImageSize - (UINTN)Handoff->DxeCoreImageBase
 201     );
 202
 203   PrepareHobLegacyTable (gHob);
 204   PreparePpisNeededByDxeCore (gHob);
 205
 206   CompleteHobGeneration ();
 207
 208 /*
 209   //
 210   // Print Hob Info
 211   //
 212   ClearScreen();
 213   PrintString("Hob Info\n");
 214   PrintString("Phit.EfiMemoryTop = ");
 215   PrintValue64(gHob->Phit.EfiMemoryTop);
 216   PrintString(" Phit.EfiMemoryBottom = ");
 217   PrintValue64(gHob->Phit.EfiMemoryBottom);
 218   PrintString("\n");
 219   PrintString("Phit.EfiFreeMemoryTop = ");
 220   PrintValue64(gHob->Phit.EfiFreeMemoryTop);
 221   PrintString(" Phit.EfiFreeMemoryBottom = ");
 222   PrintValue64(gHob->Phit.EfiFreeMemoryBottom);
 223   PrintString("\n");
 224   PrintString("Bfv = ");
 225   PrintValue64(gHob->Bfv.BaseAddress);
 226   PrintString(" BfvLength = ");
 227   PrintValue64(gHob->Bfv.Length);
 228   PrintString("\n");
 229   PrintString("NvStorageFvb = ");
 230   PrintValue64(gHob->NvStorageFvb.FvbInfo.Entries[0].Base);
 231   PrintString(" Length = ");
 232   PrintValue64(gHob->NvStorageFvb.FvbInfo.Entries[0].Length);
 233   PrintString("\n");
 234   PrintString("NvFtwFvb = ");
 235   PrintValue64(gHob->NvFtwFvb.FvbInfo.Entries[0].Base);
 236   PrintString(" Length = ");
 237   PrintValue64(gHob->NvFtwFvb.FvbInfo.Entries[0].Length);
 238   PrintString("\n");
 239   PrintString("Stack = ");
 240   PrintValue64(gHob->Stack.AllocDescriptor.MemoryBaseAddress);
 241   PrintString(" StackLength = ");
 242   PrintValue64(gHob->Stack.AllocDescriptor.MemoryLength);
 243   PrintString("\n");
 244   PrintString("MemoryFreeUnder1MB = ");
 245   PrintValue64(gHob->MemoryFreeUnder1MB.PhysicalStart);
 246   PrintString(" MemoryFreeUnder1MBLength = ");
 247   PrintValue64(gHob->MemoryFreeUnder1MB.ResourceLength);
 248   PrintString("\n");
 249   PrintString("MemoryAbove1MB = ");
 250   PrintValue64(gHob->MemoryAbove1MB.PhysicalStart);
 251   PrintString(" MemoryAbove1MBLength = ");
 252   PrintValue64(gHob->MemoryAbove1MB.ResourceLength);
 253   PrintString("\n");
 254   PrintString("MemoryAbove4GB = ");
 255   PrintValue64(gHob->MemoryAbove4GB.PhysicalStart);
 256   PrintString(" MemoryAbove4GBLength = ");
 257   PrintValue64(gHob->MemoryAbove4GB.ResourceLength);
 258   PrintString("\n");
 259   PrintString("DxeCore = ");
 260   PrintValue64(gHob->DxeCore.MemoryAllocationHeader.MemoryBaseAddress);
 261   PrintString(" DxeCoreLength = ");
 262   PrintValue64(gHob->DxeCore.MemoryAllocationHeader.MemoryLength);
 263   PrintString("\n");
 264   PrintString("MemoryAllocation = ");
 265   PrintValue64(gHob->MemoryAllocation.AllocDescriptor.MemoryBaseAddress);
 266   PrintString(" MemoryLength = ");
 267   PrintValue64(gHob->MemoryAllocation.AllocDescriptor.MemoryLength);
 268   PrintString("\n");
 269   EFI_DEADLOOP();
 270 */
 271
 272   ClearScreen();
 273   PrintString("\n\n\n\n\n\n\n\n\n\n");
 274   PrintString("                         WELCOME TO EFI WORLD!\n");
 275
 276   EnterDxeMain (StackTop, Handoff->DxeCoreEntryPoint, gHob, PageTableBase);
 277
 278   //
 279   // Should never get here
 280   //
 281   CpuDeadLoop ();
 282 }
 283