]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Source/Python/AutoGen/GenC.py
BaseTools: Generate macro for the size of PCD value
[mirror_edk2.git] / BaseTools / Source / Python / AutoGen / GenC.py
CommitLineData
f51461c8
LG
1## @file\r
2# Routines for generating AutoGen.h and AutoGen.c\r
3#\r
82a6a960 4# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>\r
f51461c8
LG
5# This program and the accompanying materials\r
6# are licensed and made available under the terms and conditions of the BSD License\r
7# which accompanies this distribution. The full text of the license may be found at\r
8# http://opensource.org/licenses/bsd-license.php\r
9#\r
10# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12#\r
13\r
14## Import Modules\r
15#\r
16import string\r
17\r
18from Common import EdkLogger\r
19\r
20from Common.BuildToolError import *\r
21from Common.DataType import *\r
22from Common.Misc import *\r
23from Common.String import StringToArray\r
24from StrGather import *\r
25from GenPcdDb import CreatePcdDatabaseCode\r
26\r
27## PCD type string\r
28gItemTypeStringDatabase = {\r
29 TAB_PCDS_FEATURE_FLAG : 'FixedAtBuild',\r
30 TAB_PCDS_FIXED_AT_BUILD : 'FixedAtBuild',\r
31 TAB_PCDS_PATCHABLE_IN_MODULE: 'BinaryPatch',\r
32 TAB_PCDS_DYNAMIC : '',\r
33 TAB_PCDS_DYNAMIC_DEFAULT : '',\r
34 TAB_PCDS_DYNAMIC_VPD : '',\r
35 TAB_PCDS_DYNAMIC_HII : '',\r
36 TAB_PCDS_DYNAMIC_EX : '',\r
37 TAB_PCDS_DYNAMIC_EX_DEFAULT : '',\r
38 TAB_PCDS_DYNAMIC_EX_VPD : '',\r
39 TAB_PCDS_DYNAMIC_EX_HII : '',\r
40}\r
41\r
42## Dynamic PCD types\r
43gDynamicPcd = [TAB_PCDS_DYNAMIC, TAB_PCDS_DYNAMIC_DEFAULT, TAB_PCDS_DYNAMIC_VPD, TAB_PCDS_DYNAMIC_HII]\r
44\r
45## Dynamic-ex PCD types\r
46gDynamicExPcd = [TAB_PCDS_DYNAMIC_EX, TAB_PCDS_DYNAMIC_EX_DEFAULT, TAB_PCDS_DYNAMIC_EX_VPD, TAB_PCDS_DYNAMIC_EX_HII]\r
47\r
48## Datum size\r
49gDatumSizeStringDatabase = {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'BOOLEAN','VOID*':'8'}\r
50gDatumSizeStringDatabaseH = {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'BOOL','VOID*':'PTR'}\r
51gDatumSizeStringDatabaseLib = {'UINT8':'8','UINT16':'16','UINT32':'32','UINT64':'64','BOOLEAN':'Bool','VOID*':'Ptr'}\r
52\r
53## AutoGen File Header Templates\r
54gAutoGenHeaderString = TemplateString("""\\r
55/**\r
56 DO NOT EDIT\r
57 FILE auto-generated\r
58 Module name:\r
59 ${FileName}\r
60 Abstract: Auto-generated ${FileName} for building module or library.\r
61**/\r
62""")\r
63\r
64gAutoGenHPrologueString = TemplateString("""\r
65#ifndef _${File}_${Guid}\r
66#define _${File}_${Guid}\r
67\r
68""")\r
69\r
70gAutoGenHCppPrologueString = """\\r
71#ifdef __cplusplus\r
72extern "C" {\r
73#endif\r
74\r
75"""\r
76\r
77gAutoGenHEpilogueString = """\r
78\r
79#ifdef __cplusplus\r
80}\r
81#endif\r
82\r
83#endif\r
84"""\r
85\r
86## PEI Core Entry Point Templates\r
87gPeiCoreEntryPointPrototype = TemplateString("""\r
88${BEGIN}\r
89VOID\r
90EFIAPI\r
91${Function} (\r
92 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,\r
93 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,\r
94 IN VOID *Context\r
95 );\r
96${END}\r
97""")\r
98\r
99gPeiCoreEntryPointString = TemplateString("""\r
100${BEGIN}\r
101VOID\r
102EFIAPI\r
103ProcessModuleEntryPointList (\r
104 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,\r
105 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,\r
106 IN VOID *Context\r
107 )\r
108\r
109{\r
110 ${Function} (SecCoreData, PpiList, Context);\r
111}\r
112${END}\r
113""")\r
114\r
115\r
116## DXE Core Entry Point Templates\r
117gDxeCoreEntryPointPrototype = TemplateString("""\r
118${BEGIN}\r
119VOID\r
120EFIAPI\r
121${Function} (\r
122 IN VOID *HobStart\r
123 );\r
124${END}\r
125""")\r
126\r
127gDxeCoreEntryPointString = TemplateString("""\r
128${BEGIN}\r
129VOID\r
130EFIAPI\r
131ProcessModuleEntryPointList (\r
132 IN VOID *HobStart\r
133 )\r
134\r
135{\r
136 ${Function} (HobStart);\r
137}\r
138${END}\r
139""")\r
140\r
141## PEIM Entry Point Templates\r
142gPeimEntryPointPrototype = TemplateString("""\r
143${BEGIN}\r
144EFI_STATUS\r
145EFIAPI\r
146${Function} (\r
147 IN EFI_PEI_FILE_HANDLE FileHandle,\r
148 IN CONST EFI_PEI_SERVICES **PeiServices\r
149 );\r
150${END}\r
151""")\r
152\r
153gPeimEntryPointString = [\r
154TemplateString("""\r
155GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
156\r
157EFI_STATUS\r
158EFIAPI\r
159ProcessModuleEntryPointList (\r
160 IN EFI_PEI_FILE_HANDLE FileHandle,\r
161 IN CONST EFI_PEI_SERVICES **PeiServices\r
162 )\r
163\r
164{\r
165 return EFI_SUCCESS;\r
166}\r
167"""),\r
168TemplateString("""\r
169GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
170${BEGIN}\r
171EFI_STATUS\r
172EFIAPI\r
173ProcessModuleEntryPointList (\r
174 IN EFI_PEI_FILE_HANDLE FileHandle,\r
175 IN CONST EFI_PEI_SERVICES **PeiServices\r
176 )\r
177\r
178{\r
179 return ${Function} (FileHandle, PeiServices);\r
180}\r
181${END}\r
182"""),\r
183TemplateString("""\r
184GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
185\r
186EFI_STATUS\r
187EFIAPI\r
188ProcessModuleEntryPointList (\r
189 IN EFI_PEI_FILE_HANDLE FileHandle,\r
190 IN CONST EFI_PEI_SERVICES **PeiServices\r
191 )\r
192\r
193{\r
194 EFI_STATUS Status;\r
195 EFI_STATUS CombinedStatus;\r
196\r
197 CombinedStatus = EFI_LOAD_ERROR;\r
198${BEGIN}\r
199 Status = ${Function} (FileHandle, PeiServices);\r
200 if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {\r
201 CombinedStatus = Status;\r
202 }\r
203${END}\r
204 return CombinedStatus;\r
205}\r
206""")\r
207]\r
208\r
209## SMM_CORE Entry Point Templates\r
210gSmmCoreEntryPointPrototype = TemplateString("""\r
211${BEGIN}\r
212EFI_STATUS\r
213EFIAPI\r
214${Function} (\r
215 IN EFI_HANDLE ImageHandle,\r
216 IN EFI_SYSTEM_TABLE *SystemTable\r
217 );\r
218${END}\r
219""")\r
220\r
221gSmmCoreEntryPointString = TemplateString("""\r
222${BEGIN}\r
223const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
224const UINT32 _gDxeRevision = ${PiSpecVersion};\r
225\r
226EFI_STATUS\r
227EFIAPI\r
228ProcessModuleEntryPointList (\r
229 IN EFI_HANDLE ImageHandle,\r
230 IN EFI_SYSTEM_TABLE *SystemTable\r
231 )\r
232{\r
233 return ${Function} (ImageHandle, SystemTable);\r
234}\r
235${END}\r
236""")\r
237\r
238## DXE SMM Entry Point Templates\r
239gDxeSmmEntryPointPrototype = TemplateString("""\r
240${BEGIN}\r
241EFI_STATUS\r
242EFIAPI\r
243${Function} (\r
244 IN EFI_HANDLE ImageHandle,\r
245 IN EFI_SYSTEM_TABLE *SystemTable\r
246 );\r
247${END}\r
248""")\r
249\r
250gDxeSmmEntryPointString = [\r
251TemplateString("""\r
252const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
253const UINT32 _gDxeRevision = ${PiSpecVersion};\r
254\r
255EFI_STATUS\r
256EFIAPI\r
257ProcessModuleEntryPointList (\r
258 IN EFI_HANDLE ImageHandle,\r
259 IN EFI_SYSTEM_TABLE *SystemTable\r
260 )\r
261\r
262{\r
263 return EFI_SUCCESS;\r
264}\r
265"""),\r
266TemplateString("""\r
267const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
268const UINT32 _gDxeRevision = ${PiSpecVersion};\r
269\r
270static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
271static EFI_STATUS mDriverEntryPointStatus;\r
272\r
273VOID\r
274EFIAPI\r
275ExitDriver (\r
276 IN EFI_STATUS Status\r
277 )\r
278{\r
279 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
280 mDriverEntryPointStatus = Status;\r
281 }\r
282 LongJump (&mJumpContext, (UINTN)-1);\r
283 ASSERT (FALSE);\r
284}\r
285\r
286EFI_STATUS\r
287EFIAPI\r
288ProcessModuleEntryPointList (\r
289 IN EFI_HANDLE ImageHandle,\r
290 IN EFI_SYSTEM_TABLE *SystemTable\r
291 )\r
292{\r
293 mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
294\r
295${BEGIN}\r
296 if (SetJump (&mJumpContext) == 0) {\r
297 ExitDriver (${Function} (ImageHandle, SystemTable));\r
298 ASSERT (FALSE);\r
299 }\r
300${END}\r
301\r
302 return mDriverEntryPointStatus;\r
303}\r
304""")\r
305]\r
306\r
307## UEFI Driver Entry Point Templates\r
308gUefiDriverEntryPointPrototype = TemplateString("""\r
309${BEGIN}\r
310EFI_STATUS\r
311EFIAPI\r
312${Function} (\r
313 IN EFI_HANDLE ImageHandle,\r
314 IN EFI_SYSTEM_TABLE *SystemTable\r
315 );\r
316${END}\r
317""")\r
318\r
319gUefiDriverEntryPointString = [\r
320TemplateString("""\r
321const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
322const UINT32 _gDxeRevision = ${PiSpecVersion};\r
323\r
324EFI_STATUS\r
325EFIAPI\r
326ProcessModuleEntryPointList (\r
327 IN EFI_HANDLE ImageHandle,\r
328 IN EFI_SYSTEM_TABLE *SystemTable\r
329 )\r
330{\r
331 return EFI_SUCCESS;\r
332}\r
333"""),\r
334TemplateString("""\r
335const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
336const UINT32 _gDxeRevision = ${PiSpecVersion};\r
337\r
338${BEGIN}\r
339EFI_STATUS\r
340EFIAPI\r
341ProcessModuleEntryPointList (\r
342 IN EFI_HANDLE ImageHandle,\r
343 IN EFI_SYSTEM_TABLE *SystemTable\r
344 )\r
345\r
346{\r
347 return ${Function} (ImageHandle, SystemTable);\r
348}\r
349${END}\r
350VOID\r
351EFIAPI\r
352ExitDriver (\r
353 IN EFI_STATUS Status\r
354 )\r
355{\r
356 if (EFI_ERROR (Status)) {\r
357 ProcessLibraryDestructorList (gImageHandle, gST);\r
358 }\r
359 gBS->Exit (gImageHandle, Status, 0, NULL);\r
360}\r
361"""),\r
362TemplateString("""\r
363const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
364const UINT32 _gDxeRevision = ${PiSpecVersion};\r
365\r
366static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
367static EFI_STATUS mDriverEntryPointStatus;\r
368\r
369EFI_STATUS\r
370EFIAPI\r
371ProcessModuleEntryPointList (\r
372 IN EFI_HANDLE ImageHandle,\r
373 IN EFI_SYSTEM_TABLE *SystemTable\r
374 )\r
375{\r
376 mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
377 ${BEGIN}\r
378 if (SetJump (&mJumpContext) == 0) {\r
379 ExitDriver (${Function} (ImageHandle, SystemTable));\r
380 ASSERT (FALSE);\r
381 }\r
382 ${END}\r
383 return mDriverEntryPointStatus;\r
384}\r
385\r
386VOID\r
387EFIAPI\r
388ExitDriver (\r
389 IN EFI_STATUS Status\r
390 )\r
391{\r
392 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
393 mDriverEntryPointStatus = Status;\r
394 }\r
395 LongJump (&mJumpContext, (UINTN)-1);\r
396 ASSERT (FALSE);\r
397}\r
398""")\r
399]\r
400\r
401\r
402## UEFI Application Entry Point Templates\r
403gUefiApplicationEntryPointPrototype = TemplateString("""\r
404${BEGIN}\r
405EFI_STATUS\r
406EFIAPI\r
407${Function} (\r
408 IN EFI_HANDLE ImageHandle,\r
409 IN EFI_SYSTEM_TABLE *SystemTable\r
410 );\r
411${END}\r
412""")\r
413\r
414gUefiApplicationEntryPointString = [\r
415TemplateString("""\r
416const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
417\r
418EFI_STATUS\r
419EFIAPI\r
420ProcessModuleEntryPointList (\r
421 IN EFI_HANDLE ImageHandle,\r
422 IN EFI_SYSTEM_TABLE *SystemTable\r
423 )\r
424{\r
425 return EFI_SUCCESS;\r
426}\r
427"""),\r
428TemplateString("""\r
429const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
430\r
431${BEGIN}\r
432EFI_STATUS\r
433EFIAPI\r
434ProcessModuleEntryPointList (\r
435 IN EFI_HANDLE ImageHandle,\r
436 IN EFI_SYSTEM_TABLE *SystemTable\r
437 )\r
438\r
439{\r
440 return ${Function} (ImageHandle, SystemTable);\r
441}\r
442${END}\r
443VOID\r
444EFIAPI\r
445ExitDriver (\r
446 IN EFI_STATUS Status\r
447 )\r
448{\r
449 if (EFI_ERROR (Status)) {\r
450 ProcessLibraryDestructorList (gImageHandle, gST);\r
451 }\r
452 gBS->Exit (gImageHandle, Status, 0, NULL);\r
453}\r
454"""),\r
455TemplateString("""\r
456const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
457\r
458EFI_STATUS\r
459EFIAPI\r
460ProcessModuleEntryPointList (\r
461 IN EFI_HANDLE ImageHandle,\r
462 IN EFI_SYSTEM_TABLE *SystemTable\r
463 )\r
464\r
465{\r
466 ${BEGIN}\r
467 if (SetJump (&mJumpContext) == 0) {\r
468 ExitDriver (${Function} (ImageHandle, SystemTable));\r
469 ASSERT (FALSE);\r
470 }\r
471 ${END}\r
472 return mDriverEntryPointStatus;\r
473}\r
474\r
475static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
476static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
477\r
478VOID\r
479EFIAPI\r
480ExitDriver (\r
481 IN EFI_STATUS Status\r
482 )\r
483{\r
484 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
485 mDriverEntryPointStatus = Status;\r
486 }\r
487 LongJump (&mJumpContext, (UINTN)-1);\r
488 ASSERT (FALSE);\r
489}\r
490""")\r
491]\r
492\r
493## UEFI Unload Image Templates\r
494gUefiUnloadImagePrototype = TemplateString("""\r
495${BEGIN}\r
496EFI_STATUS\r
497EFIAPI\r
498${Function} (\r
499 IN EFI_HANDLE ImageHandle\r
500 );\r
501${END}\r
502""")\r
503\r
504gUefiUnloadImageString = [\r
505TemplateString("""\r
506GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
507\r
508EFI_STATUS\r
509EFIAPI\r
510ProcessModuleUnloadList (\r
511 IN EFI_HANDLE ImageHandle\r
512 )\r
513{\r
514 return EFI_SUCCESS;\r
515}\r
516"""),\r
517TemplateString("""\r
518GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
519\r
520${BEGIN}\r
521EFI_STATUS\r
522EFIAPI\r
523ProcessModuleUnloadList (\r
524 IN EFI_HANDLE ImageHandle\r
525 )\r
526{\r
527 return ${Function} (ImageHandle);\r
528}\r
529${END}\r
530"""),\r
531TemplateString("""\r
532GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
533\r
534EFI_STATUS\r
535EFIAPI\r
536ProcessModuleUnloadList (\r
537 IN EFI_HANDLE ImageHandle\r
538 )\r
539{\r
540 EFI_STATUS Status;\r
541\r
542 Status = EFI_SUCCESS;\r
543${BEGIN}\r
544 if (EFI_ERROR (Status)) {\r
545 ${Function} (ImageHandle);\r
546 } else {\r
547 Status = ${Function} (ImageHandle);\r
548 }\r
549${END}\r
550 return Status;\r
551}\r
552""")\r
553]\r
554\r
555gLibraryStructorPrototype = {\r
556'BASE' : TemplateString("""${BEGIN}\r
557RETURN_STATUS\r
558EFIAPI\r
559${Function} (\r
560 VOID\r
561 );${END}\r
562"""),\r
563\r
564'PEI' : TemplateString("""${BEGIN}\r
565EFI_STATUS\r
566EFIAPI\r
567${Function} (\r
568 IN EFI_PEI_FILE_HANDLE FileHandle,\r
569 IN CONST EFI_PEI_SERVICES **PeiServices\r
570 );${END}\r
571"""),\r
572\r
573'DXE' : TemplateString("""${BEGIN}\r
574EFI_STATUS\r
575EFIAPI\r
576${Function} (\r
577 IN EFI_HANDLE ImageHandle,\r
578 IN EFI_SYSTEM_TABLE *SystemTable\r
579 );${END}\r
580"""),\r
581}\r
582\r
583gLibraryStructorCall = {\r
584'BASE' : TemplateString("""${BEGIN}\r
585 Status = ${Function} ();\r
586 ASSERT_EFI_ERROR (Status);${END}\r
587"""),\r
588\r
589'PEI' : TemplateString("""${BEGIN}\r
590 Status = ${Function} (FileHandle, PeiServices);\r
591 ASSERT_EFI_ERROR (Status);${END}\r
592"""),\r
593\r
594'DXE' : TemplateString("""${BEGIN}\r
595 Status = ${Function} (ImageHandle, SystemTable);\r
596 ASSERT_EFI_ERROR (Status);${END}\r
597"""),\r
598}\r
599\r
600## Library Constructor and Destructor Templates\r
601gLibraryString = {\r
602'BASE' : TemplateString("""\r
603${BEGIN}${FunctionPrototype}${END}\r
604\r
605VOID\r
606EFIAPI\r
607ProcessLibrary${Type}List (\r
608 VOID\r
609 )\r
610{\r
611${BEGIN} EFI_STATUS Status;\r
612${FunctionCall}${END}\r
613}\r
614"""),\r
615\r
616'PEI' : TemplateString("""\r
617${BEGIN}${FunctionPrototype}${END}\r
618\r
619VOID\r
620EFIAPI\r
621ProcessLibrary${Type}List (\r
622 IN EFI_PEI_FILE_HANDLE FileHandle,\r
623 IN CONST EFI_PEI_SERVICES **PeiServices\r
624 )\r
625{\r
626${BEGIN} EFI_STATUS Status;\r
627${FunctionCall}${END}\r
628}\r
629"""),\r
630\r
631'DXE' : TemplateString("""\r
632${BEGIN}${FunctionPrototype}${END}\r
633\r
634VOID\r
635EFIAPI\r
636ProcessLibrary${Type}List (\r
637 IN EFI_HANDLE ImageHandle,\r
638 IN EFI_SYSTEM_TABLE *SystemTable\r
639 )\r
640{\r
641${BEGIN} EFI_STATUS Status;\r
642${FunctionCall}${END}\r
643}\r
644"""),\r
645}\r
646\r
647gBasicHeaderFile = "Base.h"\r
648\r
649gModuleTypeHeaderFile = {\r
650 "BASE" : [gBasicHeaderFile],\r
651 "SEC" : ["PiPei.h", "Library/DebugLib.h"],\r
652 "PEI_CORE" : ["PiPei.h", "Library/DebugLib.h", "Library/PeiCoreEntryPoint.h"],\r
653 "PEIM" : ["PiPei.h", "Library/DebugLib.h", "Library/PeimEntryPoint.h"],\r
654 "DXE_CORE" : ["PiDxe.h", "Library/DebugLib.h", "Library/DxeCoreEntryPoint.h"],\r
655 "DXE_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
656 "DXE_SMM_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
657 "DXE_RUNTIME_DRIVER": ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
658 "DXE_SAL_DRIVER" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
659 "UEFI_DRIVER" : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
660 "UEFI_APPLICATION" : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiApplicationEntryPoint.h"],\r
661 "SMM_CORE" : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiDriverEntryPoint.h"],\r
662 "USER_DEFINED" : [gBasicHeaderFile]\r
663}\r
664\r
665## Autogen internal worker macro to define DynamicEx PCD name includes both the TokenSpaceGuidName \r
666# the TokenName and Guid comparison to avoid define name collisions.\r
667#\r
668# @param Info The ModuleAutoGen object\r
669# @param AutoGenH The TemplateString object for header file\r
670#\r
671#\r
672def DynExPcdTokenNumberMapping(Info, AutoGenH):\r
673 ExTokenCNameList = []\r
674 PcdExList = []\r
675 if Info.IsLibrary:\r
676 PcdList = Info.LibraryPcdList\r
677 else:\r
678 PcdList = Info.ModulePcdList\r
679 for Pcd in PcdList:\r
680 if Pcd.Type in gDynamicExPcd:\r
681 ExTokenCNameList.append(Pcd.TokenCName)\r
682 PcdExList.append(Pcd)\r
683 if len(ExTokenCNameList) == 0:\r
684 return\r
685 AutoGenH.Append('\n#define COMPAREGUID(Guid1, Guid2) (BOOLEAN)(*(CONST UINT64*)Guid1 == *(CONST UINT64*)Guid2 && *((CONST UINT64*)Guid1 + 1) == *((CONST UINT64*)Guid2 + 1))\n')\r
686 # AutoGen for each PCD listed in a [PcdEx] section of a Module/Lib INF file.\r
687 # Auto generate a macro for each TokenName that takes a Guid pointer as a parameter. \r
688 # Use the Guid pointer to see if it matches any of the token space GUIDs.\r
689 TokenCNameList = []\r
690 for TokenCName in ExTokenCNameList:\r
691 if TokenCName in TokenCNameList:\r
692 continue\r
693 Index = 0\r
694 Count = ExTokenCNameList.count(TokenCName)\r
695 for Pcd in PcdExList:\r
696 if Pcd.TokenCName == TokenCName:\r
697 Index = Index + 1\r
698 if Index == 1:\r
699 AutoGenH.Append('\n#define __PCD_%s_ADDR_CMP(GuidPtr) (' % (Pcd.TokenCName))\r
700 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
701 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, Pcd.TokenCName))\r
702 else:\r
703 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
704 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, Pcd.TokenCName))\r
705 if Index == Count:\r
706 AutoGenH.Append('0 \\\n )\n')\r
707 TokenCNameList.append(TokenCName)\r
708 \r
709 TokenCNameList = []\r
710 for TokenCName in ExTokenCNameList:\r
711 if TokenCName in TokenCNameList:\r
712 continue\r
713 Index = 0\r
714 Count = ExTokenCNameList.count(TokenCName)\r
715 for Pcd in PcdExList:\r
716 if Pcd.Type in gDynamicExPcd and Pcd.TokenCName == TokenCName:\r
717 Index = Index + 1\r
718 if Index == 1:\r
719 AutoGenH.Append('\n#define __PCD_%s_VAL_CMP(GuidPtr) (' % (Pcd.TokenCName))\r
9023704f 720 AutoGenH.Append('\\\n (GuidPtr == NULL) ? 0:')\r
f51461c8
LG
721 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
722 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, Pcd.TokenCName))\r
723 else:\r
724 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
725 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, Pcd.TokenCName))\r
726 if Index == Count:\r
727 AutoGenH.Append('0 \\\n )\n')\r
728 # Autogen internal worker macro to compare GUIDs. Guid1 is a pointer to a GUID. \r
729 # Guid2 is a C name for a GUID. Compare pointers first because optimizing compiler\r
730 # can do this at build time on CONST GUID pointers and optimize away call to COMPAREGUID().\r
731 # COMPAREGUID() will only be used if the Guid passed in is local to the module.\r
732 AutoGenH.Append('#define _PCD_TOKEN_EX_%s(GuidPtr) __PCD_%s_ADDR_CMP(GuidPtr) ? __PCD_%s_ADDR_CMP(GuidPtr) : __PCD_%s_VAL_CMP(GuidPtr) \n'\r
733 % (Pcd.TokenCName, Pcd.TokenCName, Pcd.TokenCName, Pcd.TokenCName))\r
734 TokenCNameList.append(TokenCName)\r
735\r
2f5acc3b
BF
736def GetPcdSize(Pcd):\r
737 if Pcd.DatumType == 'VOID*':\r
738 Value = Pcd.DefaultValue\r
739 if Value in [None, '']:\r
740 return 1\r
741 elif Value[0] == 'L':\r
742 return (len(Value) - 2) * 2\r
743 elif Value[0] == '{':\r
744 return len(Value.split(','))\r
745 else:\r
746 return len(Value) - 1\r
747 if Pcd.DatumType == 'UINT64':\r
748 return 8\r
749 if Pcd.DatumType == 'UINT32':\r
750 return 4\r
751 if Pcd.DatumType == 'UINT16':\r
752 return 2\r
753 if Pcd.DatumType == 'UINT8':\r
754 return 1\r
755 if Pcd.DatumType == 'BOOLEAN':\r
756 return 1\r
757\r
758\r
f51461c8
LG
759## Create code for module PCDs\r
760#\r
761# @param Info The ModuleAutoGen object\r
762# @param AutoGenC The TemplateString object for C code\r
763# @param AutoGenH The TemplateString object for header file\r
764# @param Pcd The PCD object\r
765#\r
766def CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd):\r
767 TokenSpaceGuidValue = Pcd.TokenSpaceGuidValue #Info.GuidList[Pcd.TokenSpaceGuidCName]\r
768 PcdTokenNumber = Info.PlatformInfo.PcdTokenNumber\r
769 #\r
770 # Write PCDs\r
771 #\r
772 PcdTokenName = '_PCD_TOKEN_' + Pcd.TokenCName\r
2f5acc3b
BF
773 PatchPcdSizeTokenName = '_PCD_PATCHABLE_' + Pcd.TokenCName +'_SIZE'\r
774 PatchPcdSizeVariableName = '_gPcd_BinaryPatch_Size_' + Pcd.TokenCName\r
775 FixPcdSizeTokenName = '_PCD_SIZE_' + Pcd.TokenCName\r
776 \r
f51461c8
LG
777 if Pcd.Type in gDynamicExPcd:\r
778 TokenNumber = int(Pcd.TokenValue, 0)\r
779 # Add TokenSpaceGuidValue value to PcdTokenName to discriminate the DynamicEx PCDs with \r
780 # different Guids but same TokenCName\r
781 PcdExTokenName = '_PCD_TOKEN_' + Pcd.TokenSpaceGuidCName + '_' + Pcd.TokenCName\r
782 AutoGenH.Append('\n#define %s %dU\n' % (PcdExTokenName, TokenNumber))\r
783 else:\r
784 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) not in PcdTokenNumber:\r
785 # If one of the Source built modules listed in the DSC is not listed in FDF modules, \r
786 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only \r
787 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will \r
788 # report warning message notify the PI that they are attempting to build a module \r
789 # that must be included in a flash image in order to be functional. These Dynamic PCD \r
790 # will not be added into the Database unless it is used by other modules that are \r
791 # included in the FDF file. \r
792 # In this case, just assign an invalid token number to make it pass build.\r
793 if Pcd.Type in PCD_DYNAMIC_TYPE_LIST:\r
794 TokenNumber = 0\r
795 else:\r
796 EdkLogger.error("build", AUTOGEN_ERROR,\r
797 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
798 ExtraData="[%s]" % str(Info))\r
799 else:\r
800 TokenNumber = PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName]\r
801 AutoGenH.Append('\n#define %s %dU\n' % (PcdTokenName, TokenNumber))\r
802\r
803 EdkLogger.debug(EdkLogger.DEBUG_3, "Creating code for " + Pcd.TokenCName + "." + Pcd.TokenSpaceGuidCName)\r
804 if Pcd.Type not in gItemTypeStringDatabase:\r
805 EdkLogger.error("build", AUTOGEN_ERROR,\r
806 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
807 ExtraData="[%s]" % str(Info))\r
808 if Pcd.DatumType not in gDatumSizeStringDatabase:\r
809 EdkLogger.error("build", AUTOGEN_ERROR,\r
810 "Unknown datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
811 ExtraData="[%s]" % str(Info))\r
812\r
813 DatumSize = gDatumSizeStringDatabase[Pcd.DatumType]\r
814 DatumSizeLib = gDatumSizeStringDatabaseLib[Pcd.DatumType]\r
815 GetModeName = '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + Pcd.TokenCName\r
816 SetModeName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + Pcd.TokenCName\r
82a6a960 817 SetModeStatusName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_S_' + Pcd.TokenCName\r
2f5acc3b
BF
818 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + Pcd.TokenCName\r
819 \r
f51461c8
LG
820 PcdExCNameList = []\r
821 if Pcd.Type in gDynamicExPcd:\r
822 if Info.IsLibrary:\r
823 PcdList = Info.LibraryPcdList\r
824 else:\r
825 PcdList = Info.ModulePcdList\r
826 for PcdModule in PcdList:\r
827 if PcdModule.Type in gDynamicExPcd:\r
828 PcdExCNameList.append(PcdModule.TokenCName)\r
829 # Be compatible with the current code which using PcdToken and PcdGet/Set for DynamicEx Pcd.\r
830 # If only PcdToken and PcdGet/Set used in all Pcds with different CName, it should succeed to build.\r
831 # If PcdToken and PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.\r
832 if PcdExCNameList.count(Pcd.TokenCName) > 1:\r
833 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')\r
834 AutoGenH.Append('// #define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
835 AutoGenH.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 836 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
837 if Pcd.DatumType == 'VOID*':\r
838 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 839 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
840 else:\r
841 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 842 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
843 else:\r
844 AutoGenH.Append('#define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
845 AutoGenH.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 846 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
847 if Pcd.DatumType == 'VOID*':\r
848 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 849 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
850 else:\r
851 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 852 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
853 elif Pcd.Type in gDynamicPcd:\r
854 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
2f5acc3b 855 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
f51461c8
LG
856 if Pcd.DatumType == 'VOID*':\r
857 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))\r
82a6a960 858 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8
LG
859 else:\r
860 AutoGenH.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))\r
82a6a960 861 AutoGenH.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8
LG
862 else:\r
863 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + Pcd.TokenCName\r
864 Const = 'const'\r
865 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
866 Const = ''\r
867 Type = ''\r
868 Array = ''\r
869 Value = Pcd.DefaultValue\r
870 Unicode = False\r
871 ValueNumber = 0\r
872\r
873 if Pcd.DatumType == 'BOOLEAN':\r
874 BoolValue = Value.upper()\r
875 if BoolValue == 'TRUE' or BoolValue == '1':\r
876 Value = '1U'\r
877 elif BoolValue == 'FALSE' or BoolValue == '0':\r
878 Value = '0U'\r
879\r
880 if Pcd.DatumType in ['UINT64', 'UINT32', 'UINT16', 'UINT8']:\r
881 try:\r
882 if Value.upper().startswith('0X'):\r
883 ValueNumber = int (Value, 16)\r
884 else:\r
885 ValueNumber = int (Value)\r
886 except:\r
887 EdkLogger.error("build", AUTOGEN_ERROR,\r
888 "PCD value is not valid dec or hex number for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
889 ExtraData="[%s]" % str(Info))\r
890 if Pcd.DatumType == 'UINT64':\r
891 if ValueNumber < 0:\r
892 EdkLogger.error("build", AUTOGEN_ERROR,\r
893 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
894 ExtraData="[%s]" % str(Info))\r
895 elif ValueNumber >= 0x10000000000000000:\r
896 EdkLogger.error("build", AUTOGEN_ERROR,\r
897 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
898 ExtraData="[%s]" % str(Info))\r
899 if not Value.endswith('ULL'):\r
900 Value += 'ULL'\r
901 elif Pcd.DatumType == 'UINT32':\r
902 if ValueNumber < 0:\r
903 EdkLogger.error("build", AUTOGEN_ERROR,\r
904 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
905 ExtraData="[%s]" % str(Info))\r
906 elif ValueNumber >= 0x100000000:\r
907 EdkLogger.error("build", AUTOGEN_ERROR,\r
908 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
909 ExtraData="[%s]" % str(Info))\r
910 if not Value.endswith('U'):\r
911 Value += 'U'\r
912 elif Pcd.DatumType == 'UINT16':\r
913 if ValueNumber < 0:\r
914 EdkLogger.error("build", AUTOGEN_ERROR,\r
915 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
916 ExtraData="[%s]" % str(Info))\r
917 elif ValueNumber >= 0x10000:\r
918 EdkLogger.error("build", AUTOGEN_ERROR,\r
919 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
920 ExtraData="[%s]" % str(Info))\r
921 if not Value.endswith('U'):\r
922 Value += 'U' \r
923 elif Pcd.DatumType == 'UINT8':\r
924 if ValueNumber < 0:\r
925 EdkLogger.error("build", AUTOGEN_ERROR,\r
926 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
927 ExtraData="[%s]" % str(Info))\r
928 elif ValueNumber >= 0x100:\r
929 EdkLogger.error("build", AUTOGEN_ERROR,\r
930 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
931 ExtraData="[%s]" % str(Info))\r
932 if not Value.endswith('U'):\r
933 Value += 'U'\r
934 if Pcd.DatumType == 'VOID*':\r
935 if Pcd.MaxDatumSize == None or Pcd.MaxDatumSize == '':\r
936 EdkLogger.error("build", AUTOGEN_ERROR,\r
937 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
938 ExtraData="[%s]" % str(Info))\r
939\r
940 ArraySize = int(Pcd.MaxDatumSize, 0)\r
941 if Value[0] == '{':\r
942 Type = '(VOID *)'\r
943 else:\r
944 if Value[0] == 'L':\r
945 Unicode = True\r
946 Value = Value.lstrip('L') #.strip('"')\r
947 Value = eval(Value) # translate escape character\r
948 NewValue = '{'\r
949 for Index in range(0,len(Value)):\r
950 if Unicode:\r
951 NewValue = NewValue + str(ord(Value[Index]) % 0x10000) + ', '\r
952 else:\r
953 NewValue = NewValue + str(ord(Value[Index]) % 0x100) + ', '\r
954 if Unicode:\r
955 ArraySize = ArraySize / 2;\r
956\r
957 if ArraySize < (len(Value) + 1):\r
958 EdkLogger.error("build", AUTOGEN_ERROR,\r
959 "The maximum size of VOID* type PCD '%s.%s' is less than its actual size occupied." % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
960 ExtraData="[%s]" % str(Info))\r
961 Value = NewValue + '0 }'\r
962 Array = '[%d]' % ArraySize\r
963 #\r
964 # skip casting for fixed at build since it breaks ARM assembly.\r
965 # Long term we need PCD macros that work in assembly\r
966 #\r
967 elif Pcd.Type != TAB_PCDS_FIXED_AT_BUILD:\r
968 Value = "((%s)%s)" % (Pcd.DatumType, Value)\r
969\r
970 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
971 PcdValueName = '_PCD_PATCHABLE_VALUE_' + Pcd.TokenCName\r
972 else:\r
973 PcdValueName = '_PCD_VALUE_' + Pcd.TokenCName\r
974 \r
975 if Pcd.DatumType == 'VOID*':\r
976 #\r
977 # For unicode, UINT16 array will be generated, so the alignment of unicode is guaranteed.\r
978 #\r
979 if Unicode:\r
f51461c8
LG
980 AutoGenH.Append('#define %s %s%s\n' %(PcdValueName, Type, PcdVariableName))\r
981 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT16 %s%s = %s;\n' % (Const, PcdVariableName, Array, Value))\r
982 AutoGenH.Append('extern %s UINT16 %s%s;\n' %(Const, PcdVariableName, Array))\r
983 AutoGenH.Append('#define %s %s%s\n' %(GetModeName, Type, PcdVariableName))\r
984 else:\r
f51461c8
LG
985 AutoGenH.Append('#define %s %s%s\n' %(PcdValueName, Type, PcdVariableName))\r
986 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT8 %s%s = %s;\n' % (Const, PcdVariableName, Array, Value))\r
987 AutoGenH.Append('extern %s UINT8 %s%s;\n' %(Const, PcdVariableName, Array))\r
988 AutoGenH.Append('#define %s %s%s\n' %(GetModeName, Type, PcdVariableName))\r
2f5acc3b
BF
989 \r
990 PcdDataSize = GetPcdSize(Pcd)\r
991 if Pcd.Type == TAB_PCDS_FIXED_AT_BUILD:\r
992 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
993 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,FixPcdSizeTokenName))\r
994 \r
995 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
996 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, Pcd.MaxDatumSize))\r
997 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
998 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
999 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName,PcdDataSize))\r
f51461c8
LG
1000 elif Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1001 AutoGenH.Append('#define %s %s\n' %(PcdValueName, Value))\r
1002 AutoGenC.Append('volatile %s %s %s = %s;\n' %(Const, Pcd.DatumType, PcdVariableName, PcdValueName))\r
1003 AutoGenH.Append('extern volatile %s %s %s%s;\n' % (Const, Pcd.DatumType, PcdVariableName, Array))\r
1004 AutoGenH.Append('#define %s %s%s\n' % (GetModeName, Type, PcdVariableName))\r
2f5acc3b
BF
1005 \r
1006 PcdDataSize = GetPcdSize(Pcd)\r
1007 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, PcdDataSize))\r
1008 \r
1009 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1010 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1011 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName,PcdDataSize))\r
f51461c8 1012 else:\r
2f5acc3b
BF
1013 PcdDataSize = GetPcdSize(Pcd)\r
1014 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1015 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,FixPcdSizeTokenName))\r
1016 \r
f51461c8
LG
1017 AutoGenH.Append('#define %s %s\n' %(PcdValueName, Value))\r
1018 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s %s = %s;\n' %(Const, Pcd.DatumType, PcdVariableName, PcdValueName))\r
1019 AutoGenH.Append('extern %s %s %s%s;\n' % (Const, Pcd.DatumType, PcdVariableName, Array))\r
1020 AutoGenH.Append('#define %s %s%s\n' % (GetModeName, Type, PcdVariableName))\r
1021\r
1022 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1023 if Pcd.DatumType == 'VOID*':\r
1024 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtr(_gPcd_BinaryPatch_%s, (UINTN)_PCD_PATCHABLE_%s_SIZE, (SizeOfBuffer), (Buffer))\n' % (SetModeName, Pcd.TokenCName, Pcd.TokenCName))\r
82a6a960 1025 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrS(_gPcd_BinaryPatch_%s, (UINTN)_PCD_PATCHABLE_%s_SIZE, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, Pcd.TokenCName, Pcd.TokenCName))\r
f51461c8
LG
1026 else:\r
1027 AutoGenH.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName, PcdVariableName))\r
82a6a960 1028 AutoGenH.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS) \n' % (SetModeStatusName, PcdVariableName))\r
f51461c8
LG
1029 else:\r
1030 AutoGenH.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName)\r
1031\r
1032## Create code for library module PCDs\r
1033#\r
1034# @param Info The ModuleAutoGen object\r
1035# @param AutoGenC The TemplateString object for C code\r
1036# @param AutoGenH The TemplateString object for header file\r
1037# @param Pcd The PCD object\r
1038#\r
1039def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):\r
1040 PcdTokenNumber = Info.PlatformInfo.PcdTokenNumber\r
1041 TokenSpaceGuidCName = Pcd.TokenSpaceGuidCName\r
1042 TokenCName = Pcd.TokenCName\r
1043 PcdTokenName = '_PCD_TOKEN_' + TokenCName\r
2f5acc3b
BF
1044 FixPcdSizeTokenName = '_PCD_SIZE_' + Pcd.TokenCName\r
1045 PatchPcdSizeTokenName = '_PCD_PATCHABLE_' + Pcd.TokenCName +'_SIZE'\r
1046 PatchPcdSizeVariableName = '_gPcd_BinaryPatch_Size_' + Pcd.TokenCName\r
1047 \r
f51461c8
LG
1048 #\r
1049 # Write PCDs\r
1050 #\r
1051 if Pcd.Type in gDynamicExPcd:\r
1052 TokenNumber = int(Pcd.TokenValue, 0)\r
1053 else:\r
1054 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) not in PcdTokenNumber:\r
1055 # If one of the Source built modules listed in the DSC is not listed in FDF modules, \r
1056 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only \r
1057 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will \r
1058 # report warning message notify the PI that they are attempting to build a module \r
1059 # that must be included in a flash image in order to be functional. These Dynamic PCD \r
1060 # will not be added into the Database unless it is used by other modules that are \r
1061 # included in the FDF file. \r
1062 # In this case, just assign an invalid token number to make it pass build.\r
1063 if Pcd.Type in PCD_DYNAMIC_TYPE_LIST:\r
1064 TokenNumber = 0\r
1065 else:\r
1066 EdkLogger.error("build", AUTOGEN_ERROR,\r
1067 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
1068 ExtraData="[%s]" % str(Info))\r
1069 else:\r
1070 TokenNumber = PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName]\r
1071\r
1072 if Pcd.Type not in gItemTypeStringDatabase:\r
1073 EdkLogger.error("build", AUTOGEN_ERROR,\r
1074 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
1075 ExtraData="[%s]" % str(Info))\r
1076 if Pcd.DatumType not in gDatumSizeStringDatabase:\r
1077 EdkLogger.error("build", AUTOGEN_ERROR,\r
1078 "Unknown datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, Pcd.TokenCName),\r
1079 ExtraData="[%s]" % str(Info))\r
1080\r
1081 DatumType = Pcd.DatumType\r
1082 DatumSize = gDatumSizeStringDatabaseH[DatumType]\r
1083 DatumSizeLib= gDatumSizeStringDatabaseLib[DatumType]\r
1084 GetModeName = '_PCD_GET_MODE_' + DatumSize + '_' + TokenCName\r
1085 SetModeName = '_PCD_SET_MODE_' + DatumSize + '_' + TokenCName\r
82a6a960 1086 SetModeStatusName = '_PCD_SET_MODE_' + DatumSize + '_S_' + TokenCName\r
2f5acc3b 1087 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + Pcd.TokenCName\r
f51461c8
LG
1088\r
1089 Type = ''\r
1090 Array = ''\r
1091 if Pcd.DatumType == 'VOID*':\r
1092 Type = '(VOID *)'\r
1093 Array = '[]'\r
1094 PcdItemType = Pcd.Type\r
1095 PcdExCNameList = []\r
1096 if PcdItemType in gDynamicExPcd:\r
1097 PcdExTokenName = '_PCD_TOKEN_' + TokenSpaceGuidCName + '_' + Pcd.TokenCName\r
1098 AutoGenH.Append('\n#define %s %dU\n' % (PcdExTokenName, TokenNumber))\r
1099 \r
1100 if Info.IsLibrary:\r
1101 PcdList = Info.LibraryPcdList\r
1102 else:\r
1103 PcdList = Info.ModulePcdList\r
1104 for PcdModule in PcdList:\r
1105 if PcdModule.Type in gDynamicExPcd:\r
1106 PcdExCNameList.append(PcdModule.TokenCName)\r
1107 # Be compatible with the current code which using PcdGet/Set for DynamicEx Pcd.\r
1108 # If only PcdGet/Set used in all Pcds with different CName, it should succeed to build.\r
1109 # If PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.\r
1110 if PcdExCNameList.count(Pcd.TokenCName) > 1:\r
1111 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')\r
1112 AutoGenH.Append('// #define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
1113 AutoGenH.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 1114 AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s \n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1115 if Pcd.DatumType == 'VOID*':\r
1116 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1117 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1118 else:\r
1119 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1120 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1121 else:\r
1122 AutoGenH.Append('#define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
1123 AutoGenH.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 1124 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1125 if Pcd.DatumType == 'VOID*':\r
1126 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1127 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1128 else:\r
1129 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1130 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1131 else:\r
1132 AutoGenH.Append('#define _PCD_TOKEN_%s %dU\n' % (TokenCName, TokenNumber))\r
1133 if PcdItemType in gDynamicPcd:\r
1134 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
2f5acc3b 1135 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
f51461c8
LG
1136 if DatumType == 'VOID*':\r
1137 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))\r
82a6a960 1138 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8
LG
1139 else:\r
1140 AutoGenH.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))\r
82a6a960 1141 AutoGenH.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8
LG
1142 if PcdItemType == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1143 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[TAB_PCDS_PATCHABLE_IN_MODULE] + '_' + TokenCName\r
1144 AutoGenH.Append('extern volatile %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType, TokenCName, Array) )\r
1145 AutoGenH.Append('#define %s %s_gPcd_BinaryPatch_%s\n' %(GetModeName, Type, TokenCName))\r
1146 AutoGenH.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName, PcdVariableName))\r
82a6a960 1147 AutoGenH.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS)\n' % (SetModeStatusName, PcdVariableName))\r
2f5acc3b
BF
1148 \r
1149 PcdDataSize = GetPcdSize(Pcd)\r
1150 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, PcdDataSize))\r
1151 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1152 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1153 \r
f51461c8
LG
1154 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD or PcdItemType == TAB_PCDS_FEATURE_FLAG:\r
1155 key = ".".join((Pcd.TokenSpaceGuidCName,Pcd.TokenCName))\r
1156 \r
41ab153f 1157 if DatumType == 'VOID*' and Array == '[]':\r
2f5acc3b 1158 DatumType = ['UINT8', 'UINT16'][Pcd.DefaultValue[0] == 'L']\r
f51461c8
LG
1159 AutoGenH.Append('extern const %s _gPcd_FixedAtBuild_%s%s;\n' %(DatumType, TokenCName, Array))\r
1160 AutoGenH.Append('#define %s %s_gPcd_FixedAtBuild_%s\n' %(GetModeName, Type, TokenCName))\r
1161 AutoGenH.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName)\r
1162 \r
1163 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD and key in Info.ConstPcd:\r
1164 AutoGenH.Append('#define _PCD_VALUE_%s %s\n' %(TokenCName, Pcd.DefaultValue))\r
1165 \r
2f5acc3b
BF
1166 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD:\r
1167 PcdDataSize = GetPcdSize(Pcd)\r
1168 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1169 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,FixPcdSizeTokenName))\r
f51461c8
LG
1170\r
1171## Create code for library constructor\r
1172#\r
1173# @param Info The ModuleAutoGen object\r
1174# @param AutoGenC The TemplateString object for C code\r
1175# @param AutoGenH The TemplateString object for header file\r
1176#\r
1177def CreateLibraryConstructorCode(Info, AutoGenC, AutoGenH):\r
1178 #\r
1179 # Library Constructors\r
1180 #\r
1181 ConstructorPrototypeString = TemplateString()\r
1182 ConstructorCallingString = TemplateString()\r
1183 if Info.IsLibrary:\r
1184 DependentLibraryList = [Info.Module]\r
1185 else:\r
1186 DependentLibraryList = Info.DependentLibraryList\r
1187 for Lib in DependentLibraryList:\r
1188 if len(Lib.ConstructorList) <= 0:\r
1189 continue\r
1190 Dict = {'Function':Lib.ConstructorList}\r
1191 if Lib.ModuleType in ['BASE', 'SEC']:\r
1192 ConstructorPrototypeString.Append(gLibraryStructorPrototype['BASE'].Replace(Dict))\r
1193 ConstructorCallingString.Append(gLibraryStructorCall['BASE'].Replace(Dict))\r
1194 elif Lib.ModuleType in ['PEI_CORE','PEIM']:\r
1195 ConstructorPrototypeString.Append(gLibraryStructorPrototype['PEI'].Replace(Dict))\r
1196 ConstructorCallingString.Append(gLibraryStructorCall['PEI'].Replace(Dict))\r
1197 elif Lib.ModuleType in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',\r
1198 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:\r
1199 ConstructorPrototypeString.Append(gLibraryStructorPrototype['DXE'].Replace(Dict))\r
1200 ConstructorCallingString.Append(gLibraryStructorCall['DXE'].Replace(Dict))\r
1201\r
1202 if str(ConstructorPrototypeString) == '':\r
1203 ConstructorPrototypeList = []\r
1204 else:\r
1205 ConstructorPrototypeList = [str(ConstructorPrototypeString)]\r
1206 if str(ConstructorCallingString) == '':\r
1207 ConstructorCallingList = []\r
1208 else:\r
1209 ConstructorCallingList = [str(ConstructorCallingString)]\r
1210\r
1211 Dict = {\r
1212 'Type' : 'Constructor',\r
1213 'FunctionPrototype' : ConstructorPrototypeList,\r
1214 'FunctionCall' : ConstructorCallingList\r
1215 }\r
1216 if Info.IsLibrary:\r
1217 AutoGenH.Append("${BEGIN}${FunctionPrototype}${END}", Dict)\r
1218 else:\r
1219 if Info.ModuleType in ['BASE', 'SEC']:\r
1220 AutoGenC.Append(gLibraryString['BASE'].Replace(Dict))\r
1221 elif Info.ModuleType in ['PEI_CORE','PEIM']:\r
1222 AutoGenC.Append(gLibraryString['PEI'].Replace(Dict))\r
1223 elif Info.ModuleType in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',\r
1224 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:\r
1225 AutoGenC.Append(gLibraryString['DXE'].Replace(Dict))\r
1226\r
1227## Create code for library destructor\r
1228#\r
1229# @param Info The ModuleAutoGen object\r
1230# @param AutoGenC The TemplateString object for C code\r
1231# @param AutoGenH The TemplateString object for header file\r
1232#\r
1233def CreateLibraryDestructorCode(Info, AutoGenC, AutoGenH):\r
1234 #\r
1235 # Library Destructors\r
1236 #\r
1237 DestructorPrototypeString = TemplateString()\r
1238 DestructorCallingString = TemplateString()\r
1239 if Info.IsLibrary:\r
1240 DependentLibraryList = [Info.Module]\r
1241 else:\r
1242 DependentLibraryList = Info.DependentLibraryList\r
1243 for Index in range(len(DependentLibraryList)-1, -1, -1):\r
1244 Lib = DependentLibraryList[Index]\r
1245 if len(Lib.DestructorList) <= 0:\r
1246 continue\r
1247 Dict = {'Function':Lib.DestructorList}\r
1248 if Lib.ModuleType in ['BASE', 'SEC']:\r
1249 DestructorPrototypeString.Append(gLibraryStructorPrototype['BASE'].Replace(Dict))\r
1250 DestructorCallingString.Append(gLibraryStructorCall['BASE'].Replace(Dict))\r
1251 elif Lib.ModuleType in ['PEI_CORE','PEIM']:\r
1252 DestructorPrototypeString.Append(gLibraryStructorPrototype['PEI'].Replace(Dict))\r
1253 DestructorCallingString.Append(gLibraryStructorCall['PEI'].Replace(Dict))\r
1254 elif Lib.ModuleType in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',\r
1255 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION', 'SMM_CORE']:\r
1256 DestructorPrototypeString.Append(gLibraryStructorPrototype['DXE'].Replace(Dict))\r
1257 DestructorCallingString.Append(gLibraryStructorCall['DXE'].Replace(Dict))\r
1258\r
1259 if str(DestructorPrototypeString) == '':\r
1260 DestructorPrototypeList = []\r
1261 else:\r
1262 DestructorPrototypeList = [str(DestructorPrototypeString)]\r
1263 if str(DestructorCallingString) == '':\r
1264 DestructorCallingList = []\r
1265 else:\r
1266 DestructorCallingList = [str(DestructorCallingString)]\r
1267\r
1268 Dict = {\r
1269 'Type' : 'Destructor',\r
1270 'FunctionPrototype' : DestructorPrototypeList,\r
1271 'FunctionCall' : DestructorCallingList\r
1272 }\r
1273 if Info.IsLibrary:\r
1274 AutoGenH.Append("${BEGIN}${FunctionPrototype}${END}", Dict)\r
1275 else:\r
1276 if Info.ModuleType in ['BASE', 'SEC']:\r
1277 AutoGenC.Append(gLibraryString['BASE'].Replace(Dict))\r
1278 elif Info.ModuleType in ['PEI_CORE','PEIM']:\r
1279 AutoGenC.Append(gLibraryString['PEI'].Replace(Dict))\r
1280 elif Info.ModuleType in ['DXE_CORE','DXE_DRIVER','DXE_SMM_DRIVER','DXE_RUNTIME_DRIVER',\r
1281 'DXE_SAL_DRIVER','UEFI_DRIVER','UEFI_APPLICATION','SMM_CORE']:\r
1282 AutoGenC.Append(gLibraryString['DXE'].Replace(Dict))\r
1283\r
1284\r
1285## Create code for ModuleEntryPoint\r
1286#\r
1287# @param Info The ModuleAutoGen object\r
1288# @param AutoGenC The TemplateString object for C code\r
1289# @param AutoGenH The TemplateString object for header file\r
1290#\r
1291def CreateModuleEntryPointCode(Info, AutoGenC, AutoGenH):\r
1292 if Info.IsLibrary or Info.ModuleType in ['USER_DEFINED', 'SEC']:\r
1293 return\r
1294 #\r
1295 # Module Entry Points\r
1296 #\r
1297 NumEntryPoints = len(Info.Module.ModuleEntryPointList)\r
1298 if 'PI_SPECIFICATION_VERSION' in Info.Module.Specification:\r
1299 PiSpecVersion = Info.Module.Specification['PI_SPECIFICATION_VERSION']\r
1300 else:\r
1301 PiSpecVersion = '0x00000000'\r
1302 if 'UEFI_SPECIFICATION_VERSION' in Info.Module.Specification:\r
1303 UefiSpecVersion = Info.Module.Specification['UEFI_SPECIFICATION_VERSION']\r
1304 else:\r
1305 UefiSpecVersion = '0x00000000'\r
1306 Dict = {\r
1307 'Function' : Info.Module.ModuleEntryPointList,\r
1308 'PiSpecVersion' : PiSpecVersion + 'U',\r
1309 'UefiSpecVersion': UefiSpecVersion + 'U'\r
1310 }\r
1311\r
1312 if Info.ModuleType in ['PEI_CORE', 'DXE_CORE', 'SMM_CORE']:\r
1313 if Info.SourceFileList <> None and Info.SourceFileList <> []:\r
1314 if NumEntryPoints != 1:\r
1315 EdkLogger.error(\r
1316 "build",\r
1317 AUTOGEN_ERROR,\r
1318 '%s must have exactly one entry point' % Info.ModuleType,\r
1319 File=str(Info),\r
1320 ExtraData= ", ".join(Info.Module.ModuleEntryPointList)\r
1321 )\r
1322 if Info.ModuleType == 'PEI_CORE':\r
1323 AutoGenC.Append(gPeiCoreEntryPointString.Replace(Dict))\r
1324 AutoGenH.Append(gPeiCoreEntryPointPrototype.Replace(Dict))\r
1325 elif Info.ModuleType == 'DXE_CORE':\r
1326 AutoGenC.Append(gDxeCoreEntryPointString.Replace(Dict))\r
1327 AutoGenH.Append(gDxeCoreEntryPointPrototype.Replace(Dict))\r
1328 elif Info.ModuleType == 'SMM_CORE':\r
1329 AutoGenC.Append(gSmmCoreEntryPointString.Replace(Dict))\r
1330 AutoGenH.Append(gSmmCoreEntryPointPrototype.Replace(Dict))\r
1331 elif Info.ModuleType == 'PEIM':\r
1332 if NumEntryPoints < 2:\r
1333 AutoGenC.Append(gPeimEntryPointString[NumEntryPoints].Replace(Dict))\r
1334 else:\r
1335 AutoGenC.Append(gPeimEntryPointString[2].Replace(Dict))\r
1336 AutoGenH.Append(gPeimEntryPointPrototype.Replace(Dict))\r
1337 elif Info.ModuleType in ['DXE_RUNTIME_DRIVER','DXE_DRIVER','DXE_SAL_DRIVER','UEFI_DRIVER']:\r
1338 if NumEntryPoints < 2:\r
1339 AutoGenC.Append(gUefiDriverEntryPointString[NumEntryPoints].Replace(Dict))\r
1340 else:\r
1341 AutoGenC.Append(gUefiDriverEntryPointString[2].Replace(Dict))\r
1342 AutoGenH.Append(gUefiDriverEntryPointPrototype.Replace(Dict))\r
1343 elif Info.ModuleType == 'DXE_SMM_DRIVER':\r
1344 if NumEntryPoints == 0:\r
1345 AutoGenC.Append(gDxeSmmEntryPointString[0].Replace(Dict))\r
1346 else:\r
1347 AutoGenC.Append(gDxeSmmEntryPointString[1].Replace(Dict))\r
1348 AutoGenH.Append(gDxeSmmEntryPointPrototype.Replace(Dict)) \r
1349 elif Info.ModuleType == 'UEFI_APPLICATION':\r
1350 if NumEntryPoints < 2:\r
1351 AutoGenC.Append(gUefiApplicationEntryPointString[NumEntryPoints].Replace(Dict))\r
1352 else:\r
1353 AutoGenC.Append(gUefiApplicationEntryPointString[2].Replace(Dict))\r
1354 AutoGenH.Append(gUefiApplicationEntryPointPrototype.Replace(Dict))\r
1355\r
1356## Create code for ModuleUnloadImage\r
1357#\r
1358# @param Info The ModuleAutoGen object\r
1359# @param AutoGenC The TemplateString object for C code\r
1360# @param AutoGenH The TemplateString object for header file\r
1361#\r
1362def CreateModuleUnloadImageCode(Info, AutoGenC, AutoGenH):\r
1363 if Info.IsLibrary or Info.ModuleType in ['USER_DEFINED', 'SEC']:\r
1364 return\r
1365 #\r
1366 # Unload Image Handlers\r
1367 #\r
1368 NumUnloadImage = len(Info.Module.ModuleUnloadImageList)\r
1369 Dict = {'Count':str(NumUnloadImage) + 'U', 'Function':Info.Module.ModuleUnloadImageList}\r
1370 if NumUnloadImage < 2:\r
1371 AutoGenC.Append(gUefiUnloadImageString[NumUnloadImage].Replace(Dict))\r
1372 else:\r
1373 AutoGenC.Append(gUefiUnloadImageString[2].Replace(Dict))\r
1374 AutoGenH.Append(gUefiUnloadImagePrototype.Replace(Dict))\r
1375\r
1376## Create code for GUID\r
1377#\r
1378# @param Info The ModuleAutoGen object\r
1379# @param AutoGenC The TemplateString object for C code\r
1380# @param AutoGenH The TemplateString object for header file\r
1381#\r
1382def CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH):\r
1383 if Info.IsLibrary:\r
1384 return\r
1385\r
1386 if Info.ModuleType in ["USER_DEFINED", "BASE"]:\r
1387 GuidType = "GUID"\r
1388 else:\r
1389 GuidType = "EFI_GUID"\r
1390\r
1391 if Info.GuidList:\r
1392 AutoGenC.Append("\n// Guids\n")\r
8262037f 1393 AutoGenH.Append("\n// Guids\n")\r
f51461c8
LG
1394 #\r
1395 # GUIDs\r
1396 #\r
1397 for Key in Info.GuidList:\r
1398 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.GuidList[Key]))\r
8262037f 1399 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1400\r
1401## Create code for protocol\r
1402#\r
1403# @param Info The ModuleAutoGen object\r
1404# @param AutoGenC The TemplateString object for C code\r
1405# @param AutoGenH The TemplateString object for header file\r
1406#\r
1407def CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH):\r
1408 if Info.IsLibrary:\r
1409 return\r
1410\r
1411 if Info.ModuleType in ["USER_DEFINED", "BASE"]:\r
1412 GuidType = "GUID"\r
1413 else:\r
1414 GuidType = "EFI_GUID"\r
1415\r
1416 if Info.ProtocolList:\r
1417 AutoGenC.Append("\n// Protocols\n")\r
8262037f 1418 AutoGenH.Append("\n// Protocols\n")\r
f51461c8
LG
1419 #\r
1420 # Protocol GUIDs\r
1421 #\r
1422 for Key in Info.ProtocolList:\r
1423 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.ProtocolList[Key]))\r
8262037f 1424 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1425\r
1426## Create code for PPI\r
1427#\r
1428# @param Info The ModuleAutoGen object\r
1429# @param AutoGenC The TemplateString object for C code\r
1430# @param AutoGenH The TemplateString object for header file\r
1431#\r
1432def CreatePpiDefinitionCode(Info, AutoGenC, AutoGenH):\r
1433 if Info.IsLibrary:\r
1434 return\r
1435\r
1436 if Info.ModuleType in ["USER_DEFINED", "BASE"]:\r
1437 GuidType = "GUID"\r
1438 else:\r
1439 GuidType = "EFI_GUID"\r
1440\r
1441 if Info.PpiList:\r
1442 AutoGenC.Append("\n// PPIs\n")\r
8262037f 1443 AutoGenH.Append("\n// PPIs\n")\r
f51461c8
LG
1444 #\r
1445 # PPI GUIDs\r
1446 #\r
1447 for Key in Info.PpiList:\r
1448 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.PpiList[Key]))\r
8262037f 1449 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1450\r
1451## Create code for PCD\r
1452#\r
1453# @param Info The ModuleAutoGen object\r
1454# @param AutoGenC The TemplateString object for C code\r
1455# @param AutoGenH The TemplateString object for header file\r
1456#\r
1457def CreatePcdCode(Info, AutoGenC, AutoGenH):\r
1458\r
1459 # Collect Token Space GUIDs used by DynamicEc PCDs\r
1460 TokenSpaceList = []\r
1461 for Pcd in Info.ModulePcdList:\r
1462 if Pcd.Type in gDynamicExPcd and Pcd.TokenSpaceGuidCName not in TokenSpaceList:\r
1463 TokenSpaceList += [Pcd.TokenSpaceGuidCName]\r
1464 \r
1465 # Add extern declarations to AutoGen.h if one or more Token Space GUIDs were found\r
1466 if TokenSpaceList <> []: \r
1467 AutoGenH.Append("\n// Definition of PCD Token Space GUIDs used in this module\n\n")\r
1468 if Info.ModuleType in ["USER_DEFINED", "BASE"]:\r
1469 GuidType = "GUID"\r
1470 else:\r
1471 GuidType = "EFI_GUID" \r
1472 for Item in TokenSpaceList:\r
1473 AutoGenH.Append('extern %s %s;\n' % (GuidType, Item))\r
1474\r
1475 if Info.IsLibrary:\r
1476 if Info.ModulePcdList:\r
1477 AutoGenH.Append("\n// PCD definitions\n")\r
1478 for Pcd in Info.ModulePcdList:\r
1479 CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd)\r
1480 DynExPcdTokenNumberMapping (Info, AutoGenH)\r
1481 else:\r
1482 if Info.ModulePcdList:\r
1483 AutoGenH.Append("\n// Definition of PCDs used in this module\n")\r
1484 AutoGenC.Append("\n// Definition of PCDs used in this module\n")\r
1485 for Pcd in Info.ModulePcdList:\r
1486 CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd)\r
1487 DynExPcdTokenNumberMapping (Info, AutoGenH)\r
1488 if Info.LibraryPcdList:\r
1489 AutoGenH.Append("\n// Definition of PCDs used in libraries is in AutoGen.c\n")\r
1490 AutoGenC.Append("\n// Definition of PCDs used in libraries\n")\r
1491 for Pcd in Info.LibraryPcdList:\r
1492 CreateModulePcdCode(Info, AutoGenC, AutoGenC, Pcd)\r
1493 CreatePcdDatabaseCode(Info, AutoGenC, AutoGenH)\r
1494\r
1495## Create code for unicode string definition\r
1496#\r
1497# @param Info The ModuleAutoGen object\r
1498# @param AutoGenC The TemplateString object for C code\r
1499# @param AutoGenH The TemplateString object for header file\r
1500# @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True\r
1501# @param UniGenBinBuffer Buffer to store uni string package data\r
1502#\r
1503def CreateUnicodeStringCode(Info, AutoGenC, AutoGenH, UniGenCFlag, UniGenBinBuffer):\r
1504 WorkingDir = os.getcwd()\r
1505 os.chdir(Info.WorkspaceDir)\r
1506\r
1507 IncList = [Info.MetaFile.Dir]\r
1508 # Get all files under [Sources] section in inf file for EDK-II module\r
1509 EDK2Module = True\r
1510 SrcList = [F for F in Info.SourceFileList]\r
1511 if Info.AutoGenVersion < 0x00010005:\r
1512 EDK2Module = False\r
1513 # Get all files under the module directory for EDK-I module\r
1514 Cwd = os.getcwd()\r
1515 os.chdir(Info.MetaFile.Dir)\r
1516 for Root, Dirs, Files in os.walk("."):\r
1517 if 'CVS' in Dirs:\r
1518 Dirs.remove('CVS')\r
1519 if '.svn' in Dirs:\r
1520 Dirs.remove('.svn')\r
1521 for File in Files:\r
1522 File = PathClass(os.path.join(Root, File), Info.MetaFile.Dir)\r
1523 if File in SrcList:\r
1524 continue\r
1525 SrcList.append(File)\r
1526 os.chdir(Cwd)\r
1527\r
1528 if 'BUILD' in Info.BuildOption and Info.BuildOption['BUILD']['FLAGS'].find('-c') > -1:\r
1529 CompatibleMode = True\r
1530 else:\r
1531 CompatibleMode = False\r
1532\r
1533 #\r
1534 # -s is a temporary option dedicated for building .UNI files with ISO 639-2 language codes of EDK Shell in EDK2\r
1535 #\r
1536 if 'BUILD' in Info.BuildOption and Info.BuildOption['BUILD']['FLAGS'].find('-s') > -1:\r
1537 if CompatibleMode:\r
1538 EdkLogger.error("build", AUTOGEN_ERROR,\r
1539 "-c and -s build options should be used exclusively",\r
1540 ExtraData="[%s]" % str(Info))\r
1541 ShellMode = True\r
1542 else:\r
1543 ShellMode = False\r
1544\r
1545 #RFC4646 is only for EDKII modules and ISO639-2 for EDK modules\r
1546 if EDK2Module:\r
1547 FilterInfo = [EDK2Module] + [Info.PlatformInfo.Platform.RFCLanguages]\r
1548 else:\r
1549 FilterInfo = [EDK2Module] + [Info.PlatformInfo.Platform.ISOLanguages]\r
1550 Header, Code = GetStringFiles(Info.UnicodeFileList, SrcList, IncList, Info.IncludePathList, ['.uni', '.inf'], Info.Name, CompatibleMode, ShellMode, UniGenCFlag, UniGenBinBuffer, FilterInfo)\r
1551 if CompatibleMode or UniGenCFlag:\r
1552 AutoGenC.Append("\n//\n//Unicode String Pack Definition\n//\n")\r
1553 AutoGenC.Append(Code)\r
1554 AutoGenC.Append("\n")\r
1555 AutoGenH.Append("\n//\n//Unicode String ID\n//\n")\r
1556 AutoGenH.Append(Header)\r
1557 if CompatibleMode or UniGenCFlag:\r
1558 AutoGenH.Append("\n#define STRING_ARRAY_NAME %sStrings\n" % Info.Name)\r
1559 os.chdir(WorkingDir)\r
1560\r
1561## Create common code\r
1562#\r
1563# @param Info The ModuleAutoGen object\r
1564# @param AutoGenC The TemplateString object for C code\r
1565# @param AutoGenH The TemplateString object for header file\r
1566#\r
1567def CreateHeaderCode(Info, AutoGenC, AutoGenH):\r
1568 # file header\r
1569 AutoGenH.Append(gAutoGenHeaderString.Replace({'FileName':'AutoGen.h'}))\r
1570 # header file Prologue\r
1571 AutoGenH.Append(gAutoGenHPrologueString.Replace({'File':'AUTOGENH','Guid':Info.Guid.replace('-','_')}))\r
1572 AutoGenH.Append(gAutoGenHCppPrologueString)\r
1573 if Info.AutoGenVersion >= 0x00010005:\r
1574 # header files includes\r
1575 AutoGenH.Append("#include <%s>\n" % gBasicHeaderFile)\r
1576 if Info.ModuleType in gModuleTypeHeaderFile \\r
1577 and gModuleTypeHeaderFile[Info.ModuleType][0] != gBasicHeaderFile:\r
1578 AutoGenH.Append("#include <%s>\n" % gModuleTypeHeaderFile[Info.ModuleType][0])\r
1579 #\r
1580 # if either PcdLib in [LibraryClasses] sections or there exist Pcd section, add PcdLib.h \r
1581 # As if modules only uses FixedPcd, then PcdLib is not needed in [LibraryClasses] section.\r
1582 #\r
1583 if 'PcdLib' in Info.Module.LibraryClasses or Info.Module.Pcds:\r
1584 AutoGenH.Append("#include <Library/PcdLib.h>\n")\r
1585\r
1586 AutoGenH.Append('\nextern GUID gEfiCallerIdGuid;')\r
1587 AutoGenH.Append('\nextern CHAR8 *gEfiCallerBaseName;\n\n')\r
1588\r
1589 if Info.IsLibrary:\r
1590 return\r
1591\r
1592 AutoGenH.Append("#define EFI_CALLER_ID_GUID \\\n %s\n" % GuidStringToGuidStructureString(Info.Guid))\r
1593\r
1594 if Info.IsLibrary:\r
1595 return\r
1596 # C file header\r
1597 AutoGenC.Append(gAutoGenHeaderString.Replace({'FileName':'AutoGen.c'}))\r
1598 if Info.AutoGenVersion >= 0x00010005:\r
1599 # C file header files includes\r
1600 if Info.ModuleType in gModuleTypeHeaderFile:\r
1601 for Inc in gModuleTypeHeaderFile[Info.ModuleType]:\r
1602 AutoGenC.Append("#include <%s>\n" % Inc)\r
1603 else:\r
1604 AutoGenC.Append("#include <%s>\n" % gBasicHeaderFile)\r
1605\r
1606 #\r
1607 # Publish the CallerId Guid\r
1608 #\r
1609 AutoGenC.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = %s;\n' % GuidStringToGuidStructureString(Info.Guid))\r
1610 AutoGenC.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED CHAR8 *gEfiCallerBaseName = "%s";\n' % Info.Name)\r
1611\r
1612## Create common code for header file\r
1613#\r
1614# @param Info The ModuleAutoGen object\r
1615# @param AutoGenC The TemplateString object for C code\r
1616# @param AutoGenH The TemplateString object for header file\r
1617#\r
1618def CreateFooterCode(Info, AutoGenC, AutoGenH):\r
1619 AutoGenH.Append(gAutoGenHEpilogueString)\r
1620\r
1621## Create code for a module\r
1622#\r
1623# @param Info The ModuleAutoGen object\r
1624# @param AutoGenC The TemplateString object for C code\r
1625# @param AutoGenH The TemplateString object for header file\r
1626# @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True\r
1627# @param UniGenBinBuffer Buffer to store uni string package data\r
1628#\r
1629def CreateCode(Info, AutoGenC, AutoGenH, StringH, UniGenCFlag, UniGenBinBuffer):\r
1630 CreateHeaderCode(Info, AutoGenC, AutoGenH)\r
1631\r
1632 if Info.AutoGenVersion >= 0x00010005:\r
1633 CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH)\r
1634 CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH)\r
1635 CreatePpiDefinitionCode(Info, AutoGenC, AutoGenH)\r
1636 CreatePcdCode(Info, AutoGenC, AutoGenH)\r
1637 CreateLibraryConstructorCode(Info, AutoGenC, AutoGenH)\r
1638 CreateLibraryDestructorCode(Info, AutoGenC, AutoGenH)\r
1639 CreateModuleEntryPointCode(Info, AutoGenC, AutoGenH)\r
1640 CreateModuleUnloadImageCode(Info, AutoGenC, AutoGenH)\r
1641\r
1642 if Info.UnicodeFileList:\r
1643 FileName = "%sStrDefs.h" % Info.Name\r
1644 StringH.Append(gAutoGenHeaderString.Replace({'FileName':FileName}))\r
1645 StringH.Append(gAutoGenHPrologueString.Replace({'File':'STRDEFS', 'Guid':Info.Guid.replace('-','_')}))\r
1646 CreateUnicodeStringCode(Info, AutoGenC, StringH, UniGenCFlag, UniGenBinBuffer)\r
8200fcfe
YL
1647\r
1648 GuidMacros = []\r
1649 for Guid in Info.Module.Guids:\r
1650 if Guid in Info.Module.GetGuidsUsedByPcd():\r
1651 continue\r
1652 GuidMacros.append('#define %s %s' % (Guid, Info.Module.Guids[Guid]))\r
1653 for Guid, Value in Info.Module.Protocols.items() + Info.Module.Ppis.items():\r
1654 GuidMacros.append('#define %s %s' % (Guid, Value))\r
1655 if GuidMacros:\r
1656 StringH.Append('\n#ifdef VFRCOMPILE\n%s\n#endif\n' % '\n'.join(GuidMacros))\r
1657\r
f51461c8
LG
1658 StringH.Append("\n#endif\n")\r
1659 AutoGenH.Append('#include "%s"\n' % FileName)\r
1660\r
1661 CreateFooterCode(Info, AutoGenC, AutoGenH)\r
1662\r
1663 # no generation of AutoGen.c for Edk modules without unicode file\r
1664 if Info.AutoGenVersion < 0x00010005 and len(Info.UnicodeFileList) == 0:\r
1665 AutoGenC.String = ''\r
1666\r
1667## Create the code file\r
1668#\r
1669# @param FilePath The path of code file\r
1670# @param Content The content of code file\r
1671# @param IsBinaryFile The flag indicating if the file is binary file or not\r
1672#\r
1673# @retval True If file content is changed or file doesn't exist\r
1674# @retval False If the file exists and the content is not changed\r
1675#\r
1676def Generate(FilePath, Content, IsBinaryFile):\r
1677 return SaveFileOnChange(FilePath, Content, IsBinaryFile)\r
1678\r