]> git.proxmox.com Git - mirror_edk2.git/blame_incremental - BaseTools/Source/Python/build/BuildReport.py
BaseTools: Update --pcd parser to support flexible pcd format
[mirror_edk2.git] / BaseTools / Source / Python / build / BuildReport.py
... / ...
CommitLineData
1## @file\r
2# Routines for generating build report.\r
3#\r
4# This module contains the functionality to generate build report after\r
5# build all target completes successfully.\r
6#\r
7# Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>\r
8# This program and the accompanying materials\r
9# are licensed and made available under the terms and conditions of the BSD License\r
10# which accompanies this distribution. The full text of the license may be found at\r
11# http://opensource.org/licenses/bsd-license.php\r
12#\r
13# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
14# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
15#\r
16\r
17## Import Modules\r
18#\r
19import Common.LongFilePathOs as os\r
20import re\r
21import platform\r
22import textwrap\r
23import traceback\r
24import sys\r
25import time\r
26import struct\r
27import hashlib\r
28import subprocess\r
29import threading\r
30from datetime import datetime\r
31from StringIO import StringIO\r
32from Common import EdkLogger\r
33from Common.Misc import SaveFileOnChange\r
34from Common.Misc import GuidStructureByteArrayToGuidString\r
35from Common.Misc import GuidStructureStringToGuidString\r
36from Common.InfClassObject import gComponentType2ModuleType\r
37from Common.BuildToolError import FILE_WRITE_FAILURE\r
38from Common.BuildToolError import CODE_ERROR\r
39from Common.BuildToolError import COMMAND_FAILURE\r
40from Common.BuildToolError import FORMAT_INVALID\r
41from Common.LongFilePathSupport import OpenLongFilePath as open\r
42from Common.MultipleWorkspace import MultipleWorkspace as mws\r
43import Common.GlobalData as GlobalData\r
44from AutoGen.AutoGen import ModuleAutoGen\r
45from Common.Misc import PathClass\r
46from Common.String import NormPath\r
47from Common.DataType import *\r
48import collections\r
49from Common.Expression import *\r
50\r
51## Pattern to extract contents in EDK DXS files\r
52gDxsDependencyPattern = re.compile(r"DEPENDENCY_START(.+)DEPENDENCY_END", re.DOTALL)\r
53\r
54## Pattern to find total FV total size, occupied size in flash report intermediate file\r
55gFvTotalSizePattern = re.compile(r"EFI_FV_TOTAL_SIZE = (0x[0-9a-fA-F]+)")\r
56gFvTakenSizePattern = re.compile(r"EFI_FV_TAKEN_SIZE = (0x[0-9a-fA-F]+)")\r
57\r
58## Pattern to find module size and time stamp in module summary report intermediate file\r
59gModuleSizePattern = re.compile(r"MODULE_SIZE = (\d+)")\r
60gTimeStampPattern = re.compile(r"TIME_STAMP = (\d+)")\r
61\r
62## Pattern to find GUID value in flash description files\r
63gPcdGuidPattern = re.compile(r"PCD\((\w+)[.](\w+)\)")\r
64\r
65## Pattern to collect offset, GUID value pair in the flash report intermediate file\r
66gOffsetGuidPattern = re.compile(r"(0x[0-9A-Fa-f]+) ([-A-Fa-f0-9]+)")\r
67\r
68## Pattern to find module base address and entry point in fixed flash map file\r
69gModulePattern = r"\n[-\w]+\s*\(([^,]+),\s*BaseAddress=%(Address)s,\s*EntryPoint=%(Address)s\)\s*\(GUID=([-0-9A-Fa-f]+)[^)]*\)"\r
70gMapFileItemPattern = re.compile(gModulePattern % {"Address" : "(-?0[xX][0-9A-Fa-f]+)"})\r
71\r
72## Pattern to find all module referenced header files in source files\r
73gIncludePattern = re.compile(r'#include\s*["<]([^">]+)[">]')\r
74gIncludePattern2 = re.compile(r"#include\s+EFI_([A-Z_]+)\s*[(]\s*(\w+)\s*[)]")\r
75\r
76## Pattern to find the entry point for EDK module using EDKII Glue library\r
77gGlueLibEntryPoint = re.compile(r"__EDKII_GLUE_MODULE_ENTRY_POINT__\s*=\s*(\w+)")\r
78\r
79## Tags for MaxLength of line in report\r
80gLineMaxLength = 120\r
81\r
82## Tags for end of line in report\r
83gEndOfLine = "\r\n"\r
84\r
85## Tags for section start, end and separator\r
86gSectionStart = ">" + "=" * (gLineMaxLength - 2) + "<"\r
87gSectionEnd = "<" + "=" * (gLineMaxLength - 2) + ">" + "\n"\r
88gSectionSep = "=" * gLineMaxLength\r
89\r
90## Tags for subsection start, end and separator\r
91gSubSectionStart = ">" + "-" * (gLineMaxLength - 2) + "<"\r
92gSubSectionEnd = "<" + "-" * (gLineMaxLength - 2) + ">"\r
93gSubSectionSep = "-" * gLineMaxLength\r
94\r
95\r
96## The look up table to map PCD type to pair of report display type and DEC type\r
97gPcdTypeMap = {\r
98 'FixedAtBuild' : ('FIXED', 'FixedAtBuild'),\r
99 'PatchableInModule': ('PATCH', 'PatchableInModule'),\r
100 'FeatureFlag' : ('FLAG', 'FeatureFlag'),\r
101 'Dynamic' : ('DYN', 'Dynamic'),\r
102 'DynamicHii' : ('DYNHII', 'Dynamic'),\r
103 'DynamicVpd' : ('DYNVPD', 'Dynamic'),\r
104 'DynamicEx' : ('DEX', 'DynamicEx'),\r
105 'DynamicExHii' : ('DEXHII', 'DynamicEx'),\r
106 'DynamicExVpd' : ('DEXVPD', 'DynamicEx'),\r
107 }\r
108\r
109## The look up table to map module type to driver type\r
110gDriverTypeMap = {\r
111 'SEC' : '0x3 (SECURITY_CORE)',\r
112 'PEI_CORE' : '0x4 (PEI_CORE)',\r
113 'PEIM' : '0x6 (PEIM)',\r
114 'DXE_CORE' : '0x5 (DXE_CORE)',\r
115 'DXE_DRIVER' : '0x7 (DRIVER)',\r
116 'DXE_SAL_DRIVER' : '0x7 (DRIVER)',\r
117 'DXE_SMM_DRIVER' : '0x7 (DRIVER)',\r
118 'DXE_RUNTIME_DRIVER': '0x7 (DRIVER)',\r
119 'UEFI_DRIVER' : '0x7 (DRIVER)',\r
120 'UEFI_APPLICATION' : '0x9 (APPLICATION)',\r
121 'SMM_CORE' : '0xD (SMM_CORE)',\r
122 'SMM_DRIVER' : '0xA (SMM)', # Extension of module type to support PI 1.1 SMM drivers\r
123 'MM_STANDALONE' : '0xE (MM_STANDALONE)',\r
124 'MM_CORE_STANDALONE' : '0xF (MM_CORE_STANDALONE)'\r
125 }\r
126\r
127## The look up table of the supported opcode in the dependency expression binaries\r
128gOpCodeList = ["BEFORE", "AFTER", "PUSH", "AND", "OR", "NOT", "TRUE", "FALSE", "END", "SOR"]\r
129\r
130##\r
131# Writes a string to the file object.\r
132#\r
133# This function writes a string to the file object and a new line is appended\r
134# afterwards. It may optionally wraps the string for better readability.\r
135#\r
136# @File The file object to write\r
137# @String The string to be written to the file\r
138# @Wrapper Indicates whether to wrap the string\r
139#\r
140def FileWrite(File, String, Wrapper=False):\r
141 if Wrapper:\r
142 String = textwrap.fill(String, 120)\r
143 File.write(String + gEndOfLine)\r
144\r
145def ByteArrayForamt(Value):\r
146 IsByteArray = False\r
147 SplitNum = 16\r
148 ArrayList = []\r
149 if Value.startswith('{') and Value.endswith('}'):\r
150 Value = Value[1:-1]\r
151 ValueList = Value.split(',')\r
152 if len(ValueList) >= SplitNum:\r
153 IsByteArray = True\r
154 if IsByteArray:\r
155 if ValueList:\r
156 Len = len(ValueList)/SplitNum\r
157 for i, element in enumerate(ValueList):\r
158 ValueList[i] = '0x%02X' % int(element.strip(), 16)\r
159 if Len:\r
160 Id = 0\r
161 while (Id <= Len):\r
162 End = min(SplitNum*(Id+1), len(ValueList))\r
163 Str = ','.join(ValueList[SplitNum*Id : End])\r
164 if End == len(ValueList):\r
165 Str += '}'\r
166 ArrayList.append(Str)\r
167 break\r
168 else:\r
169 Str += ','\r
170 ArrayList.append(Str)\r
171 Id += 1\r
172 else:\r
173 ArrayList = [Value + '}']\r
174 return IsByteArray, ArrayList\r
175\r
176##\r
177# Find all the header file that the module source directly includes.\r
178#\r
179# This function scans source code to find all header files the module may\r
180# include. This is not accurate but very effective to find all the header\r
181# file the module might include with #include statement.\r
182#\r
183# @Source The source file name\r
184# @IncludePathList The list of include path to find the source file.\r
185# @IncludeFiles The dictionary of current found include files.\r
186#\r
187def FindIncludeFiles(Source, IncludePathList, IncludeFiles):\r
188 FileContents = open(Source).read()\r
189 #\r
190 # Find header files with pattern #include "XXX.h" or #include <XXX.h>\r
191 #\r
192 for Match in gIncludePattern.finditer(FileContents):\r
193 FileName = Match.group(1).strip()\r
194 for Dir in [os.path.dirname(Source)] + IncludePathList:\r
195 FullFileName = os.path.normpath(os.path.join(Dir, FileName))\r
196 if os.path.exists(FullFileName):\r
197 IncludeFiles[FullFileName.lower().replace("\\", "/")] = FullFileName\r
198 break\r
199\r
200 #\r
201 # Find header files with pattern like #include EFI_PPI_CONSUMER(XXX)\r
202 #\r
203 for Match in gIncludePattern2.finditer(FileContents):\r
204 Key = Match.group(2)\r
205 Type = Match.group(1)\r
206 if "ARCH_PROTOCOL" in Type:\r
207 FileName = "ArchProtocol/%(Key)s/%(Key)s.h" % {"Key" : Key}\r
208 elif "PROTOCOL" in Type:\r
209 FileName = "Protocol/%(Key)s/%(Key)s.h" % {"Key" : Key}\r
210 elif "PPI" in Type:\r
211 FileName = "Ppi/%(Key)s/%(Key)s.h" % {"Key" : Key}\r
212 elif "GUID" in Type:\r
213 FileName = "Guid/%(Key)s/%(Key)s.h" % {"Key" : Key}\r
214 else:\r
215 continue\r
216 for Dir in IncludePathList:\r
217 FullFileName = os.path.normpath(os.path.join(Dir, FileName))\r
218 if os.path.exists(FullFileName):\r
219 IncludeFiles[FullFileName.lower().replace("\\", "/")] = FullFileName\r
220 break\r
221\r
222## Split each lines in file\r
223#\r
224# This method is used to split the lines in file to make the length of each line \r
225# less than MaxLength.\r
226#\r
227# @param Content The content of file\r
228# @param MaxLength The Max Length of the line\r
229#\r
230def FileLinesSplit(Content=None, MaxLength=None):\r
231 ContentList = Content.split(TAB_LINE_BREAK)\r
232 NewContent = ''\r
233 NewContentList = []\r
234 for Line in ContentList:\r
235 while len(Line.rstrip()) > MaxLength:\r
236 LineSpaceIndex = Line.rfind(TAB_SPACE_SPLIT, 0, MaxLength)\r
237 LineSlashIndex = Line.rfind(TAB_SLASH, 0, MaxLength)\r
238 LineBackSlashIndex = Line.rfind(TAB_BACK_SLASH, 0, MaxLength)\r
239 if max(LineSpaceIndex, LineSlashIndex, LineBackSlashIndex) > 0:\r
240 LineBreakIndex = max(LineSpaceIndex, LineSlashIndex, LineBackSlashIndex)\r
241 else:\r
242 LineBreakIndex = MaxLength\r
243 NewContentList.append(Line[:LineBreakIndex])\r
244 Line = Line[LineBreakIndex:]\r
245 if Line:\r
246 NewContentList.append(Line)\r
247 for NewLine in NewContentList:\r
248 NewContent += NewLine + TAB_LINE_BREAK\r
249 \r
250 NewContent = NewContent.replace(TAB_LINE_BREAK, gEndOfLine).replace('\r\r\n', gEndOfLine)\r
251 return NewContent\r
252 \r
253 \r
254 \r
255##\r
256# Parse binary dependency expression section\r
257#\r
258# This utility class parses the dependency expression section and translate the readable\r
259# GUID name and value.\r
260#\r
261class DepexParser(object):\r
262 ##\r
263 # Constructor function for class DepexParser\r
264 #\r
265 # This constructor function collect GUID values so that the readable\r
266 # GUID name can be translated.\r
267 #\r
268 # @param self The object pointer\r
269 # @param Wa Workspace context information\r
270 #\r
271 def __init__(self, Wa):\r
272 self._GuidDb = {}\r
273 for Pa in Wa.AutoGenObjectList:\r
274 for Package in Pa.PackageList:\r
275 for Protocol in Package.Protocols:\r
276 GuidValue = GuidStructureStringToGuidString(Package.Protocols[Protocol])\r
277 self._GuidDb[GuidValue.upper()] = Protocol\r
278 for Ppi in Package.Ppis:\r
279 GuidValue = GuidStructureStringToGuidString(Package.Ppis[Ppi])\r
280 self._GuidDb[GuidValue.upper()] = Ppi\r
281 for Guid in Package.Guids:\r
282 GuidValue = GuidStructureStringToGuidString(Package.Guids[Guid])\r
283 self._GuidDb[GuidValue.upper()] = Guid\r
284 \r
285 ##\r
286 # Parse the binary dependency expression files.\r
287 # \r
288 # This function parses the binary dependency expression file and translate it\r
289 # to the instruction list.\r
290 #\r
291 # @param self The object pointer\r
292 # @param DepexFileName The file name of binary dependency expression file.\r
293 #\r
294 def ParseDepexFile(self, DepexFileName):\r
295 DepexFile = open(DepexFileName, "rb")\r
296 DepexStatement = []\r
297 OpCode = DepexFile.read(1)\r
298 while OpCode:\r
299 Statement = gOpCodeList[struct.unpack("B", OpCode)[0]]\r
300 if Statement in ["BEFORE", "AFTER", "PUSH"]:\r
301 GuidValue = "%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X" % \\r
302 struct.unpack("=LHHBBBBBBBB", DepexFile.read(16))\r
303 GuidString = self._GuidDb.get(GuidValue, GuidValue)\r
304 Statement = "%s %s" % (Statement, GuidString)\r
305 DepexStatement.append(Statement)\r
306 OpCode = DepexFile.read(1)\r
307\r
308 return DepexStatement\r
309 \r
310##\r
311# Reports library information\r
312#\r
313# This class reports the module library subsection in the build report file.\r
314#\r
315class LibraryReport(object):\r
316 ##\r
317 # Constructor function for class LibraryReport\r
318 #\r
319 # This constructor function generates LibraryReport object for\r
320 # a module.\r
321 #\r
322 # @param self The object pointer\r
323 # @param M Module context information\r
324 #\r
325 def __init__(self, M):\r
326 self.LibraryList = []\r
327 if int(str(M.AutoGenVersion), 0) >= 0x00010005:\r
328 self._EdkIIModule = True\r
329 else:\r
330 self._EdkIIModule = False\r
331\r
332 for Lib in M.DependentLibraryList:\r
333 LibInfPath = str(Lib)\r
334 LibClassList = Lib.LibraryClass[0].LibraryClass\r
335 LibConstructorList = Lib.ConstructorList\r
336 LibDesstructorList = Lib.DestructorList\r
337 LibDepexList = Lib.DepexExpression[M.Arch, M.ModuleType]\r
338 for LibAutoGen in M.LibraryAutoGenList:\r
339 if LibInfPath == LibAutoGen.MetaFile.Path:\r
340 LibTime = LibAutoGen.BuildTime\r
341 break\r
342 self.LibraryList.append((LibInfPath, LibClassList, LibConstructorList, LibDesstructorList, LibDepexList, LibTime))\r
343\r
344 ##\r
345 # Generate report for module library information\r
346 #\r
347 # This function generates report for the module library.\r
348 # If the module is EDKII style one, the additional library class, library\r
349 # constructor/destructor and dependency expression may also be reported.\r
350 #\r
351 # @param self The object pointer\r
352 # @param File The file object for report\r
353 #\r
354 def GenerateReport(self, File):\r
355 if len(self.LibraryList) > 0:\r
356 FileWrite(File, gSubSectionStart)\r
357 FileWrite(File, TAB_BRG_LIBRARY)\r
358 FileWrite(File, gSubSectionSep)\r
359 for LibraryItem in self.LibraryList:\r
360 LibInfPath = LibraryItem[0]\r
361 FileWrite(File, LibInfPath)\r
362\r
363 #\r
364 # Report library class, library constructor and destructor for\r
365 # EDKII style module.\r
366 #\r
367 if self._EdkIIModule:\r
368 LibClass = LibraryItem[1]\r
369 EdkIILibInfo = ""\r
370 LibConstructor = " ".join(LibraryItem[2])\r
371 if LibConstructor:\r
372 EdkIILibInfo += " C = " + LibConstructor\r
373 LibDestructor = " ".join(LibraryItem[3])\r
374 if LibDestructor:\r
375 EdkIILibInfo += " D = " + LibDestructor\r
376 LibDepex = " ".join(LibraryItem[4])\r
377 if LibDepex:\r
378 EdkIILibInfo += " Depex = " + LibDepex\r
379 if LibraryItem[5]:\r
380 EdkIILibInfo += " Time = " + LibraryItem[5]\r
381 if EdkIILibInfo:\r
382 FileWrite(File, "{%s: %s}" % (LibClass, EdkIILibInfo))\r
383 else:\r
384 FileWrite(File, "{%s}" % LibClass)\r
385\r
386 FileWrite(File, gSubSectionEnd)\r
387\r
388##\r
389# Reports dependency expression information\r
390#\r
391# This class reports the module dependency expression subsection in the build report file.\r
392#\r
393class DepexReport(object):\r
394 ##\r
395 # Constructor function for class DepexReport\r
396 #\r
397 # This constructor function generates DepexReport object for\r
398 # a module. If the module source contains the DXS file (usually EDK\r
399 # style module), it uses the dependency in DXS file; otherwise,\r
400 # it uses the dependency expression from its own INF [Depex] section\r
401 # and then merges with the ones from its dependent library INF.\r
402 #\r
403 # @param self The object pointer\r
404 # @param M Module context information\r
405 #\r
406 def __init__(self, M):\r
407 self.Depex = ""\r
408 self._DepexFileName = os.path.join(M.BuildDir, "OUTPUT", M.Module.BaseName + ".depex")\r
409 ModuleType = M.ModuleType\r
410 if not ModuleType:\r
411 ModuleType = gComponentType2ModuleType.get(M.ComponentType, "")\r
412\r
413 if ModuleType in ["SEC", "PEI_CORE", "DXE_CORE", "SMM_CORE", "MM_CORE_STANDALONE", "UEFI_APPLICATION"]:\r
414 return\r
415 \r
416 for Source in M.SourceFileList:\r
417 if os.path.splitext(Source.Path)[1].lower() == ".dxs":\r
418 Match = gDxsDependencyPattern.search(open(Source.Path).read())\r
419 if Match:\r
420 self.Depex = Match.group(1).strip()\r
421 self.Source = "DXS"\r
422 break\r
423 else:\r
424 self.Depex = M.DepexExpressionList.get(M.ModuleType, "")\r
425 self.ModuleDepex = " ".join(M.Module.DepexExpression[M.Arch, M.ModuleType])\r
426 if not self.ModuleDepex:\r
427 self.ModuleDepex = "(None)"\r
428\r
429 LibDepexList = []\r
430 for Lib in M.DependentLibraryList:\r
431 LibDepex = " ".join(Lib.DepexExpression[M.Arch, M.ModuleType]).strip()\r
432 if LibDepex != "":\r
433 LibDepexList.append("(" + LibDepex + ")")\r
434 self.LibraryDepex = " AND ".join(LibDepexList)\r
435 if not self.LibraryDepex:\r
436 self.LibraryDepex = "(None)"\r
437 self.Source = "INF"\r
438\r
439 ##\r
440 # Generate report for module dependency expression information\r
441 #\r
442 # This function generates report for the module dependency expression.\r
443 #\r
444 # @param self The object pointer\r
445 # @param File The file object for report\r
446 # @param GlobalDepexParser The platform global Dependency expression parser object\r
447 #\r
448 def GenerateReport(self, File, GlobalDepexParser):\r
449 if not self.Depex:\r
450 return\r
451 FileWrite(File, gSubSectionStart)\r
452 if os.path.isfile(self._DepexFileName):\r
453 try:\r
454 DepexStatements = GlobalDepexParser.ParseDepexFile(self._DepexFileName)\r
455 FileWrite(File, "Final Dependency Expression (DEPEX) Instructions")\r
456 for DepexStatement in DepexStatements:\r
457 FileWrite(File, " %s" % DepexStatement)\r
458 FileWrite(File, gSubSectionSep)\r
459 except:\r
460 EdkLogger.warn(None, "Dependency expression file is corrupted", self._DepexFileName)\r
461 \r
462 FileWrite(File, "Dependency Expression (DEPEX) from %s" % self.Source)\r
463\r
464 if self.Source == "INF":\r
465 FileWrite(File, "%s" % self.Depex, True)\r
466 FileWrite(File, gSubSectionSep)\r
467 FileWrite(File, "From Module INF: %s" % self.ModuleDepex, True)\r
468 FileWrite(File, "From Library INF: %s" % self.LibraryDepex, True)\r
469 else:\r
470 FileWrite(File, "%s" % self.Depex)\r
471 FileWrite(File, gSubSectionEnd)\r
472\r
473##\r
474# Reports dependency expression information\r
475#\r
476# This class reports the module build flags subsection in the build report file.\r
477#\r
478class BuildFlagsReport(object):\r
479 ##\r
480 # Constructor function for class BuildFlagsReport\r
481 #\r
482 # This constructor function generates BuildFlagsReport object for\r
483 # a module. It reports the build tool chain tag and all relevant\r
484 # build flags to build the module.\r
485 #\r
486 # @param self The object pointer\r
487 # @param M Module context information\r
488 #\r
489 def __init__(self, M):\r
490 BuildOptions = {}\r
491 #\r
492 # Add build flags according to source file extension so that\r
493 # irrelevant ones can be filtered out.\r
494 #\r
495 for Source in M.SourceFileList:\r
496 Ext = os.path.splitext(Source.File)[1].lower()\r
497 if Ext in [".c", ".cc", ".cpp"]:\r
498 BuildOptions["CC"] = 1\r
499 elif Ext in [".s", ".asm"]:\r
500 BuildOptions["PP"] = 1\r
501 BuildOptions["ASM"] = 1\r
502 elif Ext in [".vfr"]:\r
503 BuildOptions["VFRPP"] = 1\r
504 BuildOptions["VFR"] = 1\r
505 elif Ext in [".dxs"]:\r
506 BuildOptions["APP"] = 1\r
507 BuildOptions["CC"] = 1\r
508 elif Ext in [".asl"]:\r
509 BuildOptions["ASLPP"] = 1\r
510 BuildOptions["ASL"] = 1\r
511 elif Ext in [".aslc"]:\r
512 BuildOptions["ASLCC"] = 1\r
513 BuildOptions["ASLDLINK"] = 1\r
514 BuildOptions["CC"] = 1\r
515 elif Ext in [".asm16"]:\r
516 BuildOptions["ASMLINK"] = 1\r
517 BuildOptions["SLINK"] = 1\r
518 BuildOptions["DLINK"] = 1\r
519\r
520 #\r
521 # Save module build flags.\r
522 #\r
523 self.ToolChainTag = M.ToolChain\r
524 self.BuildFlags = {}\r
525 for Tool in BuildOptions:\r
526 self.BuildFlags[Tool + "_FLAGS"] = M.BuildOption.get(Tool, {}).get("FLAGS", "")\r
527\r
528 ##\r
529 # Generate report for module build flags information\r
530 #\r
531 # This function generates report for the module build flags expression.\r
532 #\r
533 # @param self The object pointer\r
534 # @param File The file object for report\r
535 #\r
536 def GenerateReport(self, File):\r
537 FileWrite(File, gSubSectionStart)\r
538 FileWrite(File, "Build Flags")\r
539 FileWrite(File, "Tool Chain Tag: %s" % self.ToolChainTag)\r
540 for Tool in self.BuildFlags:\r
541 FileWrite(File, gSubSectionSep)\r
542 FileWrite(File, "%s = %s" % (Tool, self.BuildFlags[Tool]), True)\r
543\r
544 FileWrite(File, gSubSectionEnd)\r
545\r
546\r
547##\r
548# Reports individual module information\r
549#\r
550# This class reports the module section in the build report file.\r
551# It comprises of module summary, module PCD, library, dependency expression,\r
552# build flags sections.\r
553#\r
554class ModuleReport(object):\r
555 ##\r
556 # Constructor function for class ModuleReport\r
557 #\r
558 # This constructor function generates ModuleReport object for\r
559 # a separate module in a platform build.\r
560 #\r
561 # @param self The object pointer\r
562 # @param M Module context information\r
563 # @param ReportType The kind of report items in the final report file\r
564 #\r
565 def __init__(self, M, ReportType):\r
566 self.ModuleName = M.Module.BaseName\r
567 self.ModuleInfPath = M.MetaFile.File\r
568 self.FileGuid = M.Guid\r
569 self.Size = 0\r
570 self.BuildTimeStamp = None\r
571 self.Hash = 0\r
572 self.DriverType = ""\r
573 if not M.IsLibrary:\r
574 ModuleType = M.ModuleType\r
575 if not ModuleType:\r
576 ModuleType = gComponentType2ModuleType.get(M.ComponentType, "")\r
577 #\r
578 # If a module complies to PI 1.1, promote Module type to "SMM_DRIVER"\r
579 #\r
580 if ModuleType == "DXE_SMM_DRIVER":\r
581 PiSpec = M.Module.Specification.get("PI_SPECIFICATION_VERSION", "0x00010000")\r
582 if int(PiSpec, 0) >= 0x0001000A:\r
583 ModuleType = "SMM_DRIVER"\r
584 self.DriverType = gDriverTypeMap.get(ModuleType, "0x2 (FREE_FORM)")\r
585 self.UefiSpecVersion = M.Module.Specification.get("UEFI_SPECIFICATION_VERSION", "")\r
586 self.PiSpecVersion = M.Module.Specification.get("PI_SPECIFICATION_VERSION", "")\r
587 self.PciDeviceId = M.Module.Defines.get("PCI_DEVICE_ID", "")\r
588 self.PciVendorId = M.Module.Defines.get("PCI_VENDOR_ID", "")\r
589 self.PciClassCode = M.Module.Defines.get("PCI_CLASS_CODE", "")\r
590 self.BuildTime = M.BuildTime\r
591\r
592 self._BuildDir = M.BuildDir\r
593 self.ModulePcdSet = {}\r
594 if "PCD" in ReportType:\r
595 #\r
596 # Collect all module used PCD set: module INF referenced directly or indirectly.\r
597 # It also saves module INF default values of them in case they exist.\r
598 #\r
599 for Pcd in M.ModulePcdList + M.LibraryPcdList:\r
600 self.ModulePcdSet.setdefault((Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Pcd.Type), (Pcd.InfDefaultValue, Pcd.DefaultValue))\r
601\r
602 self.LibraryReport = None\r
603 if "LIBRARY" in ReportType:\r
604 self.LibraryReport = LibraryReport(M)\r
605\r
606 self.DepexReport = None\r
607 if "DEPEX" in ReportType:\r
608 self.DepexReport = DepexReport(M)\r
609\r
610 if "BUILD_FLAGS" in ReportType:\r
611 self.BuildFlagsReport = BuildFlagsReport(M)\r
612\r
613\r
614 ##\r
615 # Generate report for module information\r
616 #\r
617 # This function generates report for separate module expression\r
618 # in a platform build.\r
619 #\r
620 # @param self The object pointer\r
621 # @param File The file object for report\r
622 # @param GlobalPcdReport The platform global PCD report object\r
623 # @param GlobalPredictionReport The platform global Prediction report object\r
624 # @param GlobalDepexParser The platform global Dependency expression parser object\r
625 # @param ReportType The kind of report items in the final report file\r
626 #\r
627 def GenerateReport(self, File, GlobalPcdReport, GlobalPredictionReport, GlobalDepexParser, ReportType):\r
628 FileWrite(File, gSectionStart)\r
629\r
630 FwReportFileName = os.path.join(self._BuildDir, "DEBUG", self.ModuleName + ".txt")\r
631 if os.path.isfile(FwReportFileName):\r
632 try:\r
633 FileContents = open(FwReportFileName).read()\r
634 Match = gModuleSizePattern.search(FileContents)\r
635 if Match:\r
636 self.Size = int(Match.group(1))\r
637\r
638 Match = gTimeStampPattern.search(FileContents)\r
639 if Match:\r
640 self.BuildTimeStamp = datetime.fromtimestamp(int(Match.group(1)))\r
641 except IOError:\r
642 EdkLogger.warn(None, "Fail to read report file", FwReportFileName)\r
643\r
644 if "HASH" in ReportType:\r
645 OutputDir = os.path.join(self._BuildDir, "OUTPUT")\r
646 DefaultEFIfile = os.path.join(OutputDir, self.ModuleName + ".efi")\r
647 if os.path.isfile(DefaultEFIfile):\r
648 Tempfile = os.path.join(OutputDir, self.ModuleName + "_hash.tmp")\r
649 # rebase the efi image since its base address may not zero\r
650 cmd = ["GenFw", "--rebase", str(0), "-o", Tempfile, DefaultEFIfile]\r
651 try:\r
652 PopenObject = subprocess.Popen(' '.join(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True)\r
653 except Exception, X:\r
654 EdkLogger.error("GenFw", COMMAND_FAILURE, ExtraData="%s: %s" % (str(X), cmd[0]))\r
655 EndOfProcedure = threading.Event()\r
656 EndOfProcedure.clear()\r
657 if PopenObject.stderr:\r
658 StdErrThread = threading.Thread(target=ReadMessage, args=(PopenObject.stderr, EdkLogger.quiet, EndOfProcedure))\r
659 StdErrThread.setName("STDERR-Redirector")\r
660 StdErrThread.setDaemon(False)\r
661 StdErrThread.start()\r
662 # waiting for program exit\r
663 PopenObject.wait()\r
664 if PopenObject.stderr:\r
665 StdErrThread.join()\r
666 if PopenObject.returncode != 0:\r
667 EdkLogger.error("GenFw", COMMAND_FAILURE, "Failed to generate firmware hash image for %s" % (DefaultEFIfile))\r
668 if os.path.isfile(Tempfile):\r
669 self.Hash = hashlib.sha1()\r
670 buf = open(Tempfile, 'rb').read()\r
671 if self.Hash.update(buf):\r
672 self.Hash = self.Hash.update(buf)\r
673 self.Hash = self.Hash.hexdigest()\r
674 os.remove(Tempfile)\r
675\r
676 FileWrite(File, "Module Summary")\r
677 FileWrite(File, "Module Name: %s" % self.ModuleName)\r
678 FileWrite(File, "Module INF Path: %s" % self.ModuleInfPath)\r
679 FileWrite(File, "File GUID: %s" % self.FileGuid)\r
680 if self.Size:\r
681 FileWrite(File, "Size: 0x%X (%.2fK)" % (self.Size, self.Size / 1024.0))\r
682 if self.Hash:\r
683 FileWrite(File, "SHA1 HASH: %s *%s" % (self.Hash, self.ModuleName + ".efi"))\r
684 if self.BuildTimeStamp:\r
685 FileWrite(File, "Build Time Stamp: %s" % self.BuildTimeStamp)\r
686 if self.BuildTime:\r
687 FileWrite(File, "Module Build Time: %s" % self.BuildTime)\r
688 if self.DriverType:\r
689 FileWrite(File, "Driver Type: %s" % self.DriverType)\r
690 if self.UefiSpecVersion:\r
691 FileWrite(File, "UEFI Spec Version: %s" % self.UefiSpecVersion)\r
692 if self.PiSpecVersion:\r
693 FileWrite(File, "PI Spec Version: %s" % self.PiSpecVersion)\r
694 if self.PciDeviceId:\r
695 FileWrite(File, "PCI Device ID: %s" % self.PciDeviceId)\r
696 if self.PciVendorId:\r
697 FileWrite(File, "PCI Vendor ID: %s" % self.PciVendorId)\r
698 if self.PciClassCode:\r
699 FileWrite(File, "PCI Class Code: %s" % self.PciClassCode)\r
700\r
701 FileWrite(File, gSectionSep)\r
702\r
703 if "PCD" in ReportType:\r
704 GlobalPcdReport.GenerateReport(File, self.ModulePcdSet)\r
705\r
706 if "LIBRARY" in ReportType:\r
707 self.LibraryReport.GenerateReport(File)\r
708\r
709 if "DEPEX" in ReportType:\r
710 self.DepexReport.GenerateReport(File, GlobalDepexParser)\r
711\r
712 if "BUILD_FLAGS" in ReportType:\r
713 self.BuildFlagsReport.GenerateReport(File)\r
714\r
715 if "FIXED_ADDRESS" in ReportType and self.FileGuid:\r
716 GlobalPredictionReport.GenerateReport(File, self.FileGuid)\r
717\r
718 FileWrite(File, gSectionEnd)\r
719\r
720def ReadMessage(From, To, ExitFlag):\r
721 while True:\r
722 # read one line a time\r
723 Line = From.readline()\r
724 # empty string means "end"\r
725 if Line != None and Line != "":\r
726 To(Line.rstrip())\r
727 else:\r
728 break\r
729 if ExitFlag.isSet():\r
730 break\r
731\r
732##\r
733# Reports platform and module PCD information\r
734#\r
735# This class reports the platform PCD section and module PCD subsection\r
736# in the build report file.\r
737#\r
738class PcdReport(object):\r
739 ##\r
740 # Constructor function for class PcdReport\r
741 #\r
742 # This constructor function generates PcdReport object a platform build.\r
743 # It collects the whole PCD database from platform DSC files, platform\r
744 # flash description file and package DEC files.\r
745 #\r
746 # @param self The object pointer\r
747 # @param Wa Workspace context information\r
748 #\r
749 def __init__(self, Wa):\r
750 self.AllPcds = {}\r
751 self.UnusedPcds = {}\r
752 self.ConditionalPcds = {}\r
753 self.MaxLen = 0\r
754 self.Arch = None\r
755 if Wa.FdfProfile:\r
756 self.FdfPcdSet = Wa.FdfProfile.PcdDict\r
757 else:\r
758 self.FdfPcdSet = {}\r
759\r
760 self.DefaultStoreSingle = True\r
761 self.SkuSingle = True\r
762 if GlobalData.gDefaultStores and len(GlobalData.gDefaultStores) > 1:\r
763 self.DefaultStoreSingle = False\r
764 if GlobalData.gSkuids and len(GlobalData.gSkuids) > 1:\r
765 self.SkuSingle = False\r
766\r
767 self.ModulePcdOverride = {}\r
768 for Pa in Wa.AutoGenObjectList:\r
769 self.Arch = Pa.Arch\r
770 #\r
771 # Collect all platform referenced PCDs and grouped them by PCD token space\r
772 # GUID C Names\r
773 #\r
774 for Pcd in Pa.AllPcdList:\r
775 PcdList = self.AllPcds.setdefault(Pcd.TokenSpaceGuidCName, {}).setdefault(Pcd.Type, [])\r
776 if Pcd not in PcdList:\r
777 PcdList.append(Pcd)\r
778 if len(Pcd.TokenCName) > self.MaxLen:\r
779 self.MaxLen = len(Pcd.TokenCName)\r
780 #\r
781 # Collect the PCD defined in DSC/FDF file, but not used in module\r
782 #\r
783 UnusedPcdFullList = []\r
784 for item in Pa.Platform.Pcds:\r
785 Pcd = Pa.Platform.Pcds[item]\r
786 if not Pcd.Type:\r
787 # check the Pcd in FDF file, whether it is used in module first\r
788 for T in ["FixedAtBuild", "PatchableInModule", "FeatureFlag", "Dynamic", "DynamicEx"]:\r
789 PcdList = self.AllPcds.setdefault(Pcd.TokenSpaceGuidCName, {}).setdefault(T, [])\r
790 if Pcd in PcdList:\r
791 Pcd.Type = T\r
792 break\r
793 if not Pcd.Type:\r
794 PcdTypeFlag = False\r
795 for package in Pa.PackageList:\r
796 for T in ["FixedAtBuild", "PatchableInModule", "FeatureFlag", "Dynamic", "DynamicEx"]:\r
797 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, T) in package.Pcds:\r
798 Pcd.Type = T\r
799 PcdTypeFlag = True\r
800 if not Pcd.DatumType:\r
801 Pcd.DatumType = package.Pcds[(Pcd.TokenCName, Pcd.TokenSpaceGuidCName, T)].DatumType\r
802 break\r
803 if PcdTypeFlag:\r
804 break\r
805 if not Pcd.DatumType:\r
806 PcdType = Pcd.Type\r
807 # Try to remove Hii and Vpd suffix\r
808 if PcdType.startswith("DynamicEx"):\r
809 PcdType = "DynamicEx"\r
810 elif PcdType.startswith("Dynamic"):\r
811 PcdType = "Dynamic"\r
812 for package in Pa.PackageList:\r
813 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, PcdType) in package.Pcds:\r
814 Pcd.DatumType = package.Pcds[(Pcd.TokenCName, Pcd.TokenSpaceGuidCName, PcdType)].DatumType\r
815 break\r
816\r
817 PcdList = self.AllPcds.setdefault(Pcd.TokenSpaceGuidCName, {}).setdefault(Pcd.Type, [])\r
818 if Pcd not in PcdList and Pcd not in UnusedPcdFullList:\r
819 UnusedPcdFullList.append(Pcd)\r
820 if len(Pcd.TokenCName) > self.MaxLen:\r
821 self.MaxLen = len(Pcd.TokenCName)\r
822\r
823 if GlobalData.gConditionalPcds:\r
824 for PcdItem in GlobalData.gConditionalPcds:\r
825 if '.' in PcdItem:\r
826 (TokenSpaceGuidCName, TokenCName) = PcdItem.split('.')\r
827 if (TokenCName, TokenSpaceGuidCName) in Pa.Platform.Pcds.keys():\r
828 Pcd = Pa.Platform.Pcds[(TokenCName, TokenSpaceGuidCName)]\r
829 PcdList = self.ConditionalPcds.setdefault(Pcd.TokenSpaceGuidCName, {}).setdefault(Pcd.Type, [])\r
830 if Pcd not in PcdList:\r
831 PcdList.append(Pcd)\r
832\r
833 UnusedPcdList = []\r
834 if UnusedPcdFullList:\r
835 for Pcd in UnusedPcdFullList:\r
836 if Pcd.TokenSpaceGuidCName + '.' + Pcd.TokenCName in GlobalData.gConditionalPcds:\r
837 continue\r
838 UnusedPcdList.append(Pcd)\r
839\r
840 for Pcd in UnusedPcdList:\r
841 PcdList = self.UnusedPcds.setdefault(Pcd.TokenSpaceGuidCName, {}).setdefault(Pcd.Type, [])\r
842 if Pcd not in PcdList:\r
843 PcdList.append(Pcd)\r
844\r
845 for Module in Pa.Platform.Modules.values():\r
846 #\r
847 # Collect module override PCDs\r
848 #\r
849 for ModulePcd in Module.M.ModulePcdList + Module.M.LibraryPcdList:\r
850 TokenCName = ModulePcd.TokenCName\r
851 TokenSpaceGuid = ModulePcd.TokenSpaceGuidCName\r
852 ModuleDefault = ModulePcd.DefaultValue\r
853 ModulePath = os.path.basename(Module.M.MetaFile.File)\r
854 self.ModulePcdOverride.setdefault((TokenCName, TokenSpaceGuid), {})[ModulePath] = ModuleDefault\r
855\r
856\r
857 #\r
858 # Collect PCD DEC default value.\r
859 #\r
860 self.DecPcdDefault = {}\r
861 self._GuidDict = {}\r
862 for Pa in Wa.AutoGenObjectList:\r
863 for Package in Pa.PackageList:\r
864 Guids = Package.Guids\r
865 self._GuidDict.update(Guids)\r
866 for (TokenCName, TokenSpaceGuidCName, DecType) in Package.Pcds:\r
867 DecDefaultValue = Package.Pcds[TokenCName, TokenSpaceGuidCName, DecType].DefaultValue\r
868 self.DecPcdDefault.setdefault((TokenCName, TokenSpaceGuidCName, DecType), DecDefaultValue)\r
869 #\r
870 # Collect PCDs defined in DSC common section\r
871 #\r
872 self.DscPcdDefault = {}\r
873 for Pa in Wa.AutoGenObjectList:\r
874 for (TokenCName, TokenSpaceGuidCName) in Pa.Platform.Pcds:\r
875 DscDefaultValue = Pa.Platform.Pcds[(TokenCName, TokenSpaceGuidCName)].DscDefaultValue\r
876 if DscDefaultValue:\r
877 self.DscPcdDefault[(TokenCName, TokenSpaceGuidCName)] = DscDefaultValue\r
878\r
879 def GenerateReport(self, File, ModulePcdSet):\r
880 if self.ConditionalPcds:\r
881 self.GenerateReportDetail(File, ModulePcdSet, 1)\r
882 if self.UnusedPcds:\r
883 self.GenerateReportDetail(File, ModulePcdSet, 2)\r
884 self.GenerateReportDetail(File, ModulePcdSet)\r
885\r
886 ##\r
887 # Generate report for PCD information\r
888 #\r
889 # This function generates report for separate module expression\r
890 # in a platform build.\r
891 #\r
892 # @param self The object pointer\r
893 # @param File The file object for report\r
894 # @param ModulePcdSet Set of all PCDs referenced by module or None for\r
895 # platform PCD report\r
896 # @param ReportySubType 0 means platform/module PCD report, 1 means Conditional\r
897 # directives section report, 2 means Unused Pcds section report\r
898 # @param DscOverridePcds Module DSC override PCDs set\r
899 #\r
900 def GenerateReportDetail(self, File, ModulePcdSet, ReportSubType = 0):\r
901 PcdDict = self.AllPcds\r
902 if ReportSubType == 1:\r
903 PcdDict = self.ConditionalPcds\r
904 elif ReportSubType == 2:\r
905 PcdDict = self.UnusedPcds\r
906\r
907 if ModulePcdSet == None:\r
908 FileWrite(File, gSectionStart)\r
909 if ReportSubType == 1:\r
910 FileWrite(File, "Conditional Directives used by the build system")\r
911 elif ReportSubType == 2:\r
912 FileWrite(File, "PCDs not used by modules or in conditional directives")\r
913 else:\r
914 FileWrite(File, "Platform Configuration Database Report")\r
915\r
916 FileWrite(File, " *B - PCD override in the build option")\r
917 FileWrite(File, " *P - Platform scoped PCD override in DSC file")\r
918 FileWrite(File, " *F - Platform scoped PCD override in FDF file")\r
919 if not ReportSubType:\r
920 FileWrite(File, " *M - Module scoped PCD override")\r
921 FileWrite(File, gSectionSep)\r
922 else:\r
923 if not ReportSubType and ModulePcdSet:\r
924 #\r
925 # For module PCD sub-section\r
926 #\r
927 FileWrite(File, gSubSectionStart)\r
928 FileWrite(File, TAB_BRG_PCD)\r
929 FileWrite(File, gSubSectionSep)\r
930\r
931 for Key in PcdDict:\r
932 #\r
933 # Group PCD by their token space GUID C Name\r
934 #\r
935 First = True\r
936 for Type in PcdDict[Key]:\r
937 #\r
938 # Group PCD by their usage type\r
939 #\r
940 TypeName, DecType = gPcdTypeMap.get(Type, ("", Type))\r
941 for Pcd in PcdDict[Key][Type]:\r
942 PcdTokenCName = Pcd.TokenCName\r
943 MixedPcdFlag = False\r
944 if GlobalData.MixedPcd:\r
945 for PcdKey in GlobalData.MixedPcd:\r
946 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.MixedPcd[PcdKey]:\r
947 PcdTokenCName = PcdKey[0]\r
948 MixedPcdFlag = True\r
949 if MixedPcdFlag and not ModulePcdSet:\r
950 continue\r
951 #\r
952 # Get PCD default value and their override relationship\r
953 #\r
954 DecDefaultValue = self.DecPcdDefault.get((Pcd.TokenCName, Pcd.TokenSpaceGuidCName, DecType))\r
955 DscDefaultValue = self.DscPcdDefault.get((Pcd.TokenCName, Pcd.TokenSpaceGuidCName))\r
956 DscDefaultValBak = DscDefaultValue\r
957 DscDefaultValue = self.FdfPcdSet.get((Pcd.TokenCName, Key), DscDefaultValue)\r
958 if DscDefaultValue != DscDefaultValBak:\r
959 try:\r
960 DscDefaultValue = ValueExpressionEx(DscDefaultValue, Pcd.DatumType, self._GuidDict)(True)\r
961 except BadExpression, DscDefaultValue:\r
962 EdkLogger.error('BuildReport', FORMAT_INVALID, "PCD Value: %s, Type: %s" %(DscDefaultValue, Pcd.DatumType))\r
963\r
964 InfDefaultValue = None\r
965 \r
966 PcdValue = DecDefaultValue\r
967 if DscDefaultValue:\r
968 PcdValue = DscDefaultValue\r
969 if ModulePcdSet != None:\r
970 if (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Type) not in ModulePcdSet:\r
971 continue\r
972 InfDefault, PcdValue = ModulePcdSet[Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Type]\r
973 if InfDefault == "":\r
974 InfDefault = None\r
975\r
976 BuildOptionMatch = False\r
977 if GlobalData.BuildOptionPcd:\r
978 for pcd in GlobalData.BuildOptionPcd:\r
979 if (Pcd.TokenSpaceGuidCName, Pcd.TokenCName) == (pcd[0], pcd[1]):\r
980 if pcd[2]:\r
981 continue\r
982 PcdValue = pcd[3]\r
983 Pcd.DefaultValue = PcdValue\r
984 BuildOptionMatch = True\r
985 break\r
986\r
987 if First:\r
988 if ModulePcdSet == None:\r
989 FileWrite(File, "")\r
990 FileWrite(File, Key)\r
991 First = False\r
992\r
993\r
994 if Pcd.DatumType in ('UINT8', 'UINT16', 'UINT32', 'UINT64'):\r
995 PcdValueNumber = int(PcdValue.strip(), 0)\r
996 if DecDefaultValue == None:\r
997 DecMatch = True\r
998 else:\r
999 DecDefaultValueNumber = int(DecDefaultValue.strip(), 0)\r
1000 DecMatch = (DecDefaultValueNumber == PcdValueNumber)\r
1001\r
1002 if InfDefaultValue == None:\r
1003 InfMatch = True\r
1004 else:\r
1005 InfDefaultValueNumber = int(InfDefaultValue.strip(), 0)\r
1006 InfMatch = (InfDefaultValueNumber == PcdValueNumber)\r
1007\r
1008 if DscDefaultValue == None:\r
1009 DscMatch = True\r
1010 else:\r
1011 DscDefaultValueNumber = int(DscDefaultValue.strip(), 0)\r
1012 DscMatch = (DscDefaultValueNumber == PcdValueNumber)\r
1013 else:\r
1014 if DecDefaultValue == None:\r
1015 DecMatch = True\r
1016 else:\r
1017 DecMatch = (DecDefaultValue.strip() == PcdValue.strip())\r
1018\r
1019 if InfDefaultValue == None:\r
1020 InfMatch = True\r
1021 else:\r
1022 InfMatch = (InfDefaultValue.strip() == PcdValue.strip())\r
1023\r
1024 if DscDefaultValue == None:\r
1025 DscMatch = True\r
1026 else:\r
1027 DscMatch = (DscDefaultValue.strip() == PcdValue.strip())\r
1028\r
1029 IsStructure = False\r
1030 if GlobalData.gStructurePcd and (self.Arch in GlobalData.gStructurePcd.keys()) and ((Pcd.TokenCName, Pcd.TokenSpaceGuidCName) in GlobalData.gStructurePcd[self.Arch]):\r
1031 IsStructure = True\r
1032 if TypeName in ('DYNVPD', 'DEXVPD'):\r
1033 SkuInfoList = Pcd.SkuInfoList\r
1034 Pcd = GlobalData.gStructurePcd[self.Arch][(Pcd.TokenCName, Pcd.TokenSpaceGuidCName)]\r
1035 Pcd.DatumType = Pcd.StructName\r
1036 if TypeName in ('DYNVPD', 'DEXVPD'):\r
1037 Pcd.SkuInfoList = SkuInfoList\r
1038 if Pcd.PcdFieldValueFromComm:\r
1039 BuildOptionMatch = True\r
1040 DecMatch = False\r
1041 elif Pcd.SkuOverrideValues:\r
1042 DscOverride = False\r
1043 if not Pcd.SkuInfoList:\r
1044 OverrideValues = Pcd.SkuOverrideValues\r
1045 if OverrideValues:\r
1046 Keys = OverrideValues.keys()\r
1047 Data = OverrideValues[Keys[0]]\r
1048 Struct = Data.values()[0]\r
1049 DscOverride = self.ParseStruct(Struct)\r
1050 else:\r
1051 SkuList = sorted(Pcd.SkuInfoList.keys())\r
1052 for Sku in SkuList:\r
1053 SkuInfo = Pcd.SkuInfoList[Sku]\r
1054 if TypeName in ('DYNHII', 'DEXHII'):\r
1055 if SkuInfo.DefaultStoreDict:\r
1056 DefaultStoreList = sorted(SkuInfo.DefaultStoreDict.keys())\r
1057 for DefaultStore in DefaultStoreList:\r
1058 OverrideValues = Pcd.SkuOverrideValues[Sku]\r
1059 DscOverride = self.ParseStruct(OverrideValues[DefaultStore])\r
1060 if DscOverride:\r
1061 break\r
1062 else:\r
1063 OverrideValues = Pcd.SkuOverrideValues[Sku]\r
1064 if OverrideValues:\r
1065 Keys = OverrideValues.keys()\r
1066 OverrideFieldStruct = self.OverrideFieldValue(Pcd, OverrideValues[Keys[0]])\r
1067 DscOverride = self.ParseStruct(OverrideFieldStruct)\r
1068 if DscOverride:\r
1069 break\r
1070 if DscOverride:\r
1071 DscMatch = True\r
1072 DecMatch = False\r
1073\r
1074 #\r
1075 # Report PCD item according to their override relationship\r
1076 #\r
1077 if DecMatch and InfMatch:\r
1078 self.PrintPcdValue(File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValBak, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, ' ')\r
1079 elif BuildOptionMatch:\r
1080 self.PrintPcdValue(File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValBak, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, '*B')\r
1081 else:\r
1082 if DscMatch:\r
1083 if (Pcd.TokenCName, Key) in self.FdfPcdSet:\r
1084 self.PrintPcdValue(File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValBak, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, '*F')\r
1085 else:\r
1086 self.PrintPcdValue(File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValBak, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, '*P')\r
1087 else:\r
1088 self.PrintPcdValue(File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValBak, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, '*M')\r
1089\r
1090 if ModulePcdSet == None:\r
1091 if IsStructure:\r
1092 continue\r
1093 if not TypeName in ('PATCH', 'FLAG', 'FIXED'):\r
1094 continue\r
1095 if not BuildOptionMatch:\r
1096 ModuleOverride = self.ModulePcdOverride.get((Pcd.TokenCName, Pcd.TokenSpaceGuidCName), {})\r
1097 for ModulePath in ModuleOverride:\r
1098 ModuleDefault = ModuleOverride[ModulePath]\r
1099 if Pcd.DatumType in ('UINT8', 'UINT16', 'UINT32', 'UINT64'):\r
1100 ModulePcdDefaultValueNumber = int(ModuleDefault.strip(), 0)\r
1101 Match = (ModulePcdDefaultValueNumber == PcdValueNumber)\r
1102 else:\r
1103 Match = (ModuleDefault.strip() == PcdValue.strip())\r
1104 if Match:\r
1105 continue\r
1106 IsByteArray, ArrayList = ByteArrayForamt(ModuleDefault.strip())\r
1107 if IsByteArray:\r
1108 FileWrite(File, ' *M %-*s = %s' % (self.MaxLen + 19, ModulePath, '{'))\r
1109 for Array in ArrayList:\r
1110 FileWrite(File, '%s' % (Array))\r
1111 else:\r
1112 FileWrite(File, ' *M %-*s = %s' % (self.MaxLen + 19, ModulePath, ModuleDefault.strip()))\r
1113\r
1114 if ModulePcdSet == None:\r
1115 FileWrite(File, gSectionEnd)\r
1116 else:\r
1117 if not ReportSubType and ModulePcdSet:\r
1118 FileWrite(File, gSubSectionEnd)\r
1119\r
1120 def ParseStruct(self, struct):\r
1121 HasDscOverride = False\r
1122 if struct:\r
1123 for _, Values in struct.items():\r
1124 if Values[1] and Values[1].endswith('.dsc'):\r
1125 HasDscOverride = True\r
1126 break\r
1127 return HasDscOverride\r
1128\r
1129 def PrintPcdDefault(self, File, Pcd, IsStructure, DscMatch, DscDefaultValue, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue):\r
1130 if not DscMatch and DscDefaultValue != None:\r
1131 Value = DscDefaultValue.strip()\r
1132 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1133 if IsByteArray:\r
1134 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'DSC DEFAULT', "{"))\r
1135 for Array in ArrayList:\r
1136 FileWrite(File, '%s' % (Array))\r
1137 else:\r
1138 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'DSC DEFAULT', Value))\r
1139 if not InfMatch and InfDefaultValue != None:\r
1140 Value = InfDefaultValue.strip()\r
1141 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1142 if IsByteArray:\r
1143 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'INF DEFAULT', "{"))\r
1144 for Array in ArrayList:\r
1145 FileWrite(File, '%s' % (Array))\r
1146 else:\r
1147 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'INF DEFAULT', Value))\r
1148\r
1149 if not DecMatch and DecDefaultValue != None:\r
1150 Value = DecDefaultValue.strip()\r
1151 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1152 if IsByteArray:\r
1153 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'DEC DEFAULT', "{"))\r
1154 for Array in ArrayList:\r
1155 FileWrite(File, '%s' % (Array))\r
1156 else:\r
1157 FileWrite(File, ' %*s = %s' % (self.MaxLen + 19, 'DEC DEFAULT', Value))\r
1158 if IsStructure:\r
1159 self.PrintStructureInfo(File, Pcd.DefaultValues)\r
1160 if DecMatch and IsStructure:\r
1161 self.PrintStructureInfo(File, Pcd.DefaultValues)\r
1162\r
1163 def PrintPcdValue(self, File, Pcd, PcdTokenCName, TypeName, IsStructure, DscMatch, DscDefaultValue, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue, Flag = ' '):\r
1164 if not Pcd.SkuInfoList:\r
1165 Value = Pcd.DefaultValue\r
1166 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1167 if IsByteArray:\r
1168 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '{'))\r
1169 for Array in ArrayList:\r
1170 FileWrite(File, '%s' % (Array))\r
1171 else:\r
1172 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', Value))\r
1173 if IsStructure:\r
1174 OverrideValues = Pcd.SkuOverrideValues\r
1175 if OverrideValues:\r
1176 Keys = OverrideValues.keys()\r
1177 Data = OverrideValues[Keys[0]]\r
1178 Struct = Data.values()[0]\r
1179 OverrideFieldStruct = self.OverrideFieldValue(Pcd, Struct)\r
1180 self.PrintStructureInfo(File, OverrideFieldStruct)\r
1181 self.PrintPcdDefault(File, Pcd, IsStructure, DscMatch, DscDefaultValue, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue)\r
1182 else:\r
1183 FirstPrint = True\r
1184 SkuList = sorted(Pcd.SkuInfoList.keys())\r
1185 for Sku in SkuList:\r
1186 SkuInfo = Pcd.SkuInfoList[Sku]\r
1187 SkuIdName = SkuInfo.SkuIdName\r
1188 if TypeName in ('DYNHII', 'DEXHII'):\r
1189 if SkuInfo.DefaultStoreDict:\r
1190 DefaultStoreList = sorted(SkuInfo.DefaultStoreDict.keys())\r
1191 for DefaultStore in DefaultStoreList:\r
1192 Value = SkuInfo.DefaultStoreDict[DefaultStore]\r
1193 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1194 if FirstPrint:\r
1195 FirstPrint = False\r
1196 if IsByteArray:\r
1197 if self.DefaultStoreSingle and self.SkuSingle:\r
1198 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '{'))\r
1199 elif self.DefaultStoreSingle and not self.SkuSingle:\r
1200 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '{'))\r
1201 elif not self.DefaultStoreSingle and self.SkuSingle:\r
1202 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + DefaultStore + ')', '{'))\r
1203 else:\r
1204 FileWrite(File, ' %-*s : %6s %10s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '(' + DefaultStore + ')', '{'))\r
1205 for Array in ArrayList:\r
1206 FileWrite(File, '%s' % (Array))\r
1207 else:\r
1208 if self.DefaultStoreSingle and self.SkuSingle:\r
1209 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', Value))\r
1210 elif self.DefaultStoreSingle and not self.SkuSingle:\r
1211 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', Value))\r
1212 elif not self.DefaultStoreSingle and self.SkuSingle:\r
1213 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + DefaultStore + ')', Value))\r
1214 else:\r
1215 FileWrite(File, ' %-*s : %6s %10s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '(' + DefaultStore + ')', Value))\r
1216 else:\r
1217 if IsByteArray:\r
1218 if self.DefaultStoreSingle and self.SkuSingle:\r
1219 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '{'))\r
1220 elif self.DefaultStoreSingle and not self.SkuSingle:\r
1221 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '{'))\r
1222 elif not self.DefaultStoreSingle and self.SkuSingle:\r
1223 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + DefaultStore + ')', '{'))\r
1224 else:\r
1225 FileWrite(File, ' %-*s : %6s %10s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '(' + DefaultStore + ')', '{'))\r
1226 for Array in ArrayList:\r
1227 FileWrite(File, '%s' % (Array))\r
1228 else:\r
1229 if self.DefaultStoreSingle and self.SkuSingle:\r
1230 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', Value))\r
1231 elif self.DefaultStoreSingle and not self.SkuSingle:\r
1232 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', Value))\r
1233 elif not self.DefaultStoreSingle and self.SkuSingle:\r
1234 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + DefaultStore + ')', Value))\r
1235 else:\r
1236 FileWrite(File, ' %-*s : %6s %10s %10s %10s = %s' % (self.MaxLen, ' ', TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', '(' + DefaultStore + ')', Value))\r
1237 FileWrite(File, '%*s: %s: %s' % (self.MaxLen + 4, SkuInfo.VariableGuid, SkuInfo.VariableName, SkuInfo.VariableOffset))\r
1238 if IsStructure:\r
1239 OverrideValues = Pcd.SkuOverrideValues[Sku]\r
1240 OverrideFieldStruct = self.OverrideFieldValue(Pcd, OverrideValues[DefaultStore])\r
1241 self.PrintStructureInfo(File, OverrideFieldStruct)\r
1242 self.PrintPcdDefault(File, Pcd, IsStructure, DscMatch, DscDefaultValue, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue)\r
1243 else:\r
1244 Value = SkuInfo.DefaultValue\r
1245 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1246 if FirstPrint:\r
1247 FirstPrint = False\r
1248 if IsByteArray:\r
1249 if self.SkuSingle:\r
1250 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', "{"))\r
1251 else:\r
1252 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', "{"))\r
1253 for Array in ArrayList:\r
1254 FileWrite(File, '%s' % (Array))\r
1255 else:\r
1256 if self.SkuSingle:\r
1257 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', Value))\r
1258 else:\r
1259 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, Flag + ' ' + PcdTokenCName, TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', Value))\r
1260 else:\r
1261 if IsByteArray:\r
1262 if self.SkuSingle:\r
1263 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, ' ' , TypeName, '(' + Pcd.DatumType + ')', "{"))\r
1264 else:\r
1265 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ' , TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', "{"))\r
1266 for Array in ArrayList:\r
1267 FileWrite(File, '%s' % (Array))\r
1268 else:\r
1269 if self.SkuSingle:\r
1270 FileWrite(File, ' %-*s : %6s %10s = %s' % (self.MaxLen, ' ' , TypeName, '(' + Pcd.DatumType + ')', Value))\r
1271 else:\r
1272 FileWrite(File, ' %-*s : %6s %10s %10s = %s' % (self.MaxLen, ' ' , TypeName, '(' + Pcd.DatumType + ')', '(' + SkuIdName + ')', Value))\r
1273 if TypeName in ('DYNVPD', 'DEXVPD'):\r
1274 FileWrite(File, '%*s' % (self.MaxLen + 4, SkuInfo.VpdOffset))\r
1275 if IsStructure:\r
1276 OverrideValues = Pcd.SkuOverrideValues[Sku]\r
1277 if OverrideValues:\r
1278 Keys = OverrideValues.keys()\r
1279 OverrideFieldStruct = self.OverrideFieldValue(Pcd, OverrideValues[Keys[0]])\r
1280 self.PrintStructureInfo(File, OverrideFieldStruct)\r
1281 self.PrintPcdDefault(File, Pcd, IsStructure, DscMatch, DscDefaultValue, InfMatch, InfDefaultValue, DecMatch, DecDefaultValue)\r
1282\r
1283 def OverrideFieldValue(self, Pcd, OverrideStruct):\r
1284 OverrideFieldStruct = collections.OrderedDict()\r
1285 if OverrideStruct:\r
1286 for Key, Values in OverrideStruct.items():\r
1287 if Values[1] and Values[1].endswith('.dsc'):\r
1288 OverrideFieldStruct[Key] = Values\r
1289 if Pcd.PcdFieldValueFromComm:\r
1290 for Key, Values in Pcd.PcdFieldValueFromComm.items():\r
1291 OverrideFieldStruct[Key] = Values\r
1292 return OverrideFieldStruct\r
1293\r
1294 def PrintStructureInfo(self, File, Struct):\r
1295 for Key, Value in Struct.items():\r
1296 if Value[1] and 'build command options' in Value[1]:\r
1297 FileWrite(File, ' *B %-*s = %s' % (self.MaxLen + 4, '.' + Key, Value[0]))\r
1298 else:\r
1299 FileWrite(File, ' %-*s = %s' % (self.MaxLen + 4, '.' + Key, Value[0]))\r
1300\r
1301 def StrtoHex(self, value):\r
1302 try:\r
1303 value = hex(int(value))\r
1304 return value\r
1305 except:\r
1306 if value.startswith("L\"") and value.endswith("\""):\r
1307 valuelist = []\r
1308 for ch in value[2:-1]:\r
1309 valuelist.append(hex(ord(ch)))\r
1310 valuelist.append('0x00')\r
1311 return valuelist\r
1312 elif value.startswith("\"") and value.endswith("\""):\r
1313 return hex(ord(value[1:-1]))\r
1314 elif value.startswith("{") and value.endswith("}"):\r
1315 valuelist = []\r
1316 if ',' not in value:\r
1317 return value[1:-1]\r
1318 for ch in value[1:-1].split(','):\r
1319 ch = ch.strip()\r
1320 if ch.startswith('0x') or ch.startswith('0X'):\r
1321 valuelist.append(ch)\r
1322 continue\r
1323 try:\r
1324 valuelist.append(hex(int(ch.strip())))\r
1325 except:\r
1326 pass\r
1327 return valuelist\r
1328 else:\r
1329 return value\r
1330\r
1331##\r
1332# Reports platform and module Prediction information\r
1333#\r
1334# This class reports the platform execution order prediction section and\r
1335# module load fixed address prediction subsection in the build report file.\r
1336#\r
1337class PredictionReport(object):\r
1338 ##\r
1339 # Constructor function for class PredictionReport\r
1340 #\r
1341 # This constructor function generates PredictionReport object for the platform.\r
1342 #\r
1343 # @param self: The object pointer\r
1344 # @param Wa Workspace context information\r
1345 #\r
1346 def __init__(self, Wa):\r
1347 self._MapFileName = os.path.join(Wa.BuildDir, Wa.Name + ".map")\r
1348 self._MapFileParsed = False\r
1349 self._EotToolInvoked = False\r
1350 self._FvDir = Wa.FvDir\r
1351 self._EotDir = Wa.BuildDir\r
1352 self._FfsEntryPoint = {}\r
1353 self._GuidMap = {}\r
1354 self._SourceList = []\r
1355 self.FixedMapDict = {}\r
1356 self.ItemList = []\r
1357 self.MaxLen = 0\r
1358\r
1359 #\r
1360 # Collect all platform reference source files and GUID C Name\r
1361 #\r
1362 for Pa in Wa.AutoGenObjectList:\r
1363 for Module in Pa.LibraryAutoGenList + Pa.ModuleAutoGenList:\r
1364 #\r
1365 # BASE typed modules are EFI agnostic, so we need not scan\r
1366 # their source code to find PPI/Protocol produce or consume\r
1367 # information.\r
1368 #\r
1369 if Module.ModuleType == "BASE":\r
1370 continue\r
1371 #\r
1372 # Add module referenced source files\r
1373 #\r
1374 self._SourceList.append(str(Module))\r
1375 IncludeList = {}\r
1376 for Source in Module.SourceFileList:\r
1377 if os.path.splitext(str(Source))[1].lower() == ".c":\r
1378 self._SourceList.append(" " + str(Source))\r
1379 FindIncludeFiles(Source.Path, Module.IncludePathList, IncludeList)\r
1380 for IncludeFile in IncludeList.values():\r
1381 self._SourceList.append(" " + IncludeFile)\r
1382\r
1383 for Guid in Module.PpiList:\r
1384 self._GuidMap[Guid] = GuidStructureStringToGuidString(Module.PpiList[Guid])\r
1385 for Guid in Module.ProtocolList:\r
1386 self._GuidMap[Guid] = GuidStructureStringToGuidString(Module.ProtocolList[Guid])\r
1387 for Guid in Module.GuidList:\r
1388 self._GuidMap[Guid] = GuidStructureStringToGuidString(Module.GuidList[Guid])\r
1389\r
1390 if Module.Guid and not Module.IsLibrary:\r
1391 EntryPoint = " ".join(Module.Module.ModuleEntryPointList)\r
1392 if int(str(Module.AutoGenVersion), 0) >= 0x00010005:\r
1393 RealEntryPoint = "_ModuleEntryPoint"\r
1394 else:\r
1395 RealEntryPoint = EntryPoint\r
1396 if EntryPoint == "_ModuleEntryPoint":\r
1397 CCFlags = Module.BuildOption.get("CC", {}).get("FLAGS", "")\r
1398 Match = gGlueLibEntryPoint.search(CCFlags)\r
1399 if Match:\r
1400 EntryPoint = Match.group(1)\r
1401\r
1402 self._FfsEntryPoint[Module.Guid.upper()] = (EntryPoint, RealEntryPoint)\r
1403\r
1404\r
1405 #\r
1406 # Collect platform firmware volume list as the input of EOT.\r
1407 #\r
1408 self._FvList = []\r
1409 if Wa.FdfProfile:\r
1410 for Fd in Wa.FdfProfile.FdDict:\r
1411 for FdRegion in Wa.FdfProfile.FdDict[Fd].RegionList:\r
1412 if FdRegion.RegionType != "FV":\r
1413 continue\r
1414 for FvName in FdRegion.RegionDataList:\r
1415 if FvName in self._FvList:\r
1416 continue\r
1417 self._FvList.append(FvName)\r
1418 for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:\r
1419 for Section in Ffs.SectionList:\r
1420 try:\r
1421 for FvSection in Section.SectionList:\r
1422 if FvSection.FvName in self._FvList:\r
1423 continue\r
1424 self._FvList.append(FvSection.FvName)\r
1425 except AttributeError:\r
1426 pass\r
1427\r
1428\r
1429 ##\r
1430 # Parse platform fixed address map files\r
1431 #\r
1432 # This function parses the platform final fixed address map file to get\r
1433 # the database of predicted fixed address for module image base, entry point\r
1434 # etc.\r
1435 #\r
1436 # @param self: The object pointer\r
1437 #\r
1438 def _ParseMapFile(self):\r
1439 if self._MapFileParsed:\r
1440 return\r
1441 self._MapFileParsed = True\r
1442 if os.path.isfile(self._MapFileName):\r
1443 try:\r
1444 FileContents = open(self._MapFileName).read()\r
1445 for Match in gMapFileItemPattern.finditer(FileContents):\r
1446 AddressType = Match.group(1)\r
1447 BaseAddress = Match.group(2)\r
1448 EntryPoint = Match.group(3)\r
1449 Guid = Match.group(4).upper()\r
1450 List = self.FixedMapDict.setdefault(Guid, [])\r
1451 List.append((AddressType, BaseAddress, "*I"))\r
1452 List.append((AddressType, EntryPoint, "*E"))\r
1453 except:\r
1454 EdkLogger.warn(None, "Cannot open file to read", self._MapFileName)\r
1455\r
1456 ##\r
1457 # Invokes EOT tool to get the predicted the execution order.\r
1458 #\r
1459 # This function invokes EOT tool to calculate the predicted dispatch order\r
1460 #\r
1461 # @param self: The object pointer\r
1462 #\r
1463 def _InvokeEotTool(self):\r
1464 if self._EotToolInvoked:\r
1465 return\r
1466\r
1467 self._EotToolInvoked = True\r
1468 FvFileList = []\r
1469 for FvName in self._FvList:\r
1470 FvFile = os.path.join(self._FvDir, FvName + ".Fv")\r
1471 if os.path.isfile(FvFile):\r
1472 FvFileList.append(FvFile)\r
1473\r
1474 if len(FvFileList) == 0:\r
1475 return\r
1476 #\r
1477 # Write source file list and GUID file list to an intermediate file\r
1478 # as the input for EOT tool and dispatch List as the output file\r
1479 # from EOT tool.\r
1480 #\r
1481 SourceList = os.path.join(self._EotDir, "SourceFile.txt")\r
1482 GuidList = os.path.join(self._EotDir, "GuidList.txt")\r
1483 DispatchList = os.path.join(self._EotDir, "Dispatch.txt")\r
1484\r
1485 TempFile = open(SourceList, "w+")\r
1486 for Item in self._SourceList:\r
1487 FileWrite(TempFile, Item)\r
1488 TempFile.close()\r
1489 TempFile = open(GuidList, "w+")\r
1490 for Key in self._GuidMap:\r
1491 FileWrite(TempFile, "%s %s" % (Key, self._GuidMap[Key]))\r
1492 TempFile.close()\r
1493\r
1494 try:\r
1495 from Eot.Eot import Eot\r
1496\r
1497 #\r
1498 # Invoke EOT tool and echo its runtime performance\r
1499 #\r
1500 EotStartTime = time.time()\r
1501 Eot(CommandLineOption=False, SourceFileList=SourceList, GuidList=GuidList,\r
1502 FvFileList=' '.join(FvFileList), Dispatch=DispatchList, IsInit=True)\r
1503 EotEndTime = time.time()\r
1504 EotDuration = time.strftime("%H:%M:%S", time.gmtime(int(round(EotEndTime - EotStartTime))))\r
1505 EdkLogger.quiet("EOT run time: %s\n" % EotDuration)\r
1506 \r
1507 #\r
1508 # Parse the output of EOT tool\r
1509 #\r
1510 for Line in open(DispatchList):\r
1511 if len(Line.split()) < 4:\r
1512 continue\r
1513 (Guid, Phase, FfsName, FilePath) = Line.split()\r
1514 Symbol = self._FfsEntryPoint.get(Guid, [FfsName, ""])[0]\r
1515 if len(Symbol) > self.MaxLen:\r
1516 self.MaxLen = len(Symbol)\r
1517 self.ItemList.append((Phase, Symbol, FilePath))\r
1518 except:\r
1519 EdkLogger.quiet("(Python %s on %s\n%s)" % (platform.python_version(), sys.platform, traceback.format_exc()))\r
1520 EdkLogger.warn(None, "Failed to generate execution order prediction report, for some error occurred in executing EOT.")\r
1521\r
1522\r
1523 ##\r
1524 # Generate platform execution order report\r
1525 #\r
1526 # This function generates the predicted module execution order.\r
1527 #\r
1528 # @param self The object pointer\r
1529 # @param File The file object for report\r
1530 #\r
1531 def _GenerateExecutionOrderReport(self, File):\r
1532 self._InvokeEotTool()\r
1533 if len(self.ItemList) == 0:\r
1534 return\r
1535 FileWrite(File, gSectionStart)\r
1536 FileWrite(File, "Execution Order Prediction")\r
1537 FileWrite(File, "*P PEI phase")\r
1538 FileWrite(File, "*D DXE phase")\r
1539 FileWrite(File, "*E Module INF entry point name")\r
1540 FileWrite(File, "*N Module notification function name")\r
1541\r
1542 FileWrite(File, "Type %-*s %s" % (self.MaxLen, "Symbol", "Module INF Path"))\r
1543 FileWrite(File, gSectionSep)\r
1544 for Item in self.ItemList:\r
1545 FileWrite(File, "*%sE %-*s %s" % (Item[0], self.MaxLen, Item[1], Item[2]))\r
1546\r
1547 FileWrite(File, gSectionStart)\r
1548\r
1549 ##\r
1550 # Generate Fixed Address report.\r
1551 #\r
1552 # This function generate the predicted fixed address report for a module\r
1553 # specified by Guid.\r
1554 #\r
1555 # @param self The object pointer\r
1556 # @param File The file object for report\r
1557 # @param Guid The module Guid value.\r
1558 # @param NotifyList The list of all notify function in a module\r
1559 #\r
1560 def _GenerateFixedAddressReport(self, File, Guid, NotifyList):\r
1561 self._ParseMapFile()\r
1562 FixedAddressList = self.FixedMapDict.get(Guid)\r
1563 if not FixedAddressList:\r
1564 return\r
1565\r
1566 FileWrite(File, gSubSectionStart)\r
1567 FileWrite(File, "Fixed Address Prediction")\r
1568 FileWrite(File, "*I Image Loading Address")\r
1569 FileWrite(File, "*E Entry Point Address")\r
1570 FileWrite(File, "*N Notification Function Address")\r
1571 FileWrite(File, "*F Flash Address")\r
1572 FileWrite(File, "*M Memory Address")\r
1573 FileWrite(File, "*S SMM RAM Offset")\r
1574 FileWrite(File, "TOM Top of Memory")\r
1575\r
1576 FileWrite(File, "Type Address Name")\r
1577 FileWrite(File, gSubSectionSep)\r
1578 for Item in FixedAddressList:\r
1579 Type = Item[0]\r
1580 Value = Item[1]\r
1581 Symbol = Item[2]\r
1582 if Symbol == "*I":\r
1583 Name = "(Image Base)"\r
1584 elif Symbol == "*E":\r
1585 Name = self._FfsEntryPoint.get(Guid, ["", "_ModuleEntryPoint"])[1]\r
1586 elif Symbol in NotifyList:\r
1587 Name = Symbol\r
1588 Symbol = "*N"\r
1589 else:\r
1590 continue\r
1591\r
1592 if "Flash" in Type:\r
1593 Symbol += "F"\r
1594 elif "Memory" in Type:\r
1595 Symbol += "M"\r
1596 else:\r
1597 Symbol += "S"\r
1598\r
1599 if Value[0] == "-":\r
1600 Value = "TOM" + Value\r
1601\r
1602 FileWrite(File, "%s %-16s %s" % (Symbol, Value, Name))\r
1603\r
1604 ##\r
1605 # Generate report for the prediction part\r
1606 #\r
1607 # This function generate the predicted fixed address report for a module or\r
1608 # predicted module execution order for a platform.\r
1609 # If the input Guid is None, then, it generates the predicted module execution order;\r
1610 # otherwise it generated the module fixed loading address for the module specified by\r
1611 # Guid.\r
1612 #\r
1613 # @param self The object pointer\r
1614 # @param File The file object for report\r
1615 # @param Guid The module Guid value.\r
1616 #\r
1617 def GenerateReport(self, File, Guid):\r
1618 if Guid:\r
1619 self._GenerateFixedAddressReport(File, Guid.upper(), [])\r
1620 else:\r
1621 self._GenerateExecutionOrderReport(File)\r
1622\r
1623##\r
1624# Reports FD region information\r
1625#\r
1626# This class reports the FD subsection in the build report file.\r
1627# It collects region information of platform flash device.\r
1628# If the region is a firmware volume, it lists the set of modules\r
1629# and its space information; otherwise, it only lists its region name,\r
1630# base address and size in its sub-section header.\r
1631# If there are nesting FVs, the nested FVs will list immediate after\r
1632# this FD region subsection\r
1633#\r
1634class FdRegionReport(object):\r
1635 ##\r
1636 # Discover all the nested FV name list.\r
1637 #\r
1638 # This is an internal worker function to discover the all the nested FV information\r
1639 # in the parent firmware volume. It uses deep first search algorithm recursively to\r
1640 # find all the FV list name and append them to the list.\r
1641 #\r
1642 # @param self The object pointer\r
1643 # @param FvName The name of current firmware file system\r
1644 # @param Wa Workspace context information\r
1645 #\r
1646 def _DiscoverNestedFvList(self, FvName, Wa):\r
1647 FvDictKey=FvName.upper()\r
1648 if FvDictKey in Wa.FdfProfile.FvDict:\r
1649 for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:\r
1650 for Section in Ffs.SectionList:\r
1651 try:\r
1652 for FvSection in Section.SectionList:\r
1653 if FvSection.FvName in self.FvList:\r
1654 continue\r
1655 self._GuidsDb[Ffs.NameGuid.upper()] = FvSection.FvName\r
1656 self.FvList.append(FvSection.FvName)\r
1657 self.FvInfo[FvSection.FvName] = ("Nested FV", 0, 0)\r
1658 self._DiscoverNestedFvList(FvSection.FvName, Wa)\r
1659 except AttributeError:\r
1660 pass\r
1661\r
1662 ##\r
1663 # Constructor function for class FdRegionReport\r
1664 #\r
1665 # This constructor function generates FdRegionReport object for a specified FdRegion.\r
1666 # If the FdRegion is a firmware volume, it will recursively find all its nested Firmware\r
1667 # volume list. This function also collects GUID map in order to dump module identification\r
1668 # in the final report.\r
1669 #\r
1670 # @param self: The object pointer\r
1671 # @param FdRegion The current FdRegion object\r
1672 # @param Wa Workspace context information\r
1673 #\r
1674 def __init__(self, FdRegion, Wa):\r
1675 self.Type = FdRegion.RegionType\r
1676 self.BaseAddress = FdRegion.Offset\r
1677 self.Size = FdRegion.Size\r
1678 self.FvList = []\r
1679 self.FvInfo = {}\r
1680 self._GuidsDb = {}\r
1681 self._FvDir = Wa.FvDir\r
1682 self._WorkspaceDir = Wa.WorkspaceDir\r
1683\r
1684 #\r
1685 # If the input FdRegion is not a firmware volume,\r
1686 # we are done.\r
1687 #\r
1688 if self.Type != "FV":\r
1689 return\r
1690\r
1691 #\r
1692 # Find all nested FVs in the FdRegion\r
1693 #\r
1694 for FvName in FdRegion.RegionDataList:\r
1695 if FvName in self.FvList:\r
1696 continue\r
1697 self.FvList.append(FvName)\r
1698 self.FvInfo[FvName] = ("Fd Region", self.BaseAddress, self.Size)\r
1699 self._DiscoverNestedFvList(FvName, Wa)\r
1700\r
1701 PlatformPcds = {}\r
1702 #\r
1703 # Collect PCDs declared in DEC files.\r
1704 # \r
1705 for Pa in Wa.AutoGenObjectList:\r
1706 for Package in Pa.PackageList:\r
1707 for (TokenCName, TokenSpaceGuidCName, DecType) in Package.Pcds:\r
1708 DecDefaultValue = Package.Pcds[TokenCName, TokenSpaceGuidCName, DecType].DefaultValue\r
1709 PlatformPcds[(TokenCName, TokenSpaceGuidCName)] = DecDefaultValue\r
1710 #\r
1711 # Collect PCDs defined in DSC file\r
1712 #\r
1713 for Pa in Wa.AutoGenObjectList:\r
1714 for (TokenCName, TokenSpaceGuidCName) in Pa.Platform.Pcds:\r
1715 DscDefaultValue = Pa.Platform.Pcds[(TokenCName, TokenSpaceGuidCName)].DefaultValue\r
1716 PlatformPcds[(TokenCName, TokenSpaceGuidCName)] = DscDefaultValue\r
1717\r
1718 #\r
1719 # Add PEI and DXE a priori files GUIDs defined in PI specification.\r
1720 #\r
1721 self._GuidsDb["1B45CC0A-156A-428A-AF62-49864DA0E6E6"] = "PEI Apriori"\r
1722 self._GuidsDb["FC510EE7-FFDC-11D4-BD41-0080C73C8881"] = "DXE Apriori"\r
1723 #\r
1724 # Add ACPI table storage file\r
1725 #\r
1726 self._GuidsDb["7E374E25-8E01-4FEE-87F2-390C23C606CD"] = "ACPI table storage"\r
1727\r
1728 for Pa in Wa.AutoGenObjectList:\r
1729 for ModuleKey in Pa.Platform.Modules:\r
1730 M = Pa.Platform.Modules[ModuleKey].M\r
1731 InfPath = mws.join(Wa.WorkspaceDir, M.MetaFile.File)\r
1732 self._GuidsDb[M.Guid.upper()] = "%s (%s)" % (M.Module.BaseName, InfPath)\r
1733\r
1734 #\r
1735 # Collect the GUID map in the FV firmware volume\r
1736 #\r
1737 for FvName in self.FvList:\r
1738 FvDictKey=FvName.upper()\r
1739 if FvDictKey in Wa.FdfProfile.FvDict:\r
1740 for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:\r
1741 try:\r
1742 #\r
1743 # collect GUID map for binary EFI file in FDF file.\r
1744 #\r
1745 Guid = Ffs.NameGuid.upper()\r
1746 Match = gPcdGuidPattern.match(Ffs.NameGuid)\r
1747 if Match:\r
1748 PcdTokenspace = Match.group(1)\r
1749 PcdToken = Match.group(2)\r
1750 if (PcdToken, PcdTokenspace) in PlatformPcds:\r
1751 GuidValue = PlatformPcds[(PcdToken, PcdTokenspace)]\r
1752 Guid = GuidStructureByteArrayToGuidString(GuidValue).upper()\r
1753 for Section in Ffs.SectionList:\r
1754 try:\r
1755 ModuleSectFile = mws.join(Wa.WorkspaceDir, Section.SectFileName)\r
1756 self._GuidsDb[Guid] = ModuleSectFile\r
1757 except AttributeError:\r
1758 pass\r
1759 except AttributeError:\r
1760 pass\r
1761\r
1762\r
1763 ##\r
1764 # Internal worker function to generate report for the FD region\r
1765 #\r
1766 # This internal worker function to generate report for the FD region.\r
1767 # It the type is firmware volume, it lists offset and module identification.\r
1768 #\r
1769 # @param self The object pointer\r
1770 # @param File The file object for report\r
1771 # @param Title The title for the FD subsection\r
1772 # @param BaseAddress The base address for the FD region\r
1773 # @param Size The size of the FD region\r
1774 # @param FvName The FV name if the FD region is a firmware volume\r
1775 #\r
1776 def _GenerateReport(self, File, Title, Type, BaseAddress, Size=0, FvName=None):\r
1777 FileWrite(File, gSubSectionStart)\r
1778 FileWrite(File, Title)\r
1779 FileWrite(File, "Type: %s" % Type)\r
1780 FileWrite(File, "Base Address: 0x%X" % BaseAddress)\r
1781\r
1782 if self.Type == "FV":\r
1783 FvTotalSize = 0\r
1784 FvTakenSize = 0\r
1785 FvFreeSize = 0\r
1786 if FvName.upper().endswith('.FV'):\r
1787 FileExt = FvName + ".txt"\r
1788 else:\r
1789 FileExt = FvName + ".Fv.txt"\r
1790\r
1791 if not os.path.isfile(FileExt):\r
1792 FvReportFileName = mws.join(self._WorkspaceDir, FileExt)\r
1793 if not os.path.isfile(FvReportFileName):\r
1794 FvReportFileName = os.path.join(self._FvDir, FileExt)\r
1795 try:\r
1796 #\r
1797 # Collect size info in the firmware volume.\r
1798 #\r
1799 FvReport = open(FvReportFileName).read()\r
1800 Match = gFvTotalSizePattern.search(FvReport)\r
1801 if Match:\r
1802 FvTotalSize = int(Match.group(1), 16)\r
1803 Match = gFvTakenSizePattern.search(FvReport)\r
1804 if Match:\r
1805 FvTakenSize = int(Match.group(1), 16)\r
1806 FvFreeSize = FvTotalSize - FvTakenSize\r
1807 #\r
1808 # Write size information to the report file.\r
1809 #\r
1810 FileWrite(File, "Size: 0x%X (%.0fK)" % (FvTotalSize, FvTotalSize / 1024.0))\r
1811 FileWrite(File, "Fv Name: %s (%.1f%% Full)" % (FvName, FvTakenSize * 100.0 / FvTotalSize))\r
1812 FileWrite(File, "Occupied Size: 0x%X (%.0fK)" % (FvTakenSize, FvTakenSize / 1024.0))\r
1813 FileWrite(File, "Free Size: 0x%X (%.0fK)" % (FvFreeSize, FvFreeSize / 1024.0))\r
1814 FileWrite(File, "Offset Module")\r
1815 FileWrite(File, gSubSectionSep)\r
1816 #\r
1817 # Write module offset and module identification to the report file.\r
1818 #\r
1819 OffsetInfo = {}\r
1820 for Match in gOffsetGuidPattern.finditer(FvReport):\r
1821 Guid = Match.group(2).upper()\r
1822 OffsetInfo[Match.group(1)] = self._GuidsDb.get(Guid, Guid)\r
1823 OffsetList = OffsetInfo.keys()\r
1824 OffsetList.sort()\r
1825 for Offset in OffsetList:\r
1826 FileWrite (File, "%s %s" % (Offset, OffsetInfo[Offset]))\r
1827 except IOError:\r
1828 EdkLogger.warn(None, "Fail to read report file", FvReportFileName)\r
1829 else:\r
1830 FileWrite(File, "Size: 0x%X (%.0fK)" % (Size, Size / 1024.0))\r
1831 FileWrite(File, gSubSectionEnd)\r
1832\r
1833 ##\r
1834 # Generate report for the FD region\r
1835 #\r
1836 # This function generates report for the FD region.\r
1837 #\r
1838 # @param self The object pointer\r
1839 # @param File The file object for report\r
1840 #\r
1841 def GenerateReport(self, File):\r
1842 if (len(self.FvList) > 0):\r
1843 for FvItem in self.FvList:\r
1844 Info = self.FvInfo[FvItem]\r
1845 self._GenerateReport(File, Info[0], "FV", Info[1], Info[2], FvItem)\r
1846 else:\r
1847 self._GenerateReport(File, "FD Region", self.Type, self.BaseAddress, self.Size)\r
1848\r
1849##\r
1850# Reports FD information\r
1851#\r
1852# This class reports the FD section in the build report file.\r
1853# It collects flash device information for a platform.\r
1854#\r
1855class FdReport(object):\r
1856 ##\r
1857 # Constructor function for class FdReport\r
1858 #\r
1859 # This constructor function generates FdReport object for a specified\r
1860 # firmware device.\r
1861 #\r
1862 # @param self The object pointer\r
1863 # @param Fd The current Firmware device object\r
1864 # @param Wa Workspace context information\r
1865 #\r
1866 def __init__(self, Fd, Wa):\r
1867 self.FdName = Fd.FdUiName\r
1868 self.BaseAddress = Fd.BaseAddress\r
1869 self.Size = Fd.Size\r
1870 self.FdRegionList = [FdRegionReport(FdRegion, Wa) for FdRegion in Fd.RegionList]\r
1871 self.FvPath = os.path.join(Wa.BuildDir, "FV")\r
1872 self.VpdFilePath = os.path.join(self.FvPath, "%s.map" % Wa.Platform.VpdToolGuid)\r
1873 self.VPDBaseAddress = 0\r
1874 self.VPDSize = 0\r
1875 self.VPDInfoList = []\r
1876 for index, FdRegion in enumerate(Fd.RegionList):\r
1877 if str(FdRegion.RegionType) is 'FILE' and Wa.Platform.VpdToolGuid in str(FdRegion.RegionDataList):\r
1878 self.VPDBaseAddress = self.FdRegionList[index].BaseAddress\r
1879 self.VPDSize = self.FdRegionList[index].Size\r
1880 break\r
1881\r
1882 if os.path.isfile(self.VpdFilePath):\r
1883 fd = open(self.VpdFilePath, "r")\r
1884 Lines = fd.readlines()\r
1885 for Line in Lines:\r
1886 Line = Line.strip()\r
1887 if len(Line) == 0 or Line.startswith("#"):\r
1888 continue\r
1889 try:\r
1890 PcdName, SkuId, Offset, Size, Value = Line.split("#")[0].split("|")\r
1891 PcdName, SkuId, Offset, Size, Value = PcdName.strip(), SkuId.strip(), Offset.strip(), Size.strip(), Value.strip()\r
1892 if Offset.lower().startswith('0x'):\r
1893 Offset = '0x%08X' % (int(Offset, 16) + self.VPDBaseAddress)\r
1894 else:\r
1895 Offset = '0x%08X' % (int(Offset, 10) + self.VPDBaseAddress)\r
1896 self.VPDInfoList.append("%s | %s | %s | %s | %s" % (PcdName, SkuId, Offset, Size, Value))\r
1897 except:\r
1898 EdkLogger.error("BuildReport", CODE_ERROR, "Fail to parse VPD information file %s" % self.VpdFilePath)\r
1899 fd.close()\r
1900\r
1901 ##\r
1902 # Generate report for the firmware device.\r
1903 #\r
1904 # This function generates report for the firmware device.\r
1905 #\r
1906 # @param self The object pointer\r
1907 # @param File The file object for report\r
1908 #\r
1909 def GenerateReport(self, File):\r
1910 FileWrite(File, gSectionStart)\r
1911 FileWrite(File, "Firmware Device (FD)")\r
1912 FileWrite(File, "FD Name: %s" % self.FdName)\r
1913 FileWrite(File, "Base Address: %s" % self.BaseAddress)\r
1914 FileWrite(File, "Size: 0x%X (%.0fK)" % (self.Size, self.Size / 1024.0))\r
1915 if len(self.FdRegionList) > 0:\r
1916 FileWrite(File, gSectionSep)\r
1917 for FdRegionItem in self.FdRegionList:\r
1918 FdRegionItem.GenerateReport(File)\r
1919\r
1920 if len(self.VPDInfoList) > 0:\r
1921 FileWrite(File, gSubSectionStart)\r
1922 FileWrite(File, "FD VPD Region")\r
1923 FileWrite(File, "Base Address: 0x%X" % self.VPDBaseAddress)\r
1924 FileWrite(File, "Size: 0x%X (%.0fK)" % (self.VPDSize, self.VPDSize / 1024.0))\r
1925 FileWrite(File, gSubSectionSep)\r
1926 for item in self.VPDInfoList:\r
1927 ValueList = item.split('|')\r
1928 Value = ValueList[-1].strip()\r
1929 IsByteArray, ArrayList = ByteArrayForamt(Value)\r
1930 if IsByteArray:\r
1931 ValueList[-1] = ' {'\r
1932 FileWrite(File, '|'.join(ValueList))\r
1933 for Array in ArrayList:\r
1934 FileWrite(File, '%s' % (Array))\r
1935 else:\r
1936 FileWrite(File, item)\r
1937 FileWrite(File, gSubSectionEnd)\r
1938 FileWrite(File, gSectionEnd)\r
1939\r
1940\r
1941\r
1942##\r
1943# Reports platform information\r
1944#\r
1945# This class reports the whole platform information\r
1946#\r
1947class PlatformReport(object):\r
1948 ##\r
1949 # Constructor function for class PlatformReport\r
1950 #\r
1951 # This constructor function generates PlatformReport object a platform build.\r
1952 # It generates report for platform summary, flash, global PCDs and detailed\r
1953 # module information for modules involved in platform build.\r
1954 #\r
1955 # @param self The object pointer\r
1956 # @param Wa Workspace context information\r
1957 # @param MaList The list of modules in the platform build\r
1958 #\r
1959 def __init__(self, Wa, MaList, ReportType):\r
1960 self._WorkspaceDir = Wa.WorkspaceDir\r
1961 self.PlatformName = Wa.Name\r
1962 self.PlatformDscPath = Wa.Platform\r
1963 self.Architectures = " ".join(Wa.ArchList)\r
1964 self.ToolChain = Wa.ToolChain\r
1965 self.Target = Wa.BuildTarget\r
1966 self.OutputPath = os.path.join(Wa.WorkspaceDir, Wa.OutputDir)\r
1967 self.BuildEnvironment = platform.platform()\r
1968\r
1969 self.PcdReport = None\r
1970 if "PCD" in ReportType:\r
1971 self.PcdReport = PcdReport(Wa)\r
1972\r
1973 self.FdReportList = []\r
1974 if "FLASH" in ReportType and Wa.FdfProfile and MaList == None:\r
1975 for Fd in Wa.FdfProfile.FdDict:\r
1976 self.FdReportList.append(FdReport(Wa.FdfProfile.FdDict[Fd], Wa))\r
1977\r
1978 self.PredictionReport = None\r
1979 if "FIXED_ADDRESS" in ReportType or "EXECUTION_ORDER" in ReportType:\r
1980 self.PredictionReport = PredictionReport(Wa)\r
1981\r
1982 self.DepexParser = None\r
1983 if "DEPEX" in ReportType:\r
1984 self.DepexParser = DepexParser(Wa)\r
1985 \r
1986 self.ModuleReportList = []\r
1987 if MaList != None:\r
1988 self._IsModuleBuild = True\r
1989 for Ma in MaList:\r
1990 self.ModuleReportList.append(ModuleReport(Ma, ReportType))\r
1991 else:\r
1992 self._IsModuleBuild = False\r
1993 for Pa in Wa.AutoGenObjectList:\r
1994 ModuleAutoGenList = []\r
1995 for ModuleKey in Pa.Platform.Modules:\r
1996 ModuleAutoGenList.append(Pa.Platform.Modules[ModuleKey].M)\r
1997 if GlobalData.gFdfParser != None:\r
1998 if Pa.Arch in GlobalData.gFdfParser.Profile.InfDict:\r
1999 INFList = GlobalData.gFdfParser.Profile.InfDict[Pa.Arch]\r
2000 for InfName in INFList:\r
2001 InfClass = PathClass(NormPath(InfName), Wa.WorkspaceDir, Pa.Arch)\r
2002 Ma = ModuleAutoGen(Wa, InfClass, Pa.BuildTarget, Pa.ToolChain, Pa.Arch, Wa.MetaFile)\r
2003 if Ma == None:\r
2004 continue\r
2005 if Ma not in ModuleAutoGenList:\r
2006 ModuleAutoGenList.append(Ma)\r
2007 for MGen in ModuleAutoGenList:\r
2008 self.ModuleReportList.append(ModuleReport(MGen, ReportType))\r
2009\r
2010\r
2011\r
2012 ##\r
2013 # Generate report for the whole platform.\r
2014 #\r
2015 # This function generates report for platform information.\r
2016 # It comprises of platform summary, global PCD, flash and\r
2017 # module list sections.\r
2018 #\r
2019 # @param self The object pointer\r
2020 # @param File The file object for report\r
2021 # @param BuildDuration The total time to build the modules\r
2022 # @param AutoGenTime The total time of AutoGen Phase\r
2023 # @param MakeTime The total time of Make Phase\r
2024 # @param GenFdsTime The total time of GenFds Phase\r
2025 # @param ReportType The kind of report items in the final report file\r
2026 #\r
2027 def GenerateReport(self, File, BuildDuration, AutoGenTime, MakeTime, GenFdsTime, ReportType):\r
2028 FileWrite(File, "Platform Summary")\r
2029 FileWrite(File, "Platform Name: %s" % self.PlatformName)\r
2030 FileWrite(File, "Platform DSC Path: %s" % self.PlatformDscPath)\r
2031 FileWrite(File, "Architectures: %s" % self.Architectures)\r
2032 FileWrite(File, "Tool Chain: %s" % self.ToolChain)\r
2033 FileWrite(File, "Target: %s" % self.Target)\r
2034 if GlobalData.gSkuids:\r
2035 FileWrite(File, "SKUID: %s" % " ".join(GlobalData.gSkuids))\r
2036 if GlobalData.gDefaultStores:\r
2037 FileWrite(File, "DefaultStore: %s" % " ".join(GlobalData.gDefaultStores))\r
2038 FileWrite(File, "Output Path: %s" % self.OutputPath)\r
2039 FileWrite(File, "Build Environment: %s" % self.BuildEnvironment)\r
2040 FileWrite(File, "Build Duration: %s" % BuildDuration)\r
2041 if AutoGenTime:\r
2042 FileWrite(File, "AutoGen Duration: %s" % AutoGenTime)\r
2043 if MakeTime:\r
2044 FileWrite(File, "Make Duration: %s" % MakeTime)\r
2045 if GenFdsTime:\r
2046 FileWrite(File, "GenFds Duration: %s" % GenFdsTime)\r
2047 FileWrite(File, "Report Content: %s" % ", ".join(ReportType))\r
2048\r
2049 if GlobalData.MixedPcd:\r
2050 FileWrite(File, gSectionStart)\r
2051 FileWrite(File, "The following PCDs use different access methods:")\r
2052 FileWrite(File, gSectionSep)\r
2053 for PcdItem in GlobalData.MixedPcd:\r
2054 FileWrite(File, "%s.%s" % (str(PcdItem[1]), str(PcdItem[0])))\r
2055 FileWrite(File, gSectionEnd)\r
2056\r
2057 if not self._IsModuleBuild:\r
2058 if "PCD" in ReportType:\r
2059 self.PcdReport.GenerateReport(File, None)\r
2060 \r
2061 if "FLASH" in ReportType:\r
2062 for FdReportListItem in self.FdReportList:\r
2063 FdReportListItem.GenerateReport(File)\r
2064\r
2065 for ModuleReportItem in self.ModuleReportList:\r
2066 ModuleReportItem.GenerateReport(File, self.PcdReport, self.PredictionReport, self.DepexParser, ReportType)\r
2067\r
2068 if not self._IsModuleBuild:\r
2069 if "EXECUTION_ORDER" in ReportType:\r
2070 self.PredictionReport.GenerateReport(File, None)\r
2071\r
2072## BuildReport class\r
2073#\r
2074# This base class contain the routines to collect data and then\r
2075# applies certain format to the output report\r
2076#\r
2077class BuildReport(object):\r
2078 ##\r
2079 # Constructor function for class BuildReport\r
2080 #\r
2081 # This constructor function generates BuildReport object a platform build.\r
2082 # It generates report for platform summary, flash, global PCDs and detailed\r
2083 # module information for modules involved in platform build.\r
2084 #\r
2085 # @param self The object pointer\r
2086 # @param ReportFile The file name to save report file\r
2087 # @param ReportType The kind of report items in the final report file\r
2088 #\r
2089 def __init__(self, ReportFile, ReportType):\r
2090 self.ReportFile = ReportFile\r
2091 if ReportFile:\r
2092 self.ReportList = []\r
2093 self.ReportType = []\r
2094 if ReportType: \r
2095 for ReportTypeItem in ReportType:\r
2096 if ReportTypeItem not in self.ReportType:\r
2097 self.ReportType.append(ReportTypeItem)\r
2098 else:\r
2099 self.ReportType = ["PCD", "LIBRARY", "BUILD_FLAGS", "DEPEX", "HASH", "FLASH", "FIXED_ADDRESS"]\r
2100 ##\r
2101 # Adds platform report to the list\r
2102 #\r
2103 # This function adds a platform report to the final report list.\r
2104 #\r
2105 # @param self The object pointer\r
2106 # @param Wa Workspace context information\r
2107 # @param MaList The list of modules in the platform build\r
2108 #\r
2109 def AddPlatformReport(self, Wa, MaList=None):\r
2110 if self.ReportFile:\r
2111 self.ReportList.append((Wa, MaList))\r
2112\r
2113 ##\r
2114 # Generates the final report.\r
2115 #\r
2116 # This function generates platform build report. It invokes GenerateReport()\r
2117 # method for every platform report in the list.\r
2118 #\r
2119 # @param self The object pointer\r
2120 # @param BuildDuration The total time to build the modules\r
2121 # @param AutoGenTime The total time of AutoGen phase\r
2122 # @param MakeTime The total time of Make phase\r
2123 # @param GenFdsTime The total time of GenFds phase\r
2124 #\r
2125 def GenerateReport(self, BuildDuration, AutoGenTime, MakeTime, GenFdsTime):\r
2126 if self.ReportFile:\r
2127 try:\r
2128 File = StringIO('')\r
2129 for (Wa, MaList) in self.ReportList:\r
2130 PlatformReport(Wa, MaList, self.ReportType).GenerateReport(File, BuildDuration, AutoGenTime, MakeTime, GenFdsTime, self.ReportType)\r
2131 Content = FileLinesSplit(File.getvalue(), gLineMaxLength)\r
2132 SaveFileOnChange(self.ReportFile, Content, True)\r
2133 EdkLogger.quiet("Build report can be found at %s" % os.path.abspath(self.ReportFile))\r
2134 except IOError:\r
2135 EdkLogger.error(None, FILE_WRITE_FAILURE, ExtraData=self.ReportFile)\r
2136 except:\r
2137 EdkLogger.error("BuildReport", CODE_ERROR, "Unknown fatal error when generating build report", ExtraData=self.ReportFile, RaiseError=False)\r
2138 EdkLogger.quiet("(Python %s on %s\n%s)" % (platform.python_version(), sys.platform, traceback.format_exc()))\r
2139 File.close()\r
2140 \r
2141# This acts like the main() function for the script, unless it is 'import'ed into another script.\r
2142if __name__ == '__main__':\r
2143 pass\r
2144\r