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("\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
+ ">\n");
375 copyFlashMapHToDebugDir();
378 // Write PCD autogen information to AutoGen.h.
380 if (this.myPcdAutogen
!= null) {
381 fileBuffer
.append("\n");
382 fileBuffer
.append(this.myPcdAutogen
.getHAutoGenString());
386 // Append the #endif at AutoGen.h
388 fileBuffer
.append("#endif\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 // Get the native MSA file infomation. Since before call autogen,
416 // the MSA native <Externs> information were overrided. So before
417 // process <Externs> it should be set the DOC as the Native MSA info.
419 Map
<String
, XmlObject
> doc
= GlobalData
.getNativeMsa(this.moduleId
);
423 // DriverBinding/ComponentName/DriverConfiguration/DriverDialog
427 ExternsDriverBindingToAutoGenC(fileBuffer
);
430 // Write DriverExitBootServicesEvent/DriverSetVirtualAddressMapEvent
433 ExternCallBackToAutoGenC(fileBuffer
);
436 // Write EntryPoint to autgoGen.c
438 String
[] entryPointList
= saq
.getModuleEntryPointArray();
439 String
[] unloadImageList
= saq
.getModuleUnloadImageArray();
440 EntryPointToAutoGen(CommonDefinition
.remDupString(entryPointList
),
441 CommonDefinition
.remDupString(unloadImageList
),
444 pcdDriverType
= saq
.getPcdDriverType();
447 // Restore the DOC which include the FPD module info.
452 // Write Guid to autogen.c
454 String guid
= CommonDefinition
.formatGuidName(saq
.getModuleGuid());
455 if (this.moduleId
.getModuleType().equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
456 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = {");
458 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiCallerIdGuid = {");
462 throw new AutoGenException("Guid value must set!\n");
466 // Formate Guid as ANSI c form.Example:
467 // {0xd2b2b828, 0x826, 0x48a7,{0xb3, 0xdf, 0x98, 0x3c, 0x0, 0x60, 0x24,
471 fileBuffer
.append(guid
);
472 fileBuffer
.append("};\n");
475 // Generate library instance consumed protocol, guid, ppi, pcd list.
476 // Save those to this.protocolList, this.ppiList, this.pcdList,
477 // this.guidList. Write Consumed library constructor and desconstuct to
480 LibInstanceToAutogenC(fileBuffer
);
483 // Get module dependent Package identification.
485 PackageIdentification
[] packages
= saq
.getDependencePkg(this.arch
);
486 for (int i
= 0; i
< packages
.length
; i
++) {
487 if (!this.mDepPkgList
.contains(packages
[i
])) {
488 this.mDepPkgList
.add(packages
[i
]);
494 // Write consumed ppi, guid, protocol to autogen.c
496 ProtocolGuidToAutogenC(fileBuffer
);
497 PpiGuidToAutogenC(fileBuffer
);
498 GuidGuidToAutogenC(fileBuffer
);
503 this.myPcdAutogen
= new PCDAutoGenAction(moduleId
,
510 this.myPcdAutogen
.execute();
511 if (this.myPcdAutogen
!= null) {
512 fileBuffer
.append("\n");
513 fileBuffer
.append(this.myPcdAutogen
.getCAutoGenString());
516 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.c", fileBuffer
)) {
517 throw new AutoGenException("Failed to generate AutoGen.c !!!");
525 This function generates AutoGen.h for library.
527 @throws BuildException
528 Failed to generate AutoGen.c.
530 void libGenAutogenH() throws EdkException
{
532 Set
<String
> libClassIncludeH
;
534 List
<String
> headerFileList
;
536 StringBuffer fileBuffer
= new StringBuffer(10240);
539 // Write Autogen.h header notation
541 fileBuffer
.append(CommonDefinition
.AUTOGENHNOTATION
);
544 // Add #ifndef ${BaseName}_AUTOGENH
545 // #def ${BseeName}_AUTOGENH
547 fileBuffer
.append(CommonDefinition
.IFNDEF
548 + CommonDefinition
.AUTOGENH
549 + this.moduleId
.getGuid().replaceAll("-", "_")
550 + ToolDefinitions
.LINE_SEPARATOR
);
551 fileBuffer
.append(CommonDefinition
.DEFINE
552 + CommonDefinition
.AUTOGENH
553 + this.moduleId
.getGuid().replaceAll("-", "_")
554 + ToolDefinitions
.LINE_SEPARATOR
555 + ToolDefinitions
.LINE_SEPARATOR
);
558 // Write EFI_SPECIFICATION_VERSION and EDK_RELEASE_VERSION
559 // to autogen.h file.
560 // Note: the specification version and release version should
561 // be get from module surface area instead of hard code.
563 fileBuffer
.append(CommonDefinition
.AUTOGENHBEGIN
);
564 String
[] specList
= saq
.getExternSpecificaiton();
565 for (int i
= 0; i
< specList
.length
; i
++) {
566 fileBuffer
.append(CommonDefinition
.DEFINE
+ specList
[i
]
569 // fileBuffer.append(CommonDefinition.autoGenHLine1);
570 // fileBuffer.append(CommonDefinition.autoGenHLine2);
573 // Write consumed package's mdouleInfo related *.h file to autogen.h.
575 moduleType
= saq
.getModuleType();
576 PackageIdentification
[] cosumedPkglist
= saq
577 .getDependencePkg(this.arch
);
578 headerFileList
= depPkgToAutogenH(cosumedPkglist
, moduleType
);
579 item
= headerFileList
.iterator();
580 while (item
.hasNext()) {
581 fileBuffer
.append(item
.next().toString());
584 // Write library class's related *.h file to autogen.h
586 String
[] libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSCONSUMED
, this.arch
);
587 if (libClassList
!= null) {
588 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
589 item
= libClassIncludeH
.iterator();
590 while (item
.hasNext()) {
591 fileBuffer
.append(item
.next().toString());
595 libClassList
= saq
.getLibraryClasses(CommonDefinition
.ALWAYSPRODUCED
, this.arch
);
596 if (libClassList
!= null) {
597 libClassIncludeH
= LibraryClassToAutogenH(libClassList
);
598 item
= libClassIncludeH
.iterator();
599 while (item
.hasNext()) {
600 fileBuffer
.append(item
.next().toString());
603 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
606 // If is TianoR8FlashMap, copy {Fv_DIR}/FlashMap.h to
607 // {DEST_DIR_DRBUG}/FlashMap.h
609 if (saq
.isHaveTianoR8FlashMap()) {
610 fileBuffer
.append(CommonDefinition
.INCLUDE
);
611 fileBuffer
.append(" <");
612 fileBuffer
.append(CommonDefinition
.TIANOR8PLASHMAPH
+ ">\n");
613 copyFlashMapHToDebugDir();
617 // Write PCD information to library AutoGen.h.
619 if (this.myPcdAutogen
!= null) {
620 fileBuffer
.append("\n");
621 fileBuffer
.append(this.myPcdAutogen
.getHAutoGenString());
624 // generate function prototype for constructor and destructor
626 LibConstructorToAutogenH(moduleType
, fileBuffer
);
627 LibDestructorToAutogenH(moduleType
, fileBuffer
);
629 // Append the #endif at AutoGen.h
631 fileBuffer
.append("#endif\n");
633 // Save content of string buffer to AutoGen.h file.
635 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.h", fileBuffer
)) {
636 throw new AutoGenException("Failed to generate AutoGen.h !!!");
643 This function generates AutoGen.h for library.
645 @throws BuildException
646 Failed to generate AutoGen.c.
648 void libGenAutogenC() throws EdkException
{
649 StringBuffer fileBuffer
= new StringBuffer(10240);
652 // Write Autogen.c header notation
654 fileBuffer
.append(CommonDefinition
.AUTOGENCNOTATION
);
656 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
657 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
662 this.myPcdAutogen
= new PCDAutoGenAction(moduleId
,
665 saq
.getModulePcdEntryNameArray(this.arch
),
668 this.myPcdAutogen
.execute();
669 if (this.myPcdAutogen
!= null) {
670 fileBuffer
.append(ToolDefinitions
.LINE_SEPARATOR
);
671 fileBuffer
.append(this.myPcdAutogen
.getCAutoGenString());
674 if (!saveFile(outputPath
+ File
.separatorChar
+ "AutoGen.c", fileBuffer
)) {
675 throw new AutoGenException("Failed to generate AutoGen.c !!!");
680 LibraryClassToAutogenH
682 This function returns *.h files declared by library classes which are
683 consumed or produced by current build module or library.
686 List of library class which consumed or produce by current
687 build module or library.
688 @return includeStrList List of *.h file.
690 Set
<String
> LibraryClassToAutogenH(String
[] libClassList
)
691 throws EdkException
{
692 Set
<String
> includeStrList
= new LinkedHashSet
<String
>();
693 String includeName
[];
697 // Get include file from GlobalData's SPDTable according to
698 // library class name.
700 for (int i
= 0; i
< libClassList
.length
; i
++) {
701 includeName
= GlobalData
.getLibraryClassHeaderFiles(
702 saq
.getDependencePkg(this.arch
),
704 if (includeName
== null) {
705 throw new AutoGenException("Can not find library class ["
706 + libClassList
[i
] + "] declaration in any SPD package. ");
708 for (int j
= 0; j
< includeName
.length
; j
++) {
709 String includeNameStr
= includeName
[j
];
710 if (includeNameStr
!= null) {
711 str
= CommonDefinition
.INCLUDE
+ " " + "<";
712 str
= str
+ includeNameStr
+ ">\n";
713 includeStrList
.add(str
);
714 includeNameStr
= null;
718 return includeStrList
;
724 This function add include file in AutoGen.h file.
726 @param packageNameList
727 List of module depended package.
732 List
<String
> depPkgToAutogenH(PackageIdentification
[] packageNameList
,
733 String moduleType
) throws AutoGenException
{
735 List
<String
> includeStrList
= new LinkedList
<String
>();
737 String includeStr
= "";
740 // Get include file from moduleInfo file
742 for (int i
= 0; i
< packageNameList
.length
; i
++) {
743 pkgHeader
= GlobalData
.getPackageHeaderFiles(packageNameList
[i
],
745 if (pkgHeader
== null) {
746 throw new AutoGenException("Can not find package ["
748 + "] declaration in any SPD package. ");
749 } else if (!pkgHeader
.equalsIgnoreCase("")) {
750 includeStr
= CommonDefinition
.INCLUDE
+ " <" + pkgHeader
752 includeStrList
.add(includeStr
);
756 return includeStrList
;
762 This function convert <ModuleEntryPoint> & <ModuleUnloadImage>
763 information in mas to AutoGen.c
765 @param entryPointList
768 String buffer fo AutoGen.c.
771 void EntryPointToAutoGen(String
[] entryPointList
, String
[] unloadImageList
, StringBuffer fileBuffer
)
772 throws EdkException
{
774 String typeStr
= saq
.getModuleType();
775 String debugStr
= "DEBUG ((EFI_D_INFO | EFI_D_LOAD, \"Module Entry Point (%s) 0x%%p\\n\", (VOID *)(UINTN)%s));\n";
776 int unloadImageCount
= 0;
777 int entryPointCount
= 0;
780 // The parameters and return value of entryPoint is difference
781 // for difference module type.
783 switch (CommonDefinition
.getModuleType(typeStr
)) {
785 case CommonDefinition
.ModuleTypePeiCore
:
786 if (entryPointList
== null ||entryPointList
.length
!= 1 ) {
787 throw new AutoGenException(
788 "Module type = 'PEI_CORE', can have only one module entry point!");
790 fileBuffer
.append("EFI_STATUS\n");
791 fileBuffer
.append("EFIAPI\n");
792 fileBuffer
.append(entryPointList
[0]);
793 fileBuffer
.append(" (\n");
794 fileBuffer
.append(" IN EFI_PEI_STARTUP_DESCRIPTOR *PeiStartupDescriptor,\n");
795 fileBuffer
.append(" IN VOID *OldCoreData\n");
796 fileBuffer
.append(" );\n\n");
798 fileBuffer
.append("EFI_STATUS\n");
799 fileBuffer
.append("EFIAPI\n");
800 fileBuffer
.append("ProcessModuleEntryPointList (\n");
801 fileBuffer
.append(" IN EFI_PEI_STARTUP_DESCRIPTOR *PeiStartupDescriptor,\n");
802 fileBuffer
.append(" IN VOID *OldCoreData\n");
803 fileBuffer
.append(" )\n\n");
804 fileBuffer
.append("{\n");
805 fileBuffer
.append(" return ");
806 fileBuffer
.append(entryPointList
[0]);
807 fileBuffer
.append(" (PeiStartupDescriptor, OldCoreData);\n");
808 fileBuffer
.append("}\n\n");
812 case CommonDefinition
.ModuleTypeDxeCore
:
813 fileBuffer
.append("const UINT32 _gUefiDriverRevision = 0;\n");
814 if (entryPointList
== null || entryPointList
.length
!= 1) {
815 throw new AutoGenException("Module type = 'DXE_CORE', can have only one module entry point!");
817 fileBuffer
.append("VOID\n");
818 fileBuffer
.append("EFIAPI\n");
819 fileBuffer
.append(entryPointList
[0]);
820 fileBuffer
.append(" (\n");
821 fileBuffer
.append(" IN VOID *HobStart\n");
822 fileBuffer
.append(" );\n\n");
824 fileBuffer
.append("VOID\n");
825 fileBuffer
.append("EFIAPI\n");
826 fileBuffer
.append("ProcessModuleEntryPointList (\n");
827 fileBuffer
.append(" IN VOID *HobStart\n");
828 fileBuffer
.append(" )\n\n");
829 fileBuffer
.append("{\n");
830 fileBuffer
.append(" ");
831 fileBuffer
.append(entryPointList
[0]);
832 fileBuffer
.append(" (HobStart);\n");
833 fileBuffer
.append("}\n\n");
837 case CommonDefinition
.ModuleTypePeim
:
839 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPeimRevision = 0;\n");
840 if (entryPointList
== null || entryPointList
.length
== 0) {
841 fileBuffer
.append("EFI_STATUS\n");
842 fileBuffer
.append("EFIAPI\n");
843 fileBuffer
.append("ProcessModuleEntryPointList (\n");
844 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
845 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
846 fileBuffer
.append(" )\n\n");
847 fileBuffer
.append("{\n");
848 fileBuffer
.append(" return EFI_SUCCESS;\n");
849 fileBuffer
.append("}\n\n");
852 for (int i
= 0; i
< entryPointList
.length
; i
++) {
853 fileBuffer
.append("EFI_STATUS\n");
854 fileBuffer
.append("EFIAPI\n");
855 fileBuffer
.append(entryPointList
[i
]);
856 fileBuffer
.append(" (\n");
857 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
858 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
859 fileBuffer
.append(" );\n");
863 fileBuffer
.append("EFI_STATUS\n");
864 fileBuffer
.append("EFIAPI\n");
865 fileBuffer
.append("ProcessModuleEntryPointList (\n");
866 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
867 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
868 fileBuffer
.append(" )\n\n");
869 fileBuffer
.append("{\n");
870 if (entryPointCount
== 1) {
871 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[0], entryPointList
[0]));
872 fileBuffer
.append(" return ");
873 fileBuffer
.append(entryPointList
[0]);
874 fileBuffer
.append(" (FfsHeader, PeiServices);\n");
876 fileBuffer
.append(" EFI_STATUS Status;\n");
877 fileBuffer
.append(" EFI_STATUS CombinedStatus;\n\n");
878 fileBuffer
.append(" CombinedStatus = EFI_LOAD_ERROR;\n\n");
879 for (int i
= 0; i
< entryPointList
.length
; i
++) {
880 if (!entryPointList
[i
].equals("")) {
881 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
882 fileBuffer
.append(" Status = ");
883 fileBuffer
.append(entryPointList
[i
]);
884 fileBuffer
.append(" (FfsHeader, PeiServices);\n");
885 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (CombinedStatus)) {\n");
886 fileBuffer
.append(" CombinedStatus = Status;\n");
887 fileBuffer
.append(" }\n\n");
892 fileBuffer
.append(" return CombinedStatus;\n");
894 fileBuffer
.append("}\n\n");
897 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
900 // If entryPoint is null, create an empty ProcessModuleEntryPointList
903 if (entryPointList
== null || entryPointList
.length
== 0) {
904 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
905 fileBuffer
.append(Integer
.toString(entryPointCount
));
906 fileBuffer
.append(";\n");
907 fileBuffer
.append("EFI_STATUS\n");
908 fileBuffer
.append("EFIAPI\n");
909 fileBuffer
.append("ProcessModuleEntryPointList (\n");
910 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
911 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
912 fileBuffer
.append(" )\n\n");
913 fileBuffer
.append("{\n");
914 fileBuffer
.append(" return EFI_SUCCESS;\n");
915 fileBuffer
.append("}\n\n");
918 for (int i
= 0; i
< entryPointList
.length
; i
++) {
919 fileBuffer
.append("EFI_STATUS\n");
920 fileBuffer
.append("EFIAPI\n");
921 fileBuffer
.append(entryPointList
[i
]);
922 fileBuffer
.append(" (\n");
923 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
924 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
925 fileBuffer
.append(" );\n");
928 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
929 fileBuffer
.append(Integer
.toString(entryPointCount
));
930 fileBuffer
.append(";\n");
931 fileBuffer
.append("static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\n");
932 fileBuffer
.append("static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\n\n");
934 fileBuffer
.append("EFI_STATUS\n");
935 fileBuffer
.append("EFIAPI\n");
936 fileBuffer
.append("ProcessModuleEntryPointList (\n");
937 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
938 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
939 fileBuffer
.append(" )\n\n");
940 fileBuffer
.append("{\n");
942 for (int i
= 0; i
< entryPointList
.length
; i
++) {
943 fileBuffer
.append(" if (SetJump (&mJumpContext) == 0) {\n");
944 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
945 fileBuffer
.append(" ExitDriver (");
946 fileBuffer
.append(entryPointList
[i
]);
947 fileBuffer
.append(" (ImageHandle, SystemTable));\n");
948 fileBuffer
.append(" ASSERT (FALSE);\n");
949 fileBuffer
.append(" }\n");
951 fileBuffer
.append(" return mDriverEntryPointStatus;\n");
952 fileBuffer
.append("}\n\n");
954 fileBuffer
.append("VOID\n");
955 fileBuffer
.append("EFIAPI\n");
956 fileBuffer
.append("ExitDriver (\n");
957 fileBuffer
.append(" IN EFI_STATUS Status\n");
958 fileBuffer
.append(" )\n\n");
959 fileBuffer
.append("{\n");
960 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\n");
961 fileBuffer
.append(" mDriverEntryPointStatus = Status;\n");
962 fileBuffer
.append(" }\n");
963 fileBuffer
.append(" LongJump (&mJumpContext, (UINTN)-1);\n");
964 fileBuffer
.append(" ASSERT (FALSE);\n");
965 fileBuffer
.append("}\n\n");
970 // Add "ModuleUnloadImage" for DxeSmmDriver module type;
972 //entryPointList = SurfaceAreaQuery.getModuleUnloadImageArray();
973 //entryPointList = CommonDefinition.remDupString(entryPointList);
974 //entryPointCount = 0;
976 unloadImageCount
= 0;
977 if (unloadImageList
!= null) {
978 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
979 fileBuffer
.append("EFI_STATUS\n");
980 fileBuffer
.append(unloadImageList
[i
]);
981 fileBuffer
.append(" (\n");
982 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\n");
983 fileBuffer
.append(" );\n");
988 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ");
989 fileBuffer
.append(Integer
.toString(unloadImageCount
));
990 fileBuffer
.append(";\n\n");
992 fileBuffer
.append("EFI_STATUS\n");
993 fileBuffer
.append("EFIAPI\n");
994 fileBuffer
.append("ProcessModuleUnloadList (\n");
995 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\n");
996 fileBuffer
.append(" )\n");
997 fileBuffer
.append("{\n");
999 if (unloadImageCount
== 0) {
1000 fileBuffer
.append(" return EFI_SUCCESS;\n");
1001 } else if (unloadImageCount
== 1) {
1002 fileBuffer
.append(" return ");
1003 fileBuffer
.append(unloadImageList
[0]);
1004 fileBuffer
.append("(ImageHandle);\n");
1006 fileBuffer
.append(" EFI_STATUS Status;\n\n");
1007 fileBuffer
.append(" Status = EFI_SUCCESS;\n\n");
1008 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1010 fileBuffer
.append(" Status = ");
1011 fileBuffer
.append(unloadImageList
[i
]);
1012 fileBuffer
.append("(ImageHandle);\n");
1014 fileBuffer
.append(" if (EFI_ERROR (Status)) {\n");
1015 fileBuffer
.append(" ");
1016 fileBuffer
.append(unloadImageList
[i
]);
1017 fileBuffer
.append("(ImageHandle);\n");
1018 fileBuffer
.append(" } else {\n");
1019 fileBuffer
.append(" Status = ");
1020 fileBuffer
.append(unloadImageList
[i
]);
1021 fileBuffer
.append("(ImageHandle);\n");
1022 fileBuffer
.append(" }\n");
1025 fileBuffer
.append(" return Status;\n");
1027 fileBuffer
.append("}\n\n");
1030 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1031 case CommonDefinition
.ModuleTypeDxeDriver
:
1032 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1033 case CommonDefinition
.ModuleTypeUefiDriver
:
1034 case CommonDefinition
.ModuleTypeUefiApplication
:
1035 entryPointCount
= 0;
1036 fileBuffer
.append("const UINT32 _gUefiDriverRevision = 0;\n");
1038 // If entry point is null, create a empty ProcessModuleEntryPointList function.
1040 if (entryPointList
== null || entryPointList
.length
== 0) {
1041 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = 0;\n");
1042 fileBuffer
.append("EFI_STATUS\n");
1043 fileBuffer
.append("EFIAPI\n");
1044 fileBuffer
.append("ProcessModuleEntryPointList (\n");
1045 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1046 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1047 fileBuffer
.append(" )\n\n");
1048 fileBuffer
.append("{\n");
1049 fileBuffer
.append(" return EFI_SUCCESS;\n");
1050 fileBuffer
.append("}\n");
1053 for (int i
= 0; i
< entryPointList
.length
; i
++) {
1055 fileBuffer
.append("EFI_STATUS\n");
1056 fileBuffer
.append("EFIAPI\n");
1057 fileBuffer
.append(entryPointList
[i
]);
1058 fileBuffer
.append(" (\n");
1059 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1060 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1061 fileBuffer
.append(" );\n");
1065 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverEntryPointCount = ");
1066 fileBuffer
.append(Integer
.toString(entryPointCount
));
1067 fileBuffer
.append(";\n");
1068 if (entryPointCount
> 1) {
1069 fileBuffer
.append("static BASE_LIBRARY_JUMP_BUFFER mJumpContext;\n");
1070 fileBuffer
.append("static EFI_STATUS mDriverEntryPointStatus = EFI_LOAD_ERROR;\n");
1072 fileBuffer
.append("\n");
1074 fileBuffer
.append("EFI_STATUS\n");
1075 fileBuffer
.append("EFIAPI\n");
1076 fileBuffer
.append("ProcessModuleEntryPointList (\n");
1077 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1078 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1079 fileBuffer
.append(" )\n\n");
1080 fileBuffer
.append("{\n");
1082 if (entryPointCount
== 1) {
1083 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[0], entryPointList
[0]));
1084 fileBuffer
.append(" return ");
1085 fileBuffer
.append(entryPointList
[0]);
1086 fileBuffer
.append(" (ImageHandle, SystemTable);\n");
1088 for (int i
= 0; i
< entryPointList
.length
; i
++) {
1089 if (!entryPointList
[i
].equals("")) {
1090 fileBuffer
.append(" if (SetJump (&mJumpContext) == 0) {\n");
1091 fileBuffer
.append(String
.format(" " + debugStr
, entryPointList
[i
], entryPointList
[i
]));
1092 fileBuffer
.append(" ExitDriver (");
1093 fileBuffer
.append(entryPointList
[i
]);
1094 fileBuffer
.append(" (ImageHandle, SystemTable));\n");
1095 fileBuffer
.append(" ASSERT (FALSE);\n");
1096 fileBuffer
.append(" }\n");
1101 fileBuffer
.append(" return mDriverEntryPointStatus;\n");
1103 fileBuffer
.append("}\n\n");
1105 fileBuffer
.append("VOID\n");
1106 fileBuffer
.append("EFIAPI\n");
1107 fileBuffer
.append("ExitDriver (\n");
1108 fileBuffer
.append(" IN EFI_STATUS Status\n");
1109 fileBuffer
.append(" )\n\n");
1110 fileBuffer
.append("{\n");
1111 if (entryPointCount
<= 1) {
1112 fileBuffer
.append(" if (EFI_ERROR (Status)) {\n");
1113 fileBuffer
.append(" ProcessLibraryDestructorList (gImageHandle, gST);\n");
1114 fileBuffer
.append(" }\n");
1116 .append(" gBS->Exit (gImageHandle, Status, 0, NULL);\n");
1118 fileBuffer
.append(" if (!EFI_ERROR (Status) || EFI_ERROR (mDriverEntryPointStatus)) {\n");
1119 fileBuffer
.append(" mDriverEntryPointStatus = Status;\n");
1120 fileBuffer
.append(" }\n");
1121 fileBuffer
.append(" LongJump (&mJumpContext, (UINTN)-1);\n");
1122 fileBuffer
.append(" ASSERT (FALSE);\n");
1124 fileBuffer
.append("}\n\n");
1128 // Add ModuleUnloadImage for DxeDriver and UefiDriver module type.
1130 //entryPointList = SurfaceAreaQuery.getModuleUnloadImageArray();
1132 // Remover duplicate unload entry point.
1134 //entryPointList = CommonDefinition.remDupString(entryPointList);
1135 //entryPointCount = 0;
1136 unloadImageCount
= 0;
1137 if (unloadImageList
!= null) {
1138 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1139 fileBuffer
.append("EFI_STATUS\n");
1140 fileBuffer
.append("EFIAPI\n");
1141 fileBuffer
.append(unloadImageList
[i
]);
1142 fileBuffer
.append(" (\n");
1143 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\n");
1144 fileBuffer
.append(" );\n");
1149 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = ");
1150 fileBuffer
.append(Integer
.toString(unloadImageCount
));
1151 fileBuffer
.append(";\n\n");
1153 fileBuffer
.append("EFI_STATUS\n");
1154 fileBuffer
.append("EFIAPI\n");
1155 fileBuffer
.append("ProcessModuleUnloadList (\n");
1156 fileBuffer
.append(" IN EFI_HANDLE ImageHandle\n");
1157 fileBuffer
.append(" )\n");
1158 fileBuffer
.append("{\n");
1160 if (unloadImageCount
== 0) {
1161 fileBuffer
.append(" return EFI_SUCCESS;\n");
1162 } else if (unloadImageCount
== 1) {
1163 fileBuffer
.append(" return ");
1164 fileBuffer
.append(unloadImageList
[0]);
1165 fileBuffer
.append("(ImageHandle);\n");
1167 fileBuffer
.append(" EFI_STATUS Status;\n\n");
1168 fileBuffer
.append(" Status = EFI_SUCCESS;\n\n");
1169 for (int i
= 0; i
< unloadImageList
.length
; i
++) {
1171 fileBuffer
.append(" Status = ");
1172 fileBuffer
.append(unloadImageList
[i
]);
1173 fileBuffer
.append("(ImageHandle);\n");
1175 fileBuffer
.append(" if (EFI_ERROR (Status)) {\n");
1176 fileBuffer
.append(" ");
1177 fileBuffer
.append(unloadImageList
[i
]);
1178 fileBuffer
.append("(ImageHandle);\n");
1179 fileBuffer
.append(" } else {\n");
1180 fileBuffer
.append(" Status = ");
1181 fileBuffer
.append(unloadImageList
[i
]);
1182 fileBuffer
.append("(ImageHandle);\n");
1183 fileBuffer
.append(" }\n");
1186 fileBuffer
.append(" return Status;\n");
1188 fileBuffer
.append("}\n\n");
1196 This function gets GUIDs from SPD file accrodeing to <PPIs> information
1197 and write those GUIDs to AutoGen.c.
1200 String Buffer for Autogen.c file.
1201 @throws BuildException
1202 Guid must set value!
1204 void PpiGuidToAutogenC(StringBuffer fileBuffer
) throws AutoGenException
{
1205 String
[] cNameGuid
= null;
1208 // Get the all PPI adn PPI Notify from MSA file,
1209 // then add those PPI ,and PPI Notify name to list.
1212 String
[] ppiList
= saq
.getPpiArray(this.arch
);
1213 for (int i
= 0; i
< ppiList
.length
; i
++) {
1214 this.mPpiList
.add(ppiList
[i
]);
1217 String
[] ppiNotifyList
= saq
.getPpiNotifyArray(this.arch
);
1218 for (int i
= 0; i
< ppiNotifyList
.length
; i
++) {
1219 this.mPpiList
.add(ppiNotifyList
[i
]);
1223 // Find CNAME and GUID from dependence SPD file and write to Autogen.c
1225 Iterator ppiIterator
= this.mPpiList
.iterator();
1226 String ppiKeyWord
= null;
1227 while (ppiIterator
.hasNext()) {
1228 ppiKeyWord
= ppiIterator
.next().toString();
1229 cNameGuid
= GlobalData
.getPpiGuid(this.mDepPkgList
, ppiKeyWord
);
1230 if (cNameGuid
!= null) {
1231 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1232 fileBuffer
.append(cNameGuid
[0]);
1233 fileBuffer
.append(" = { ");
1234 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1235 fileBuffer
.append(" } ;");
1238 // If can't find Ppi GUID declaration in every package
1240 throw new AutoGenException("Can not find Ppi GUID ["
1241 + ppiKeyWord
+ "] declaration in any SPD package!");
1247 ProtocolGuidToAutogenc
1249 This function gets GUIDs from SPD file accrodeing to <Protocol>
1250 information and write those GUIDs to AutoGen.c.
1253 String Buffer for Autogen.c file.
1254 @throws BuildException
1255 Protocol name must set.
1257 void ProtocolGuidToAutogenC(StringBuffer fileBuffer
) throws EdkException
{
1258 String
[] cNameGuid
= null;
1260 String
[] protocolList
= saq
.getProtocolArray(this.arch
);
1263 // Add result to Autogen global list.
1265 for (int i
= 0; i
< protocolList
.length
; i
++) {
1266 this.mProtocolList
.add(protocolList
[i
]);
1269 String
[] protocolNotifyList
= saq
.getProtocolNotifyArray(this.arch
);
1271 for (int i
= 0; i
< protocolNotifyList
.length
; i
++) {
1272 this.mProtocolList
.add(protocolNotifyList
[i
]);
1276 // Get the NAME and GUID from dependence SPD and write to Autogen.c
1278 Iterator protocolIterator
= this.mProtocolList
.iterator();
1279 String protocolKeyWord
= null;
1282 while (protocolIterator
.hasNext()) {
1283 protocolKeyWord
= protocolIterator
.next().toString();
1284 cNameGuid
= GlobalData
.getProtocolGuid(this.mDepPkgList
, protocolKeyWord
);
1285 if (cNameGuid
!= null) {
1286 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1287 fileBuffer
.append(cNameGuid
[0]);
1288 fileBuffer
.append(" = { ");
1289 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1290 fileBuffer
.append(" } ;");
1293 // If can't find protocol GUID declaration in every package
1295 throw new AutoGenException("Can not find protocol Guid ["
1296 + protocolKeyWord
+ "] declaration in any SPD package!");
1304 This function gets GUIDs from SPD file accrodeing to <Guids> information
1305 and write those GUIDs to AutoGen.c.
1308 String Buffer for Autogen.c file.
1311 void GuidGuidToAutogenC(StringBuffer fileBuffer
) throws AutoGenException
{
1312 String
[] cNameGuid
= null;
1313 String guidKeyWord
= null;
1315 String
[] guidList
= saq
.getGuidEntryArray(this.arch
);
1317 for (int i
= 0; i
< guidList
.length
; i
++) {
1318 this.mGuidList
.add(guidList
[i
]);
1322 Iterator guidIterator
= this.mGuidList
.iterator();
1323 while (guidIterator
.hasNext()) {
1324 guidKeyWord
= guidIterator
.next().toString();
1325 cNameGuid
= GlobalData
.getGuid(this.mDepPkgList
, guidKeyWord
);
1327 if (cNameGuid
!= null) {
1328 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID ");
1329 fileBuffer
.append(cNameGuid
[0]);
1330 fileBuffer
.append(" = { ");
1331 fileBuffer
.append(CommonDefinition
.formatGuidName(cNameGuid
[1]));
1332 fileBuffer
.append("} ;");
1335 // If can't find GUID declaration in every package
1337 throw new AutoGenException("Can not find Guid [" + guidKeyWord
1338 + "] declaration in any SPD package. ");
1345 LibInstanceToAutogenC
1347 This function adds dependent library instance to autogen.c,which
1348 includeing library's constructor, destructor, and library dependent ppi,
1349 protocol, guid, pcd information.
1352 String buffer for AutoGen.c
1353 @throws BuildException
1355 void LibInstanceToAutogenC(StringBuffer fileBuffer
) throws EdkException
{
1356 String moduleType
= this.moduleId
.getModuleType();
1358 // Add library constructor to AutoGen.c
1360 LibConstructorToAutogenC(libConstructList
, moduleType
,
1361 fileBuffer
/* autogenC */);
1363 // Add library destructor to AutoGen.c
1365 LibDestructorToAutogenC(libDestructList
, moduleType
, fileBuffer
/* autogenC */);
1369 LibConstructorToAutogenH
1371 This function writes library constructor declarations AutoGen.h. The library
1372 constructor's parameter and return value depend on module type.
1374 @param libInstanceList
1375 List of library construct name.
1379 String buffer for AutoGen.c
1382 void LibConstructorToAutogenH(String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1383 boolean isFirst
= true;
1386 // If not yet parse this library instance's constructor
1387 // element,parse it.
1389 String libConstructName
= saq
.getLibConstructorName();
1390 if (libConstructName
== null) {
1395 // The library constructor's parameter and return value depend on
1398 if (moduleType
.equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1399 fileBuffer
.append("RETURN_STATUS\n");
1400 fileBuffer
.append("EFIAPI\n");
1401 fileBuffer
.append(libConstructName
);
1402 fileBuffer
.append(" (\n");
1403 fileBuffer
.append(" VOID\n");
1404 fileBuffer
.append(" );\n");
1406 switch (CommonDefinition
.getModuleType(moduleType
)) {
1407 case CommonDefinition
.ModuleTypeBase
:
1408 fileBuffer
.append("RETURN_STATUS\n");
1409 fileBuffer
.append("EFIAPI\n");
1410 fileBuffer
.append(libConstructName
);
1411 fileBuffer
.append(" (\n");
1412 fileBuffer
.append(" VOID\n");
1413 fileBuffer
.append(" );\n");
1416 case CommonDefinition
.ModuleTypePeiCore
:
1417 case CommonDefinition
.ModuleTypePeim
:
1418 fileBuffer
.append("EFI_STATUS\n");
1419 fileBuffer
.append("EFIAPI\n");
1420 fileBuffer
.append(libConstructName
);
1421 fileBuffer
.append(" (\n");
1422 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
1423 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
1424 fileBuffer
.append(" );\n");
1427 case CommonDefinition
.ModuleTypeDxeCore
:
1428 case CommonDefinition
.ModuleTypeDxeDriver
:
1429 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1430 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1431 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1432 case CommonDefinition
.ModuleTypeUefiDriver
:
1433 case CommonDefinition
.ModuleTypeUefiApplication
:
1434 fileBuffer
.append("EFI_STATUS\n");
1435 fileBuffer
.append("EFIAPI\n");
1436 fileBuffer
.append(libConstructName
);
1437 fileBuffer
.append(" (\n");
1438 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1439 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1440 fileBuffer
.append(" );\n");
1448 LibDestructorToAutogenH
1450 This function writes library destructor declarations AutoGen.h. The library
1451 destructor's parameter and return value depend on module type.
1453 @param libInstanceList
1454 List of library destructor name.
1458 String buffer for AutoGen.c
1461 void LibDestructorToAutogenH(String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1462 boolean isFirst
= true;
1463 String libDestructName
= saq
.getLibDestructorName();
1464 if (libDestructName
== null) {
1468 if (moduleType
.equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1469 fileBuffer
.append("RETURN_STATUS\n");
1470 fileBuffer
.append("EFIAPI\n");
1471 fileBuffer
.append(libDestructName
);
1472 fileBuffer
.append(" (\n");
1473 fileBuffer
.append(" VOID\n");
1474 fileBuffer
.append(" );\n");
1476 switch (CommonDefinition
.getModuleType(moduleType
)) {
1477 case CommonDefinition
.ModuleTypeBase
:
1478 fileBuffer
.append("RETURN_STATUS\n");
1479 fileBuffer
.append("EFIAPI\n");
1480 fileBuffer
.append(libDestructName
);
1481 fileBuffer
.append(" (\n");
1482 fileBuffer
.append(" VOID\n");
1483 fileBuffer
.append(" );\n");
1485 case CommonDefinition
.ModuleTypePeiCore
:
1486 case CommonDefinition
.ModuleTypePeim
:
1487 fileBuffer
.append("EFI_STATUS\n");
1488 fileBuffer
.append("EFIAPI\n");
1489 fileBuffer
.append(libDestructName
);
1490 fileBuffer
.append(" (\n");
1491 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
1492 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
1493 fileBuffer
.append(" );\n");
1495 case CommonDefinition
.ModuleTypeDxeCore
:
1496 case CommonDefinition
.ModuleTypeDxeDriver
:
1497 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1498 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1499 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1500 case CommonDefinition
.ModuleTypeUefiDriver
:
1501 case CommonDefinition
.ModuleTypeUefiApplication
:
1502 fileBuffer
.append("EFI_STATUS\n");
1503 fileBuffer
.append("EFIAPI\n");
1504 fileBuffer
.append(libDestructName
);
1505 fileBuffer
.append(" (\n");
1506 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1507 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1508 fileBuffer
.append(" );\n");
1515 LibConstructorToAutogenc
1517 This function writes library constructor list to AutoGen.c. The library
1518 constructor's parameter and return value depend on module type.
1520 @param libInstanceList
1521 List of library construct name.
1525 String buffer for AutoGen.c
1528 void LibConstructorToAutogenC(List
<String
[]> libInstanceList
,
1529 String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1530 boolean isFirst
= true;
1533 // The library constructor's parameter and return value depend on
1536 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1537 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1538 fileBuffer
.append("RETURN_STATUS\n");
1539 fileBuffer
.append("EFIAPI\n");
1540 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1541 fileBuffer
.append(" (\n");
1542 fileBuffer
.append(" VOID\n");
1543 fileBuffer
.append(" );\n");
1545 switch (CommonDefinition
.getModuleType(moduleType
)) {
1546 case CommonDefinition
.ModuleTypeBase
:
1547 fileBuffer
.append("RETURN_STATUS\n");
1548 fileBuffer
.append("EFIAPI\n");
1549 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1550 fileBuffer
.append(" (\n");
1551 fileBuffer
.append(" VOID\n");
1552 fileBuffer
.append(" );\n");
1555 case CommonDefinition
.ModuleTypePeiCore
:
1556 case CommonDefinition
.ModuleTypePeim
:
1557 fileBuffer
.append("EFI_STATUS\n");
1558 fileBuffer
.append("EFIAPI\n");
1559 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1560 fileBuffer
.append(" (\n");
1561 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
1562 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
1563 fileBuffer
.append(" );\n");
1566 case CommonDefinition
.ModuleTypeDxeCore
:
1567 case CommonDefinition
.ModuleTypeDxeDriver
:
1568 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1569 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1570 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1571 case CommonDefinition
.ModuleTypeUefiDriver
:
1572 case CommonDefinition
.ModuleTypeUefiApplication
:
1573 fileBuffer
.append("EFI_STATUS\n");
1574 fileBuffer
.append("EFIAPI\n");
1575 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1576 fileBuffer
.append(" (\n");
1577 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1578 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1579 fileBuffer
.append(" );\n");
1587 // Add ProcessLibraryConstructorList in AutoGen.c
1589 fileBuffer
.append("VOID\n");
1590 fileBuffer
.append("EFIAPI\n");
1591 fileBuffer
.append("ProcessLibraryConstructorList (\n");
1592 switch (CommonDefinition
.getModuleType(moduleType
)) {
1593 case CommonDefinition
.ModuleTypeBase
:
1594 fileBuffer
.append(" VOID\n");
1597 case CommonDefinition
.ModuleTypePeiCore
:
1598 case CommonDefinition
.ModuleTypePeim
:
1599 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
1601 .append(" IN EFI_PEI_SERVICES **PeiServices\n");
1604 case CommonDefinition
.ModuleTypeDxeCore
:
1605 case CommonDefinition
.ModuleTypeDxeDriver
:
1606 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1607 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1608 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1609 case CommonDefinition
.ModuleTypeUefiDriver
:
1610 case CommonDefinition
.ModuleTypeUefiApplication
:
1611 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1612 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1616 fileBuffer
.append(" )\n");
1617 fileBuffer
.append("{\n");
1619 // If no constructor function, return EFI_SUCCESS.
1621 //if (libInstanceList.size() == 0){
1622 // fileBuffer.append(" return EFI_SUCCESS;\n");
1624 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1626 fileBuffer
.append(" EFI_STATUS Status;\n");
1627 fileBuffer
.append(" Status = EFI_SUCCESS;\n");
1628 fileBuffer
.append("\n");
1631 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1632 fileBuffer
.append(" Status = ");
1633 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1634 fileBuffer
.append("();\n");
1636 switch (CommonDefinition
.getModuleType(moduleType
)) {
1637 case CommonDefinition
.ModuleTypeBase
:
1638 fileBuffer
.append(" Status = ");
1639 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1640 fileBuffer
.append("();\n");
1642 case CommonDefinition
.ModuleTypePeiCore
:
1643 case CommonDefinition
.ModuleTypePeim
:
1644 fileBuffer
.append(" Status = ");
1645 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1646 fileBuffer
.append(" (FfsHeader, PeiServices);\n");
1648 case CommonDefinition
.ModuleTypeDxeCore
:
1649 case CommonDefinition
.ModuleTypeDxeDriver
:
1650 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1651 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1652 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1653 case CommonDefinition
.ModuleTypeUefiDriver
:
1654 case CommonDefinition
.ModuleTypeUefiApplication
:
1655 fileBuffer
.append(" Status = ");
1656 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1657 fileBuffer
.append(" (ImageHandle, SystemTable);\n");
1660 EdkLog
.log(EdkLog
.EDK_INFO
,"Autogen doesn't know how to deal with module type - " + moduleType
+ "!");
1664 fileBuffer
.append(" ASSERT_EFI_ERROR (Status);\n");
1666 fileBuffer
.append("}\n");
1670 LibDestructorToAutogenc
1672 This function writes library destructor list to AutoGen.c. The library
1673 destructor's parameter and return value depend on module type.
1675 @param libInstanceList
1676 List of library destructor name.
1680 String buffer for AutoGen.c
1683 void LibDestructorToAutogenC(List
<String
[]> libInstanceList
,
1684 String moduleType
, StringBuffer fileBuffer
) throws EdkException
{
1685 boolean isFirst
= true;
1686 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1687 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1688 fileBuffer
.append("RETURN_STATUS\n");
1689 fileBuffer
.append("EFIAPI\n");
1690 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1691 fileBuffer
.append(" (\n");
1692 fileBuffer
.append(" VOID\n");
1693 fileBuffer
.append(" );\n");
1695 switch (CommonDefinition
.getModuleType(moduleType
)) {
1696 case CommonDefinition
.ModuleTypeBase
:
1697 fileBuffer
.append("RETURN_STATUS\n");
1698 fileBuffer
.append("EFIAPI\n");
1699 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1700 fileBuffer
.append(" (\n");
1701 fileBuffer
.append(" VOID\n");
1702 fileBuffer
.append(" );\n");
1704 case CommonDefinition
.ModuleTypePeiCore
:
1705 case CommonDefinition
.ModuleTypePeim
:
1706 fileBuffer
.append("EFI_STATUS\n");
1707 fileBuffer
.append("EFIAPI\n");
1708 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1709 fileBuffer
.append(" (\n");
1710 fileBuffer
.append(" IN EFI_FFS_FILE_HEADER *FfsHeader,\n");
1711 fileBuffer
.append(" IN EFI_PEI_SERVICES **PeiServices\n");
1712 fileBuffer
.append(" );\n");
1714 case CommonDefinition
.ModuleTypeDxeCore
:
1715 case CommonDefinition
.ModuleTypeDxeDriver
:
1716 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1717 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1718 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1719 case CommonDefinition
.ModuleTypeUefiDriver
:
1720 case CommonDefinition
.ModuleTypeUefiApplication
:
1721 fileBuffer
.append("EFI_STATUS\n");
1722 fileBuffer
.append("EFIAPI\n");
1723 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1724 fileBuffer
.append(" (\n");
1725 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1726 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1727 fileBuffer
.append(" );\n");
1734 // Write ProcessLibraryDestructor list to autogen.c
1736 switch (CommonDefinition
.getModuleType(moduleType
)) {
1737 case CommonDefinition
.ModuleTypeBase
:
1738 case CommonDefinition
.ModuleTypePeiCore
:
1739 case CommonDefinition
.ModuleTypePeim
:
1741 case CommonDefinition
.ModuleTypeDxeCore
:
1742 case CommonDefinition
.ModuleTypeDxeDriver
:
1743 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1744 case CommonDefinition
.ModuleTypeDxeSmmDriver
:
1745 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1746 case CommonDefinition
.ModuleTypeUefiDriver
:
1747 case CommonDefinition
.ModuleTypeUefiApplication
:
1748 fileBuffer
.append("VOID\n");
1749 fileBuffer
.append("EFIAPI\n");
1750 fileBuffer
.append("ProcessLibraryDestructorList (\n");
1751 fileBuffer
.append(" IN EFI_HANDLE ImageHandle,\n");
1752 fileBuffer
.append(" IN EFI_SYSTEM_TABLE *SystemTable\n");
1753 fileBuffer
.append(" )\n");
1754 fileBuffer
.append("{\n");
1756 // If no library destructor function, return EFI_SUCCESS.
1759 for (int i
= 0; i
< libInstanceList
.size(); i
++) {
1761 fileBuffer
.append(" EFI_STATUS Status;\n");
1762 fileBuffer
.append(" Status = EFI_SUCCESS;\n");
1763 fileBuffer
.append("\n");
1766 if (libInstanceList
.get(i
)[1].equalsIgnoreCase(EdkDefinitions
.MODULE_TYPE_BASE
)) {
1767 fileBuffer
.append(" Status = ");
1768 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1769 fileBuffer
.append("();\n");
1770 fileBuffer
.append(" VOID\n");
1772 fileBuffer
.append(" Status = ");
1773 fileBuffer
.append(libInstanceList
.get(i
)[0]);
1774 fileBuffer
.append("(ImageHandle, SystemTable);\n");
1775 fileBuffer
.append(" ASSERT_EFI_ERROR (Status);\n");
1778 fileBuffer
.append("}\n");
1784 ExternsDriverBindingToAutoGenC
1786 This function is to write DRIVER_BINDING, COMPONENT_NAME,
1787 DRIVER_CONFIGURATION, DRIVER_DIAGNOSTIC in AutoGen.c.
1790 String buffer for AutoGen.c
1792 void ExternsDriverBindingToAutoGenC(StringBuffer fileBuffer
)
1793 throws EdkException
{
1795 // Get the arry of extern. The driverBindingGroup is a 2 dimension array.
1796 // The second dimension is include following element: DriverBinding,
1797 // ComponentName, DriverConfiguration, DriverDiag;
1799 String
[][] driverBindingGroup
= this.saq
.getExternProtocolGroup();
1808 // Write driver binding protocol extern to autogen.c
1810 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1811 if (driverBindingGroup
[i
][0] != null) {
1812 fileBuffer
.append("extern EFI_DRIVER_BINDING_PROTOCOL ");
1813 fileBuffer
.append(driverBindingGroup
[i
][0]);
1814 fileBuffer
.append(";\n");
1819 // Write component name protocol extern to autogen.c
1821 if (!componentNamePcd
) {
1822 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1823 if (driverBindingGroup
[i
][1]!= null) {
1824 if (driverBindingGroup
[i
][0] != null) {
1826 fileBuffer
.append("extern EFI_COMPONENT_NAME_PROTOCOL ");
1827 fileBuffer
.append(driverBindingGroup
[i
][1]);
1828 fileBuffer
.append(";\n");
1830 throw new AutoGenException("DriverBinding can't be empty!!");
1837 // Write driver configration protocol extern to autogen.c
1839 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1840 if (driverBindingGroup
[i
][2] != null) {
1841 if (driverBindingGroup
[i
][0] != null) {
1843 fileBuffer
.append("extern EFI_DRIVER_CONFIGURATION_PROTOCOL ");
1844 fileBuffer
.append(driverBindingGroup
[i
][2]);
1845 fileBuffer
.append(";\n");
1847 throw new AutoGenException("DriverBinding can't be empty!!");
1853 // Write driver dignastic protocol extern to autogen.c
1855 if (!driverDiagnostPcd
) {
1856 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1857 if (driverBindingGroup
[i
][3] != null) {
1858 if (driverBindingGroup
[i
][0] != null) {
1860 fileBuffer
.append("extern EFI_DRIVER_DIAGNOSTICS_PROTOCOL ");
1861 fileBuffer
.append(driverBindingGroup
[i
][3]);
1862 fileBuffer
.append(";\n");
1864 throw new AutoGenException("DriverBinding can't be empty!!");
1872 // Write driver module protocol bitmask.
1874 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverModelProtocolBitmask = ");
1875 fileBuffer
.append(Integer
.toString(BitMask
));
1876 fileBuffer
.append(";\n");
1879 // Write driver module protocol list entry
1881 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverModelProtocolListEntries = ");
1883 fileBuffer
.append(Integer
.toString(driverBindingGroup
.length
));
1884 fileBuffer
.append(";\n");
1887 // Write drive module protocol list to autogen.c
1889 if (driverBindingGroup
.length
> 0) {
1890 fileBuffer
.append("GLOBAL_REMOVE_IF_UNREFERENCED const EFI_DRIVER_MODEL_PROTOCOL_LIST _gDriverModelProtocolList[] = {");
1894 for (int i
= 0; i
< driverBindingGroup
.length
; i
++) {
1896 fileBuffer
.append(",");
1901 fileBuffer
.append("\n {\n");
1902 fileBuffer
.append(" &");
1903 fileBuffer
.append(driverBindingGroup
[i
][0]);
1904 fileBuffer
.append(", \n");
1909 if (driverBindingGroup
[i
][1] != null && componentNamePcd
!= true) {
1910 fileBuffer
.append(" &");
1911 fileBuffer
.append(driverBindingGroup
[i
][1]);
1912 fileBuffer
.append(", \n");
1914 fileBuffer
.append(" NULL, \n");
1918 // DriverConfiguration
1920 if (driverBindingGroup
[i
][2] != null) {
1921 fileBuffer
.append(" &");
1922 fileBuffer
.append(driverBindingGroup
[i
][2]);
1923 fileBuffer
.append(", \n");
1925 fileBuffer
.append(" NULL, \n");
1931 if (driverBindingGroup
[i
][3] != null && driverDiagnostPcd
!= true) {
1932 fileBuffer
.append(" &");
1933 fileBuffer
.append(driverBindingGroup
[i
][3]);
1934 fileBuffer
.append(", \n");
1936 fileBuffer
.append(" NULL, \n");
1938 fileBuffer
.append(" }");
1941 if (driverBindingGroup
.length
> 0) {
1942 fileBuffer
.append("\n};\n");
1947 ExternCallBackToAutoGenC
1949 This function adds <SetVirtualAddressMapCallBack> and
1950 <ExitBootServicesCallBack> infomation to AutoGen.c
1953 String buffer for AutoGen.c
1954 @throws BuildException
1956 void ExternCallBackToAutoGenC(StringBuffer fileBuffer
)
1957 throws EdkException
{
1959 // Collect module's <SetVirtualAddressMapCallBack> and
1960 // <ExitBootServiceCallBack> and add to setVirtualAddList
1961 // exitBootServiceList.
1963 String
[] setVirtuals
= saq
.getSetVirtualAddressMapCallBackArray();
1964 String
[] exitBoots
= saq
.getExitBootServicesCallBackArray();
1965 if (setVirtuals
!= null) {
1966 for (int j
= 0; j
< setVirtuals
.length
; j
++) {
1967 this.setVirtalAddList
.add(setVirtuals
[j
]);
1970 if (exitBoots
!= null) {
1971 for (int k
= 0; k
< exitBoots
.length
; k
++) {
1972 this.exitBootServiceList
.add(exitBoots
[k
]);
1976 // Add c code in autogen.c which relate to <SetVirtualAddressMapCallBack>
1977 // and <ExitBootServicesCallBack>
1979 String moduleType
= this.moduleId
.getModuleType();
1980 switch (CommonDefinition
.getModuleType(moduleType
)) {
1981 case CommonDefinition
.ModuleTypeDxeDriver
:
1982 case CommonDefinition
.ModuleTypeDxeRuntimeDriver
:
1983 case CommonDefinition
.ModuleTypeDxeSalDriver
:
1984 case CommonDefinition
.ModuleTypeUefiDriver
:
1985 case CommonDefinition
.ModuleTypeUefiApplication
:
1987 // If moduleType is one of above, call setVirtualAddressToAutogenC,
1988 // and setExitBootServiceToAutogenC.
1990 setVirtualAddressToAutogenC(fileBuffer
);
1991 setExitBootServiceToAutogenC(fileBuffer
);
1999 copyFlashMapHToDebugDir
2001 This function is to copy the falshmap.h to debug directory and change
2002 its name to TianoR8FlashMap.h
2007 private void copyFlashMapHToDebugDir() throws AutoGenException
{
2009 File inFile
= new File(fvDir
+ File
.separatorChar
+ CommonDefinition
.FLASHMAPH
);
2010 int size
= (int)inFile
.length();
2011 byte[] buffer
= new byte[size
];
2012 File outFile
= new File (this.outputPath
+ File
.separatorChar
+ CommonDefinition
.TIANOR8PLASHMAPH
);
2014 // If TianoR8FlashMap.h existed and the flashMap.h don't change,
2017 if ((!outFile
.exists()) ||(inFile
.lastModified() - outFile
.lastModified()) >= 0) {
2018 if (inFile
.exists()) {
2020 FileInputStream fis
= new FileInputStream (inFile
);
2022 FileOutputStream fos
= new FileOutputStream(outFile
);
2026 } catch (IOException e
) {
2027 throw new AutoGenException("The file, flashMap.h can't be open!");
2031 throw new AutoGenException("The file, flashMap.h doesn't exist!");
2037 This function first order the library instances, then collect
2038 library instance 's PPI, Protocol, GUID,
2039 SetVirtalAddressMapCallBack, ExitBootServiceCallBack, and
2040 Destructor, Constructor.
2045 private void collectLibInstanceInfo() throws EdkException
{
2048 String libConstructName
= null;
2049 String libDestructName
= null;
2050 String libModuleType
= null;
2051 String
[] setVirtuals
= null;
2052 String
[] exitBoots
= null;
2054 ModuleIdentification
[] libraryIdList
= saq
.getLibraryInstance(this.arch
);
2056 if (libraryIdList
!= null) {
2058 // Reorder library instance sequence.
2060 AutogenLibOrder libOrder
= new AutogenLibOrder(libraryIdList
,
2062 List
<ModuleIdentification
> orderList
= libOrder
2063 .orderLibInstance();
2065 if (orderList
!= null) {
2067 // Process library instance one by one.
2069 for (int i
= 0; i
< orderList
.size(); i
++) {
2071 // Get library instance basename.
2073 ModuleIdentification libInstanceId
= orderList
.get(i
);
2079 Map
<String
, XmlObject
> libDoc
= GlobalData
.getDoc(libInstanceId
, this.arch
);
2082 // Get <PPis>, <Protocols>, <Guids> list of this library
2085 String
[] ppiList
= saq
.getPpiArray(this.arch
);
2086 String
[] ppiNotifyList
= saq
.getPpiNotifyArray(this.arch
);
2087 String
[] protocolList
= saq
.getProtocolArray(this.arch
);
2088 String
[] protocolNotifyList
= saq
.getProtocolNotifyArray(this.arch
);
2089 String
[] guidList
= saq
.getGuidEntryArray(this.arch
);
2090 PackageIdentification
[] pkgList
= saq
.getDependencePkg(this.arch
);
2093 // Add those ppi, protocol, guid in global ppi,
2097 for (index
= 0; index
< ppiList
.length
; index
++) {
2098 this.mPpiList
.add(ppiList
[index
]);
2101 for (index
= 0; index
< ppiNotifyList
.length
; index
++) {
2102 this.mPpiList
.add(ppiNotifyList
[index
]);
2105 for (index
= 0; index
< protocolList
.length
; index
++) {
2106 this.mProtocolList
.add(protocolList
[index
]);
2109 for (index
= 0; index
< protocolNotifyList
.length
; index
++) {
2110 this.mProtocolList
.add(protocolNotifyList
[index
]);
2113 for (index
= 0; index
< guidList
.length
; index
++) {
2114 this.mGuidList
.add(guidList
[index
]);
2116 for (index
= 0; index
< pkgList
.length
; index
++) {
2117 if (!this.mDepPkgList
.contains(pkgList
[index
])) {
2118 this.mDepPkgList
.add(pkgList
[index
]);
2123 // If not yet parse this library instance's constructor
2124 // element,parse it.
2126 libConstructName
= saq
.getLibConstructorName();
2127 libDestructName
= saq
.getLibDestructorName();
2128 libModuleType
= saq
.getModuleType();
2131 // Collect SetVirtualAddressMapCallBack and
2132 // ExitBootServiceCallBack.
2134 setVirtuals
= saq
.getSetVirtualAddressMapCallBackArray();
2135 exitBoots
= saq
.getExitBootServicesCallBackArray();
2136 if (setVirtuals
!= null) {
2137 for (int j
= 0; j
< setVirtuals
.length
; j
++) {
2138 this.setVirtalAddList
.add(setVirtuals
[j
]);
2141 if (exitBoots
!= null) {
2142 for (int k
= 0; k
< exitBoots
.length
; k
++) {
2143 this.exitBootServiceList
.add(exitBoots
[k
]);
2148 // Add dependent library instance constructor function.
2150 if (libConstructName
!= null) {
2151 this.libConstructList
.add(new String
[] {libConstructName
, libModuleType
});
2154 // Add dependent library instance destructor fuction.
2156 if (libDestructName
!= null) {
2157 this.libDestructList
.add(new String
[] {libDestructName
, libModuleType
});
2163 private void setVirtualAddressToAutogenC(StringBuffer fileBuffer
){
2165 // Entry point lib for these module types needs to know the count
2168 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverSetVirtualAddressMapEventCount = ");
2171 // If the list is not valid or has no entries set count to zero else
2172 // set count to the number of valid entries
2176 if (this.setVirtalAddList
!= null) {
2177 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2178 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2185 fileBuffer
.append(Integer
.toString(Count
));
2186 fileBuffer
.append(";\n\n");
2187 if (this.setVirtalAddList
== null || this.setVirtalAddList
.size() == 0) {
2189 // No data so make a NULL list
2191 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverSetVirtualAddressMapEvent[] = {\n");
2192 fileBuffer
.append(" NULL\n");
2193 fileBuffer
.append("};\n\n");
2196 // Write SetVirtualAddressMap function definition.
2198 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2199 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2202 fileBuffer
.append("VOID\n");
2203 fileBuffer
.append("EFIAPI\n");
2204 fileBuffer
.append(this.setVirtalAddList
.get(i
));
2205 fileBuffer
.append(" (\n");
2206 fileBuffer
.append(" IN EFI_EVENT Event,\n");
2207 fileBuffer
.append(" IN VOID *Context\n");
2208 fileBuffer
.append(" );\n\n");
2212 // Write SetVirtualAddressMap entry point array.
2214 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverSetVirtualAddressMapEvent[] = {");
2215 for (i
= 0; i
< this.setVirtalAddList
.size(); i
++) {
2216 if (this.setVirtalAddList
.get(i
).equalsIgnoreCase("")) {
2221 fileBuffer
.append("\n ");
2223 fileBuffer
.append(",\n ");
2226 fileBuffer
.append(this.setVirtalAddList
.get(i
));
2229 // add the NULL at the end of _gDriverSetVirtualAddressMapEvent list.
2231 fileBuffer
.append(",\n NULL");
2232 fileBuffer
.append("\n};\n\n");
2237 private void setExitBootServiceToAutogenC(StringBuffer fileBuffer
){
2239 // Entry point lib for these module types needs to know the count.
2242 .append("\nGLOBAL_REMOVE_IF_UNREFERENCED const UINTN _gDriverExitBootServicesEventCount = ");
2245 // If the list is not valid or has no entries set count to zero else
2246 // set count to the number of valid entries.
2250 if (this.exitBootServiceList
!= null) {
2251 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2252 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2258 fileBuffer
.append(Integer
.toString(Count
));
2259 fileBuffer
.append(";\n\n");
2261 if (this.exitBootServiceList
== null || this.exitBootServiceList
.size() == 0) {
2263 // No data so make a NULL list.
2265 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverExitBootServicesEvent[] = {\n");
2266 fileBuffer
.append(" NULL\n");
2267 fileBuffer
.append("};\n\n");
2270 // Write DriverExitBootServices function definition.
2272 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2273 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2277 fileBuffer
.append("VOID\n");
2278 fileBuffer
.append("EFIAPI\n");
2279 fileBuffer
.append(this.exitBootServiceList
.get(i
));
2280 fileBuffer
.append(" (\n");
2281 fileBuffer
.append(" IN EFI_EVENT Event,\n");
2282 fileBuffer
.append(" IN VOID *Context\n");
2283 fileBuffer
.append(" );\n\n");
2287 // Write DriverExitBootServices entry point array.
2289 fileBuffer
.append("\nGLOBAL_REMOVE_IF_UNREFERENCED const EFI_EVENT_NOTIFY _gDriverExitBootServicesEvent[] = {");
2290 for (i
= 0; i
< this.exitBootServiceList
.size(); i
++) {
2291 if (this.exitBootServiceList
.get(i
).equalsIgnoreCase("")) {
2296 fileBuffer
.append("\n ");
2298 fileBuffer
.append(",\n ");
2300 fileBuffer
.append(this.exitBootServiceList
.get(i
));
2303 fileBuffer
.append(",\n NULL");
2304 fileBuffer
.append("\n};\n\n");
2310 Get the Pcd Value of ComponentName to
2311 decide whether need to disable the componentName.
2314 public void setPcdComponentName (){
2315 String pcdValue
= null;
2316 pcdValue
= saq
.getPcdValueBycName("PcdComponentNameDisable");
2317 if (pcdValue
!= null && pcdValue
.equalsIgnoreCase("true")) {
2318 this.componentNamePcd
= true;
2323 setPcdDriverDiagnostic
2325 Get the Pcd Value of DriverDiagnostic to
2326 decide whether need to disable DriverDiagnostic.
2329 public void setPcdDriverDiagnostic (){
2330 String pcdValue
= null;
2331 pcdValue
= saq
.getPcdValueBycName("PcdDriverDiagnosticsDisable");
2332 if (pcdValue
!= null && pcdValue
.equalsIgnoreCase("true")) {
2333 this.driverDiagnostPcd
= true;