2 EFI PEI Core memory services
4 Copyright (c) 2006, Intel Corporation
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
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.
19 Initialize the memory services.
21 @param PrivateData Points to PeiCore's private instance data.
22 @param SecCoreData Points to a data structure containing information about the PEI core's operating
23 environment, such as the size and location of temporary RAM, the stack location and
25 @param OldCoreData Pointer to the PEI Core data.
26 NULL if being run in non-permament memory mode.
30 InitializeMemoryServices (
31 IN PEI_CORE_INSTANCE
*PrivateData
,
32 IN CONST EFI_SEC_PEI_HAND_OFF
*SecCoreData
,
33 IN PEI_CORE_INSTANCE
*OldCoreData
37 PrivateData
->SwitchStackSignal
= FALSE
;
40 // First entering PeiCore, following code will initialized some field
41 // in PeiCore's private data according to hand off data from sec core.
43 if (OldCoreData
== NULL
) {
45 PrivateData
->PeiMemoryInstalled
= FALSE
;
46 PrivateData
->HobList
.Raw
= SecCoreData
->PeiTemporaryRamBase
;
48 PeiCoreBuildHobHandoffInfoTable (
49 BOOT_WITH_FULL_CONFIGURATION
,
50 (EFI_PHYSICAL_ADDRESS
) (UINTN
) SecCoreData
->PeiTemporaryRamBase
,
51 (UINTN
) SecCoreData
->PeiTemporaryRamSize
55 // Set PS to point to ServiceTableShadow in Cache
57 PrivateData
->PS
= &(PrivateData
->ServiceTableShadow
);
65 This function registers the found memory configuration with the PEI Foundation.
67 The usage model is that the PEIM that discovers the permanent memory shall invoke this service.
68 This routine will hold discoveried memory information into PeiCore's private data,
69 and set SwitchStackSignal flag. After PEIM who discovery memory is dispatched,
70 PeiDispatcher will migrate temporary memory to permenement memory.
72 @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
73 @param MemoryBegin Start of memory address.
74 @param MemoryLength Length of memory.
76 @return EFI_SUCCESS Always success.
82 IN CONST EFI_PEI_SERVICES
**PeiServices
,
83 IN EFI_PHYSICAL_ADDRESS MemoryBegin
,
84 IN UINT64 MemoryLength
87 PEI_CORE_INSTANCE
*PrivateData
;
89 DEBUG ((EFI_D_INFO
, "PeiInstallPeiMemory MemoryBegin 0x%LX, MemoryLength 0x%LX\n", MemoryBegin
, MemoryLength
));
90 PrivateData
= PEI_CORE_INSTANCE_FROM_PS_THIS (PeiServices
);
92 PrivateData
->PhysicalMemoryBegin
= MemoryBegin
;
93 PrivateData
->PhysicalMemoryLength
= MemoryLength
;
94 PrivateData
->FreePhysicalMemoryTop
= MemoryBegin
+ MemoryLength
;
96 PrivateData
->SwitchStackSignal
= TRUE
;
103 Memory allocation service on permanent memory,
104 not usable prior to the memory installation.
107 @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
108 @param MemoryType Type of memory to allocate.
109 @param Pages Number of pages to allocate.
110 @param Memory Pointer of memory allocated.
112 @retval EFI_SUCCESS The allocation was successful
113 @retval EFI_NOT_AVAILABLE_YET Called with permanent memory not available
114 @retval EFI_OUT_OF_RESOURCES There is not enough HOB heap to satisfy the requirement
115 to allocate the number of pages.
121 IN CONST EFI_PEI_SERVICES
**PeiServices
,
122 IN EFI_MEMORY_TYPE MemoryType
,
124 OUT EFI_PHYSICAL_ADDRESS
*Memory
127 PEI_CORE_INSTANCE
*PrivateData
;
128 EFI_PEI_HOB_POINTERS Hob
;
129 EFI_PHYSICAL_ADDRESS
*FreeMemoryTop
;
130 EFI_PHYSICAL_ADDRESS
*FreeMemoryBottom
;
131 UINTN RemainingPages
;
133 PrivateData
= PEI_CORE_INSTANCE_FROM_PS_THIS (PeiServices
);
134 Hob
.Raw
= PrivateData
->HobList
.Raw
;
137 // Check if Hob already available
139 if (!PrivateData
->PeiMemoryInstalled
) {
141 // When PeiInstallMemory is called but CAR has *not* been moved to temporary memory,
142 // the AllocatePage will depend on the field of PEI_CORE_INSTANCE structure.
144 if (!PrivateData
->SwitchStackSignal
) {
145 return EFI_NOT_AVAILABLE_YET
;
147 FreeMemoryTop
= &(PrivateData
->FreePhysicalMemoryTop
);
148 FreeMemoryBottom
= &(PrivateData
->PhysicalMemoryBegin
);
151 FreeMemoryTop
= &(Hob
.HandoffInformationTable
->EfiFreeMemoryTop
);
152 FreeMemoryBottom
= &(Hob
.HandoffInformationTable
->EfiFreeMemoryBottom
);
156 // Check to see if on 4k boundary, If not aligned, make the allocation aligned.
158 *(FreeMemoryTop
) -= *(FreeMemoryTop
) & 0xFFF;
161 // Verify that there is sufficient memory to satisfy the allocation
163 RemainingPages
= EFI_SIZE_TO_PAGES ((UINTN
) (*FreeMemoryTop
- *FreeMemoryBottom
));
165 // For page allocation, the overhead sizeof (EFI_HOB_MEMORY_ALLOCATION) needs one extra page.
166 // So the number of remaining pages needs to be greater than that of the request pages.
168 if (RemainingPages
<= Pages
) {
169 DEBUG ((EFI_D_ERROR
, "AllocatePages failed: No 0x%lx Pages is available.\n", (UINT64
) Pages
));
170 DEBUG ((EFI_D_ERROR
, "There is only left 0x%lx pages memory resource to be allocated.\n", (UINT64
) RemainingPages
));
171 return EFI_OUT_OF_RESOURCES
;
174 // Update the PHIT to reflect the memory usage
176 *(FreeMemoryTop
) -= Pages
* EFI_PAGE_SIZE
;
179 // Update the value for the caller
181 *Memory
= *(FreeMemoryTop
);
184 // Create a memory allocation HOB.
186 BuildMemoryAllocationHob (
188 Pages
* EFI_PAGE_SIZE
,
198 Pool allocation service. Before permenent memory is discoveried, the pool will
199 be allocated the heap in the CAR. Genenrally, the size of heap in temporary
200 memory does not exceed to 64K, so the biggest pool size could be allocated is
203 @param PeiServices An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
204 @param Size Amount of memory required
205 @param Buffer Address of pointer to the buffer
207 @retval EFI_SUCCESS The allocation was successful
208 @retval EFI_OUT_OF_RESOURCES There is not enough heap to satisfy the requirement
209 to allocate the requested size.
215 IN CONST EFI_PEI_SERVICES
**PeiServices
,
221 EFI_HOB_MEMORY_POOL
*Hob
;
224 // If some "post-memory" PEIM wishes to allocate larger pool,
225 // it should use AllocatePages service instead.
229 // Generally, the size of heap in temporary memory does not exceed to 64K,
230 // so the maxmium size of pool is 0x10000 - sizeof (EFI_HOB_MEMORY_POOL)
232 ASSERT (Size
< 0x10000 - sizeof (EFI_HOB_MEMORY_POOL
));
233 Status
= PeiServicesCreateHob (
234 EFI_HOB_TYPE_MEMORY_POOL
,
235 (UINT16
)(sizeof (EFI_HOB_MEMORY_POOL
) + Size
),