IntelFSP介绍

　　概述
　　FSP（FirmwareSupportPackage）是Intelsilicon初始化代码的一个binary形式的发布包。
　　FSP主要提供chipset，processor初始化代码，并且很容易集成到当前的bootloaders。
　　FSP独立于bootloader，bootloader需要将FSP集成进来完成Intelsilicon初始化以外的一些功能例如：
　　1。初始化其它的非intelsilicon相关的硬件
　　2。总线枚举，例如pci总线，usb总线等总线枚举，目的是devicediscovery。
　　3。工业规范的支持，例如ACPI，SMBIOS等。FSP格式
　　1。FSP二进制格式遵循UEFIFirmwareVolumeSpecification。
　　2。FSP由几个components组成，每个component由一个或者多个FV组成。
　　3。Components包括FSPT，FSPM，FSPS，FSPI，FSPT。每个component只能有一个实例。
　　4。每个component的第一个FV的第一个ffs文件必须是FSPINFOHEADER（一个数据结构体）。这个结构用了传递bootloader用来和FSPbinary交互所需要的信息。
　　5。每个component包含一个可配置的数据区UPD（UpdateableProductData）。这个UPD包含的是FSPcomponent初始化参数。
　　FSPComponents
　　FSPT：主要目的是是初始化TemporaryRAM。
　　此阶段包含
　　TempRamInitAPI。
　　FSPM：主要目的是初始化内存。
　　此阶段包含如下FSPAPI
　　FspMemoryInit（）
　　FspMultiPhaseMemInit（）
　　FspRamExit（）
　　FSPS：主要目的是CPUIOcontroller等silicon相关初始化
　　此阶段包含如下FSPAPI
　　FspSiliconInit（）
　　FspMultiPhaseSiInit（）
　　NotifyPhase（）
　　FSPI：SMM初始化阶段
　　此阶段用来初始化SMM，提供OSSMM相关runtimesiliconservice，例如RAS。
　　此阶段包含如下FSPAPI
　　FspSmmInit（）FSPInformationTables
　　每一个FSPcomponent包含一个FSPINFOHEADERtable，至于其它table可以
　　有选择地包含。
　　所有的FSPtables必须遵循4bytes地址对齐。
　　所有的FSPtables必须以DWORDsignature，DWORDlengthfield开始。
　　通常来说一个通用的FSPtable查找通过搜寻相应的signature，直到FSPPsignature被发现而终止。
　　FSPINFOHEADER
　　Byte
　　Offset
　　Size
　　in
　　Bytes
　　Field
　　Description
　　0hr4hrSignature
　　FSPH
　　4hr4hrHeaderLength
　　Lengthoftheheaderinbytes。Thecurrentvalueis88。
　　8hr2hrReserved1
　　10hr1hrSpecVersion
　　11hr1hrHeaderRevision
　　12hr4hrImageRevision
　　RevisionoftheFSPbinary
　　16hr8hrImageId
　　24hr4hrImageSize
　　28hr4hrImageBase
　　32hr2hrImageAttribute
　　34hr2hrComponentAttribute
　　36hr4hrCfgRegionOffset
　　OffsetoftheUPDregion
　　40hr4hrCfgRegionSize
　　44hr4hrReserved2
　　48hr4hrTempRamInitEntryOfset
　　52hr4hrReseved3
　　。。。。。。
　　4hrOtherFSPAPIs
　　OffsetofotherAPIsFSPConfigurationData
　　每一个FSPcomponent包含一个configurabledataregion用做FSP初始化配置参数。
　　这个configurabledataregion称作UpdateableProductData（UPD）。
　　UPD参数可以被静态地客制化。可以利用BinaryConfigurationTool（BCT）
　　搭配BootSettingFile（BSF），BSPbinary来修改UPD。
　　UPD参数也可以被bootloader动态地overrided。
　　UPD以datastructure形式组织所有的配置参数。当bootloadercallTempRamInit（），
　　FspSiliconInit（）等FSPAPI时通常会将UPD配置参数以指针的形式传递给这些APIs。
　　如果传递的指针是NULL，那么FSP将要用静态buildin的UPD作为API参考的参数。
　　通常bootloader在callFSPAPIs之前会copybuildinUPD到memory，update相关的
　　memory中的UPD参数，再将updatedmemory中的UPD作为指针传递给FSPAPIs使用。
　　UPDstructure
　　Offset
　　Field
　　0x000x07
　　UPDRegionSignature。
　　XXXXXXTforFSPT
　　XXXXXXMforFSPM
　　XXXXXXSforFSPS
　　XXXXXXIforFSPI
　　0X08
　　RevisionoftheDatastructure
　　0x090x1F
　　Reserved〔23〕
　　0x20n
　　PlatformSpecificParametersFSPMode
　　FSPInteface分APIMode，DispatchMode。
　　UPD只能用于APImode，在dispatchmode，PPIdatabase，PCDdatabase用来作为
　　FSP和bootloader交互，因此dispachmode仅存在于UEFIbootloader。
　　dispatchmode不是FSP强制性要求支持，APImode被强制要求支持。
　　dispachmode是FSP可选择的支持模式，用来更好的集成FSP到UEFIbootloader环境。FSPAPIModeInterface
　　关于FSPAPI执行环境要求如下
　　中断必须关闭
　　FSPAPI只能被BSP执行
　　确保足够的堆栈空间
　　x8632bitAPImode
　　系统操作在32bitflatmode
　　代码段，数据段选择子对应的段描述符必须是4GB范围
　　x6464bitAPImode
　　系统操作在64bitlongmode，分页机制使能
　　FSP，bootloader的地址空间映射相同（物理地址即虚拟地址）
　　段选择子被要求设置flat模式（所谓平坦模式既一个段访问整个地址空间）
　　API调用约定
　　调用约定体现在参数传递的方式，参数传递的顺序，寄存器环境保存等。
　　FSPAPI32bit调用接口同c声明调用相似，也就是所有的参数是从右到左压入堆栈
　　FSPAPI64bit调用接口同EFIAPI类似FSPDispatchModeInterface
　　Dispatchmode是FSP实现的一个可选的模式，dispatchmode是用来使FSP方便容易地集成到UEFIbootloader中。
　　Dispatchmode启动流程遵循标准的PI规范，也就是遵守SEC，PEI，DXE，BDS四个PI启动流程。
　　Dispatchmode，FSTT，FSPM，FSPS，FSPI等所有组件只是作为PEIM或者DXE驱动的容器，直接将这些组件中的FVs暴漏给UEFIbootloader，UEFIbootloader从这些FVs加载相应的PEIMs或者DXE驱动在UEFIbootloader的PEIDXE执行环境执行。
　　在dispatchmode下PPIdatabase，PCDdatabase，HOB等在FSP和bootloader之间共享用来交互信息。
　　在dispatchmode下UPD不再被用。
　　在dispatchmode下NotifyPhase（）API也不再备用，取而代之的是FSPS中的DXE驱动实现UEFInativecallback。
　　在dispatchmode下FSP应该用DXEfundation环境提供的service中的一部分，下面这些service不应该使用
　　ExitBootServices（）
　　SetWatchdogTimer（）
　　SetTime（）
　　SetWakeupTIme（）
　　UpdateCapsule（）
　　QueryCapsuleCapblities（）
　　FSPdispatchmode完全遵循PI规范，因此大部分FSPAPIs是不需要的。但是无论如何PI定义了PEI和DXE阶段module的格式，例外的是没有定义SEC阶段module的格式，因此在dispatchmodeFSTT依然用FSPAPI模式下的TempRamInit（）。
　　基于dispatchmode启动流程PEIfoundation并没有在BFV中，按照PI规范，SEC必须传递EFIPEICOREFVLOCATIONPPI到PEIFoundationEntryPoint。
　　Dispatchmode下产生FSPTemporaryRAMExitPPI，这个PPI等同于TempRamExit（）FSPAPI，这个PPI是选择性要求。
　　Bootloader需要按照FSPMArchitectualConfigurationPPI，此PPI包含FSPM中的PEIM需要的配置数据。启动流程
　　APIModeBootFlow
　　DispatchModeBootFlow
　　唐爱六于2023。3。123