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