]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Source/Python/AutoGen/GenC.py
BaseTools: move PCD size calculation functions to PcdClassObject
[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
eca980c0 4# Copyright (c) 2007 - 2018, 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
333ba578
YZ
17import collections\r
18import struct\r
f51461c8
LG
19from Common import EdkLogger\r
20\r
21from Common.BuildToolError import *\r
22from Common.DataType import *\r
23from Common.Misc import *\r
24from Common.String import StringToArray\r
25from StrGather import *\r
26from GenPcdDb import CreatePcdDatabaseCode\r
333ba578 27from IdfClassObject import *\r
f51461c8
LG
28\r
29## PCD type string\r
30gItemTypeStringDatabase = {\r
be409b67
CJ
31 TAB_PCDS_FEATURE_FLAG : TAB_PCDS_FIXED_AT_BUILD,\r
32 TAB_PCDS_FIXED_AT_BUILD : TAB_PCDS_FIXED_AT_BUILD,\r
f51461c8
LG
33 TAB_PCDS_PATCHABLE_IN_MODULE: 'BinaryPatch',\r
34 TAB_PCDS_DYNAMIC : '',\r
35 TAB_PCDS_DYNAMIC_DEFAULT : '',\r
36 TAB_PCDS_DYNAMIC_VPD : '',\r
37 TAB_PCDS_DYNAMIC_HII : '',\r
38 TAB_PCDS_DYNAMIC_EX : '',\r
39 TAB_PCDS_DYNAMIC_EX_DEFAULT : '',\r
40 TAB_PCDS_DYNAMIC_EX_VPD : '',\r
41 TAB_PCDS_DYNAMIC_EX_HII : '',\r
42}\r
43\r
f51461c8
LG
44\r
45## Datum size\r
656d2539
CJ
46gDatumSizeStringDatabase = {TAB_UINT8:'8',TAB_UINT16:'16',TAB_UINT32:'32',TAB_UINT64:'64','BOOLEAN':'BOOLEAN',TAB_VOID:'8'}\r
47gDatumSizeStringDatabaseH = {TAB_UINT8:'8',TAB_UINT16:'16',TAB_UINT32:'32',TAB_UINT64:'64','BOOLEAN':'BOOL',TAB_VOID:'PTR'}\r
48gDatumSizeStringDatabaseLib = {TAB_UINT8:'8',TAB_UINT16:'16',TAB_UINT32:'32',TAB_UINT64:'64','BOOLEAN':'Bool',TAB_VOID:'Ptr'}\r
f51461c8
LG
49\r
50## AutoGen File Header Templates\r
51gAutoGenHeaderString = TemplateString("""\\r
52/**\r
53 DO NOT EDIT\r
54 FILE auto-generated\r
55 Module name:\r
56 ${FileName}\r
57 Abstract: Auto-generated ${FileName} for building module or library.\r
58**/\r
59""")\r
60\r
61gAutoGenHPrologueString = TemplateString("""\r
62#ifndef _${File}_${Guid}\r
63#define _${File}_${Guid}\r
64\r
65""")\r
66\r
67gAutoGenHCppPrologueString = """\\r
68#ifdef __cplusplus\r
69extern "C" {\r
70#endif\r
71\r
72"""\r
73\r
74gAutoGenHEpilogueString = """\r
75\r
76#ifdef __cplusplus\r
77}\r
78#endif\r
79\r
80#endif\r
81"""\r
82\r
83## PEI Core Entry Point Templates\r
84gPeiCoreEntryPointPrototype = TemplateString("""\r
85${BEGIN}\r
86VOID\r
87EFIAPI\r
88${Function} (\r
89 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,\r
90 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,\r
91 IN VOID *Context\r
92 );\r
93${END}\r
94""")\r
95\r
96gPeiCoreEntryPointString = TemplateString("""\r
97${BEGIN}\r
98VOID\r
99EFIAPI\r
100ProcessModuleEntryPointList (\r
101 IN CONST EFI_SEC_PEI_HAND_OFF *SecCoreData,\r
102 IN CONST EFI_PEI_PPI_DESCRIPTOR *PpiList,\r
103 IN VOID *Context\r
104 )\r
105\r
106{\r
107 ${Function} (SecCoreData, PpiList, Context);\r
108}\r
109${END}\r
110""")\r
111\r
112\r
113## DXE Core Entry Point Templates\r
114gDxeCoreEntryPointPrototype = TemplateString("""\r
115${BEGIN}\r
116VOID\r
117EFIAPI\r
118${Function} (\r
119 IN VOID *HobStart\r
120 );\r
121${END}\r
122""")\r
123\r
124gDxeCoreEntryPointString = TemplateString("""\r
125${BEGIN}\r
126VOID\r
127EFIAPI\r
128ProcessModuleEntryPointList (\r
129 IN VOID *HobStart\r
130 )\r
131\r
132{\r
133 ${Function} (HobStart);\r
134}\r
135${END}\r
136""")\r
137\r
138## PEIM Entry Point Templates\r
139gPeimEntryPointPrototype = TemplateString("""\r
140${BEGIN}\r
141EFI_STATUS\r
142EFIAPI\r
143${Function} (\r
144 IN EFI_PEI_FILE_HANDLE FileHandle,\r
145 IN CONST EFI_PEI_SERVICES **PeiServices\r
146 );\r
147${END}\r
148""")\r
149\r
150gPeimEntryPointString = [\r
151TemplateString("""\r
152GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
153\r
154EFI_STATUS\r
155EFIAPI\r
156ProcessModuleEntryPointList (\r
157 IN EFI_PEI_FILE_HANDLE FileHandle,\r
158 IN CONST EFI_PEI_SERVICES **PeiServices\r
159 )\r
160\r
161{\r
162 return EFI_SUCCESS;\r
163}\r
164"""),\r
165TemplateString("""\r
166GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
167${BEGIN}\r
168EFI_STATUS\r
169EFIAPI\r
170ProcessModuleEntryPointList (\r
171 IN EFI_PEI_FILE_HANDLE FileHandle,\r
172 IN CONST EFI_PEI_SERVICES **PeiServices\r
173 )\r
174\r
175{\r
176 return ${Function} (FileHandle, PeiServices);\r
177}\r
178${END}\r
179"""),\r
180TemplateString("""\r
181GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = ${PiSpecVersion};\r
182\r
183EFI_STATUS\r
184EFIAPI\r
185ProcessModuleEntryPointList (\r
186 IN EFI_PEI_FILE_HANDLE FileHandle,\r
187 IN CONST EFI_PEI_SERVICES **PeiServices\r
188 )\r
189\r
190{\r
191 EFI_STATUS Status;\r
192 EFI_STATUS CombinedStatus;\r
193\r
194 CombinedStatus = EFI_LOAD_ERROR;\r
195${BEGIN}\r
196 Status = ${Function} (FileHandle, PeiServices);\r
197 if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {\r
198 CombinedStatus = Status;\r
199 }\r
200${END}\r
201 return CombinedStatus;\r
202}\r
203""")\r
204]\r
205\r
206## SMM_CORE Entry Point Templates\r
207gSmmCoreEntryPointPrototype = TemplateString("""\r
208${BEGIN}\r
209EFI_STATUS\r
210EFIAPI\r
211${Function} (\r
212 IN EFI_HANDLE ImageHandle,\r
213 IN EFI_SYSTEM_TABLE *SystemTable\r
214 );\r
215${END}\r
216""")\r
217\r
218gSmmCoreEntryPointString = TemplateString("""\r
219${BEGIN}\r
220const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
221const UINT32 _gDxeRevision = ${PiSpecVersion};\r
222\r
223EFI_STATUS\r
224EFIAPI\r
225ProcessModuleEntryPointList (\r
226 IN EFI_HANDLE ImageHandle,\r
227 IN EFI_SYSTEM_TABLE *SystemTable\r
228 )\r
229{\r
230 return ${Function} (ImageHandle, SystemTable);\r
231}\r
232${END}\r
233""")\r
234\r
5a9c3e3e
SV
235## MM_CORE_STANDALONE Entry Point Templates\r
236gMmCoreStandaloneEntryPointPrototype = TemplateString("""\r
237${BEGIN}\r
238EFI_STATUS\r
239EFIAPI\r
240${Function} (\r
241 IN VOID *HobStart\r
242 );\r
243${END}\r
244""")\r
245\r
246gMmCoreStandaloneEntryPointString = TemplateString("""\r
247${BEGIN}\r
248const UINT32 _gMmRevision = ${PiSpecVersion};\r
249\r
250VOID\r
251EFIAPI\r
252ProcessModuleEntryPointList (\r
253 IN VOID *HobStart\r
254 )\r
255{\r
256 ${Function} (HobStart);\r
257}\r
258${END}\r
259""")\r
260\r
261## MM_STANDALONE Entry Point Templates\r
262gMmStandaloneEntryPointPrototype = TemplateString("""\r
263${BEGIN}\r
264EFI_STATUS\r
265EFIAPI\r
266${Function} (\r
267 IN EFI_HANDLE ImageHandle,\r
268 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
269 );\r
270${END}\r
271""")\r
272\r
273gMmStandaloneEntryPointString = [\r
274TemplateString("""\r
275GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};\r
276\r
277EFI_STATUS\r
278EFIAPI\r
279ProcessModuleEntryPointList (\r
280 IN EFI_HANDLE ImageHandle,\r
281 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
282 )\r
283\r
284{\r
285 return EFI_SUCCESS;\r
286}\r
287"""),\r
288TemplateString("""\r
289GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};\r
290${BEGIN}\r
291EFI_STATUS\r
292EFIAPI\r
293ProcessModuleEntryPointList (\r
294 IN EFI_HANDLE ImageHandle,\r
295 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
296 )\r
297\r
298{\r
299 return ${Function} (ImageHandle, MmSystemTable);\r
300}\r
301${END}\r
302"""),\r
303TemplateString("""\r
304GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gMmRevision = ${PiSpecVersion};\r
305\r
306EFI_STATUS\r
307EFIAPI\r
308ProcessModuleEntryPointList (\r
309 IN EFI_HANDLE ImageHandle,\r
310 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
311 )\r
312\r
313{\r
314 EFI_STATUS Status;\r
315 EFI_STATUS CombinedStatus;\r
316\r
317 CombinedStatus = EFI_LOAD_ERROR;\r
318${BEGIN}\r
319 Status = ${Function} (ImageHandle, MmSystemTable);\r
320 if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {\r
321 CombinedStatus = Status;\r
322 }\r
323${END}\r
324 return CombinedStatus;\r
325}\r
326""")\r
327]\r
328\r
f51461c8
LG
329## DXE SMM Entry Point Templates\r
330gDxeSmmEntryPointPrototype = TemplateString("""\r
331${BEGIN}\r
332EFI_STATUS\r
333EFIAPI\r
334${Function} (\r
335 IN EFI_HANDLE ImageHandle,\r
336 IN EFI_SYSTEM_TABLE *SystemTable\r
337 );\r
338${END}\r
339""")\r
340\r
341gDxeSmmEntryPointString = [\r
342TemplateString("""\r
343const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
344const UINT32 _gDxeRevision = ${PiSpecVersion};\r
345\r
346EFI_STATUS\r
347EFIAPI\r
348ProcessModuleEntryPointList (\r
349 IN EFI_HANDLE ImageHandle,\r
350 IN EFI_SYSTEM_TABLE *SystemTable\r
351 )\r
352\r
353{\r
354 return EFI_SUCCESS;\r
355}\r
356"""),\r
357TemplateString("""\r
358const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
359const UINT32 _gDxeRevision = ${PiSpecVersion};\r
360\r
361static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
362static EFI_STATUS mDriverEntryPointStatus;\r
363\r
364VOID\r
365EFIAPI\r
366ExitDriver (\r
367 IN EFI_STATUS Status\r
368 )\r
369{\r
370 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
371 mDriverEntryPointStatus = Status;\r
372 }\r
373 LongJump (&mJumpContext, (UINTN)-1);\r
374 ASSERT (FALSE);\r
375}\r
376\r
377EFI_STATUS\r
378EFIAPI\r
379ProcessModuleEntryPointList (\r
380 IN EFI_HANDLE ImageHandle,\r
381 IN EFI_SYSTEM_TABLE *SystemTable\r
382 )\r
383{\r
384 mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
385\r
386${BEGIN}\r
387 if (SetJump (&mJumpContext) == 0) {\r
388 ExitDriver (${Function} (ImageHandle, SystemTable));\r
389 ASSERT (FALSE);\r
390 }\r
391${END}\r
392\r
393 return mDriverEntryPointStatus;\r
394}\r
395""")\r
396]\r
397\r
398## UEFI Driver Entry Point Templates\r
399gUefiDriverEntryPointPrototype = TemplateString("""\r
400${BEGIN}\r
401EFI_STATUS\r
402EFIAPI\r
403${Function} (\r
404 IN EFI_HANDLE ImageHandle,\r
405 IN EFI_SYSTEM_TABLE *SystemTable\r
406 );\r
407${END}\r
408""")\r
409\r
410gUefiDriverEntryPointString = [\r
411TemplateString("""\r
412const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
413const UINT32 _gDxeRevision = ${PiSpecVersion};\r
414\r
415EFI_STATUS\r
416EFIAPI\r
417ProcessModuleEntryPointList (\r
418 IN EFI_HANDLE ImageHandle,\r
419 IN EFI_SYSTEM_TABLE *SystemTable\r
420 )\r
421{\r
422 return EFI_SUCCESS;\r
423}\r
424"""),\r
425TemplateString("""\r
426const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
427const UINT32 _gDxeRevision = ${PiSpecVersion};\r
428\r
429${BEGIN}\r
430EFI_STATUS\r
431EFIAPI\r
432ProcessModuleEntryPointList (\r
433 IN EFI_HANDLE ImageHandle,\r
434 IN EFI_SYSTEM_TABLE *SystemTable\r
435 )\r
436\r
437{\r
438 return ${Function} (ImageHandle, SystemTable);\r
439}\r
440${END}\r
441VOID\r
442EFIAPI\r
443ExitDriver (\r
444 IN EFI_STATUS Status\r
445 )\r
446{\r
447 if (EFI_ERROR (Status)) {\r
448 ProcessLibraryDestructorList (gImageHandle, gST);\r
449 }\r
450 gBS->Exit (gImageHandle, Status, 0, NULL);\r
451}\r
452"""),\r
453TemplateString("""\r
454const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
455const UINT32 _gDxeRevision = ${PiSpecVersion};\r
456\r
457static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
458static EFI_STATUS mDriverEntryPointStatus;\r
459\r
460EFI_STATUS\r
461EFIAPI\r
462ProcessModuleEntryPointList (\r
463 IN EFI_HANDLE ImageHandle,\r
464 IN EFI_SYSTEM_TABLE *SystemTable\r
465 )\r
466{\r
467 mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
468 ${BEGIN}\r
469 if (SetJump (&mJumpContext) == 0) {\r
470 ExitDriver (${Function} (ImageHandle, SystemTable));\r
471 ASSERT (FALSE);\r
472 }\r
473 ${END}\r
474 return mDriverEntryPointStatus;\r
475}\r
476\r
477VOID\r
478EFIAPI\r
479ExitDriver (\r
480 IN EFI_STATUS Status\r
481 )\r
482{\r
483 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
484 mDriverEntryPointStatus = Status;\r
485 }\r
486 LongJump (&mJumpContext, (UINTN)-1);\r
487 ASSERT (FALSE);\r
488}\r
489""")\r
490]\r
491\r
492\r
493## UEFI Application Entry Point Templates\r
494gUefiApplicationEntryPointPrototype = TemplateString("""\r
495${BEGIN}\r
496EFI_STATUS\r
497EFIAPI\r
498${Function} (\r
499 IN EFI_HANDLE ImageHandle,\r
500 IN EFI_SYSTEM_TABLE *SystemTable\r
501 );\r
502${END}\r
503""")\r
504\r
505gUefiApplicationEntryPointString = [\r
506TemplateString("""\r
507const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
508\r
509EFI_STATUS\r
510EFIAPI\r
511ProcessModuleEntryPointList (\r
512 IN EFI_HANDLE ImageHandle,\r
513 IN EFI_SYSTEM_TABLE *SystemTable\r
514 )\r
515{\r
516 return EFI_SUCCESS;\r
517}\r
518"""),\r
519TemplateString("""\r
520const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
521\r
522${BEGIN}\r
523EFI_STATUS\r
524EFIAPI\r
525ProcessModuleEntryPointList (\r
526 IN EFI_HANDLE ImageHandle,\r
527 IN EFI_SYSTEM_TABLE *SystemTable\r
528 )\r
529\r
530{\r
531 return ${Function} (ImageHandle, SystemTable);\r
532}\r
533${END}\r
534VOID\r
535EFIAPI\r
536ExitDriver (\r
537 IN EFI_STATUS Status\r
538 )\r
539{\r
540 if (EFI_ERROR (Status)) {\r
541 ProcessLibraryDestructorList (gImageHandle, gST);\r
542 }\r
543 gBS->Exit (gImageHandle, Status, 0, NULL);\r
544}\r
545"""),\r
546TemplateString("""\r
547const UINT32 _gUefiDriverRevision = ${UefiSpecVersion};\r
548\r
549EFI_STATUS\r
550EFIAPI\r
551ProcessModuleEntryPointList (\r
552 IN EFI_HANDLE ImageHandle,\r
553 IN EFI_SYSTEM_TABLE *SystemTable\r
554 )\r
555\r
556{\r
557 ${BEGIN}\r
558 if (SetJump (&mJumpContext) == 0) {\r
559 ExitDriver (${Function} (ImageHandle, SystemTable));\r
560 ASSERT (FALSE);\r
561 }\r
562 ${END}\r
563 return mDriverEntryPointStatus;\r
564}\r
565\r
566static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r
567static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\r
568\r
569VOID\r
570EFIAPI\r
571ExitDriver (\r
572 IN EFI_STATUS Status\r
573 )\r
574{\r
575 if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r
576 mDriverEntryPointStatus = Status;\r
577 }\r
578 LongJump (&mJumpContext, (UINTN)-1);\r
579 ASSERT (FALSE);\r
580}\r
581""")\r
582]\r
583\r
584## UEFI Unload Image Templates\r
585gUefiUnloadImagePrototype = TemplateString("""\r
586${BEGIN}\r
587EFI_STATUS\r
588EFIAPI\r
589${Function} (\r
590 IN EFI_HANDLE ImageHandle\r
591 );\r
592${END}\r
593""")\r
594\r
595gUefiUnloadImageString = [\r
596TemplateString("""\r
597GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
598\r
599EFI_STATUS\r
600EFIAPI\r
601ProcessModuleUnloadList (\r
602 IN EFI_HANDLE ImageHandle\r
603 )\r
604{\r
605 return EFI_SUCCESS;\r
606}\r
607"""),\r
608TemplateString("""\r
609GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
610\r
611${BEGIN}\r
612EFI_STATUS\r
613EFIAPI\r
614ProcessModuleUnloadList (\r
615 IN EFI_HANDLE ImageHandle\r
616 )\r
617{\r
618 return ${Function} (ImageHandle);\r
619}\r
620${END}\r
621"""),\r
622TemplateString("""\r
623GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ${Count};\r
624\r
625EFI_STATUS\r
626EFIAPI\r
627ProcessModuleUnloadList (\r
628 IN EFI_HANDLE ImageHandle\r
629 )\r
630{\r
631 EFI_STATUS Status;\r
632\r
633 Status = EFI_SUCCESS;\r
634${BEGIN}\r
635 if (EFI_ERROR (Status)) {\r
636 ${Function} (ImageHandle);\r
637 } else {\r
638 Status = ${Function} (ImageHandle);\r
639 }\r
640${END}\r
641 return Status;\r
642}\r
643""")\r
644]\r
645\r
646gLibraryStructorPrototype = {\r
8bb63e37 647SUP_MODULE_BASE : TemplateString("""${BEGIN}\r
f51461c8
LG
648RETURN_STATUS\r
649EFIAPI\r
650${Function} (\r
651 VOID\r
652 );${END}\r
653"""),\r
654\r
655'PEI' : TemplateString("""${BEGIN}\r
656EFI_STATUS\r
657EFIAPI\r
658${Function} (\r
659 IN EFI_PEI_FILE_HANDLE FileHandle,\r
660 IN CONST EFI_PEI_SERVICES **PeiServices\r
661 );${END}\r
662"""),\r
663\r
664'DXE' : TemplateString("""${BEGIN}\r
665EFI_STATUS\r
666EFIAPI\r
667${Function} (\r
668 IN EFI_HANDLE ImageHandle,\r
669 IN EFI_SYSTEM_TABLE *SystemTable\r
670 );${END}\r
671"""),\r
5a9c3e3e
SV
672\r
673'MM' : TemplateString("""${BEGIN}\r
674EFI_STATUS\r
675EFIAPI\r
676${Function} (\r
677 IN EFI_HANDLE ImageHandle,\r
678 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
679 );${END}\r
680"""),\r
f51461c8
LG
681}\r
682\r
683gLibraryStructorCall = {\r
8bb63e37 684SUP_MODULE_BASE : TemplateString("""${BEGIN}\r
f51461c8
LG
685 Status = ${Function} ();\r
686 ASSERT_EFI_ERROR (Status);${END}\r
687"""),\r
688\r
689'PEI' : TemplateString("""${BEGIN}\r
690 Status = ${Function} (FileHandle, PeiServices);\r
691 ASSERT_EFI_ERROR (Status);${END}\r
692"""),\r
693\r
694'DXE' : TemplateString("""${BEGIN}\r
695 Status = ${Function} (ImageHandle, SystemTable);\r
696 ASSERT_EFI_ERROR (Status);${END}\r
697"""),\r
5a9c3e3e
SV
698\r
699'MM' : TemplateString("""${BEGIN}\r
700 Status = ${Function} (ImageHandle, MmSystemTable);\r
701 ASSERT_EFI_ERROR (Status);${END}\r
702"""),\r
f51461c8
LG
703}\r
704\r
705## Library Constructor and Destructor Templates\r
706gLibraryString = {\r
8bb63e37 707SUP_MODULE_BASE : TemplateString("""\r
f51461c8
LG
708${BEGIN}${FunctionPrototype}${END}\r
709\r
710VOID\r
711EFIAPI\r
712ProcessLibrary${Type}List (\r
713 VOID\r
714 )\r
715{\r
716${BEGIN} EFI_STATUS Status;\r
717${FunctionCall}${END}\r
718}\r
719"""),\r
720\r
721'PEI' : TemplateString("""\r
722${BEGIN}${FunctionPrototype}${END}\r
723\r
724VOID\r
725EFIAPI\r
726ProcessLibrary${Type}List (\r
727 IN EFI_PEI_FILE_HANDLE FileHandle,\r
728 IN CONST EFI_PEI_SERVICES **PeiServices\r
729 )\r
730{\r
731${BEGIN} EFI_STATUS Status;\r
732${FunctionCall}${END}\r
733}\r
734"""),\r
735\r
736'DXE' : TemplateString("""\r
737${BEGIN}${FunctionPrototype}${END}\r
738\r
739VOID\r
740EFIAPI\r
741ProcessLibrary${Type}List (\r
742 IN EFI_HANDLE ImageHandle,\r
743 IN EFI_SYSTEM_TABLE *SystemTable\r
744 )\r
745{\r
746${BEGIN} EFI_STATUS Status;\r
747${FunctionCall}${END}\r
748}\r
749"""),\r
5a9c3e3e
SV
750\r
751'MM' : TemplateString("""\r
752${BEGIN}${FunctionPrototype}${END}\r
753\r
754VOID\r
755EFIAPI\r
756ProcessLibrary${Type}List (\r
757 IN EFI_HANDLE ImageHandle,\r
758 IN EFI_SMM_SYSTEM_TABLE2 *MmSystemTable\r
759 )\r
760{\r
761${BEGIN} EFI_STATUS Status;\r
762${FunctionCall}${END}\r
763}\r
764"""),\r
f51461c8
LG
765}\r
766\r
767gBasicHeaderFile = "Base.h"\r
768\r
769gModuleTypeHeaderFile = {\r
8bb63e37
CJ
770 SUP_MODULE_BASE : [gBasicHeaderFile],\r
771 SUP_MODULE_SEC : ["PiPei.h", "Library/DebugLib.h"],\r
772 SUP_MODULE_PEI_CORE : ["PiPei.h", "Library/DebugLib.h", "Library/PeiCoreEntryPoint.h"],\r
773 SUP_MODULE_PEIM : ["PiPei.h", "Library/DebugLib.h", "Library/PeimEntryPoint.h"],\r
774 SUP_MODULE_DXE_CORE : ["PiDxe.h", "Library/DebugLib.h", "Library/DxeCoreEntryPoint.h"],\r
775 SUP_MODULE_DXE_DRIVER : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
776 SUP_MODULE_DXE_SMM_DRIVER : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
777 SUP_MODULE_DXE_RUNTIME_DRIVER: ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
778 SUP_MODULE_DXE_SAL_DRIVER : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
779 SUP_MODULE_UEFI_DRIVER : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiDriverEntryPoint.h"],\r
780 SUP_MODULE_UEFI_APPLICATION : ["Uefi.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiBootServicesTableLib.h", "Library/UefiApplicationEntryPoint.h"],\r
781 SUP_MODULE_SMM_CORE : ["PiDxe.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/UefiDriverEntryPoint.h"],\r
782 SUP_MODULE_MM_STANDALONE : ["PiSmm.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/SmmDriverStandaloneEntryPoint.h"],\r
783 SUP_MODULE_MM_CORE_STANDALONE : ["PiSmm.h", "Library/BaseLib.h", "Library/DebugLib.h", "Library/SmmCoreStandaloneEntryPoint.h"],\r
784 SUP_MODULE_USER_DEFINED : [gBasicHeaderFile]\r
f51461c8
LG
785}\r
786\r
787## Autogen internal worker macro to define DynamicEx PCD name includes both the TokenSpaceGuidName \r
788# the TokenName and Guid comparison to avoid define name collisions.\r
789#\r
790# @param Info The ModuleAutoGen object\r
791# @param AutoGenH The TemplateString object for header file\r
792#\r
793#\r
794def DynExPcdTokenNumberMapping(Info, AutoGenH):\r
795 ExTokenCNameList = []\r
796 PcdExList = []\r
d590cce5
YZ
797 # Even it is the Library, the PCD is saved in the ModulePcdList\r
798 PcdList = Info.ModulePcdList\r
f51461c8 799 for Pcd in PcdList:\r
eece4292 800 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET:\r
f51461c8
LG
801 ExTokenCNameList.append(Pcd.TokenCName)\r
802 PcdExList.append(Pcd)\r
803 if len(ExTokenCNameList) == 0:\r
804 return\r
805 AutoGenH.Append('\n#define COMPAREGUID(Guid1, Guid2) (BOOLEAN)(*(CONST UINT64*)Guid1 == *(CONST UINT64*)Guid2 && *((CONST UINT64*)Guid1 + 1) == *((CONST UINT64*)Guid2 + 1))\n')\r
806 # AutoGen for each PCD listed in a [PcdEx] section of a Module/Lib INF file.\r
807 # Auto generate a macro for each TokenName that takes a Guid pointer as a parameter. \r
808 # Use the Guid pointer to see if it matches any of the token space GUIDs.\r
72fbe88d 809 TokenCNameList = set()\r
f51461c8
LG
810 for TokenCName in ExTokenCNameList:\r
811 if TokenCName in TokenCNameList:\r
812 continue\r
813 Index = 0\r
814 Count = ExTokenCNameList.count(TokenCName)\r
815 for Pcd in PcdExList:\r
2a29017e
YZ
816 RealTokenCName = Pcd.TokenCName\r
817 for PcdItem in GlobalData.MixedPcd:\r
818 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
819 RealTokenCName = PcdItem[0]\r
820 break\r
f51461c8
LG
821 if Pcd.TokenCName == TokenCName:\r
822 Index = Index + 1\r
823 if Index == 1:\r
2a29017e 824 AutoGenH.Append('\n#define __PCD_%s_ADDR_CMP(GuidPtr) (' % (RealTokenCName))\r
f51461c8 825 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
2a29017e 826 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
f51461c8
LG
827 else:\r
828 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
2a29017e 829 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
f51461c8
LG
830 if Index == Count:\r
831 AutoGenH.Append('0 \\\n )\n')\r
72fbe88d 832 TokenCNameList.add(TokenCName)\r
f51461c8 833 \r
72fbe88d 834 TokenCNameList = set()\r
f51461c8
LG
835 for TokenCName in ExTokenCNameList:\r
836 if TokenCName in TokenCNameList:\r
837 continue\r
838 Index = 0\r
839 Count = ExTokenCNameList.count(TokenCName)\r
840 for Pcd in PcdExList:\r
2a29017e
YZ
841 RealTokenCName = Pcd.TokenCName\r
842 for PcdItem in GlobalData.MixedPcd:\r
843 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
844 RealTokenCName = PcdItem[0]\r
845 break\r
eece4292 846 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET and Pcd.TokenCName == TokenCName:\r
f51461c8
LG
847 Index = Index + 1\r
848 if Index == 1:\r
2a29017e 849 AutoGenH.Append('\n#define __PCD_%s_VAL_CMP(GuidPtr) (' % (RealTokenCName))\r
9023704f 850 AutoGenH.Append('\\\n (GuidPtr == NULL) ? 0:')\r
f51461c8 851 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
2a29017e 852 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
f51461c8
LG
853 else:\r
854 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
2a29017e 855 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
f51461c8
LG
856 if Index == Count:\r
857 AutoGenH.Append('0 \\\n )\n')\r
858 # Autogen internal worker macro to compare GUIDs. Guid1 is a pointer to a GUID. \r
859 # Guid2 is a C name for a GUID. Compare pointers first because optimizing compiler\r
860 # can do this at build time on CONST GUID pointers and optimize away call to COMPAREGUID().\r
861 # COMPAREGUID() will only be used if the Guid passed in is local to the module.\r
862 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
2a29017e 863 % (RealTokenCName, RealTokenCName, RealTokenCName, RealTokenCName))\r
72fbe88d 864 TokenCNameList.add(TokenCName)\r
f51461c8
LG
865\r
866## Create code for module PCDs\r
867#\r
868# @param Info The ModuleAutoGen object\r
869# @param AutoGenC The TemplateString object for C code\r
870# @param AutoGenH The TemplateString object for header file\r
871# @param Pcd The PCD object\r
872#\r
873def CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd):\r
874 TokenSpaceGuidValue = Pcd.TokenSpaceGuidValue #Info.GuidList[Pcd.TokenSpaceGuidCName]\r
875 PcdTokenNumber = Info.PlatformInfo.PcdTokenNumber\r
2a29017e
YZ
876 #\r
877 # Write PCDs\r
878 #\r
879 TokenCName = Pcd.TokenCName\r
880 for PcdItem in GlobalData.MixedPcd:\r
881 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
882 TokenCName = PcdItem[0]\r
883 break\r
884 PcdTokenName = '_PCD_TOKEN_' + TokenCName\r
885 PatchPcdSizeTokenName = '_PCD_PATCHABLE_' + TokenCName +'_SIZE'\r
886 PatchPcdSizeVariableName = '_gPcd_BinaryPatch_Size_' + TokenCName\r
f7b31aa5 887 PatchPcdMaxSizeVariable = '_gPcd_BinaryPatch_MaxSize_' + TokenCName\r
2a29017e 888 FixPcdSizeTokenName = '_PCD_SIZE_' + TokenCName\r
1bfcf64f 889 FixedPcdSizeVariableName = '_gPcd_FixedAtBuild_Size_' + TokenCName\r
763e8edf 890\r
0f228f19
B
891 if Pcd.PcdValueFromComm:\r
892 Pcd.DefaultValue = Pcd.PcdValueFromComm\r
2f5acc3b 893 \r
eece4292 894 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET:\r
f51461c8
LG
895 TokenNumber = int(Pcd.TokenValue, 0)\r
896 # Add TokenSpaceGuidValue value to PcdTokenName to discriminate the DynamicEx PCDs with \r
897 # different Guids but same TokenCName\r
2a29017e 898 PcdExTokenName = '_PCD_TOKEN_' + Pcd.TokenSpaceGuidCName + '_' + TokenCName\r
f51461c8
LG
899 AutoGenH.Append('\n#define %s %dU\n' % (PcdExTokenName, TokenNumber))\r
900 else:\r
901 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) not in PcdTokenNumber:\r
902 # If one of the Source built modules listed in the DSC is not listed in FDF modules, \r
903 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only \r
904 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will \r
905 # report warning message notify the PI that they are attempting to build a module \r
906 # that must be included in a flash image in order to be functional. These Dynamic PCD \r
907 # will not be added into the Database unless it is used by other modules that are \r
908 # included in the FDF file. \r
909 # In this case, just assign an invalid token number to make it pass build.\r
eece4292 910 if Pcd.Type in PCD_DYNAMIC_TYPE_SET:\r
f51461c8
LG
911 TokenNumber = 0\r
912 else:\r
913 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 914 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
915 ExtraData="[%s]" % str(Info))\r
916 else:\r
917 TokenNumber = PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName]\r
918 AutoGenH.Append('\n#define %s %dU\n' % (PcdTokenName, TokenNumber))\r
919\r
2a29017e 920 EdkLogger.debug(EdkLogger.DEBUG_3, "Creating code for " + TokenCName + "." + Pcd.TokenSpaceGuidCName)\r
f51461c8
LG
921 if Pcd.Type not in gItemTypeStringDatabase:\r
922 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 923 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8 924 ExtraData="[%s]" % str(Info))\r
f51461c8 925\r
656d2539
CJ
926 DatumSize = gDatumSizeStringDatabase[Pcd.DatumType] if Pcd.DatumType in gDatumSizeStringDatabase else gDatumSizeStringDatabase[TAB_VOID]\r
927 DatumSizeLib = gDatumSizeStringDatabaseLib[Pcd.DatumType] if Pcd.DatumType in gDatumSizeStringDatabaseLib else gDatumSizeStringDatabaseLib[TAB_VOID]\r
928 GetModeName = '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_' + TokenCName\r
929 SetModeName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_' + TokenCName\r
930 SetModeStatusName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_S_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_S_' + TokenCName\r
2a29017e 931 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + TokenCName\r
2f5acc3b 932 \r
eece4292 933 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET:\r
f51461c8
LG
934 if Info.IsLibrary:\r
935 PcdList = Info.LibraryPcdList\r
936 else:\r
937 PcdList = Info.ModulePcdList\r
72fbe88d 938 PcdExCNameTest = 0\r
f51461c8 939 for PcdModule in PcdList:\r
eece4292 940 if PcdModule.Type in PCD_DYNAMIC_EX_TYPE_SET and Pcd.TokenCName == PcdModule.TokenCName:\r
72fbe88d
CJ
941 PcdExCNameTest += 1\r
942 # get out early once we found > 1...\r
943 if PcdExCNameTest > 1:\r
944 break\r
f51461c8
LG
945 # Be compatible with the current code which using PcdToken and PcdGet/Set for DynamicEx Pcd.\r
946 # If only PcdToken and PcdGet/Set used in all Pcds with different CName, it should succeed to build.\r
947 # If PcdToken and PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.\r
72fbe88d 948 if PcdExCNameTest > 1:\r
f51461c8
LG
949 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
950 AutoGenH.Append('// #define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
951 AutoGenH.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
38b986e3 952 AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
656d2539 953 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f51461c8 954 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 955 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
956 else:\r
957 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 958 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
959 else:\r
960 AutoGenH.Append('#define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
961 AutoGenH.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 962 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
656d2539 963 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f51461c8 964 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 965 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
966 else:\r
967 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 968 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
eece4292 969 elif Pcd.Type in PCD_DYNAMIC_TYPE_SET:\r
72fbe88d
CJ
970 PcdCNameTest = 0\r
971 for PcdModule in Info.LibraryPcdList + Info.ModulePcdList:\r
eece4292 972 if PcdModule.Type in PCD_DYNAMIC_TYPE_SET and Pcd.TokenCName == PcdModule.TokenCName:\r
72fbe88d
CJ
973 PcdCNameTest += 1\r
974 # get out early once we found > 1...\r
975 if PcdCNameTest > 1:\r
976 break\r
977 if PcdCNameTest > 1:\r
2a29017e 978 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))\r
f51461c8 979 else:\r
38b986e3
YZ
980 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
981 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
656d2539 982 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
38b986e3
YZ
983 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))\r
984 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
985 else:\r
986 AutoGenH.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))\r
987 AutoGenH.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8 988 else:\r
2a29017e 989 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + TokenCName\r
f51461c8
LG
990 Const = 'const'\r
991 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
992 Const = ''\r
993 Type = ''\r
994 Array = ''\r
995 Value = Pcd.DefaultValue\r
996 Unicode = False\r
997 ValueNumber = 0\r
998\r
999 if Pcd.DatumType == 'BOOLEAN':\r
1000 BoolValue = Value.upper()\r
1001 if BoolValue == 'TRUE' or BoolValue == '1':\r
1002 Value = '1U'\r
1003 elif BoolValue == 'FALSE' or BoolValue == '0':\r
1004 Value = '0U'\r
1005\r
656d2539 1006 if Pcd.DatumType in TAB_PCD_CLEAN_NUMERIC_TYPES:\r
f51461c8 1007 try:\r
726c501c
YZ
1008 if Value.upper().endswith('L'):\r
1009 Value = Value[:-1]\r
0944818a 1010 ValueNumber = int (Value, 0)\r
f51461c8
LG
1011 except:\r
1012 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1013 "PCD value is not valid dec or hex number for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8 1014 ExtraData="[%s]" % str(Info))\r
656d2539 1015 if Pcd.DatumType == TAB_UINT64:\r
f51461c8
LG
1016 if ValueNumber < 0:\r
1017 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1018 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1019 ExtraData="[%s]" % str(Info))\r
1020 elif ValueNumber >= 0x10000000000000000:\r
1021 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1022 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1023 ExtraData="[%s]" % str(Info))\r
1024 if not Value.endswith('ULL'):\r
1025 Value += 'ULL'\r
656d2539 1026 elif Pcd.DatumType == TAB_UINT32:\r
f51461c8
LG
1027 if ValueNumber < 0:\r
1028 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1029 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1030 ExtraData="[%s]" % str(Info))\r
1031 elif ValueNumber >= 0x100000000:\r
1032 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1033 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1034 ExtraData="[%s]" % str(Info))\r
1035 if not Value.endswith('U'):\r
1036 Value += 'U'\r
656d2539 1037 elif Pcd.DatumType == TAB_UINT16:\r
f51461c8
LG
1038 if ValueNumber < 0:\r
1039 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1040 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1041 ExtraData="[%s]" % str(Info))\r
1042 elif ValueNumber >= 0x10000:\r
1043 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1044 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1045 ExtraData="[%s]" % str(Info))\r
1046 if not Value.endswith('U'):\r
1047 Value += 'U' \r
656d2539 1048 elif Pcd.DatumType == TAB_UINT8:\r
f51461c8
LG
1049 if ValueNumber < 0:\r
1050 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1051 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1052 ExtraData="[%s]" % str(Info))\r
1053 elif ValueNumber >= 0x100:\r
1054 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1055 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1056 ExtraData="[%s]" % str(Info))\r
1057 if not Value.endswith('U'):\r
1058 Value += 'U'\r
656d2539 1059 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
4231a819 1060 if Pcd.MaxDatumSize is None or Pcd.MaxDatumSize == '':\r
f51461c8 1061 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1062 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1063 ExtraData="[%s]" % str(Info))\r
1064\r
1065 ArraySize = int(Pcd.MaxDatumSize, 0)\r
1066 if Value[0] == '{':\r
1067 Type = '(VOID *)'\r
1068 else:\r
1069 if Value[0] == 'L':\r
1070 Unicode = True\r
1071 Value = Value.lstrip('L') #.strip('"')\r
1072 Value = eval(Value) # translate escape character\r
1073 NewValue = '{'\r
1074 for Index in range(0,len(Value)):\r
1075 if Unicode:\r
1076 NewValue = NewValue + str(ord(Value[Index]) % 0x10000) + ', '\r
1077 else:\r
1078 NewValue = NewValue + str(ord(Value[Index]) % 0x100) + ', '\r
1079 if Unicode:\r
1080 ArraySize = ArraySize / 2;\r
1081\r
1082 if ArraySize < (len(Value) + 1):\r
c33081c9
YZ
1083 if Pcd.MaxSizeUserSet:\r
1084 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1085 "The maximum size of VOID* type PCD '%s.%s' is less than its actual size occupied." % (Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8 1086 ExtraData="[%s]" % str(Info))\r
c33081c9 1087 else:\r
5565a8c4 1088 ArraySize = Pcd.GetPcdSize()\r
c33081c9
YZ
1089 if Unicode:\r
1090 ArraySize = ArraySize / 2\r
f51461c8
LG
1091 Value = NewValue + '0 }'\r
1092 Array = '[%d]' % ArraySize\r
1093 #\r
1094 # skip casting for fixed at build since it breaks ARM assembly.\r
1095 # Long term we need PCD macros that work in assembly\r
1096 #\r
656d2539 1097 elif Pcd.Type != TAB_PCDS_FIXED_AT_BUILD and Pcd.DatumType in TAB_PCD_NUMERIC_TYPES_VOID:\r
f51461c8
LG
1098 Value = "((%s)%s)" % (Pcd.DatumType, Value)\r
1099\r
656d2539 1100 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES_VOID:\r
ae7b6df8 1101 # handle structure PCD\r
4231a819 1102 if Pcd.MaxDatumSize is None or Pcd.MaxDatumSize == '':\r
ae7b6df8
LG
1103 EdkLogger.error("build", AUTOGEN_ERROR,\r
1104 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
1105 ExtraData="[%s]" % str(Info))\r
1106\r
1107 ArraySize = int(Pcd.MaxDatumSize, 0)\r
1108 Array = '[%d]' % ArraySize\r
1109\r
f51461c8 1110 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
2a29017e 1111 PcdValueName = '_PCD_PATCHABLE_VALUE_' + TokenCName\r
f51461c8 1112 else:\r
2a29017e 1113 PcdValueName = '_PCD_VALUE_' + TokenCName\r
f51461c8 1114 \r
656d2539 1115 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f51461c8
LG
1116 #\r
1117 # For unicode, UINT16 array will be generated, so the alignment of unicode is guaranteed.\r
1118 #\r
674e2014 1119 AutoGenH.Append('#define %s %s%s\n' %(PcdValueName, Type, PcdVariableName))\r
f51461c8 1120 if Unicode:\r
f51461c8
LG
1121 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT16 %s%s = %s;\n' % (Const, PcdVariableName, Array, Value))\r
1122 AutoGenH.Append('extern %s UINT16 %s%s;\n' %(Const, PcdVariableName, Array))\r
f51461c8 1123 else:\r
f51461c8
LG
1124 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s UINT8 %s%s = %s;\n' % (Const, PcdVariableName, Array, Value))\r
1125 AutoGenH.Append('extern %s UINT8 %s%s;\n' %(Const, PcdVariableName, Array))\r
674e2014 1126 AutoGenH.Append('#define %s %s%s\n' %(GetModeName, Type, PcdVariableName))\r
2f5acc3b 1127 \r
5565a8c4 1128 PcdDataSize = Pcd.GetPcdSize()\r
2f5acc3b
BF
1129 if Pcd.Type == TAB_PCDS_FIXED_AT_BUILD:\r
1130 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1131 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,FixPcdSizeTokenName))\r
1bfcf64f 1132 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (FixedPcdSizeVariableName,PcdDataSize))\r
2f5acc3b
BF
1133 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1134 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, Pcd.MaxDatumSize))\r
1135 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1136 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1137 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName,PcdDataSize))\r
f7b31aa5 1138 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (PatchPcdMaxSizeVariable,Pcd.MaxDatumSize))\r
f51461c8
LG
1139 elif Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1140 AutoGenH.Append('#define %s %s\n' %(PcdValueName, Value))\r
1141 AutoGenC.Append('volatile %s %s %s = %s;\n' %(Const, Pcd.DatumType, PcdVariableName, PcdValueName))\r
1142 AutoGenH.Append('extern volatile %s %s %s%s;\n' % (Const, Pcd.DatumType, PcdVariableName, Array))\r
1143 AutoGenH.Append('#define %s %s%s\n' % (GetModeName, Type, PcdVariableName))\r
2f5acc3b 1144 \r
5565a8c4 1145 PcdDataSize = Pcd.GetPcdSize()\r
2f5acc3b
BF
1146 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, PcdDataSize))\r
1147 \r
1148 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1149 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1150 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED UINTN %s = %s;\n' % (PatchPcdSizeVariableName,PcdDataSize))\r
f51461c8 1151 else:\r
5565a8c4 1152 PcdDataSize = Pcd.GetPcdSize()\r
2f5acc3b
BF
1153 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1154 AutoGenH.Append('#define %s %s \n' % (GetModeSizeName,FixPcdSizeTokenName))\r
1155 \r
f51461c8
LG
1156 AutoGenH.Append('#define %s %s\n' %(PcdValueName, Value))\r
1157 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s %s = %s;\n' %(Const, Pcd.DatumType, PcdVariableName, PcdValueName))\r
1158 AutoGenH.Append('extern %s %s %s%s;\n' % (Const, Pcd.DatumType, PcdVariableName, Array))\r
1159 AutoGenH.Append('#define %s %s%s\n' % (GetModeName, Type, PcdVariableName))\r
1160\r
1161 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
656d2539 1162 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
e70504cd
LG
1163 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))\r
1164 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))\r
f51461c8
LG
1165 else:\r
1166 AutoGenH.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName, PcdVariableName))\r
82a6a960 1167 AutoGenH.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS) \n' % (SetModeStatusName, PcdVariableName))\r
f51461c8
LG
1168 else:\r
1169 AutoGenH.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName)\r
1170\r
1171## Create code for library module PCDs\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# @param Pcd The PCD object\r
1177#\r
1178def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):\r
1179 PcdTokenNumber = Info.PlatformInfo.PcdTokenNumber\r
1180 TokenSpaceGuidCName = Pcd.TokenSpaceGuidCName\r
1181 TokenCName = Pcd.TokenCName\r
2a29017e
YZ
1182 for PcdItem in GlobalData.MixedPcd:\r
1183 if (TokenCName, TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
1184 TokenCName = PcdItem[0]\r
1185 break\r
f51461c8 1186 PcdTokenName = '_PCD_TOKEN_' + TokenCName\r
2a29017e
YZ
1187 FixPcdSizeTokenName = '_PCD_SIZE_' + TokenCName\r
1188 PatchPcdSizeTokenName = '_PCD_PATCHABLE_' + TokenCName +'_SIZE'\r
1189 PatchPcdSizeVariableName = '_gPcd_BinaryPatch_Size_' + TokenCName\r
f7b31aa5 1190 PatchPcdMaxSizeVariable = '_gPcd_BinaryPatch_MaxSize_' + TokenCName\r
1bfcf64f 1191 FixedPcdSizeVariableName = '_gPcd_FixedAtBuild_Size_' + TokenCName\r
763e8edf 1192\r
0f228f19
B
1193 if Pcd.PcdValueFromComm:\r
1194 Pcd.DefaultValue = Pcd.PcdValueFromComm\r
f51461c8
LG
1195 #\r
1196 # Write PCDs\r
1197 #\r
eece4292 1198 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET:\r
f51461c8
LG
1199 TokenNumber = int(Pcd.TokenValue, 0)\r
1200 else:\r
1201 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) not in PcdTokenNumber:\r
1202 # If one of the Source built modules listed in the DSC is not listed in FDF modules, \r
1203 # and the INF lists a PCD can only use the PcdsDynamic access method (it is only \r
1204 # listed in the DEC file that declares the PCD as PcdsDynamic), then build tool will \r
1205 # report warning message notify the PI that they are attempting to build a module \r
1206 # that must be included in a flash image in order to be functional. These Dynamic PCD \r
1207 # will not be added into the Database unless it is used by other modules that are \r
1208 # included in the FDF file. \r
1209 # In this case, just assign an invalid token number to make it pass build.\r
eece4292 1210 if Pcd.Type in PCD_DYNAMIC_TYPE_SET:\r
f51461c8
LG
1211 TokenNumber = 0\r
1212 else:\r
1213 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1214 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8
LG
1215 ExtraData="[%s]" % str(Info))\r
1216 else:\r
1217 TokenNumber = PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName]\r
1218\r
1219 if Pcd.Type not in gItemTypeStringDatabase:\r
1220 EdkLogger.error("build", AUTOGEN_ERROR,\r
2a29017e 1221 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, TokenCName),\r
f51461c8 1222 ExtraData="[%s]" % str(Info))\r
f51461c8
LG
1223\r
1224 DatumType = Pcd.DatumType\r
656d2539
CJ
1225 DatumSize = gDatumSizeStringDatabase[Pcd.DatumType] if Pcd.DatumType in gDatumSizeStringDatabase else gDatumSizeStringDatabase[TAB_VOID]\r
1226 DatumSizeLib = gDatumSizeStringDatabaseLib[Pcd.DatumType] if Pcd.DatumType in gDatumSizeStringDatabaseLib else gDatumSizeStringDatabaseLib[TAB_VOID]\r
1227 GetModeName = '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_GET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_' + TokenCName\r
1228 SetModeName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_' + TokenCName\r
1229 SetModeStatusName = '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[Pcd.DatumType] + '_S_' + TokenCName if Pcd.DatumType in gDatumSizeStringDatabaseH else '_PCD_SET_MODE_' + gDatumSizeStringDatabaseH[TAB_VOID] + '_S_' + TokenCName\r
2a29017e 1230 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + TokenCName\r
f51461c8
LG
1231\r
1232 Type = ''\r
1233 Array = ''\r
656d2539 1234 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
d66670f9
YZ
1235 if Pcd.DefaultValue[0]== '{':\r
1236 Type = '(VOID *)'\r
f51461c8
LG
1237 Array = '[]'\r
1238 PcdItemType = Pcd.Type\r
eece4292 1239 if PcdItemType in PCD_DYNAMIC_EX_TYPE_SET:\r
2a29017e 1240 PcdExTokenName = '_PCD_TOKEN_' + TokenSpaceGuidCName + '_' + TokenCName\r
f51461c8
LG
1241 AutoGenH.Append('\n#define %s %dU\n' % (PcdExTokenName, TokenNumber))\r
1242 \r
1243 if Info.IsLibrary:\r
1244 PcdList = Info.LibraryPcdList\r
1245 else:\r
1246 PcdList = Info.ModulePcdList\r
72fbe88d 1247 PcdExCNameTest = 0\r
f51461c8 1248 for PcdModule in PcdList:\r
eece4292 1249 if PcdModule.Type in PCD_DYNAMIC_EX_TYPE_SET and Pcd.TokenCName == PcdModule.TokenCName:\r
72fbe88d
CJ
1250 PcdExCNameTest += 1\r
1251 # get out early once we found > 1...\r
1252 if PcdExCNameTest > 1:\r
1253 break\r
f51461c8
LG
1254 # Be compatible with the current code which using PcdGet/Set for DynamicEx Pcd.\r
1255 # If only PcdGet/Set used in all Pcds with different CName, it should succeed to build.\r
1256 # If PcdGet/Set used in the Pcds with different Guids but same CName, it should failed to build.\r
72fbe88d 1257 if PcdExCNameTest > 1:\r
f51461c8
LG
1258 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
1259 AutoGenH.Append('// #define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
1260 AutoGenH.Append('// #define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
d590cce5 1261 AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
656d2539 1262 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f51461c8 1263 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1264 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1265 else:\r
1266 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1267 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1268 else:\r
1269 AutoGenH.Append('#define %s %s\n' % (PcdTokenName, PcdExTokenName))\r
1270 AutoGenH.Append('#define %s LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
2f5acc3b 1271 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
656d2539 1272 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f51461c8 1273 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1274 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1275 else:\r
1276 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
82a6a960 1277 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
f51461c8
LG
1278 else:\r
1279 AutoGenH.Append('#define _PCD_TOKEN_%s %dU\n' % (TokenCName, TokenNumber))\r
eece4292 1280 if PcdItemType in PCD_DYNAMIC_TYPE_SET:\r
38b986e3
YZ
1281 PcdList = []\r
1282 PcdCNameList = []\r
1283 PcdList.extend(Info.LibraryPcdList)\r
1284 PcdList.extend(Info.ModulePcdList)\r
1285 for PcdModule in PcdList:\r
eece4292 1286 if PcdModule.Type in PCD_DYNAMIC_TYPE_SET:\r
38b986e3
YZ
1287 PcdCNameList.append(PcdModule.TokenCName)\r
1288 if PcdCNameList.count(Pcd.TokenCName) > 1:\r
2a29017e 1289 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))\r
f51461c8 1290 else:\r
38b986e3
YZ
1291 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
1292 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
656d2539 1293 if DatumType not in TAB_PCD_NUMERIC_TYPES:\r
38b986e3
YZ
1294 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))\r
1295 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
1296 else:\r
1297 AutoGenH.Append('#define %s(Value) LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))\r
1298 AutoGenH.Append('#define %s(Value) LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))\r
f51461c8 1299 if PcdItemType == TAB_PCDS_PATCHABLE_IN_MODULE:\r
f7b31aa5 1300 GetModeMaxSizeName = '_PCD_GET_MODE_MAXSIZE' + '_' + TokenCName\r
f51461c8 1301 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[TAB_PCDS_PATCHABLE_IN_MODULE] + '_' + TokenCName\r
656d2539
CJ
1302 if DatumType not in TAB_PCD_NUMERIC_TYPES:\r
1303 if DatumType == TAB_VOID and Array == '[]':\r
1304 DatumType = [TAB_UINT8, TAB_UINT16][Pcd.DefaultValue[0] == 'L']\r
f7b31aa5 1305 else:\r
656d2539 1306 DatumType = TAB_UINT8\r
d66670f9
YZ
1307 AutoGenH.Append('extern %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType, TokenCName, Array))\r
1308 else:\r
1309 AutoGenH.Append('extern volatile %s %s%s;\n' % (DatumType, PcdVariableName, Array))\r
f51461c8 1310 AutoGenH.Append('#define %s %s_gPcd_BinaryPatch_%s\n' %(GetModeName, Type, TokenCName))\r
5565a8c4 1311 PcdDataSize = Pcd.GetPcdSize()\r
656d2539 1312 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
f7b31aa5
YZ
1313 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSize((VOID *)_gPcd_BinaryPatch_%s, &%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, TokenCName, PatchPcdSizeVariableName, PatchPcdMaxSizeVariable))\r
1314 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPatchPcdSetPtrAndSizeS((VOID *)_gPcd_BinaryPatch_%s, &%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, TokenCName, PatchPcdSizeVariableName, PatchPcdMaxSizeVariable))\r
1315 AutoGenH.Append('#define %s %s\n' % (GetModeMaxSizeName, PatchPcdMaxSizeVariable))\r
1316 AutoGenH.Append('extern const UINTN %s; \n' % PatchPcdMaxSizeVariable)\r
27187d24
LG
1317 else:\r
1318 AutoGenH.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName, PcdVariableName))\r
1319 AutoGenH.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS)\n' % (SetModeStatusName, PcdVariableName))\r
a6c31c6d
YZ
1320 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, PcdDataSize))\r
1321\r
2f5acc3b
BF
1322 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1323 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1324 \r
f51461c8
LG
1325 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD or PcdItemType == TAB_PCDS_FEATURE_FLAG:\r
1326 key = ".".join((Pcd.TokenSpaceGuidCName,Pcd.TokenCName))\r
7256bd55 1327 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + TokenCName\r
656d2539
CJ
1328 if DatumType == TAB_VOID and Array == '[]':\r
1329 DatumType = [TAB_UINT8, TAB_UINT16][Pcd.DefaultValue[0] == 'L']\r
1330 if DatumType not in TAB_PCD_NUMERIC_TYPES_VOID:\r
1331 DatumType = TAB_UINT8\r
f51461c8
LG
1332 AutoGenH.Append('extern const %s _gPcd_FixedAtBuild_%s%s;\n' %(DatumType, TokenCName, Array))\r
1333 AutoGenH.Append('#define %s %s_gPcd_FixedAtBuild_%s\n' %(GetModeName, Type, TokenCName))\r
1334 AutoGenH.Append('//#define %s ASSERT(FALSE) // It is not allowed to set value for a FIXED_AT_BUILD PCD\n' % SetModeName)\r
1335 \r
1bfcf64f 1336 ConstFixedPcd = False\r
c9da41b2 1337 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD and (key in Info.ConstPcd or (Info.IsLibrary and not Info._ReferenceModules)):\r
1bfcf64f 1338 ConstFixedPcd = True\r
eca980c0
YZ
1339 if key in Info.ConstPcd:\r
1340 Pcd.DefaultValue = Info.ConstPcd[key]\r
656d2539 1341 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
7256bd55
YZ
1342 AutoGenH.Append('#define _PCD_VALUE_%s %s%s\n' %(TokenCName, Type, PcdVariableName))\r
1343 else:\r
1344 AutoGenH.Append('#define _PCD_VALUE_%s %s\n' %(TokenCName, Pcd.DefaultValue))\r
5565a8c4 1345 PcdDataSize = Pcd.GetPcdSize()\r
2f5acc3b 1346 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD:\r
656d2539 1347 if Pcd.DatumType not in TAB_PCD_NUMERIC_TYPES:\r
1bfcf64f
YZ
1348 if ConstFixedPcd:\r
1349 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1350 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,FixPcdSizeTokenName))\r
1351 else:\r
1352 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,FixedPcdSizeVariableName))\r
1353 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName,FixedPcdSizeVariableName))\r
1354 AutoGenH.Append('extern const UINTN %s; \n' % FixedPcdSizeVariableName)\r
1355 else:\r
1356 AutoGenH.Append('#define %s %s\n' % (FixPcdSizeTokenName, PcdDataSize))\r
1357 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,FixPcdSizeTokenName))\r
f51461c8
LG
1358\r
1359## Create code for library constructor\r
1360#\r
1361# @param Info The ModuleAutoGen object\r
1362# @param AutoGenC The TemplateString object for C code\r
1363# @param AutoGenH The TemplateString object for header file\r
1364#\r
1365def CreateLibraryConstructorCode(Info, AutoGenC, AutoGenH):\r
1366 #\r
1367 # Library Constructors\r
1368 #\r
1369 ConstructorPrototypeString = TemplateString()\r
1370 ConstructorCallingString = TemplateString()\r
1371 if Info.IsLibrary:\r
1372 DependentLibraryList = [Info.Module]\r
1373 else:\r
1374 DependentLibraryList = Info.DependentLibraryList\r
1375 for Lib in DependentLibraryList:\r
1376 if len(Lib.ConstructorList) <= 0:\r
1377 continue\r
1378 Dict = {'Function':Lib.ConstructorList}\r
8bb63e37
CJ
1379 if Lib.ModuleType in [SUP_MODULE_BASE, SUP_MODULE_SEC]:\r
1380 ConstructorPrototypeString.Append(gLibraryStructorPrototype[SUP_MODULE_BASE].Replace(Dict))\r
1381 ConstructorCallingString.Append(gLibraryStructorCall[SUP_MODULE_BASE].Replace(Dict))\r
88c6c1b6 1382 elif Lib.ModuleType in SUP_MODULE_SET_PEI:\r
f51461c8
LG
1383 ConstructorPrototypeString.Append(gLibraryStructorPrototype['PEI'].Replace(Dict))\r
1384 ConstructorCallingString.Append(gLibraryStructorCall['PEI'].Replace(Dict))\r
8bb63e37
CJ
1385 elif Lib.ModuleType in [SUP_MODULE_DXE_CORE,SUP_MODULE_DXE_DRIVER,SUP_MODULE_DXE_SMM_DRIVER,SUP_MODULE_DXE_RUNTIME_DRIVER,\r
1386 SUP_MODULE_DXE_SAL_DRIVER,SUP_MODULE_UEFI_DRIVER,SUP_MODULE_UEFI_APPLICATION,SUP_MODULE_SMM_CORE]:\r
f51461c8
LG
1387 ConstructorPrototypeString.Append(gLibraryStructorPrototype['DXE'].Replace(Dict))\r
1388 ConstructorCallingString.Append(gLibraryStructorCall['DXE'].Replace(Dict))\r
8bb63e37 1389 elif Lib.ModuleType in [SUP_MODULE_MM_STANDALONE,SUP_MODULE_MM_CORE_STANDALONE]:\r
5a9c3e3e
SV
1390 ConstructorPrototypeString.Append(gLibraryStructorPrototype['MM'].Replace(Dict))\r
1391 ConstructorCallingString.Append(gLibraryStructorCall['MM'].Replace(Dict))\r
f51461c8
LG
1392\r
1393 if str(ConstructorPrototypeString) == '':\r
1394 ConstructorPrototypeList = []\r
1395 else:\r
1396 ConstructorPrototypeList = [str(ConstructorPrototypeString)]\r
1397 if str(ConstructorCallingString) == '':\r
1398 ConstructorCallingList = []\r
1399 else:\r
1400 ConstructorCallingList = [str(ConstructorCallingString)]\r
1401\r
1402 Dict = {\r
1403 'Type' : 'Constructor',\r
1404 'FunctionPrototype' : ConstructorPrototypeList,\r
1405 'FunctionCall' : ConstructorCallingList\r
1406 }\r
1407 if Info.IsLibrary:\r
1408 AutoGenH.Append("${BEGIN}${FunctionPrototype}${END}", Dict)\r
1409 else:\r
8bb63e37
CJ
1410 if Info.ModuleType in [SUP_MODULE_BASE, SUP_MODULE_SEC]:\r
1411 AutoGenC.Append(gLibraryString[SUP_MODULE_BASE].Replace(Dict))\r
88c6c1b6 1412 elif Info.ModuleType in SUP_MODULE_SET_PEI:\r
f51461c8 1413 AutoGenC.Append(gLibraryString['PEI'].Replace(Dict))\r
8bb63e37
CJ
1414 elif Info.ModuleType in [SUP_MODULE_DXE_CORE,SUP_MODULE_DXE_DRIVER,SUP_MODULE_DXE_SMM_DRIVER,SUP_MODULE_DXE_RUNTIME_DRIVER,\r
1415 SUP_MODULE_DXE_SAL_DRIVER,SUP_MODULE_UEFI_DRIVER,SUP_MODULE_UEFI_APPLICATION,SUP_MODULE_SMM_CORE]:\r
f51461c8 1416 AutoGenC.Append(gLibraryString['DXE'].Replace(Dict))\r
8bb63e37 1417 elif Info.ModuleType in [SUP_MODULE_MM_STANDALONE,SUP_MODULE_MM_CORE_STANDALONE]:\r
5a9c3e3e 1418 AutoGenC.Append(gLibraryString['MM'].Replace(Dict))\r
f51461c8
LG
1419\r
1420## Create code for library destructor\r
1421#\r
1422# @param Info The ModuleAutoGen object\r
1423# @param AutoGenC The TemplateString object for C code\r
1424# @param AutoGenH The TemplateString object for header file\r
1425#\r
1426def CreateLibraryDestructorCode(Info, AutoGenC, AutoGenH):\r
1427 #\r
1428 # Library Destructors\r
1429 #\r
1430 DestructorPrototypeString = TemplateString()\r
1431 DestructorCallingString = TemplateString()\r
1432 if Info.IsLibrary:\r
1433 DependentLibraryList = [Info.Module]\r
1434 else:\r
1435 DependentLibraryList = Info.DependentLibraryList\r
1436 for Index in range(len(DependentLibraryList)-1, -1, -1):\r
1437 Lib = DependentLibraryList[Index]\r
1438 if len(Lib.DestructorList) <= 0:\r
1439 continue\r
1440 Dict = {'Function':Lib.DestructorList}\r
8bb63e37
CJ
1441 if Lib.ModuleType in [SUP_MODULE_BASE, SUP_MODULE_SEC]:\r
1442 DestructorPrototypeString.Append(gLibraryStructorPrototype[SUP_MODULE_BASE].Replace(Dict))\r
1443 DestructorCallingString.Append(gLibraryStructorCall[SUP_MODULE_BASE].Replace(Dict))\r
88c6c1b6 1444 elif Lib.ModuleType in SUP_MODULE_SET_PEI:\r
f51461c8
LG
1445 DestructorPrototypeString.Append(gLibraryStructorPrototype['PEI'].Replace(Dict))\r
1446 DestructorCallingString.Append(gLibraryStructorCall['PEI'].Replace(Dict))\r
8bb63e37
CJ
1447 elif Lib.ModuleType in [SUP_MODULE_DXE_CORE,SUP_MODULE_DXE_DRIVER,SUP_MODULE_DXE_SMM_DRIVER,SUP_MODULE_DXE_RUNTIME_DRIVER,\r
1448 SUP_MODULE_DXE_SAL_DRIVER,SUP_MODULE_UEFI_DRIVER,SUP_MODULE_UEFI_APPLICATION, SUP_MODULE_SMM_CORE]:\r
f51461c8
LG
1449 DestructorPrototypeString.Append(gLibraryStructorPrototype['DXE'].Replace(Dict))\r
1450 DestructorCallingString.Append(gLibraryStructorCall['DXE'].Replace(Dict))\r
8bb63e37 1451 elif Lib.ModuleType in [SUP_MODULE_MM_STANDALONE,SUP_MODULE_MM_CORE_STANDALONE]:\r
5a9c3e3e
SV
1452 DestructorPrototypeString.Append(gLibraryStructorPrototype['MM'].Replace(Dict))\r
1453 DestructorCallingString.Append(gLibraryStructorCall['MM'].Replace(Dict))\r
f51461c8
LG
1454\r
1455 if str(DestructorPrototypeString) == '':\r
1456 DestructorPrototypeList = []\r
1457 else:\r
1458 DestructorPrototypeList = [str(DestructorPrototypeString)]\r
1459 if str(DestructorCallingString) == '':\r
1460 DestructorCallingList = []\r
1461 else:\r
1462 DestructorCallingList = [str(DestructorCallingString)]\r
1463\r
1464 Dict = {\r
1465 'Type' : 'Destructor',\r
1466 'FunctionPrototype' : DestructorPrototypeList,\r
1467 'FunctionCall' : DestructorCallingList\r
1468 }\r
1469 if Info.IsLibrary:\r
1470 AutoGenH.Append("${BEGIN}${FunctionPrototype}${END}", Dict)\r
1471 else:\r
8bb63e37
CJ
1472 if Info.ModuleType in [SUP_MODULE_BASE, SUP_MODULE_SEC]:\r
1473 AutoGenC.Append(gLibraryString[SUP_MODULE_BASE].Replace(Dict))\r
88c6c1b6 1474 elif Info.ModuleType in SUP_MODULE_SET_PEI:\r
f51461c8 1475 AutoGenC.Append(gLibraryString['PEI'].Replace(Dict))\r
8bb63e37
CJ
1476 elif Info.ModuleType in [SUP_MODULE_DXE_CORE,SUP_MODULE_DXE_DRIVER,SUP_MODULE_DXE_SMM_DRIVER,SUP_MODULE_DXE_RUNTIME_DRIVER,\r
1477 SUP_MODULE_DXE_SAL_DRIVER,SUP_MODULE_UEFI_DRIVER,SUP_MODULE_UEFI_APPLICATION,SUP_MODULE_SMM_CORE]:\r
f51461c8 1478 AutoGenC.Append(gLibraryString['DXE'].Replace(Dict))\r
8bb63e37 1479 elif Info.ModuleType in [SUP_MODULE_MM_STANDALONE,SUP_MODULE_MM_CORE_STANDALONE]:\r
5a9c3e3e 1480 AutoGenC.Append(gLibraryString['MM'].Replace(Dict))\r
f51461c8
LG
1481\r
1482\r
1483## Create code for ModuleEntryPoint\r
1484#\r
1485# @param Info The ModuleAutoGen object\r
1486# @param AutoGenC The TemplateString object for C code\r
1487# @param AutoGenH The TemplateString object for header file\r
1488#\r
1489def CreateModuleEntryPointCode(Info, AutoGenC, AutoGenH):\r
8bb63e37 1490 if Info.IsLibrary or Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_SEC]:\r
f51461c8
LG
1491 return\r
1492 #\r
1493 # Module Entry Points\r
1494 #\r
1495 NumEntryPoints = len(Info.Module.ModuleEntryPointList)\r
1496 if 'PI_SPECIFICATION_VERSION' in Info.Module.Specification:\r
1497 PiSpecVersion = Info.Module.Specification['PI_SPECIFICATION_VERSION']\r
1498 else:\r
1499 PiSpecVersion = '0x00000000'\r
1500 if 'UEFI_SPECIFICATION_VERSION' in Info.Module.Specification:\r
1501 UefiSpecVersion = Info.Module.Specification['UEFI_SPECIFICATION_VERSION']\r
1502 else:\r
1503 UefiSpecVersion = '0x00000000'\r
1504 Dict = {\r
1505 'Function' : Info.Module.ModuleEntryPointList,\r
1506 'PiSpecVersion' : PiSpecVersion + 'U',\r
1507 'UefiSpecVersion': UefiSpecVersion + 'U'\r
1508 }\r
1509\r
8bb63e37 1510 if Info.ModuleType in [SUP_MODULE_PEI_CORE, SUP_MODULE_DXE_CORE, SUP_MODULE_SMM_CORE, SUP_MODULE_MM_CORE_STANDALONE]:\r
128d435f 1511 if Info.SourceFileList:\r
f51461c8
LG
1512 if NumEntryPoints != 1:\r
1513 EdkLogger.error(\r
1514 "build",\r
1515 AUTOGEN_ERROR,\r
1516 '%s must have exactly one entry point' % Info.ModuleType,\r
1517 File=str(Info),\r
1518 ExtraData= ", ".join(Info.Module.ModuleEntryPointList)\r
1519 )\r
8bb63e37 1520 if Info.ModuleType == SUP_MODULE_PEI_CORE:\r
f51461c8
LG
1521 AutoGenC.Append(gPeiCoreEntryPointString.Replace(Dict))\r
1522 AutoGenH.Append(gPeiCoreEntryPointPrototype.Replace(Dict))\r
8bb63e37 1523 elif Info.ModuleType == SUP_MODULE_DXE_CORE:\r
f51461c8
LG
1524 AutoGenC.Append(gDxeCoreEntryPointString.Replace(Dict))\r
1525 AutoGenH.Append(gDxeCoreEntryPointPrototype.Replace(Dict))\r
8bb63e37 1526 elif Info.ModuleType == SUP_MODULE_SMM_CORE:\r
f51461c8
LG
1527 AutoGenC.Append(gSmmCoreEntryPointString.Replace(Dict))\r
1528 AutoGenH.Append(gSmmCoreEntryPointPrototype.Replace(Dict))\r
8bb63e37 1529 elif Info.ModuleType == SUP_MODULE_MM_CORE_STANDALONE:\r
5a9c3e3e
SV
1530 AutoGenC.Append(gMmCoreStandaloneEntryPointString.Replace(Dict))\r
1531 AutoGenH.Append(gMmCoreStandaloneEntryPointPrototype.Replace(Dict))\r
8bb63e37 1532 elif Info.ModuleType == SUP_MODULE_PEIM:\r
f51461c8
LG
1533 if NumEntryPoints < 2:\r
1534 AutoGenC.Append(gPeimEntryPointString[NumEntryPoints].Replace(Dict))\r
1535 else:\r
1536 AutoGenC.Append(gPeimEntryPointString[2].Replace(Dict))\r
1537 AutoGenH.Append(gPeimEntryPointPrototype.Replace(Dict))\r
8bb63e37 1538 elif Info.ModuleType in [SUP_MODULE_DXE_RUNTIME_DRIVER,SUP_MODULE_DXE_DRIVER,SUP_MODULE_DXE_SAL_DRIVER,SUP_MODULE_UEFI_DRIVER]:\r
f51461c8
LG
1539 if NumEntryPoints < 2:\r
1540 AutoGenC.Append(gUefiDriverEntryPointString[NumEntryPoints].Replace(Dict))\r
1541 else:\r
1542 AutoGenC.Append(gUefiDriverEntryPointString[2].Replace(Dict))\r
1543 AutoGenH.Append(gUefiDriverEntryPointPrototype.Replace(Dict))\r
8bb63e37 1544 elif Info.ModuleType == SUP_MODULE_DXE_SMM_DRIVER:\r
f51461c8
LG
1545 if NumEntryPoints == 0:\r
1546 AutoGenC.Append(gDxeSmmEntryPointString[0].Replace(Dict))\r
1547 else:\r
1548 AutoGenC.Append(gDxeSmmEntryPointString[1].Replace(Dict))\r
5a9c3e3e 1549 AutoGenH.Append(gDxeSmmEntryPointPrototype.Replace(Dict))\r
8bb63e37 1550 elif Info.ModuleType == SUP_MODULE_MM_STANDALONE:\r
5a9c3e3e
SV
1551 if NumEntryPoints < 2:\r
1552 AutoGenC.Append(gMmStandaloneEntryPointString[NumEntryPoints].Replace(Dict))\r
1553 else:\r
1554 AutoGenC.Append(gMmStandaloneEntryPointString[2].Replace(Dict))\r
1555 AutoGenH.Append(gMmStandaloneEntryPointPrototype.Replace(Dict))\r
8bb63e37 1556 elif Info.ModuleType == SUP_MODULE_UEFI_APPLICATION:\r
f51461c8
LG
1557 if NumEntryPoints < 2:\r
1558 AutoGenC.Append(gUefiApplicationEntryPointString[NumEntryPoints].Replace(Dict))\r
1559 else:\r
1560 AutoGenC.Append(gUefiApplicationEntryPointString[2].Replace(Dict))\r
1561 AutoGenH.Append(gUefiApplicationEntryPointPrototype.Replace(Dict))\r
1562\r
1563## Create code for ModuleUnloadImage\r
1564#\r
1565# @param Info The ModuleAutoGen object\r
1566# @param AutoGenC The TemplateString object for C code\r
1567# @param AutoGenH The TemplateString object for header file\r
1568#\r
1569def CreateModuleUnloadImageCode(Info, AutoGenC, AutoGenH):\r
8bb63e37 1570 if Info.IsLibrary or Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_SEC]:\r
f51461c8
LG
1571 return\r
1572 #\r
1573 # Unload Image Handlers\r
1574 #\r
1575 NumUnloadImage = len(Info.Module.ModuleUnloadImageList)\r
1576 Dict = {'Count':str(NumUnloadImage) + 'U', 'Function':Info.Module.ModuleUnloadImageList}\r
1577 if NumUnloadImage < 2:\r
1578 AutoGenC.Append(gUefiUnloadImageString[NumUnloadImage].Replace(Dict))\r
1579 else:\r
1580 AutoGenC.Append(gUefiUnloadImageString[2].Replace(Dict))\r
1581 AutoGenH.Append(gUefiUnloadImagePrototype.Replace(Dict))\r
1582\r
1583## Create code for GUID\r
1584#\r
1585# @param Info The ModuleAutoGen object\r
1586# @param AutoGenC The TemplateString object for C code\r
1587# @param AutoGenH The TemplateString object for header file\r
1588#\r
1589def CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH):\r
8bb63e37 1590 if Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_BASE]:\r
91fa33ee 1591 GuidType = TAB_GUID\r
f51461c8
LG
1592 else:\r
1593 GuidType = "EFI_GUID"\r
1594\r
1595 if Info.GuidList:\r
7beed8a3
YZ
1596 if not Info.IsLibrary:\r
1597 AutoGenC.Append("\n// Guids\n")\r
8262037f 1598 AutoGenH.Append("\n// Guids\n")\r
f51461c8
LG
1599 #\r
1600 # GUIDs\r
1601 #\r
1602 for Key in Info.GuidList:\r
7beed8a3
YZ
1603 if not Info.IsLibrary:\r
1604 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.GuidList[Key]))\r
8262037f 1605 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1606\r
1607## Create code for protocol\r
1608#\r
1609# @param Info The ModuleAutoGen object\r
1610# @param AutoGenC The TemplateString object for C code\r
1611# @param AutoGenH The TemplateString object for header file\r
1612#\r
1613def CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH):\r
8bb63e37 1614 if Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_BASE]:\r
91fa33ee 1615 GuidType = TAB_GUID\r
f51461c8
LG
1616 else:\r
1617 GuidType = "EFI_GUID"\r
1618\r
1619 if Info.ProtocolList:\r
7beed8a3
YZ
1620 if not Info.IsLibrary:\r
1621 AutoGenC.Append("\n// Protocols\n")\r
8262037f 1622 AutoGenH.Append("\n// Protocols\n")\r
f51461c8
LG
1623 #\r
1624 # Protocol GUIDs\r
1625 #\r
1626 for Key in Info.ProtocolList:\r
7beed8a3
YZ
1627 if not Info.IsLibrary:\r
1628 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.ProtocolList[Key]))\r
8262037f 1629 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1630\r
1631## Create code for PPI\r
1632#\r
1633# @param Info The ModuleAutoGen object\r
1634# @param AutoGenC The TemplateString object for C code\r
1635# @param AutoGenH The TemplateString object for header file\r
1636#\r
1637def CreatePpiDefinitionCode(Info, AutoGenC, AutoGenH):\r
8bb63e37 1638 if Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_BASE]:\r
91fa33ee 1639 GuidType = TAB_GUID\r
f51461c8
LG
1640 else:\r
1641 GuidType = "EFI_GUID"\r
1642\r
1643 if Info.PpiList:\r
7beed8a3
YZ
1644 if not Info.IsLibrary:\r
1645 AutoGenC.Append("\n// PPIs\n")\r
8262037f 1646 AutoGenH.Append("\n// PPIs\n")\r
f51461c8
LG
1647 #\r
1648 # PPI GUIDs\r
1649 #\r
1650 for Key in Info.PpiList:\r
7beed8a3
YZ
1651 if not Info.IsLibrary:\r
1652 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.PpiList[Key]))\r
8262037f 1653 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
f51461c8
LG
1654\r
1655## Create code for PCD\r
1656#\r
1657# @param Info The ModuleAutoGen object\r
1658# @param AutoGenC The TemplateString object for C code\r
1659# @param AutoGenH The TemplateString object for header file\r
1660#\r
1661def CreatePcdCode(Info, AutoGenC, AutoGenH):\r
1662\r
1663 # Collect Token Space GUIDs used by DynamicEc PCDs\r
1664 TokenSpaceList = []\r
1665 for Pcd in Info.ModulePcdList:\r
eece4292 1666 if Pcd.Type in PCD_DYNAMIC_EX_TYPE_SET and Pcd.TokenSpaceGuidCName not in TokenSpaceList:\r
f51461c8
LG
1667 TokenSpaceList += [Pcd.TokenSpaceGuidCName]\r
1668 \r
8518bf0b
LG
1669 SkuMgr = Info.Workspace.Platform.SkuIdMgr\r
1670 AutoGenH.Append("\n// Definition of SkuId Array\n")\r
1671 AutoGenH.Append("extern UINT64 _gPcd_SkuId_Array[];\n")\r
f51461c8 1672 # Add extern declarations to AutoGen.h if one or more Token Space GUIDs were found\r
72fbe88d 1673 if TokenSpaceList:\r
f51461c8 1674 AutoGenH.Append("\n// Definition of PCD Token Space GUIDs used in this module\n\n")\r
8bb63e37 1675 if Info.ModuleType in [SUP_MODULE_USER_DEFINED, SUP_MODULE_BASE]:\r
91fa33ee 1676 GuidType = TAB_GUID\r
f51461c8
LG
1677 else:\r
1678 GuidType = "EFI_GUID" \r
1679 for Item in TokenSpaceList:\r
1680 AutoGenH.Append('extern %s %s;\n' % (GuidType, Item))\r
1681\r
1682 if Info.IsLibrary:\r
1683 if Info.ModulePcdList:\r
1684 AutoGenH.Append("\n// PCD definitions\n")\r
1685 for Pcd in Info.ModulePcdList:\r
1686 CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd)\r
1687 DynExPcdTokenNumberMapping (Info, AutoGenH)\r
1688 else:\r
8518bf0b
LG
1689 AutoGenC.Append("\n// Definition of SkuId Array\n")\r
1690 AutoGenC.Append("GLOBAL_REMOVE_IF_UNREFERENCED UINT64 _gPcd_SkuId_Array[] = %s;\n" % SkuMgr.DumpSkuIdArrary())\r
f51461c8
LG
1691 if Info.ModulePcdList:\r
1692 AutoGenH.Append("\n// Definition of PCDs used in this module\n")\r
1693 AutoGenC.Append("\n// Definition of PCDs used in this module\n")\r
1694 for Pcd in Info.ModulePcdList:\r
1695 CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd)\r
1696 DynExPcdTokenNumberMapping (Info, AutoGenH)\r
1697 if Info.LibraryPcdList:\r
1698 AutoGenH.Append("\n// Definition of PCDs used in libraries is in AutoGen.c\n")\r
1699 AutoGenC.Append("\n// Definition of PCDs used in libraries\n")\r
1700 for Pcd in Info.LibraryPcdList:\r
1701 CreateModulePcdCode(Info, AutoGenC, AutoGenC, Pcd)\r
1702 CreatePcdDatabaseCode(Info, AutoGenC, AutoGenH)\r
1703\r
1704## Create code for unicode string definition\r
1705#\r
1706# @param Info The ModuleAutoGen object\r
1707# @param AutoGenC The TemplateString object for C code\r
1708# @param AutoGenH The TemplateString object for header file\r
1709# @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True\r
1710# @param UniGenBinBuffer Buffer to store uni string package data\r
1711#\r
1712def CreateUnicodeStringCode(Info, AutoGenC, AutoGenH, UniGenCFlag, UniGenBinBuffer):\r
1713 WorkingDir = os.getcwd()\r
1714 os.chdir(Info.WorkspaceDir)\r
1715\r
1716 IncList = [Info.MetaFile.Dir]\r
1717 # Get all files under [Sources] section in inf file for EDK-II module\r
1718 EDK2Module = True\r
1719 SrcList = [F for F in Info.SourceFileList]\r
1720 if Info.AutoGenVersion < 0x00010005:\r
1721 EDK2Module = False\r
1722 # Get all files under the module directory for EDK-I module\r
1723 Cwd = os.getcwd()\r
1724 os.chdir(Info.MetaFile.Dir)\r
1725 for Root, Dirs, Files in os.walk("."):\r
1726 if 'CVS' in Dirs:\r
1727 Dirs.remove('CVS')\r
1728 if '.svn' in Dirs:\r
1729 Dirs.remove('.svn')\r
1730 for File in Files:\r
1731 File = PathClass(os.path.join(Root, File), Info.MetaFile.Dir)\r
1732 if File in SrcList:\r
1733 continue\r
1734 SrcList.append(File)\r
1735 os.chdir(Cwd)\r
1736\r
1737 if 'BUILD' in Info.BuildOption and Info.BuildOption['BUILD']['FLAGS'].find('-c') > -1:\r
1738 CompatibleMode = True\r
1739 else:\r
1740 CompatibleMode = False\r
1741\r
1742 #\r
1743 # -s is a temporary option dedicated for building .UNI files with ISO 639-2 language codes of EDK Shell in EDK2\r
1744 #\r
1745 if 'BUILD' in Info.BuildOption and Info.BuildOption['BUILD']['FLAGS'].find('-s') > -1:\r
1746 if CompatibleMode:\r
1747 EdkLogger.error("build", AUTOGEN_ERROR,\r
1748 "-c and -s build options should be used exclusively",\r
1749 ExtraData="[%s]" % str(Info))\r
1750 ShellMode = True\r
1751 else:\r
1752 ShellMode = False\r
1753\r
1754 #RFC4646 is only for EDKII modules and ISO639-2 for EDK modules\r
1755 if EDK2Module:\r
1756 FilterInfo = [EDK2Module] + [Info.PlatformInfo.Platform.RFCLanguages]\r
1757 else:\r
1758 FilterInfo = [EDK2Module] + [Info.PlatformInfo.Platform.ISOLanguages]\r
1759 Header, Code = GetStringFiles(Info.UnicodeFileList, SrcList, IncList, Info.IncludePathList, ['.uni', '.inf'], Info.Name, CompatibleMode, ShellMode, UniGenCFlag, UniGenBinBuffer, FilterInfo)\r
1760 if CompatibleMode or UniGenCFlag:\r
1761 AutoGenC.Append("\n//\n//Unicode String Pack Definition\n//\n")\r
1762 AutoGenC.Append(Code)\r
1763 AutoGenC.Append("\n")\r
1764 AutoGenH.Append("\n//\n//Unicode String ID\n//\n")\r
1765 AutoGenH.Append(Header)\r
1766 if CompatibleMode or UniGenCFlag:\r
1767 AutoGenH.Append("\n#define STRING_ARRAY_NAME %sStrings\n" % Info.Name)\r
1768 os.chdir(WorkingDir)\r
1769\r
333ba578
YZ
1770def CreateIdfFileCode(Info, AutoGenC, StringH, IdfGenCFlag, IdfGenBinBuffer):\r
1771 if len(Info.IdfFileList) > 0:\r
1772 ImageFiles = IdfFileClassObject(sorted (Info.IdfFileList))\r
1773 if ImageFiles.ImageFilesDict:\r
1774 Index = 1\r
1775 PaletteIndex = 1\r
1776 IncList = [Info.MetaFile.Dir]\r
1777 SrcList = [F for F in Info.SourceFileList]\r
1778 SkipList = ['.jpg', '.png', '.bmp', '.inf', '.idf']\r
1779 FileList = GetFileList(SrcList, IncList, SkipList)\r
1780 ValueStartPtr = 60\r
1781 StringH.Append("\n//\n//Image ID\n//\n")\r
1782 ImageInfoOffset = 0\r
1783 PaletteInfoOffset = 0\r
1784 ImageBuffer = pack('x')\r
1785 PaletteBuffer = pack('x')\r
1786 BufferStr = ''\r
1787 PaletteStr = ''\r
6d034a2a 1788 FileDict = {}\r
333ba578
YZ
1789 for Idf in ImageFiles.ImageFilesDict:\r
1790 if ImageFiles.ImageFilesDict[Idf]:\r
1791 for FileObj in ImageFiles.ImageFilesDict[Idf]:\r
1792 for sourcefile in Info.SourceFileList:\r
1793 if FileObj.FileName == sourcefile.File:\r
1794 if not sourcefile.Ext.upper() in ['.PNG', '.BMP', '.JPG']:\r
1795 EdkLogger.error("build", AUTOGEN_ERROR, "The %s's postfix must be one of .bmp, .jpg, .png" % (FileObj.FileName), ExtraData="[%s]" % str(Info))\r
1796 FileObj.File = sourcefile\r
1797 break\r
1798 else:\r
1799 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))\r
1800\r
1801 for FileObj in ImageFiles.ImageFilesDict[Idf]:\r
1802 ID = FileObj.ImageID\r
1803 File = FileObj.File\r
1804 if not os.path.exists(File.Path) or not os.path.isfile(File.Path):\r
1805 EdkLogger.error("build", FILE_NOT_FOUND, ExtraData=File.Path)\r
1806 SearchImageID (FileObj, FileList)\r
1807 if FileObj.Referenced:\r
1808 if (ValueStartPtr - len(DEFINE_STR + ID)) <= 0:\r
1809 Line = DEFINE_STR + ' ' + ID + ' ' + DecToHexStr(Index, 4) + '\n'\r
1810 else:\r
1811 Line = DEFINE_STR + ' ' + ID + ' ' * (ValueStartPtr - len(DEFINE_STR + ID)) + DecToHexStr(Index, 4) + '\n'\r
1812\r
6d034a2a
YZ
1813 if File not in FileDict:\r
1814 FileDict[File] = Index\r
1815 else:\r
1816 DuplicateBlock = pack('B', EFI_HII_IIBT_DUPLICATE)\r
1817 DuplicateBlock += pack('H', FileDict[File])\r
1818 ImageBuffer += DuplicateBlock\r
1819 BufferStr = WriteLine(BufferStr, '// %s: %s: %s' % (DecToHexStr(Index, 4), ID, DecToHexStr(Index, 4)))\r
1820 TempBufferList = AscToHexList(DuplicateBlock)\r
1821 BufferStr = WriteLine(BufferStr, CreateArrayItem(TempBufferList, 16) + '\n')\r
1822 StringH.Append(Line)\r
1823 Index += 1\r
1824 continue\r
1825\r
333ba578
YZ
1826 TmpFile = open(File.Path, 'rb')\r
1827 Buffer = TmpFile.read()\r
1828 TmpFile.close()\r
1829 if File.Ext.upper() == '.PNG':\r
1830 TempBuffer = pack('B', EFI_HII_IIBT_IMAGE_PNG)\r
1831 TempBuffer += pack('I', len(Buffer))\r
1832 TempBuffer += Buffer\r
1833 elif File.Ext.upper() == '.JPG':\r
1834 ImageType, = struct.unpack('4s', Buffer[6:10])\r
1835 if ImageType != 'JFIF':\r
1836 EdkLogger.error("build", FILE_TYPE_MISMATCH, "The file %s is not a standard JPG file." % File.Path)\r
1837 TempBuffer = pack('B', EFI_HII_IIBT_IMAGE_JPEG)\r
1838 TempBuffer += pack('I', len(Buffer))\r
1839 TempBuffer += Buffer\r
1840 elif File.Ext.upper() == '.BMP':\r
1841 TempBuffer, TempPalette = BmpImageDecoder(File, Buffer, PaletteIndex, FileObj.TransParent)\r
1842 if len(TempPalette) > 1:\r
1843 PaletteIndex += 1\r
e148e6e9
YZ
1844 NewPalette = pack('H', len(TempPalette))\r
1845 NewPalette += TempPalette\r
1846 PaletteBuffer += NewPalette\r
333ba578 1847 PaletteStr = WriteLine(PaletteStr, '// %s: %s: %s' % (DecToHexStr(PaletteIndex - 1, 4), ID, DecToHexStr(PaletteIndex - 1, 4)))\r
e148e6e9 1848 TempPaletteList = AscToHexList(NewPalette)\r
333ba578
YZ
1849 PaletteStr = WriteLine(PaletteStr, CreateArrayItem(TempPaletteList, 16) + '\n')\r
1850 ImageBuffer += TempBuffer\r
1851 BufferStr = WriteLine(BufferStr, '// %s: %s: %s' % (DecToHexStr(Index, 4), ID, DecToHexStr(Index, 4)))\r
1852 TempBufferList = AscToHexList(TempBuffer)\r
1853 BufferStr = WriteLine(BufferStr, CreateArrayItem(TempBufferList, 16) + '\n')\r
1854\r
1855 StringH.Append(Line)\r
1856 Index += 1\r
1857\r
1858 BufferStr = WriteLine(BufferStr, '// End of the Image Info')\r
1859 BufferStr = WriteLine(BufferStr, CreateArrayItem(DecToHexList(EFI_HII_IIBT_END, 2)) + '\n')\r
1860 ImageEnd = pack('B', EFI_HII_IIBT_END)\r
1861 ImageBuffer += ImageEnd\r
1862\r
1863 if len(ImageBuffer) > 1:\r
1864 ImageInfoOffset = 12\r
1865 if len(PaletteBuffer) > 1:\r
1866 PaletteInfoOffset = 12 + len(ImageBuffer) - 1 # -1 is for the first empty pad byte of ImageBuffer\r
1867\r
1868 IMAGE_PACKAGE_HDR = pack('=II', ImageInfoOffset, PaletteInfoOffset)\r
1869 # PACKAGE_HEADER_Length = PACKAGE_HEADER + ImageInfoOffset + PaletteInfoOffset + ImageBuffer Length + PaletteCount + PaletteBuffer Length\r
1870 if len(PaletteBuffer) > 1:\r
1871 PACKAGE_HEADER_Length = 4 + 4 + 4 + len(ImageBuffer) - 1 + 2 + len(PaletteBuffer) - 1\r
1872 else:\r
1873 PACKAGE_HEADER_Length = 4 + 4 + 4 + len(ImageBuffer) - 1\r
1874 if PaletteIndex > 1:\r
1875 PALETTE_INFO_HEADER = pack('H', PaletteIndex - 1)\r
1876 # EFI_HII_PACKAGE_HEADER length max value is 0xFFFFFF\r
1877 Hex_Length = '%06X' % PACKAGE_HEADER_Length\r
1878 if PACKAGE_HEADER_Length > 0xFFFFFF:\r
1879 EdkLogger.error("build", AUTOGEN_ERROR, "The Length of EFI_HII_PACKAGE_HEADER exceed its maximum value", ExtraData="[%s]" % str(Info))\r
1880 PACKAGE_HEADER = pack('=HBB', int('0x' + Hex_Length[2:], 16), int('0x' + Hex_Length[0:2], 16), EFI_HII_PACKAGE_IMAGES)\r
1881\r
1882 IdfGenBinBuffer.write(PACKAGE_HEADER)\r
1883 IdfGenBinBuffer.write(IMAGE_PACKAGE_HDR)\r
1884 if len(ImageBuffer) > 1 :\r
1885 IdfGenBinBuffer.write(ImageBuffer[1:])\r
1886 if PaletteIndex > 1:\r
1887 IdfGenBinBuffer.write(PALETTE_INFO_HEADER)\r
1888 if len(PaletteBuffer) > 1:\r
1889 IdfGenBinBuffer.write(PaletteBuffer[1:])\r
1890\r
1891 if IdfGenCFlag:\r
1892 TotalLength = EFI_HII_ARRAY_SIZE_LENGTH + PACKAGE_HEADER_Length\r
1893 AutoGenC.Append("\n//\n//Image Pack Definition\n//\n")\r
1894 AllStr = WriteLine('', CHAR_ARRAY_DEFIN + ' ' + Info.Module.BaseName + 'Images' + '[] = {\n')\r
1895 AllStr = WriteLine(AllStr, '// STRGATHER_OUTPUT_HEADER')\r
1896 AllStr = WriteLine(AllStr, CreateArrayItem(DecToHexList(TotalLength)) + '\n')\r
1897 AllStr = WriteLine(AllStr, '// Image PACKAGE HEADER\n')\r
1898 IMAGE_PACKAGE_HDR_List = AscToHexList(PACKAGE_HEADER)\r
1899 IMAGE_PACKAGE_HDR_List += AscToHexList(IMAGE_PACKAGE_HDR)\r
1900 AllStr = WriteLine(AllStr, CreateArrayItem(IMAGE_PACKAGE_HDR_List, 16) + '\n')\r
1901 AllStr = WriteLine(AllStr, '// Image DATA\n')\r
1902 if BufferStr:\r
1903 AllStr = WriteLine(AllStr, BufferStr)\r
1904 if PaletteStr:\r
1905 AllStr = WriteLine(AllStr, '// Palette Header\n')\r
1906 PALETTE_INFO_HEADER_List = AscToHexList(PALETTE_INFO_HEADER)\r
1907 AllStr = WriteLine(AllStr, CreateArrayItem(PALETTE_INFO_HEADER_List, 16) + '\n')\r
1908 AllStr = WriteLine(AllStr, '// Palette Data\n')\r
1909 AllStr = WriteLine(AllStr, PaletteStr)\r
1910 AllStr = WriteLine(AllStr, '};')\r
1911 AutoGenC.Append(AllStr)\r
1912 AutoGenC.Append("\n")\r
1913 StringH.Append('\nextern unsigned char ' + Info.Module.BaseName + 'Images[];\n')\r
1914 StringH.Append("\n#define IMAGE_ARRAY_NAME %sImages\n" % Info.Module.BaseName)\r
1915\r
1916# typedef struct _EFI_HII_IMAGE_PACKAGE_HDR {\r
1917# EFI_HII_PACKAGE_HEADER Header; # Standard package header, where Header.Type = EFI_HII_PACKAGE_IMAGES\r
1918# UINT32 ImageInfoOffset;\r
1919# UINT32 PaletteInfoOffset;\r
1920# } EFI_HII_IMAGE_PACKAGE_HDR;\r
1921\r
1922# typedef struct {\r
1923# UINT32 Length:24;\r
1924# UINT32 Type:8;\r
1925# UINT8 Data[];\r
1926# } EFI_HII_PACKAGE_HEADER;\r
1927\r
1928# typedef struct _EFI_HII_IMAGE_BLOCK {\r
1929# UINT8 BlockType;\r
1930# UINT8 BlockBody[];\r
1931# } EFI_HII_IMAGE_BLOCK;\r
1932\r
1933def BmpImageDecoder(File, Buffer, PaletteIndex, TransParent):\r
1934 ImageType, = struct.unpack('2s', Buffer[0:2])\r
1935 if ImageType!= 'BM': # BMP file type is 'BM'\r
1936 EdkLogger.error("build", FILE_TYPE_MISMATCH, "The file %s is not a standard BMP file." % File.Path)\r
1937 BMP_IMAGE_HEADER = collections.namedtuple('BMP_IMAGE_HEADER', ['bfSize','bfReserved1','bfReserved2','bfOffBits','biSize','biWidth','biHeight','biPlanes','biBitCount', 'biCompression', 'biSizeImage','biXPelsPerMeter','biYPelsPerMeter','biClrUsed','biClrImportant'])\r
1938 BMP_IMAGE_HEADER_STRUCT = struct.Struct('IHHIIIIHHIIIIII')\r
1939 BmpHeader = BMP_IMAGE_HEADER._make(BMP_IMAGE_HEADER_STRUCT.unpack_from(Buffer[2:]))\r
1940 #\r
1941 # Doesn't support compress.\r
1942 #\r
1943 if BmpHeader.biCompression != 0:\r
1944 EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "The compress BMP file %s is not support." % File.Path)\r
1945\r
1946 # The Width and Height is UINT16 type in Image Package\r
1947 if BmpHeader.biWidth > 0xFFFF:\r
1948 EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "The BMP file %s Width is exceed 0xFFFF." % File.Path)\r
1949 if BmpHeader.biHeight > 0xFFFF:\r
1950 EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "The BMP file %s Height is exceed 0xFFFF." % File.Path)\r
1951\r
1952 PaletteBuffer = pack('x')\r
1953 if BmpHeader.biBitCount == 1:\r
1954 if TransParent:\r
1955 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_1BIT_TRANS)\r
1956 else:\r
1957 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_1BIT)\r
1958 ImageBuffer += pack('B', PaletteIndex)\r
1959 Width = (BmpHeader.biWidth + 7)/8\r
1960 if BmpHeader.bfOffBits > BMP_IMAGE_HEADER_STRUCT.size + 2:\r
1961 PaletteBuffer = Buffer[BMP_IMAGE_HEADER_STRUCT.size + 2 : BmpHeader.bfOffBits]\r
1962 elif BmpHeader.biBitCount == 4:\r
1963 if TransParent:\r
1964 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_4BIT_TRANS)\r
1965 else:\r
1966 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_4BIT)\r
1967 ImageBuffer += pack('B', PaletteIndex)\r
1968 Width = (BmpHeader.biWidth + 1)/2\r
1969 if BmpHeader.bfOffBits > BMP_IMAGE_HEADER_STRUCT.size + 2:\r
1970 PaletteBuffer = Buffer[BMP_IMAGE_HEADER_STRUCT.size + 2 : BmpHeader.bfOffBits]\r
1971 elif BmpHeader.biBitCount == 8:\r
1972 if TransParent:\r
1973 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_8BIT_TRANS)\r
1974 else:\r
1975 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_8BIT)\r
1976 ImageBuffer += pack('B', PaletteIndex)\r
1977 Width = BmpHeader.biWidth\r
1978 if BmpHeader.bfOffBits > BMP_IMAGE_HEADER_STRUCT.size + 2:\r
1979 PaletteBuffer = Buffer[BMP_IMAGE_HEADER_STRUCT.size + 2 : BmpHeader.bfOffBits]\r
1980 elif BmpHeader.biBitCount == 24:\r
1981 if TransParent:\r
1982 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_24BIT_TRANS)\r
1983 else:\r
1984 ImageBuffer = pack('B', EFI_HII_IIBT_IMAGE_24BIT)\r
1985 Width = BmpHeader.biWidth * 3\r
1986 else:\r
1987 EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "Only support the 1 bit, 4 bit, 8bit, 24 bit BMP files.", ExtraData="[%s]" % str(File.Path))\r
1988\r
1989 ImageBuffer += pack('H', BmpHeader.biWidth)\r
1990 ImageBuffer += pack('H', BmpHeader.biHeight)\r
1991 Start = BmpHeader.bfOffBits\r
1992 End = BmpHeader.bfSize - 1\r
1993 for Height in range(0, BmpHeader.biHeight):\r
1994 if Width % 4 != 0:\r
1995 Start = End + (Width % 4) - 4 - Width\r
1996 else:\r
1997 Start = End - Width\r
1998 ImageBuffer += Buffer[Start + 1 : Start + Width + 1]\r
1999 End = Start\r
2000\r
2001 # 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\r
2002 if PaletteBuffer and len(PaletteBuffer) > 1:\r
2003 PaletteTemp = pack('x')\r
2004 for Index in range(0, len(PaletteBuffer)):\r
2005 if Index % 4 == 3:\r
2006 continue\r
2007 PaletteTemp += PaletteBuffer[Index]\r
2008 PaletteBuffer = PaletteTemp[1:]\r
2009 return ImageBuffer, PaletteBuffer\r
2010\r
f51461c8
LG
2011## Create common code\r
2012#\r
2013# @param Info The ModuleAutoGen object\r
2014# @param AutoGenC The TemplateString object for C code\r
2015# @param AutoGenH The TemplateString object for header file\r
2016#\r
2017def CreateHeaderCode(Info, AutoGenC, AutoGenH):\r
2018 # file header\r
2019 AutoGenH.Append(gAutoGenHeaderString.Replace({'FileName':'AutoGen.h'}))\r
2020 # header file Prologue\r
2021 AutoGenH.Append(gAutoGenHPrologueString.Replace({'File':'AUTOGENH','Guid':Info.Guid.replace('-','_')}))\r
2022 AutoGenH.Append(gAutoGenHCppPrologueString)\r
2023 if Info.AutoGenVersion >= 0x00010005:\r
2024 # header files includes\r
2025 AutoGenH.Append("#include <%s>\n" % gBasicHeaderFile)\r
2026 if Info.ModuleType in gModuleTypeHeaderFile \\r
2027 and gModuleTypeHeaderFile[Info.ModuleType][0] != gBasicHeaderFile:\r
2028 AutoGenH.Append("#include <%s>\n" % gModuleTypeHeaderFile[Info.ModuleType][0])\r
2029 #\r
2030 # if either PcdLib in [LibraryClasses] sections or there exist Pcd section, add PcdLib.h \r
2031 # As if modules only uses FixedPcd, then PcdLib is not needed in [LibraryClasses] section.\r
2032 #\r
2033 if 'PcdLib' in Info.Module.LibraryClasses or Info.Module.Pcds:\r
2034 AutoGenH.Append("#include <Library/PcdLib.h>\n")\r
2035\r
2036 AutoGenH.Append('\nextern GUID gEfiCallerIdGuid;')\r
2037 AutoGenH.Append('\nextern CHAR8 *gEfiCallerBaseName;\n\n')\r
2038\r
2039 if Info.IsLibrary:\r
2040 return\r
2041\r
2042 AutoGenH.Append("#define EFI_CALLER_ID_GUID \\\n %s\n" % GuidStringToGuidStructureString(Info.Guid))\r
2043\r
2044 if Info.IsLibrary:\r
2045 return\r
2046 # C file header\r
2047 AutoGenC.Append(gAutoGenHeaderString.Replace({'FileName':'AutoGen.c'}))\r
2048 if Info.AutoGenVersion >= 0x00010005:\r
2049 # C file header files includes\r
2050 if Info.ModuleType in gModuleTypeHeaderFile:\r
2051 for Inc in gModuleTypeHeaderFile[Info.ModuleType]:\r
2052 AutoGenC.Append("#include <%s>\n" % Inc)\r
2053 else:\r
2054 AutoGenC.Append("#include <%s>\n" % gBasicHeaderFile)\r
2055\r
2056 #\r
2057 # Publish the CallerId Guid\r
2058 #\r
2059 AutoGenC.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = %s;\n' % GuidStringToGuidStructureString(Info.Guid))\r
2060 AutoGenC.Append('\nGLOBAL_REMOVE_IF_UNREFERENCED CHAR8 *gEfiCallerBaseName = "%s";\n' % Info.Name)\r
2061\r
2062## Create common code for header file\r
2063#\r
2064# @param Info The ModuleAutoGen object\r
2065# @param AutoGenC The TemplateString object for C code\r
2066# @param AutoGenH The TemplateString object for header file\r
2067#\r
2068def CreateFooterCode(Info, AutoGenC, AutoGenH):\r
2069 AutoGenH.Append(gAutoGenHEpilogueString)\r
2070\r
2071## Create code for a module\r
2072#\r
2073# @param Info The ModuleAutoGen object\r
2074# @param AutoGenC The TemplateString object for C code\r
2075# @param AutoGenH The TemplateString object for header file\r
333ba578 2076# @param StringH The TemplateString object for header file\r
f51461c8
LG
2077# @param UniGenCFlag UniString is generated into AutoGen C file when it is set to True\r
2078# @param UniGenBinBuffer Buffer to store uni string package data\r
333ba578
YZ
2079# @param StringIdf The TemplateString object for header file\r
2080# @param IdfGenCFlag IdfString is generated into AutoGen C file when it is set to True\r
2081# @param IdfGenBinBuffer Buffer to store Idf string package data\r
f51461c8 2082#\r
333ba578 2083def CreateCode(Info, AutoGenC, AutoGenH, StringH, UniGenCFlag, UniGenBinBuffer, StringIdf, IdfGenCFlag, IdfGenBinBuffer):\r
f51461c8
LG
2084 CreateHeaderCode(Info, AutoGenC, AutoGenH)\r
2085\r
2086 if Info.AutoGenVersion >= 0x00010005:\r
2087 CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH)\r
2088 CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH)\r
2089 CreatePpiDefinitionCode(Info, AutoGenC, AutoGenH)\r
2090 CreatePcdCode(Info, AutoGenC, AutoGenH)\r
2091 CreateLibraryConstructorCode(Info, AutoGenC, AutoGenH)\r
2092 CreateLibraryDestructorCode(Info, AutoGenC, AutoGenH)\r
2093 CreateModuleEntryPointCode(Info, AutoGenC, AutoGenH)\r
2094 CreateModuleUnloadImageCode(Info, AutoGenC, AutoGenH)\r
2095\r
2096 if Info.UnicodeFileList:\r
2097 FileName = "%sStrDefs.h" % Info.Name\r
2098 StringH.Append(gAutoGenHeaderString.Replace({'FileName':FileName}))\r
2099 StringH.Append(gAutoGenHPrologueString.Replace({'File':'STRDEFS', 'Guid':Info.Guid.replace('-','_')}))\r
2100 CreateUnicodeStringCode(Info, AutoGenC, StringH, UniGenCFlag, UniGenBinBuffer)\r
8200fcfe
YL
2101\r
2102 GuidMacros = []\r
2103 for Guid in Info.Module.Guids:\r
2104 if Guid in Info.Module.GetGuidsUsedByPcd():\r
2105 continue\r
2106 GuidMacros.append('#define %s %s' % (Guid, Info.Module.Guids[Guid]))\r
2107 for Guid, Value in Info.Module.Protocols.items() + Info.Module.Ppis.items():\r
2108 GuidMacros.append('#define %s %s' % (Guid, Value))\r
5b97eb4c
YZ
2109 # supports FixedAtBuild usage in VFR file\r
2110 if Info.VfrFileList and Info.ModulePcdList:\r
2111 GuidMacros.append('#define %s %s' % ('FixedPcdGetBool(TokenName)', '_PCD_VALUE_##TokenName'))\r
2112 GuidMacros.append('#define %s %s' % ('FixedPcdGet8(TokenName)', '_PCD_VALUE_##TokenName'))\r
2113 GuidMacros.append('#define %s %s' % ('FixedPcdGet16(TokenName)', '_PCD_VALUE_##TokenName'))\r
2114 GuidMacros.append('#define %s %s' % ('FixedPcdGet32(TokenName)', '_PCD_VALUE_##TokenName'))\r
2115 GuidMacros.append('#define %s %s' % ('FixedPcdGet64(TokenName)', '_PCD_VALUE_##TokenName'))\r
2116 for Pcd in Info.ModulePcdList:\r
2117 if Pcd.Type == TAB_PCDS_FIXED_AT_BUILD:\r
2118 TokenCName = Pcd.TokenCName\r
2119 Value = Pcd.DefaultValue\r
2120 if Pcd.DatumType == 'BOOLEAN':\r
2121 BoolValue = Value.upper()\r
2122 if BoolValue == 'TRUE':\r
2123 Value = '1'\r
2124 elif BoolValue == 'FALSE':\r
2125 Value = '0'\r
2126 for PcdItem in GlobalData.MixedPcd:\r
2127 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
2128 TokenCName = PcdItem[0]\r
2129 break\r
2130 GuidMacros.append('#define %s %s' % ('_PCD_VALUE_'+TokenCName, Value))\r
2131\r
bc7d95c0
YZ
2132 if Info.IdfFileList:\r
2133 GuidMacros.append('#include "%sImgDefs.h"' % Info.Name)\r
2134\r
8200fcfe
YL
2135 if GuidMacros:\r
2136 StringH.Append('\n#ifdef VFRCOMPILE\n%s\n#endif\n' % '\n'.join(GuidMacros))\r
2137\r
f51461c8
LG
2138 StringH.Append("\n#endif\n")\r
2139 AutoGenH.Append('#include "%s"\n' % FileName)\r
2140\r
333ba578
YZ
2141 if Info.IdfFileList:\r
2142 FileName = "%sImgDefs.h" % Info.Name\r
2143 StringIdf.Append(gAutoGenHeaderString.Replace({'FileName':FileName}))\r
2144 StringIdf.Append(gAutoGenHPrologueString.Replace({'File':'IMAGEDEFS', 'Guid':Info.Guid.replace('-','_')}))\r
2145 CreateIdfFileCode(Info, AutoGenC, StringIdf, IdfGenCFlag, IdfGenBinBuffer)\r
2146\r
2147 StringIdf.Append("\n#endif\n")\r
2148 AutoGenH.Append('#include "%s"\n' % FileName)\r
2149\r
f51461c8
LG
2150 CreateFooterCode(Info, AutoGenC, AutoGenH)\r
2151\r
2152 # no generation of AutoGen.c for Edk modules without unicode file\r
2153 if Info.AutoGenVersion < 0x00010005 and len(Info.UnicodeFileList) == 0:\r
2154 AutoGenC.String = ''\r
2155\r
2156## Create the code file\r
2157#\r
2158# @param FilePath The path of code file\r
2159# @param Content The content of code file\r
2160# @param IsBinaryFile The flag indicating if the file is binary file or not\r
2161#\r
2162# @retval True If file content is changed or file doesn't exist\r
2163# @retval False If the file exists and the content is not changed\r
2164#\r
2165def Generate(FilePath, Content, IsBinaryFile):\r
2166 return SaveFileOnChange(FilePath, Content, IsBinaryFile)\r
2167\r