2 # Routines for generating AutoGen.h and AutoGen.c
4 # Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
5 # This program and the accompanying materials
6 # are licensed and made available under the terms and conditions of the BSD License
7 # which accompanies this distribution. The full text of the license may be found at
8 # http://opensource.org/licenses/bsd-license.php
10 # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
19 from Common
import EdkLogger
21 from Common
.BuildToolError
import *
22 from Common
.DataType
import *
23 from Common
.Misc
import *
24 from Common
.String
import StringToArray
25 from StrGather
import *
26 from GenPcdDb
import CreatePcdDatabaseCode
27 from IdfClassObject
import *
30 gItemTypeStringDatabase
= {
31 TAB_PCDS_FEATURE_FLAG
: 'FixedAtBuild',
32 TAB_PCDS_FIXED_AT_BUILD
: 'FixedAtBuild',
33 TAB_PCDS_PATCHABLE_IN_MODULE
: 'BinaryPatch',
34 TAB_PCDS_DYNAMIC
: '',
35 TAB_PCDS_DYNAMIC_DEFAULT
: '',
36 TAB_PCDS_DYNAMIC_VPD
: '',
37 TAB_PCDS_DYNAMIC_HII
: '',
38 TAB_PCDS_DYNAMIC_EX
: '',
39 TAB_PCDS_DYNAMIC_EX_DEFAULT
: '',
40 TAB_PCDS_DYNAMIC_EX_VPD
: '',
41 TAB_PCDS_DYNAMIC_EX_HII
: '',
44 _NumericDataTypesList
= ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN']
47 gDynamicPcd
= [TAB_PCDS_DYNAMIC
, TAB_PCDS_DYNAMIC_DEFAULT
, TAB_PCDS_DYNAMIC_VPD
, TAB_PCDS_DYNAMIC_HII
]
49 ## Dynamic-ex PCD types
50 gDynamicExPcd
= [TAB_PCDS_DYNAMIC_EX
, TAB_PCDS_DYNAMIC_EX_DEFAULT
, TAB_PCDS_DYNAMIC_EX_VPD
, TAB_PCDS_DYNAMIC_EX_HII
]
53 gDatumSizeStringDatabase
= {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'BOOLEAN','VOID*':'8'}
54 gDatumSizeStringDatabaseH
= {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'BOOL','VOID*':'PTR'}
55 gDatumSizeStringDatabaseLib
= {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'Bool','VOID*':'Ptr'}
57 ## AutoGen File Header Templates
58 gAutoGenHeaderString
= TemplateString("""\
64 Abstract: Auto-generated ${FileName} for building module or library.
68 gAutoGenHPrologueString
= TemplateString("""
69 #ifndef _${File}_${Guid}
70 #define _${File}_${Guid}
74 gAutoGenHCppPrologueString
= """\
81 gAutoGenHEpilogueString
= """
90 ## PEI Core Entry Point Templates
91 gPeiCoreEntryPointPrototype
= TemplateString("""
96 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,
97 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,
103 gPeiCoreEntryPointString
= TemplateString("""
107 ProcessModuleEntryPointList (
108 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,
109 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,
114 ${Function} (SecCoreData, PpiList, Context);
120 ## DXE Core Entry Point Templates
121 gDxeCoreEntryPointPrototype
= TemplateString("""
131 gDxeCoreEntryPointString
= TemplateString("""
135 ProcessModuleEntryPointList (
140 ${Function} (HobStart);
145 ## PEIM Entry Point Templates
146 gPeimEntryPointPrototype
= TemplateString("""
151 IN EFI_PEI_FILE_HANDLE FileHandle,
152 IN CONST EFI_PEI_SERVICES **PeiServices
157 gPeimEntryPointString
= [
159 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};
163 ProcessModuleEntryPointList (
164 IN EFI_PEI_FILE_HANDLE FileHandle,
165 IN CONST EFI_PEI_SERVICES **PeiServices
173 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};
177 ProcessModuleEntryPointList (
178 IN EFI_PEI_FILE_HANDLE FileHandle,
179 IN CONST EFI_PEI_SERVICES **PeiServices
183 return ${Function} (FileHandle, PeiServices);
188 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};
192 ProcessModuleEntryPointList (
193 IN EFI_PEI_FILE_HANDLE FileHandle,
194 IN CONST EFI_PEI_SERVICES **PeiServices
199 EFI_STATUS CombinedStatus;
201 CombinedStatus = EFI_LOAD_ERROR;
203 Status = ${Function} (FileHandle, PeiServices);
204 if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {
205 CombinedStatus = Status;
208 return CombinedStatus;
213 ## SMM_CORE Entry Point Templates
214 gSmmCoreEntryPointPrototype
= TemplateString("""
219 IN EFI_HANDLE ImageHandle,
220 IN EFI_SYSTEM_TABLE *SystemTable
225 gSmmCoreEntryPointString
= TemplateString("""
227 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
228 const UINT32 _gDxeRevision = ${PiSpecVersion};
232 ProcessModuleEntryPointList (
233 IN EFI_HANDLE ImageHandle,
234 IN EFI_SYSTEM_TABLE *SystemTable
237 return ${Function} (ImageHandle, SystemTable);
242 ## MM_CORE_STANDALONE Entry Point Templates
243 gMmCoreStandaloneEntryPointPrototype
= TemplateString("""
253 gMmCoreStandaloneEntryPointString
= TemplateString("""
255 const UINT32 _gMmRevision = ${PiSpecVersion};
259 ProcessModuleEntryPointList (
263 ${Function} (HobStart);
268 ## MM_STANDALONE Entry Point Templates
269 gMmStandaloneEntryPointPrototype
= TemplateString("""
274 IN EFI_HANDLE ImageHandle,
275 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
280 gMmStandaloneEntryPointString
= [
282 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};
286 ProcessModuleEntryPointList (
287 IN EFI_HANDLE ImageHandle,
288 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
296 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};
300 ProcessModuleEntryPointList (
301 IN EFI_HANDLE ImageHandle,
302 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
306 return ${Function} (ImageHandle, MmSystemTable);
311 GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};
315 ProcessModuleEntryPointList (
316 IN EFI_HANDLE ImageHandle,
317 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
322 EFI_STATUS CombinedStatus;
324 CombinedStatus = EFI_LOAD_ERROR;
326 Status = ${Function} (ImageHandle, MmSystemTable);
327 if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {
328 CombinedStatus = Status;
331 return CombinedStatus;
336 ## DXE SMM Entry Point Templates
337 gDxeSmmEntryPointPrototype
= TemplateString("""
342 IN EFI_HANDLE ImageHandle,
343 IN EFI_SYSTEM_TABLE *SystemTable
348 gDxeSmmEntryPointString
= [
350 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
351 const UINT32 _gDxeRevision = ${PiSpecVersion};
355 ProcessModuleEntryPointList (
356 IN EFI_HANDLE ImageHandle,
357 IN EFI_SYSTEM_TABLE *SystemTable
365 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
366 const UINT32 _gDxeRevision = ${PiSpecVersion};
368 static BASE_LIBRARY_JUMP_BUFFER mJumpContext;
369 static EFI_STATUS mDriverEntryPointStatus;
377 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {
378 mDriverEntryPointStatus = Status;
380 LongJump (&mJumpContext, (UINTN)-1);
386 ProcessModuleEntryPointList (
387 IN EFI_HANDLE ImageHandle,
388 IN EFI_SYSTEM_TABLE *SystemTable
391 mDriverEntryPointStatus = EFI_LOAD_ERROR;
394 if (SetJump (&mJumpContext) == 0) {
395 ExitDriver (${Function} (ImageHandle, SystemTable));
400 return mDriverEntryPointStatus;
405 ## UEFI Driver Entry Point Templates
406 gUefiDriverEntryPointPrototype
= TemplateString("""
411 IN EFI_HANDLE ImageHandle,
412 IN EFI_SYSTEM_TABLE *SystemTable
417 gUefiDriverEntryPointString
= [
419 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
420 const UINT32 _gDxeRevision = ${PiSpecVersion};
424 ProcessModuleEntryPointList (
425 IN EFI_HANDLE ImageHandle,
426 IN EFI_SYSTEM_TABLE *SystemTable
433 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
434 const UINT32 _gDxeRevision = ${PiSpecVersion};
439 ProcessModuleEntryPointList (
440 IN EFI_HANDLE ImageHandle,
441 IN EFI_SYSTEM_TABLE *SystemTable
445 return ${Function} (ImageHandle, SystemTable);
454 if (EFI_ERROR (Status)) {
455 ProcessLibraryDestructorList (gImageHandle, gST);
457 gBS->Exit (gImageHandle, Status, 0, NULL);
461 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
462 const UINT32 _gDxeRevision = ${PiSpecVersion};
464 static BASE_LIBRARY_JUMP_BUFFER mJumpContext;
465 static EFI_STATUS mDriverEntryPointStatus;
469 ProcessModuleEntryPointList (
470 IN EFI_HANDLE ImageHandle,
471 IN EFI_SYSTEM_TABLE *SystemTable
474 mDriverEntryPointStatus = EFI_LOAD_ERROR;
476 if (SetJump (&mJumpContext) == 0) {
477 ExitDriver (${Function} (ImageHandle, SystemTable));
481 return mDriverEntryPointStatus;
490 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {
491 mDriverEntryPointStatus = Status;
493 LongJump (&mJumpContext, (UINTN)-1);
500 ## UEFI Application Entry Point Templates
501 gUefiApplicationEntryPointPrototype
= TemplateString("""
506 IN EFI_HANDLE ImageHandle,
507 IN EFI_SYSTEM_TABLE *SystemTable
512 gUefiApplicationEntryPointString
= [
514 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
518 ProcessModuleEntryPointList (
519 IN EFI_HANDLE ImageHandle,
520 IN EFI_SYSTEM_TABLE *SystemTable
527 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
532 ProcessModuleEntryPointList (
533 IN EFI_HANDLE ImageHandle,
534 IN EFI_SYSTEM_TABLE *SystemTable
538 return ${Function} (ImageHandle, SystemTable);
547 if (EFI_ERROR (Status)) {
548 ProcessLibraryDestructorList (gImageHandle, gST);
550 gBS->Exit (gImageHandle, Status, 0, NULL);
554 const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};
558 ProcessModuleEntryPointList (
559 IN EFI_HANDLE ImageHandle,
560 IN EFI_SYSTEM_TABLE *SystemTable
565 if (SetJump (&mJumpContext) == 0) {
566 ExitDriver (${Function} (ImageHandle, SystemTable));
570 return mDriverEntryPointStatus;
573 static BASE_LIBRARY_JUMP_BUFFER mJumpContext;
574 static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;
582 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {
583 mDriverEntryPointStatus = Status;
585 LongJump (&mJumpContext, (UINTN)-1);
591 ## UEFI Unload Image Templates
592 gUefiUnloadImagePrototype
= TemplateString("""
597 IN EFI_HANDLE ImageHandle
602 gUefiUnloadImageString
= [
604 GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};
608 ProcessModuleUnloadList (
609 IN EFI_HANDLE ImageHandle
616 GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};
621 ProcessModuleUnloadList (
622 IN EFI_HANDLE ImageHandle
625 return ${Function} (ImageHandle);
630 GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};
634 ProcessModuleUnloadList (
635 IN EFI_HANDLE ImageHandle
640 Status = EFI_SUCCESS;
642 if (EFI_ERROR (Status)) {
643 ${Function} (ImageHandle);
645 Status = ${Function} (ImageHandle);
653 gLibraryStructorPrototype
= {
654 'BASE' : TemplateString("""${BEGIN}
662 'PEI' : TemplateString("""${BEGIN}
666 IN EFI_PEI_FILE_HANDLE FileHandle,
667 IN CONST EFI_PEI_SERVICES **PeiServices
671 'DXE' : TemplateString("""${BEGIN}
675 IN EFI_HANDLE ImageHandle,
676 IN EFI_SYSTEM_TABLE *SystemTable
680 'MM' : TemplateString("""${BEGIN}
684 IN EFI_HANDLE ImageHandle,
685 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
690 gLibraryStructorCall
= {
691 'BASE' : TemplateString("""${BEGIN}
692 Status = ${Function} ();
693 ASSERT_EFI_ERROR (Status);${END}
696 'PEI' : TemplateString("""${BEGIN}
697 Status = ${Function} (FileHandle, PeiServices);
698 ASSERT_EFI_ERROR (Status);${END}
701 'DXE' : TemplateString("""${BEGIN}
702 Status = ${Function} (ImageHandle, SystemTable);
703 ASSERT_EFI_ERROR (Status);${END}
706 'MM' : TemplateString("""${BEGIN}
707 Status = ${Function} (ImageHandle, MmSystemTable);
708 ASSERT_EFI_ERROR (Status);${END}
712 ## Library Constructor and Destructor Templates
714 'BASE' : TemplateString("""
715 ${BEGIN}${FunctionPrototype}${END}
719 ProcessLibrary${Type}List (
723 ${BEGIN} EFI_STATUS Status;
724 ${FunctionCall}${END}
728 'PEI' : TemplateString("""
729 ${BEGIN}${FunctionPrototype}${END}
733 ProcessLibrary${Type}List (
734 IN EFI_PEI_FILE_HANDLE FileHandle,
735 IN CONST EFI_PEI_SERVICES **PeiServices
738 ${BEGIN} EFI_STATUS Status;
739 ${FunctionCall}${END}
743 'DXE' : TemplateString("""
744 ${BEGIN}${FunctionPrototype}${END}
748 ProcessLibrary${Type}List (
749 IN EFI_HANDLE ImageHandle,
750 IN EFI_SYSTEM_TABLE *SystemTable
753 ${BEGIN} EFI_STATUS Status;
754 ${FunctionCall}${END}
758 'MM' : TemplateString("""
759 ${BEGIN}${FunctionPrototype}${END}
763 ProcessLibrary${Type}List (
764 IN EFI_HANDLE ImageHandle,
765 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable
768 ${BEGIN} EFI_STATUS Status;
769 ${FunctionCall}${END}
774 gBasicHeaderFile
= "Base.h"
776 gModuleTypeHeaderFile
= {
777 "BASE" : [gBasicHeaderFile
],
778 "SEC" : ["PiPei.h", "Library/DebugLib.h"],
779 "PEI_CORE" : ["PiPei.h", "Library/DebugLib.h", "Library/PeiCoreEntryPoint.h"],
780 "PEIM" : ["PiPei.h", "Library/DebugLib.h", "Library/PeimEntryPoint.h"],
781 "DXE_CORE" : ["PiDxe.h", "Library/DebugLib.h", "Library/DxeCoreEntryPoint.h"],
782 "DXE_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],
783 "DXE_SMM_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],
784 "DXE_RUNTIME_DRIVER": ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],
785 "DXE_SAL_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],
786 "UEFI_DRIVER" : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],
787 "UEFI_APPLICATION" : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiApplicationEntryPoint.h"],
788 "SMM_CORE" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiDriverEntryPoint.h"],
789 "MM_STANDALONE" : ["PiSmm.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/SmmDriverStandaloneEntryPoint.h"],
790 "MM_CORE_STANDALONE" : ["PiSmm.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/SmmCoreStandaloneEntryPoint.h"],
791 "USER_DEFINED" : [gBasicHeaderFile
]
794 ## Autogen internal worker macro to define DynamicEx PCD name includes both the TokenSpaceGuidName
795 # the TokenName and Guid comparison to avoid define name collisions.
797 # @param Info The ModuleAutoGen object
798 # @param AutoGenH The TemplateString object for header file
801 def DynExPcdTokenNumberMapping(Info
, AutoGenH
):
802 ExTokenCNameList
= []
804 # Even it is the Library, the PCD is saved in the ModulePcdList
805 PcdList
= Info
.ModulePcdList
807 if Pcd
.Type
in gDynamicExPcd
:
808 ExTokenCNameList
.append(Pcd
.TokenCName
)
809 PcdExList
.append(Pcd
)
810 if len(ExTokenCNameList
) == 0:
812 AutoGenH
.Append('\n#define COMPAREGUID(Guid1, Guid2) (BOOLEAN)(*(CONST UINT64*)Guid1 == *(CONST UINT64*)Guid2 && *((CONST UINT64*)Guid1 + 1) == *((CONST UINT64*)Guid2 + 1))\n')
813 # AutoGen for each PCD listed in a [PcdEx] section of a Module/Lib INF file.
814 # Auto generate a macro for each TokenName that takes a Guid pointer as a parameter.
815 # Use the Guid pointer to see if it matches any of the token space GUIDs.
816 TokenCNameList
= set()
817 for TokenCName
in ExTokenCNameList
:
818 if TokenCName
in TokenCNameList
:
821 Count
= ExTokenCNameList
.count(TokenCName
)
822 for Pcd
in PcdExList
:
823 RealTokenCName
= Pcd
.TokenCName
824 for PcdItem
in GlobalData
.MixedPcd
:
825 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) in GlobalData
.MixedPcd
[PcdItem
]:
826 RealTokenCName
= PcdItem
[0]
828 if Pcd
.TokenCName
== TokenCName
:
831 AutoGenH
.Append('\n#define __PCD_%s_ADDR_CMP(GuidPtr) (' % (RealTokenCName
))
832 AutoGenH
.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:'
833 % (Pcd
.TokenSpaceGuidCName
, Pcd
.TokenSpaceGuidCName
, RealTokenCName
))
835 AutoGenH
.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:'
836 % (Pcd
.TokenSpaceGuidCName
, Pcd
.TokenSpaceGuidCName
, RealTokenCName
))
838 AutoGenH
.Append('0 \\\n )\n')
839 TokenCNameList
.add(TokenCName
)
841 TokenCNameList
= set()
842 for TokenCName
in ExTokenCNameList
:
843 if TokenCName
in TokenCNameList
:
846 Count
= ExTokenCNameList
.count(TokenCName
)
847 for Pcd
in PcdExList
:
848 RealTokenCName
= Pcd
.TokenCName
849 for PcdItem
in GlobalData
.MixedPcd
:
850 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) in GlobalData
.MixedPcd
[PcdItem
]:
851 RealTokenCName
= PcdItem
[0]
853 if Pcd
.Type
in gDynamicExPcd
and Pcd
.TokenCName
== TokenCName
:
856 AutoGenH
.Append('\n#define __PCD_%s_VAL_CMP(GuidPtr) (' % (RealTokenCName
))
857 AutoGenH
.Append('\\\n (GuidPtr == NULL) ? 0:')
858 AutoGenH
.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:'
859 % (Pcd
.TokenSpaceGuidCName
, Pcd
.TokenSpaceGuidCName
, RealTokenCName
))
861 AutoGenH
.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:'
862 % (Pcd
.TokenSpaceGuidCName
, Pcd
.TokenSpaceGuidCName
, RealTokenCName
))
864 AutoGenH
.Append('0 \\\n )\n')
865 # Autogen internal worker macro to compare GUIDs. Guid1 is a pointer to a GUID.
866 # Guid2 is a C name for a GUID. Compare pointers first because optimizing compiler
867 # can do this at build time on CONST GUID pointers and optimize away call to COMPAREGUID().
868 # COMPAREGUID() will only be used if the Guid passed in is local to the module.
869 AutoGenH
.Append('#define _PCD_TOKEN_EX_%s(GuidPtr) __PCD_%s_ADDR_CMP(GuidPtr) ? __PCD_%s_ADDR_CMP(GuidPtr) : __PCD_%s_VAL_CMP(GuidPtr) \n'
870 % (RealTokenCName
, RealTokenCName
, RealTokenCName
, RealTokenCName
))
871 TokenCNameList
.add(TokenCName
)
874 if Pcd
.DatumType
not in _NumericDataTypesList
:
875 Value
= Pcd
.DefaultValue
876 if Value
in [None, '']:
878 elif Value
[0] == 'L':
879 return (len(Value
) - 2) * 2
880 elif Value
[0] == '{':
881 return len(Value
.split(','))
883 return len(Value
) - 1
884 if Pcd
.DatumType
== 'UINT64':
886 if Pcd
.DatumType
== 'UINT32':
888 if Pcd
.DatumType
== 'UINT16':
890 if Pcd
.DatumType
== 'UINT8':
892 if Pcd
.DatumType
== 'BOOLEAN':
895 return Pcd
.MaxDatumSize
898 ## Create code for module PCDs
900 # @param Info The ModuleAutoGen object
901 # @param AutoGenC The TemplateString object for C code
902 # @param AutoGenH The TemplateString object for header file
903 # @param Pcd The PCD object
905 def CreateModulePcdCode(Info
, AutoGenC
, AutoGenH
, Pcd
):
906 TokenSpaceGuidValue
= Pcd
.TokenSpaceGuidValue
#Info.GuidList[Pcd.TokenSpaceGuidCName]
907 PcdTokenNumber
= Info
.PlatformInfo
.PcdTokenNumber
911 TokenCName
= Pcd
.TokenCName
912 for PcdItem
in GlobalData
.MixedPcd
:
913 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) in GlobalData
.MixedPcd
[PcdItem
]:
914 TokenCName
= PcdItem
[0]
916 PcdTokenName
= '_PCD_TOKEN_' + TokenCName
917 PatchPcdSizeTokenName
= '_PCD_PATCHABLE_' + TokenCName
+'_SIZE'
918 PatchPcdSizeVariableName
= '_gPcd_BinaryPatch_Size_' + TokenCName
919 PatchPcdMaxSizeVariable
= '_gPcd_BinaryPatch_MaxSize_' + TokenCName
920 FixPcdSizeTokenName
= '_PCD_SIZE_' + TokenCName
921 FixedPcdSizeVariableName
= '_gPcd_FixedAtBuild_Size_' + TokenCName
923 if Pcd
.PcdValueFromComm
:
924 Pcd
.DefaultValue
= Pcd
.PcdValueFromComm
926 if Pcd
.Type
in gDynamicExPcd
:
927 TokenNumber
= int(Pcd
.TokenValue
, 0)
928 # Add TokenSpaceGuidValue value to PcdTokenName to discriminate the DynamicEx PCDs with
929 # different Guids but same TokenCName
930 PcdExTokenName
= '_PCD_TOKEN_' + Pcd
.TokenSpaceGuidCName
+ '_' + TokenCName
931 AutoGenH
.Append('\n#define %s %dU\n' % (PcdExTokenName
, TokenNumber
))
933 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) not in PcdTokenNumber
:
934 # If one of the Source built modules listed in the DSC is not listed in FDF modules,
935 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only
936 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will
937 # report warning message notify the PI that they are attempting to build a module
938 # that must be included in a flash image in order to be functional. These Dynamic PCD
939 # will not be added into the Database unless it is used by other modules that are
940 # included in the FDF file.
941 # In this case, just assign an invalid token number to make it pass build.
942 if Pcd
.Type
in PCD_DYNAMIC_TYPE_LIST
:
945 EdkLogger
.error("build", AUTOGEN_ERROR
,
946 "No generated token number for %s.%s\n" % (Pcd
.TokenSpaceGuidCName
, TokenCName
),
947 ExtraData
="[%s]" % str(Info
))
949 TokenNumber
= PcdTokenNumber
[Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
]
950 AutoGenH
.Append('\n#define %s %dU\n' % (PcdTokenName
, TokenNumber
))
952 EdkLogger
.debug(EdkLogger
.DEBUG_3
, "Creating code for " + TokenCName
+ "." + Pcd
.TokenSpaceGuidCName
)
953 if Pcd
.Type
not in gItemTypeStringDatabase
:
954 EdkLogger
.error("build", AUTOGEN_ERROR
,
955 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd
.Type
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
956 ExtraData
="[%s]" % str(Info
))
958 DatumSize
= gDatumSizeStringDatabase
[Pcd
.DatumType
] if Pcd
.DatumType
in gDatumSizeStringDatabase
else gDatumSizeStringDatabase
['VOID*']
959 DatumSizeLib
= gDatumSizeStringDatabaseLib
[Pcd
.DatumType
] if Pcd
.DatumType
in gDatumSizeStringDatabaseLib
else gDatumSizeStringDatabaseLib
['VOID*']
960 GetModeName
= '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_' + TokenCName
961 SetModeName
= '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_' + TokenCName
962 SetModeStatusName
= '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_S_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_S_' + TokenCName
963 GetModeSizeName
= '_PCD_GET_MODE_SIZE' + '_' + TokenCName
965 if Pcd
.Type
in gDynamicExPcd
:
967 PcdList
= Info
.LibraryPcdList
969 PcdList
= Info
.ModulePcdList
971 for PcdModule
in PcdList
:
972 if PcdModule
.Type
in gDynamicExPcd
and Pcd
.TokenCName
== PcdModule
.TokenCName
:
974 # get out early once we found > 1...
975 if PcdExCNameTest
> 1:
977 # Be compatible with the current code which using PcdToken and PcdGet/Set for DynamicEx Pcd.
978 # If only PcdToken and PcdGet/Set used in all Pcds with different CName, it should succeed to build.
979 # If PcdToken and PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.
980 if PcdExCNameTest
> 1:
981 AutoGenH
.Append('// Disabled the macros, as PcdToken and PcdGet/Set are not allowed in the case that more than one DynamicEx Pcds are different Guids but same CName.\n')
982 AutoGenH
.Append('// #define %s %s\n' % (PcdTokenName
, PcdExTokenName
))
983 AutoGenH
.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
984 AutoGenH
.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName
,Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
985 if Pcd
.DatumType
not in _NumericDataTypesList
:
986 AutoGenH
.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
987 AutoGenH
.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
989 AutoGenH
.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
990 AutoGenH
.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
992 AutoGenH
.Append('#define %s %s\n' % (PcdTokenName
, PcdExTokenName
))
993 AutoGenH
.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
994 AutoGenH
.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName
,Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
995 if Pcd
.DatumType
not in _NumericDataTypesList
:
996 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
997 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
999 AutoGenH
.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1000 AutoGenH
.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1001 elif Pcd
.Type
in gDynamicPcd
:
1003 for PcdModule
in Info
.LibraryPcdList
+ Info
.ModulePcdList
:
1004 if PcdModule
.Type
in gDynamicPcd
and Pcd
.TokenCName
== PcdModule
.TokenCName
:
1006 # get out early once we found > 1...
1007 if PcdCNameTest
> 1:
1009 if PcdCNameTest
> 1:
1010 EdkLogger
.error("build", AUTOGEN_ERROR
, "More than one Dynamic Pcds [%s] are different Guids but same CName. They need to be changed to DynamicEx type to avoid the confliction.\n" % (TokenCName
), ExtraData
="[%s]" % str(Info
.MetaFile
.Path
))
1012 AutoGenH
.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName
, DatumSizeLib
, PcdTokenName
))
1013 AutoGenH
.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName
, PcdTokenName
))
1014 if Pcd
.DatumType
not in _NumericDataTypesList
:
1015 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName
, DatumSizeLib
, PcdTokenName
))
1016 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, PcdTokenName
))
1018 AutoGenH
.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName
, DatumSizeLib
, PcdTokenName
))
1019 AutoGenH
.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, PcdTokenName
))
1021 PcdVariableName
= '_gPcd_' + gItemTypeStringDatabase
[Pcd
.Type
] + '_' + TokenCName
1023 if Pcd
.Type
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1027 Value
= Pcd
.DefaultValue
1031 if Pcd
.DatumType
== 'BOOLEAN':
1032 BoolValue
= Value
.upper()
1033 if BoolValue
== 'TRUE' or BoolValue
== '1':
1035 elif BoolValue
== 'FALSE' or BoolValue
== '0':
1038 if Pcd
.DatumType
in ['UINT64', 'UINT32', 'UINT16', 'UINT8']:
1040 if Value
.upper().endswith('L'):
1042 ValueNumber
= int (Value
, 0)
1044 EdkLogger
.error("build", AUTOGEN_ERROR
,
1045 "PCD value is not valid dec or hex number for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1046 ExtraData
="[%s]" % str(Info
))
1047 if Pcd
.DatumType
== 'UINT64':
1049 EdkLogger
.error("build", AUTOGEN_ERROR
,
1050 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1051 ExtraData
="[%s]" % str(Info
))
1052 elif ValueNumber
>= 0x10000000000000000:
1053 EdkLogger
.error("build", AUTOGEN_ERROR
,
1054 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1055 ExtraData
="[%s]" % str(Info
))
1056 if not Value
.endswith('ULL'):
1058 elif Pcd
.DatumType
== 'UINT32':
1060 EdkLogger
.error("build", AUTOGEN_ERROR
,
1061 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1062 ExtraData
="[%s]" % str(Info
))
1063 elif ValueNumber
>= 0x100000000:
1064 EdkLogger
.error("build", AUTOGEN_ERROR
,
1065 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1066 ExtraData
="[%s]" % str(Info
))
1067 if not Value
.endswith('U'):
1069 elif Pcd
.DatumType
== 'UINT16':
1071 EdkLogger
.error("build", AUTOGEN_ERROR
,
1072 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1073 ExtraData
="[%s]" % str(Info
))
1074 elif ValueNumber
>= 0x10000:
1075 EdkLogger
.error("build", AUTOGEN_ERROR
,
1076 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1077 ExtraData
="[%s]" % str(Info
))
1078 if not Value
.endswith('U'):
1080 elif Pcd
.DatumType
== 'UINT8':
1082 EdkLogger
.error("build", AUTOGEN_ERROR
,
1083 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1084 ExtraData
="[%s]" % str(Info
))
1085 elif ValueNumber
>= 0x100:
1086 EdkLogger
.error("build", AUTOGEN_ERROR
,
1087 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd
.DatumType
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1088 ExtraData
="[%s]" % str(Info
))
1089 if not Value
.endswith('U'):
1091 if Pcd
.DatumType
not in _NumericDataTypesList
:
1092 if Pcd
.MaxDatumSize
is None or Pcd
.MaxDatumSize
== '':
1093 EdkLogger
.error("build", AUTOGEN_ERROR
,
1094 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd
.TokenSpaceGuidCName
, TokenCName
),
1095 ExtraData
="[%s]" % str(Info
))
1097 ArraySize
= int(Pcd
.MaxDatumSize
, 0)
1103 Value
= Value
.lstrip('L') #.strip('"')
1104 Value
= eval(Value
) # translate escape character
1106 for Index
in range(0,len(Value
)):
1108 NewValue
= NewValue
+ str(ord(Value
[Index
]) % 0x10000) + ', '
1110 NewValue
= NewValue
+ str(ord(Value
[Index
]) % 0x100) + ', '
1112 ArraySize
= ArraySize
/ 2;
1114 if ArraySize
< (len(Value
) + 1):
1115 if Pcd
.MaxSizeUserSet
:
1116 EdkLogger
.error("build", AUTOGEN_ERROR
,
1117 "The maximum size of VOID* type PCD '%s.%s' is less than its actual size occupied." % (Pcd
.TokenSpaceGuidCName
, TokenCName
),
1118 ExtraData
="[%s]" % str(Info
))
1120 ArraySize
= GetPcdSize(Pcd
)
1122 ArraySize
= ArraySize
/ 2
1123 Value
= NewValue
+ '0 }'
1124 Array
= '[%d]' % ArraySize
1126 # skip casting for fixed at build since it breaks ARM assembly.
1127 # Long term we need PCD macros that work in assembly
1129 elif Pcd
.Type
!= TAB_PCDS_FIXED_AT_BUILD
and Pcd
.DatumType
in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:
1130 Value
= "((%s)%s)" % (Pcd
.DatumType
, Value
)
1132 if Pcd
.DatumType
not in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:
1133 # handle structure PCD
1134 if Pcd
.MaxDatumSize
is None or Pcd
.MaxDatumSize
== '':
1135 EdkLogger
.error("build", AUTOGEN_ERROR
,
1136 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd
.TokenSpaceGuidCName
, TokenCName
),
1137 ExtraData
="[%s]" % str(Info
))
1139 ArraySize
= int(Pcd
.MaxDatumSize
, 0)
1140 Array
= '[%d]' % ArraySize
1142 if Pcd
.Type
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1143 PcdValueName
= '_PCD_PATCHABLE_VALUE_' + TokenCName
1145 PcdValueName
= '_PCD_VALUE_' + TokenCName
1147 if Pcd
.DatumType
not in _NumericDataTypesList
:
1149 # For unicode, UINT16 array will be generated, so the alignment of unicode is guaranteed.
1151 AutoGenH
.Append('#define %s %s%s\n' %(PcdValueName
, Type
, PcdVariableName
))
1153 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT16 %s%s = %s;\n' % (Const
, PcdVariableName
, Array
, Value
))
1154 AutoGenH
.Append('extern %s UINT16 %s%s;\n' %(Const
, PcdVariableName
, Array
))
1156 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT8 %s%s = %s;\n' % (Const
, PcdVariableName
, Array
, Value
))
1157 AutoGenH
.Append('extern %s UINT8 %s%s;\n' %(Const
, PcdVariableName
, Array
))
1158 AutoGenH
.Append('#define %s %s%s\n' %(GetModeName
, Type
, PcdVariableName
))
1160 PcdDataSize
= GetPcdSize(Pcd
)
1161 if Pcd
.Type
== TAB_PCDS_FIXED_AT_BUILD
:
1162 AutoGenH
.Append('#define %s %s\n' % (FixPcdSizeTokenName
, PcdDataSize
))
1163 AutoGenH
.Append('#define %s %s \n' % (GetModeSizeName
,FixPcdSizeTokenName
))
1164 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (FixedPcdSizeVariableName
,PcdDataSize
))
1165 if Pcd
.Type
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1166 AutoGenH
.Append('#define %s %s\n' % (PatchPcdSizeTokenName
, Pcd
.MaxDatumSize
))
1167 AutoGenH
.Append('#define %s %s \n' % (GetModeSizeName
,PatchPcdSizeVariableName
))
1168 AutoGenH
.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName
)
1169 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName
,PcdDataSize
))
1170 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (PatchPcdMaxSizeVariable
,Pcd
.MaxDatumSize
))
1171 elif Pcd
.Type
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1172 AutoGenH
.Append('#define %s %s\n' %(PcdValueName
, Value
))
1173 AutoGenC
.Append('volatile %s %s %s = %s;\n' %(Const
, Pcd
.DatumType
, PcdVariableName
, PcdValueName
))
1174 AutoGenH
.Append('extern volatile %s %s %s%s;\n' % (Const
, Pcd
.DatumType
, PcdVariableName
, Array
))
1175 AutoGenH
.Append('#define %s %s%s\n' % (GetModeName
, Type
, PcdVariableName
))
1177 PcdDataSize
= GetPcdSize(Pcd
)
1178 AutoGenH
.Append('#define %s %s\n' % (PatchPcdSizeTokenName
, PcdDataSize
))
1180 AutoGenH
.Append('#define %s %s \n' % (GetModeSizeName
,PatchPcdSizeVariableName
))
1181 AutoGenH
.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName
)
1182 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName
,PcdDataSize
))
1184 PcdDataSize
= GetPcdSize(Pcd
)
1185 AutoGenH
.Append('#define %s %s\n' % (FixPcdSizeTokenName
, PcdDataSize
))
1186 AutoGenH
.Append('#define %s %s \n' % (GetModeSizeName
,FixPcdSizeTokenName
))
1188 AutoGenH
.Append('#define %s %s\n' %(PcdValueName
, Value
))
1189 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s %s = %s;\n' %(Const
, Pcd
.DatumType
, PcdVariableName
, PcdValueName
))
1190 AutoGenH
.Append('extern %s %s %s%s;\n' % (Const
, Pcd
.DatumType
, PcdVariableName
, Array
))
1191 AutoGenH
.Append('#define %s %s%s\n' % (GetModeName
, Type
, PcdVariableName
))
1193 if Pcd
.Type
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1194 if Pcd
.DatumType
not in _NumericDataTypesList
:
1195 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSize((VOID *)_gPcd_BinaryPatch_%s, &_gPcd_BinaryPatch_Size_%s, (UINTN)_PCD_PATCHABLE_%s_SIZE, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, Pcd
.TokenCName
, Pcd
.TokenCName
, Pcd
.TokenCName
))
1196 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSizeS((VOID *)_gPcd_BinaryPatch_%s, &_gPcd_BinaryPatch_Size_%s, (UINTN)_PCD_PATCHABLE_%s_SIZE, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, Pcd
.TokenCName
, Pcd
.TokenCName
, Pcd
.TokenCName
))
1198 AutoGenH
.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName
, PcdVariableName
))
1199 AutoGenH
.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS) \n' % (SetModeStatusName
, PcdVariableName
))
1201 AutoGenH
.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName
)
1203 ## Create code for library module PCDs
1205 # @param Info The ModuleAutoGen object
1206 # @param AutoGenC The TemplateString object for C code
1207 # @param AutoGenH The TemplateString object for header file
1208 # @param Pcd The PCD object
1210 def CreateLibraryPcdCode(Info
, AutoGenC
, AutoGenH
, Pcd
):
1211 PcdTokenNumber
= Info
.PlatformInfo
.PcdTokenNumber
1212 TokenSpaceGuidCName
= Pcd
.TokenSpaceGuidCName
1213 TokenCName
= Pcd
.TokenCName
1214 for PcdItem
in GlobalData
.MixedPcd
:
1215 if (TokenCName
, TokenSpaceGuidCName
) in GlobalData
.MixedPcd
[PcdItem
]:
1216 TokenCName
= PcdItem
[0]
1218 PcdTokenName
= '_PCD_TOKEN_' + TokenCName
1219 FixPcdSizeTokenName
= '_PCD_SIZE_' + TokenCName
1220 PatchPcdSizeTokenName
= '_PCD_PATCHABLE_' + TokenCName
+'_SIZE'
1221 PatchPcdSizeVariableName
= '_gPcd_BinaryPatch_Size_' + TokenCName
1222 PatchPcdMaxSizeVariable
= '_gPcd_BinaryPatch_MaxSize_' + TokenCName
1223 FixedPcdSizeVariableName
= '_gPcd_FixedAtBuild_Size_' + TokenCName
1225 if Pcd
.PcdValueFromComm
:
1226 Pcd
.DefaultValue
= Pcd
.PcdValueFromComm
1230 if Pcd
.Type
in gDynamicExPcd
:
1231 TokenNumber
= int(Pcd
.TokenValue
, 0)
1233 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) not in PcdTokenNumber
:
1234 # If one of the Source built modules listed in the DSC is not listed in FDF modules,
1235 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only
1236 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will
1237 # report warning message notify the PI that they are attempting to build a module
1238 # that must be included in a flash image in order to be functional. These Dynamic PCD
1239 # will not be added into the Database unless it is used by other modules that are
1240 # included in the FDF file.
1241 # In this case, just assign an invalid token number to make it pass build.
1242 if Pcd
.Type
in PCD_DYNAMIC_TYPE_LIST
:
1245 EdkLogger
.error("build", AUTOGEN_ERROR
,
1246 "No generated token number for %s.%s\n" % (Pcd
.TokenSpaceGuidCName
, TokenCName
),
1247 ExtraData
="[%s]" % str(Info
))
1249 TokenNumber
= PcdTokenNumber
[Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
]
1251 if Pcd
.Type
not in gItemTypeStringDatabase
:
1252 EdkLogger
.error("build", AUTOGEN_ERROR
,
1253 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd
.Type
, Pcd
.TokenSpaceGuidCName
, TokenCName
),
1254 ExtraData
="[%s]" % str(Info
))
1256 DatumType
= Pcd
.DatumType
1257 DatumSize
= gDatumSizeStringDatabase
[Pcd
.DatumType
] if Pcd
.DatumType
in gDatumSizeStringDatabase
else gDatumSizeStringDatabase
['VOID*']
1258 DatumSizeLib
= gDatumSizeStringDatabaseLib
[Pcd
.DatumType
] if Pcd
.DatumType
in gDatumSizeStringDatabaseLib
else gDatumSizeStringDatabaseLib
['VOID*']
1259 GetModeName
= '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_' + TokenCName
1260 SetModeName
= '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_' + TokenCName
1261 SetModeStatusName
= '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
[Pcd
.DatumType
] + '_S_' + TokenCName
if Pcd
.DatumType
in gDatumSizeStringDatabaseH
else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH
['VOID*'] + '_S_' + TokenCName
1262 GetModeSizeName
= '_PCD_GET_MODE_SIZE' + '_' + TokenCName
1266 if Pcd
.DatumType
not in _NumericDataTypesList
:
1267 if Pcd
.DefaultValue
[0]== '{':
1270 PcdItemType
= Pcd
.Type
1271 if PcdItemType
in gDynamicExPcd
:
1272 PcdExTokenName
= '_PCD_TOKEN_' + TokenSpaceGuidCName
+ '_' + TokenCName
1273 AutoGenH
.Append('\n#define %s %dU\n' % (PcdExTokenName
, TokenNumber
))
1276 PcdList
= Info
.LibraryPcdList
1278 PcdList
= Info
.ModulePcdList
1280 for PcdModule
in PcdList
:
1281 if PcdModule
.Type
in gDynamicExPcd
and Pcd
.TokenCName
== PcdModule
.TokenCName
:
1283 # get out early once we found > 1...
1284 if PcdExCNameTest
> 1:
1286 # Be compatible with the current code which using PcdGet/Set for DynamicEx Pcd.
1287 # If only PcdGet/Set used in all Pcds with different CName, it should succeed to build.
1288 # If PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.
1289 if PcdExCNameTest
> 1:
1290 AutoGenH
.Append('// Disabled the macros, as PcdToken and PcdGet/Set are not allowed in the case that more than one DynamicEx Pcds are different Guids but same CName.\n')
1291 AutoGenH
.Append('// #define %s %s\n' % (PcdTokenName
, PcdExTokenName
))
1292 AutoGenH
.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1293 AutoGenH
.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName
,Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1294 if Pcd
.DatumType
not in _NumericDataTypesList
:
1295 AutoGenH
.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1296 AutoGenH
.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1298 AutoGenH
.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1299 AutoGenH
.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1301 AutoGenH
.Append('#define %s %s\n' % (PcdTokenName
, PcdExTokenName
))
1302 AutoGenH
.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1303 AutoGenH
.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName
,Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1304 if Pcd
.DatumType
not in _NumericDataTypesList
:
1305 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1306 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1308 AutoGenH
.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1309 AutoGenH
.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, Pcd
.TokenSpaceGuidCName
, PcdTokenName
))
1311 AutoGenH
.Append('#define _PCD_TOKEN_%s %dU\n' % (TokenCName
, TokenNumber
))
1312 if PcdItemType
in gDynamicPcd
:
1315 PcdList
.extend(Info
.LibraryPcdList
)
1316 PcdList
.extend(Info
.ModulePcdList
)
1317 for PcdModule
in PcdList
:
1318 if PcdModule
.Type
in gDynamicPcd
:
1319 PcdCNameList
.append(PcdModule
.TokenCName
)
1320 if PcdCNameList
.count(Pcd
.TokenCName
) > 1:
1321 EdkLogger
.error("build", AUTOGEN_ERROR
, "More than one Dynamic Pcds [%s] are different Guids but same CName.They need to be changed to DynamicEx type to avoid the confliction.\n" % (TokenCName
), ExtraData
="[%s]" % str(Info
.MetaFile
.Path
))
1323 AutoGenH
.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName
, DatumSizeLib
, PcdTokenName
))
1324 AutoGenH
.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName
, PcdTokenName
))
1325 if DatumType
not in _NumericDataTypesList
:
1326 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName
, DatumSizeLib
, PcdTokenName
))
1327 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, DatumSizeLib
, PcdTokenName
))
1329 AutoGenH
.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName
, DatumSizeLib
, PcdTokenName
))
1330 AutoGenH
.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName
, DatumSizeLib
, PcdTokenName
))
1331 if PcdItemType
== TAB_PCDS_PATCHABLE_IN_MODULE
:
1332 GetModeMaxSizeName
= '_PCD_GET_MODE_MAXSIZE' + '_' + TokenCName
1333 PcdVariableName
= '_gPcd_' + gItemTypeStringDatabase
[TAB_PCDS_PATCHABLE_IN_MODULE
] + '_' + TokenCName
1334 if DatumType
not in _NumericDataTypesList
:
1335 if DatumType
== 'VOID*' and Array
== '[]':
1336 DatumType
= ['UINT8', 'UINT16'][Pcd
.DefaultValue
[0] == 'L']
1339 AutoGenH
.Append('extern %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType
, TokenCName
, Array
))
1341 AutoGenH
.Append('extern volatile %s %s%s;\n' % (DatumType
, PcdVariableName
, Array
))
1342 AutoGenH
.Append('#define %s %s_gPcd_BinaryPatch_%s\n' %(GetModeName
, Type
, TokenCName
))
1343 PcdDataSize
= GetPcdSize(Pcd
)
1344 if Pcd
.DatumType
not in _NumericDataTypesList
:
1345 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSize((VOID *)_gPcd_BinaryPatch_%s, &%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName
, TokenCName
, PatchPcdSizeVariableName
, PatchPcdMaxSizeVariable
))
1346 AutoGenH
.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSizeS((VOID *)_gPcd_BinaryPatch_%s, &%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName
, TokenCName
, PatchPcdSizeVariableName
, PatchPcdMaxSizeVariable
))
1347 AutoGenH
.Append('#define %s %s\n' % (GetModeMaxSizeName
, PatchPcdMaxSizeVariable
))
1348 AutoGenH
.Append('extern const UINTN %s; \n' % PatchPcdMaxSizeVariable
)
1350 AutoGenH
.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName
, PcdVariableName
))
1351 AutoGenH
.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS)\n' % (SetModeStatusName
, PcdVariableName
))
1352 AutoGenH
.Append('#define %s %s\n' % (PatchPcdSizeTokenName
, PcdDataSize
))
1354 AutoGenH
.Append('#define %s %s\n' % (GetModeSizeName
,PatchPcdSizeVariableName
))
1355 AutoGenH
.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName
)
1357 if PcdItemType
== TAB_PCDS_FIXED_AT_BUILD
or PcdItemType
== TAB_PCDS_FEATURE_FLAG
:
1358 key
= ".".join((Pcd
.TokenSpaceGuidCName
,Pcd
.TokenCName
))
1359 PcdVariableName
= '_gPcd_' + gItemTypeStringDatabase
[Pcd
.Type
] + '_' + TokenCName
1360 if DatumType
== 'VOID*' and Array
== '[]':
1361 DatumType
= ['UINT8', 'UINT16'][Pcd
.DefaultValue
[0] == 'L']
1362 if DatumType
not in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:
1364 AutoGenH
.Append('extern const %s _gPcd_FixedAtBuild_%s%s;\n' %(DatumType
, TokenCName
, Array
))
1365 AutoGenH
.Append('#define %s %s_gPcd_FixedAtBuild_%s\n' %(GetModeName
, Type
, TokenCName
))
1366 AutoGenH
.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName
)
1368 ConstFixedPcd
= False
1369 if PcdItemType
== TAB_PCDS_FIXED_AT_BUILD
and (key
in Info
.ConstPcd
or (Info
.IsLibrary
and not Info
._ReferenceModules
)):
1370 ConstFixedPcd
= True
1371 if key
in Info
.ConstPcd
:
1372 Pcd
.DefaultValue
= Info
.ConstPcd
[key
]
1373 if Pcd
.DatumType
not in _NumericDataTypesList
:
1374 AutoGenH
.Append('#define _PCD_VALUE_%s %s%s\n' %(TokenCName
, Type
, PcdVariableName
))
1376 AutoGenH
.Append('#define _PCD_VALUE_%s %s\n' %(TokenCName
, Pcd
.DefaultValue
))
1377 PcdDataSize
= GetPcdSize(Pcd
)
1378 if PcdItemType
== TAB_PCDS_FIXED_AT_BUILD
:
1379 if Pcd
.DatumType
not in _NumericDataTypesList
:
1381 AutoGenH
.Append('#define %s %s\n' % (FixPcdSizeTokenName
, PcdDataSize
))
1382 AutoGenH
.Append('#define %s %s\n' % (GetModeSizeName
,FixPcdSizeTokenName
))
1384 AutoGenH
.Append('#define %s %s\n' % (GetModeSizeName
,FixedPcdSizeVariableName
))
1385 AutoGenH
.Append('#define %s %s\n' % (FixPcdSizeTokenName
,FixedPcdSizeVariableName
))
1386 AutoGenH
.Append('extern const UINTN %s; \n' % FixedPcdSizeVariableName
)
1388 AutoGenH
.Append('#define %s %s\n' % (FixPcdSizeTokenName
, PcdDataSize
))
1389 AutoGenH
.Append('#define %s %s\n' % (GetModeSizeName
,FixPcdSizeTokenName
))
1391 ## Create code for library constructor
1393 # @param Info The ModuleAutoGen object
1394 # @param AutoGenC The TemplateString object for C code
1395 # @param AutoGenH The TemplateString object for header file
1397 def CreateLibraryConstructorCode(Info
, AutoGenC
, AutoGenH
):
1399 # Library Constructors
1401 ConstructorPrototypeString
= TemplateString()
1402 ConstructorCallingString
= TemplateString()
1404 DependentLibraryList
= [Info
.Module
]
1406 DependentLibraryList
= Info
.DependentLibraryList
1407 for Lib
in DependentLibraryList
:
1408 if len(Lib
.ConstructorList
) <= 0:
1410 Dict
= {'Function':Lib
.ConstructorList
}
1411 if Lib
.ModuleType
in ['BASE', 'SEC']:
1412 ConstructorPrototypeString
.Append(gLibraryStructorPrototype
['BASE'].Replace(Dict
))
1413 ConstructorCallingString
.Append(gLibraryStructorCall
['BASE'].Replace(Dict
))
1414 elif Lib
.ModuleType
in ['PEI_CORE','PEIM']:
1415 ConstructorPrototypeString
.Append(gLibraryStructorPrototype
['PEI'].Replace(Dict
))
1416 ConstructorCallingString
.Append(gLibraryStructorCall
['PEI'].Replace(Dict
))
1417 elif Lib
.ModuleType
in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',
1418 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:
1419 ConstructorPrototypeString
.Append(gLibraryStructorPrototype
['DXE'].Replace(Dict
))
1420 ConstructorCallingString
.Append(gLibraryStructorCall
['DXE'].Replace(Dict
))
1421 elif Lib
.ModuleType
in ['MM_STANDALONE','MM_CORE_STANDALONE']:
1422 ConstructorPrototypeString
.Append(gLibraryStructorPrototype
['MM'].Replace(Dict
))
1423 ConstructorCallingString
.Append(gLibraryStructorCall
['MM'].Replace(Dict
))
1425 if str(ConstructorPrototypeString
) == '':
1426 ConstructorPrototypeList
= []
1428 ConstructorPrototypeList
= [str(ConstructorPrototypeString
)]
1429 if str(ConstructorCallingString
) == '':
1430 ConstructorCallingList
= []
1432 ConstructorCallingList
= [str(ConstructorCallingString
)]
1435 'Type' : 'Constructor',
1436 'FunctionPrototype' : ConstructorPrototypeList
,
1437 'FunctionCall' : ConstructorCallingList
1440 AutoGenH
.Append("${BEGIN}${FunctionPrototype}${END}", Dict
)
1442 if Info
.ModuleType
in ['BASE', 'SEC']:
1443 AutoGenC
.Append(gLibraryString
['BASE'].Replace(Dict
))
1444 elif Info
.ModuleType
in ['PEI_CORE','PEIM']:
1445 AutoGenC
.Append(gLibraryString
['PEI'].Replace(Dict
))
1446 elif Info
.ModuleType
in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',
1447 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:
1448 AutoGenC
.Append(gLibraryString
['DXE'].Replace(Dict
))
1449 elif Info
.ModuleType
in ['MM_STANDALONE','MM_CORE_STANDALONE']:
1450 AutoGenC
.Append(gLibraryString
['MM'].Replace(Dict
))
1452 ## Create code for library destructor
1454 # @param Info The ModuleAutoGen object
1455 # @param AutoGenC The TemplateString object for C code
1456 # @param AutoGenH The TemplateString object for header file
1458 def CreateLibraryDestructorCode(Info
, AutoGenC
, AutoGenH
):
1460 # Library Destructors
1462 DestructorPrototypeString
= TemplateString()
1463 DestructorCallingString
= TemplateString()
1465 DependentLibraryList
= [Info
.Module
]
1467 DependentLibraryList
= Info
.DependentLibraryList
1468 for Index
in range(len(DependentLibraryList
)-1, -1, -1):
1469 Lib
= DependentLibraryList
[Index
]
1470 if len(Lib
.DestructorList
) <= 0:
1472 Dict
= {'Function':Lib
.DestructorList
}
1473 if Lib
.ModuleType
in ['BASE', 'SEC']:
1474 DestructorPrototypeString
.Append(gLibraryStructorPrototype
['BASE'].Replace(Dict
))
1475 DestructorCallingString
.Append(gLibraryStructorCall
['BASE'].Replace(Dict
))
1476 elif Lib
.ModuleType
in ['PEI_CORE','PEIM']:
1477 DestructorPrototypeString
.Append(gLibraryStructorPrototype
['PEI'].Replace(Dict
))
1478 DestructorCallingString
.Append(gLibraryStructorCall
['PEI'].Replace(Dict
))
1479 elif Lib
.ModuleType
in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',
1480 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION', 'SMM_CORE']:
1481 DestructorPrototypeString
.Append(gLibraryStructorPrototype
['DXE'].Replace(Dict
))
1482 DestructorCallingString
.Append(gLibraryStructorCall
['DXE'].Replace(Dict
))
1483 elif Lib
.ModuleType
in ['MM_STANDALONE','MM_CORE_STANDALONE']:
1484 DestructorPrototypeString
.Append(gLibraryStructorPrototype
['MM'].Replace(Dict
))
1485 DestructorCallingString
.Append(gLibraryStructorCall
['MM'].Replace(Dict
))
1487 if str(DestructorPrototypeString
) == '':
1488 DestructorPrototypeList
= []
1490 DestructorPrototypeList
= [str(DestructorPrototypeString
)]
1491 if str(DestructorCallingString
) == '':
1492 DestructorCallingList
= []
1494 DestructorCallingList
= [str(DestructorCallingString
)]
1497 'Type' : 'Destructor',
1498 'FunctionPrototype' : DestructorPrototypeList
,
1499 'FunctionCall' : DestructorCallingList
1502 AutoGenH
.Append("${BEGIN}${FunctionPrototype}${END}", Dict
)
1504 if Info
.ModuleType
in ['BASE', 'SEC']:
1505 AutoGenC
.Append(gLibraryString
['BASE'].Replace(Dict
))
1506 elif Info
.ModuleType
in ['PEI_CORE','PEIM']:
1507 AutoGenC
.Append(gLibraryString
['PEI'].Replace(Dict
))
1508 elif Info
.ModuleType
in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',
1509 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:
1510 AutoGenC
.Append(gLibraryString
['DXE'].Replace(Dict
))
1511 elif Info
.ModuleType
in ['MM_STANDALONE','MM_CORE_STANDALONE']:
1512 AutoGenC
.Append(gLibraryString
['MM'].Replace(Dict
))
1515 ## Create code for ModuleEntryPoint
1517 # @param Info The ModuleAutoGen object
1518 # @param AutoGenC The TemplateString object for C code
1519 # @param AutoGenH The TemplateString object for header file
1521 def CreateModuleEntryPointCode(Info
, AutoGenC
, AutoGenH
):
1522 if Info
.IsLibrary
or Info
.ModuleType
in ['USER_DEFINED', 'SEC']:
1525 # Module Entry Points
1527 NumEntryPoints
= len(Info
.Module
.ModuleEntryPointList
)
1528 if 'PI_SPECIFICATION_VERSION' in Info
.Module
.Specification
:
1529 PiSpecVersion
= Info
.Module
.Specification
['PI_SPECIFICATION_VERSION']
1531 PiSpecVersion
= '0x00000000'
1532 if 'UEFI_SPECIFICATION_VERSION' in Info
.Module
.Specification
:
1533 UefiSpecVersion
= Info
.Module
.Specification
['UEFI_SPECIFICATION_VERSION']
1535 UefiSpecVersion
= '0x00000000'
1537 'Function' : Info
.Module
.ModuleEntryPointList
,
1538 'PiSpecVersion' : PiSpecVersion
+ 'U',
1539 'UefiSpecVersion': UefiSpecVersion
+ 'U'
1542 if Info
.ModuleType
in ['PEI_CORE', 'DXE_CORE', 'SMM_CORE', 'MM_CORE_STANDALONE']:
1543 if Info
.SourceFileList
:
1544 if NumEntryPoints
!= 1:
1548 '%s must have exactly one entry point' % Info
.ModuleType
,
1550 ExtraData
= ", ".join(Info
.Module
.ModuleEntryPointList
)
1552 if Info
.ModuleType
== 'PEI_CORE':
1553 AutoGenC
.Append(gPeiCoreEntryPointString
.Replace(Dict
))
1554 AutoGenH
.Append(gPeiCoreEntryPointPrototype
.Replace(Dict
))
1555 elif Info
.ModuleType
== 'DXE_CORE':
1556 AutoGenC
.Append(gDxeCoreEntryPointString
.Replace(Dict
))
1557 AutoGenH
.Append(gDxeCoreEntryPointPrototype
.Replace(Dict
))
1558 elif Info
.ModuleType
== 'SMM_CORE':
1559 AutoGenC
.Append(gSmmCoreEntryPointString
.Replace(Dict
))
1560 AutoGenH
.Append(gSmmCoreEntryPointPrototype
.Replace(Dict
))
1561 elif Info
.ModuleType
== 'MM_CORE_STANDALONE':
1562 AutoGenC
.Append(gMmCoreStandaloneEntryPointString
.Replace(Dict
))
1563 AutoGenH
.Append(gMmCoreStandaloneEntryPointPrototype
.Replace(Dict
))
1564 elif Info
.ModuleType
== 'PEIM':
1565 if NumEntryPoints
< 2:
1566 AutoGenC
.Append(gPeimEntryPointString
[NumEntryPoints
].Replace(Dict
))
1568 AutoGenC
.Append(gPeimEntryPointString
[2].Replace(Dict
))
1569 AutoGenH
.Append(gPeimEntryPointPrototype
.Replace(Dict
))
1570 elif Info
.ModuleType
in ['DXE_RUNTIME_DRIVER','DXE_DRIVER','DXE_SAL_DRIVER','UEFI_DRIVER']:
1571 if NumEntryPoints
< 2:
1572 AutoGenC
.Append(gUefiDriverEntryPointString
[NumEntryPoints
].Replace(Dict
))
1574 AutoGenC
.Append(gUefiDriverEntryPointString
[2].Replace(Dict
))
1575 AutoGenH
.Append(gUefiDriverEntryPointPrototype
.Replace(Dict
))
1576 elif Info
.ModuleType
== 'DXE_SMM_DRIVER':
1577 if NumEntryPoints
== 0:
1578 AutoGenC
.Append(gDxeSmmEntryPointString
[0].Replace(Dict
))
1580 AutoGenC
.Append(gDxeSmmEntryPointString
[1].Replace(Dict
))
1581 AutoGenH
.Append(gDxeSmmEntryPointPrototype
.Replace(Dict
))
1582 elif Info
.ModuleType
== 'MM_STANDALONE':
1583 if NumEntryPoints
< 2:
1584 AutoGenC
.Append(gMmStandaloneEntryPointString
[NumEntryPoints
].Replace(Dict
))
1586 AutoGenC
.Append(gMmStandaloneEntryPointString
[2].Replace(Dict
))
1587 AutoGenH
.Append(gMmStandaloneEntryPointPrototype
.Replace(Dict
))
1588 elif Info
.ModuleType
== 'UEFI_APPLICATION':
1589 if NumEntryPoints
< 2:
1590 AutoGenC
.Append(gUefiApplicationEntryPointString
[NumEntryPoints
].Replace(Dict
))
1592 AutoGenC
.Append(gUefiApplicationEntryPointString
[2].Replace(Dict
))
1593 AutoGenH
.Append(gUefiApplicationEntryPointPrototype
.Replace(Dict
))
1595 ## Create code for ModuleUnloadImage
1597 # @param Info The ModuleAutoGen object
1598 # @param AutoGenC The TemplateString object for C code
1599 # @param AutoGenH The TemplateString object for header file
1601 def CreateModuleUnloadImageCode(Info
, AutoGenC
, AutoGenH
):
1602 if Info
.IsLibrary
or Info
.ModuleType
in ['USER_DEFINED', 'SEC']:
1605 # Unload Image Handlers
1607 NumUnloadImage
= len(Info
.Module
.ModuleUnloadImageList
)
1608 Dict
= {'Count':str(NumUnloadImage
) + 'U', 'Function':Info
.Module
.ModuleUnloadImageList
}
1609 if NumUnloadImage
< 2:
1610 AutoGenC
.Append(gUefiUnloadImageString
[NumUnloadImage
].Replace(Dict
))
1612 AutoGenC
.Append(gUefiUnloadImageString
[2].Replace(Dict
))
1613 AutoGenH
.Append(gUefiUnloadImagePrototype
.Replace(Dict
))
1615 ## Create code for GUID
1617 # @param Info The ModuleAutoGen object
1618 # @param AutoGenC The TemplateString object for C code
1619 # @param AutoGenH The TemplateString object for header file
1621 def CreateGuidDefinitionCode(Info
, AutoGenC
, AutoGenH
):
1622 if Info
.ModuleType
in ["USER_DEFINED", "BASE"]:
1625 GuidType
= "EFI_GUID"
1628 if not Info
.IsLibrary
:
1629 AutoGenC
.Append("\n// Guids\n")
1630 AutoGenH
.Append("\n// Guids\n")
1634 for Key
in Info
.GuidList
:
1635 if not Info
.IsLibrary
:
1636 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType
, Key
, Info
.GuidList
[Key
]))
1637 AutoGenH
.Append('extern %s %s;\n' % (GuidType
, Key
))
1639 ## Create code for protocol
1641 # @param Info The ModuleAutoGen object
1642 # @param AutoGenC The TemplateString object for C code
1643 # @param AutoGenH The TemplateString object for header file
1645 def CreateProtocolDefinitionCode(Info
, AutoGenC
, AutoGenH
):
1646 if Info
.ModuleType
in ["USER_DEFINED", "BASE"]:
1649 GuidType
= "EFI_GUID"
1651 if Info
.ProtocolList
:
1652 if not Info
.IsLibrary
:
1653 AutoGenC
.Append("\n// Protocols\n")
1654 AutoGenH
.Append("\n// Protocols\n")
1658 for Key
in Info
.ProtocolList
:
1659 if not Info
.IsLibrary
:
1660 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType
, Key
, Info
.ProtocolList
[Key
]))
1661 AutoGenH
.Append('extern %s %s;\n' % (GuidType
, Key
))
1663 ## Create code for PPI
1665 # @param Info The ModuleAutoGen object
1666 # @param AutoGenC The TemplateString object for C code
1667 # @param AutoGenH The TemplateString object for header file
1669 def CreatePpiDefinitionCode(Info
, AutoGenC
, AutoGenH
):
1670 if Info
.ModuleType
in ["USER_DEFINED", "BASE"]:
1673 GuidType
= "EFI_GUID"
1676 if not Info
.IsLibrary
:
1677 AutoGenC
.Append("\n// PPIs\n")
1678 AutoGenH
.Append("\n// PPIs\n")
1682 for Key
in Info
.PpiList
:
1683 if not Info
.IsLibrary
:
1684 AutoGenC
.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType
, Key
, Info
.PpiList
[Key
]))
1685 AutoGenH
.Append('extern %s %s;\n' % (GuidType
, Key
))
1687 ## Create code for PCD
1689 # @param Info The ModuleAutoGen object
1690 # @param AutoGenC The TemplateString object for C code
1691 # @param AutoGenH The TemplateString object for header file
1693 def CreatePcdCode(Info
, AutoGenC
, AutoGenH
):
1695 # Collect Token Space GUIDs used by DynamicEc PCDs
1697 for Pcd
in Info
.ModulePcdList
:
1698 if Pcd
.Type
in gDynamicExPcd
and Pcd
.TokenSpaceGuidCName
not in TokenSpaceList
:
1699 TokenSpaceList
+= [Pcd
.TokenSpaceGuidCName
]
1701 SkuMgr
= Info
.Workspace
.Platform
.SkuIdMgr
1702 AutoGenH
.Append("\n// Definition of SkuId Array\n")
1703 AutoGenH
.Append("extern UINT64 _gPcd_SkuId_Array[];\n")
1704 # Add extern declarations to AutoGen.h if one or more Token Space GUIDs were found
1706 AutoGenH
.Append("\n// Definition of PCD Token Space GUIDs used in this module\n\n")
1707 if Info
.ModuleType
in ["USER_DEFINED", "BASE"]:
1710 GuidType
= "EFI_GUID"
1711 for Item
in TokenSpaceList
:
1712 AutoGenH
.Append('extern %s %s;\n' % (GuidType
, Item
))
1715 if Info
.ModulePcdList
:
1716 AutoGenH
.Append("\n// PCD definitions\n")
1717 for Pcd
in Info
.ModulePcdList
:
1718 CreateLibraryPcdCode(Info
, AutoGenC
, AutoGenH
, Pcd
)
1719 DynExPcdTokenNumberMapping (Info
, AutoGenH
)
1721 AutoGenC
.Append("\n// Definition of SkuId Array\n")
1722 AutoGenC
.Append("GLOBAL_REMOVE_IF_UNREFERENCED UINT64 _gPcd_SkuId_Array[] = %s;\n" % SkuMgr
.DumpSkuIdArrary())
1723 if Info
.ModulePcdList
:
1724 AutoGenH
.Append("\n// Definition of PCDs used in this module\n")
1725 AutoGenC
.Append("\n// Definition of PCDs used in this module\n")
1726 for Pcd
in Info
.ModulePcdList
:
1727 CreateModulePcdCode(Info
, AutoGenC
, AutoGenH
, Pcd
)
1728 DynExPcdTokenNumberMapping (Info
, AutoGenH
)
1729 if Info
.LibraryPcdList
:
1730 AutoGenH
.Append("\n// Definition of PCDs used in libraries is in AutoGen.c\n")
1731 AutoGenC
.Append("\n// Definition of PCDs used in libraries\n")
1732 for Pcd
in Info
.LibraryPcdList
:
1733 CreateModulePcdCode(Info
, AutoGenC
, AutoGenC
, Pcd
)
1734 CreatePcdDatabaseCode(Info
, AutoGenC
, AutoGenH
)
1736 ## Create code for unicode string definition
1738 # @param Info The ModuleAutoGen object
1739 # @param AutoGenC The TemplateString object for C code
1740 # @param AutoGenH The TemplateString object for header file
1741 # @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True
1742 # @param UniGenBinBuffer Buffer to store uni string package data
1744 def CreateUnicodeStringCode(Info
, AutoGenC
, AutoGenH
, UniGenCFlag
, UniGenBinBuffer
):
1745 WorkingDir
= os
.getcwd()
1746 os
.chdir(Info
.WorkspaceDir
)
1748 IncList
= [Info
.MetaFile
.Dir
]
1749 # Get all files under [Sources] section in inf file for EDK-II module
1751 SrcList
= [F
for F
in Info
.SourceFileList
]
1752 if Info
.AutoGenVersion
< 0x00010005:
1754 # Get all files under the module directory for EDK-I module
1756 os
.chdir(Info
.MetaFile
.Dir
)
1757 for Root
, Dirs
, Files
in os
.walk("."):
1763 File
= PathClass(os
.path
.join(Root
, File
), Info
.MetaFile
.Dir
)
1766 SrcList
.append(File
)
1769 if 'BUILD' in Info
.BuildOption
and Info
.BuildOption
['BUILD']['FLAGS'].find('-c') > -1:
1770 CompatibleMode
= True
1772 CompatibleMode
= False
1775 # -s is a temporary option dedicated for building .UNI files with ISO 639-2 language codes of EDK Shell in EDK2
1777 if 'BUILD' in Info
.BuildOption
and Info
.BuildOption
['BUILD']['FLAGS'].find('-s') > -1:
1779 EdkLogger
.error("build", AUTOGEN_ERROR
,
1780 "-c and -s build options should be used exclusively",
1781 ExtraData
="[%s]" % str(Info
))
1786 #RFC4646 is only for EDKII modules and ISO639-2 for EDK modules
1788 FilterInfo
= [EDK2Module
] + [Info
.PlatformInfo
.Platform
.RFCLanguages
]
1790 FilterInfo
= [EDK2Module
] + [Info
.PlatformInfo
.Platform
.ISOLanguages
]
1791 Header
, Code
= GetStringFiles(Info
.UnicodeFileList
, SrcList
, IncList
, Info
.IncludePathList
, ['.uni', '.inf'], Info
.Name
, CompatibleMode
, ShellMode
, UniGenCFlag
, UniGenBinBuffer
, FilterInfo
)
1792 if CompatibleMode
or UniGenCFlag
:
1793 AutoGenC
.Append("\n//\n//Unicode String Pack Definition\n//\n")
1794 AutoGenC
.Append(Code
)
1795 AutoGenC
.Append("\n")
1796 AutoGenH
.Append("\n//\n//Unicode String ID\n//\n")
1797 AutoGenH
.Append(Header
)
1798 if CompatibleMode
or UniGenCFlag
:
1799 AutoGenH
.Append("\n#define STRING_ARRAY_NAME %sStrings\n" % Info
.Name
)
1800 os
.chdir(WorkingDir
)
1802 def CreateIdfFileCode(Info
, AutoGenC
, StringH
, IdfGenCFlag
, IdfGenBinBuffer
):
1803 if len(Info
.IdfFileList
) > 0:
1804 ImageFiles
= IdfFileClassObject(sorted (Info
.IdfFileList
))
1805 if ImageFiles
.ImageFilesDict
:
1808 IncList
= [Info
.MetaFile
.Dir
]
1809 SrcList
= [F
for F
in Info
.SourceFileList
]
1810 SkipList
= ['.jpg', '.png', '.bmp', '.inf', '.idf']
1811 FileList
= GetFileList(SrcList
, IncList
, SkipList
)
1813 StringH
.Append("\n//\n//Image ID\n//\n")
1815 PaletteInfoOffset
= 0
1816 ImageBuffer
= pack('x')
1817 PaletteBuffer
= pack('x')
1821 for Idf
in ImageFiles
.ImageFilesDict
:
1822 if ImageFiles
.ImageFilesDict
[Idf
]:
1823 for FileObj
in ImageFiles
.ImageFilesDict
[Idf
]:
1824 for sourcefile
in Info
.SourceFileList
:
1825 if FileObj
.FileName
== sourcefile
.File
:
1826 if not sourcefile
.Ext
.upper() in ['.PNG', '.BMP', '.JPG']:
1827 EdkLogger
.error("build", AUTOGEN_ERROR
, "The %s's postfix must be one of .bmp, .jpg, .png" % (FileObj
.FileName
), ExtraData
="[%s]" % str(Info
))
1828 FileObj
.File
= sourcefile
1831 EdkLogger
.error("build", AUTOGEN_ERROR
, "The %s in %s is not defined in the driver's [Sources] section" % (FileObj
.FileName
, Idf
), ExtraData
="[%s]" % str(Info
))
1833 for FileObj
in ImageFiles
.ImageFilesDict
[Idf
]:
1834 ID
= FileObj
.ImageID
1836 if not os
.path
.exists(File
.Path
) or not os
.path
.isfile(File
.Path
):
1837 EdkLogger
.error("build", FILE_NOT_FOUND
, ExtraData
=File
.Path
)
1838 SearchImageID (FileObj
, FileList
)
1839 if FileObj
.Referenced
:
1840 if (ValueStartPtr
- len(DEFINE_STR
+ ID
)) <= 0:
1841 Line
= DEFINE_STR
+ ' ' + ID
+ ' ' + DecToHexStr(Index
, 4) + '\n'
1843 Line
= DEFINE_STR
+ ' ' + ID
+ ' ' * (ValueStartPtr
- len(DEFINE_STR
+ ID
)) + DecToHexStr(Index
, 4) + '\n'
1845 if File
not in FileDict
:
1846 FileDict
[File
] = Index
1848 DuplicateBlock
= pack('B', EFI_HII_IIBT_DUPLICATE
)
1849 DuplicateBlock
+= pack('H', FileDict
[File
])
1850 ImageBuffer
+= DuplicateBlock
1851 BufferStr
= WriteLine(BufferStr
, '// %s: %s: %s' % (DecToHexStr(Index
, 4), ID
, DecToHexStr(Index
, 4)))
1852 TempBufferList
= AscToHexList(DuplicateBlock
)
1853 BufferStr
= WriteLine(BufferStr
, CreateArrayItem(TempBufferList
, 16) + '\n')
1854 StringH
.Append(Line
)
1858 TmpFile
= open(File
.Path
, 'rb')
1859 Buffer
= TmpFile
.read()
1861 if File
.Ext
.upper() == '.PNG':
1862 TempBuffer
= pack('B', EFI_HII_IIBT_IMAGE_PNG
)
1863 TempBuffer
+= pack('I', len(Buffer
))
1864 TempBuffer
+= Buffer
1865 elif File
.Ext
.upper() == '.JPG':
1866 ImageType
, = struct
.unpack('4s', Buffer
[6:10])
1867 if ImageType
!= 'JFIF':
1868 EdkLogger
.error("build", FILE_TYPE_MISMATCH
, "The file %s is not a standard JPG file." % File
.Path
)
1869 TempBuffer
= pack('B', EFI_HII_IIBT_IMAGE_JPEG
)
1870 TempBuffer
+= pack('I', len(Buffer
))
1871 TempBuffer
+= Buffer
1872 elif File
.Ext
.upper() == '.BMP':
1873 TempBuffer
, TempPalette
= BmpImageDecoder(File
, Buffer
, PaletteIndex
, FileObj
.TransParent
)
1874 if len(TempPalette
) > 1:
1876 NewPalette
= pack('H', len(TempPalette
))
1877 NewPalette
+= TempPalette
1878 PaletteBuffer
+= NewPalette
1879 PaletteStr
= WriteLine(PaletteStr
, '// %s: %s: %s' % (DecToHexStr(PaletteIndex
- 1, 4), ID
, DecToHexStr(PaletteIndex
- 1, 4)))
1880 TempPaletteList
= AscToHexList(NewPalette
)
1881 PaletteStr
= WriteLine(PaletteStr
, CreateArrayItem(TempPaletteList
, 16) + '\n')
1882 ImageBuffer
+= TempBuffer
1883 BufferStr
= WriteLine(BufferStr
, '// %s: %s: %s' % (DecToHexStr(Index
, 4), ID
, DecToHexStr(Index
, 4)))
1884 TempBufferList
= AscToHexList(TempBuffer
)
1885 BufferStr
= WriteLine(BufferStr
, CreateArrayItem(TempBufferList
, 16) + '\n')
1887 StringH
.Append(Line
)
1890 BufferStr
= WriteLine(BufferStr
, '// End of the Image Info')
1891 BufferStr
= WriteLine(BufferStr
, CreateArrayItem(DecToHexList(EFI_HII_IIBT_END
, 2)) + '\n')
1892 ImageEnd
= pack('B', EFI_HII_IIBT_END
)
1893 ImageBuffer
+= ImageEnd
1895 if len(ImageBuffer
) > 1:
1896 ImageInfoOffset
= 12
1897 if len(PaletteBuffer
) > 1:
1898 PaletteInfoOffset
= 12 + len(ImageBuffer
) - 1 # -1 is for the first empty pad byte of ImageBuffer
1900 IMAGE_PACKAGE_HDR
= pack('=II', ImageInfoOffset
, PaletteInfoOffset
)
1901 # PACKAGE_HEADER_Length = PACKAGE_HEADER + ImageInfoOffset + PaletteInfoOffset + ImageBuffer Length + PaletteCount + PaletteBuffer Length
1902 if len(PaletteBuffer
) > 1:
1903 PACKAGE_HEADER_Length
= 4 + 4 + 4 + len(ImageBuffer
) - 1 + 2 + len(PaletteBuffer
) - 1
1905 PACKAGE_HEADER_Length
= 4 + 4 + 4 + len(ImageBuffer
) - 1
1906 if PaletteIndex
> 1:
1907 PALETTE_INFO_HEADER
= pack('H', PaletteIndex
- 1)
1908 # EFI_HII_PACKAGE_HEADER length max value is 0xFFFFFF
1909 Hex_Length
= '%06X' % PACKAGE_HEADER_Length
1910 if PACKAGE_HEADER_Length
> 0xFFFFFF:
1911 EdkLogger
.error("build", AUTOGEN_ERROR
, "The Length of EFI_HII_PACKAGE_HEADER exceed its maximum value", ExtraData
="[%s]" % str(Info
))
1912 PACKAGE_HEADER
= pack('=HBB', int('0x' + Hex_Length
[2:], 16), int('0x' + Hex_Length
[0:2], 16), EFI_HII_PACKAGE_IMAGES
)
1914 IdfGenBinBuffer
.write(PACKAGE_HEADER
)
1915 IdfGenBinBuffer
.write(IMAGE_PACKAGE_HDR
)
1916 if len(ImageBuffer
) > 1 :
1917 IdfGenBinBuffer
.write(ImageBuffer
[1:])
1918 if PaletteIndex
> 1:
1919 IdfGenBinBuffer
.write(PALETTE_INFO_HEADER
)
1920 if len(PaletteBuffer
) > 1:
1921 IdfGenBinBuffer
.write(PaletteBuffer
[1:])
1924 TotalLength
= EFI_HII_ARRAY_SIZE_LENGTH
+ PACKAGE_HEADER_Length
1925 AutoGenC
.Append("\n//\n//Image Pack Definition\n//\n")
1926 AllStr
= WriteLine('', CHAR_ARRAY_DEFIN
+ ' ' + Info
.Module
.BaseName
+ 'Images' + '[] = {\n')
1927 AllStr
= WriteLine(AllStr
, '// STRGATHER_OUTPUT_HEADER')
1928 AllStr
= WriteLine(AllStr
, CreateArrayItem(DecToHexList(TotalLength
)) + '\n')
1929 AllStr
= WriteLine(AllStr
, '// Image PACKAGE HEADER\n')
1930 IMAGE_PACKAGE_HDR_List
= AscToHexList(PACKAGE_HEADER
)
1931 IMAGE_PACKAGE_HDR_List
+= AscToHexList(IMAGE_PACKAGE_HDR
)
1932 AllStr
= WriteLine(AllStr
, CreateArrayItem(IMAGE_PACKAGE_HDR_List
, 16) + '\n')
1933 AllStr
= WriteLine(AllStr
, '// Image DATA\n')
1935 AllStr
= WriteLine(AllStr
, BufferStr
)
1937 AllStr
= WriteLine(AllStr
, '// Palette Header\n')
1938 PALETTE_INFO_HEADER_List
= AscToHexList(PALETTE_INFO_HEADER
)
1939 AllStr
= WriteLine(AllStr
, CreateArrayItem(PALETTE_INFO_HEADER_List
, 16) + '\n')
1940 AllStr
= WriteLine(AllStr
, '// Palette Data\n')
1941 AllStr
= WriteLine(AllStr
, PaletteStr
)
1942 AllStr
= WriteLine(AllStr
, '};')
1943 AutoGenC
.Append(AllStr
)
1944 AutoGenC
.Append("\n")
1945 StringH
.Append('\nextern unsigned char ' + Info
.Module
.BaseName
+ 'Images[];\n')
1946 StringH
.Append("\n#define IMAGE_ARRAY_NAME %sImages\n" % Info
.Module
.BaseName
)
1948 # typedef struct _EFI_HII_IMAGE_PACKAGE_HDR {
1949 # EFI_HII_PACKAGE_HEADER Header; # Standard package header, where Header.Type = EFI_HII_PACKAGE_IMAGES
1950 # UINT32 ImageInfoOffset;
1951 # UINT32 PaletteInfoOffset;
1952 # } EFI_HII_IMAGE_PACKAGE_HDR;
1958 # } EFI_HII_PACKAGE_HEADER;
1960 # typedef struct _EFI_HII_IMAGE_BLOCK {
1962 # UINT8 BlockBody[];
1963 # } EFI_HII_IMAGE_BLOCK;
1965 def BmpImageDecoder(File
, Buffer
, PaletteIndex
, TransParent
):
1966 ImageType
, = struct
.unpack('2s', Buffer
[0:2])
1967 if ImageType
!= 'BM': # BMP file type is 'BM'
1968 EdkLogger
.error("build", FILE_TYPE_MISMATCH
, "The file %s is not a standard BMP file." % File
.Path
)
1969 BMP_IMAGE_HEADER
= collections
.namedtuple('BMP_IMAGE_HEADER', ['bfSize','bfReserved1','bfReserved2','bfOffBits','biSize','biWidth','biHeight','biPlanes','biBitCount', 'biCompression', 'biSizeImage','biXPelsPerMeter','biYPelsPerMeter','biClrUsed','biClrImportant'])
1970 BMP_IMAGE_HEADER_STRUCT
= struct
.Struct('IHHIIIIHHIIIIII')
1971 BmpHeader
= BMP_IMAGE_HEADER
._make
(BMP_IMAGE_HEADER_STRUCT
.unpack_from(Buffer
[2:]))
1973 # Doesn't support compress.
1975 if BmpHeader
.biCompression
!= 0:
1976 EdkLogger
.error("build", FORMAT_NOT_SUPPORTED
, "The compress BMP file %s is not support." % File
.Path
)
1978 # The Width and Height is UINT16 type in Image Package
1979 if BmpHeader
.biWidth
> 0xFFFF:
1980 EdkLogger
.error("build", FORMAT_NOT_SUPPORTED
, "The BMP file %s Width is exceed 0xFFFF." % File
.Path
)
1981 if BmpHeader
.biHeight
> 0xFFFF:
1982 EdkLogger
.error("build", FORMAT_NOT_SUPPORTED
, "The BMP file %s Height is exceed 0xFFFF." % File
.Path
)
1984 PaletteBuffer
= pack('x')
1985 if BmpHeader
.biBitCount
== 1:
1987 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_1BIT_TRANS
)
1989 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_1BIT
)
1990 ImageBuffer
+= pack('B', PaletteIndex
)
1991 Width
= (BmpHeader
.biWidth
+ 7)/8
1992 if BmpHeader
.bfOffBits
> BMP_IMAGE_HEADER_STRUCT
.size
+ 2:
1993 PaletteBuffer
= Buffer
[BMP_IMAGE_HEADER_STRUCT
.size
+ 2 : BmpHeader
.bfOffBits
]
1994 elif BmpHeader
.biBitCount
== 4:
1996 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_4BIT_TRANS
)
1998 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_4BIT
)
1999 ImageBuffer
+= pack('B', PaletteIndex
)
2000 Width
= (BmpHeader
.biWidth
+ 1)/2
2001 if BmpHeader
.bfOffBits
> BMP_IMAGE_HEADER_STRUCT
.size
+ 2:
2002 PaletteBuffer
= Buffer
[BMP_IMAGE_HEADER_STRUCT
.size
+ 2 : BmpHeader
.bfOffBits
]
2003 elif BmpHeader
.biBitCount
== 8:
2005 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_8BIT_TRANS
)
2007 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_8BIT
)
2008 ImageBuffer
+= pack('B', PaletteIndex
)
2009 Width
= BmpHeader
.biWidth
2010 if BmpHeader
.bfOffBits
> BMP_IMAGE_HEADER_STRUCT
.size
+ 2:
2011 PaletteBuffer
= Buffer
[BMP_IMAGE_HEADER_STRUCT
.size
+ 2 : BmpHeader
.bfOffBits
]
2012 elif BmpHeader
.biBitCount
== 24:
2014 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_24BIT_TRANS
)
2016 ImageBuffer
= pack('B', EFI_HII_IIBT_IMAGE_24BIT
)
2017 Width
= BmpHeader
.biWidth
* 3
2019 EdkLogger
.error("build", FORMAT_NOT_SUPPORTED
, "Only support the 1 bit, 4 bit, 8bit, 24 bit BMP files.", ExtraData
="[%s]" % str(File
.Path
))
2021 ImageBuffer
+= pack('H', BmpHeader
.biWidth
)
2022 ImageBuffer
+= pack('H', BmpHeader
.biHeight
)
2023 Start
= BmpHeader
.bfOffBits
2024 End
= BmpHeader
.bfSize
- 1
2025 for Height
in range(0, BmpHeader
.biHeight
):
2027 Start
= End
+ (Width
% 4) - 4 - Width
2030 ImageBuffer
+= Buffer
[Start
+ 1 : Start
+ Width
+ 1]
2033 # handle the Palette info, BMP use 4 bytes for R, G, B and Reserved info while EFI_HII_RGB_PIXEL only have the R, G, B info
2034 if PaletteBuffer
and len(PaletteBuffer
) > 1:
2035 PaletteTemp
= pack('x')
2036 for Index
in range(0, len(PaletteBuffer
)):
2039 PaletteTemp
+= PaletteBuffer
[Index
]
2040 PaletteBuffer
= PaletteTemp
[1:]
2041 return ImageBuffer
, PaletteBuffer
2043 ## Create common code
2045 # @param Info The ModuleAutoGen object
2046 # @param AutoGenC The TemplateString object for C code
2047 # @param AutoGenH The TemplateString object for header file
2049 def CreateHeaderCode(Info
, AutoGenC
, AutoGenH
):
2051 AutoGenH
.Append(gAutoGenHeaderString
.Replace({'FileName':'AutoGen.h'}))
2052 # header file Prologue
2053 AutoGenH
.Append(gAutoGenHPrologueString
.Replace({'File':'AUTOGENH','Guid':Info
.Guid
.replace('-','_')}))
2054 AutoGenH
.Append(gAutoGenHCppPrologueString
)
2055 if Info
.AutoGenVersion
>= 0x00010005:
2056 # header files includes
2057 AutoGenH
.Append("#include <%s>\n" % gBasicHeaderFile
)
2058 if Info
.ModuleType
in gModuleTypeHeaderFile \
2059 and gModuleTypeHeaderFile
[Info
.ModuleType
][0] != gBasicHeaderFile
:
2060 AutoGenH
.Append("#include <%s>\n" % gModuleTypeHeaderFile
[Info
.ModuleType
][0])
2062 # if either PcdLib in [LibraryClasses] sections or there exist Pcd section, add PcdLib.h
2063 # As if modules only uses FixedPcd, then PcdLib is not needed in [LibraryClasses] section.
2065 if 'PcdLib' in Info
.Module
.LibraryClasses
or Info
.Module
.Pcds
:
2066 AutoGenH
.Append("#include <Library/PcdLib.h>\n")
2068 AutoGenH
.Append('\nextern GUID gEfiCallerIdGuid;')
2069 AutoGenH
.Append('\nextern CHAR8 *gEfiCallerBaseName;\n\n')
2074 AutoGenH
.Append("#define EFI_CALLER_ID_GUID \\\n %s\n" % GuidStringToGuidStructureString(Info
.Guid
))
2079 AutoGenC
.Append(gAutoGenHeaderString
.Replace({'FileName':'AutoGen.c'}))
2080 if Info
.AutoGenVersion
>= 0x00010005:
2081 # C file header files includes
2082 if Info
.ModuleType
in gModuleTypeHeaderFile
:
2083 for Inc
in gModuleTypeHeaderFile
[Info
.ModuleType
]:
2084 AutoGenC
.Append("#include <%s>\n" % Inc
)
2086 AutoGenC
.Append("#include <%s>\n" % gBasicHeaderFile
)
2089 # Publish the CallerId Guid
2091 AutoGenC
.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = %s;\n' % GuidStringToGuidStructureString(Info
.Guid
))
2092 AutoGenC
.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED CHAR8 *gEfiCallerBaseName = "%s";\n' % Info
.Name
)
2094 ## Create common code for header file
2096 # @param Info The ModuleAutoGen object
2097 # @param AutoGenC The TemplateString object for C code
2098 # @param AutoGenH The TemplateString object for header file
2100 def CreateFooterCode(Info
, AutoGenC
, AutoGenH
):
2101 AutoGenH
.Append(gAutoGenHEpilogueString
)
2103 ## Create code for a module
2105 # @param Info The ModuleAutoGen object
2106 # @param AutoGenC The TemplateString object for C code
2107 # @param AutoGenH The TemplateString object for header file
2108 # @param StringH The TemplateString object for header file
2109 # @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True
2110 # @param UniGenBinBuffer Buffer to store uni string package data
2111 # @param StringIdf The TemplateString object for header file
2112 # @param IdfGenCFlag IdfString is generated into AutoGen C file when it is set to True
2113 # @param IdfGenBinBuffer Buffer to store Idf string package data
2115 def CreateCode(Info
, AutoGenC
, AutoGenH
, StringH
, UniGenCFlag
, UniGenBinBuffer
, StringIdf
, IdfGenCFlag
, IdfGenBinBuffer
):
2116 CreateHeaderCode(Info
, AutoGenC
, AutoGenH
)
2118 if Info
.AutoGenVersion
>= 0x00010005:
2119 CreateGuidDefinitionCode(Info
, AutoGenC
, AutoGenH
)
2120 CreateProtocolDefinitionCode(Info
, AutoGenC
, AutoGenH
)
2121 CreatePpiDefinitionCode(Info
, AutoGenC
, AutoGenH
)
2122 CreatePcdCode(Info
, AutoGenC
, AutoGenH
)
2123 CreateLibraryConstructorCode(Info
, AutoGenC
, AutoGenH
)
2124 CreateLibraryDestructorCode(Info
, AutoGenC
, AutoGenH
)
2125 CreateModuleEntryPointCode(Info
, AutoGenC
, AutoGenH
)
2126 CreateModuleUnloadImageCode(Info
, AutoGenC
, AutoGenH
)
2128 if Info
.UnicodeFileList
:
2129 FileName
= "%sStrDefs.h" % Info
.Name
2130 StringH
.Append(gAutoGenHeaderString
.Replace({'FileName':FileName
}))
2131 StringH
.Append(gAutoGenHPrologueString
.Replace({'File':'STRDEFS', 'Guid':Info
.Guid
.replace('-','_')}))
2132 CreateUnicodeStringCode(Info
, AutoGenC
, StringH
, UniGenCFlag
, UniGenBinBuffer
)
2135 for Guid
in Info
.Module
.Guids
:
2136 if Guid
in Info
.Module
.GetGuidsUsedByPcd():
2138 GuidMacros
.append('#define %s %s' % (Guid
, Info
.Module
.Guids
[Guid
]))
2139 for Guid
, Value
in Info
.Module
.Protocols
.items() + Info
.Module
.Ppis
.items():
2140 GuidMacros
.append('#define %s %s' % (Guid
, Value
))
2141 # supports FixedAtBuild usage in VFR file
2142 if Info
.VfrFileList
and Info
.ModulePcdList
:
2143 GuidMacros
.append('#define %s %s' % ('FixedPcdGetBool(TokenName)', '_PCD_VALUE_##TokenName'))
2144 GuidMacros
.append('#define %s %s' % ('FixedPcdGet8(TokenName)', '_PCD_VALUE_##TokenName'))
2145 GuidMacros
.append('#define %s %s' % ('FixedPcdGet16(TokenName)', '_PCD_VALUE_##TokenName'))
2146 GuidMacros
.append('#define %s %s' % ('FixedPcdGet32(TokenName)', '_PCD_VALUE_##TokenName'))
2147 GuidMacros
.append('#define %s %s' % ('FixedPcdGet64(TokenName)', '_PCD_VALUE_##TokenName'))
2148 for Pcd
in Info
.ModulePcdList
:
2149 if Pcd
.Type
== TAB_PCDS_FIXED_AT_BUILD
:
2150 TokenCName
= Pcd
.TokenCName
2151 Value
= Pcd
.DefaultValue
2152 if Pcd
.DatumType
== 'BOOLEAN':
2153 BoolValue
= Value
.upper()
2154 if BoolValue
== 'TRUE':
2156 elif BoolValue
== 'FALSE':
2158 for PcdItem
in GlobalData
.MixedPcd
:
2159 if (Pcd
.TokenCName
, Pcd
.TokenSpaceGuidCName
) in GlobalData
.MixedPcd
[PcdItem
]:
2160 TokenCName
= PcdItem
[0]
2162 GuidMacros
.append('#define %s %s' % ('_PCD_VALUE_'+TokenCName
, Value
))
2164 if Info
.IdfFileList
:
2165 GuidMacros
.append('#include "%sImgDefs.h"' % Info
.Name
)
2168 StringH
.Append('\n#ifdef VFRCOMPILE\n%s\n#endif\n' % '\n'.join(GuidMacros
))
2170 StringH
.Append("\n#endif\n")
2171 AutoGenH
.Append('#include "%s"\n' % FileName
)
2173 if Info
.IdfFileList
:
2174 FileName
= "%sImgDefs.h" % Info
.Name
2175 StringIdf
.Append(gAutoGenHeaderString
.Replace({'FileName':FileName
}))
2176 StringIdf
.Append(gAutoGenHPrologueString
.Replace({'File':'IMAGEDEFS', 'Guid':Info
.Guid
.replace('-','_')}))
2177 CreateIdfFileCode(Info
, AutoGenC
, StringIdf
, IdfGenCFlag
, IdfGenBinBuffer
)
2179 StringIdf
.Append("\n#endif\n")
2180 AutoGenH
.Append('#include "%s"\n' % FileName
)
2182 CreateFooterCode(Info
, AutoGenC
, AutoGenH
)
2184 # no generation of AutoGen.c for Edk modules without unicode file
2185 if Info
.AutoGenVersion
< 0x00010005 and len(Info
.UnicodeFileList
) == 0:
2186 AutoGenC
.String
= ''
2188 ## Create the code file
2190 # @param FilePath The path of code file
2191 # @param Content The content of code file
2192 # @param IsBinaryFile The flag indicating if the file is binary file or not
2194 # @retval True If file content is changed or file doesn't exist
2195 # @retval False If the file exists and the content is not changed
2197 def Generate(FilePath
, Content
, IsBinaryFile
):
2198 return SaveFileOnChange(FilePath
, Content
, IsBinaryFile
)