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