3 Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved.<BR>
\r
4 This program and the accompanying materials
\r
5 are licensed and made available under the terms and conditions of the BSD License
\r
6 which accompanies this distribution. The full text of the license may be found at
\r
7 http://opensource.org/licenses/bsd-license.php.
\r
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
\r
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
\r
18 Calculate the FSP IDT gate descriptor.
\r
20 @param[in] IdtEntryTemplate IDT gate descriptor template.
\r
22 @return FSP specific IDT gate descriptor.
\r
26 FspGetExceptionHandler(
\r
27 IN UINT64 IdtEntryTemplate
\r
31 UINT64 ExceptionHandler;
\r
32 IA32_IDT_GATE_DESCRIPTOR *IdtGateDescriptor;
\r
33 FSP_INFO_HEADER *FspInfoHeader;
\r
35 FspInfoHeader = (FSP_INFO_HEADER *)AsmGetFspInfoHeader();
\r
36 ExceptionHandler = IdtEntryTemplate;
\r
37 IdtGateDescriptor = (IA32_IDT_GATE_DESCRIPTOR *)&ExceptionHandler;
\r
38 Entry = (IdtGateDescriptor->Bits.OffsetHigh << 16) | IdtGateDescriptor->Bits.OffsetLow;
\r
39 Entry = FspInfoHeader->ImageBase + FspInfoHeader->ImageSize - (~Entry + 1);
\r
40 IdtGateDescriptor->Bits.OffsetHigh = (UINT16)(Entry >> 16);
\r
41 IdtGateDescriptor->Bits.OffsetLow = (UINT16)Entry;
\r
43 return ExceptionHandler;
\r
47 This interface fills platform specific data.
\r
49 @param[in,out] FspData Pointer to the FSP global data.
\r
54 SecGetPlatformData (
\r
55 IN OUT FSP_GLOBAL_DATA *FspData
\r
58 FSP_PLAT_DATA *FspPlatformData;
\r
63 FspPlatformData = &FspData->PlatformData;
\r
66 // The entries of platform information, together with the number of them,
\r
67 // reside in the bottom of stack, left untouched by normal stack operation.
\r
70 FspPlatformData->DataPtr = NULL;
\r
71 FspPlatformData->MicrocodeRegionBase = 0;
\r
72 FspPlatformData->MicrocodeRegionSize = 0;
\r
73 FspPlatformData->CodeRegionBase = 0;
\r
74 FspPlatformData->CodeRegionSize = 0;
\r
77 // Pointer to the size field
\r
79 TopOfCar = FspPlatformData->CarBase + FspPlatformData->CarSize;
\r
80 StackPtr = (UINT32 *)(TopOfCar - sizeof (UINT32));
\r
82 if (*(StackPtr - 1) == FSP_MCUD_SIGNATURE) {
\r
83 while (*StackPtr != 0) {
\r
84 if (*(StackPtr - 1) == FSP_MCUD_SIGNATURE) {
\r
86 // This following data was pushed onto stack after TempRamInit API
\r
89 StackPtr = StackPtr - 1 - DwordSize;
\r
90 CopyMem (&(FspPlatformData->MicrocodeRegionBase), StackPtr, (DwordSize << 2));
\r
92 } else if (*(StackPtr - 1) == FSP_PER0_SIGNATURE) {
\r
94 // This is the performance data for InitTempMemory API entry/exit
\r
97 StackPtr = StackPtr - 1 - DwordSize;
\r
98 CopyMem (FspData->PerfData, StackPtr, (DwordSize << 2));
\r
100 ((UINT8 *)(&FspData->PerfData[0]))[7] = FSP_PERF_ID_API_TEMP_RAM_INIT_ENTRY;
\r
101 ((UINT8 *)(&FspData->PerfData[1]))[7] = FSP_PERF_ID_API_TEMP_RAM_INIT_EXIT;
\r
105 StackPtr -= (*StackPtr);
\r
113 Initialize the FSP global data region.
\r
114 It needs to be done as soon as possible after the stack is setup.
\r
116 @param[in,out] PeiFspData Pointer of the FSP global data.
\r
117 @param[in] BootLoaderStack BootLoader stack.
\r
118 @param[in] ApiIdx The index of the FSP API.
\r
122 FspGlobalDataInit (
\r
123 IN OUT FSP_GLOBAL_DATA *PeiFspData,
\r
124 IN UINT32 BootLoaderStack,
\r
128 VOID *FspmUpdDataPtr;
\r
133 // Set FSP Global Data pointer
\r
135 SetFspGlobalDataPointer (PeiFspData);
\r
136 ZeroMem ((VOID *)PeiFspData, sizeof(FSP_GLOBAL_DATA));
\r
138 PeiFspData->Signature = FSP_GLOBAL_DATA_SIGNATURE;
\r
139 PeiFspData->Version = 0;
\r
140 PeiFspData->CoreStack = BootLoaderStack;
\r
141 PeiFspData->PerfIdx = 2;
\r
142 PeiFspData->PerfSig = FSP_PERFORMANCE_DATA_SIGNATURE;
\r
143 PeiFspData->PlatformData.CarBase = AsmReadMsr32 (0x200) & ~(0x6);
\r
144 PeiFspData->PlatformData.CarSize = ~(AsmReadMsr32(0x201) & ~(0x800)) + 1;
\r
146 SetFspMeasurePoint (FSP_PERF_ID_API_FSP_MEMORY_INIT_ENTRY);
\r
149 // Get FSP Header offset
\r
150 // It may have multiple FVs, so look into the last one for FSP header
\r
152 PeiFspData->FspInfoHeader = (FSP_INFO_HEADER *)AsmGetFspInfoHeader();
\r
153 SecGetPlatformData (PeiFspData);
\r
156 // Set API calling mode
\r
158 SetFspApiCallingIndex (ApiIdx);
\r
163 FspmUpdDataPtr = (VOID *) GetFspApiParameter ();
\r
164 if (FspmUpdDataPtr == NULL) {
\r
165 FspmUpdDataPtr = (VOID *)(PeiFspData->FspInfoHeader->ImageBase + PeiFspData->FspInfoHeader->CfgRegionOffset);
\r
167 SetFspUpdDataPointer (FspmUpdDataPtr);
\r
168 SetFspMemoryInitUpdDataPointer (FspmUpdDataPtr);
\r
169 SetFspSiliconInitUpdDataPointer (NULL);
\r
172 // Initialize serial port
\r
173 // It might have been done in ProcessLibraryConstructorList(), however,
\r
174 // the FSP global data is not initialized at that time. So do it again
\r
177 SerialPortInitialize ();
\r
180 // Ensure the golbal data pointer is valid
\r
182 ASSERT (GetFspGlobalDataPointer () == PeiFspData);
\r
184 for (Idx = 0; Idx < 8; Idx++) {
\r
185 ImageId[Idx] = PeiFspData->FspInfoHeader->ImageId[Idx];
\r
189 DEBUG ((DEBUG_INFO | DEBUG_INIT, "\n============= FSP Spec v%d.%d Header Revision v%x (%a v%x.%x.%x.%x) =============\n", \
\r
190 (PeiFspData->FspInfoHeader->SpecVersion >> 4) & 0xF, \
\r
191 PeiFspData->FspInfoHeader->SpecVersion & 0xF, \
\r
192 PeiFspData->FspInfoHeader->HeaderRevision, \
\r
194 (PeiFspData->FspInfoHeader->ImageRevision >> 24) & 0xFF, \
\r
195 (PeiFspData->FspInfoHeader->ImageRevision >> 16) & 0xFF, \
\r
196 (PeiFspData->FspInfoHeader->ImageRevision >> 8) & 0xFF, \
\r
197 PeiFspData->FspInfoHeader->ImageRevision & 0xFF));
\r
202 Adjust the FSP data pointers after the stack is migrated to memory.
\r
204 @param[in] OffsetGap The offset gap between the old stack and the new stack.
\r
208 FspDataPointerFixUp (
\r
209 IN UINT32 OffsetGap
\r
212 FSP_GLOBAL_DATA *NewFspData;
\r
214 NewFspData = (FSP_GLOBAL_DATA *)((UINTN)GetFspGlobalDataPointer() + (UINTN)OffsetGap);
\r
215 SetFspGlobalDataPointer (NewFspData);
\r