[mirror_edk2.git] / UefiPayloadPkg / UefiPayloadEntry / UefiPayloadEntry.c

/** @file\r
\r
  Copyright (c) 2014 - 2021, Intel Corporation. All rights reserved.<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "UefiPayloadEntry.h"\r
\r
STATIC UINT32 mTopOfLowerUsableDram = 0;\r
\r
/**\r
   Callback function to build resource descriptor HOB\r
\r
   This function build a HOB based on the memory map entry info.\r
   It creates only EFI_RESOURCE_MEMORY_MAPPED_IO and EFI_RESOURCE_MEMORY_RESERVED\r
   resources.\r
\r
   @param MemoryMapEntry         Memory map entry info got from bootloader.\r
   @param Params                 A pointer to ACPI_BOARD_INFO.\r
\r
  @retval EFI_SUCCESS            Successfully build a HOB.\r
  @retval EFI_INVALID_PARAMETER  Invalid parameter provided.\r
**/\r
EFI_STATUS\r
MemInfoCallbackMmio (\r
  IN MEMROY_MAP_ENTRY          *MemoryMapEntry,\r
  IN VOID                      *Params\r
  )\r
{\r
  EFI_PHYSICAL_ADDRESS         Base;\r
  EFI_RESOURCE_TYPE            Type;\r
  UINT64                       Size;\r
  EFI_RESOURCE_ATTRIBUTE_TYPE  Attribue;\r
  ACPI_BOARD_INFO              *AcpiBoardInfo;\r
\r
  AcpiBoardInfo = (ACPI_BOARD_INFO *)Params;\r
  if (AcpiBoardInfo == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Skip types already handled in MemInfoCallback\r
  //\r
  if (MemoryMapEntry->Type == E820_RAM || MemoryMapEntry->Type == E820_ACPI) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  if (MemoryMapEntry->Base == AcpiBoardInfo->PcieBaseAddress) {\r
    //\r
    // MMCONF is always MMIO\r
    //\r
    Type = EFI_RESOURCE_MEMORY_MAPPED_IO;\r
  } else if (MemoryMapEntry->Base < mTopOfLowerUsableDram) {\r
    //\r
    // It's in DRAM and thus must be reserved\r
    //\r
    Type = EFI_RESOURCE_MEMORY_RESERVED;\r
  } else if ((MemoryMapEntry->Base < 0x100000000ULL) && (MemoryMapEntry->Base >= mTopOfLowerUsableDram)) {\r
    //\r
    // It's not in DRAM, must be MMIO\r
    //\r
    Type = EFI_RESOURCE_MEMORY_MAPPED_IO;\r
  } else {\r
    Type = EFI_RESOURCE_MEMORY_RESERVED;\r
  }\r
\r
  Base    = MemoryMapEntry->Base;\r
  Size    = MemoryMapEntry->Size;\r
\r
  Attribue = EFI_RESOURCE_ATTRIBUTE_PRESENT |\r
             EFI_RESOURCE_ATTRIBUTE_INITIALIZED |\r
             EFI_RESOURCE_ATTRIBUTE_TESTED |\r
             EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE;\r
\r
  BuildResourceDescriptorHob (Type, Attribue, (EFI_PHYSICAL_ADDRESS)Base, Size);\r
  DEBUG ((DEBUG_INFO , "buildhob: base = 0x%lx, size = 0x%lx, type = 0x%x\n", Base, Size, Type));\r
\r
  if (MemoryMapEntry->Type == E820_UNUSABLE ||\r
    MemoryMapEntry->Type == E820_DISABLED) {\r
    BuildMemoryAllocationHob (Base, Size, EfiUnusableMemory);\r
  } else if (MemoryMapEntry->Type == E820_PMEM) {\r
    BuildMemoryAllocationHob (Base, Size, EfiPersistentMemory);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
   Callback function to find TOLUD (Top of Lower Usable DRAM)\r
\r
   Estimate where TOLUD (Top of Lower Usable DRAM) resides. The exact position\r
   would require platform specific code.\r
\r
   @param MemoryMapEntry         Memory map entry info got from bootloader.\r
   @param Params                 Not used for now.\r
\r
  @retval EFI_SUCCESS            Successfully updated mTopOfLowerUsableDram.\r
**/\r
EFI_STATUS\r
FindToludCallback (\r
  IN MEMROY_MAP_ENTRY          *MemoryMapEntry,\r
  IN VOID                      *Params\r
  )\r
{\r
  //\r
  // This code assumes that the memory map on this x86 machine below 4GiB is continous\r
  // until TOLUD. In addition it assumes that the bootloader provided memory tables have\r
  // no "holes" and thus the first memory range not covered by e820 marks the end of\r
  // usable DRAM. In addition it's assumed that every reserved memory region touching\r
  // usable RAM is also covering DRAM, everything else that is marked reserved thus must be\r
  // MMIO not detectable by bootloader/OS\r
  //\r
\r
  //\r
  // Skip memory types not RAM or reserved\r
  //\r
  if ((MemoryMapEntry->Type == E820_UNUSABLE) || (MemoryMapEntry->Type == E820_DISABLED) ||\r
    (MemoryMapEntry->Type == E820_PMEM)) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // Skip resources above 4GiB\r
  //\r
  if ((MemoryMapEntry->Base + MemoryMapEntry->Size) > 0x100000000ULL) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  if ((MemoryMapEntry->Type == E820_RAM) || (MemoryMapEntry->Type == E820_ACPI) ||\r
    (MemoryMapEntry->Type == E820_NVS)) {\r
    //\r
    // It's usable DRAM. Update TOLUD.\r
    //\r
    if (mTopOfLowerUsableDram < (MemoryMapEntry->Base + MemoryMapEntry->Size)) {\r
      mTopOfLowerUsableDram = (UINT32)(MemoryMapEntry->Base + MemoryMapEntry->Size);\r
    }\r
  } else {\r
    //\r
    // It might be 'reserved DRAM' or 'MMIO'.\r
    //\r
    // If it touches usable DRAM at Base assume it's DRAM as well,\r
    // as it could be bootloader installed tables, TSEG, GTT, ...\r
    //\r
    if (mTopOfLowerUsableDram == MemoryMapEntry->Base) {\r
      mTopOfLowerUsableDram = (UINT32)(MemoryMapEntry->Base + MemoryMapEntry->Size);\r
    }\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
   Callback function to build resource descriptor HOB\r
\r
   This function build a HOB based on the memory map entry info.\r
   Only add EFI_RESOURCE_SYSTEM_MEMORY.\r
\r
   @param MemoryMapEntry         Memory map entry info got from bootloader.\r
   @param Params                 Not used for now.\r
\r
  @retval RETURN_SUCCESS        Successfully build a HOB.\r
**/\r
EFI_STATUS\r
MemInfoCallback (\r
  IN MEMROY_MAP_ENTRY          *MemoryMapEntry,\r
  IN VOID                      *Params\r
  )\r
{\r
  EFI_PHYSICAL_ADDRESS         Base;\r
  EFI_RESOURCE_TYPE            Type;\r
  UINT64                       Size;\r
  EFI_RESOURCE_ATTRIBUTE_TYPE  Attribue;\r
\r
  //\r
  // Skip everything not known to be usable DRAM.\r
  // It will be added later.\r
  //\r
  if ((MemoryMapEntry->Type != E820_RAM) && (MemoryMapEntry->Type != E820_ACPI) &&\r
    (MemoryMapEntry->Type != E820_NVS)) {\r
    return RETURN_SUCCESS;\r
  }\r
\r
  Type    = EFI_RESOURCE_SYSTEM_MEMORY;\r
  Base    = MemoryMapEntry->Base;\r
  Size    = MemoryMapEntry->Size;\r
\r
  Attribue = EFI_RESOURCE_ATTRIBUTE_PRESENT |\r
             EFI_RESOURCE_ATTRIBUTE_INITIALIZED |\r
             EFI_RESOURCE_ATTRIBUTE_TESTED |\r
             EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE |\r
             EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE;\r
\r
  BuildResourceDescriptorHob (Type, Attribue, (EFI_PHYSICAL_ADDRESS)Base, Size);\r
  DEBUG ((DEBUG_INFO , "buildhob: base = 0x%lx, size = 0x%lx, type = 0x%x\n", Base, Size, Type));\r
\r
  if (MemoryMapEntry->Type == E820_ACPI) {\r
    BuildMemoryAllocationHob (Base, Size, EfiACPIReclaimMemory);\r
  } else if (MemoryMapEntry->Type == E820_NVS) {\r
    BuildMemoryAllocationHob (Base, Size, EfiACPIMemoryNVS);\r
  }\r
\r
  return RETURN_SUCCESS;\r
}\r
\r
\r
\r
/**\r
  It will build HOBs based on information from bootloaders.\r
\r
  @retval EFI_SUCCESS        If it completed successfully.\r
  @retval Others             If it failed to build required HOBs.\r
**/\r
EFI_STATUS\r
BuildHobFromBl (\r
  VOID\r
  )\r
{\r
  EFI_STATUS                       Status;\r
  SYSTEM_TABLE_INFO                SysTableInfo;\r
  SYSTEM_TABLE_INFO                *NewSysTableInfo;\r
  ACPI_BOARD_INFO                  *AcpiBoardInfo;\r
  EFI_PEI_GRAPHICS_INFO_HOB        GfxInfo;\r
  EFI_PEI_GRAPHICS_INFO_HOB        *NewGfxInfo;\r
  EFI_PEI_GRAPHICS_DEVICE_INFO_HOB GfxDeviceInfo;\r
  EFI_PEI_GRAPHICS_DEVICE_INFO_HOB *NewGfxDeviceInfo;\r
  UNIVERSAL_PAYLOAD_SMBIOS_TABLE   *SmBiosTableHob;\r
  UNIVERSAL_PAYLOAD_ACPI_TABLE     *AcpiTableHob;\r
\r
  //\r
  // First find TOLUD\r
  //\r
  DEBUG ((DEBUG_INFO , "Guessing Top of Lower Usable DRAM:\n"));\r
  Status = ParseMemoryInfo (FindToludCallback, NULL);\r
  if (EFI_ERROR(Status)) {\r
    return Status;\r
  }\r
  DEBUG ((DEBUG_INFO , "Assuming TOLUD = 0x%x\n", mTopOfLowerUsableDram));\r
\r
  //\r
  // Parse memory info and build memory HOBs for Usable RAM\r
  //\r
  DEBUG ((DEBUG_INFO , "Building ResourceDescriptorHobs for usable memory:\n"));\r
  Status = ParseMemoryInfo (MemInfoCallback, NULL);\r
  if (EFI_ERROR(Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Create guid hob for frame buffer information\r
  //\r
  Status = ParseGfxInfo (&GfxInfo);\r
  if (!EFI_ERROR (Status)) {\r
    NewGfxInfo = BuildGuidHob (&gEfiGraphicsInfoHobGuid, sizeof (GfxInfo));\r
    ASSERT (NewGfxInfo != NULL);\r
    CopyMem (NewGfxInfo, &GfxInfo, sizeof (GfxInfo));\r
    DEBUG ((DEBUG_INFO, "Created graphics info hob\n"));\r
  }\r
\r
\r
  Status = ParseGfxDeviceInfo (&GfxDeviceInfo);\r
  if (!EFI_ERROR (Status)) {\r
    NewGfxDeviceInfo = BuildGuidHob (&gEfiGraphicsDeviceInfoHobGuid, sizeof (GfxDeviceInfo));\r
    ASSERT (NewGfxDeviceInfo != NULL);\r
    CopyMem (NewGfxDeviceInfo, &GfxDeviceInfo, sizeof (GfxDeviceInfo));\r
    DEBUG ((DEBUG_INFO, "Created graphics device info hob\n"));\r
  }\r
\r
\r
  //\r
  // Create guid hob for system tables like acpi table and smbios table\r
  //\r
  Status = ParseSystemTable(&SysTableInfo);\r
  ASSERT_EFI_ERROR (Status);\r
  if (!EFI_ERROR (Status)) {\r
    NewSysTableInfo = BuildGuidHob (&gUefiSystemTableInfoGuid, sizeof (SYSTEM_TABLE_INFO));\r
    ASSERT (NewSysTableInfo != NULL);\r
    CopyMem (NewSysTableInfo, &SysTableInfo, sizeof (SYSTEM_TABLE_INFO));\r
    DEBUG ((DEBUG_INFO, "Detected Acpi Table at 0x%lx, length 0x%x\n", SysTableInfo.AcpiTableBase, SysTableInfo.AcpiTableSize));\r
    DEBUG ((DEBUG_INFO, "Detected Smbios Table at 0x%lx, length 0x%x\n", SysTableInfo.SmbiosTableBase, SysTableInfo.SmbiosTableSize));\r
  }\r
  //\r
  // Creat SmBios table Hob\r
  //\r
  SmBiosTableHob = BuildGuidHob (&gUniversalPayloadSmbiosTableGuid, sizeof (UNIVERSAL_PAYLOAD_SMBIOS_TABLE));\r
  ASSERT (SmBiosTableHob != NULL);\r
  SmBiosTableHob->Header.Revision = UNIVERSAL_PAYLOAD_SMBIOS_TABLE_REVISION;\r
  SmBiosTableHob->Header.Length = sizeof (UNIVERSAL_PAYLOAD_SMBIOS_TABLE);\r
  SmBiosTableHob->SmBiosEntryPoint = SysTableInfo.SmbiosTableBase;\r
  DEBUG ((DEBUG_INFO, "Create smbios table gUniversalPayloadSmbiosTableGuid guid hob\n"));\r
\r
  //\r
  // Creat ACPI table Hob\r
  //\r
  AcpiTableHob = BuildGuidHob (&gUniversalPayloadAcpiTableGuid, sizeof (UNIVERSAL_PAYLOAD_ACPI_TABLE));\r
  ASSERT (AcpiTableHob != NULL);\r
  AcpiTableHob->Header.Revision = UNIVERSAL_PAYLOAD_ACPI_TABLE_REVISION;\r
  AcpiTableHob->Header.Length = sizeof (UNIVERSAL_PAYLOAD_ACPI_TABLE);\r
  AcpiTableHob->Rsdp = SysTableInfo.AcpiTableBase;\r
  DEBUG ((DEBUG_INFO, "Create smbios table gUniversalPayloadAcpiTableGuid guid hob\n"));\r
\r
  //\r
  // Create guid hob for acpi board information\r
  //\r
  AcpiBoardInfo = BuildHobFromAcpi (SysTableInfo.AcpiTableBase);\r
  ASSERT (AcpiBoardInfo != NULL);\r
\r
  //\r
  // Parse memory info and build memory HOBs for reserved DRAM and MMIO\r
  //\r
  DEBUG ((DEBUG_INFO , "Building ResourceDescriptorHobs for reserved memory:\n"));\r
  Status = ParseMemoryInfo (MemInfoCallbackMmio, AcpiBoardInfo);\r
  if (EFI_ERROR(Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Parse platform specific information.\r
  //\r
  Status = ParsePlatformInfo ();\r
  if (EFI_ERROR (Status)) {\r
    DEBUG ((DEBUG_ERROR, "Error when parsing platform info, Status = %r\n", Status));\r
    return Status;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  This function will build some generic HOBs that doesn't depend on information from bootloaders.\r
\r
**/\r
VOID\r
BuildGenericHob (\r
  VOID\r
  )\r
{\r
  UINT32                           RegEax;\r
  UINT8                            PhysicalAddressBits;\r
  EFI_RESOURCE_ATTRIBUTE_TYPE      ResourceAttribute;\r
\r
  // The UEFI payload FV\r
  BuildMemoryAllocationHob (PcdGet32 (PcdPayloadFdMemBase), PcdGet32 (PcdPayloadFdMemSize), EfiBootServicesData);\r
\r
  //\r
  // Build CPU memory space and IO space hob\r
  //\r
  AsmCpuid (0x80000000, &RegEax, NULL, NULL, NULL);\r
  if (RegEax >= 0x80000008) {\r
    AsmCpuid (0x80000008, &RegEax, NULL, NULL, NULL);\r
    PhysicalAddressBits = (UINT8) RegEax;\r
  } else {\r
    PhysicalAddressBits  = 36;\r
  }\r
\r
  BuildCpuHob (PhysicalAddressBits, 16);\r
\r
  //\r
  // Report Local APIC range, cause sbl HOB to be NULL, comment now\r
  //\r
  ResourceAttribute = (\r
      EFI_RESOURCE_ATTRIBUTE_PRESENT |\r
      EFI_RESOURCE_ATTRIBUTE_INITIALIZED |\r
      EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE |\r
      EFI_RESOURCE_ATTRIBUTE_TESTED\r
  );\r
  BuildResourceDescriptorHob (EFI_RESOURCE_MEMORY_MAPPED_IO, ResourceAttribute, 0xFEC80000, SIZE_512KB);\r
  BuildMemoryAllocationHob ( 0xFEC80000, SIZE_512KB, EfiMemoryMappedIO);\r
\r
}\r
\r
\r
/**\r
  Entry point to the C language phase of UEFI payload.\r
\r
  @retval      It will not return if SUCCESS, and return error when passing bootloader parameter.\r
**/\r
EFI_STATUS\r
EFIAPI\r
PayloadEntry (\r
  IN UINTN                     BootloaderParameter\r
  )\r
{\r
  EFI_STATUS                    Status;\r
  PHYSICAL_ADDRESS              DxeCoreEntryPoint;\r
  UINTN                         MemBase;\r
  UINTN                         HobMemBase;\r
  UINTN                         HobMemTop;\r
  EFI_PEI_HOB_POINTERS          Hob;\r
\r
  // Call constructor for all libraries\r
  ProcessLibraryConstructorList ();\r
\r
  DEBUG ((DEBUG_INFO, "GET_BOOTLOADER_PARAMETER() = 0x%lx\n", GET_BOOTLOADER_PARAMETER()));\r
  DEBUG ((DEBUG_INFO, "sizeof(UINTN) = 0x%x\n", sizeof(UINTN)));\r
\r
  // Initialize floating point operating environment to be compliant with UEFI spec.\r
  InitializeFloatingPointUnits ();\r
\r
  // HOB region is used for HOB and memory allocation for this module\r
  MemBase    = PcdGet32 (PcdPayloadFdMemBase);\r
  HobMemBase = ALIGN_VALUE (MemBase + PcdGet32 (PcdPayloadFdMemSize), SIZE_1MB);\r
  HobMemTop  = HobMemBase + FixedPcdGet32 (PcdSystemMemoryUefiRegionSize);\r
\r
  HobConstructor ((VOID *)MemBase, (VOID *)HobMemTop, (VOID *)HobMemBase, (VOID *)HobMemTop);\r
\r
  // Build HOB based on information from Bootloader\r
  Status = BuildHobFromBl ();\r
  if (EFI_ERROR (Status)) {\r
    DEBUG ((DEBUG_ERROR, "BuildHobFromBl Status = %r\n", Status));\r
    return Status;\r
  }\r
\r
  // Build other HOBs required by DXE\r
  BuildGenericHob ();\r
\r
  // Load the DXE Core\r
  Status = LoadDxeCore (&DxeCoreEntryPoint);\r
  ASSERT_EFI_ERROR (Status);\r
\r
  DEBUG ((DEBUG_INFO, "DxeCoreEntryPoint = 0x%lx\n", DxeCoreEntryPoint));\r
\r
  //\r
  // Mask off all legacy 8259 interrupt sources\r
  //\r
  IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, 0xFF);\r
  IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE,  0xFF);\r
\r
  Hob.HandoffInformationTable = (EFI_HOB_HANDOFF_INFO_TABLE *) GetFirstHob(EFI_HOB_TYPE_HANDOFF);\r
  HandOffToDxeCore (DxeCoreEntryPoint, Hob);\r
\r
  // Should not get here\r
  CpuDeadLoop ();\r
  return EFI_SUCCESS;\r
}\r
Commit	Line	Data
04af8bf2	1	/** @file\r
04af8bf2	2	\r
302a8f35	3	Copyright (c) 2014 - 2021, Intel Corporation. All rights reserved.<BR>\r
7c4ab1c2	4	SPDX-License-Identifier: BSD-2-Clause-Patent\r
04af8bf2 DG	5	\r
04af8bf2 DG	6	**/\r
04af8bf2	7	\r
7c4ab1c2	8	#include "UefiPayloadEntry.h"\r
04af8bf2	9	\r
1e5e58d3 PR	10	STATIC UINT32 mTopOfLowerUsableDram = 0;\r
1e5e58d3 PR	11	\r
04af8bf2	12	/**\r
7c4ab1c2	13	Callback function to build resource descriptor HOB\r
04af8bf2	14	\r
7c4ab1c2	15	This function build a HOB based on the memory map entry info.\r
1e5e58d3 PR	16	It creates only EFI_RESOURCE_MEMORY_MAPPED_IO and EFI_RESOURCE_MEMORY_RESERVED\r
	17	resources.\r
	18	\r
	19	@param MemoryMapEntry Memory map entry info got from bootloader.\r
	20	@param Params A pointer to ACPI_BOARD_INFO.\r
	21	\r
	22	@retval EFI_SUCCESS Successfully build a HOB.\r
	23	@retval EFI_INVALID_PARAMETER Invalid parameter provided.\r
	24	**/\r
	25	EFI_STATUS\r
	26	MemInfoCallbackMmio (\r
	27	IN MEMROY_MAP_ENTRY *MemoryMapEntry,\r
	28	IN VOID *Params\r
	29	)\r
	30	{\r
	31	EFI_PHYSICAL_ADDRESS Base;\r
	32	EFI_RESOURCE_TYPE Type;\r
	33	UINT64 Size;\r
	34	EFI_RESOURCE_ATTRIBUTE_TYPE Attribue;\r
	35	ACPI_BOARD_INFO *AcpiBoardInfo;\r
	36	\r
	37	AcpiBoardInfo = (ACPI_BOARD_INFO *)Params;\r
	38	if (AcpiBoardInfo == NULL) {\r
	39	return EFI_INVALID_PARAMETER;\r
	40	}\r
	41	\r
	42	//\r
	43	// Skip types already handled in MemInfoCallback\r
	44	//\r
	45	if (MemoryMapEntry->Type == E820_RAM \|\| MemoryMapEntry->Type == E820_ACPI) {\r
	46	return EFI_SUCCESS;\r
	47	}\r
	48	\r
	49	if (MemoryMapEntry->Base == AcpiBoardInfo->PcieBaseAddress) {\r
	50	//\r
	51	// MMCONF is always MMIO\r
	52	//\r
	53	Type = EFI_RESOURCE_MEMORY_MAPPED_IO;\r
	54	} else if (MemoryMapEntry->Base < mTopOfLowerUsableDram) {\r
	55	//\r
	56	// It's in DRAM and thus must be reserved\r
	57	//\r
	58	Type = EFI_RESOURCE_MEMORY_RESERVED;\r
	59	} else if ((MemoryMapEntry->Base < 0x100000000ULL) && (MemoryMapEntry->Base >= mTopOfLowerUsableDram)) {\r
	60	//\r
	61	// It's not in DRAM, must be MMIO\r
	62	//\r
	63	Type = EFI_RESOURCE_MEMORY_MAPPED_IO;\r
	64	} else {\r
	65	Type = EFI_RESOURCE_MEMORY_RESERVED;\r
	66	}\r
	67	\r
	68	Base = MemoryMapEntry->Base;\r
	69	Size = MemoryMapEntry->Size;\r
	70	\r
	71	Attribue = EFI_RESOURCE_ATTRIBUTE_PRESENT \|\r
	72	EFI_RESOURCE_ATTRIBUTE_INITIALIZED \|\r
	73	EFI_RESOURCE_ATTRIBUTE_TESTED \|\r
	74	EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE \|\r
	75	EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE \|\r
	76	EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE \|\r
	77	EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE;\r
	78	\r
	79	BuildResourceDescriptorHob (Type, Attribue, (EFI_PHYSICAL_ADDRESS)Base, Size);\r
80	DEBUG ((DEBUG_INFO , "buildhob: base = 0x%lx, size = 0x%lx, type = 0x%x\n", Base, Size, Type));\r
81	\r
82	if (MemoryMapEntry->Type == E820_UNUSABLE \|\|\r
83	MemoryMapEntry->Type == E820_DISABLED) {\r
84	BuildMemoryAllocationHob (Base, Size, EfiUnusableMemory);\r
85	} else if (MemoryMapEntry->Type == E820_PMEM) {\r
86	BuildMemoryAllocationHob (Base, Size, EfiPersistentMemory);\r
87	}\r
88	\r
89	return EFI_SUCCESS;\r
90	}\r
91	\r
92	\r
93	/**\r
94	Callback function to find TOLUD (Top of Lower Usable DRAM)\r
95	\r
96	Estimate where TOLUD (Top of Lower Usable DRAM) resides. The exact position\r
97	would require platform specific code.\r
98	\r
99	@param MemoryMapEntry Memory map entry info got from bootloader.\r
100	@param Params Not used for now.\r
101	\r
102	@retval EFI_SUCCESS Successfully updated mTopOfLowerUsableDram.\r
103	**/\r
104	EFI_STATUS\r
105	FindToludCallback (\r
106	IN MEMROY_MAP_ENTRY *MemoryMapEntry,\r
107	IN VOID *Params\r
108	)\r
109	{\r
110	//\r
111	// This code assumes that the memory map on this x86 machine below 4GiB is continous\r
112	// until TOLUD. In addition it assumes that the bootloader provided memory tables have\r
113	// no "holes" and thus the first memory range not covered by e820 marks the end of\r
114	// usable DRAM. In addition it's assumed that every reserved memory region touching\r
115	// usable RAM is also covering DRAM, everything else that is marked reserved thus must be\r
116	// MMIO not detectable by bootloader/OS\r
117	//\r
118	\r
119	//\r
120	// Skip memory types not RAM or reserved\r
121	//\r
122	if ((MemoryMapEntry->Type == E820_UNUSABLE) \|\| (MemoryMapEntry->Type == E820_DISABLED) \|\|\r
123	(MemoryMapEntry->Type == E820_PMEM)) {\r
124	return EFI_SUCCESS;\r
125	}\r
126	\r
127	//\r
128	// Skip resources above 4GiB\r
129	//\r
130	if ((MemoryMapEntry->Base + MemoryMapEntry->Size) > 0x100000000ULL) {\r
131	return EFI_SUCCESS;\r
132	}\r
133	\r
134	if ((MemoryMapEntry->Type == E820_RAM) \|\| (MemoryMapEntry->Type == E820_ACPI) \|\|\r
135	(MemoryMapEntry->Type == E820_NVS)) {\r
136	//\r
137	// It's usable DRAM. Update TOLUD.\r
138	//\r
139	if (mTopOfLowerUsableDram < (MemoryMapEntry->Base + MemoryMapEntry->Size)) {\r
140	mTopOfLowerUsableDram = (UINT32)(MemoryMapEntry->Base + MemoryMapEntry->Size);\r
141	}\r
142	} else {\r
143	//\r
144	// It might be 'reserved DRAM' or 'MMIO'.\r
145	//\r
146	// If it touches usable DRAM at Base assume it's DRAM as well,\r
147	// as it could be bootloader installed tables, TSEG, GTT, ...\r
148	//\r
149	if (mTopOfLowerUsableDram == MemoryMapEntry->Base) {\r
150	mTopOfLowerUsableDram = (UINT32)(MemoryMapEntry->Base + MemoryMapEntry->Size);\r
151	}\r
152	}\r
153	\r
154	return EFI_SUCCESS;\r
155	}\r
156	\r
157	\r
158	/**\r
159	Callback function to build resource descriptor HOB\r
160	\r
161	This function build a HOB based on the memory map entry info.\r
162	Only add EFI_RESOURCE_SYSTEM_MEMORY.\r
04af8bf2	163	\r
7c4ab1c2 GD	164	@param MemoryMapEntry Memory map entry info got from bootloader.\r
7c4ab1c2 GD	165	@param Params Not used for now.\r
04af8bf2	166	\r
7c4ab1c2	167	@retval RETURN_SUCCESS Successfully build a HOB.\r
04af8bf2	168	**/\r
7c4ab1c2 GD	169	EFI_STATUS\r
	170	MemInfoCallback (\r
	171	IN MEMROY_MAP_ENTRY *MemoryMapEntry,\r
	172	IN VOID *Params\r
04af8bf2 DG	173	)\r
04af8bf2 DG	174	{\r
7c4ab1c2 GD	175	EFI_PHYSICAL_ADDRESS Base;\r
	176	EFI_RESOURCE_TYPE Type;\r
	177	UINT64 Size;\r
	178	EFI_RESOURCE_ATTRIBUTE_TYPE Attribue;\r
04af8bf2	179	\r
1e5e58d3 PR	180	//\r
	181	// Skip everything not known to be usable DRAM.\r
	182	// It will be added later.\r
	183	//\r
	184	if ((MemoryMapEntry->Type != E820_RAM) && (MemoryMapEntry->Type != E820_ACPI) &&\r
	185	(MemoryMapEntry->Type != E820_NVS)) {\r
	186	return RETURN_SUCCESS;\r
	187	}\r
	188	\r
	189	Type = EFI_RESOURCE_SYSTEM_MEMORY;\r
7c4ab1c2 GD	190	Base = MemoryMapEntry->Base;\r
7c4ab1c2 GD	191	Size = MemoryMapEntry->Size;\r
04af8bf2	192	\r
7c4ab1c2 GD	193	Attribue = EFI_RESOURCE_ATTRIBUTE_PRESENT \|\r
	194	EFI_RESOURCE_ATTRIBUTE_INITIALIZED \|\r
	195	EFI_RESOURCE_ATTRIBUTE_TESTED \|\r
	196	EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE \|\r
	197	EFI_RESOURCE_ATTRIBUTE_WRITE_COMBINEABLE \|\r
	198	EFI_RESOURCE_ATTRIBUTE_WRITE_THROUGH_CACHEABLE \|\r
	199	EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE;\r
04af8bf2	200	\r
7c4ab1c2 GD	201	BuildResourceDescriptorHob (Type, Attribue, (EFI_PHYSICAL_ADDRESS)Base, Size);\r
7c4ab1c2 GD	202	DEBUG ((DEBUG_INFO , "buildhob: base = 0x%lx, size = 0x%lx, type = 0x%x\n", Base, Size, Type));\r
04af8bf2	203	\r
1e5e58d3 PR	204	if (MemoryMapEntry->Type == E820_ACPI) {\r
	205	BuildMemoryAllocationHob (Base, Size, EfiACPIReclaimMemory);\r
	206	} else if (MemoryMapEntry->Type == E820_NVS) {\r
	207	BuildMemoryAllocationHob (Base, Size, EfiACPIMemoryNVS);\r
	208	}\r
	209	\r
7c4ab1c2	210	return RETURN_SUCCESS;\r
04af8bf2 DG	211	}\r
	212	\r
	213	\r
7c4ab1c2	214	\r
04af8bf2	215	/**\r
7c4ab1c2	216	It will build HOBs based on information from bootloaders.\r
04af8bf2	217	\r
7c4ab1c2 GD	218	@retval EFI_SUCCESS If it completed successfully.\r
7c4ab1c2 GD	219	@retval Others If it failed to build required HOBs.\r
04af8bf2 DG	220	**/\r
04af8bf2 DG	221	EFI_STATUS\r
7c4ab1c2 GD	222	BuildHobFromBl (\r
7c4ab1c2 GD	223	VOID\r
04af8bf2 DG	224	)\r
	225	{\r
	226	EFI_STATUS Status;\r
04af8bf2 DG	227	SYSTEM_TABLE_INFO SysTableInfo;\r
04af8bf2 DG	228	SYSTEM_TABLE_INFO *NewSysTableInfo;\r
cc5a6726	229	ACPI_BOARD_INFO *AcpiBoardInfo;\r
04af8bf2 DG	230	EFI_PEI_GRAPHICS_INFO_HOB GfxInfo;\r
	231	EFI_PEI_GRAPHICS_INFO_HOB *NewGfxInfo;\r
	232	EFI_PEI_GRAPHICS_DEVICE_INFO_HOB GfxDeviceInfo;\r
	233	EFI_PEI_GRAPHICS_DEVICE_INFO_HOB *NewGfxDeviceInfo;\r
302a8f35	234	UNIVERSAL_PAYLOAD_SMBIOS_TABLE *SmBiosTableHob;\r
8c0d6780	235	UNIVERSAL_PAYLOAD_ACPI_TABLE *AcpiTableHob;\r
04af8bf2	236	\r
04af8bf2	237	//\r
1e5e58d3 PR	238	// First find TOLUD\r
	239	//\r
	240	DEBUG ((DEBUG_INFO , "Guessing Top of Lower Usable DRAM:\n"));\r
	241	Status = ParseMemoryInfo (FindToludCallback, NULL);\r
	242	if (EFI_ERROR(Status)) {\r
	243	return Status;\r
	244	}\r
	245	DEBUG ((DEBUG_INFO , "Assuming TOLUD = 0x%x\n", mTopOfLowerUsableDram));\r
	246	\r
	247	//\r
	248	// Parse memory info and build memory HOBs for Usable RAM\r
04af8bf2	249	//\r
1e5e58d3	250	DEBUG ((DEBUG_INFO , "Building ResourceDescriptorHobs for usable memory:\n"));\r
7c4ab1c2	251	Status = ParseMemoryInfo (MemInfoCallback, NULL);\r
04af8bf2 DG	252	if (EFI_ERROR(Status)) {\r
	253	return Status;\r
	254	}\r
	255	\r
04af8bf2 DG	256	//\r
	257	// Create guid hob for frame buffer information\r
	258	//\r
	259	Status = ParseGfxInfo (&GfxInfo);\r
	260	if (!EFI_ERROR (Status)) {\r
	261	NewGfxInfo = BuildGuidHob (&gEfiGraphicsInfoHobGuid, sizeof (GfxInfo));\r
	262	ASSERT (NewGfxInfo != NULL);\r
	263	CopyMem (NewGfxInfo, &GfxInfo, sizeof (GfxInfo));\r
	264	DEBUG ((DEBUG_INFO, "Created graphics info hob\n"));\r
	265	}\r
	266	\r
	267	\r
	268	Status = ParseGfxDeviceInfo (&GfxDeviceInfo);\r
	269	if (!EFI_ERROR (Status)) {\r
	270	NewGfxDeviceInfo = BuildGuidHob (&gEfiGraphicsDeviceInfoHobGuid, sizeof (GfxDeviceInfo));\r
	271	ASSERT (NewGfxDeviceInfo != NULL);\r
	272	CopyMem (NewGfxDeviceInfo, &GfxDeviceInfo, sizeof (GfxDeviceInfo));\r
	273	DEBUG ((DEBUG_INFO, "Created graphics device info hob\n"));\r
	274	}\r
	275	\r
	276	\r
	277	//\r
	278	// Create guid hob for system tables like acpi table and smbios table\r
	279	//\r
	280	Status = ParseSystemTable(&SysTableInfo);\r
	281	ASSERT_EFI_ERROR (Status);\r
	282	if (!EFI_ERROR (Status)) {\r
	283	NewSysTableInfo = BuildGuidHob (&gUefiSystemTableInfoGuid, sizeof (SYSTEM_TABLE_INFO));\r
	284	ASSERT (NewSysTableInfo != NULL);\r
	285	CopyMem (NewSysTableInfo, &SysTableInfo, sizeof (SYSTEM_TABLE_INFO));\r
	286	DEBUG ((DEBUG_INFO, "Detected Acpi Table at 0x%lx, length 0x%x\n", SysTableInfo.AcpiTableBase, SysTableInfo.AcpiTableSize));\r
	287	DEBUG ((DEBUG_INFO, "Detected Smbios Table at 0x%lx, length 0x%x\n", SysTableInfo.SmbiosTableBase, SysTableInfo.SmbiosTableSize));\r
	288	}\r
302a8f35 ZL	289	//\r
	290	// Creat SmBios table Hob\r
	291	//\r
	292	SmBiosTableHob = BuildGuidHob (&gUniversalPayloadSmbiosTableGuid, sizeof (UNIVERSAL_PAYLOAD_SMBIOS_TABLE));\r
	293	ASSERT (SmBiosTableHob != NULL);\r
	294	SmBiosTableHob->Header.Revision = UNIVERSAL_PAYLOAD_SMBIOS_TABLE_REVISION;\r
	295	SmBiosTableHob->Header.Length = sizeof (UNIVERSAL_PAYLOAD_SMBIOS_TABLE);\r
	296	SmBiosTableHob->SmBiosEntryPoint = SysTableInfo.SmbiosTableBase;\r
	297	DEBUG ((DEBUG_INFO, "Create smbios table gUniversalPayloadSmbiosTableGuid guid hob\n"));\r
04af8bf2	298	\r
8c0d6780 ZL	299	//\r
	300	// Creat ACPI table Hob\r
	301	//\r
	302	AcpiTableHob = BuildGuidHob (&gUniversalPayloadAcpiTableGuid, sizeof (UNIVERSAL_PAYLOAD_ACPI_TABLE));\r
	303	ASSERT (AcpiTableHob != NULL);\r
	304	AcpiTableHob->Header.Revision = UNIVERSAL_PAYLOAD_ACPI_TABLE_REVISION;\r
	305	AcpiTableHob->Header.Length = sizeof (UNIVERSAL_PAYLOAD_ACPI_TABLE);\r
	306	AcpiTableHob->Rsdp = SysTableInfo.AcpiTableBase;\r
	307	DEBUG ((DEBUG_INFO, "Create smbios table gUniversalPayloadAcpiTableGuid guid hob\n"));\r
	308	\r
04af8bf2 DG	309	//\r
	310	// Create guid hob for acpi board information\r
	311	//\r
cc5a6726 GD	312	AcpiBoardInfo = BuildHobFromAcpi (SysTableInfo.AcpiTableBase);\r
cc5a6726 GD	313	ASSERT (AcpiBoardInfo != NULL);\r
04af8bf2	314	\r
1e5e58d3 PR	315	//\r
	316	// Parse memory info and build memory HOBs for reserved DRAM and MMIO\r
	317	//\r
	318	DEBUG ((DEBUG_INFO , "Building ResourceDescriptorHobs for reserved memory:\n"));\r
cc5a6726	319	Status = ParseMemoryInfo (MemInfoCallbackMmio, AcpiBoardInfo);\r
1e5e58d3 PR	320	if (EFI_ERROR(Status)) {\r
	321	return Status;\r
	322	}\r
	323	\r
04af8bf2 DG	324	//\r
	325	// Parse platform specific information.\r
	326	//\r
	327	Status = ParsePlatformInfo ();\r
	328	if (EFI_ERROR (Status)) {\r
	329	DEBUG ((DEBUG_ERROR, "Error when parsing platform info, Status = %r\n", Status));\r
	330	return Status;\r
	331	}\r
	332	\r
7c4ab1c2 GD	333	return EFI_SUCCESS;\r
	334	}\r
	335	\r
	336	\r
	337	/**\r
	338	This function will build some generic HOBs that doesn't depend on information from bootloaders.\r
	339	\r
	340	**/\r
	341	VOID\r
	342	BuildGenericHob (\r
	343	VOID\r
	344	)\r
	345	{\r
	346	UINT32 RegEax;\r
	347	UINT8 PhysicalAddressBits;\r
	348	EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute;\r
	349	\r
	350	// The UEFI payload FV\r
	351	BuildMemoryAllocationHob (PcdGet32 (PcdPayloadFdMemBase), PcdGet32 (PcdPayloadFdMemSize), EfiBootServicesData);\r
	352	\r
	353	//\r
	354	// Build CPU memory space and IO space hob\r
	355	//\r
	356	AsmCpuid (0x80000000, &RegEax, NULL, NULL, NULL);\r
	357	if (RegEax >= 0x80000008) {\r
	358	AsmCpuid (0x80000008, &RegEax, NULL, NULL, NULL);\r
	359	PhysicalAddressBits = (UINT8) RegEax;\r
	360	} else {\r
	361	PhysicalAddressBits = 36;\r
	362	}\r
	363	\r
	364	BuildCpuHob (PhysicalAddressBits, 16);\r
	365	\r
	366	//\r
	367	// Report Local APIC range, cause sbl HOB to be NULL, comment now\r
	368	//\r
	369	ResourceAttribute = (\r
	370	EFI_RESOURCE_ATTRIBUTE_PRESENT \|\r
	371	EFI_RESOURCE_ATTRIBUTE_INITIALIZED \|\r
	372	EFI_RESOURCE_ATTRIBUTE_UNCACHEABLE \|\r
	373	EFI_RESOURCE_ATTRIBUTE_TESTED\r
	374	);\r
	375	BuildResourceDescriptorHob (EFI_RESOURCE_MEMORY_MAPPED_IO, ResourceAttribute, 0xFEC80000, SIZE_512KB);\r
	376	BuildMemoryAllocationHob ( 0xFEC80000, SIZE_512KB, EfiMemoryMappedIO);\r
	377	\r
	378	}\r
	379	\r
	380	\r
	381	/**\r
	382	Entry point to the C language phase of UEFI payload.\r
	383	\r
	384	@retval It will not return if SUCCESS, and return error when passing bootloader parameter.\r
	385	**/\r
	386	EFI_STATUS\r
	387	EFIAPI\r
	388	PayloadEntry (\r
	389	IN UINTN BootloaderParameter\r
	390	)\r
	391	{\r
	392	EFI_STATUS Status;\r
	393	PHYSICAL_ADDRESS DxeCoreEntryPoint;\r
7c4ab1c2	394	UINTN MemBase;\r
7c4ab1c2 GD	395	UINTN HobMemBase;\r
	396	UINTN HobMemTop;\r
	397	EFI_PEI_HOB_POINTERS Hob;\r
	398	\r
	399	// Call constructor for all libraries\r
	400	ProcessLibraryConstructorList ();\r
	401	\r
	402	DEBUG ((DEBUG_INFO, "GET_BOOTLOADER_PARAMETER() = 0x%lx\n", GET_BOOTLOADER_PARAMETER()));\r
	403	DEBUG ((DEBUG_INFO, "sizeof(UINTN) = 0x%x\n", sizeof(UINTN)));\r
	404	\r
	405	// Initialize floating point operating environment to be compliant with UEFI spec.\r
	406	InitializeFloatingPointUnits ();\r
	407	\r
	408	// HOB region is used for HOB and memory allocation for this module\r
	409	MemBase = PcdGet32 (PcdPayloadFdMemBase);\r
	410	HobMemBase = ALIGN_VALUE (MemBase + PcdGet32 (PcdPayloadFdMemSize), SIZE_1MB);\r
	411	HobMemTop = HobMemBase + FixedPcdGet32 (PcdSystemMemoryUefiRegionSize);\r
	412	\r
d63595c3	413	HobConstructor ((VOID )MemBase, (VOID )HobMemTop, (VOID )HobMemBase, (VOID )HobMemTop);\r
7c4ab1c2 GD	414	\r
	415	// Build HOB based on information from Bootloader\r
	416	Status = BuildHobFromBl ();\r
	417	if (EFI_ERROR (Status)) {\r
	418	DEBUG ((DEBUG_ERROR, "BuildHobFromBl Status = %r\n", Status));\r
	419	return Status;\r
	420	}\r
	421	\r
	422	// Build other HOBs required by DXE\r
	423	BuildGenericHob ();\r
	424	\r
	425	// Load the DXE Core\r
	426	Status = LoadDxeCore (&DxeCoreEntryPoint);\r
	427	ASSERT_EFI_ERROR (Status);\r
	428	\r
	429	DEBUG ((DEBUG_INFO, "DxeCoreEntryPoint = 0x%lx\n", DxeCoreEntryPoint));\r
	430	\r
04af8bf2 DG	431	//\r
	432	// Mask off all legacy 8259 interrupt sources\r
	433	//\r
	434	IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, 0xFF);\r
	435	IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, 0xFF);\r
	436	\r
fea7901d	437	Hob.HandoffInformationTable = (EFI_HOB_HANDOFF_INFO_TABLE *) GetFirstHob(EFI_HOB_TYPE_HANDOFF);\r
7c4ab1c2 GD	438	HandOffToDxeCore (DxeCoreEntryPoint, Hob);\r
	439	\r
	440	// Should not get here\r
	441	CpuDeadLoop ();\r
04af8bf2 DG	442	return EFI_SUCCESS;\r
04af8bf2 DG	443	}\r