4 This class is to generate Autogen.h and Autogen.c according to module surface area
5 or library surface area.
7 Copyright (c) 2006, Intel Corporation
8 All rights reserved. This program and the accompanying materials
9 are licensed and made available under the terms and conditions of the BSD License
10 which accompanies this distribution. The full text of the license may be found at
11 http://opensource.org/licenses/bsd-license.php
13 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
14 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 package org
.tianocore
.build
.autogen
;
21 import java
.io
.FileInputStream
;
22 import java
.io
.FileOutputStream
;
23 import java
.io
.FileReader
;
24 import java
.io
.FileWriter
;
25 import java
.io
.IOException
;
26 import java
.util
.ArrayList
;
27 import java
.util
.HashSet
;
28 import java
.util
.Iterator
;
29 import java
.util
.LinkedHashSet
;
30 import java
.util
.LinkedList
;
31 import java
.util
.List
;
35 import org
.apache
.tools
.ant
.BuildException
;
36 import org
.apache
.xmlbeans
.XmlObject
;
37 import org
.tianocore
.build
.exception
.AutoGenException
;
38 import org
.tianocore
.build
.global
.GlobalData
;
39 import org
.tianocore
.build
.global
.SurfaceAreaQuery
;
40 import org
.tianocore
.build
.id
.ModuleIdentification
;
41 import org
.tianocore
.build
.id
.PackageIdentification
;
42 import org
.tianocore
.build
.pcd
.action
.PCDAutoGenAction
;
43 import org
.tianocore
.common
.definitions
.ToolDefinitions
;
44 import org
.tianocore
.common
.definitions
.EdkDefinitions
;
45 import org
.tianocore
.common
.exception
.EdkException
;
46 import org
.tianocore
.common
.logger
.EdkLog
;
49 This class is to generate Autogen.h and Autogen.c according to module surface
50 area or library surface area.
52 public class AutoGen
{
54 /// The output path of Autogen.h and Autogen.c
56 private String outputPath
;
59 /// The name of FV directory
64 /// The base name of module or library.
66 private ModuleIdentification moduleId
;
69 /// The build architecture
74 /// PcdAutogen instance which is used to manage how to generate the PCD
77 private PCDAutoGenAction myPcdAutogen
;
80 /// the one of type : NOT_PCD_DRIVER, PEI_PCD_DRIVER, DXE_PCD_DRIVER
82 private CommonDefinition
.PCD_DRIVER_TYPE pcdDriverType
;
85 /// The protocl list which records in module or library surface area and
86 /// it's dependence on library instance surface area.
88 private Set
<String
> mProtocolList
= new HashSet
<String
>();
91 /// The Ppi list which recorded in module or library surface area and its
92 /// dependency on library instance surface area.
94 private Set
<String
> mPpiList
= new HashSet
<String
>();
97 /// The Guid list which recoreded in module or library surface area and it's
98 /// dependence on library instance surface area.
100 private Set
<String
> mGuidList
= new HashSet
<String
>();
103 /// The dependence package list which recoreded in module or library surface
104 /// area and it's dependence on library instance surface area.
106 private List
<PackageIdentification
> mDepPkgList
= new LinkedList
<PackageIdentification
>();
109 /// For non library module, add its library instance's construct and destructor to
110 /// list. String[0] recode LibConstructor name, String[1] recode Lib instance
113 private List
<String
[]> libConstructList
= new ArrayList
<String
[]>();
114 private List
<String
[]> libDestructList
= new ArrayList
<String
[]>();
117 /// List to store SetVirtalAddressMapCallBack, ExitBootServiceCallBack
119 private List
<String
> setVirtalAddList
= new ArrayList
<String
>();
120 private List
<String
> exitBootServiceList
= new ArrayList
<String
>();
123 // flag of PcdComponentNameDisable, PcdDriverDiagnosticDisable
125 private boolean componentNamePcd
= false;
126 private boolean driverDiagnostPcd
= false;
129 // Instance of SurfaceAreaQuery
131 private SurfaceAreaQuery saq
= null;
133 private ModuleIdentification parentId
= null;
138 This function mainly initialize some member variable.
141 Absolute path of FV directory.
143 Output path of AutoGen file.
145 Module identification.
149 public AutoGen(String fvDir
, String outputPath
, ModuleIdentification moduleId
, String arch
, SurfaceAreaQuery saq
, ModuleIdentification parentId
) {
150 this.outputPath
= outputPath
;
151 this.moduleId
= moduleId
;
155 this.parentId
= parentId
;
161 This function save the content in stringBuffer to file.
166 The content of AutoGen file in buffer.
171 private boolean saveFile(String fileName
, StringBuffer fileBuffer
) {
173 File autoGenH
= new File(fileName
);
176 // if the file exists, compare their content
178 if (autoGenH
.exists()) {
179 char[] oldFileBuffer
= new char[(int) autoGenH
.length()];
181 FileReader fIn
= new FileReader(autoGenH
);
182 fIn
.read(oldFileBuffer
, 0, (int) autoGenH
.length());
184 } catch (IOException e
) {
185 EdkLog
.log(EdkLog
.EDK_INFO
, this.moduleId
.getName()
188 + " is exist, but can't be open!!");
193 // if we got the same file, don't re-generate it to prevent
194 // sources depending on it from re-building
196 if (fileBuffer
.toString().compareTo(new String(oldFileBuffer
)) == 0) {
202 FileWriter fOut
= new FileWriter(autoGenH
);
203 fOut
.write(fileBuffer
.toString());
206 } catch (IOException e
) {
207 EdkLog
.log(EdkLog
.EDK_INFO
, this.moduleId
.getName()
210 + " can't be create!!");
219 This function call libGenAutoGen or moduleGenAutogen function, which
220 dependence on generate library autogen or module autogen.
222 @throws BuildException
223 Failed to creat AutoGen.c & AutoGen.h.
225 public void genAutogen() throws EdkException
{
227 // If outputPath do not exist, create it.
229 File path
= new File(outputPath
);
233 // Check current is library or not, then call the corresponding
236 if (this.moduleId
.isLibrary()) {
244 moduleGenAutogen function
246 This function generates AutoGen.c & AutoGen.h for module.
248 @throws BuildException
249 Faile to create module AutoGen.c & AutoGen.h.
251 void moduleGenAutogen() throws EdkException
{
252 setPcdComponentName();
253 setPcdDriverDiagnostic();
254 collectLibInstanceInfo();
260 libGenAutogen function
262 This function generates AutoGen.c & AutoGen.h for library.
264 @throws BuildException
265 Faile to create library AutoGen.c & AutoGen.h
267 void libGenAutogen() throws EdkException
{
275 This function generates AutoGen.h for module.
277 @throws BuildException
278 Failed to generate AutoGen.h.
280 void moduleGenAutogenH() throws EdkException
{
282 Set
<String
> libClassIncludeH
;
284 // List<String> headerFileList;
285 List
<String
> headerFileList
;
287 StringBuffer fileBuffer
= new StringBuffer(8192);
290 // Write Autogen.h header notation
292 fileBuffer
.append(CommonDefinition
.AUTOGENHNOTATION
);
295 // Add #ifndef ${BaseName}_AUTOGENH
296 // #def ${BseeName}_AUTOGENH
298 fileBuffer
.append(CommonDefinition
.IFNDEF
299 + CommonDefinition
.AUTOGENH
300 + this.moduleId
.getGuid().replaceAll("-", "_")
301 + ToolDefinitions
.LINE_SEPARATOR
);
302 fileBuffer
.append(CommonDefinition
.DEFINE
303 + CommonDefinition
.AUTOGENH
304 + this.moduleId
.getGuid().replaceAll("-", "_")
305 + ToolDefinitions
.LINE_SEPARATOR
306 + ToolDefinitions
.LINE_SEPARATOR
);
309 // Write the specification version and release version at the begine
310 // of autogen.h file.
311 // Note: the specification version and release version should
312 // be got from module surface area instead of hard code by it's
315 moduleType
= saq
.getModuleType();
318 // Add "extern int __make_me_compile_correctly;" at begin of
321 fileBuffer
.append(CommonDefinition
.AUTOGENHBEGIN
);
324 // Put EFI_SPECIFICATION_VERSION, and EDK_RELEASE_VERSION.
326 String
[] specList
= saq
.getExternSpecificaiton();
327 for (int i
= 0; i
< specList
.length
; i
++) {
328 fileBuffer
.append(CommonDefinition
.DEFINE
+ specList
[i
]
332 // Write consumed package's mdouleInfo related .h file to autogen.h
334 // PackageIdentification[] consumedPkgIdList = SurfaceAreaQuery
335 // .getDependencePkg(this.arch);
336 PackageIdentification
[] consumedPkgIdList
= saq
.getDependencePkg(this.arch
);
337 if (consumedPkgIdList
!= null) {
338 headerFileList
= depPkgToAutogenH(consumedPkgIdList
, moduleType
);
339 item
= headerFileList
.iterator();
340 while (item
.hasNext()) {
341 fileBuffer
.append(item
.next().toString());
346 // Write library class's related *.h file to autogen.h.
348 String
[] libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSCONSUMED
,this.arch
);
349 if (libClassList
!= null) {
350 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
351 item
= libClassIncludeH
.iterator();
352 while (item
.hasNext()) {
353 fileBuffer
.append(item
.next().toString());
357 libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSPRODUCED
, this.arch
);
358 if (libClassList
!= null) {
359 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
360 item
= libClassIncludeH
.iterator();
361 while (item
.hasNext()) {
362 fileBuffer
.append(item
.next().toString());
365 fileBuffer
.append("\r\n");
368 // If is TianoR8FlashMap, copy {Fv_DIR}/FlashMap.h to
369 // {DEST_DIR_DRBUG}/FlashMap.h
371 if (saq
.isHaveTianoR8FlashMap()) {
372 fileBuffer
.append(CommonDefinition
.INCLUDE
);
373 fileBuffer
.append(" <");
374 fileBuffer
.append(CommonDefinition
.TIANOR8PLASHMAPH
+ ">\r\n");
375 copyFlashMapHToDebugDir();
378 // Write PCD autogen information to AutoGen.h.
380 if (this.myPcdAutogen
!= null) {
381 fileBuffer
.append("\r\n");
382 fileBuffer
.append(this.myPcdAutogen
.getHAutoGenString());
386 // Append the #endif at AutoGen.h
388 fileBuffer
.append("#endif\r\n");
391 // Save string buffer content in AutoGen.h.
393 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.h", fileBuffer
)) {
394 throw new AutoGenException("Failed to generate AutoGen.h !!!");
401 This function generates AutoGen.c for module.
403 @throws BuildException
404 Failed to generate AutoGen.c.
406 void moduleGenAutogenC() throws EdkException
{
408 StringBuffer fileBuffer
= new StringBuffer(8192);
410 // Write Autogen.c header notation
412 fileBuffer
.append(CommonDefinition
.AUTOGENCNOTATION
);
415 // Write #include <AutoGen.h> at beginning of AutoGen.c
417 fileBuffer
.append(CommonDefinition
.INCLUDEAUTOGENH
);
420 // Get the native MSA file infomation. Since before call autogen,
421 // the MSA native <Externs> information were overrided. So before
422 // process <Externs> it should be set the DOC as the Native MSA info.
424 Map
<String
, XmlObject
> doc
= GlobalData
.getNativeMsa(this.moduleId
);
428 // DriverBinding/ComponentName/DriverConfiguration/DriverDialog
432 ExternsDriverBindingToAutoGenC(fileBuffer
);
435 // Write DriverExitBootServicesEvent/DriverSetVirtualAddressMapEvent
438 ExternCallBackToAutoGenC(fileBuffer
);
441 // Write EntryPoint to autgoGen.c
443 String
[] entryPointList
= saq
.getModuleEntryPointArray();
444 String
[] unloadImageList
= saq
.getModuleUnloadImageArray();
445 EntryPointToAutoGen(CommonDefinition
.remDupString(entryPointList
),
446 CommonDefinition
.remDupString(unloadImageList
),
449 pcdDriverType
= saq
.getPcdDriverType();
452 // Restore the DOC which include the FPD module info.
457 // Write Guid to autogen.c
459 String guid
= CommonDefinition
.formatGuidName(saq
.getModuleGuid());
460 if (this.moduleId
.getModuleType().equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
461 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = {");
463 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiCallerIdGuid = {");
467 throw new AutoGenException("Guid value must set!\n");
471 // Formate Guid as ANSI c form.Example:
472 // {0xd2b2b828, 0x826, 0x48a7,{0xb3, 0xdf, 0x98, 0x3c, 0x0, 0x60, 0x24,
476 fileBuffer
.append(guid
);
477 fileBuffer
.append("};\r\n");
480 // Generate library instance consumed protocol, guid, ppi, pcd list.
481 // Save those to this.protocolList, this.ppiList, this.pcdList,
482 // this.guidList. Write Consumed library constructor and desconstuct to
485 LibInstanceToAutogenC(fileBuffer
);
488 // Get module dependent Package identification.
490 PackageIdentification
[] packages
= saq
.getDependencePkg(this.arch
);
491 for (int i
= 0; i
< packages
.length
; i
++) {
492 if (!this.mDepPkgList
.contains(packages
[i
])) {
493 this.mDepPkgList
.add(packages
[i
]);
499 // Write consumed ppi, guid, protocol to autogen.c
501 ProtocolGuidToAutogenC(fileBuffer
);
502 PpiGuidToAutogenC(fileBuffer
);
503 GuidGuidToAutogenC(fileBuffer
);
508 this.myPcdAutogen
= new PCDAutoGenAction(moduleId
,
515 this.myPcdAutogen
.execute();
516 if (this.myPcdAutogen
!= null) {
517 fileBuffer
.append("\r\n");
518 fileBuffer
.append(this.myPcdAutogen
.getCAutoGenString());
521 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.c", fileBuffer
)) {
522 throw new AutoGenException("Failed to generate AutoGen.c !!!");
530 This function generates AutoGen.h for library.
532 @throws BuildException
533 Failed to generate AutoGen.c.
535 void libGenAutogenH() throws EdkException
{
537 Set
<String
> libClassIncludeH
;
539 List
<String
> headerFileList
;
541 StringBuffer fileBuffer
= new StringBuffer(10240);
544 // Write Autogen.h header notation
546 fileBuffer
.append(CommonDefinition
.AUTOGENHNOTATION
);
549 // Add #ifndef ${BaseName}_AUTOGENH
550 // #def ${BseeName}_AUTOGENH
552 fileBuffer
.append(CommonDefinition
.IFNDEF
553 + CommonDefinition
.AUTOGENH
554 + this.moduleId
.getGuid().replaceAll("-", "_")
555 + ToolDefinitions
.LINE_SEPARATOR
);
556 fileBuffer
.append(CommonDefinition
.DEFINE
557 + CommonDefinition
.AUTOGENH
558 + this.moduleId
.getGuid().replaceAll("-", "_")
559 + ToolDefinitions
.LINE_SEPARATOR
560 + ToolDefinitions
.LINE_SEPARATOR
);
563 // Write EFI_SPECIFICATION_VERSION and EDK_RELEASE_VERSION
564 // to autogen.h file.
565 // Note: the specification version and release version should
566 // be get from module surface area instead of hard code.
568 fileBuffer
.append(CommonDefinition
.AUTOGENHBEGIN
);
569 String
[] specList
= saq
.getExternSpecificaiton();
570 for (int i
= 0; i
< specList
.length
; i
++) {
571 fileBuffer
.append(CommonDefinition
.DEFINE
+ specList
[i
]
574 // fileBuffer.append(CommonDefinition.autoGenHLine1);
575 // fileBuffer.append(CommonDefinition.autoGenHLine2);
578 // Write consumed package's mdouleInfo related *.h file to autogen.h.
580 moduleType
= saq
.getModuleType();
581 PackageIdentification
[] cosumedPkglist
= saq
582 .getDependencePkg(this.arch
);
583 headerFileList
= depPkgToAutogenH(cosumedPkglist
, moduleType
);
584 item
= headerFileList
.iterator();
585 while (item
.hasNext()) {
586 fileBuffer
.append(item
.next().toString());
589 // Write library class's related *.h file to autogen.h
591 String
[] libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSCONSUMED
, this.arch
);
592 if (libClassList
!= null) {
593 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
594 item
= libClassIncludeH
.iterator();
595 while (item
.hasNext()) {
596 fileBuffer
.append(item
.next().toString());
600 libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSPRODUCED
, this.arch
);
601 if (libClassList
!= null) {
602 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
603 item
= libClassIncludeH
.iterator();
604 while (item
.hasNext()) {
605 fileBuffer
.append(item
.next().toString());
608 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
611 // If is TianoR8FlashMap, copy {Fv_DIR}/FlashMap.h to
612 // {DEST_DIR_DRBUG}/FlashMap.h
614 if (saq
.isHaveTianoR8FlashMap()) {
615 fileBuffer
.append(CommonDefinition
.INCLUDE
);
616 fileBuffer
.append(" <");
617 fileBuffer
.append(CommonDefinition
.TIANOR8PLASHMAPH
+ ">\r\n");
618 copyFlashMapHToDebugDir();
622 // Write PCD information to library AutoGen.h.
624 if (this.myPcdAutogen
!= null) {
625 fileBuffer
.append("\r\n");
626 fileBuffer
.append(this.myPcdAutogen
.getHAutoGenString());
630 // Append the #endif at AutoGen.h
632 fileBuffer
.append("#endif\r\n");
635 // Save content of string buffer to AutoGen.h file.
637 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.h", fileBuffer
)) {
638 throw new AutoGenException("Failed to generate AutoGen.h !!!");
645 This function generates AutoGen.h for library.
647 @throws BuildException
648 Failed to generate AutoGen.c.
650 void libGenAutogenC() throws EdkException
{
651 StringBuffer fileBuffer
= new StringBuffer(10240);
654 // Write Autogen.c header notation
656 fileBuffer
.append(CommonDefinition
.AUTOGENCNOTATION
);
658 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
659 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
664 this.myPcdAutogen
= new PCDAutoGenAction(moduleId
,
667 saq
.getModulePcdEntryNameArray(this.arch
),
670 this.myPcdAutogen
.execute();
671 if (this.myPcdAutogen
!= null) {
672 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
673 fileBuffer
.append(this.myPcdAutogen
.getCAutoGenString());
676 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.c", fileBuffer
)) {
677 throw new AutoGenException("Failed to generate AutoGen.c !!!");
682 LibraryClassToAutogenH
684 This function returns *.h files declared by library classes which are
685 consumed or produced by current build module or library.
688 List of library class which consumed or produce by current
689 build module or library.
690 @return includeStrList List of *.h file.
692 Set
<String
> LibraryClassToAutogenH(String
[] libClassList
)
693 throws EdkException
{
694 Set
<String
> includeStrList
= new LinkedHashSet
<String
>();
695 String includeName
[];
699 // Get include file from GlobalData's SPDTable according to
700 // library class name.
702 for (int i
= 0; i
< libClassList
.length
; i
++) {
703 includeName
= GlobalData
.getLibraryClassHeaderFiles(
704 saq
.getDependencePkg(this.arch
),
706 if (includeName
== null) {
707 throw new AutoGenException("Can not find library class ["
708 + libClassList
[i
] + "] declaration in any SPD package. ");
710 for (int j
= 0; j
< includeName
.length
; j
++) {
711 String includeNameStr
= includeName
[j
];
712 if (includeNameStr
!= null) {
713 str
= CommonDefinition
.INCLUDE
+ " " + "<";
714 str
= str
+ includeNameStr
+ ">\r\n";
715 includeStrList
.add(str
);
716 includeNameStr
= null;
720 return includeStrList
;
726 This function add include file in AutoGen.h file.
728 @param packageNameList
729 List of module depended package.
734 List
<String
> depPkgToAutogenH(PackageIdentification
[] packageNameList
,
735 String moduleType
) throws AutoGenException
{
737 List
<String
> includeStrList
= new LinkedList
<String
>();
739 String includeStr
= "";
742 // Get include file from moduleInfo file
744 for (int i
= 0; i
< packageNameList
.length
; i
++) {
745 pkgHeader
= GlobalData
.getPackageHeaderFiles(packageNameList
[i
],
747 if (pkgHeader
== null) {
748 throw new AutoGenException("Can not find package ["
750 + "] declaration in any SPD package. ");
751 } else if (!pkgHeader
.equalsIgnoreCase("")) {
752 includeStr
= CommonDefinition
.INCLUDE
+ " <" + pkgHeader
754 includeStrList
.add(includeStr
);
758 return includeStrList
;
764 This function convert <ModuleEntryPoint> & <ModuleUnloadImage>
765 information in mas to AutoGen.c
767 @param entryPointList
770 String buffer fo AutoGen.c.
773 void EntryPointToAutoGen(String
[] entryPointList
, String
[] unloadImageList
, StringBuffer fileBuffer
)
774 throws EdkException
{
776 String typeStr
= saq
.getModuleType();
777 String debugStr
= "DEBUG ((EFI_D_INFO | EFI_D_LOAD, \"Module Entry Point (%s) 0x%%p\\n\", (VOID *)(UINTN)%s));\n";
778 int unloadImageCount
= 0;
779 int entryPointCount
= 0;
782 // The parameters and return value of entryPoint is difference
783 // for difference module type.
785 switch (CommonDefinition
.getModuleType(typeStr
)) {
787 case CommonDefinition
.ModuleTypePeiCore
:
788 if (entryPointList
== null ||entryPointList
.length
!= 1 ) {
789 throw new AutoGenException(
790 "Module type = 'PEI_CORE', can have only one module entry point!");
792 fileBuffer
.append("EFI_STATUS\r\n");
793 fileBuffer
.append(entryPointList
[0]);
794 fileBuffer
.append(" (\r\n");
795 fileBuffer
.append(" IN EFI_PEI_STARTUP_DESCRIPTOR *PeiStartupDescriptor,\r\n");
796 fileBuffer
.append(" IN VOID *OldCoreData\r\n");
797 fileBuffer
.append(" );\r\n\r\n");
799 fileBuffer
.append("EFI_STATUS\r\n");
800 fileBuffer
.append("EFIAPI\r\n");
801 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
802 fileBuffer
.append(" IN EFI_PEI_STARTUP_DESCRIPTOR *PeiStartupDescriptor,\r\n");
803 fileBuffer
.append(" IN VOID *OldCoreData\r\n");
804 fileBuffer
.append(" )\r\n\r\n");
805 fileBuffer
.append("{\r\n");
806 fileBuffer
.append(" return ");
807 fileBuffer
.append(entryPointList
[0]);
808 fileBuffer
.append(" (PeiStartupDescriptor, OldCoreData);\r\n");
809 fileBuffer
.append("}\r\n\r\n");
813 case CommonDefinition
.ModuleTypeDxeCore
:
814 fileBuffer
.append("const UINT32 _gUefiDriverRevision = 0;\r\n");
815 if (entryPointList
== null || entryPointList
.length
!= 1) {
816 throw new AutoGenException("Module type = 'DXE_CORE', can have only one module entry point!");
818 fileBuffer
.append("VOID\r\n");
819 fileBuffer
.append(entryPointList
[0]);
820 fileBuffer
.append(" (\n");
821 fileBuffer
.append(" IN VOID *HobStart\r\n");
822 fileBuffer
.append(" );\r\n\r\n");
824 fileBuffer
.append("VOID\r\n");
825 fileBuffer
.append("EFIAPI\r\n");
826 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
827 fileBuffer
.append(" IN VOID *HobStart\r\n");
828 fileBuffer
.append(" )\r\n\r\n");
829 fileBuffer
.append("{\r\n");
830 fileBuffer
.append(" ");
831 fileBuffer
.append(entryPointList
[0]);
832 fileBuffer
.append(" (HobStart);\r\n");
833 fileBuffer
.append("}\r\n\r\n");
837 case CommonDefinition
.ModuleTypePeim
:
839 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = 0;\r\n");
840 if (entryPointList
== null || entryPointList
.length
== 0) {
841 fileBuffer
.append("EFI_STATUS\r\n");
842 fileBuffer
.append("EFIAPI\r\n");
843 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
844 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
845 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
846 fileBuffer
.append(" )\r\n\r\n");
847 fileBuffer
.append("{\r\n");
848 fileBuffer
.append(" return EFI_SUCCESS;\r\n");
849 fileBuffer
.append("}\r\n\r\n");
852 for (int i
= 0; i
< entryPointList
.length
; i
++) {
853 fileBuffer
.append("EFI_STATUS\r\n");
854 fileBuffer
.append(entryPointList
[i
]);
855 fileBuffer
.append(" (\r\n");
856 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
857 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
858 fileBuffer
.append(" );\r\n");
862 fileBuffer
.append("EFI_STATUS\r\n");
863 fileBuffer
.append("EFIAPI\r\n");
864 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
865 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
866 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
867 fileBuffer
.append(" )\r\n\r\n");
868 fileBuffer
.append("{\r\n");
869 if (entryPointCount
== 1) {
870 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[0], entryPointList
[0]));
871 fileBuffer
.append(" return ");
872 fileBuffer
.append(entryPointList
[0]);
873 fileBuffer
.append(" (FfsHeader, PeiServices);\r\n");
875 fileBuffer
.append(" EFI_STATUS Status;\r\n");
876 fileBuffer
.append(" EFI_STATUS CombinedStatus;\r\n\r\n");
877 fileBuffer
.append(" CombinedStatus = EFI_LOAD_ERROR;\r\n\r\n");
878 for (int i
= 0; i
< entryPointList
.length
; i
++) {
879 if (!entryPointList
[i
].equals("")) {
880 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
881 fileBuffer
.append(" Status = ");
882 fileBuffer
.append(entryPointList
[i
]);
883 fileBuffer
.append(" (FfsHeader, PeiServices);\r\n");
884 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {\r\n");
885 fileBuffer
.append(" CombinedStatus = Status;\r\n");
886 fileBuffer
.append(" }\r\n\r\n");
891 fileBuffer
.append(" return CombinedStatus;\r\n");
893 fileBuffer
.append("}\r\n\r\n");
896 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
899 // If entryPoint is null, create an empty ProcessModuleEntryPointList
902 if (entryPointList
== null || entryPointList
.length
== 0) {
903 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
904 fileBuffer
.append(Integer
.toString(entryPointCount
));
905 fileBuffer
.append(";\r\n");
906 fileBuffer
.append("EFI_STATUS\r\n");
907 fileBuffer
.append("EFIAPI\r\n");
908 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
909 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
910 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
911 fileBuffer
.append(" )\r\n\r\n");
912 fileBuffer
.append("{\r\n");
913 fileBuffer
.append(" return EFI_SUCCESS;\r\n");
914 fileBuffer
.append("}\r\n\r\n");
917 for (int i
= 0; i
< entryPointList
.length
; i
++) {
918 fileBuffer
.append("EFI_STATUS\r\n");
919 fileBuffer
.append(entryPointList
[i
]);
920 fileBuffer
.append(" (\r\n");
921 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
922 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
923 fileBuffer
.append(" );\r\n");
926 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
927 fileBuffer
.append(Integer
.toString(entryPointCount
));
928 fileBuffer
.append(";\r\n");
929 fileBuffer
.append("static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r\n");
930 fileBuffer
.append("static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\r\n\r\n");
932 fileBuffer
.append("EFI_STATUS\r\n");
933 fileBuffer
.append("EFIAPI\r\n");
934 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
935 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
936 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
937 fileBuffer
.append(" )\r\n\r\n");
938 fileBuffer
.append("{\r\n");
940 for (int i
= 0; i
< entryPointList
.length
; i
++) {
941 fileBuffer
.append(" if (SetJump (&mJumpContext) == 0) {\r\n");
942 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
943 fileBuffer
.append(" ExitDriver (");
944 fileBuffer
.append(entryPointList
[i
]);
945 fileBuffer
.append(" (ImageHandle, SystemTable));\r\n");
946 fileBuffer
.append(" ASSERT (FALSE);\r\n");
947 fileBuffer
.append(" }\r\n");
949 fileBuffer
.append(" return mDriverEntryPointStatus;\r\n");
950 fileBuffer
.append("}\r\n\r\n");
952 fileBuffer
.append("VOID\r\n");
953 fileBuffer
.append("EFIAPI\r\n");
954 fileBuffer
.append("ExitDriver (\r\n");
955 fileBuffer
.append(" IN EFI_STATUS Status\n");
956 fileBuffer
.append(" )\r\n\r\n");
957 fileBuffer
.append("{\r\n");
958 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r\n");
959 fileBuffer
.append(" mDriverEntryPointStatus = Status;\r\n");
960 fileBuffer
.append(" }\r\n");
961 fileBuffer
.append(" LongJump (&mJumpContext, (UINTN)-1);\r\n");
962 fileBuffer
.append(" ASSERT (FALSE);\r\n");
963 fileBuffer
.append("}\r\n\r\n");
968 // Add "ModuleUnloadImage" for DxeSmmDriver module type;
970 //entryPointList = SurfaceAreaQuery.getModuleUnloadImageArray();
971 //entryPointList = CommonDefinition.remDupString(entryPointList);
972 //entryPointCount = 0;
974 unloadImageCount
= 0;
975 if (unloadImageList
!= null) {
976 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
977 fileBuffer
.append("EFI_STATUS\r\n");
978 fileBuffer
.append(unloadImageList
[i
]);
979 fileBuffer
.append(" (\r\n");
980 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\r\n");
981 fileBuffer
.append(" );\r\n");
986 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ");
987 fileBuffer
.append(Integer
.toString(unloadImageCount
));
988 fileBuffer
.append(";\r\n\r\n");
990 fileBuffer
.append("EFI_STATUS\r\n");
991 fileBuffer
.append("EFIAPI\r\n");
992 fileBuffer
.append("ProcessModuleUnloadList (\r\n");
993 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\r\n");
994 fileBuffer
.append(" )\r\n");
995 fileBuffer
.append("{\r\n");
997 if (unloadImageCount
== 0) {
998 fileBuffer
.append(" return EFI_SUCCESS;\r\n");
999 } else if (unloadImageCount
== 1) {
1000 fileBuffer
.append(" return ");
1001 fileBuffer
.append(unloadImageList
[0]);
1002 fileBuffer
.append("(ImageHandle);\r\n");
1004 fileBuffer
.append(" EFI_STATUS Status;\r\n\r\n");
1005 fileBuffer
.append(" Status = EFI_SUCCESS;\r\n\r\n");
1006 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1008 fileBuffer
.append(" Status = ");
1009 fileBuffer
.append(unloadImageList
[i
]);
1010 fileBuffer
.append("(ImageHandle);\r\n");
1012 fileBuffer
.append(" if (EFI_ERROR (Status)) {\r\n");
1013 fileBuffer
.append(" ");
1014 fileBuffer
.append(unloadImageList
[i
]);
1015 fileBuffer
.append("(ImageHandle);\r\n");
1016 fileBuffer
.append(" } else {\r\n");
1017 fileBuffer
.append(" Status = ");
1018 fileBuffer
.append(unloadImageList
[i
]);
1019 fileBuffer
.append("(ImageHandle);\r\n");
1020 fileBuffer
.append(" }\r\n");
1023 fileBuffer
.append(" return Status;\r\n");
1025 fileBuffer
.append("}\r\n\r\n");
1028 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1029 case CommonDefinition
.ModuleTypeDxeDriver
:
1030 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1031 case CommonDefinition
.ModuleTypeUefiDriver
:
1032 case CommonDefinition
.ModuleTypeUefiApplication
:
1033 entryPointCount
= 0;
1034 fileBuffer
.append("const UINT32 _gUefiDriverRevision = 0;\r\n");
1036 // If entry point is null, create a empty ProcessModuleEntryPointList function.
1038 if (entryPointList
== null || entryPointList
.length
== 0) {
1039 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = 0;\r\n");
1040 fileBuffer
.append("EFI_STATUS\r\n");
1041 fileBuffer
.append("EFIAPI\r\n");
1042 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
1043 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1044 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1045 fileBuffer
.append(" )\r\n\r\n");
1046 fileBuffer
.append("{\r\n");
1047 fileBuffer
.append(" return EFI_SUCCESS;\r\n");
1048 fileBuffer
.append("}\r\n");
1051 for (int i
= 0; i
< entryPointList
.length
; i
++) {
1053 fileBuffer
.append("EFI_STATUS\r\n");
1054 fileBuffer
.append(entryPointList
[i
]);
1055 fileBuffer
.append(" (\r\n");
1056 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1057 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1058 fileBuffer
.append(" );\r\n");
1062 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
1063 fileBuffer
.append(Integer
.toString(entryPointCount
));
1064 fileBuffer
.append(";\r\n");
1065 if (entryPointCount
> 1) {
1066 fileBuffer
.append("static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\r\n");
1067 fileBuffer
.append("static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\r\n");
1069 fileBuffer
.append("\n");
1071 fileBuffer
.append("EFI_STATUS\r\n");
1072 fileBuffer
.append("EFIAPI\r\n");
1073 fileBuffer
.append("ProcessModuleEntryPointList (\r\n");
1074 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1075 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1076 fileBuffer
.append(" )\r\n\r\n");
1077 fileBuffer
.append("{\r\n");
1079 if (entryPointCount
== 1) {
1080 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[0], entryPointList
[0]));
1081 fileBuffer
.append(" return ");
1082 fileBuffer
.append(entryPointList
[0]);
1083 fileBuffer
.append(" (ImageHandle, SystemTable);\r\n");
1085 for (int i
= 0; i
< entryPointList
.length
; i
++) {
1086 if (!entryPointList
[i
].equals("")) {
1087 fileBuffer
.append(" if (SetJump (&mJumpContext) == 0) {\r\n");
1088 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
1089 fileBuffer
.append(" ExitDriver (");
1090 fileBuffer
.append(entryPointList
[i
]);
1091 fileBuffer
.append(" (ImageHandle, SystemTable));\r\n");
1092 fileBuffer
.append(" ASSERT (FALSE);\r\n");
1093 fileBuffer
.append(" }\r\n");
1098 fileBuffer
.append(" return mDriverEntryPointStatus;\r\n");
1100 fileBuffer
.append("}\r\n\r\n");
1102 fileBuffer
.append("VOID\r\n");
1103 fileBuffer
.append("EFIAPI\r\n");
1104 fileBuffer
.append("ExitDriver (\r\n");
1105 fileBuffer
.append(" IN EFI_STATUS Status\r\n");
1106 fileBuffer
.append(" )\r\n\r\n");
1107 fileBuffer
.append("{\r\n");
1108 if (entryPointCount
<= 1) {
1109 fileBuffer
.append(" if (EFI_ERROR (Status)) {\r\n");
1110 fileBuffer
.append(" ProcessLibraryDestructorList (gImageHandle, gST);\r\n");
1111 fileBuffer
.append(" }\r\n");
1113 .append(" gBS->Exit (gImageHandle, Status, 0, NULL);\r\n");
1115 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\r\n");
1116 fileBuffer
.append(" mDriverEntryPointStatus = Status;\r\n");
1117 fileBuffer
.append(" }\r\n");
1118 fileBuffer
.append(" LongJump (&mJumpContext, (UINTN)-1);\r\n");
1119 fileBuffer
.append(" ASSERT (FALSE);\r\n");
1121 fileBuffer
.append("}\r\n\r\n");
1125 // Add ModuleUnloadImage for DxeDriver and UefiDriver module type.
1127 //entryPointList = SurfaceAreaQuery.getModuleUnloadImageArray();
1129 // Remover duplicate unload entry point.
1131 //entryPointList = CommonDefinition.remDupString(entryPointList);
1132 //entryPointCount = 0;
1133 unloadImageCount
= 0;
1134 if (unloadImageList
!= null) {
1135 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1136 fileBuffer
.append("EFI_STATUS\r\n");
1137 fileBuffer
.append("EFIAPI\r\n");
1138 fileBuffer
.append(unloadImageList
[i
]);
1139 fileBuffer
.append(" (\r\n");
1140 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\r\n");
1141 fileBuffer
.append(" );\r\n");
1146 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ");
1147 fileBuffer
.append(Integer
.toString(unloadImageCount
));
1148 fileBuffer
.append(";\r\n\r\n");
1150 fileBuffer
.append("EFI_STATUS\n");
1151 fileBuffer
.append("EFIAPI\r\n");
1152 fileBuffer
.append("ProcessModuleUnloadList (\r\n");
1153 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\r\n");
1154 fileBuffer
.append(" )\r\n");
1155 fileBuffer
.append("{\r\n");
1157 if (unloadImageCount
== 0) {
1158 fileBuffer
.append(" return EFI_SUCCESS;\r\n");
1159 } else if (unloadImageCount
== 1) {
1160 fileBuffer
.append(" return ");
1161 fileBuffer
.append(unloadImageList
[0]);
1162 fileBuffer
.append("(ImageHandle);\r\n");
1164 fileBuffer
.append(" EFI_STATUS Status;\r\n\r\n");
1165 fileBuffer
.append(" Status = EFI_SUCCESS;\r\n\r\n");
1166 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1168 fileBuffer
.append(" Status = ");
1169 fileBuffer
.append(unloadImageList
[i
]);
1170 fileBuffer
.append("(ImageHandle);\r\n");
1172 fileBuffer
.append(" if (EFI_ERROR (Status)) {\r\n");
1173 fileBuffer
.append(" ");
1174 fileBuffer
.append(unloadImageList
[i
]);
1175 fileBuffer
.append("(ImageHandle);\r\n");
1176 fileBuffer
.append(" } else {\r\n");
1177 fileBuffer
.append(" Status = ");
1178 fileBuffer
.append(unloadImageList
[i
]);
1179 fileBuffer
.append("(ImageHandle);\r\n");
1180 fileBuffer
.append(" }\r\n");
1183 fileBuffer
.append(" return Status;\r\n");
1185 fileBuffer
.append("}\r\n\r\n");
1193 This function gets GUIDs from SPD file accrodeing to <PPIs> information
1194 and write those GUIDs to AutoGen.c.
1197 String Buffer for Autogen.c file.
1198 @throws BuildException
1199 Guid must set value!
1201 void PpiGuidToAutogenC(StringBuffer fileBuffer
) throws AutoGenException
{
1202 String
[] cNameGuid
= null;
1205 // Get the all PPI adn PPI Notify from MSA file,
1206 // then add those PPI ,and PPI Notify name to list.
1209 String
[] ppiList
= saq
.getPpiArray(this.arch
);
1210 for (int i
= 0; i
< ppiList
.length
; i
++) {
1211 this.mPpiList
.add(ppiList
[i
]);
1214 String
[] ppiNotifyList
= saq
.getPpiNotifyArray(this.arch
);
1215 for (int i
= 0; i
< ppiNotifyList
.length
; i
++) {
1216 this.mPpiList
.add(ppiNotifyList
[i
]);
1220 // Find CNAME and GUID from dependence SPD file and write to Autogen.c
1222 Iterator ppiIterator
= this.mPpiList
.iterator();
1223 String ppiKeyWord
= null;
1224 while (ppiIterator
.hasNext()) {
1225 ppiKeyWord
= ppiIterator
.next().toString();
1226 cNameGuid
= GlobalData
.getPpiGuid(this.mDepPkgList
, ppiKeyWord
);
1227 if (cNameGuid
!= null) {
1228 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1229 fileBuffer
.append(cNameGuid
[0]);
1230 fileBuffer
.append(" = { ");
1231 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1232 fileBuffer
.append(" } ;");
1235 // If can't find Ppi GUID declaration in every package
1237 throw new AutoGenException("Can not find Ppi GUID ["
1238 + ppiKeyWord
+ "] declaration in any SPD package!");
1244 ProtocolGuidToAutogenc
1246 This function gets GUIDs from SPD file accrodeing to <Protocol>
1247 information and write those GUIDs to AutoGen.c.
1250 String Buffer for Autogen.c file.
1251 @throws BuildException
1252 Protocol name must set.
1254 void ProtocolGuidToAutogenC(StringBuffer fileBuffer
) throws EdkException
{
1255 String
[] cNameGuid
= null;
1257 String
[] protocolList
= saq
.getProtocolArray(this.arch
);
1260 // Add result to Autogen global list.
1262 for (int i
= 0; i
< protocolList
.length
; i
++) {
1263 this.mProtocolList
.add(protocolList
[i
]);
1266 String
[] protocolNotifyList
= saq
.getProtocolNotifyArray(this.arch
);
1268 for (int i
= 0; i
< protocolNotifyList
.length
; i
++) {
1269 this.mProtocolList
.add(protocolNotifyList
[i
]);
1273 // Get the NAME and GUID from dependence SPD and write to Autogen.c
1275 Iterator protocolIterator
= this.mProtocolList
.iterator();
1276 String protocolKeyWord
= null;
1279 while (protocolIterator
.hasNext()) {
1280 protocolKeyWord
= protocolIterator
.next().toString();
1281 cNameGuid
= GlobalData
.getProtocolGuid(this.mDepPkgList
, protocolKeyWord
);
1282 if (cNameGuid
!= null) {
1283 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1284 fileBuffer
.append(cNameGuid
[0]);
1285 fileBuffer
.append(" = { ");
1286 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1287 fileBuffer
.append(" } ;");
1290 // If can't find protocol GUID declaration in every package
1292 throw new AutoGenException("Can not find protocol Guid ["
1293 + protocolKeyWord
+ "] declaration in any SPD package!");
1301 This function gets GUIDs from SPD file accrodeing to <Guids> information
1302 and write those GUIDs to AutoGen.c.
1305 String Buffer for Autogen.c file.
1308 void GuidGuidToAutogenC(StringBuffer fileBuffer
) throws AutoGenException
{
1309 String
[] cNameGuid
= null;
1310 String guidKeyWord
= null;
1312 String
[] guidList
= saq
.getGuidEntryArray(this.arch
);
1314 for (int i
= 0; i
< guidList
.length
; i
++) {
1315 this.mGuidList
.add(guidList
[i
]);
1319 Iterator guidIterator
= this.mGuidList
.iterator();
1320 while (guidIterator
.hasNext()) {
1321 guidKeyWord
= guidIterator
.next().toString();
1322 cNameGuid
= GlobalData
.getGuid(this.mDepPkgList
, guidKeyWord
);
1324 if (cNameGuid
!= null) {
1325 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1326 fileBuffer
.append(cNameGuid
[0]);
1327 fileBuffer
.append(" = { ");
1328 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1329 fileBuffer
.append("} ;");
1332 // If can't find GUID declaration in every package
1334 throw new AutoGenException("Can not find Guid [" + guidKeyWord
1335 + "] declaration in any SPD package. ");
1342 LibInstanceToAutogenC
1344 This function adds dependent library instance to autogen.c,which
1345 includeing library's constructor, destructor, and library dependent ppi,
1346 protocol, guid, pcd information.
1349 String buffer for AutoGen.c
1350 @throws BuildException
1352 void LibInstanceToAutogenC(StringBuffer fileBuffer
) throws EdkException
{
1353 String moduleType
= this.moduleId
.getModuleType();
1355 // Add library constructor to AutoGen.c
1357 LibConstructorToAutogenC(libConstructList
, moduleType
,
1358 fileBuffer
/* autogenC */);
1360 // Add library destructor to AutoGen.c
1362 LibDestructorToAutogenC(libDestructList
, moduleType
, fileBuffer
/* autogenC */);
1366 LibConstructorToAutogenc
1368 This function writes library constructor list to AutoGen.c. The library
1369 constructor's parameter and return value depend on module type.
1371 @param libInstanceList
1372 List of library construct name.
1376 String buffer for AutoGen.c
1379 void LibConstructorToAutogenC(List
<String
[]> libInstanceList
,
1380 String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1381 boolean isFirst
= true;
1384 // The library constructor's parameter and return value depend on
1387 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1388 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1389 fileBuffer
.append("RETURN_STATUS\r\n");
1390 fileBuffer
.append("EFIAPI\r\n");
1391 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1392 fileBuffer
.append(" (\r\n");
1393 fileBuffer
.append(" VOID\r\n");
1394 fileBuffer
.append(" );\r\n");
1396 switch (CommonDefinition
.getModuleType(moduleType
)) {
1397 case CommonDefinition
.ModuleTypeBase
:
1398 fileBuffer
.append("RETURN_STATUS\r\n");
1399 fileBuffer
.append("EFIAPI\r\n");
1400 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1401 fileBuffer
.append(" (\r\n");
1402 fileBuffer
.append(" VOID\r\n");
1403 fileBuffer
.append(" );\r\n");
1406 case CommonDefinition
.ModuleTypePeiCore
:
1407 case CommonDefinition
.ModuleTypePeim
:
1408 fileBuffer
.append("EFI_STATUS\r\n");
1409 fileBuffer
.append("EFIAPI\r\n");
1410 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1411 fileBuffer
.append(" (\r\n");
1412 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
1413 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
1414 fileBuffer
.append(" );\r\n");
1417 case CommonDefinition
.ModuleTypeDxeCore
:
1418 case CommonDefinition
.ModuleTypeDxeDriver
:
1419 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1420 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1421 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1422 case CommonDefinition
.ModuleTypeUefiDriver
:
1423 case CommonDefinition
.ModuleTypeUefiApplication
:
1424 fileBuffer
.append("EFI_STATUS\r\n");
1425 fileBuffer
.append("EFIAPI\r\n");
1426 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1427 fileBuffer
.append(" (\r\n");
1428 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1429 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1430 fileBuffer
.append(" );\r\n");
1438 // Add ProcessLibraryConstructorList in AutoGen.c
1440 fileBuffer
.append("VOID\r\n");
1441 fileBuffer
.append("EFIAPI\r\n");
1442 fileBuffer
.append("ProcessLibraryConstructorList (\r\n");
1443 switch (CommonDefinition
.getModuleType(moduleType
)) {
1444 case CommonDefinition
.ModuleTypeBase
:
1445 fileBuffer
.append(" VOID\r\n");
1448 case CommonDefinition
.ModuleTypePeiCore
:
1449 case CommonDefinition
.ModuleTypePeim
:
1450 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
1452 .append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
1455 case CommonDefinition
.ModuleTypeDxeCore
:
1456 case CommonDefinition
.ModuleTypeDxeDriver
:
1457 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1458 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1459 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1460 case CommonDefinition
.ModuleTypeUefiDriver
:
1461 case CommonDefinition
.ModuleTypeUefiApplication
:
1462 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1463 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1467 fileBuffer
.append(" )\r\n");
1468 fileBuffer
.append("{\r\n");
1470 // If no constructor function, return EFI_SUCCESS.
1472 //if (libInstanceList.size() == 0){
1473 // fileBuffer.append(" return EFI_SUCCESS;\r\n");
1475 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1477 fileBuffer
.append(" EFI_STATUS Status;\r\n");
1478 fileBuffer
.append(" Status = EFI_SUCCESS;\r\n");
1479 fileBuffer
.append("\r\n");
1482 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1483 fileBuffer
.append(" Status = ");
1484 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1485 fileBuffer
.append("();\r\n");
1487 switch (CommonDefinition
.getModuleType(moduleType
)) {
1488 case CommonDefinition
.ModuleTypeBase
:
1489 fileBuffer
.append(" Status = ");
1490 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1491 fileBuffer
.append("();\r\n");
1493 case CommonDefinition
.ModuleTypePeiCore
:
1494 case CommonDefinition
.ModuleTypePeim
:
1495 fileBuffer
.append(" Status = ");
1496 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1497 fileBuffer
.append(" (FfsHeader, PeiServices);\r\n");
1499 case CommonDefinition
.ModuleTypeDxeCore
:
1500 case CommonDefinition
.ModuleTypeDxeDriver
:
1501 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1502 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1503 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1504 case CommonDefinition
.ModuleTypeUefiDriver
:
1505 case CommonDefinition
.ModuleTypeUefiApplication
:
1506 fileBuffer
.append(" Status = ");
1507 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1508 fileBuffer
.append(" (ImageHandle, SystemTable);\r\n");
1511 EdkLog
.log(EdkLog
.EDK_INFO
,"Autogen doesn't know how to deal with module type - " + moduleType
+ "!");
1515 fileBuffer
.append(" ASSERT_EFI_ERROR (Status);\r\n");
1517 fileBuffer
.append("}\r\n");
1521 LibDestructorToAutogenc
1523 This function writes library destructor list to AutoGen.c. The library
1524 destructor's parameter and return value depend on module type.
1526 @param libInstanceList
1527 List of library destructor name.
1531 String buffer for AutoGen.c
1534 void LibDestructorToAutogenC(List
<String
[]> libInstanceList
,
1535 String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1536 boolean isFirst
= true;
1537 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1538 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1539 fileBuffer
.append("RETURN_STATUS\r\n");
1540 fileBuffer
.append("EFIAPI\r\n");
1541 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1542 fileBuffer
.append(" (\r\n");
1543 fileBuffer
.append(" VOID\r\n");
1544 fileBuffer
.append(" );\r\n");
1546 switch (CommonDefinition
.getModuleType(moduleType
)) {
1547 case CommonDefinition
.ModuleTypeBase
:
1548 fileBuffer
.append("RETURN_STATUS\r\n");
1549 fileBuffer
.append("EFIAPI\r\n");
1550 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1551 fileBuffer
.append(" (\r\n");
1552 fileBuffer
.append(" VOID\r\n");
1553 fileBuffer
.append(" );\r\n");
1555 case CommonDefinition
.ModuleTypePeiCore
:
1556 case CommonDefinition
.ModuleTypePeim
:
1557 fileBuffer
.append("EFI_STATUS\r\n");
1558 fileBuffer
.append("EFIAPI\r\n");
1559 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1560 fileBuffer
.append(" (\r\n");
1561 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\r\n");
1562 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\r\n");
1563 fileBuffer
.append(" );\r\n");
1565 case CommonDefinition
.ModuleTypeDxeCore
:
1566 case CommonDefinition
.ModuleTypeDxeDriver
:
1567 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1568 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1569 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1570 case CommonDefinition
.ModuleTypeUefiDriver
:
1571 case CommonDefinition
.ModuleTypeUefiApplication
:
1572 fileBuffer
.append("EFI_STATUS\r\n");
1573 fileBuffer
.append("EFIAPI\r\n");
1574 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1575 fileBuffer
.append(" (\r\n");
1576 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1577 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1578 fileBuffer
.append(" );\r\n");
1585 // Write ProcessLibraryDestructor list to autogen.c
1587 switch (CommonDefinition
.getModuleType(moduleType
)) {
1588 case CommonDefinition
.ModuleTypeBase
:
1589 case CommonDefinition
.ModuleTypePeiCore
:
1590 case CommonDefinition
.ModuleTypePeim
:
1592 case CommonDefinition
.ModuleTypeDxeCore
:
1593 case CommonDefinition
.ModuleTypeDxeDriver
:
1594 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1595 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1596 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1597 case CommonDefinition
.ModuleTypeUefiDriver
:
1598 case CommonDefinition
.ModuleTypeUefiApplication
:
1599 fileBuffer
.append("VOID\r\n");
1600 fileBuffer
.append("EFIAPI\r\n");
1601 fileBuffer
.append("ProcessLibraryDestructorList (\r\n");
1602 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\r\n");
1603 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\r\n");
1604 fileBuffer
.append(" )\r\n");
1605 fileBuffer
.append("{\r\n");
1607 // If no library destructor function, return EFI_SUCCESS.
1610 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1612 fileBuffer
.append(" EFI_STATUS Status;\r\n");
1613 fileBuffer
.append(" Status = EFI_SUCCESS;\r\n");
1614 fileBuffer
.append("\r\n");
1617 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1618 fileBuffer
.append(" Status = ");
1619 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1620 fileBuffer
.append("();\r\n");
1621 fileBuffer
.append(" VOID\r\n");
1623 fileBuffer
.append(" Status = ");
1624 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1625 fileBuffer
.append("(ImageHandle, SystemTable);\r\n");
1626 fileBuffer
.append(" ASSERT_EFI_ERROR (Status);\r\n");
1629 fileBuffer
.append("}\r\n");
1635 ExternsDriverBindingToAutoGenC
1637 This function is to write DRIVER_BINDING, COMPONENT_NAME,
1638 DRIVER_CONFIGURATION, DRIVER_DIAGNOSTIC in AutoGen.c.
1641 String buffer for AutoGen.c
1643 void ExternsDriverBindingToAutoGenC(StringBuffer fileBuffer
)
1644 throws EdkException
{
1646 // Get the arry of extern. The driverBindingGroup is a 2 dimension array.
1647 // The second dimension is include following element: DriverBinding,
1648 // ComponentName, DriverConfiguration, DriverDiag;
1650 String
[][] driverBindingGroup
= this.saq
.getExternProtocolGroup();
1659 // Write driver binding protocol extern to autogen.c
1661 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1662 if (driverBindingGroup
[i
][0] != null) {
1663 fileBuffer
.append("extern EFI_DRIVER_BINDING_PROTOCOL ");
1664 fileBuffer
.append(driverBindingGroup
[i
][0]);
1665 fileBuffer
.append(";\r\n");
1670 // Write component name protocol extern to autogen.c
1672 if (!componentNamePcd
) {
1673 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1674 if (driverBindingGroup
[i
][1]!= null) {
1675 if (driverBindingGroup
[i
][0] != null) {
1677 fileBuffer
.append("extern EFI_COMPONENT_NAME_PROTOCOL ");
1678 fileBuffer
.append(driverBindingGroup
[i
][1]);
1679 fileBuffer
.append(";\r\n");
1681 throw new AutoGenException("DriverBinding can't be empty!!");
1688 // Write driver configration protocol extern to autogen.c
1690 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1691 if (driverBindingGroup
[i
][2] != null) {
1692 if (driverBindingGroup
[i
][0] != null) {
1694 fileBuffer
.append("extern EFI_DRIVER_CONFIGURATION_PROTOCOL ");
1695 fileBuffer
.append(driverBindingGroup
[i
][2]);
1696 fileBuffer
.append(";\r\n");
1698 throw new AutoGenException("DriverBinding can't be empty!!");
1704 // Write driver dignastic protocol extern to autogen.c
1706 if (!driverDiagnostPcd
) {
1707 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1708 if (driverBindingGroup
[i
][3] != null) {
1709 if (driverBindingGroup
[i
][0] != null) {
1711 fileBuffer
.append("extern EFI_DRIVER_DIAGNOSTICS_PROTOCOL ");
1712 fileBuffer
.append(driverBindingGroup
[i
][3]);
1713 fileBuffer
.append(";\r\n");
1715 throw new AutoGenException("DriverBinding can't be empty!!");
1723 // Write driver module protocol bitmask.
1725 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverModelProtocolBitmask = ");
1726 fileBuffer
.append(Integer
.toString(BitMask
));
1727 fileBuffer
.append(";\r\n");
1730 // Write driver module protocol list entry
1732 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverModelProtocolListEntries = ");
1734 fileBuffer
.append(Integer
.toString(driverBindingGroup
.length
));
1735 fileBuffer
.append(";\r\n");
1738 // Write drive module protocol list to autogen.c
1740 if (driverBindingGroup
.length
> 0) {
1741 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const EFI_DRIVER_MODEL_PROTOCOL_LIST _gDriverModelProtocolList[] = {");
1745 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1747 fileBuffer
.append(",");
1752 fileBuffer
.append("\r\n {\r\n");
1753 fileBuffer
.append(" &");
1754 fileBuffer
.append(driverBindingGroup
[i
][0]);
1755 fileBuffer
.append(", \r\n");
1760 if (driverBindingGroup
[i
][1] != null && componentNamePcd
!= true) {
1761 fileBuffer
.append(" &");
1762 fileBuffer
.append(driverBindingGroup
[i
][1]);
1763 fileBuffer
.append(", \r\n");
1765 fileBuffer
.append(" NULL, \r\n");
1769 // DriverConfiguration
1771 if (driverBindingGroup
[i
][2] != null) {
1772 fileBuffer
.append(" &");
1773 fileBuffer
.append(driverBindingGroup
[i
][2]);
1774 fileBuffer
.append(", \r\n");
1776 fileBuffer
.append(" NULL, \r\n");
1782 if (driverBindingGroup
[i
][3] != null && driverDiagnostPcd
!= true) {
1783 fileBuffer
.append(" &");
1784 fileBuffer
.append(driverBindingGroup
[i
][3]);
1785 fileBuffer
.append(", \r\n");
1787 fileBuffer
.append(" NULL, \r\n");
1789 fileBuffer
.append(" }");
1792 if (driverBindingGroup
.length
> 0) {
1793 fileBuffer
.append("\r\n};\r\n");
1798 ExternCallBackToAutoGenC
1800 This function adds <SetVirtualAddressMapCallBack> and
1801 <ExitBootServicesCallBack> infomation to AutoGen.c
1804 String buffer for AutoGen.c
1805 @throws BuildException
1807 void ExternCallBackToAutoGenC(StringBuffer fileBuffer
)
1808 throws EdkException
{
1810 // Collect module's <SetVirtualAddressMapCallBack> and
1811 // <ExitBootServiceCallBack> and add to setVirtualAddList
1812 // exitBootServiceList.
1814 String
[] setVirtuals
= saq
.getSetVirtualAddressMapCallBackArray();
1815 String
[] exitBoots
= saq
.getExitBootServicesCallBackArray();
1816 if (setVirtuals
!= null) {
1817 for (int j
= 0; j
< setVirtuals
.length
; j
++) {
1818 this.setVirtalAddList
.add(setVirtuals
[j
]);
1821 if (exitBoots
!= null) {
1822 for (int k
= 0; k
< exitBoots
.length
; k
++) {
1823 this.exitBootServiceList
.add(exitBoots
[k
]);
1827 // Add c code in autogen.c which relate to <SetVirtualAddressMapCallBack>
1828 // and <ExitBootServicesCallBack>
1830 String moduleType
= this.moduleId
.getModuleType();
1831 switch (CommonDefinition
.getModuleType(moduleType
)) {
1832 case CommonDefinition
.ModuleTypeDxeDriver
:
1833 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1834 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1835 case CommonDefinition
.ModuleTypeUefiDriver
:
1836 case CommonDefinition
.ModuleTypeUefiApplication
:
1838 // If moduleType is one of above, call setVirtualAddressToAutogenC,
1839 // and setExitBootServiceToAutogenC.
1841 setVirtualAddressToAutogenC(fileBuffer
);
1842 setExitBootServiceToAutogenC(fileBuffer
);
1850 copyFlashMapHToDebugDir
1852 This function is to copy the falshmap.h to debug directory and change
1853 its name to TianoR8FlashMap.h
1858 private void copyFlashMapHToDebugDir() throws AutoGenException
{
1860 File inFile
= new File(fvDir
+ File
.separatorChar
+ CommonDefinition
.FLASHMAPH
);
1861 int size
= (int)inFile
.length();
1862 byte[] buffer
= new byte[size
];
1863 File outFile
= new File (this.outputPath
+ File
.separatorChar
+ CommonDefinition
.TIANOR8PLASHMAPH
);
1865 // If TianoR8FlashMap.h existed and the flashMap.h don't change,
1868 if ((!outFile
.exists()) ||(inFile
.lastModified() - outFile
.lastModified()) >= 0) {
1869 if (inFile
.exists()) {
1871 FileInputStream fis
= new FileInputStream (inFile
);
1873 FileOutputStream fos
= new FileOutputStream(outFile
);
1877 } catch (IOException e
) {
1878 throw new AutoGenException("The file, flashMap.h can't be open!");
1882 throw new AutoGenException("The file, flashMap.h doesn't exist!");
1888 This function first order the library instances, then collect
1889 library instance 's PPI, Protocol, GUID,
1890 SetVirtalAddressMapCallBack, ExitBootServiceCallBack, and
1891 Destructor, Constructor.
1896 private void collectLibInstanceInfo() throws EdkException
{
1899 String libConstructName
= null;
1900 String libDestructName
= null;
1901 String libModuleType
= null;
1902 String
[] setVirtuals
= null;
1903 String
[] exitBoots
= null;
1905 ModuleIdentification
[] libraryIdList
= saq
.getLibraryInstance(this.arch
);
1907 if (libraryIdList
!= null) {
1909 // Reorder library instance sequence.
1911 AutogenLibOrder libOrder
= new AutogenLibOrder(libraryIdList
,
1913 List
<ModuleIdentification
> orderList
= libOrder
1914 .orderLibInstance();
1916 if (orderList
!= null) {
1918 // Process library instance one by one.
1920 for (int i
= 0; i
< orderList
.size(); i
++) {
1922 // Get library instance basename.
1924 ModuleIdentification libInstanceId
= orderList
.get(i
);
1930 Map
<String
, XmlObject
> libDoc
= GlobalData
.getDoc(libInstanceId
, this.arch
);
1933 // Get <PPis>, <Protocols>, <Guids> list of this library
1936 String
[] ppiList
= saq
.getPpiArray(this.arch
);
1937 String
[] ppiNotifyList
= saq
.getPpiNotifyArray(this.arch
);
1938 String
[] protocolList
= saq
.getProtocolArray(this.arch
);
1939 String
[] protocolNotifyList
= saq
.getProtocolNotifyArray(this.arch
);
1940 String
[] guidList
= saq
.getGuidEntryArray(this.arch
);
1941 PackageIdentification
[] pkgList
= saq
.getDependencePkg(this.arch
);
1944 // Add those ppi, protocol, guid in global ppi,
1948 for (index
= 0; index
< ppiList
.length
; index
++) {
1949 this.mPpiList
.add(ppiList
[index
]);
1952 for (index
= 0; index
< ppiNotifyList
.length
; index
++) {
1953 this.mPpiList
.add(ppiNotifyList
[index
]);
1956 for (index
= 0; index
< protocolList
.length
; index
++) {
1957 this.mProtocolList
.add(protocolList
[index
]);
1960 for (index
= 0; index
< protocolNotifyList
.length
; index
++) {
1961 this.mProtocolList
.add(protocolNotifyList
[index
]);
1964 for (index
= 0; index
< guidList
.length
; index
++) {
1965 this.mGuidList
.add(guidList
[index
]);
1967 for (index
= 0; index
< pkgList
.length
; index
++) {
1968 if (!this.mDepPkgList
.contains(pkgList
[index
])) {
1969 this.mDepPkgList
.add(pkgList
[index
]);
1974 // If not yet parse this library instance's constructor
1975 // element,parse it.
1977 libConstructName
= saq
.getLibConstructorName();
1978 libDestructName
= saq
.getLibDestructorName();
1979 libModuleType
= saq
.getModuleType();
1982 // Collect SetVirtualAddressMapCallBack and
1983 // ExitBootServiceCallBack.
1985 setVirtuals
= saq
.getSetVirtualAddressMapCallBackArray();
1986 exitBoots
= saq
.getExitBootServicesCallBackArray();
1987 if (setVirtuals
!= null) {
1988 for (int j
= 0; j
< setVirtuals
.length
; j
++) {
1989 this.setVirtalAddList
.add(setVirtuals
[j
]);
1992 if (exitBoots
!= null) {
1993 for (int k
= 0; k
< exitBoots
.length
; k
++) {
1994 this.exitBootServiceList
.add(exitBoots
[k
]);
1999 // Add dependent library instance constructor function.
2001 if (libConstructName
!= null) {
2002 this.libConstructList
.add(new String
[] {libConstructName
, libModuleType
});
2005 // Add dependent library instance destructor fuction.
2007 if (libDestructName
!= null) {
2008 this.libDestructList
.add(new String
[] {libDestructName
, libModuleType
});
2014 private void setVirtualAddressToAutogenC(StringBuffer fileBuffer
){
2016 // Entry point lib for these module types needs to know the count
2019 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverSetVirtualAddressMapEventCount = ");
2022 // If the list is not valid or has no entries set count to zero else
2023 // set count to the number of valid entries
2027 if (this.setVirtalAddList
!= null) {
2028 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2029 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2036 fileBuffer
.append(Integer
.toString(Count
));
2037 fileBuffer
.append(";\r\n\r\n");
2038 if (this.setVirtalAddList
== null || this.setVirtalAddList
.size() == 0) {
2040 // No data so make a NULL list
2042 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverSetVirtualAddressMapEvent[] = {\r\n");
2043 fileBuffer
.append(" NULL\r\n");
2044 fileBuffer
.append("};\r\n\r\n");
2047 // Write SetVirtualAddressMap function definition.
2049 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2050 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2053 fileBuffer
.append("VOID\r\n");
2054 fileBuffer
.append("EFIAPI\r\n");
2055 fileBuffer
.append(this.setVirtalAddList
.get(i
));
2056 fileBuffer
.append(" (\r\n");
2057 fileBuffer
.append(" IN EFI_EVENT Event,\r\n");
2058 fileBuffer
.append(" IN VOID *Context\r\n");
2059 fileBuffer
.append(" );\r\n\r\n");
2063 // Write SetVirtualAddressMap entry point array.
2065 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverSetVirtualAddressMapEvent[] = {");
2066 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2067 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2072 fileBuffer
.append("\r\n ");
2074 fileBuffer
.append(",\r\n ");
2077 fileBuffer
.append(this.setVirtalAddList
.get(i
));
2080 // add the NULL at the end of _gDriverSetVirtualAddressMapEvent list.
2082 fileBuffer
.append(",\r\n NULL");
2083 fileBuffer
.append("\r\n};\r\n\r\n");
2088 private void setExitBootServiceToAutogenC(StringBuffer fileBuffer
){
2090 // Entry point lib for these module types needs to know the count.
2093 .append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverExitBootServicesEventCount = ");
2096 // If the list is not valid or has no entries set count to zero else
2097 // set count to the number of valid entries.
2101 if (this.exitBootServiceList
!= null) {
2102 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2103 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2109 fileBuffer
.append(Integer
.toString(Count
));
2110 fileBuffer
.append(";\r\n\r\n");
2112 if (this.exitBootServiceList
== null || this.exitBootServiceList
.size() == 0) {
2114 // No data so make a NULL list.
2116 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverExitBootServicesEvent[] = {\r\n");
2117 fileBuffer
.append(" NULL\r\n");
2118 fileBuffer
.append("};\r\n\r\n");
2121 // Write DriverExitBootServices function definition.
2123 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2124 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2128 fileBuffer
.append("VOID\r\n");
2129 fileBuffer
.append("EFIAPI\r\n");
2130 fileBuffer
.append(this.exitBootServiceList
.get(i
));
2131 fileBuffer
.append(" (\r\n");
2132 fileBuffer
.append(" IN EFI_EVENT Event,\r\n");
2133 fileBuffer
.append(" IN VOID *Context\r\n");
2134 fileBuffer
.append(" );\r\n\r\n");
2138 // Write DriverExitBootServices entry point array.
2140 fileBuffer
.append("\r\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverExitBootServicesEvent[] = {");
2141 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2142 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2147 fileBuffer
.append("\r\n ");
2149 fileBuffer
.append(",\r\n ");
2151 fileBuffer
.append(this.exitBootServiceList
.get(i
));
2154 fileBuffer
.append(",\r\n NULL");
2155 fileBuffer
.append("\r\n};\r\n\r\n");
2161 Get the Pcd Value of ComponentName to
2162 decide whether need to disable the componentName.
2165 public void setPcdComponentName (){
2166 String pcdValue
= null;
2167 pcdValue
= saq
.getPcdValueBycName("PcdComponentNameDisable");
2168 if (pcdValue
!= null && pcdValue
.equalsIgnoreCase("true")) {
2169 this.componentNamePcd
= true;
2174 setPcdDriverDiagnostic
2176 Get the Pcd Value of DriverDiagnostic to
2177 decide whether need to disable DriverDiagnostic.
2180 public void setPcdDriverDiagnostic (){
2181 String pcdValue
= null;
2182 pcdValue
= saq
.getPcdValueBycName("PcdDriverDiagnosticsDisable");
2183 if (pcdValue
!= null && pcdValue
.equalsIgnoreCase("true")) {
2184 this.driverDiagnostPcd
= true;