PeiFspPolicyUpdateLib.c 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186
  1. /** @file
  2. Provide FSP wrapper platform related function.
  3. Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>
  4. SPDX-License-Identifier: BSD-2-Clause-Patent
  5. **/
  6. #include <PiPei.h>
  7. #include <Library/PcdLib.h>
  8. #include <Library/DebugLib.h>
  9. #include <Library/BaseMemoryLib.h>
  10. #include <Library/MemoryAllocationLib.h>
  11. #include <Library/FspWrapperApiLib.h>
  12. #include <Library/SiliconPolicyUpdateLib.h>
  13. #include <FspEas.h>
  14. #include <FspmUpd.h>
  15. #include <FspsUpd.h>
  16. /**
  17. Performs FSP Misc UPD initialization.
  18. @param[in][out] FspmUpd Pointer to FSPM_UPD Data.
  19. @retval EFI_SUCCESS FSP UPD Data is updated.
  20. **/
  21. EFI_STATUS
  22. EFIAPI
  23. PeiFspMiscUpdUpdatePreMem (
  24. IN OUT FSPM_UPD *FspmUpd
  25. );
  26. /**
  27. Performs FSP PCH PEI Policy pre mem initialization.
  28. @param[in][out] FspmUpd Pointer to FSP UPD Data.
  29. @retval EFI_SUCCESS FSP UPD Data is updated.
  30. @retval EFI_NOT_FOUND Fail to locate required PPI.
  31. @retval Other FSP UPD Data update process fail.
  32. **/
  33. EFI_STATUS
  34. EFIAPI
  35. PeiFspPchPolicyUpdatePreMem (
  36. IN OUT FSPM_UPD *FspmUpd
  37. );
  38. /**
  39. Performs FSP PCH PEI Policy initialization.
  40. @param[in][out] FspsUpd Pointer to FSP UPD Data.
  41. @retval EFI_SUCCESS FSP UPD Data is updated.
  42. @retval EFI_NOT_FOUND Fail to locate required PPI.
  43. @retval Other FSP UPD Data update process fail.
  44. **/
  45. EFI_STATUS
  46. EFIAPI
  47. PeiFspPchPolicyUpdate (
  48. IN OUT FSPS_UPD *FspsUpd
  49. );
  50. /**
  51. Performs FSP SA PEI Policy initialization in pre-memory.
  52. @param[in][out] FspmUpd Pointer to FSP UPD Data.
  53. @retval EFI_SUCCESS FSP UPD Data is updated.
  54. @retval EFI_NOT_FOUND Fail to locate required PPI.
  55. @retval Other FSP UPD Data update process fail.
  56. **/
  57. EFI_STATUS
  58. EFIAPI
  59. PeiFspSaPolicyUpdatePreMem (
  60. IN OUT FSPM_UPD *FspmUpd
  61. );
  62. /**
  63. Performs FSP SA PEI Policy initialization.
  64. @param[in][out] FspsUpd Pointer to FSP UPD Data.
  65. @retval EFI_SUCCESS FSP UPD Data is updated.
  66. @retval EFI_NOT_FOUND Fail to locate required PPI.
  67. @retval Other FSP UPD Data update process fail.
  68. **/
  69. EFI_STATUS
  70. EFIAPI
  71. PeiFspSaPolicyUpdate (
  72. IN OUT FSPS_UPD *FspsUpd
  73. );
  74. VOID
  75. InternalPrintVariableData (
  76. IN UINT8 *Data8,
  77. IN UINTN DataSize
  78. )
  79. {
  80. UINTN Index;
  81. for (Index = 0; Index < DataSize; Index++) {
  82. if (Index % 0x10 == 0) {
  83. DEBUG ((DEBUG_INFO, "\n%08X:", Index));
  84. }
  85. DEBUG ((DEBUG_INFO, " %02X", *Data8++));
  86. }
  87. DEBUG ((DEBUG_INFO, "\n"));
  88. }
  89. /**
  90. Performs silicon pre-mem policy update.
  91. The meaning of Policy is defined by silicon code.
  92. It could be the raw data, a handle, a PPI, etc.
  93. The input Policy must be returned by SiliconPolicyDonePreMem().
  94. 1) In FSP path, the input Policy should be FspmUpd.
  95. A platform may use this API to update the FSPM UPD policy initialized
  96. by the silicon module or the default UPD data.
  97. The output of FSPM UPD data from this API is the final UPD data.
  98. 2) In non-FSP path, the board may use additional way to get
  99. the silicon policy data field based upon the input Policy.
  100. @param[in, out] Policy Pointer to policy.
  101. @return the updated policy.
  102. **/
  103. VOID *
  104. EFIAPI
  105. SiliconPolicyUpdatePreMem (
  106. IN OUT VOID *FspmUpd
  107. )
  108. {
  109. FSPM_UPD *FspmUpdDataPtr;
  110. FspmUpdDataPtr = FspmUpd;
  111. PeiFspSaPolicyUpdatePreMem (FspmUpdDataPtr);
  112. PeiFspPchPolicyUpdatePreMem (FspmUpdDataPtr);
  113. PeiFspMiscUpdUpdatePreMem (FspmUpdDataPtr);
  114. InternalPrintVariableData ((VOID *)FspmUpdDataPtr, sizeof(FSPM_UPD));
  115. return FspmUpd;
  116. }
  117. /**
  118. Performs silicon post-mem policy update.
  119. The meaning of Policy is defined by silicon code.
  120. It could be the raw data, a handle, a PPI, etc.
  121. The input Policy must be returned by SiliconPolicyDonePostMem().
  122. 1) In FSP path, the input Policy should be FspsUpd.
  123. A platform may use this API to update the FSPS UPD policy initialized
  124. by the silicon module or the default UPD data.
  125. The output of FSPS UPD data from this API is the final UPD data.
  126. 2) In non-FSP path, the board may use additional way to get
  127. the silicon policy data field based upon the input Policy.
  128. @param[in, out] Policy Pointer to policy.
  129. @return the updated policy.
  130. **/
  131. VOID *
  132. EFIAPI
  133. SiliconPolicyUpdatePostMem (
  134. IN OUT VOID *FspsUpd
  135. )
  136. {
  137. FSPS_UPD *FspsUpdDataPtr;
  138. FspsUpdDataPtr = FspsUpd;
  139. PeiFspSaPolicyUpdate (FspsUpdDataPtr);
  140. PeiFspPchPolicyUpdate (FspsUpdDataPtr);
  141. InternalPrintVariableData ((VOID *)FspsUpdDataPtr, sizeof(FSPS_UPD));
  142. return FspsUpd;
  143. }