a2e61f341d
REF: https://bugzilla.tianocore.org/show_bug.cgi?id=1241 Add support for both API (original mode) and DISPATCH mode: 1. Add FspMode field from reserved byte of Global Data Structure to tell which mode is selected by boot loader. If boot loader invoking FSP-M API this field will remain as default 0 (API mode), otherwise platform FSP should set this field to 1 (Dispatch mode) when initializing Global Data Structure. 2. gFspInApiModePpiGuid will be instaled when FSP running in API mode and modules only for API mode should have this in depex. 3. If it is DISPATCH mode, FSP will return to PEI dispatcher, not directly return to boot loader. 4. DISPATCH mode supports DXE NotifyPhase drivers so FSP will not wait for PEI NotifyPhase callbacks, instead it will install gFspReadyForNotifyPhasePpiGuid PPI for platform to complete late initialization before transferring to DXE. Test: Verified FSP API and DISPATCH modes on 2 internal platforms and both boot successfully. Cc: Jiewen Yao <Jiewen.yao@intel.com> Cc: Desimone Nathaniel L <nathaniel.l.desimone@intel.com> Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Chasel Chiu <chasel.chiu@intel.com> Reviewed-by: Jiewen Yao <Jiewen.yao@intel.com>
72 lines
2.1 KiB
C
72 lines
2.1 KiB
C
/** @file
|
|
|
|
Copyright (c) 2014 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php.
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#ifndef _FSP_GLOBAL_DATA_H_
|
|
#define _FSP_GLOBAL_DATA_H_
|
|
|
|
#include <FspEas.h>
|
|
|
|
#define FSP_IN_API_MODE 0
|
|
#define FSP_IN_DISPATCH_MODE 1
|
|
|
|
#pragma pack(1)
|
|
|
|
typedef enum {
|
|
TempRamInitApiIndex,
|
|
FspInitApiIndex,
|
|
NotifyPhaseApiIndex,
|
|
FspMemoryInitApiIndex,
|
|
TempRamExitApiIndex,
|
|
FspSiliconInitApiIndex,
|
|
FspApiIndexMax
|
|
} FSP_API_INDEX;
|
|
|
|
typedef struct {
|
|
VOID *DataPtr;
|
|
UINT32 MicrocodeRegionBase;
|
|
UINT32 MicrocodeRegionSize;
|
|
UINT32 CodeRegionBase;
|
|
UINT32 CodeRegionSize;
|
|
} FSP_PLAT_DATA;
|
|
|
|
#define FSP_GLOBAL_DATA_SIGNATURE SIGNATURE_32 ('F', 'S', 'P', 'D')
|
|
#define FSP_PERFORMANCE_DATA_SIGNATURE SIGNATURE_32 ('P', 'E', 'R', 'F')
|
|
#define FSP_PERFORMANCE_DATA_TIMER_MASK 0xFFFFFFFFFFFFFF
|
|
|
|
typedef struct {
|
|
UINT32 Signature;
|
|
UINT8 Version;
|
|
UINT8 Reserved1[3];
|
|
UINT32 CoreStack;
|
|
UINT32 StatusCode;
|
|
UINT32 Reserved2[8];
|
|
FSP_PLAT_DATA PlatformData;
|
|
FSP_INFO_HEADER *FspInfoHeader;
|
|
VOID *UpdDataPtr;
|
|
VOID *TempRamInitUpdPtr;
|
|
VOID *MemoryInitUpdPtr;
|
|
VOID *SiliconInitUpdPtr;
|
|
UINT8 ApiIdx;
|
|
UINT8 FspMode; // 0: FSP in API mode; 1: FSP in DISPATCH mode
|
|
UINT8 Reserved3[30];
|
|
UINT32 PerfSig;
|
|
UINT16 PerfLen;
|
|
UINT16 Reserved4;
|
|
UINT32 PerfIdx;
|
|
UINT64 PerfData[32];
|
|
} FSP_GLOBAL_DATA;
|
|
|
|
#pragma pack()
|
|
|
|
#endif
|