UEFI学习笔记（五）：EDK II PCD的概念、类型、使用

一、基本概念

在 UEFI中，PCD（Platform Configuration Database）是一种用于管理平台配置数据的机制。PCD 允许固件和操作系统在运行时读取和修改配置数据，以支持系统的定制和优化。

目的

为了把代码中可配置的信息抽象出来成PCD，使得Module和Platform容易做定制化，不用修改源码，容易维护，便于改动。三个方面：
1）不仅可以在Build-time中可以通过编译选项配置，
2）在Run-time（boot过程）中也可以配置，
3）在Binary中也可以进行配置

二、PCD类型

（对应的数据类型都是基本数据类型）

1、FixedAtBuild

作用域在一个模块中（模块级的）。用于控制Feature，在build之后不能修改（相当于一个宏）。不同模块可以配置不同的值。只支持静态设置。

2、FeatureFlag

和FixedAtBuild是一样的作用，但是是Boolean类型。（同1的作用）

3、PatchableInModule

作用域在一个模块中（模块级的），可以在Binary Level进行修改。

4、Dynamic

作用域在整个系统中（系统级的）。动态的（在整个启动过程中可以set、get）。PCD的值存在memory里面，下次启动时，上次更改的值丢失了，每次启动都是从default值开始。

5、DynamicEx

与DynamicEx类似。区别是：
如果platform是从源码build出来的，没有binary在里面的时候，PCD用的都是Dynamic这种类型；
如果在BIOS里面有一些模块是binary方式集成进来的而这些binary又需要用到PCD（用于Binary Release），那么这些Binary集成的要用到的PCD就必须要设置为DynamicEx类型。

6、DynamicHii

作用域在整个系统中（系统级的）。动态的（在整个启动过程中可以set、get）。PCD的值和EFI Variable关联在一起（可能是non-volatile的，下次作启动还起效）

7、DynamicVpd

作用域在整个系统中（系统级的）。动态的（在整个启动过程中可以set、get）。是存在VPD空间的（在FLASH上，只读），一般是出厂配置。

三、PCD的使用

1、在.DEC中声明

[PcdsFixedAtBuild]gEmulatorPkgTokenSpaceGuid.PcdEmuFlashNvStorageVariableBase|0x0|UINT64|0x00001014

PCD的唯一性是通过GuidName和TokenNum（0x00001014）决定。GuidName、TokenNum不能修改了，Value可以修改。

2、在.INF中引用

在Pcd section中列出来，示例如下：

[Pcd]gEfiMdeModulePkgTokenSpaceGuid.PcdConOutRow                          ## PRODUCESgEfiMdeModulePkgTokenSpaceGuid.PcdConOutColumn                       ## PRODUCESgEfiMdeModulePkgTokenSpaceGuid.PcdVideoHorizontalResolution          ## PRODUCES

3、在.DSC中配置

设置PCD的值，示例如下：

[PcdsFixedAtBuild]gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0x0fgEfiMdePkgTokenSpaceGuid.PcdReportStatusCodePropertyMask|0x06gEfiMdeModulePkgTokenSpaceGuid.PcdMaxSizeNonPopulateCapsule|0x0

4、在.c中使用

通过PCB Library进行操作，最常用的是：PCDGetXX()、PCDSetXX()
（其中：XX = 8/16/32/Size/Ptr/Boolean），示例如下：

PcdStatus = PcdSet16S(PcdPlatformBootTimeOut， GetFrontPageTimeoutFromQemu);

Timeout = PcdGet16(PcdPlatformBootTimeOut);

四、特殊的PCD

参考文章

UEFI——PCD介绍