]> git.proxmox.com Git - mirror_edk2.git/blame_incremental - BaseTools/Source/Python/AutoGen/GenC.py
BaseTools: Fix the bug for VOID* pcd max size from component section
[mirror_edk2.git] / BaseTools / Source / Python / AutoGen / GenC.py
... / ...
CommitLineData
1## @file\r
2# Routines for generating AutoGen.h and AutoGen.c\r
3#\r
4# Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
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
17import collections\r
18import struct\r
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
27from IdfClassObject import *\r
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
44_NumericDataTypesList = ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN']\r
45\r
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
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
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
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
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
705\r
706'MM' : TemplateString("""${BEGIN}\r
707 Status = ${Function} (ImageHandle, MmSystemTable);\r
708 ASSERT_EFI_ERROR (Status);${END}\r
709"""),\r
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
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
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
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
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
804 # Even it is the Library, the PCD is saved in the ModulePcdList\r
805 PcdList = Info.ModulePcdList\r
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
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
828 if Pcd.TokenCName == TokenCName:\r
829 Index = Index + 1\r
830 if Index == 1:\r
831 AutoGenH.Append('\n#define __PCD_%s_ADDR_CMP(GuidPtr) (' % (RealTokenCName))\r
832 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
833 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
834 else:\r
835 AutoGenH.Append('\\\n (GuidPtr == &%s) ? _PCD_TOKEN_%s_%s:' \r
836 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
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
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
853 if Pcd.Type in gDynamicExPcd and Pcd.TokenCName == TokenCName:\r
854 Index = Index + 1\r
855 if Index == 1:\r
856 AutoGenH.Append('\n#define __PCD_%s_VAL_CMP(GuidPtr) (' % (RealTokenCName))\r
857 AutoGenH.Append('\\\n (GuidPtr == NULL) ? 0:')\r
858 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
859 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
860 else:\r
861 AutoGenH.Append('\\\n COMPAREGUID (GuidPtr, &%s) ? _PCD_TOKEN_%s_%s:' \r
862 % (Pcd.TokenSpaceGuidCName, Pcd.TokenSpaceGuidCName, RealTokenCName))\r
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
870 % (RealTokenCName, RealTokenCName, RealTokenCName, RealTokenCName))\r
871 TokenCNameList.append(TokenCName)\r
872\r
873def GetPcdSize(Pcd):\r
874 if Pcd.DatumType not in _NumericDataTypesList:\r
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
894 else:\r
895 return Pcd.MaxDatumSize\r
896\r
897\r
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
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
919 PatchPcdMaxSizeVariable = '_gPcd_BinaryPatch_MaxSize_' + TokenCName\r
920 FixPcdSizeTokenName = '_PCD_SIZE_' + TokenCName\r
921 FixedPcdSizeVariableName = '_gPcd_FixedAtBuild_Size_' + TokenCName\r
922\r
923 if Pcd.PcdValueFromComm:\r
924 Pcd.DefaultValue = Pcd.PcdValueFromComm\r
925 \r
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
930 PcdExTokenName = '_PCD_TOKEN_' + Pcd.TokenSpaceGuidCName + '_' + TokenCName\r
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
946 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
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
952 EdkLogger.debug(EdkLogger.DEBUG_3, "Creating code for " + TokenCName + "." + Pcd.TokenSpaceGuidCName)\r
953 if Pcd.Type not in gItemTypeStringDatabase:\r
954 EdkLogger.error("build", AUTOGEN_ERROR,\r
955 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, TokenCName),\r
956 ExtraData="[%s]" % str(Info))\r
957\r
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
963 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + TokenCName\r
964 \r
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
981 AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
982 if Pcd.DatumType not in _NumericDataTypesList:\r
983 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
984 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
985 else:\r
986 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
987 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
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
991 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
992 if Pcd.DatumType not in _NumericDataTypesList:\r
993 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
994 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
995 else:\r
996 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
997 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
998 elif Pcd.Type in gDynamicPcd:\r
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
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
1008 else:\r
1009 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
1010 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
1011 if Pcd.DatumType not in _NumericDataTypesList:\r
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
1017 else:\r
1018 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + TokenCName\r
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
1037 if Value.upper().endswith('L'):\r
1038 Value = Value[:-1]\r
1039 ValueNumber = int (Value, 0)\r
1040 except:\r
1041 EdkLogger.error("build", AUTOGEN_ERROR,\r
1042 "PCD value is not valid dec or hex number for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1043 ExtraData="[%s]" % str(Info))\r
1044 if Pcd.DatumType == 'UINT64':\r
1045 if ValueNumber < 0:\r
1046 EdkLogger.error("build", AUTOGEN_ERROR,\r
1047 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1048 ExtraData="[%s]" % str(Info))\r
1049 elif ValueNumber >= 0x10000000000000000:\r
1050 EdkLogger.error("build", AUTOGEN_ERROR,\r
1051 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
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
1058 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1059 ExtraData="[%s]" % str(Info))\r
1060 elif ValueNumber >= 0x100000000:\r
1061 EdkLogger.error("build", AUTOGEN_ERROR,\r
1062 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
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
1069 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1070 ExtraData="[%s]" % str(Info))\r
1071 elif ValueNumber >= 0x10000:\r
1072 EdkLogger.error("build", AUTOGEN_ERROR,\r
1073 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
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
1080 "PCD can't be set to negative value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1081 ExtraData="[%s]" % str(Info))\r
1082 elif ValueNumber >= 0x100:\r
1083 EdkLogger.error("build", AUTOGEN_ERROR,\r
1084 "Too large PCD value for datum type [%s] of PCD %s.%s" % (Pcd.DatumType, Pcd.TokenSpaceGuidCName, TokenCName),\r
1085 ExtraData="[%s]" % str(Info))\r
1086 if not Value.endswith('U'):\r
1087 Value += 'U'\r
1088 if Pcd.DatumType not in _NumericDataTypesList:\r
1089 if Pcd.MaxDatumSize is None or Pcd.MaxDatumSize == '':\r
1090 EdkLogger.error("build", AUTOGEN_ERROR,\r
1091 "Unknown [MaxDatumSize] of PCD [%s.%s]" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
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
1112 if Pcd.MaxSizeUserSet:\r
1113 EdkLogger.error("build", AUTOGEN_ERROR,\r
1114 "The maximum size of VOID* type PCD '%s.%s' is less than its actual size occupied." % (Pcd.TokenSpaceGuidCName, TokenCName),\r
1115 ExtraData="[%s]" % str(Info))\r
1116 else:\r
1117 ArraySize = GetPcdSize(Pcd)\r
1118 if Unicode:\r
1119 ArraySize = ArraySize / 2\r
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
1126 elif Pcd.Type != TAB_PCDS_FIXED_AT_BUILD and Pcd.DatumType in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:\r
1127 Value = "((%s)%s)" % (Pcd.DatumType, Value)\r
1128\r
1129 if Pcd.DatumType not in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:\r
1130 # handle structure PCD\r
1131 if Pcd.MaxDatumSize is None or Pcd.MaxDatumSize == '':\r
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
1139 if Pcd.Type == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1140 PcdValueName = '_PCD_PATCHABLE_VALUE_' + TokenCName\r
1141 else:\r
1142 PcdValueName = '_PCD_VALUE_' + TokenCName\r
1143 \r
1144 if Pcd.DatumType not in _NumericDataTypesList:\r
1145 #\r
1146 # For unicode, UINT16 array will be generated, so the alignment of unicode is guaranteed.\r
1147 #\r
1148 AutoGenH.Append('#define %s %s%s\n' %(PcdValueName, Type, PcdVariableName))\r
1149 if Unicode:\r
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
1152 else:\r
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
1155 AutoGenH.Append('#define %s %s%s\n' %(GetModeName, Type, PcdVariableName))\r
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
1161 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (FixedPcdSizeVariableName,PcdDataSize))\r
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
1167 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED const UINTN %s = %s;\n' % (PatchPcdMaxSizeVariable,Pcd.MaxDatumSize))\r
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
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
1180 else:\r
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
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
1191 if Pcd.DatumType not in _NumericDataTypesList:\r
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
1194 else:\r
1195 AutoGenH.Append('#define %s(Value) (%s = (Value))\n' % (SetModeName, PcdVariableName))\r
1196 AutoGenH.Append('#define %s(Value) ((%s = (Value)), RETURN_SUCCESS) \n' % (SetModeStatusName, PcdVariableName))\r
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
1211 for PcdItem in GlobalData.MixedPcd:\r
1212 if (TokenCName, TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdItem]:\r
1213 TokenCName = PcdItem[0]\r
1214 break\r
1215 PcdTokenName = '_PCD_TOKEN_' + TokenCName\r
1216 FixPcdSizeTokenName = '_PCD_SIZE_' + TokenCName\r
1217 PatchPcdSizeTokenName = '_PCD_PATCHABLE_' + TokenCName +'_SIZE'\r
1218 PatchPcdSizeVariableName = '_gPcd_BinaryPatch_Size_' + TokenCName\r
1219 PatchPcdMaxSizeVariable = '_gPcd_BinaryPatch_MaxSize_' + TokenCName\r
1220 FixedPcdSizeVariableName = '_gPcd_FixedAtBuild_Size_' + TokenCName\r
1221\r
1222 if Pcd.PcdValueFromComm:\r
1223 Pcd.DefaultValue = Pcd.PcdValueFromComm\r
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
1243 "No generated token number for %s.%s\n" % (Pcd.TokenSpaceGuidCName, TokenCName),\r
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
1250 "Unknown PCD type [%s] of PCD %s.%s" % (Pcd.Type, Pcd.TokenSpaceGuidCName, TokenCName),\r
1251 ExtraData="[%s]" % str(Info))\r
1252\r
1253 DatumType = Pcd.DatumType\r
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
1259 GetModeSizeName = '_PCD_GET_MODE_SIZE' + '_' + TokenCName\r
1260\r
1261 Type = ''\r
1262 Array = ''\r
1263 if Pcd.DatumType not in _NumericDataTypesList:\r
1264 if Pcd.DefaultValue[0]== '{':\r
1265 Type = '(VOID *)'\r
1266 Array = '[]'\r
1267 PcdItemType = Pcd.Type\r
1268 PcdExCNameList = []\r
1269 if PcdItemType in gDynamicExPcd:\r
1270 PcdExTokenName = '_PCD_TOKEN_' + TokenSpaceGuidCName + '_' + TokenCName\r
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
1287 AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1288 if Pcd.DatumType not in _NumericDataTypesList:\r
1289 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1290 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1291 else:\r
1292 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1293 AutoGenH.Append('// #define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
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
1297 AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1298 if Pcd.DatumType not in _NumericDataTypesList:\r
1299 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1300 AutoGenH.Append('#define %s(SizeOfBuffer, Buffer) LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1301 else:\r
1302 AutoGenH.Append('#define %s(Value) LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1303 AutoGenH.Append('#define %s(Value) LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))\r
1304 else:\r
1305 AutoGenH.Append('#define _PCD_TOKEN_%s %dU\n' % (TokenCName, TokenNumber))\r
1306 if PcdItemType in gDynamicPcd:\r
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
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
1316 else:\r
1317 AutoGenH.Append('#define %s LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))\r
1318 AutoGenH.Append('#define %s LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))\r
1319 if DatumType not in _NumericDataTypesList:\r
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
1325 if PcdItemType == TAB_PCDS_PATCHABLE_IN_MODULE:\r
1326 GetModeMaxSizeName = '_PCD_GET_MODE_MAXSIZE' + '_' + TokenCName\r
1327 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[TAB_PCDS_PATCHABLE_IN_MODULE] + '_' + TokenCName\r
1328 if DatumType not in _NumericDataTypesList:\r
1329 if DatumType == 'VOID*' and Array == '[]':\r
1330 DatumType = ['UINT8', 'UINT16'][Pcd.DefaultValue[0] == 'L']\r
1331 else:\r
1332 DatumType = 'UINT8'\r
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
1336 AutoGenH.Append('#define %s %s_gPcd_BinaryPatch_%s\n' %(GetModeName, Type, TokenCName))\r
1337 PcdDataSize = GetPcdSize(Pcd)\r
1338 if Pcd.DatumType not in _NumericDataTypesList:\r
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
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
1346 AutoGenH.Append('#define %s %s\n' % (PatchPcdSizeTokenName, PcdDataSize))\r
1347\r
1348 AutoGenH.Append('#define %s %s\n' % (GetModeSizeName,PatchPcdSizeVariableName))\r
1349 AutoGenH.Append('extern UINTN %s; \n' % PatchPcdSizeVariableName)\r
1350 \r
1351 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD or PcdItemType == TAB_PCDS_FEATURE_FLAG:\r
1352 key = ".".join((Pcd.TokenSpaceGuidCName,Pcd.TokenCName))\r
1353 PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + TokenCName\r
1354 if DatumType == 'VOID*' and Array == '[]':\r
1355 DatumType = ['UINT8', 'UINT16'][Pcd.DefaultValue[0] == 'L']\r
1356 if DatumType not in ['UINT8', 'UINT16', 'UINT32', 'UINT64', 'BOOLEAN', 'VOID*']:\r
1357 DatumType = 'UINT8'\r
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
1362 ConstFixedPcd = False\r
1363 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD and (key in Info.ConstPcd or (Info.IsLibrary and not Info._ReferenceModules)):\r
1364 ConstFixedPcd = True\r
1365 if key in Info.ConstPcd:\r
1366 Pcd.DefaultValue = Info.ConstPcd[key]\r
1367 if Pcd.DatumType not in _NumericDataTypesList:\r
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
1371 PcdDataSize = GetPcdSize(Pcd)\r
1372 if PcdItemType == TAB_PCDS_FIXED_AT_BUILD:\r
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
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
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
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
1443 elif Info.ModuleType in ['MM_STANDALONE','MM_CORE_STANDALONE']:\r
1444 AutoGenC.Append(gLibraryString['MM'].Replace(Dict))\r
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
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
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
1505 elif Info.ModuleType in ['MM_STANDALONE','MM_CORE_STANDALONE']:\r
1506 AutoGenC.Append(gLibraryString['MM'].Replace(Dict))\r
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
1536 if Info.ModuleType in ['PEI_CORE', 'DXE_CORE', 'SMM_CORE', 'MM_CORE_STANDALONE']:\r
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
1555 elif Info.ModuleType == 'MM_CORE_STANDALONE':\r
1556 AutoGenC.Append(gMmCoreStandaloneEntryPointString.Replace(Dict))\r
1557 AutoGenH.Append(gMmCoreStandaloneEntryPointPrototype.Replace(Dict))\r
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
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
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
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
1622 if not Info.IsLibrary:\r
1623 AutoGenC.Append("\n// Guids\n")\r
1624 AutoGenH.Append("\n// Guids\n")\r
1625 #\r
1626 # GUIDs\r
1627 #\r
1628 for Key in Info.GuidList:\r
1629 if not Info.IsLibrary:\r
1630 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.GuidList[Key]))\r
1631 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
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
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
1646 if not Info.IsLibrary:\r
1647 AutoGenC.Append("\n// Protocols\n")\r
1648 AutoGenH.Append("\n// Protocols\n")\r
1649 #\r
1650 # Protocol GUIDs\r
1651 #\r
1652 for Key in Info.ProtocolList:\r
1653 if not Info.IsLibrary:\r
1654 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.ProtocolList[Key]))\r
1655 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
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
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
1670 if not Info.IsLibrary:\r
1671 AutoGenC.Append("\n// PPIs\n")\r
1672 AutoGenH.Append("\n// PPIs\n")\r
1673 #\r
1674 # PPI GUIDs\r
1675 #\r
1676 for Key in Info.PpiList:\r
1677 if not Info.IsLibrary:\r
1678 AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.PpiList[Key]))\r
1679 AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))\r
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
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
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
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
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
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
1814 FileDict = {}\r
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
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
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
1870 NewPalette = pack('H', len(TempPalette))\r
1871 NewPalette += TempPalette\r
1872 PaletteBuffer += NewPalette\r
1873 PaletteStr = WriteLine(PaletteStr, '// %s: %s: %s' % (DecToHexStr(PaletteIndex - 1, 4), ID, DecToHexStr(PaletteIndex - 1, 4)))\r
1874 TempPaletteList = AscToHexList(NewPalette)\r
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
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
2102# @param StringH The TemplateString object for header file\r
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
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
2108#\r
2109def CreateCode(Info, AutoGenC, AutoGenH, StringH, UniGenCFlag, UniGenBinBuffer, StringIdf, IdfGenCFlag, IdfGenBinBuffer):\r
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
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
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
2158 if Info.IdfFileList:\r
2159 GuidMacros.append('#include "%sImgDefs.h"' % Info.Name)\r
2160\r
2161 if GuidMacros:\r
2162 StringH.Append('\n#ifdef VFRCOMPILE\n%s\n#endif\n' % '\n'.join(GuidMacros))\r
2163\r
2164 StringH.Append("\n#endif\n")\r
2165 AutoGenH.Append('#include "%s"\n' % FileName)\r
2166\r
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
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