]> git.proxmox.com Git - mirror_edk2.git/blame_incremental - BaseTools/Source/Python/GenFds/FdfParser.py
New EdkShell binaries.
[mirror_edk2.git] / BaseTools / Source / Python / GenFds / FdfParser.py
... / ...
CommitLineData
1## @file\r
2# parse FDF file\r
3#\r
4# Copyright (c) 2007 - 2013, Intel Corporation. All rights reserved.<BR>\r
5#\r
6# This program and the accompanying materials\r
7# are licensed and made available under the terms and conditions of the BSD License\r
8# which accompanies this distribution. The full text of the license may be found at\r
9# http://opensource.org/licenses/bsd-license.php\r
10#\r
11# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13#\r
14\r
15##\r
16# Import Modules\r
17#\r
18import re\r
19\r
20import Fd\r
21import Region\r
22import Fv\r
23import AprioriSection\r
24import FfsInfStatement\r
25import FfsFileStatement\r
26import VerSection\r
27import UiSection\r
28import FvImageSection\r
29import DataSection\r
30import DepexSection\r
31import CompressSection\r
32import GuidSection\r
33import Capsule\r
34import CapsuleData\r
35import Rule\r
36import RuleComplexFile\r
37import RuleSimpleFile\r
38import EfiSection\r
39import Vtf\r
40import ComponentStatement\r
41import OptionRom\r
42import OptRomInfStatement\r
43import OptRomFileStatement\r
44\r
45from GenFdsGlobalVariable import GenFdsGlobalVariable\r
46from Common.BuildToolError import *\r
47from Common import EdkLogger\r
48from Common.Misc import PathClass\r
49from Common.String import NormPath\r
50import Common.GlobalData as GlobalData\r
51from Common.Expression import *\r
52from Common import GlobalData\r
53from Common.String import ReplaceMacro\r
54\r
55from Common.Misc import tdict\r
56\r
57import re\r
58import os\r
59\r
60##define T_CHAR_SPACE ' '\r
61##define T_CHAR_NULL '\0'\r
62##define T_CHAR_CR '\r'\r
63##define T_CHAR_TAB '\t'\r
64##define T_CHAR_LF '\n'\r
65##define T_CHAR_SLASH '/'\r
66##define T_CHAR_BACKSLASH '\\'\r
67##define T_CHAR_DOUBLE_QUOTE '\"'\r
68##define T_CHAR_SINGLE_QUOTE '\''\r
69##define T_CHAR_STAR '*'\r
70##define T_CHAR_HASH '#'\r
71\r
72(T_CHAR_SPACE, T_CHAR_NULL, T_CHAR_CR, T_CHAR_TAB, T_CHAR_LF, T_CHAR_SLASH, \\r
73T_CHAR_BACKSLASH, T_CHAR_DOUBLE_QUOTE, T_CHAR_SINGLE_QUOTE, T_CHAR_STAR, T_CHAR_HASH) = \\r
74(' ', '\0', '\r', '\t', '\n', '/', '\\', '\"', '\'', '*', '#')\r
75\r
76SEPERATOR_TUPLE = ('=', '|', ',', '{', '}')\r
77\r
78RegionSizePattern = re.compile("\s*(?P<base>(?:0x|0X)?[a-fA-F0-9]+)\s*\|\s*(?P<size>(?:0x|0X)?[a-fA-F0-9]+)\s*")\r
79RegionSizeGuidPattern = re.compile("\s*(?P<base>\w+\.\w+)\s*\|\s*(?P<size>\w+\.\w+)\s*")\r
80ShortcutPcdPattern = re.compile("\s*\w+\s*=\s*(?P<value>(?:0x|0X)?[a-fA-F0-9]+)\s*\|\s*(?P<name>\w+\.\w+)\s*")\r
81\r
82IncludeFileList = []\r
83\r
84def GetRealFileLine (File, Line):\r
85\r
86 InsertedLines = 0\r
87 for Profile in IncludeFileList:\r
88 if Line >= Profile.InsertStartLineNumber and Line < Profile.InsertStartLineNumber + Profile.InsertAdjust + len(Profile.FileLinesList):\r
89 return (Profile.FileName, Line - Profile.InsertStartLineNumber + 1)\r
90 if Line >= Profile.InsertStartLineNumber + Profile.InsertAdjust + len(Profile.FileLinesList):\r
91 InsertedLines += Profile.InsertAdjust + len(Profile.FileLinesList)\r
92\r
93 return (File, Line - InsertedLines)\r
94\r
95## The exception class that used to report error messages when parsing FDF\r
96#\r
97# Currently the "ToolName" is set to be "FDF Parser".\r
98#\r
99class Warning (Exception):\r
100 ## The constructor\r
101 #\r
102 # @param self The object pointer\r
103 # @param Str The message to record\r
104 # @param File The FDF name\r
105 # @param Line The Line number that error occurs\r
106 #\r
107 def __init__(self, Str, File = None, Line = None):\r
108\r
109 FileLineTuple = GetRealFileLine(File, Line)\r
110 self.FileName = FileLineTuple[0]\r
111 self.LineNumber = FileLineTuple[1]\r
112 self.Message = Str\r
113 self.ToolName = 'FdfParser'\r
114\r
115 def __str__(self):\r
116 return self.Message\r
117\r
118## The MACRO class that used to record macro value data when parsing include file\r
119#\r
120#\r
121class MacroProfile :\r
122 ## The constructor\r
123 #\r
124 # @param self The object pointer\r
125 # @param FileName The file that to be parsed\r
126 #\r
127 def __init__(self, FileName, Line):\r
128 self.FileName = FileName\r
129 self.DefinedAtLine = Line\r
130 self.MacroName = None\r
131 self.MacroValue = None\r
132\r
133## The Include file content class that used to record file data when parsing include file\r
134#\r
135# May raise Exception when opening file.\r
136#\r
137class IncludeFileProfile :\r
138 ## The constructor\r
139 #\r
140 # @param self The object pointer\r
141 # @param FileName The file that to be parsed\r
142 #\r
143 def __init__(self, FileName):\r
144 self.FileName = FileName\r
145 self.FileLinesList = []\r
146 try:\r
147 fsock = open(FileName, "rb", 0)\r
148 try:\r
149 self.FileLinesList = fsock.readlines()\r
150 finally:\r
151 fsock.close()\r
152\r
153 except:\r
154 EdkLogger.error("FdfParser", FILE_OPEN_FAILURE, ExtraData=FileName)\r
155\r
156 self.InsertStartLineNumber = None\r
157 self.InsertAdjust = 0\r
158\r
159## The FDF content class that used to record file data when parsing FDF\r
160#\r
161# May raise Exception when opening file.\r
162#\r
163class FileProfile :\r
164 ## The constructor\r
165 #\r
166 # @param self The object pointer\r
167 # @param FileName The file that to be parsed\r
168 #\r
169 def __init__(self, FileName):\r
170 self.FileLinesList = []\r
171 try:\r
172 fsock = open(FileName, "rb", 0)\r
173 try:\r
174 self.FileLinesList = fsock.readlines()\r
175 finally:\r
176 fsock.close()\r
177\r
178 except:\r
179 EdkLogger.error("FdfParser", FILE_OPEN_FAILURE, ExtraData=FileName)\r
180\r
181\r
182 self.PcdDict = {}\r
183 self.InfList = []\r
184 # ECC will use this Dict and List information\r
185 self.PcdFileLineDict = {}\r
186 self.InfFileLineList = []\r
187 \r
188 self.FdDict = {}\r
189 self.FdNameNotSet = False\r
190 self.FvDict = {}\r
191 self.CapsuleDict = {}\r
192 self.VtfList = []\r
193 self.RuleDict = {}\r
194 self.OptRomDict = {}\r
195\r
196## The syntax parser for FDF\r
197#\r
198# PreprocessFile method should be called prior to ParseFile\r
199# CycleReferenceCheck method can detect cycles in FDF contents\r
200#\r
201# GetNext*** procedures mean these procedures will get next token first, then make judgement.\r
202# Get*** procedures mean these procedures will make judgement on current token only.\r
203#\r
204class FdfParser:\r
205 ## The constructor\r
206 #\r
207 # @param self The object pointer\r
208 # @param FileName The file that to be parsed\r
209 #\r
210 def __init__(self, FileName):\r
211 self.Profile = FileProfile(FileName)\r
212 self.FileName = FileName\r
213 self.CurrentLineNumber = 1\r
214 self.CurrentOffsetWithinLine = 0\r
215 self.CurrentFdName = None\r
216 self.CurrentFvName = None\r
217 self.__Token = ""\r
218 self.__SkippedChars = ""\r
219\r
220 # Used to section info\r
221 self.__CurSection = []\r
222 # Key: [section name, UI name, arch]\r
223 # Value: {MACRO_NAME : MACRO_VALUE}\r
224 self.__MacroDict = tdict(True, 3)\r
225 self.__PcdDict = {}\r
226\r
227 self.__WipeOffArea = []\r
228 if GenFdsGlobalVariable.WorkSpaceDir == '':\r
229 GenFdsGlobalVariable.WorkSpaceDir = os.getenv("WORKSPACE")\r
230\r
231 ## __IsWhiteSpace() method\r
232 #\r
233 # Whether char at current FileBufferPos is whitespace\r
234 #\r
235 # @param self The object pointer\r
236 # @param Char The char to test\r
237 # @retval True The char is a kind of white space\r
238 # @retval False The char is NOT a kind of white space\r
239 #\r
240 def __IsWhiteSpace(self, Char):\r
241 if Char in (T_CHAR_NULL, T_CHAR_CR, T_CHAR_SPACE, T_CHAR_TAB, T_CHAR_LF):\r
242 return True\r
243 else:\r
244 return False\r
245\r
246 ## __SkipWhiteSpace() method\r
247 #\r
248 # Skip white spaces from current char, return number of chars skipped\r
249 #\r
250 # @param self The object pointer\r
251 # @retval Count The number of chars skipped\r
252 #\r
253 def __SkipWhiteSpace(self):\r
254 Count = 0\r
255 while not self.__EndOfFile():\r
256 Count += 1\r
257 if self.__CurrentChar() in (T_CHAR_NULL, T_CHAR_CR, T_CHAR_LF, T_CHAR_SPACE, T_CHAR_TAB):\r
258 self.__SkippedChars += str(self.__CurrentChar())\r
259 self.__GetOneChar()\r
260\r
261 else:\r
262 Count = Count - 1\r
263 return Count\r
264\r
265 ## __EndOfFile() method\r
266 #\r
267 # Judge current buffer pos is at file end\r
268 #\r
269 # @param self The object pointer\r
270 # @retval True Current File buffer position is at file end\r
271 # @retval False Current File buffer position is NOT at file end\r
272 #\r
273 def __EndOfFile(self):\r
274 NumberOfLines = len(self.Profile.FileLinesList)\r
275 SizeOfLastLine = len(self.Profile.FileLinesList[-1])\r
276 if self.CurrentLineNumber == NumberOfLines and self.CurrentOffsetWithinLine >= SizeOfLastLine - 1:\r
277 return True\r
278 elif self.CurrentLineNumber > NumberOfLines:\r
279 return True\r
280 else:\r
281 return False\r
282\r
283 ## __EndOfLine() method\r
284 #\r
285 # Judge current buffer pos is at line end\r
286 #\r
287 # @param self The object pointer\r
288 # @retval True Current File buffer position is at line end\r
289 # @retval False Current File buffer position is NOT at line end\r
290 #\r
291 def __EndOfLine(self):\r
292 if self.CurrentLineNumber > len(self.Profile.FileLinesList):\r
293 return True\r
294 SizeOfCurrentLine = len(self.Profile.FileLinesList[self.CurrentLineNumber - 1])\r
295 if self.CurrentOffsetWithinLine >= SizeOfCurrentLine:\r
296 return True\r
297 else:\r
298 return False\r
299\r
300 ## Rewind() method\r
301 #\r
302 # Reset file data buffer to the initial state\r
303 #\r
304 # @param self The object pointer\r
305 #\r
306 def Rewind(self):\r
307 self.CurrentLineNumber = 1\r
308 self.CurrentOffsetWithinLine = 0\r
309\r
310 ## __UndoOneChar() method\r
311 #\r
312 # Go back one char in the file buffer\r
313 #\r
314 # @param self The object pointer\r
315 # @retval True Successfully go back one char\r
316 # @retval False Not able to go back one char as file beginning reached\r
317 #\r
318 def __UndoOneChar(self):\r
319\r
320 if self.CurrentLineNumber == 1 and self.CurrentOffsetWithinLine == 0:\r
321 return False\r
322 elif self.CurrentOffsetWithinLine == 0:\r
323 self.CurrentLineNumber -= 1\r
324 self.CurrentOffsetWithinLine = len(self.__CurrentLine()) - 1\r
325 else:\r
326 self.CurrentOffsetWithinLine -= 1\r
327 return True\r
328\r
329 ## __GetOneChar() method\r
330 #\r
331 # Move forward one char in the file buffer\r
332 #\r
333 # @param self The object pointer\r
334 #\r
335 def __GetOneChar(self):\r
336 if self.CurrentOffsetWithinLine == len(self.Profile.FileLinesList[self.CurrentLineNumber - 1]) - 1:\r
337 self.CurrentLineNumber += 1\r
338 self.CurrentOffsetWithinLine = 0\r
339 else:\r
340 self.CurrentOffsetWithinLine += 1\r
341\r
342 ## __CurrentChar() method\r
343 #\r
344 # Get the char pointed to by the file buffer pointer\r
345 #\r
346 # @param self The object pointer\r
347 # @retval Char Current char\r
348 #\r
349 def __CurrentChar(self):\r
350 return self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine]\r
351\r
352 ## __NextChar() method\r
353 #\r
354 # Get the one char pass the char pointed to by the file buffer pointer\r
355 #\r
356 # @param self The object pointer\r
357 # @retval Char Next char\r
358 #\r
359 def __NextChar(self):\r
360 if self.CurrentOffsetWithinLine == len(self.Profile.FileLinesList[self.CurrentLineNumber - 1]) - 1:\r
361 return self.Profile.FileLinesList[self.CurrentLineNumber][0]\r
362 else:\r
363 return self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine + 1]\r
364\r
365 ## __SetCurrentCharValue() method\r
366 #\r
367 # Modify the value of current char\r
368 #\r
369 # @param self The object pointer\r
370 # @param Value The new value of current char\r
371 #\r
372 def __SetCurrentCharValue(self, Value):\r
373 self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine] = Value\r
374\r
375 ## __CurrentLine() method\r
376 #\r
377 # Get the list that contains current line contents\r
378 #\r
379 # @param self The object pointer\r
380 # @retval List current line contents\r
381 #\r
382 def __CurrentLine(self):\r
383 return self.Profile.FileLinesList[self.CurrentLineNumber - 1]\r
384\r
385 def __StringToList(self):\r
386 self.Profile.FileLinesList = [list(s) for s in self.Profile.FileLinesList]\r
387 self.Profile.FileLinesList[-1].append(' ')\r
388\r
389 def __ReplaceFragment(self, StartPos, EndPos, Value = ' '):\r
390 if StartPos[0] == EndPos[0]:\r
391 Offset = StartPos[1]\r
392 while Offset <= EndPos[1]:\r
393 self.Profile.FileLinesList[StartPos[0]][Offset] = Value\r
394 Offset += 1\r
395 return\r
396\r
397 Offset = StartPos[1]\r
398 while self.Profile.FileLinesList[StartPos[0]][Offset] not in ('\r', '\n'):\r
399 self.Profile.FileLinesList[StartPos[0]][Offset] = Value\r
400 Offset += 1\r
401\r
402 Line = StartPos[0]\r
403 while Line < EndPos[0]:\r
404 Offset = 0\r
405 while self.Profile.FileLinesList[Line][Offset] not in ('\r', '\n'):\r
406 self.Profile.FileLinesList[Line][Offset] = Value\r
407 Offset += 1\r
408 Line += 1\r
409\r
410 Offset = 0\r
411 while Offset <= EndPos[1]:\r
412 self.Profile.FileLinesList[EndPos[0]][Offset] = Value\r
413 Offset += 1\r
414\r
415\r
416 def __GetMacroName(self):\r
417 if not self.__GetNextToken():\r
418 raise Warning("expected Macro name", self.FileName, self.CurrentLineNumber)\r
419 MacroName = self.__Token\r
420 NotFlag = False\r
421 if MacroName.startswith('!'):\r
422 NotFlag = True\r
423 MacroName = MacroName[1:].strip()\r
424 \r
425 if not MacroName.startswith('$(') or not MacroName.endswith(')'):\r
426 raise Warning("Macro name expected(Please use '$(%(Token)s)' if '%(Token)s' is a macro.)" % {"Token" : MacroName},\r
427 self.FileName, self.CurrentLineNumber)\r
428 MacroName = MacroName[2:-1]\r
429 return MacroName, NotFlag\r
430\r
431 def __SetMacroValue(self, Macro, Value):\r
432 if not self.__CurSection:\r
433 return\r
434\r
435 MacroDict = {}\r
436 if not self.__MacroDict[self.__CurSection[0], self.__CurSection[1], self.__CurSection[2]]:\r
437 self.__MacroDict[self.__CurSection[0], self.__CurSection[1], self.__CurSection[2]] = MacroDict\r
438 else:\r
439 MacroDict = self.__MacroDict[self.__CurSection[0], self.__CurSection[1], self.__CurSection[2]]\r
440 MacroDict[Macro] = Value\r
441\r
442 def __GetMacroValue(self, Macro):\r
443 # Highest priority\r
444 if Macro in GlobalData.gCommandLineDefines:\r
445 return GlobalData.gCommandLineDefines[Macro]\r
446 if Macro in GlobalData.gGlobalDefines:\r
447 return GlobalData.gGlobalDefines[Macro]\r
448\r
449 if self.__CurSection:\r
450 MacroDict = self.__MacroDict[\r
451 self.__CurSection[0],\r
452 self.__CurSection[1],\r
453 self.__CurSection[2]\r
454 ]\r
455 if MacroDict and Macro in MacroDict:\r
456 return MacroDict[Macro]\r
457\r
458 # Lowest priority\r
459 if Macro in GlobalData.gPlatformDefines:\r
460 return GlobalData.gPlatformDefines[Macro]\r
461 return None\r
462\r
463 def __SectionHeaderParser(self, Section):\r
464 # [Defines]\r
465 # [FD.UiName]: use dummy instead if UI name is optional\r
466 # [FV.UiName]\r
467 # [Capsule.UiName]\r
468 # [Rule]: don't take rule section into account, macro is not allowed in this section\r
469 # [VTF.arch.UiName, arch]\r
470 # [OptionRom.DriverName]\r
471 self.__CurSection = []\r
472 Section = Section.strip()[1:-1].upper().replace(' ', '').strip('.')\r
473 ItemList = Section.split('.')\r
474 Item = ItemList[0]\r
475 if Item == '' or Item == 'RULE':\r
476 return\r
477\r
478 if Item == 'DEFINES':\r
479 self.__CurSection = ['COMMON', 'COMMON', 'COMMON']\r
480 elif Item == 'VTF' and len(ItemList) == 3:\r
481 UiName = ItemList[2]\r
482 Pos = UiName.find(',')\r
483 if Pos != -1:\r
484 UiName = UiName[:Pos]\r
485 self.__CurSection = ['VTF', UiName, ItemList[1]]\r
486 elif len(ItemList) > 1:\r
487 self.__CurSection = [ItemList[0], ItemList[1], 'COMMON']\r
488 elif len(ItemList) > 0:\r
489 self.__CurSection = [ItemList[0], 'DUMMY', 'COMMON']\r
490\r
491 ## PreprocessFile() method\r
492 #\r
493 # Preprocess file contents, replace comments with spaces.\r
494 # In the end, rewind the file buffer pointer to the beginning\r
495 # BUGBUG: No !include statement processing contained in this procedure\r
496 # !include statement should be expanded at the same FileLinesList[CurrentLineNumber - 1]\r
497 #\r
498 # @param self The object pointer\r
499 #\r
500 def PreprocessFile(self):\r
501\r
502 self.Rewind()\r
503 InComment = False\r
504 DoubleSlashComment = False\r
505 HashComment = False\r
506 # HashComment in quoted string " " is ignored.\r
507 InString = False\r
508\r
509 while not self.__EndOfFile():\r
510\r
511 if self.__CurrentChar() == T_CHAR_DOUBLE_QUOTE and not InComment:\r
512 InString = not InString\r
513 # meet new line, then no longer in a comment for // and '#'\r
514 if self.__CurrentChar() == T_CHAR_LF:\r
515 self.CurrentLineNumber += 1\r
516 self.CurrentOffsetWithinLine = 0\r
517 if InComment and DoubleSlashComment:\r
518 InComment = False\r
519 DoubleSlashComment = False\r
520 if InComment and HashComment:\r
521 InComment = False\r
522 HashComment = False\r
523 # check for */ comment end\r
524 elif InComment and not DoubleSlashComment and not HashComment and self.__CurrentChar() == T_CHAR_STAR and self.__NextChar() == T_CHAR_SLASH:\r
525 self.__SetCurrentCharValue(T_CHAR_SPACE)\r
526 self.__GetOneChar()\r
527 self.__SetCurrentCharValue(T_CHAR_SPACE)\r
528 self.__GetOneChar()\r
529 InComment = False\r
530 # set comments to spaces\r
531 elif InComment:\r
532 self.__SetCurrentCharValue(T_CHAR_SPACE)\r
533 self.__GetOneChar()\r
534 # check for // comment\r
535 elif self.__CurrentChar() == T_CHAR_SLASH and self.__NextChar() == T_CHAR_SLASH and not self.__EndOfLine():\r
536 InComment = True\r
537 DoubleSlashComment = True\r
538 # check for '#' comment\r
539 elif self.__CurrentChar() == T_CHAR_HASH and not self.__EndOfLine() and not InString:\r
540 InComment = True\r
541 HashComment = True\r
542 # check for /* comment start\r
543 elif self.__CurrentChar() == T_CHAR_SLASH and self.__NextChar() == T_CHAR_STAR:\r
544 self.__SetCurrentCharValue( T_CHAR_SPACE)\r
545 self.__GetOneChar()\r
546 self.__SetCurrentCharValue( T_CHAR_SPACE)\r
547 self.__GetOneChar()\r
548 InComment = True\r
549 else:\r
550 self.__GetOneChar()\r
551\r
552 # restore from ListOfList to ListOfString\r
553 self.Profile.FileLinesList = ["".join(list) for list in self.Profile.FileLinesList]\r
554 self.Rewind()\r
555\r
556 ## PreprocessIncludeFile() method\r
557 #\r
558 # Preprocess file contents, replace !include statements with file contents.\r
559 # In the end, rewind the file buffer pointer to the beginning\r
560 #\r
561 # @param self The object pointer\r
562 #\r
563 def PreprocessIncludeFile(self):\r
564\r
565 while self.__GetNextToken():\r
566\r
567 if self.__Token == '!include':\r
568 IncludeLine = self.CurrentLineNumber\r
569 IncludeOffset = self.CurrentOffsetWithinLine - len('!include')\r
570 if not self.__GetNextToken():\r
571 raise Warning("expected include file name", self.FileName, self.CurrentLineNumber)\r
572 IncFileName = self.__Token\r
573 __IncludeMacros = {}\r
574 for Macro in ['WORKSPACE', 'ECP_SOURCE', 'EFI_SOURCE', 'EDK_SOURCE']:\r
575 MacroVal = self.__GetMacroValue(Macro)\r
576 if MacroVal:\r
577 __IncludeMacros[Macro] = MacroVal\r
578\r
579 try:\r
580 IncludedFile = NormPath(ReplaceMacro(IncFileName, __IncludeMacros, RaiseError=True))\r
581 except:\r
582 raise Warning("only these system environment variables are permitted to start the path of the included file: "\r
583 "$(WORKSPACE), $(ECP_SOURCE), $(EFI_SOURCE), $(EDK_SOURCE)",\r
584 self.FileName, self.CurrentLineNumber)\r
585 #\r
586 # First search the include file under the same directory as FDF file\r
587 #\r
588 IncludedFile1 = PathClass(IncludedFile, os.path.dirname(self.FileName))\r
589 ErrorCode = IncludedFile1.Validate()[0]\r
590 if ErrorCode != 0:\r
591 #\r
592 # Then search the include file under the same directory as DSC file\r
593 #\r
594 PlatformDir = ''\r
595 if GenFdsGlobalVariable.ActivePlatform:\r
596 PlatformDir = GenFdsGlobalVariable.ActivePlatform.Dir\r
597 elif GlobalData.gActivePlatform:\r
598 PlatformDir = GlobalData.gActivePlatform.MetaFile.Dir\r
599 IncludedFile1 = PathClass(IncludedFile, PlatformDir)\r
600 ErrorCode = IncludedFile1.Validate()[0]\r
601 if ErrorCode != 0:\r
602 #\r
603 # Also search file under the WORKSPACE directory\r
604 #\r
605 IncludedFile1 = PathClass(IncludedFile, GlobalData.gWorkspace)\r
606 ErrorCode = IncludedFile1.Validate()[0]\r
607 if ErrorCode != 0:\r
608 raise Warning("The include file does not exist under below directories: \n%s\n%s\n%s\n"%(os.path.dirname(self.FileName), PlatformDir, GlobalData.gWorkspace), \r
609 self.FileName, self.CurrentLineNumber)\r
610\r
611 IncFileProfile = IncludeFileProfile(IncludedFile1.Path)\r
612\r
613 CurrentLine = self.CurrentLineNumber\r
614 CurrentOffset = self.CurrentOffsetWithinLine\r
615 # list index of the insertion, note that line number is 'CurrentLine + 1'\r
616 InsertAtLine = CurrentLine\r
617 IncFileProfile.InsertStartLineNumber = InsertAtLine + 1\r
618 # deal with remaining portions after "!include filename", if exists.\r
619 if self.__GetNextToken():\r
620 if self.CurrentLineNumber == CurrentLine:\r
621 RemainingLine = self.__CurrentLine()[CurrentOffset:]\r
622 self.Profile.FileLinesList.insert(self.CurrentLineNumber, RemainingLine)\r
623 IncFileProfile.InsertAdjust += 1\r
624 self.CurrentLineNumber += 1\r
625 self.CurrentOffsetWithinLine = 0\r
626\r
627 for Line in IncFileProfile.FileLinesList:\r
628 self.Profile.FileLinesList.insert(InsertAtLine, Line)\r
629 self.CurrentLineNumber += 1\r
630 InsertAtLine += 1\r
631\r
632 IncludeFileList.append(IncFileProfile)\r
633\r
634 # comment out the processed include file statement\r
635 TempList = list(self.Profile.FileLinesList[IncludeLine - 1])\r
636 TempList.insert(IncludeOffset, '#')\r
637 self.Profile.FileLinesList[IncludeLine - 1] = ''.join(TempList)\r
638\r
639 self.Rewind()\r
640 \r
641 def __GetIfListCurrentItemStat(self, IfList):\r
642 if len(IfList) == 0:\r
643 return True\r
644 \r
645 for Item in IfList:\r
646 if Item[1] == False:\r
647 return False\r
648 \r
649 return True\r
650 \r
651 ## PreprocessConditionalStatement() method\r
652 #\r
653 # Preprocess conditional statement.\r
654 # In the end, rewind the file buffer pointer to the beginning\r
655 #\r
656 # @param self The object pointer\r
657 #\r
658 def PreprocessConditionalStatement(self):\r
659 # IfList is a stack of if branches with elements of list [Pos, CondSatisfied, BranchDetermined]\r
660 IfList = []\r
661 RegionLayoutLine = 0\r
662 ReplacedLine = -1\r
663 while self.__GetNextToken():\r
664 # Determine section name and the location dependent macro\r
665 if self.__GetIfListCurrentItemStat(IfList):\r
666 if self.__Token.startswith('['):\r
667 Header = self.__Token\r
668 if not self.__Token.endswith(']'):\r
669 self.__SkipToToken(']')\r
670 Header += self.__SkippedChars\r
671 if Header.find('$(') != -1:\r
672 raise Warning("macro cannot be used in section header", self.FileName, self.CurrentLineNumber)\r
673 self.__SectionHeaderParser(Header)\r
674 continue\r
675 # Replace macros except in RULE section or out of section\r
676 elif self.__CurSection and ReplacedLine != self.CurrentLineNumber:\r
677 ReplacedLine = self.CurrentLineNumber\r
678 self.__UndoToken()\r
679 CurLine = self.Profile.FileLinesList[ReplacedLine - 1]\r
680 PreIndex = 0\r
681 StartPos = CurLine.find('$(', PreIndex)\r
682 EndPos = CurLine.find(')', StartPos+2)\r
683 while StartPos != -1 and EndPos != -1 and self.__Token not in ['!ifdef', '!ifndef', '!if', '!elseif']:\r
684 MacroName = CurLine[StartPos+2 : EndPos]\r
685 MacorValue = self.__GetMacroValue(MacroName)\r
686 if MacorValue != None:\r
687 CurLine = CurLine.replace('$(' + MacroName + ')', MacorValue, 1)\r
688 if MacorValue.find('$(') != -1:\r
689 PreIndex = StartPos\r
690 else:\r
691 PreIndex = StartPos + len(MacorValue)\r
692 else:\r
693 PreIndex = EndPos + 1\r
694 StartPos = CurLine.find('$(', PreIndex)\r
695 EndPos = CurLine.find(')', StartPos+2)\r
696 self.Profile.FileLinesList[ReplacedLine - 1] = CurLine\r
697 continue\r
698\r
699 if self.__Token == 'DEFINE':\r
700 if self.__GetIfListCurrentItemStat(IfList):\r
701 if not self.__CurSection:\r
702 raise Warning("macro cannot be defined in Rule section or out of section", self.FileName, self.CurrentLineNumber)\r
703 DefineLine = self.CurrentLineNumber - 1\r
704 DefineOffset = self.CurrentOffsetWithinLine - len('DEFINE')\r
705 if not self.__GetNextToken():\r
706 raise Warning("expected Macro name", self.FileName, self.CurrentLineNumber)\r
707 Macro = self.__Token\r
708 if not self.__IsToken( "="):\r
709 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
710 \r
711 Value = self.__GetExpression()\r
712 self.__SetMacroValue(Macro, Value)\r
713 self.__WipeOffArea.append(((DefineLine, DefineOffset), (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
714 elif self.__Token == 'SET':\r
715 SetLine = self.CurrentLineNumber - 1\r
716 SetOffset = self.CurrentOffsetWithinLine - len('SET')\r
717 PcdPair = self.__GetNextPcdName()\r
718 PcdName = "%s.%s" % (PcdPair[1], PcdPair[0])\r
719 if not self.__IsToken( "="):\r
720 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
721\r
722 Value = self.__GetExpression()\r
723 Value = self.__EvaluateConditional(Value, self.CurrentLineNumber, 'eval', True)\r
724\r
725 self.__PcdDict[PcdName] = Value\r
726\r
727 self.Profile.PcdDict[PcdPair] = Value\r
728 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
729 self.Profile.PcdFileLineDict[PcdPair] = FileLineTuple\r
730\r
731 self.__WipeOffArea.append(((SetLine, SetOffset), (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
732 elif self.__Token in ('!ifdef', '!ifndef', '!if'):\r
733 IfStartPos = (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - len(self.__Token))\r
734 IfList.append([IfStartPos, None, None])\r
735\r
736 CondLabel = self.__Token\r
737 Expression = self.__GetExpression()\r
738 \r
739 if CondLabel == '!if':\r
740 ConditionSatisfied = self.__EvaluateConditional(Expression, IfList[-1][0][0] + 1, 'eval')\r
741 else:\r
742 ConditionSatisfied = self.__EvaluateConditional(Expression, IfList[-1][0][0] + 1, 'in')\r
743 if CondLabel == '!ifndef':\r
744 ConditionSatisfied = not ConditionSatisfied\r
745\r
746 BranchDetermined = ConditionSatisfied\r
747 IfList[-1] = [IfList[-1][0], ConditionSatisfied, BranchDetermined]\r
748 if ConditionSatisfied:\r
749 self.__WipeOffArea.append((IfList[-1][0], (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1))) \r
750 elif self.__Token in ('!elseif', '!else'):\r
751 ElseStartPos = (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - len(self.__Token))\r
752 if len(IfList) <= 0:\r
753 raise Warning("Missing !if statement", self.FileName, self.CurrentLineNumber)\r
754\r
755 if IfList[-1][1]:\r
756 IfList[-1] = [ElseStartPos, False, True]\r
757 self.__WipeOffArea.append((ElseStartPos, (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
758 else:\r
759 self.__WipeOffArea.append((IfList[-1][0], ElseStartPos))\r
760 IfList[-1] = [ElseStartPos, True, IfList[-1][2]]\r
761 if self.__Token == '!elseif':\r
762 Expression = self.__GetExpression()\r
763 ConditionSatisfied = self.__EvaluateConditional(Expression, IfList[-1][0][0] + 1, 'eval')\r
764 IfList[-1] = [IfList[-1][0], ConditionSatisfied, IfList[-1][2]]\r
765\r
766 if IfList[-1][1]:\r
767 if IfList[-1][2]:\r
768 IfList[-1][1] = False\r
769 else:\r
770 IfList[-1][2] = True\r
771 self.__WipeOffArea.append((IfList[-1][0], (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
772 elif self.__Token == '!endif':\r
773 if len(IfList) <= 0:\r
774 raise Warning("Missing !if statement", self.FileName, self.CurrentLineNumber)\r
775 if IfList[-1][1]:\r
776 self.__WipeOffArea.append(((self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - len('!endif')), (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
777 else:\r
778 self.__WipeOffArea.append((IfList[-1][0], (self.CurrentLineNumber - 1, self.CurrentOffsetWithinLine - 1)))\r
779\r
780 IfList.pop()\r
781 elif not IfList: # Don't use PCDs inside conditional directive\r
782 if self.CurrentLineNumber <= RegionLayoutLine:\r
783 # Don't try the same line twice\r
784 continue\r
785 SetPcd = ShortcutPcdPattern.match(self.Profile.FileLinesList[self.CurrentLineNumber - 1])\r
786 if SetPcd:\r
787 self.__PcdDict[SetPcd.group('name')] = SetPcd.group('value')\r
788 RegionLayoutLine = self.CurrentLineNumber\r
789 continue\r
790 RegionSize = RegionSizePattern.match(self.Profile.FileLinesList[self.CurrentLineNumber - 1])\r
791 if not RegionSize:\r
792 RegionLayoutLine = self.CurrentLineNumber\r
793 continue\r
794 RegionSizeGuid = RegionSizeGuidPattern.match(self.Profile.FileLinesList[self.CurrentLineNumber])\r
795 if not RegionSizeGuid:\r
796 RegionLayoutLine = self.CurrentLineNumber + 1\r
797 continue\r
798 self.__PcdDict[RegionSizeGuid.group('base')] = RegionSize.group('base')\r
799 self.__PcdDict[RegionSizeGuid.group('size')] = RegionSize.group('size')\r
800 RegionLayoutLine = self.CurrentLineNumber + 1\r
801\r
802 if IfList:\r
803 raise Warning("Missing !endif", self.FileName, self.CurrentLineNumber)\r
804 self.Rewind()\r
805\r
806 def __CollectMacroPcd(self):\r
807 MacroDict = {}\r
808\r
809 # PCD macro\r
810 MacroDict.update(GlobalData.gPlatformPcds)\r
811 MacroDict.update(self.__PcdDict)\r
812\r
813 # Lowest priority\r
814 MacroDict.update(GlobalData.gPlatformDefines)\r
815\r
816 if self.__CurSection:\r
817 # Defines macro\r
818 ScopeMacro = self.__MacroDict['COMMON', 'COMMON', 'COMMON']\r
819 if ScopeMacro:\r
820 MacroDict.update(ScopeMacro)\r
821 \r
822 # Section macro\r
823 ScopeMacro = self.__MacroDict[\r
824 self.__CurSection[0],\r
825 self.__CurSection[1],\r
826 self.__CurSection[2]\r
827 ]\r
828 if ScopeMacro:\r
829 MacroDict.update(ScopeMacro)\r
830\r
831 MacroDict.update(GlobalData.gGlobalDefines)\r
832 MacroDict.update(GlobalData.gCommandLineDefines)\r
833 # Highest priority\r
834\r
835 return MacroDict\r
836\r
837 def __EvaluateConditional(self, Expression, Line, Op = None, Value = None):\r
838 FileLineTuple = GetRealFileLine(self.FileName, Line)\r
839 MacroPcdDict = self.__CollectMacroPcd()\r
840 if Op == 'eval':\r
841 try:\r
842 if Value:\r
843 return ValueExpression(Expression, MacroPcdDict)(True)\r
844 else:\r
845 return ValueExpression(Expression, MacroPcdDict)()\r
846 except WrnExpression, Excpt:\r
847 # \r
848 # Catch expression evaluation warning here. We need to report\r
849 # the precise number of line and return the evaluation result\r
850 #\r
851 EdkLogger.warn('Parser', "Suspicious expression: %s" % str(Excpt),\r
852 File=self.FileName, ExtraData=self.__CurrentLine(), \r
853 Line=Line)\r
854 return Excpt.result\r
855 except Exception, Excpt:\r
856 if hasattr(Excpt, 'Pcd'):\r
857 if Excpt.Pcd in GlobalData.gPlatformOtherPcds:\r
858 Info = GlobalData.gPlatformOtherPcds[Excpt.Pcd]\r
859 raise Warning("Cannot use this PCD (%s) in an expression as"\r
860 " it must be defined in a [PcdsFixedAtBuild] or [PcdsFeatureFlag] section"\r
861 " of the DSC file (%s), and it is currently defined in this section:"\r
862 " %s, line #: %d." % (Excpt.Pcd, GlobalData.gPlatformOtherPcds['DSCFILE'], Info[0], Info[1]),\r
863 *FileLineTuple)\r
864 else:\r
865 raise Warning("PCD (%s) is not defined in DSC file (%s)" % (Excpt.Pcd, GlobalData.gPlatformOtherPcds['DSCFILE']),\r
866 *FileLineTuple)\r
867 else:\r
868 raise Warning(str(Excpt), *FileLineTuple)\r
869 else:\r
870 if Expression.startswith('$(') and Expression[-1] == ')':\r
871 Expression = Expression[2:-1] \r
872 return Expression in MacroPcdDict\r
873\r
874 ## __IsToken() method\r
875 #\r
876 # Check whether input string is found from current char position along\r
877 # If found, the string value is put into self.__Token\r
878 #\r
879 # @param self The object pointer\r
880 # @param String The string to search\r
881 # @param IgnoreCase Indicate case sensitive/non-sensitive search, default is case sensitive\r
882 # @retval True Successfully find string, file buffer pointer moved forward\r
883 # @retval False Not able to find string, file buffer pointer not changed\r
884 #\r
885 def __IsToken(self, String, IgnoreCase = False):\r
886 self.__SkipWhiteSpace()\r
887\r
888 # Only consider the same line, no multi-line token allowed\r
889 StartPos = self.CurrentOffsetWithinLine\r
890 index = -1\r
891 if IgnoreCase:\r
892 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].upper().find(String.upper())\r
893 else:\r
894 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].find(String)\r
895 if index == 0:\r
896 self.CurrentOffsetWithinLine += len(String)\r
897 self.__Token = self.__CurrentLine()[StartPos : self.CurrentOffsetWithinLine]\r
898 return True\r
899 return False\r
900\r
901 ## __IsKeyword() method\r
902 #\r
903 # Check whether input keyword is found from current char position along, whole word only!\r
904 # If found, the string value is put into self.__Token\r
905 #\r
906 # @param self The object pointer\r
907 # @param Keyword The string to search\r
908 # @param IgnoreCase Indicate case sensitive/non-sensitive search, default is case sensitive\r
909 # @retval True Successfully find string, file buffer pointer moved forward\r
910 # @retval False Not able to find string, file buffer pointer not changed\r
911 #\r
912 def __IsKeyword(self, KeyWord, IgnoreCase = False):\r
913 self.__SkipWhiteSpace()\r
914\r
915 # Only consider the same line, no multi-line token allowed\r
916 StartPos = self.CurrentOffsetWithinLine\r
917 index = -1\r
918 if IgnoreCase:\r
919 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].upper().find(KeyWord.upper())\r
920 else:\r
921 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].find(KeyWord)\r
922 if index == 0:\r
923 followingChar = self.__CurrentLine()[self.CurrentOffsetWithinLine + len(KeyWord)]\r
924 if not str(followingChar).isspace() and followingChar not in SEPERATOR_TUPLE:\r
925 return False\r
926 self.CurrentOffsetWithinLine += len(KeyWord)\r
927 self.__Token = self.__CurrentLine()[StartPos : self.CurrentOffsetWithinLine]\r
928 return True\r
929 return False\r
930\r
931 def __GetExpression(self):\r
932 Line = self.Profile.FileLinesList[self.CurrentLineNumber - 1]\r
933 Index = len(Line) - 1\r
934 while Line[Index] in ['\r', '\n']:\r
935 Index -= 1\r
936 ExpressionString = self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine:Index+1]\r
937 self.CurrentOffsetWithinLine += len(ExpressionString)\r
938 ExpressionString = ExpressionString.strip()\r
939 return ExpressionString\r
940\r
941 ## __GetNextWord() method\r
942 #\r
943 # Get next C name from file lines\r
944 # If found, the string value is put into self.__Token\r
945 #\r
946 # @param self The object pointer\r
947 # @retval True Successfully find a C name string, file buffer pointer moved forward\r
948 # @retval False Not able to find a C name string, file buffer pointer not changed\r
949 #\r
950 def __GetNextWord(self):\r
951 self.__SkipWhiteSpace()\r
952 if self.__EndOfFile():\r
953 return False\r
954\r
955 TempChar = self.__CurrentChar()\r
956 StartPos = self.CurrentOffsetWithinLine\r
957 if (TempChar >= 'a' and TempChar <= 'z') or (TempChar >= 'A' and TempChar <= 'Z') or TempChar == '_':\r
958 self.__GetOneChar()\r
959 while not self.__EndOfLine():\r
960 TempChar = self.__CurrentChar()\r
961 if (TempChar >= 'a' and TempChar <= 'z') or (TempChar >= 'A' and TempChar <= 'Z') \\r
962 or (TempChar >= '0' and TempChar <= '9') or TempChar == '_' or TempChar == '-':\r
963 self.__GetOneChar()\r
964\r
965 else:\r
966 break\r
967\r
968 self.__Token = self.__CurrentLine()[StartPos : self.CurrentOffsetWithinLine]\r
969 return True\r
970\r
971 return False\r
972\r
973 ## __GetNextToken() method\r
974 #\r
975 # Get next token unit before a seperator\r
976 # If found, the string value is put into self.__Token\r
977 #\r
978 # @param self The object pointer\r
979 # @retval True Successfully find a token unit, file buffer pointer moved forward\r
980 # @retval False Not able to find a token unit, file buffer pointer not changed\r
981 #\r
982 def __GetNextToken(self):\r
983 # Skip leading spaces, if exist.\r
984 self.__SkipWhiteSpace()\r
985 if self.__EndOfFile():\r
986 return False\r
987 # Record the token start position, the position of the first non-space char.\r
988 StartPos = self.CurrentOffsetWithinLine\r
989 StartLine = self.CurrentLineNumber\r
990 while StartLine == self.CurrentLineNumber:\r
991 TempChar = self.__CurrentChar()\r
992 # Try to find the end char that is not a space and not in seperator tuple.\r
993 # That is, when we got a space or any char in the tuple, we got the end of token.\r
994 if not str(TempChar).isspace() and TempChar not in SEPERATOR_TUPLE:\r
995 self.__GetOneChar()\r
996 # if we happen to meet a seperator as the first char, we must proceed to get it.\r
997 # That is, we get a token that is a seperator char. nomally it is the boundary of other tokens.\r
998 elif StartPos == self.CurrentOffsetWithinLine and TempChar in SEPERATOR_TUPLE:\r
999 self.__GetOneChar()\r
1000 break\r
1001 else:\r
1002 break\r
1003# else:\r
1004# return False\r
1005\r
1006 EndPos = self.CurrentOffsetWithinLine\r
1007 if self.CurrentLineNumber != StartLine:\r
1008 EndPos = len(self.Profile.FileLinesList[StartLine-1])\r
1009 self.__Token = self.Profile.FileLinesList[StartLine-1][StartPos : EndPos]\r
1010 if StartPos != self.CurrentOffsetWithinLine:\r
1011 return True\r
1012 else:\r
1013 return False\r
1014\r
1015 def __GetNextOp(self):\r
1016 # Skip leading spaces, if exist.\r
1017 self.__SkipWhiteSpace()\r
1018 if self.__EndOfFile():\r
1019 return False\r
1020 # Record the token start position, the position of the first non-space char.\r
1021 StartPos = self.CurrentOffsetWithinLine\r
1022 while not self.__EndOfLine():\r
1023 TempChar = self.__CurrentChar()\r
1024 # Try to find the end char that is not a space\r
1025 if not str(TempChar).isspace():\r
1026 self.__GetOneChar()\r
1027 else:\r
1028 break\r
1029 else:\r
1030 return False\r
1031\r
1032 if StartPos != self.CurrentOffsetWithinLine:\r
1033 self.__Token = self.__CurrentLine()[StartPos : self.CurrentOffsetWithinLine]\r
1034 return True\r
1035 else:\r
1036 return False\r
1037 ## __GetNextGuid() method\r
1038 #\r
1039 # Get next token unit before a seperator\r
1040 # If found, the GUID string is put into self.__Token\r
1041 #\r
1042 # @param self The object pointer\r
1043 # @retval True Successfully find a registry format GUID, file buffer pointer moved forward\r
1044 # @retval False Not able to find a registry format GUID, file buffer pointer not changed\r
1045 #\r
1046 def __GetNextGuid(self):\r
1047\r
1048 if not self.__GetNextToken():\r
1049 return False\r
1050 p = re.compile('[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}')\r
1051 if p.match(self.__Token) != None:\r
1052 return True\r
1053 else:\r
1054 self.__UndoToken()\r
1055 return False\r
1056\r
1057 ## __UndoToken() method\r
1058 #\r
1059 # Go back one token unit in file buffer\r
1060 #\r
1061 # @param self The object pointer\r
1062 #\r
1063 def __UndoToken(self):\r
1064 self.__UndoOneChar()\r
1065 while self.__CurrentChar().isspace():\r
1066 if not self.__UndoOneChar():\r
1067 self.__GetOneChar()\r
1068 return\r
1069\r
1070\r
1071 StartPos = self.CurrentOffsetWithinLine\r
1072 CurrentLine = self.CurrentLineNumber\r
1073 while CurrentLine == self.CurrentLineNumber:\r
1074\r
1075 TempChar = self.__CurrentChar()\r
1076 # Try to find the end char that is not a space and not in seperator tuple.\r
1077 # That is, when we got a space or any char in the tuple, we got the end of token.\r
1078 if not str(TempChar).isspace() and not TempChar in SEPERATOR_TUPLE:\r
1079 if not self.__UndoOneChar():\r
1080 return\r
1081 # if we happen to meet a seperator as the first char, we must proceed to get it.\r
1082 # That is, we get a token that is a seperator char. nomally it is the boundary of other tokens.\r
1083 elif StartPos == self.CurrentOffsetWithinLine and TempChar in SEPERATOR_TUPLE:\r
1084 return\r
1085 else:\r
1086 break\r
1087\r
1088 self.__GetOneChar()\r
1089\r
1090 ## __HexDigit() method\r
1091 #\r
1092 # Whether char input is a Hex data bit\r
1093 #\r
1094 # @param self The object pointer\r
1095 # @param TempChar The char to test\r
1096 # @retval True The char is a Hex data bit\r
1097 # @retval False The char is NOT a Hex data bit\r
1098 #\r
1099 def __HexDigit(self, TempChar):\r
1100 if (TempChar >= 'a' and TempChar <= 'f') or (TempChar >= 'A' and TempChar <= 'F') \\r
1101 or (TempChar >= '0' and TempChar <= '9'):\r
1102 return True\r
1103 else:\r
1104 return False\r
1105\r
1106 def __IsHex(self, HexStr):\r
1107 if not HexStr.upper().startswith("0X"):\r
1108 return False\r
1109 if len(self.__Token) <= 2:\r
1110 return False\r
1111 charList = [c for c in HexStr[2 : ] if not self.__HexDigit( c)]\r
1112 if len(charList) == 0:\r
1113 return True\r
1114 else:\r
1115 return False\r
1116 ## __GetNextHexNumber() method\r
1117 #\r
1118 # Get next HEX data before a seperator\r
1119 # If found, the HEX data is put into self.__Token\r
1120 #\r
1121 # @param self The object pointer\r
1122 # @retval True Successfully find a HEX data, file buffer pointer moved forward\r
1123 # @retval False Not able to find a HEX data, file buffer pointer not changed\r
1124 #\r
1125 def __GetNextHexNumber(self):\r
1126 if not self.__GetNextToken():\r
1127 return False\r
1128 if self.__IsHex(self.__Token):\r
1129 return True\r
1130 else:\r
1131 self.__UndoToken()\r
1132 return False\r
1133\r
1134 ## __GetNextDecimalNumber() method\r
1135 #\r
1136 # Get next decimal data before a seperator\r
1137 # If found, the decimal data is put into self.__Token\r
1138 #\r
1139 # @param self The object pointer\r
1140 # @retval True Successfully find a decimal data, file buffer pointer moved forward\r
1141 # @retval False Not able to find a decimal data, file buffer pointer not changed\r
1142 #\r
1143 def __GetNextDecimalNumber(self):\r
1144 if not self.__GetNextToken():\r
1145 return False\r
1146 if self.__Token.isdigit():\r
1147 return True\r
1148 else:\r
1149 self.__UndoToken()\r
1150 return False\r
1151\r
1152 ## __GetNextPcdName() method\r
1153 #\r
1154 # Get next PCD token space C name and PCD C name pair before a seperator\r
1155 # If found, the decimal data is put into self.__Token\r
1156 #\r
1157 # @param self The object pointer\r
1158 # @retval Tuple PCD C name and PCD token space C name pair\r
1159 #\r
1160 def __GetNextPcdName(self):\r
1161 if not self.__GetNextWord():\r
1162 raise Warning("expected format of <PcdTokenSpaceCName>.<PcdCName>", self.FileName, self.CurrentLineNumber)\r
1163 pcdTokenSpaceCName = self.__Token\r
1164\r
1165 if not self.__IsToken( "."):\r
1166 raise Warning("expected format of <PcdTokenSpaceCName>.<PcdCName>", self.FileName, self.CurrentLineNumber)\r
1167\r
1168 if not self.__GetNextWord():\r
1169 raise Warning("expected format of <PcdTokenSpaceCName>.<PcdCName>", self.FileName, self.CurrentLineNumber)\r
1170 pcdCName = self.__Token\r
1171\r
1172 return (pcdCName, pcdTokenSpaceCName)\r
1173\r
1174 ## __GetStringData() method\r
1175 #\r
1176 # Get string contents quoted in ""\r
1177 # If found, the decimal data is put into self.__Token\r
1178 #\r
1179 # @param self The object pointer\r
1180 # @retval True Successfully find a string data, file buffer pointer moved forward\r
1181 # @retval False Not able to find a string data, file buffer pointer not changed\r
1182 #\r
1183 def __GetStringData(self):\r
1184 if self.__Token.startswith("\"") or self.__Token.startswith("L\""):\r
1185 self.__UndoToken()\r
1186 self.__SkipToToken("\"")\r
1187 currentLineNumber = self.CurrentLineNumber\r
1188\r
1189 if not self.__SkipToToken("\""):\r
1190 raise Warning("Missing Quote \" for String", self.FileName, self.CurrentLineNumber)\r
1191 if currentLineNumber != self.CurrentLineNumber:\r
1192 raise Warning("Missing Quote \" for String", self.FileName, self.CurrentLineNumber)\r
1193 self.__Token = self.__SkippedChars.rstrip('\"')\r
1194 return True\r
1195\r
1196 elif self.__Token.startswith("\'") or self.__Token.startswith("L\'"):\r
1197 self.__UndoToken()\r
1198 self.__SkipToToken("\'")\r
1199 currentLineNumber = self.CurrentLineNumber\r
1200\r
1201 if not self.__SkipToToken("\'"):\r
1202 raise Warning("Missing Quote \' for String", self.FileName, self.CurrentLineNumber)\r
1203 if currentLineNumber != self.CurrentLineNumber:\r
1204 raise Warning("Missing Quote \' for String", self.FileName, self.CurrentLineNumber)\r
1205 self.__Token = self.__SkippedChars.rstrip('\'')\r
1206 return True\r
1207\r
1208 else:\r
1209 return False\r
1210\r
1211 ## __SkipToToken() method\r
1212 #\r
1213 # Search forward in file buffer for the string\r
1214 # The skipped chars are put into self.__SkippedChars\r
1215 #\r
1216 # @param self The object pointer\r
1217 # @param String The string to search\r
1218 # @param IgnoreCase Indicate case sensitive/non-sensitive search, default is case sensitive\r
1219 # @retval True Successfully find the string, file buffer pointer moved forward\r
1220 # @retval False Not able to find the string, file buffer pointer not changed\r
1221 #\r
1222 def __SkipToToken(self, String, IgnoreCase = False):\r
1223 StartPos = self.GetFileBufferPos()\r
1224\r
1225 self.__SkippedChars = ""\r
1226 while not self.__EndOfFile():\r
1227 index = -1\r
1228 if IgnoreCase:\r
1229 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].upper().find(String.upper())\r
1230 else:\r
1231 index = self.__CurrentLine()[self.CurrentOffsetWithinLine : ].find(String)\r
1232 if index == 0:\r
1233 self.CurrentOffsetWithinLine += len(String)\r
1234 self.__SkippedChars += String\r
1235 return True\r
1236 self.__SkippedChars += str(self.__CurrentChar())\r
1237 self.__GetOneChar()\r
1238\r
1239 self.SetFileBufferPos( StartPos)\r
1240 self.__SkippedChars = ""\r
1241 return False\r
1242\r
1243 ## GetFileBufferPos() method\r
1244 #\r
1245 # Return the tuple of current line and offset within the line\r
1246 #\r
1247 # @param self The object pointer\r
1248 # @retval Tuple Line number and offset pair\r
1249 #\r
1250 def GetFileBufferPos(self):\r
1251 return (self.CurrentLineNumber, self.CurrentOffsetWithinLine)\r
1252\r
1253 ## SetFileBufferPos() method\r
1254 #\r
1255 # Restore the file buffer position\r
1256 #\r
1257 # @param self The object pointer\r
1258 # @param Pos The new file buffer position\r
1259 #\r
1260 def SetFileBufferPos(self, Pos):\r
1261 (self.CurrentLineNumber, self.CurrentOffsetWithinLine) = Pos\r
1262\r
1263 ## Preprocess() method\r
1264 #\r
1265 # Preprocess comment, conditional directive, include directive, replace macro.\r
1266 # Exception will be raised if syntax error found\r
1267 #\r
1268 # @param self The object pointer\r
1269 #\r
1270 def Preprocess(self):\r
1271 self.__StringToList()\r
1272 self.PreprocessFile()\r
1273 self.PreprocessIncludeFile()\r
1274 self.__StringToList()\r
1275 self.PreprocessFile()\r
1276 self.PreprocessConditionalStatement()\r
1277 self.__StringToList()\r
1278 for Pos in self.__WipeOffArea:\r
1279 self.__ReplaceFragment(Pos[0], Pos[1])\r
1280 self.Profile.FileLinesList = ["".join(list) for list in self.Profile.FileLinesList]\r
1281\r
1282 while self.__GetDefines():\r
1283 pass\r
1284\r
1285 ## ParseFile() method\r
1286 #\r
1287 # Parse the file profile buffer to extract fd, fv ... information\r
1288 # Exception will be raised if syntax error found\r
1289 #\r
1290 # @param self The object pointer\r
1291 #\r
1292 def ParseFile(self):\r
1293\r
1294 try:\r
1295 self.Preprocess()\r
1296 while self.__GetFd():\r
1297 pass\r
1298\r
1299 while self.__GetFv():\r
1300 pass\r
1301\r
1302 while self.__GetCapsule():\r
1303 pass\r
1304\r
1305 while self.__GetVtf():\r
1306 pass\r
1307\r
1308 while self.__GetRule():\r
1309 pass\r
1310 \r
1311 while self.__GetOptionRom():\r
1312 pass\r
1313\r
1314 except Warning, X:\r
1315 self.__UndoToken()\r
1316 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1317 #'\n\tGot Token: \"%s\" from File %s\n' % (self.__Token, FileLineTuple[0]) + \\r
1318 X.Message += ' near line %d, column %d: %s' \\r
1319 % (FileLineTuple[1], self.CurrentOffsetWithinLine + 1, self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :].rstrip('\n').rstrip('\r'))\r
1320 raise\r
1321\r
1322 ## __GetDefines() method\r
1323 #\r
1324 # Get Defines section contents and store its data into AllMacrosList\r
1325 #\r
1326 # @param self The object pointer\r
1327 # @retval True Successfully find a Defines\r
1328 # @retval False Not able to find a Defines\r
1329 #\r
1330 def __GetDefines(self):\r
1331\r
1332 if not self.__GetNextToken():\r
1333 return False\r
1334\r
1335 S = self.__Token.upper()\r
1336 if S.startswith("[") and not S.startswith("[DEFINES"):\r
1337 if not S.startswith("[FD.") and not S.startswith("[FV.") and not S.startswith("[CAPSULE.") \\r
1338 and not S.startswith("[VTF.") and not S.startswith("[RULE.") and not S.startswith("[OPTIONROM."):\r
1339 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [DEFINES], [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
1340 self.__UndoToken()\r
1341 return False\r
1342\r
1343 self.__UndoToken()\r
1344 if not self.__IsToken("[DEFINES", True):\r
1345 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1346 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
1347 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
1348 raise Warning("expected [DEFINES", self.FileName, self.CurrentLineNumber)\r
1349\r
1350 if not self.__IsToken( "]"):\r
1351 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
1352\r
1353 while self.__GetNextWord():\r
1354 # handle the SET statement\r
1355 if self.__Token == 'SET':\r
1356 self.__UndoToken()\r
1357 self.__GetSetStatement(None)\r
1358 continue\r
1359 \r
1360 Macro = self.__Token\r
1361 \r
1362 if not self.__IsToken("="):\r
1363 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1364 if not self.__GetNextToken() or self.__Token.startswith('['):\r
1365 raise Warning("expected MACRO value", self.FileName, self.CurrentLineNumber)\r
1366 Value = self.__Token\r
1367\r
1368 return False\r
1369\r
1370 ## __GetFd() method\r
1371 #\r
1372 # Get FD section contents and store its data into FD dictionary of self.Profile\r
1373 #\r
1374 # @param self The object pointer\r
1375 # @retval True Successfully find a FD\r
1376 # @retval False Not able to find a FD\r
1377 #\r
1378 def __GetFd(self):\r
1379\r
1380 if not self.__GetNextToken():\r
1381 return False\r
1382\r
1383 S = self.__Token.upper()\r
1384 if S.startswith("[") and not S.startswith("[FD."):\r
1385 if not S.startswith("[FV.") and not S.startswith("[CAPSULE.") \\r
1386 and not S.startswith("[VTF.") and not S.startswith("[RULE.") and not S.startswith("[OPTIONROM."):\r
1387 raise Warning("Unknown section", self.FileName, self.CurrentLineNumber)\r
1388 self.__UndoToken()\r
1389 return False\r
1390\r
1391 self.__UndoToken()\r
1392 if not self.__IsToken("[FD.", True):\r
1393 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1394 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
1395 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
1396 raise Warning("expected [FD.]", self.FileName, self.CurrentLineNumber)\r
1397\r
1398 FdName = self.__GetUiName()\r
1399 if FdName == "":\r
1400 if len (self.Profile.FdDict) == 0:\r
1401 FdName = GenFdsGlobalVariable.PlatformName\r
1402 if FdName == "" and GlobalData.gActivePlatform:\r
1403 FdName = GlobalData.gActivePlatform.PlatformName\r
1404 self.Profile.FdNameNotSet = True\r
1405 else:\r
1406 raise Warning("expected FdName in [FD.] section", self.FileName, self.CurrentLineNumber)\r
1407 self.CurrentFdName = FdName.upper()\r
1408 \r
1409 if self.CurrentFdName in self.Profile.FdDict:\r
1410 raise Warning("Unexpected the same FD name", self.FileName, self.CurrentLineNumber)\r
1411\r
1412 if not self.__IsToken( "]"):\r
1413 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
1414\r
1415 FdObj = Fd.FD()\r
1416 FdObj.FdUiName = self.CurrentFdName\r
1417 self.Profile.FdDict[self.CurrentFdName] = FdObj\r
1418\r
1419 if len (self.Profile.FdDict) > 1 and self.Profile.FdNameNotSet:\r
1420 raise Warning("expected all FDs have their name", self.FileName, self.CurrentLineNumber)\r
1421\r
1422 Status = self.__GetCreateFile(FdObj)\r
1423 if not Status:\r
1424 raise Warning("FD name error", self.FileName, self.CurrentLineNumber)\r
1425\r
1426 while self.__GetTokenStatements(FdObj):\r
1427 pass\r
1428 for Attr in ("BaseAddress", "Size", "ErasePolarity"):\r
1429 if getattr(FdObj, Attr) == None:\r
1430 self.__GetNextToken()\r
1431 raise Warning("Keyword %s missing" % Attr, self.FileName, self.CurrentLineNumber)\r
1432\r
1433 if not FdObj.BlockSizeList:\r
1434 FdObj.BlockSizeList.append((1, FdObj.Size, None))\r
1435\r
1436 self.__GetDefineStatements(FdObj)\r
1437\r
1438 self.__GetSetStatements(FdObj)\r
1439\r
1440 if not self.__GetRegionLayout(FdObj):\r
1441 raise Warning("expected region layout", self.FileName, self.CurrentLineNumber)\r
1442\r
1443 while self.__GetRegionLayout(FdObj):\r
1444 pass\r
1445 return True\r
1446\r
1447 ## __GetUiName() method\r
1448 #\r
1449 # Return the UI name of a section\r
1450 #\r
1451 # @param self The object pointer\r
1452 # @retval FdName UI name\r
1453 #\r
1454 def __GetUiName(self):\r
1455 Name = ""\r
1456 if self.__GetNextWord():\r
1457 Name = self.__Token\r
1458\r
1459 return Name\r
1460\r
1461 ## __GetCreateFile() method\r
1462 #\r
1463 # Return the output file name of object\r
1464 #\r
1465 # @param self The object pointer\r
1466 # @param Obj object whose data will be stored in file\r
1467 # @retval FdName UI name\r
1468 #\r
1469 def __GetCreateFile(self, Obj):\r
1470\r
1471 if self.__IsKeyword( "CREATE_FILE"):\r
1472 if not self.__IsToken( "="):\r
1473 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1474\r
1475 if not self.__GetNextToken():\r
1476 raise Warning("expected file name", self.FileName, self.CurrentLineNumber)\r
1477\r
1478 FileName = self.__Token\r
1479 Obj.CreateFileName = FileName\r
1480\r
1481 return True\r
1482\r
1483 ## __GetTokenStatements() method\r
1484 #\r
1485 # Get token statements\r
1486 #\r
1487 # @param self The object pointer\r
1488 # @param Obj for whom token statement is got\r
1489 #\r
1490 def __GetTokenStatements(self, Obj):\r
1491 if self.__IsKeyword( "BaseAddress"):\r
1492 if not self.__IsToken( "="):\r
1493 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1494 \r
1495 if not self.__GetNextHexNumber():\r
1496 raise Warning("expected Hex base address", self.FileName, self.CurrentLineNumber)\r
1497 \r
1498 Obj.BaseAddress = self.__Token\r
1499 \r
1500 if self.__IsToken( "|"):\r
1501 pcdPair = self.__GetNextPcdName()\r
1502 Obj.BaseAddressPcd = pcdPair\r
1503 self.Profile.PcdDict[pcdPair] = Obj.BaseAddress\r
1504 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1505 self.Profile.PcdFileLineDict[pcdPair] = FileLineTuple\r
1506 return True\r
1507\r
1508 if self.__IsKeyword( "Size"):\r
1509 if not self.__IsToken( "="):\r
1510 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1511 \r
1512 if not self.__GetNextHexNumber():\r
1513 raise Warning("expected Hex size", self.FileName, self.CurrentLineNumber)\r
1514\r
1515 Size = self.__Token\r
1516 if self.__IsToken( "|"):\r
1517 pcdPair = self.__GetNextPcdName()\r
1518 Obj.SizePcd = pcdPair\r
1519 self.Profile.PcdDict[pcdPair] = Size\r
1520 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1521 self.Profile.PcdFileLineDict[pcdPair] = FileLineTuple\r
1522 Obj.Size = long(Size, 0)\r
1523 return True\r
1524\r
1525 if self.__IsKeyword( "ErasePolarity"):\r
1526 if not self.__IsToken( "="):\r
1527 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1528 \r
1529 if not self.__GetNextToken():\r
1530 raise Warning("expected Erase Polarity", self.FileName, self.CurrentLineNumber)\r
1531 \r
1532 if self.__Token != "1" and self.__Token != "0":\r
1533 raise Warning("expected 1 or 0 Erase Polarity", self.FileName, self.CurrentLineNumber)\r
1534 \r
1535 Obj.ErasePolarity = self.__Token\r
1536 return True\r
1537\r
1538 return self.__GetBlockStatements(Obj)\r
1539\r
1540 ## __GetAddressStatements() method\r
1541 #\r
1542 # Get address statements\r
1543 #\r
1544 # @param self The object pointer\r
1545 # @param Obj for whom address statement is got\r
1546 # @retval True Successfully find\r
1547 # @retval False Not able to find\r
1548 #\r
1549 def __GetAddressStatements(self, Obj):\r
1550\r
1551 if self.__IsKeyword("BsBaseAddress"):\r
1552 if not self.__IsToken( "="):\r
1553 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1554\r
1555 if not self.__GetNextDecimalNumber() and not self.__GetNextHexNumber():\r
1556 raise Warning("expected address", self.FileName, self.CurrentLineNumber)\r
1557\r
1558 BsAddress = long(self.__Token, 0)\r
1559 Obj.BsBaseAddress = BsAddress\r
1560\r
1561 if self.__IsKeyword("RtBaseAddress"):\r
1562 if not self.__IsToken( "="):\r
1563 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1564\r
1565 if not self.__GetNextDecimalNumber() and not self.__GetNextHexNumber():\r
1566 raise Warning("expected address", self.FileName, self.CurrentLineNumber)\r
1567\r
1568 RtAddress = long(self.__Token, 0)\r
1569 Obj.RtBaseAddress = RtAddress\r
1570\r
1571 ## __GetBlockStatements() method\r
1572 #\r
1573 # Get block statements\r
1574 #\r
1575 # @param self The object pointer\r
1576 # @param Obj for whom block statement is got\r
1577 #\r
1578 def __GetBlockStatements(self, Obj):\r
1579 IsBlock = False\r
1580 while self.__GetBlockStatement(Obj):\r
1581 IsBlock = True\r
1582 \r
1583 Item = Obj.BlockSizeList[-1]\r
1584 if Item[0] == None or Item[1] == None:\r
1585 raise Warning("expected block statement", self.FileName, self.CurrentLineNumber)\r
1586 return IsBlock\r
1587\r
1588 ## __GetBlockStatement() method\r
1589 #\r
1590 # Get block statement\r
1591 #\r
1592 # @param self The object pointer\r
1593 # @param Obj for whom block statement is got\r
1594 # @retval True Successfully find\r
1595 # @retval False Not able to find\r
1596 #\r
1597 def __GetBlockStatement(self, Obj):\r
1598 if not self.__IsKeyword( "BlockSize"):\r
1599 return False\r
1600\r
1601 if not self.__IsToken( "="):\r
1602 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1603\r
1604 if not self.__GetNextHexNumber() and not self.__GetNextDecimalNumber():\r
1605 raise Warning("expected Hex or Integer block size", self.FileName, self.CurrentLineNumber)\r
1606\r
1607 BlockSize = self.__Token\r
1608 BlockSizePcd = None\r
1609 if self.__IsToken( "|"):\r
1610 PcdPair = self.__GetNextPcdName()\r
1611 BlockSizePcd = PcdPair\r
1612 self.Profile.PcdDict[PcdPair] = BlockSize\r
1613 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1614 self.Profile.PcdFileLineDict[PcdPair] = FileLineTuple\r
1615 BlockSize = long(BlockSize, 0)\r
1616\r
1617 BlockNumber = None\r
1618 if self.__IsKeyword( "NumBlocks"):\r
1619 if not self.__IsToken( "="):\r
1620 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1621\r
1622 if not self.__GetNextDecimalNumber() and not self.__GetNextHexNumber():\r
1623 raise Warning("expected block numbers", self.FileName, self.CurrentLineNumber)\r
1624\r
1625 BlockNumber = long(self.__Token, 0)\r
1626\r
1627 Obj.BlockSizeList.append((BlockSize, BlockNumber, BlockSizePcd))\r
1628 return True\r
1629\r
1630 ## __GetDefineStatements() method\r
1631 #\r
1632 # Get define statements\r
1633 #\r
1634 # @param self The object pointer\r
1635 # @param Obj for whom define statement is got\r
1636 # @retval True Successfully find\r
1637 # @retval False Not able to find\r
1638 #\r
1639 def __GetDefineStatements(self, Obj):\r
1640 while self.__GetDefineStatement( Obj):\r
1641 pass\r
1642\r
1643 ## __GetDefineStatement() method\r
1644 #\r
1645 # Get define statement\r
1646 #\r
1647 # @param self The object pointer\r
1648 # @param Obj for whom define statement is got\r
1649 # @retval True Successfully find\r
1650 # @retval False Not able to find\r
1651 #\r
1652 def __GetDefineStatement(self, Obj):\r
1653 if self.__IsKeyword("DEFINE"):\r
1654 self.__GetNextToken()\r
1655 Macro = self.__Token\r
1656 if not self.__IsToken( "="):\r
1657 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1658\r
1659 if not self.__GetNextToken():\r
1660 raise Warning("expected value", self.FileName, self.CurrentLineNumber)\r
1661\r
1662 Value = self.__Token\r
1663 Macro = '$(' + Macro + ')'\r
1664 Obj.DefineVarDict[Macro] = Value\r
1665 return True\r
1666\r
1667 return False\r
1668\r
1669 ## __GetSetStatements() method\r
1670 #\r
1671 # Get set statements\r
1672 #\r
1673 # @param self The object pointer\r
1674 # @param Obj for whom set statement is got\r
1675 # @retval True Successfully find\r
1676 # @retval False Not able to find\r
1677 #\r
1678 def __GetSetStatements(self, Obj):\r
1679 while self.__GetSetStatement(Obj):\r
1680 pass\r
1681\r
1682 ## __GetSetStatement() method\r
1683 #\r
1684 # Get set statement\r
1685 #\r
1686 # @param self The object pointer\r
1687 # @param Obj for whom set statement is got\r
1688 # @retval True Successfully find\r
1689 # @retval False Not able to find\r
1690 #\r
1691 def __GetSetStatement(self, Obj):\r
1692 if self.__IsKeyword("SET"):\r
1693 PcdPair = self.__GetNextPcdName()\r
1694\r
1695 if not self.__IsToken( "="):\r
1696 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1697\r
1698 Value = self.__GetExpression()\r
1699 Value = self.__EvaluateConditional(Value, self.CurrentLineNumber, 'eval', True)\r
1700\r
1701 if Obj:\r
1702 Obj.SetVarDict[PcdPair] = Value\r
1703 self.Profile.PcdDict[PcdPair] = Value\r
1704 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1705 self.Profile.PcdFileLineDict[PcdPair] = FileLineTuple\r
1706 return True\r
1707\r
1708 return False\r
1709\r
1710 ## __CalcRegionExpr(self)\r
1711 #\r
1712 # Calculate expression for offset or size of a region\r
1713 #\r
1714 # @return: None if invalid expression\r
1715 # Calculated number if successfully\r
1716 #\r
1717 def __CalcRegionExpr(self):\r
1718 StartPos = self.GetFileBufferPos()\r
1719 Expr = ''\r
1720 PairCount = 0\r
1721 while not self.__EndOfFile():\r
1722 CurCh = self.__CurrentChar()\r
1723 if CurCh == '(':\r
1724 PairCount += 1\r
1725 elif CurCh == ')':\r
1726 PairCount -= 1\r
1727\r
1728 if CurCh in '|\r\n' and PairCount == 0:\r
1729 break\r
1730 Expr += CurCh\r
1731 self.__GetOneChar()\r
1732 try:\r
1733 return long(\r
1734 ValueExpression(Expr,\r
1735 dict(['%s.%s' % (Pcd[1], Pcd[0]), Val] \r
1736 for Pcd, Val in self.Profile.PcdDict.iteritems())\r
1737 )(True),0)\r
1738 except Exception:\r
1739 self.SetFileBufferPos(StartPos)\r
1740 return None\r
1741\r
1742 ## __GetRegionLayout() method\r
1743 #\r
1744 # Get region layout for FD\r
1745 #\r
1746 # @param self The object pointer\r
1747 # @param Fd for whom region is got\r
1748 # @retval True Successfully find\r
1749 # @retval False Not able to find\r
1750 #\r
1751 def __GetRegionLayout(self, Fd):\r
1752 Offset = self.__CalcRegionExpr() \r
1753 if Offset == None:\r
1754 return False\r
1755\r
1756 RegionObj = Region.Region()\r
1757 RegionObj.Offset = Offset\r
1758 Fd.RegionList.append(RegionObj)\r
1759\r
1760 if not self.__IsToken( "|"):\r
1761 raise Warning("expected '|'", self.FileName, self.CurrentLineNumber)\r
1762\r
1763 Size = self.__CalcRegionExpr()\r
1764 if Size == None:\r
1765 raise Warning("expected Region Size", self.FileName, self.CurrentLineNumber)\r
1766 RegionObj.Size = Size\r
1767\r
1768 if not self.__GetNextWord():\r
1769 return True\r
1770\r
1771 if not self.__Token in ("SET", "FV", "FILE", "DATA", "CAPSULE"):\r
1772 self.__UndoToken()\r
1773 RegionObj.PcdOffset = self.__GetNextPcdName()\r
1774 self.Profile.PcdDict[RegionObj.PcdOffset] = "0x%08X" % (RegionObj.Offset + long(Fd.BaseAddress, 0))\r
1775 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1776 self.Profile.PcdFileLineDict[RegionObj.PcdOffset] = FileLineTuple\r
1777 if self.__IsToken( "|"):\r
1778 RegionObj.PcdSize = self.__GetNextPcdName()\r
1779 self.Profile.PcdDict[RegionObj.PcdSize] = "0x%08X" % RegionObj.Size\r
1780 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
1781 self.Profile.PcdFileLineDict[RegionObj.PcdSize] = FileLineTuple\r
1782\r
1783 if not self.__GetNextWord():\r
1784 return True\r
1785\r
1786 if self.__Token == "SET":\r
1787 self.__UndoToken()\r
1788 self.__GetSetStatements( RegionObj)\r
1789 if not self.__GetNextWord():\r
1790 return True\r
1791\r
1792 elif self.__Token == "FV":\r
1793 self.__UndoToken()\r
1794 self.__GetRegionFvType( RegionObj)\r
1795\r
1796 elif self.__Token == "CAPSULE":\r
1797 self.__UndoToken()\r
1798 self.__GetRegionCapType( RegionObj)\r
1799\r
1800 elif self.__Token == "FILE":\r
1801 self.__UndoToken()\r
1802 self.__GetRegionFileType( RegionObj)\r
1803\r
1804 elif self.__Token == "DATA":\r
1805 self.__UndoToken()\r
1806 self.__GetRegionDataType( RegionObj)\r
1807 else:\r
1808 raise Warning("A valid region type was not found. "\r
1809 "Valid types are [SET, FV, CAPSULE, FILE, DATA]. This error occurred",\r
1810 self.FileName, self.CurrentLineNumber)\r
1811\r
1812 return True\r
1813\r
1814 ## __GetRegionFvType() method\r
1815 #\r
1816 # Get region fv data for region\r
1817 #\r
1818 # @param self The object pointer\r
1819 # @param RegionObj for whom region data is got\r
1820 #\r
1821 def __GetRegionFvType(self, RegionObj):\r
1822\r
1823 if not self.__IsKeyword( "FV"):\r
1824 raise Warning("expected Keyword 'FV'", self.FileName, self.CurrentLineNumber)\r
1825\r
1826 if not self.__IsToken( "="):\r
1827 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1828\r
1829 if not self.__GetNextToken():\r
1830 raise Warning("expected FV name", self.FileName, self.CurrentLineNumber)\r
1831\r
1832 RegionObj.RegionType = "FV"\r
1833 RegionObj.RegionDataList.append(self.__Token)\r
1834\r
1835 while self.__IsKeyword( "FV"):\r
1836\r
1837 if not self.__IsToken( "="):\r
1838 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1839\r
1840 if not self.__GetNextToken():\r
1841 raise Warning("expected FV name", self.FileName, self.CurrentLineNumber)\r
1842\r
1843 RegionObj.RegionDataList.append(self.__Token)\r
1844\r
1845 ## __GetRegionCapType() method\r
1846 #\r
1847 # Get region capsule data for region\r
1848 #\r
1849 # @param self The object pointer\r
1850 # @param RegionObj for whom region data is got\r
1851 #\r
1852 def __GetRegionCapType(self, RegionObj):\r
1853\r
1854 if not self.__IsKeyword("CAPSULE"):\r
1855 raise Warning("expected Keyword 'CAPSULE'", self.FileName, self.CurrentLineNumber)\r
1856\r
1857 if not self.__IsToken("="):\r
1858 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1859\r
1860 if not self.__GetNextToken():\r
1861 raise Warning("expected CAPSULE name", self.FileName, self.CurrentLineNumber)\r
1862\r
1863 RegionObj.RegionType = "CAPSULE"\r
1864 RegionObj.RegionDataList.append(self.__Token)\r
1865\r
1866 while self.__IsKeyword("CAPSULE"):\r
1867\r
1868 if not self.__IsToken("="):\r
1869 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1870\r
1871 if not self.__GetNextToken():\r
1872 raise Warning("expected CAPSULE name", self.FileName, self.CurrentLineNumber)\r
1873\r
1874 RegionObj.RegionDataList.append(self.__Token)\r
1875\r
1876 ## __GetRegionFileType() method\r
1877 #\r
1878 # Get region file data for region\r
1879 #\r
1880 # @param self The object pointer\r
1881 # @param RegionObj for whom region data is got\r
1882 #\r
1883 def __GetRegionFileType(self, RegionObj):\r
1884\r
1885 if not self.__IsKeyword( "FILE"):\r
1886 raise Warning("expected Keyword 'FILE'", self.FileName, self.CurrentLineNumber)\r
1887\r
1888 if not self.__IsToken( "="):\r
1889 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1890\r
1891 if not self.__GetNextToken():\r
1892 raise Warning("expected File name", self.FileName, self.CurrentLineNumber)\r
1893\r
1894 RegionObj.RegionType = "FILE"\r
1895 RegionObj.RegionDataList.append( self.__Token)\r
1896\r
1897 while self.__IsKeyword( "FILE"):\r
1898\r
1899 if not self.__IsToken( "="):\r
1900 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1901\r
1902 if not self.__GetNextToken():\r
1903 raise Warning("expected FILE name", self.FileName, self.CurrentLineNumber)\r
1904\r
1905 RegionObj.RegionDataList.append(self.__Token)\r
1906\r
1907 ## __GetRegionDataType() method\r
1908 #\r
1909 # Get region array data for region\r
1910 #\r
1911 # @param self The object pointer\r
1912 # @param RegionObj for whom region data is got\r
1913 #\r
1914 def __GetRegionDataType(self, RegionObj):\r
1915\r
1916 if not self.__IsKeyword( "DATA"):\r
1917 raise Warning("expected Region Data type", self.FileName, self.CurrentLineNumber)\r
1918\r
1919 if not self.__IsToken( "="):\r
1920 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1921\r
1922 if not self.__IsToken( "{"):\r
1923 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
1924\r
1925 if not self.__GetNextHexNumber():\r
1926 raise Warning("expected Hex byte", self.FileName, self.CurrentLineNumber)\r
1927\r
1928 if len(self.__Token) > 18:\r
1929 raise Warning("Hex string can't be converted to a valid UINT64 value", self.FileName, self.CurrentLineNumber)\r
1930\r
1931 # convert hex string value to byte hex string array\r
1932 AllString = self.__Token\r
1933 AllStrLen = len (AllString)\r
1934 DataString = ""\r
1935 while AllStrLen > 4:\r
1936 DataString = DataString + "0x" + AllString[AllStrLen - 2: AllStrLen] + ","\r
1937 AllStrLen = AllStrLen - 2\r
1938 DataString = DataString + AllString[:AllStrLen] + ","\r
1939\r
1940 # byte value array\r
1941 if len (self.__Token) <= 4:\r
1942 while self.__IsToken(","):\r
1943 if not self.__GetNextHexNumber():\r
1944 raise Warning("Invalid Hex number", self.FileName, self.CurrentLineNumber)\r
1945 if len(self.__Token) > 4:\r
1946 raise Warning("Hex byte(must be 2 digits) too long", self.FileName, self.CurrentLineNumber)\r
1947 DataString += self.__Token\r
1948 DataString += ","\r
1949\r
1950 if not self.__IsToken( "}"):\r
1951 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
1952\r
1953 DataString = DataString.rstrip(",")\r
1954 RegionObj.RegionType = "DATA"\r
1955 RegionObj.RegionDataList.append( DataString)\r
1956\r
1957 while self.__IsKeyword( "DATA"):\r
1958\r
1959 if not self.__IsToken( "="):\r
1960 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
1961\r
1962 if not self.__IsToken( "{"):\r
1963 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
1964\r
1965 if not self.__GetNextHexNumber():\r
1966 raise Warning("expected Hex byte", self.FileName, self.CurrentLineNumber)\r
1967\r
1968 if len(self.__Token) > 18:\r
1969 raise Warning("Hex string can't be converted to a valid UINT64 value", self.FileName, self.CurrentLineNumber)\r
1970\r
1971 # convert hex string value to byte hex string array\r
1972 AllString = self.__Token\r
1973 AllStrLen = len (AllString)\r
1974 DataString = ""\r
1975 while AllStrLen > 4:\r
1976 DataString = DataString + "0x" + AllString[AllStrLen - 2: AllStrLen] + ","\r
1977 AllStrLen = AllStrLen - 2\r
1978 DataString = DataString + AllString[:AllStrLen] + ","\r
1979\r
1980 # byte value array\r
1981 if len (self.__Token) <= 4:\r
1982 while self.__IsToken(","):\r
1983 if not self.__GetNextHexNumber():\r
1984 raise Warning("Invalid Hex number", self.FileName, self.CurrentLineNumber)\r
1985 if len(self.__Token) > 4:\r
1986 raise Warning("Hex byte(must be 2 digits) too long", self.FileName, self.CurrentLineNumber)\r
1987 DataString += self.__Token\r
1988 DataString += ","\r
1989\r
1990 if not self.__IsToken( "}"):\r
1991 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
1992\r
1993 DataString = DataString.rstrip(",")\r
1994 RegionObj.RegionDataList.append( DataString)\r
1995\r
1996 ## __GetFv() method\r
1997 #\r
1998 # Get FV section contents and store its data into FV dictionary of self.Profile\r
1999 #\r
2000 # @param self The object pointer\r
2001 # @retval True Successfully find a FV\r
2002 # @retval False Not able to find a FV\r
2003 #\r
2004 def __GetFv(self):\r
2005 if not self.__GetNextToken():\r
2006 return False\r
2007\r
2008 S = self.__Token.upper()\r
2009 if S.startswith("[") and not S.startswith("[FV."):\r
2010 if not S.startswith("[CAPSULE.") \\r
2011 and not S.startswith("[VTF.") and not S.startswith("[RULE.") and not S.startswith("[OPTIONROM."):\r
2012 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
2013 self.__UndoToken()\r
2014 return False\r
2015\r
2016 self.__UndoToken()\r
2017 if not self.__IsToken("[FV.", True):\r
2018 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
2019 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
2020 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
2021 raise Warning("Unknown Keyword '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2022\r
2023 FvName = self.__GetUiName()\r
2024 self.CurrentFvName = FvName.upper()\r
2025\r
2026 if not self.__IsToken( "]"):\r
2027 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
2028\r
2029 FvObj = Fv.FV()\r
2030 FvObj.UiFvName = self.CurrentFvName\r
2031 self.Profile.FvDict[self.CurrentFvName] = FvObj\r
2032\r
2033 Status = self.__GetCreateFile(FvObj)\r
2034 if not Status:\r
2035 raise Warning("FV name error", self.FileName, self.CurrentLineNumber)\r
2036\r
2037 self.__GetDefineStatements(FvObj)\r
2038\r
2039 self.__GetAddressStatements(FvObj)\r
2040\r
2041 FvObj.FvExtEntryTypeValue = []\r
2042 FvObj.FvExtEntryType = []\r
2043 FvObj.FvExtEntryData = []\r
2044 while True:\r
2045 self.__GetSetStatements(FvObj)\r
2046\r
2047 if not (self.__GetBlockStatement(FvObj) or self.__GetFvBaseAddress(FvObj) or \r
2048 self.__GetFvForceRebase(FvObj) or self.__GetFvAlignment(FvObj) or \r
2049 self.__GetFvAttributes(FvObj) or self.__GetFvNameGuid(FvObj) or \r
2050 self.__GetFvExtEntryStatement(FvObj)):\r
2051 break\r
2052\r
2053 self.__GetAprioriSection(FvObj, FvObj.DefineVarDict.copy())\r
2054 self.__GetAprioriSection(FvObj, FvObj.DefineVarDict.copy())\r
2055\r
2056 while True:\r
2057 isInf = self.__GetInfStatement(FvObj, MacroDict = FvObj.DefineVarDict.copy())\r
2058 isFile = self.__GetFileStatement(FvObj, MacroDict = FvObj.DefineVarDict.copy())\r
2059 if not isInf and not isFile:\r
2060 break\r
2061\r
2062 return True\r
2063\r
2064 ## __GetFvAlignment() method\r
2065 #\r
2066 # Get alignment for FV\r
2067 #\r
2068 # @param self The object pointer\r
2069 # @param Obj for whom alignment is got\r
2070 # @retval True Successfully find a alignment statement\r
2071 # @retval False Not able to find a alignment statement\r
2072 #\r
2073 def __GetFvAlignment(self, Obj):\r
2074\r
2075 if not self.__IsKeyword( "FvAlignment"):\r
2076 return False\r
2077\r
2078 if not self.__IsToken( "="):\r
2079 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2080\r
2081 if not self.__GetNextToken():\r
2082 raise Warning("expected alignment value", self.FileName, self.CurrentLineNumber)\r
2083\r
2084 if self.__Token.upper() not in ("1", "2", "4", "8", "16", "32", "64", "128", "256", "512", \\r
2085 "1K", "2K", "4K", "8K", "16K", "32K", "64K", "128K", "256K", "512K", \\r
2086 "1M", "2M", "4M", "8M", "16M", "32M", "64M", "128M", "256M", "512M", \\r
2087 "1G", "2G"):\r
2088 raise Warning("Unknown alignment value '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2089 Obj.FvAlignment = self.__Token\r
2090 return True\r
2091 \r
2092 ## __GetFvBaseAddress() method\r
2093 #\r
2094 # Get BaseAddress for FV\r
2095 #\r
2096 # @param self The object pointer\r
2097 # @param Obj for whom FvBaseAddress is got\r
2098 # @retval True Successfully find a FvBaseAddress statement\r
2099 # @retval False Not able to find a FvBaseAddress statement\r
2100 #\r
2101 def __GetFvBaseAddress(self, Obj):\r
2102\r
2103 if not self.__IsKeyword("FvBaseAddress"):\r
2104 return False\r
2105\r
2106 if not self.__IsToken( "="):\r
2107 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2108\r
2109 if not self.__GetNextToken():\r
2110 raise Warning("expected FV base address value", self.FileName, self.CurrentLineNumber)\r
2111\r
2112 IsValidBaseAddrValue = re.compile('^0[x|X][0-9a-fA-F]+')\r
2113\r
2114 if not IsValidBaseAddrValue.match(self.__Token.upper()):\r
2115 raise Warning("Unknown FV base address value '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2116 Obj.FvBaseAddress = self.__Token\r
2117 return True \r
2118 \r
2119 ## __GetFvForceRebase() method\r
2120 #\r
2121 # Get FvForceRebase for FV\r
2122 #\r
2123 # @param self The object pointer\r
2124 # @param Obj for whom FvForceRebase is got\r
2125 # @retval True Successfully find a FvForceRebase statement\r
2126 # @retval False Not able to find a FvForceRebase statement\r
2127 #\r
2128 def __GetFvForceRebase(self, Obj):\r
2129\r
2130 if not self.__IsKeyword("FvForceRebase"):\r
2131 return False\r
2132\r
2133 if not self.__IsToken( "="):\r
2134 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2135\r
2136 if not self.__GetNextToken():\r
2137 raise Warning("expected FvForceRebase value", self.FileName, self.CurrentLineNumber)\r
2138\r
2139 if self.__Token.upper() not in ["TRUE", "FALSE", "0", "0X0", "0X00", "1", "0X1", "0X01"]:\r
2140 raise Warning("Unknown FvForceRebase value '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2141 \r
2142 if self.__Token.upper() in ["TRUE", "1", "0X1", "0X01"]:\r
2143 Obj.FvForceRebase = True\r
2144 elif self.__Token.upper() in ["FALSE", "0", "0X0", "0X00"]:\r
2145 Obj.FvForceRebase = False\r
2146 else:\r
2147 Obj.FvForceRebase = None\r
2148 \r
2149 return True\r
2150\r
2151\r
2152 ## __GetFvAttributes() method\r
2153 #\r
2154 # Get attributes for FV\r
2155 #\r
2156 # @param self The object pointer\r
2157 # @param Obj for whom attribute is got\r
2158 # @retval None\r
2159 #\r
2160 def __GetFvAttributes(self, FvObj):\r
2161\r
2162 while self.__GetNextWord():\r
2163 name = self.__Token\r
2164 if name not in ("ERASE_POLARITY", "MEMORY_MAPPED", \\r
2165 "STICKY_WRITE", "LOCK_CAP", "LOCK_STATUS", "WRITE_ENABLED_CAP", \\r
2166 "WRITE_DISABLED_CAP", "WRITE_STATUS", "READ_ENABLED_CAP", \\r
2167 "READ_DISABLED_CAP", "READ_STATUS", "READ_LOCK_CAP", \\r
2168 "READ_LOCK_STATUS", "WRITE_LOCK_CAP", "WRITE_LOCK_STATUS", \\r
2169 "WRITE_POLICY_RELIABLE", "WEAK_ALIGNMENT"):\r
2170 self.__UndoToken()\r
2171 return False\r
2172\r
2173 if not self.__IsToken( "="):\r
2174 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2175\r
2176 if not self.__GetNextToken() or self.__Token.upper() not in ("TRUE", "FALSE", "1", "0"):\r
2177 raise Warning("expected TRUE/FALSE (1/0)", self.FileName, self.CurrentLineNumber)\r
2178\r
2179 FvObj.FvAttributeDict[name] = self.__Token\r
2180\r
2181 return True\r
2182 \r
2183 ## __GetFvNameGuid() method\r
2184 #\r
2185 # Get FV GUID for FV\r
2186 #\r
2187 # @param self The object pointer\r
2188 # @param Obj for whom GUID is got\r
2189 # @retval None\r
2190 #\r
2191 def __GetFvNameGuid(self, FvObj):\r
2192\r
2193 if not self.__IsKeyword( "FvNameGuid"):\r
2194 return False\r
2195\r
2196 if not self.__IsToken( "="):\r
2197 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2198\r
2199 if not self.__GetNextGuid():\r
2200 raise Warning("expected FV GUID value", self.FileName, self.CurrentLineNumber)\r
2201\r
2202 FvObj.FvNameGuid = self.__Token\r
2203\r
2204 return True\r
2205\r
2206 def __GetFvExtEntryStatement(self, FvObj):\r
2207\r
2208 if not self.__IsKeyword( "FV_EXT_ENTRY"):\r
2209 return False\r
2210\r
2211 if not self.__IsKeyword ("TYPE"):\r
2212 raise Warning("expected 'TYPE'", self.FileName, self.CurrentLineNumber)\r
2213 \r
2214 if not self.__IsToken( "="):\r
2215 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2216\r
2217 if not self.__GetNextHexNumber() and not self.__GetNextDecimalNumber():\r
2218 raise Warning("expected Hex FV extension entry type value At Line ", self.FileName, self.CurrentLineNumber)\r
2219\r
2220 FvObj.FvExtEntryTypeValue += [self.__Token]\r
2221\r
2222 if not self.__IsToken( "{"):\r
2223 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2224\r
2225 if not self.__IsKeyword ("FILE") and not self.__IsKeyword ("DATA"):\r
2226 raise Warning("expected 'FILE' or 'DATA'", self.FileName, self.CurrentLineNumber)\r
2227\r
2228 FvObj.FvExtEntryType += [self.__Token]\r
2229\r
2230 if self.__Token == 'DATA':\r
2231\r
2232 if not self.__IsToken( "="):\r
2233 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2234 \r
2235 if not self.__IsToken( "{"):\r
2236 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2237\r
2238 if not self.__GetNextHexNumber():\r
2239 raise Warning("expected Hex byte", self.FileName, self.CurrentLineNumber)\r
2240\r
2241 if len(self.__Token) > 4:\r
2242 raise Warning("Hex byte(must be 2 digits) too long", self.FileName, self.CurrentLineNumber)\r
2243\r
2244 DataString = self.__Token\r
2245 DataString += ","\r
2246\r
2247 while self.__IsToken(","):\r
2248 if not self.__GetNextHexNumber():\r
2249 raise Warning("Invalid Hex number", self.FileName, self.CurrentLineNumber)\r
2250 if len(self.__Token) > 4:\r
2251 raise Warning("Hex byte(must be 2 digits) too long", self.FileName, self.CurrentLineNumber)\r
2252 DataString += self.__Token\r
2253 DataString += ","\r
2254\r
2255 if not self.__IsToken( "}"):\r
2256 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2257\r
2258 if not self.__IsToken( "}"):\r
2259 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2260\r
2261 DataString = DataString.rstrip(",")\r
2262 FvObj.FvExtEntryData += [DataString]\r
2263\r
2264 if self.__Token == 'FILE':\r
2265 \r
2266 if not self.__IsToken( "="):\r
2267 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2268 \r
2269 if not self.__GetNextToken():\r
2270 raise Warning("expected FV Extension Entry file path At Line ", self.FileName, self.CurrentLineNumber)\r
2271 \r
2272 FvObj.FvExtEntryData += [self.__Token]\r
2273\r
2274 if not self.__IsToken( "}"):\r
2275 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2276\r
2277 return True\r
2278\r
2279 ## __GetAprioriSection() method\r
2280 #\r
2281 # Get token statements\r
2282 #\r
2283 # @param self The object pointer\r
2284 # @param FvObj for whom apriori is got\r
2285 # @param MacroDict dictionary used to replace macro\r
2286 # @retval True Successfully find apriori statement\r
2287 # @retval False Not able to find apriori statement\r
2288 #\r
2289 def __GetAprioriSection(self, FvObj, MacroDict = {}):\r
2290\r
2291 if not self.__IsKeyword( "APRIORI"):\r
2292 return False\r
2293\r
2294 if not self.__IsKeyword("PEI") and not self.__IsKeyword("DXE"):\r
2295 raise Warning("expected Apriori file type", self.FileName, self.CurrentLineNumber)\r
2296 AprType = self.__Token\r
2297\r
2298 if not self.__IsToken( "{"):\r
2299 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2300\r
2301 AprSectionObj = AprioriSection.AprioriSection()\r
2302 AprSectionObj.AprioriType = AprType\r
2303\r
2304 self.__GetDefineStatements(AprSectionObj)\r
2305 MacroDict.update(AprSectionObj.DefineVarDict)\r
2306\r
2307 while True:\r
2308 IsInf = self.__GetInfStatement( AprSectionObj, MacroDict = MacroDict)\r
2309 IsFile = self.__GetFileStatement( AprSectionObj)\r
2310 if not IsInf and not IsFile:\r
2311 break\r
2312\r
2313 if not self.__IsToken( "}"):\r
2314 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2315\r
2316 FvObj.AprioriSectionList.append(AprSectionObj)\r
2317 return True\r
2318\r
2319 ## __GetInfStatement() method\r
2320 #\r
2321 # Get INF statements\r
2322 #\r
2323 # @param self The object pointer\r
2324 # @param Obj for whom inf statement is got\r
2325 # @param MacroDict dictionary used to replace macro\r
2326 # @retval True Successfully find inf statement\r
2327 # @retval False Not able to find inf statement\r
2328 #\r
2329 def __GetInfStatement(self, Obj, ForCapsule = False, MacroDict = {}):\r
2330\r
2331 if not self.__IsKeyword( "INF"):\r
2332 return False\r
2333\r
2334 ffsInf = FfsInfStatement.FfsInfStatement()\r
2335 self.__GetInfOptions( ffsInf)\r
2336\r
2337 if not self.__GetNextToken():\r
2338 raise Warning("expected INF file path", self.FileName, self.CurrentLineNumber)\r
2339 ffsInf.InfFileName = self.__Token\r
2340\r
2341 ffsInf.CurrentLineNum = self.CurrentLineNumber\r
2342 ffsInf.CurrentLineContent = self.__CurrentLine()\r
2343\r
2344 if ffsInf.InfFileName.replace('$(WORKSPACE)', '').find('$') == -1:\r
2345 #do case sensitive check for file path\r
2346 ErrorCode, ErrorInfo = PathClass(NormPath(ffsInf.InfFileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
2347 if ErrorCode != 0:\r
2348 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
2349\r
2350 if not ffsInf.InfFileName in self.Profile.InfList:\r
2351 self.Profile.InfList.append(ffsInf.InfFileName)\r
2352 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
2353 self.Profile.InfFileLineList.append(FileLineTuple)\r
2354\r
2355 if self.__IsToken('|'):\r
2356 if self.__IsKeyword('RELOCS_STRIPPED'):\r
2357 ffsInf.KeepReloc = False\r
2358 elif self.__IsKeyword('RELOCS_RETAINED'):\r
2359 ffsInf.KeepReloc = True\r
2360 else:\r
2361 raise Warning("Unknown reloc strip flag '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2362 \r
2363 if ForCapsule:\r
2364 capsuleFfs = CapsuleData.CapsuleFfs()\r
2365 capsuleFfs.Ffs = ffsInf\r
2366 Obj.CapsuleDataList.append(capsuleFfs)\r
2367 else:\r
2368 Obj.FfsList.append(ffsInf)\r
2369 return True\r
2370\r
2371 ## __GetInfOptions() method\r
2372 #\r
2373 # Get options for INF\r
2374 #\r
2375 # @param self The object pointer\r
2376 # @param FfsInfObj for whom option is got\r
2377 #\r
2378 def __GetInfOptions(self, FfsInfObj):\r
2379\r
2380 if self.__IsKeyword( "RuleOverride"):\r
2381 if not self.__IsToken( "="):\r
2382 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2383 if not self.__GetNextToken():\r
2384 raise Warning("expected Rule name", self.FileName, self.CurrentLineNumber)\r
2385 FfsInfObj.Rule = self.__Token\r
2386\r
2387 if self.__IsKeyword( "VERSION"):\r
2388 if not self.__IsToken( "="):\r
2389 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2390 if not self.__GetNextToken():\r
2391 raise Warning("expected Version", self.FileName, self.CurrentLineNumber)\r
2392\r
2393 if self.__GetStringData():\r
2394 FfsInfObj.Version = self.__Token\r
2395\r
2396 if self.__IsKeyword( "UI"):\r
2397 if not self.__IsToken( "="):\r
2398 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2399 if not self.__GetNextToken():\r
2400 raise Warning("expected UI name", self.FileName, self.CurrentLineNumber)\r
2401\r
2402 if self.__GetStringData():\r
2403 FfsInfObj.Ui = self.__Token\r
2404\r
2405 if self.__IsKeyword( "USE"):\r
2406 if not self.__IsToken( "="):\r
2407 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2408 if not self.__GetNextToken():\r
2409 raise Warning("expected ARCH name", self.FileName, self.CurrentLineNumber)\r
2410 FfsInfObj.UseArch = self.__Token\r
2411\r
2412 \r
2413 if self.__GetNextToken():\r
2414 p = re.compile(r'([a-zA-Z0-9\-]+|\$\(TARGET\)|\*)_([a-zA-Z0-9\-]+|\$\(TOOL_CHAIN_TAG\)|\*)_([a-zA-Z0-9\-]+|\$\(ARCH\)|\*)')\r
2415 if p.match(self.__Token):\r
2416 FfsInfObj.KeyStringList.append(self.__Token)\r
2417 if not self.__IsToken(","):\r
2418 return\r
2419 else:\r
2420 self.__UndoToken()\r
2421 return\r
2422\r
2423 while self.__GetNextToken():\r
2424 if not p.match(self.__Token):\r
2425 raise Warning("expected KeyString \"Target_Tag_Arch\"", self.FileName, self.CurrentLineNumber)\r
2426 FfsInfObj.KeyStringList.append(self.__Token)\r
2427\r
2428 if not self.__IsToken(","):\r
2429 break\r
2430\r
2431 ## __GetFileStatement() method\r
2432 #\r
2433 # Get FILE statements\r
2434 #\r
2435 # @param self The object pointer\r
2436 # @param Obj for whom FILE statement is got\r
2437 # @param MacroDict dictionary used to replace macro\r
2438 # @retval True Successfully find FILE statement\r
2439 # @retval False Not able to find FILE statement\r
2440 #\r
2441 def __GetFileStatement(self, Obj, ForCapsule = False, MacroDict = {}):\r
2442\r
2443 if not self.__IsKeyword( "FILE"):\r
2444 return False\r
2445\r
2446 if not self.__GetNextWord():\r
2447 raise Warning("expected FFS type", self.FileName, self.CurrentLineNumber)\r
2448\r
2449 if ForCapsule and self.__Token == 'DATA':\r
2450 self.__UndoToken()\r
2451 self.__UndoToken()\r
2452 return False\r
2453 \r
2454 FfsFileObj = FfsFileStatement.FileStatement()\r
2455 FfsFileObj.FvFileType = self.__Token\r
2456\r
2457 if not self.__IsToken( "="):\r
2458 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2459\r
2460 if not self.__GetNextGuid():\r
2461 if not self.__GetNextWord():\r
2462 raise Warning("expected File GUID", self.FileName, self.CurrentLineNumber)\r
2463 if self.__Token == 'PCD':\r
2464 if not self.__IsToken( "("):\r
2465 raise Warning("expected '('", self.FileName, self.CurrentLineNumber)\r
2466 PcdPair = self.__GetNextPcdName()\r
2467 if not self.__IsToken( ")"):\r
2468 raise Warning("expected ')'", self.FileName, self.CurrentLineNumber)\r
2469 self.__Token = 'PCD('+PcdPair[1]+'.'+PcdPair[0]+')'\r
2470 \r
2471 FfsFileObj.NameGuid = self.__Token\r
2472 \r
2473 self.__GetFilePart( FfsFileObj, MacroDict.copy())\r
2474\r
2475 if ForCapsule:\r
2476 capsuleFfs = CapsuleData.CapsuleFfs()\r
2477 capsuleFfs.Ffs = FfsFileObj\r
2478 Obj.CapsuleDataList.append(capsuleFfs)\r
2479 else:\r
2480 Obj.FfsList.append(FfsFileObj)\r
2481\r
2482 return True\r
2483\r
2484 ## __FileCouldHaveRelocFlag() method\r
2485 #\r
2486 # Check whether reloc strip flag can be set for a file type.\r
2487 #\r
2488 # @param self The object pointer\r
2489 # @param FileType The file type to check with\r
2490 # @retval True This type could have relocation strip flag\r
2491 # @retval False No way to have it\r
2492 #\r
2493\r
2494 def __FileCouldHaveRelocFlag (self, FileType):\r
2495 if FileType in ('SEC', 'PEI_CORE', 'PEIM', 'PEI_DXE_COMBO'):\r
2496 return True\r
2497 else:\r
2498 return False\r
2499\r
2500 ## __SectionCouldHaveRelocFlag() method\r
2501 #\r
2502 # Check whether reloc strip flag can be set for a section type.\r
2503 #\r
2504 # @param self The object pointer\r
2505 # @param SectionType The section type to check with\r
2506 # @retval True This type could have relocation strip flag\r
2507 # @retval False No way to have it\r
2508 #\r
2509\r
2510 def __SectionCouldHaveRelocFlag (self, SectionType):\r
2511 if SectionType in ('TE', 'PE32'):\r
2512 return True\r
2513 else:\r
2514 return False\r
2515\r
2516 ## __GetFilePart() method\r
2517 #\r
2518 # Get components for FILE statement\r
2519 #\r
2520 # @param self The object pointer\r
2521 # @param FfsFileObj for whom component is got\r
2522 # @param MacroDict dictionary used to replace macro\r
2523 #\r
2524 def __GetFilePart(self, FfsFileObj, MacroDict = {}):\r
2525\r
2526 self.__GetFileOpts( FfsFileObj)\r
2527\r
2528 if not self.__IsToken("{"):\r
2529 if self.__IsKeyword('RELOCS_STRIPPED') or self.__IsKeyword('RELOCS_RETAINED'):\r
2530 if self.__FileCouldHaveRelocFlag(FfsFileObj.FvFileType):\r
2531 if self.__Token == 'RELOCS_STRIPPED':\r
2532 FfsFileObj.KeepReloc = False\r
2533 else:\r
2534 FfsFileObj.KeepReloc = True\r
2535 else:\r
2536 raise Warning("File type %s could not have reloc strip flag%d" % (FfsFileObj.FvFileType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
2537\r
2538 if not self.__IsToken("{"):\r
2539 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2540\r
2541 if not self.__GetNextToken():\r
2542 raise Warning("expected File name or section data", self.FileName, self.CurrentLineNumber)\r
2543\r
2544 if self.__Token == "FV":\r
2545 if not self.__IsToken( "="):\r
2546 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2547 if not self.__GetNextToken():\r
2548 raise Warning("expected FV name", self.FileName, self.CurrentLineNumber)\r
2549 FfsFileObj.FvName = self.__Token\r
2550\r
2551 elif self.__Token == "FD":\r
2552 if not self.__IsToken( "="):\r
2553 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2554 if not self.__GetNextToken():\r
2555 raise Warning("expected FD name", self.FileName, self.CurrentLineNumber)\r
2556 FfsFileObj.FdName = self.__Token\r
2557\r
2558 elif self.__Token in ("DEFINE", "APRIORI", "SECTION"):\r
2559 self.__UndoToken()\r
2560 self.__GetSectionData( FfsFileObj, MacroDict)\r
2561 else:\r
2562 FfsFileObj.CurrentLineNum = self.CurrentLineNumber\r
2563 FfsFileObj.CurrentLineContent = self.__CurrentLine()\r
2564 FfsFileObj.FileName = self.__Token\r
2565 if FfsFileObj.FileName.replace('$(WORKSPACE)', '').find('$') == -1:\r
2566 #\r
2567 # For file in OUTPUT_DIRECTORY will not check whether it exist or not at AutoGen phase.\r
2568 #\r
2569 if not GlobalData.gAutoGenPhase:\r
2570 #do case sensitive check for file path\r
2571 ErrorCode, ErrorInfo = PathClass(NormPath(FfsFileObj.FileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
2572 if ErrorCode != 0:\r
2573 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
2574 else:\r
2575 if not self.__GetMacroValue("OUTPUT_DIRECTORY") in FfsFileObj.FileName:\r
2576 #do case sensitive check for file path\r
2577 ErrorCode, ErrorInfo = PathClass(NormPath(FfsFileObj.FileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
2578 if ErrorCode != 0:\r
2579 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo) \r
2580\r
2581\r
2582 if not self.__IsToken( "}"):\r
2583 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2584\r
2585 ## __GetFileOpts() method\r
2586 #\r
2587 # Get options for FILE statement\r
2588 #\r
2589 # @param self The object pointer\r
2590 # @param FfsFileObj for whom options is got\r
2591 #\r
2592 def __GetFileOpts(self, FfsFileObj):\r
2593\r
2594 if self.__GetNextToken():\r
2595 Pattern = re.compile(r'([a-zA-Z0-9\-]+|\$\(TARGET\)|\*)_([a-zA-Z0-9\-]+|\$\(TOOL_CHAIN_TAG\)|\*)_([a-zA-Z0-9\-]+|\$\(ARCH\)|\*)')\r
2596 if Pattern.match(self.__Token):\r
2597 FfsFileObj.KeyStringList.append(self.__Token)\r
2598 if self.__IsToken(","):\r
2599 while self.__GetNextToken():\r
2600 if not Pattern.match(self.__Token):\r
2601 raise Warning("expected KeyString \"Target_Tag_Arch\"", self.FileName, self.CurrentLineNumber)\r
2602 FfsFileObj.KeyStringList.append(self.__Token)\r
2603\r
2604 if not self.__IsToken(","):\r
2605 break\r
2606\r
2607 else:\r
2608 self.__UndoToken()\r
2609\r
2610 if self.__IsKeyword( "FIXED", True):\r
2611 FfsFileObj.Fixed = True\r
2612\r
2613 if self.__IsKeyword( "CHECKSUM", True):\r
2614 FfsFileObj.CheckSum = True\r
2615\r
2616 if self.__GetAlignment():\r
2617 if self.__Token not in ("Auto", "8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
2618 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2619 #For FFS, Auto is default option same to ""\r
2620 if not self.__Token == "Auto":\r
2621 FfsFileObj.Alignment = self.__Token\r
2622\r
2623 ## __GetAlignment() method\r
2624 #\r
2625 # Return the alignment value\r
2626 #\r
2627 # @param self The object pointer\r
2628 # @retval True Successfully find alignment\r
2629 # @retval False Not able to find alignment\r
2630 #\r
2631 def __GetAlignment(self):\r
2632 if self.__IsKeyword( "Align", True):\r
2633 if not self.__IsToken( "="):\r
2634 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2635\r
2636 if not self.__GetNextToken():\r
2637 raise Warning("expected alignment value", self.FileName, self.CurrentLineNumber)\r
2638 return True\r
2639\r
2640 return False\r
2641\r
2642 ## __GetFilePart() method\r
2643 #\r
2644 # Get section data for FILE statement\r
2645 #\r
2646 # @param self The object pointer\r
2647 # @param FfsFileObj for whom section is got\r
2648 # @param MacroDict dictionary used to replace macro\r
2649 #\r
2650 def __GetSectionData(self, FfsFileObj, MacroDict = {}):\r
2651 Dict = {}\r
2652 Dict.update(MacroDict)\r
2653\r
2654 self.__GetDefineStatements(FfsFileObj)\r
2655\r
2656 Dict.update(FfsFileObj.DefineVarDict)\r
2657 self.__GetAprioriSection(FfsFileObj, Dict.copy())\r
2658 self.__GetAprioriSection(FfsFileObj, Dict.copy())\r
2659\r
2660 while True:\r
2661 IsLeafSection = self.__GetLeafSection(FfsFileObj, Dict)\r
2662 IsEncapSection = self.__GetEncapsulationSec(FfsFileObj)\r
2663 if not IsLeafSection and not IsEncapSection:\r
2664 break\r
2665\r
2666 ## __GetLeafSection() method\r
2667 #\r
2668 # Get leaf section for Obj\r
2669 #\r
2670 # @param self The object pointer\r
2671 # @param Obj for whom leaf section is got\r
2672 # @param MacroDict dictionary used to replace macro\r
2673 # @retval True Successfully find section statement\r
2674 # @retval False Not able to find section statement\r
2675 #\r
2676 def __GetLeafSection(self, Obj, MacroDict = {}):\r
2677\r
2678 OldPos = self.GetFileBufferPos()\r
2679\r
2680 if not self.__IsKeyword( "SECTION"):\r
2681 if len(Obj.SectionList) == 0:\r
2682 raise Warning("expected SECTION", self.FileName, self.CurrentLineNumber)\r
2683 else:\r
2684 return False\r
2685\r
2686 AlignValue = None\r
2687 if self.__GetAlignment():\r
2688 if self.__Token not in ("Auto", "8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
2689 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2690 AlignValue = self.__Token\r
2691\r
2692 BuildNum = None\r
2693 if self.__IsKeyword( "BUILD_NUM"):\r
2694 if not self.__IsToken( "="):\r
2695 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2696\r
2697 if not self.__GetNextToken():\r
2698 raise Warning("expected Build number value", self.FileName, self.CurrentLineNumber)\r
2699\r
2700 BuildNum = self.__Token\r
2701\r
2702 if self.__IsKeyword( "VERSION"):\r
2703 if AlignValue == 'Auto':\r
2704 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
2705 if not self.__IsToken( "="):\r
2706 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2707 if not self.__GetNextToken():\r
2708 raise Warning("expected version", self.FileName, self.CurrentLineNumber)\r
2709 VerSectionObj = VerSection.VerSection()\r
2710 VerSectionObj.Alignment = AlignValue\r
2711 VerSectionObj.BuildNum = BuildNum\r
2712 if self.__GetStringData():\r
2713 VerSectionObj.StringData = self.__Token\r
2714 else:\r
2715 VerSectionObj.FileName = self.__Token\r
2716 Obj.SectionList.append(VerSectionObj)\r
2717 \r
2718 elif self.__IsKeyword( "UI"):\r
2719 if AlignValue == 'Auto':\r
2720 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
2721 if not self.__IsToken( "="):\r
2722 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2723 if not self.__GetNextToken():\r
2724 raise Warning("expected UI", self.FileName, self.CurrentLineNumber)\r
2725 UiSectionObj = UiSection.UiSection()\r
2726 UiSectionObj.Alignment = AlignValue\r
2727 if self.__GetStringData():\r
2728 UiSectionObj.StringData = self.__Token\r
2729 else:\r
2730 UiSectionObj.FileName = self.__Token\r
2731 Obj.SectionList.append(UiSectionObj)\r
2732\r
2733 elif self.__IsKeyword( "FV_IMAGE"):\r
2734 if AlignValue == 'Auto':\r
2735 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
2736 if not self.__IsToken( "="):\r
2737 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2738 if not self.__GetNextToken():\r
2739 raise Warning("expected FV name or FV file path", self.FileName, self.CurrentLineNumber)\r
2740\r
2741 FvName = self.__Token\r
2742 FvObj = None\r
2743\r
2744 if self.__IsToken( "{"):\r
2745 FvObj = Fv.FV()\r
2746 FvObj.UiFvName = FvName.upper()\r
2747 self.__GetDefineStatements(FvObj)\r
2748 MacroDict.update(FvObj.DefineVarDict)\r
2749 self.__GetBlockStatement(FvObj)\r
2750 self.__GetSetStatements(FvObj)\r
2751 self.__GetFvAlignment(FvObj)\r
2752 self.__GetFvAttributes(FvObj)\r
2753 self.__GetAprioriSection(FvObj, MacroDict.copy())\r
2754 self.__GetAprioriSection(FvObj, MacroDict.copy())\r
2755\r
2756 while True:\r
2757 IsInf = self.__GetInfStatement(FvObj, MacroDict.copy())\r
2758 IsFile = self.__GetFileStatement(FvObj, MacroDict.copy())\r
2759 if not IsInf and not IsFile:\r
2760 break\r
2761\r
2762 if not self.__IsToken( "}"):\r
2763 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2764\r
2765 FvImageSectionObj = FvImageSection.FvImageSection()\r
2766 FvImageSectionObj.Alignment = AlignValue\r
2767 if FvObj != None:\r
2768 FvImageSectionObj.Fv = FvObj\r
2769 FvImageSectionObj.FvName = None\r
2770 else:\r
2771 FvImageSectionObj.FvName = FvName.upper()\r
2772 FvImageSectionObj.FvFileName = FvName\r
2773\r
2774 Obj.SectionList.append(FvImageSectionObj)\r
2775\r
2776 elif self.__IsKeyword("PEI_DEPEX_EXP") or self.__IsKeyword("DXE_DEPEX_EXP") or self.__IsKeyword("SMM_DEPEX_EXP"):\r
2777 if AlignValue == 'Auto':\r
2778 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
2779 DepexSectionObj = DepexSection.DepexSection()\r
2780 DepexSectionObj.Alignment = AlignValue\r
2781 DepexSectionObj.DepexType = self.__Token\r
2782\r
2783 if not self.__IsToken( "="):\r
2784 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2785 if not self.__IsToken( "{"):\r
2786 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2787 if not self.__SkipToToken( "}"):\r
2788 raise Warning("expected Depex expression ending '}'", self.FileName, self.CurrentLineNumber)\r
2789\r
2790 DepexSectionObj.Expression = self.__SkippedChars.rstrip('}')\r
2791 Obj.SectionList.append(DepexSectionObj)\r
2792\r
2793 else:\r
2794 if not self.__GetNextWord():\r
2795 raise Warning("expected section type", self.FileName, self.CurrentLineNumber)\r
2796\r
2797 # Encapsulation section appear, UndoToken and return\r
2798 if self.__Token == "COMPRESS" or self.__Token == "GUIDED":\r
2799 self.SetFileBufferPos(OldPos)\r
2800 return False\r
2801\r
2802 if self.__Token not in ("COMPAT16", "PE32", "PIC", "TE", "FV_IMAGE", "RAW", "DXE_DEPEX",\\r
2803 "UI", "VERSION", "PEI_DEPEX", "SUBTYPE_GUID", "SMM_DEPEX"):\r
2804 raise Warning("Unknown section type '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2805 if AlignValue == 'Auto'and (not self.__Token == 'PE32') and (not self.__Token == 'TE'):\r
2806 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
2807\r
2808 # DataSection\r
2809 DataSectionObj = DataSection.DataSection()\r
2810 DataSectionObj.Alignment = AlignValue\r
2811 DataSectionObj.SecType = self.__Token\r
2812\r
2813 if self.__IsKeyword('RELOCS_STRIPPED') or self.__IsKeyword('RELOCS_RETAINED'):\r
2814 if self.__FileCouldHaveRelocFlag(Obj.FvFileType) and self.__SectionCouldHaveRelocFlag(DataSectionObj.SecType):\r
2815 if self.__Token == 'RELOCS_STRIPPED':\r
2816 DataSectionObj.KeepReloc = False\r
2817 else:\r
2818 DataSectionObj.KeepReloc = True\r
2819 else:\r
2820 raise Warning("File type %s, section type %s, could not have reloc strip flag%d" % (Obj.FvFileType, DataSectionObj.SecType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
2821\r
2822 if self.__IsToken("="):\r
2823 if not self.__GetNextToken():\r
2824 raise Warning("expected section file path", self.FileName, self.CurrentLineNumber)\r
2825 DataSectionObj.SectFileName = self.__Token\r
2826 if DataSectionObj.SectFileName.replace('$(WORKSPACE)', '').find('$') == -1:\r
2827 #do case sensitive check for file path\r
2828 ErrorCode, ErrorInfo = PathClass(NormPath(DataSectionObj.SectFileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
2829 if ErrorCode != 0:\r
2830 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
2831 else:\r
2832 if not self.__GetCglSection(DataSectionObj):\r
2833 return False\r
2834\r
2835 Obj.SectionList.append(DataSectionObj)\r
2836\r
2837 return True\r
2838\r
2839 ## __GetCglSection() method\r
2840 #\r
2841 # Get compressed or GUIDed section for Obj\r
2842 #\r
2843 # @param self The object pointer\r
2844 # @param Obj for whom leaf section is got\r
2845 # @param AlignValue alignment value for complex section\r
2846 # @retval True Successfully find section statement\r
2847 # @retval False Not able to find section statement\r
2848 #\r
2849 def __GetCglSection(self, Obj, AlignValue = None):\r
2850\r
2851 if self.__IsKeyword( "COMPRESS"):\r
2852 type = "PI_STD"\r
2853 if self.__IsKeyword("PI_STD") or self.__IsKeyword("PI_NONE"):\r
2854 type = self.__Token\r
2855\r
2856 if not self.__IsToken("{"):\r
2857 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2858\r
2859 CompressSectionObj = CompressSection.CompressSection()\r
2860 CompressSectionObj.Alignment = AlignValue\r
2861 CompressSectionObj.CompType = type\r
2862 # Recursive sections...\r
2863 while True:\r
2864 IsLeafSection = self.__GetLeafSection(CompressSectionObj)\r
2865 IsEncapSection = self.__GetEncapsulationSec(CompressSectionObj)\r
2866 if not IsLeafSection and not IsEncapSection:\r
2867 break\r
2868\r
2869\r
2870 if not self.__IsToken( "}"):\r
2871 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2872 Obj.SectionList.append(CompressSectionObj)\r
2873\r
2874# else:\r
2875# raise Warning("Compress type not known")\r
2876\r
2877 return True\r
2878\r
2879 elif self.__IsKeyword( "GUIDED"):\r
2880 GuidValue = None\r
2881 if self.__GetNextGuid():\r
2882 GuidValue = self.__Token\r
2883\r
2884 AttribDict = self.__GetGuidAttrib()\r
2885 if not self.__IsToken("{"):\r
2886 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
2887 GuidSectionObj = GuidSection.GuidSection()\r
2888 GuidSectionObj.Alignment = AlignValue\r
2889 GuidSectionObj.NameGuid = GuidValue\r
2890 GuidSectionObj.SectionType = "GUIDED"\r
2891 GuidSectionObj.ProcessRequired = AttribDict["PROCESSING_REQUIRED"]\r
2892 GuidSectionObj.AuthStatusValid = AttribDict["AUTH_STATUS_VALID"]\r
2893 GuidSectionObj.ExtraHeaderSize = AttribDict["EXTRA_HEADER_SIZE"]\r
2894 # Recursive sections...\r
2895 while True:\r
2896 IsLeafSection = self.__GetLeafSection(GuidSectionObj)\r
2897 IsEncapSection = self.__GetEncapsulationSec(GuidSectionObj)\r
2898 if not IsLeafSection and not IsEncapSection:\r
2899 break\r
2900\r
2901 if not self.__IsToken( "}"):\r
2902 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
2903 Obj.SectionList.append(GuidSectionObj)\r
2904\r
2905 return True\r
2906\r
2907 return False\r
2908\r
2909 ## __GetGuidAttri() method\r
2910 #\r
2911 # Get attributes for GUID section\r
2912 #\r
2913 # @param self The object pointer\r
2914 # @retval AttribDict Dictionary of key-value pair of section attributes\r
2915 #\r
2916 def __GetGuidAttrib(self):\r
2917\r
2918 AttribDict = {}\r
2919 AttribDict["PROCESSING_REQUIRED"] = "NONE"\r
2920 AttribDict["AUTH_STATUS_VALID"] = "NONE"\r
2921 AttribDict["EXTRA_HEADER_SIZE"] = -1\r
2922 while self.__IsKeyword("PROCESSING_REQUIRED") or self.__IsKeyword("AUTH_STATUS_VALID") \\r
2923 or self.__IsKeyword("EXTRA_HEADER_SIZE"):\r
2924 AttribKey = self.__Token\r
2925\r
2926 if not self.__IsToken("="):\r
2927 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
2928\r
2929 if not self.__GetNextToken():\r
2930 raise Warning("expected TRUE(1)/FALSE(0)/Number", self.FileName, self.CurrentLineNumber)\r
2931 elif AttribKey == "EXTRA_HEADER_SIZE":\r
2932 Base = 10\r
2933 if self.__Token[0:2].upper() == "0X":\r
2934 Base = 16\r
2935 try:\r
2936 AttribDict[AttribKey] = int(self.__Token, Base)\r
2937 continue\r
2938 except ValueError:\r
2939 raise Warning("expected Number", self.FileName, self.CurrentLineNumber)\r
2940 elif self.__Token.upper() not in ("TRUE", "FALSE", "1", "0"):\r
2941 raise Warning("expected TRUE/FALSE (1/0)", self.FileName, self.CurrentLineNumber)\r
2942 AttribDict[AttribKey] = self.__Token\r
2943\r
2944 return AttribDict\r
2945\r
2946 ## __GetEncapsulationSec() method\r
2947 #\r
2948 # Get encapsulation section for FILE\r
2949 #\r
2950 # @param self The object pointer\r
2951 # @param FfsFile for whom section is got\r
2952 # @retval True Successfully find section statement\r
2953 # @retval False Not able to find section statement\r
2954 #\r
2955 def __GetEncapsulationSec(self, FfsFileObj):\r
2956\r
2957 OldPos = self.GetFileBufferPos()\r
2958 if not self.__IsKeyword( "SECTION"):\r
2959 if len(FfsFileObj.SectionList) == 0:\r
2960 raise Warning("expected SECTION", self.FileName, self.CurrentLineNumber)\r
2961 else:\r
2962 return False\r
2963\r
2964 AlignValue = None\r
2965 if self.__GetAlignment():\r
2966 if self.__Token not in ("8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
2967 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
2968 AlignValue = self.__Token\r
2969\r
2970 if not self.__GetCglSection(FfsFileObj, AlignValue):\r
2971 self.SetFileBufferPos(OldPos)\r
2972 return False\r
2973 else:\r
2974 return True\r
2975\r
2976 ## __GetCapsule() method\r
2977 #\r
2978 # Get capsule section contents and store its data into capsule list of self.Profile\r
2979 #\r
2980 # @param self The object pointer\r
2981 # @retval True Successfully find a capsule\r
2982 # @retval False Not able to find a capsule\r
2983 #\r
2984 def __GetCapsule(self):\r
2985\r
2986 if not self.__GetNextToken():\r
2987 return False\r
2988\r
2989 S = self.__Token.upper()\r
2990 if S.startswith("[") and not S.startswith("[CAPSULE."):\r
2991 if not S.startswith("[VTF.") and not S.startswith("[RULE.") and not S.startswith("[OPTIONROM."):\r
2992 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
2993 self.__UndoToken()\r
2994 return False\r
2995\r
2996 self.__UndoToken()\r
2997 if not self.__IsToken("[CAPSULE.", True):\r
2998 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
2999 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
3000 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
3001 raise Warning("expected [Capsule.]", self.FileName, self.CurrentLineNumber)\r
3002\r
3003 CapsuleObj = Capsule.Capsule()\r
3004\r
3005 CapsuleName = self.__GetUiName()\r
3006 if not CapsuleName:\r
3007 raise Warning("expected capsule name", self.FileName, self.CurrentLineNumber)\r
3008\r
3009 CapsuleObj.UiCapsuleName = CapsuleName.upper()\r
3010\r
3011 if not self.__IsToken( "]"):\r
3012 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
3013\r
3014 if self.__IsKeyword("CREATE_FILE"):\r
3015 if not self.__IsToken( "="):\r
3016 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3017\r
3018 if not self.__GetNextToken():\r
3019 raise Warning("expected file name", self.FileName, self.CurrentLineNumber)\r
3020\r
3021 CapsuleObj.CreateFile = self.__Token\r
3022\r
3023 self.__GetCapsuleStatements(CapsuleObj)\r
3024 self.Profile.CapsuleDict[CapsuleObj.UiCapsuleName] = CapsuleObj\r
3025 return True\r
3026\r
3027 ## __GetCapsuleStatements() method\r
3028 #\r
3029 # Get statements for capsule\r
3030 #\r
3031 # @param self The object pointer\r
3032 # @param Obj for whom statements are got\r
3033 #\r
3034 def __GetCapsuleStatements(self, Obj):\r
3035 self.__GetCapsuleTokens(Obj)\r
3036 self.__GetDefineStatements(Obj)\r
3037 self.__GetSetStatements(Obj)\r
3038 self.__GetCapsuleData(Obj)\r
3039\r
3040 ## __GetCapsuleTokens() method\r
3041 #\r
3042 # Get token statements for capsule\r
3043 #\r
3044 # @param self The object pointer\r
3045 # @param Obj for whom token statements are got\r
3046 #\r
3047 def __GetCapsuleTokens(self, Obj):\r
3048 if not self.__GetNextToken():\r
3049 return False\r
3050 while self.__Token in ("CAPSULE_GUID", "CAPSULE_HEADER_SIZE", "CAPSULE_FLAGS", "OEM_CAPSULE_FLAGS"):\r
3051 Name = self.__Token.strip()\r
3052 if not self.__IsToken("="):\r
3053 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3054 if not self.__GetNextToken():\r
3055 raise Warning("expected value", self.FileName, self.CurrentLineNumber)\r
3056 if Name == 'CAPSULE_FLAGS':\r
3057 if not self.__Token in ("PersistAcrossReset", "PopulateSystemTable", "InitiateReset"):\r
3058 raise Warning("expected PersistAcrossReset, PopulateSystemTable, or InitiateReset", self.FileName, self.CurrentLineNumber)\r
3059 Value = self.__Token.strip()\r
3060 while self.__IsToken(","):\r
3061 Value += ','\r
3062 if not self.__GetNextToken():\r
3063 raise Warning("expected value", self.FileName, self.CurrentLineNumber)\r
3064 if not self.__Token in ("PersistAcrossReset", "PopulateSystemTable", "InitiateReset"):\r
3065 raise Warning("expected PersistAcrossReset, PopulateSystemTable, or InitiateReset", self.FileName, self.CurrentLineNumber)\r
3066 Value += self.__Token.strip()\r
3067 elif Name == 'OEM_CAPSULE_FLAGS':\r
3068 Value = self.__Token.strip()\r
3069 try:\r
3070 Value = int(Value, 0)\r
3071 except ValueError:\r
3072 raise Warning("expected integer value between 0x0000 and 0xFFFF", self.FileName, self.CurrentLineNumber)\r
3073 if not 0x0000 <= Value <= 0xFFFF:\r
3074 raise Warning("expected integer value between 0x0000 and 0xFFFF", self.FileName, self.CurrentLineNumber)\r
3075 Value = self.__Token.strip()\r
3076 else:\r
3077 Value = self.__Token.strip()\r
3078 Obj.TokensDict[Name] = Value \r
3079 if not self.__GetNextToken():\r
3080 return False\r
3081 self.__UndoToken()\r
3082\r
3083 ## __GetCapsuleData() method\r
3084 #\r
3085 # Get capsule data for capsule\r
3086 #\r
3087 # @param self The object pointer\r
3088 # @param Obj for whom capsule data are got\r
3089 #\r
3090 def __GetCapsuleData(self, Obj):\r
3091\r
3092 while True:\r
3093 IsInf = self.__GetInfStatement(Obj, True)\r
3094 IsFile = self.__GetFileStatement(Obj, True)\r
3095 IsFv = self.__GetFvStatement(Obj)\r
3096 IsFd = self.__GetFdStatement(Obj)\r
3097 IsAnyFile = self.__GetAnyFileStatement(Obj)\r
3098 if not (IsInf or IsFile or IsFv or IsFd or IsAnyFile):\r
3099 break\r
3100\r
3101 ## __GetFvStatement() method\r
3102 #\r
3103 # Get FV for capsule\r
3104 #\r
3105 # @param self The object pointer\r
3106 # @param CapsuleObj for whom FV is got\r
3107 # @retval True Successfully find a FV statement\r
3108 # @retval False Not able to find a FV statement\r
3109 #\r
3110 def __GetFvStatement(self, CapsuleObj):\r
3111\r
3112 if not self.__IsKeyword("FV"):\r
3113 return False\r
3114\r
3115 if not self.__IsToken("="):\r
3116 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3117\r
3118 if not self.__GetNextToken():\r
3119 raise Warning("expected FV name", self.FileName, self.CurrentLineNumber)\r
3120\r
3121 if self.__Token.upper() not in self.Profile.FvDict.keys():\r
3122 raise Warning("FV name does not exist", self.FileName, self.CurrentLineNumber)\r
3123\r
3124 CapsuleFv = CapsuleData.CapsuleFv()\r
3125 CapsuleFv.FvName = self.__Token\r
3126 CapsuleObj.CapsuleDataList.append(CapsuleFv)\r
3127 return True\r
3128\r
3129 ## __GetFdStatement() method\r
3130 #\r
3131 # Get FD for capsule\r
3132 #\r
3133 # @param self The object pointer\r
3134 # @param CapsuleObj for whom FD is got\r
3135 # @retval True Successfully find a FD statement\r
3136 # @retval False Not able to find a FD statement\r
3137 #\r
3138 def __GetFdStatement(self, CapsuleObj):\r
3139\r
3140 if not self.__IsKeyword("FD"):\r
3141 return False\r
3142\r
3143 if not self.__IsToken("="):\r
3144 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3145\r
3146 if not self.__GetNextToken():\r
3147 raise Warning("expected FD name", self.FileName, self.CurrentLineNumber)\r
3148\r
3149 if self.__Token.upper() not in self.Profile.FdDict.keys():\r
3150 raise Warning("FD name does not exist", self.FileName, self.CurrentLineNumber)\r
3151\r
3152 CapsuleFd = CapsuleData.CapsuleFd()\r
3153 CapsuleFd.FdName = self.__Token\r
3154 CapsuleObj.CapsuleDataList.append(CapsuleFd)\r
3155 return True\r
3156\r
3157 ## __GetAnyFileStatement() method\r
3158 #\r
3159 # Get AnyFile for capsule\r
3160 #\r
3161 # @param self The object pointer\r
3162 # @param CapsuleObj for whom AnyFile is got\r
3163 # @retval True Successfully find a Anyfile statement\r
3164 # @retval False Not able to find a AnyFile statement\r
3165 #\r
3166 def __GetAnyFileStatement(self, CapsuleObj):\r
3167\r
3168 if not self.__IsKeyword("FILE"):\r
3169 return False\r
3170\r
3171 if not self.__IsKeyword("DATA"):\r
3172 self.__UndoToken()\r
3173 return False\r
3174\r
3175 if not self.__IsToken("="):\r
3176 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3177\r
3178 if not self.__GetNextToken():\r
3179 raise Warning("expected File name", self.FileName, self.CurrentLineNumber)\r
3180 \r
3181 AnyFileName = self.__Token\r
3182 AnyFileName = GenFdsGlobalVariable.ReplaceWorkspaceMacro(AnyFileName)\r
3183 if not os.path.exists(AnyFileName):\r
3184 raise Warning("File %s not exists"%AnyFileName, self.FileName, self.CurrentLineNumber)\r
3185\r
3186 CapsuleAnyFile = CapsuleData.CapsuleAnyFile()\r
3187 CapsuleAnyFile.FileName = AnyFileName\r
3188 CapsuleObj.CapsuleDataList.append(CapsuleAnyFile)\r
3189 return True\r
3190\r
3191 ## __GetRule() method\r
3192 #\r
3193 # Get Rule section contents and store its data into rule list of self.Profile\r
3194 #\r
3195 # @param self The object pointer\r
3196 # @retval True Successfully find a Rule\r
3197 # @retval False Not able to find a Rule\r
3198 #\r
3199 def __GetRule(self):\r
3200\r
3201 if not self.__GetNextToken():\r
3202 return False\r
3203\r
3204 S = self.__Token.upper()\r
3205 if S.startswith("[") and not S.startswith("[RULE."):\r
3206 if not S.startswith("[OPTIONROM."):\r
3207 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
3208 self.__UndoToken()\r
3209 return False\r
3210 self.__UndoToken()\r
3211 if not self.__IsToken("[Rule.", True):\r
3212 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
3213 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
3214 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
3215 raise Warning("expected [Rule.]", self.FileName, self.CurrentLineNumber)\r
3216\r
3217 if not self.__SkipToToken("."):\r
3218 raise Warning("expected '.'", self.FileName, self.CurrentLineNumber)\r
3219\r
3220 Arch = self.__SkippedChars.rstrip(".")\r
3221 if Arch.upper() not in ("IA32", "X64", "IPF", "EBC", "ARM", "AARCH64", "COMMON"):\r
3222 raise Warning("Unknown Arch '%s'" % Arch, self.FileName, self.CurrentLineNumber)\r
3223\r
3224 ModuleType = self.__GetModuleType()\r
3225\r
3226 TemplateName = ""\r
3227 if self.__IsToken("."):\r
3228 if not self.__GetNextWord():\r
3229 raise Warning("expected template name", self.FileName, self.CurrentLineNumber)\r
3230 TemplateName = self.__Token\r
3231\r
3232 if not self.__IsToken( "]"):\r
3233 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
3234\r
3235 RuleObj = self.__GetRuleFileStatements()\r
3236 RuleObj.Arch = Arch.upper()\r
3237 RuleObj.ModuleType = ModuleType\r
3238 RuleObj.TemplateName = TemplateName\r
3239 if TemplateName == '' :\r
3240 self.Profile.RuleDict['RULE' + \\r
3241 '.' + \\r
3242 Arch.upper() + \\r
3243 '.' + \\r
3244 ModuleType.upper() ] = RuleObj\r
3245 else :\r
3246 self.Profile.RuleDict['RULE' + \\r
3247 '.' + \\r
3248 Arch.upper() + \\r
3249 '.' + \\r
3250 ModuleType.upper() + \\r
3251 '.' + \\r
3252 TemplateName.upper() ] = RuleObj\r
3253# self.Profile.RuleList.append(rule)\r
3254 return True\r
3255\r
3256 ## __GetModuleType() method\r
3257 #\r
3258 # Return the module type\r
3259 #\r
3260 # @param self The object pointer\r
3261 # @retval string module type\r
3262 #\r
3263 def __GetModuleType(self):\r
3264\r
3265 if not self.__GetNextWord():\r
3266 raise Warning("expected Module type", self.FileName, self.CurrentLineNumber)\r
3267 if self.__Token.upper() not in ("SEC", "PEI_CORE", "PEIM", "DXE_CORE", \\r
3268 "DXE_DRIVER", "DXE_SAL_DRIVER", \\r
3269 "DXE_SMM_DRIVER", "DXE_RUNTIME_DRIVER", \\r
3270 "UEFI_DRIVER", "UEFI_APPLICATION", "USER_DEFINED", "DEFAULT", "BASE", \\r
3271 "SECURITY_CORE", "COMBINED_PEIM_DRIVER", "PIC_PEIM", "RELOCATABLE_PEIM", \\r
3272 "PE32_PEIM", "BS_DRIVER", "RT_DRIVER", "SAL_RT_DRIVER", "APPLICATION", "ACPITABLE", "SMM_CORE"):\r
3273 raise Warning("Unknown Module type '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3274 return self.__Token\r
3275\r
3276 ## __GetFileExtension() method\r
3277 #\r
3278 # Return the file extension\r
3279 #\r
3280 # @param self The object pointer\r
3281 # @retval string file name extension\r
3282 #\r
3283 def __GetFileExtension(self):\r
3284 if not self.__IsToken("."):\r
3285 raise Warning("expected '.'", self.FileName, self.CurrentLineNumber)\r
3286\r
3287 Ext = ""\r
3288 if self.__GetNextToken():\r
3289 Pattern = re.compile(r'([a-zA-Z][a-zA-Z0-9]*)')\r
3290 if Pattern.match(self.__Token):\r
3291 Ext = self.__Token\r
3292 return '.' + Ext\r
3293 else:\r
3294 raise Warning("Unknown file extension '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3295\r
3296 else:\r
3297 raise Warning("expected file extension", self.FileName, self.CurrentLineNumber)\r
3298\r
3299 ## __GetRuleFileStatement() method\r
3300 #\r
3301 # Get rule contents\r
3302 #\r
3303 # @param self The object pointer\r
3304 # @retval Rule Rule object\r
3305 #\r
3306 def __GetRuleFileStatements(self):\r
3307\r
3308 if not self.__IsKeyword("FILE"):\r
3309 raise Warning("expected FILE", self.FileName, self.CurrentLineNumber)\r
3310\r
3311 if not self.__GetNextWord():\r
3312 raise Warning("expected FFS type", self.FileName, self.CurrentLineNumber)\r
3313\r
3314 Type = self.__Token.strip().upper()\r
3315 if Type not in ("RAW", "FREEFORM", "SEC", "PEI_CORE", "PEIM",\\r
3316 "PEI_DXE_COMBO", "DRIVER", "DXE_CORE", "APPLICATION", "FV_IMAGE", "SMM", "SMM_CORE"):\r
3317 raise Warning("Unknown FV type '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3318\r
3319 if not self.__IsToken("="):\r
3320 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3321\r
3322 if not self.__IsKeyword("$(NAMED_GUID)"):\r
3323 if not self.__GetNextWord():\r
3324 raise Warning("expected $(NAMED_GUID)", self.FileName, self.CurrentLineNumber)\r
3325 if self.__Token == 'PCD':\r
3326 if not self.__IsToken( "("):\r
3327 raise Warning("expected '('", self.FileName, self.CurrentLineNumber)\r
3328 PcdPair = self.__GetNextPcdName()\r
3329 if not self.__IsToken( ")"):\r
3330 raise Warning("expected ')'", self.FileName, self.CurrentLineNumber)\r
3331 self.__Token = 'PCD('+PcdPair[1]+'.'+PcdPair[0]+')'\r
3332 \r
3333 NameGuid = self.__Token\r
3334\r
3335 KeepReloc = None\r
3336 if self.__IsKeyword('RELOCS_STRIPPED') or self.__IsKeyword('RELOCS_RETAINED'):\r
3337 if self.__FileCouldHaveRelocFlag(Type):\r
3338 if self.__Token == 'RELOCS_STRIPPED':\r
3339 KeepReloc = False\r
3340 else:\r
3341 KeepReloc = True\r
3342 else:\r
3343 raise Warning("File type %s could not have reloc strip flag%d" % (Type, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
3344\r
3345 KeyStringList = []\r
3346 if self.__GetNextToken():\r
3347 Pattern = re.compile(r'([a-zA-Z0-9\-]+|\$\(TARGET\)|\*)_([a-zA-Z0-9\-]+|\$\(TOOL_CHAIN_TAG\)|\*)_([a-zA-Z0-9\-]+|\$\(ARCH\)|\*)')\r
3348 if Pattern.match(self.__Token):\r
3349 KeyStringList.append(self.__Token)\r
3350 if self.__IsToken(","):\r
3351 while self.__GetNextToken():\r
3352 if not Pattern.match(self.__Token):\r
3353 raise Warning("expected KeyString \"Target_Tag_Arch\"", self.FileName, self.CurrentLineNumber)\r
3354 KeyStringList.append(self.__Token)\r
3355\r
3356 if not self.__IsToken(","):\r
3357 break\r
3358\r
3359 else:\r
3360 self.__UndoToken()\r
3361\r
3362\r
3363 Fixed = False\r
3364 if self.__IsKeyword("Fixed", True):\r
3365 Fixed = True\r
3366\r
3367 CheckSum = False\r
3368 if self.__IsKeyword("CheckSum", True):\r
3369 CheckSum = True\r
3370\r
3371 AlignValue = ""\r
3372 if self.__GetAlignment():\r
3373 if self.__Token not in ("Auto", "8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
3374 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3375 #For FFS, Auto is default option same to ""\r
3376 if not self.__Token == "Auto":\r
3377 AlignValue = self.__Token\r
3378\r
3379 if self.__IsToken("{"):\r
3380 # Complex file rule expected\r
3381 Rule = RuleComplexFile.RuleComplexFile()\r
3382 Rule.FvFileType = Type\r
3383 Rule.NameGuid = NameGuid\r
3384 Rule.Alignment = AlignValue\r
3385 Rule.CheckSum = CheckSum\r
3386 Rule.Fixed = Fixed\r
3387 Rule.KeyStringList = KeyStringList\r
3388 if KeepReloc != None:\r
3389 Rule.KeepReloc = KeepReloc\r
3390\r
3391 while True:\r
3392 IsEncapsulate = self.__GetRuleEncapsulationSection(Rule)\r
3393 IsLeaf = self.__GetEfiSection(Rule)\r
3394 if not IsEncapsulate and not IsLeaf:\r
3395 break\r
3396\r
3397 if not self.__IsToken("}"):\r
3398 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
3399\r
3400 return Rule\r
3401\r
3402 else:\r
3403 # Simple file rule expected\r
3404 if not self.__GetNextWord():\r
3405 raise Warning("expected leaf section type", self.FileName, self.CurrentLineNumber)\r
3406\r
3407 SectionName = self.__Token\r
3408\r
3409 if SectionName not in ("COMPAT16", "PE32", "PIC", "TE", "FV_IMAGE", "RAW", "DXE_DEPEX",\\r
3410 "UI", "PEI_DEPEX", "VERSION", "SUBTYPE_GUID", "SMM_DEPEX"):\r
3411 raise Warning("Unknown leaf section name '%s'" % SectionName, self.FileName, self.CurrentLineNumber)\r
3412\r
3413\r
3414 if self.__IsKeyword("Fixed", True):\r
3415 Fixed = True\r
3416\r
3417 if self.__IsKeyword("CheckSum", True):\r
3418 CheckSum = True\r
3419\r
3420 SectAlignment = ""\r
3421 if self.__GetAlignment():\r
3422 if self.__Token not in ("Auto", "8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
3423 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3424 if self.__Token == 'Auto' and (not SectionName == 'PE32') and (not SectionName == 'TE'):\r
3425 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
3426 SectAlignment = self.__Token\r
3427\r
3428 Ext = None\r
3429 if self.__IsToken('|'):\r
3430 Ext = self.__GetFileExtension()\r
3431 elif not self.__GetNextToken():\r
3432 raise Warning("expected File name", self.FileName, self.CurrentLineNumber)\r
3433\r
3434 Rule = RuleSimpleFile.RuleSimpleFile()\r
3435 Rule.SectionType = SectionName\r
3436 Rule.FvFileType = Type\r
3437 Rule.NameGuid = NameGuid\r
3438 Rule.Alignment = AlignValue\r
3439 Rule.SectAlignment = SectAlignment\r
3440 Rule.CheckSum = CheckSum\r
3441 Rule.Fixed = Fixed\r
3442 Rule.KeyStringList = KeyStringList\r
3443 if KeepReloc != None:\r
3444 Rule.KeepReloc = KeepReloc\r
3445 Rule.FileExtension = Ext\r
3446 Rule.FileName = self.__Token\r
3447 return Rule\r
3448\r
3449 ## __GetEfiSection() method\r
3450 #\r
3451 # Get section list for Rule\r
3452 #\r
3453 # @param self The object pointer\r
3454 # @param Obj for whom section is got\r
3455 # @retval True Successfully find section statement\r
3456 # @retval False Not able to find section statement\r
3457 #\r
3458 def __GetEfiSection(self, Obj):\r
3459\r
3460 OldPos = self.GetFileBufferPos()\r
3461 if not self.__GetNextWord():\r
3462 return False\r
3463 SectionName = self.__Token\r
3464\r
3465 if SectionName not in ("COMPAT16", "PE32", "PIC", "TE", "FV_IMAGE", "RAW", "DXE_DEPEX",\\r
3466 "UI", "VERSION", "PEI_DEPEX", "GUID", "SMM_DEPEX"):\r
3467 self.__UndoToken()\r
3468 return False\r
3469\r
3470 if SectionName == "FV_IMAGE":\r
3471 FvImageSectionObj = FvImageSection.FvImageSection()\r
3472 if self.__IsKeyword("FV_IMAGE"):\r
3473 pass\r
3474 if self.__IsToken( "{"):\r
3475 FvObj = Fv.FV()\r
3476 self.__GetDefineStatements(FvObj)\r
3477 self.__GetBlockStatement(FvObj)\r
3478 self.__GetSetStatements(FvObj)\r
3479 self.__GetFvAlignment(FvObj)\r
3480 self.__GetFvAttributes(FvObj)\r
3481 self.__GetAprioriSection(FvObj)\r
3482 self.__GetAprioriSection(FvObj)\r
3483\r
3484 while True:\r
3485 IsInf = self.__GetInfStatement(FvObj)\r
3486 IsFile = self.__GetFileStatement(FvObj)\r
3487 if not IsInf and not IsFile:\r
3488 break\r
3489\r
3490 if not self.__IsToken( "}"):\r
3491 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
3492 FvImageSectionObj.Fv = FvObj\r
3493 FvImageSectionObj.FvName = None\r
3494\r
3495 else:\r
3496 if not self.__IsKeyword("FV"):\r
3497 raise Warning("expected 'FV'", self.FileName, self.CurrentLineNumber)\r
3498 FvImageSectionObj.FvFileType = self.__Token\r
3499\r
3500 if self.__GetAlignment():\r
3501 if self.__Token not in ("8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
3502 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3503 FvImageSectionObj.Alignment = self.__Token\r
3504\r
3505 if self.__IsToken('|'):\r
3506 FvImageSectionObj.FvFileExtension = self.__GetFileExtension()\r
3507 elif self.__GetNextToken():\r
3508 if self.__Token not in ("}", "COMPAT16", "PE32", "PIC", "TE", "FV_IMAGE", "RAW", "DXE_DEPEX",\\r
3509 "UI", "VERSION", "PEI_DEPEX", "GUID", "SMM_DEPEX"):\r
3510 FvImageSectionObj.FvFileName = self.__Token\r
3511 else:\r
3512 self.__UndoToken()\r
3513 else:\r
3514 raise Warning("expected FV file name", self.FileName, self.CurrentLineNumber)\r
3515\r
3516 Obj.SectionList.append(FvImageSectionObj)\r
3517 return True\r
3518\r
3519 EfiSectionObj = EfiSection.EfiSection()\r
3520 EfiSectionObj.SectionType = SectionName\r
3521\r
3522 if not self.__GetNextToken():\r
3523 raise Warning("expected file type", self.FileName, self.CurrentLineNumber)\r
3524\r
3525 if self.__Token == "STRING":\r
3526 if not self.__RuleSectionCouldHaveString(EfiSectionObj.SectionType):\r
3527 raise Warning("%s section could NOT have string data%d" % (EfiSectionObj.SectionType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
3528\r
3529 if not self.__IsToken('='):\r
3530 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3531\r
3532 if not self.__GetNextToken():\r
3533 raise Warning("expected Quoted String", self.FileName, self.CurrentLineNumber)\r
3534\r
3535 if self.__GetStringData():\r
3536 EfiSectionObj.StringData = self.__Token\r
3537\r
3538 if self.__IsKeyword("BUILD_NUM"):\r
3539 if not self.__RuleSectionCouldHaveBuildNum(EfiSectionObj.SectionType):\r
3540 raise Warning("%s section could NOT have BUILD_NUM%d" % (EfiSectionObj.SectionType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
3541\r
3542 if not self.__IsToken("="):\r
3543 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3544 if not self.__GetNextToken():\r
3545 raise Warning("expected Build number", self.FileName, self.CurrentLineNumber)\r
3546 EfiSectionObj.BuildNum = self.__Token\r
3547\r
3548 else:\r
3549 EfiSectionObj.FileType = self.__Token\r
3550 self.__CheckRuleSectionFileType(EfiSectionObj.SectionType, EfiSectionObj.FileType)\r
3551\r
3552 if self.__IsKeyword("Optional"):\r
3553 if not self.__RuleSectionCouldBeOptional(EfiSectionObj.SectionType):\r
3554 raise Warning("%s section could NOT be optional%d" % (EfiSectionObj.SectionType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
3555 EfiSectionObj.Optional = True\r
3556\r
3557 if self.__IsKeyword("BUILD_NUM"):\r
3558 if not self.__RuleSectionCouldHaveBuildNum(EfiSectionObj.SectionType):\r
3559 raise Warning("%s section could NOT have BUILD_NUM%d" % (EfiSectionObj.SectionType, self.CurrentLineNumber), self.FileName, self.CurrentLineNumber)\r
3560\r
3561 if not self.__IsToken("="):\r
3562 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3563 if not self.__GetNextToken():\r
3564 raise Warning("expected Build number", self.FileName, self.CurrentLineNumber)\r
3565 EfiSectionObj.BuildNum = self.__Token\r
3566\r
3567 if self.__GetAlignment():\r
3568 if self.__Token not in ("Auto", "8", "16", "32", "64", "128", "512", "1K", "4K", "32K" ,"64K"):\r
3569 raise Warning("Incorrect alignment '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3570 if self.__Token == 'Auto' and (not SectionName == 'PE32') and (not SectionName == 'TE'):\r
3571 raise Warning("Auto alignment can only be used in PE32 or TE section ", self.FileName, self.CurrentLineNumber)\r
3572 EfiSectionObj.Alignment = self.__Token\r
3573\r
3574 if self.__IsKeyword('RELOCS_STRIPPED') or self.__IsKeyword('RELOCS_RETAINED'):\r
3575 if self.__SectionCouldHaveRelocFlag(EfiSectionObj.SectionType):\r
3576 if self.__Token == 'RELOCS_STRIPPED':\r
3577 EfiSectionObj.KeepReloc = False\r
3578 else:\r
3579 EfiSectionObj.KeepReloc = True\r
3580 if Obj.KeepReloc != None and Obj.KeepReloc != EfiSectionObj.KeepReloc:\r
3581 raise Warning("Section type %s has reloc strip flag conflict with Rule" % EfiSectionObj.SectionType, self.FileName, self.CurrentLineNumber)\r
3582 else:\r
3583 raise Warning("Section type %s could not have reloc strip flag" % EfiSectionObj.SectionType, self.FileName, self.CurrentLineNumber)\r
3584\r
3585\r
3586 if self.__IsToken('|'):\r
3587 EfiSectionObj.FileExtension = self.__GetFileExtension()\r
3588 elif self.__GetNextToken():\r
3589 if self.__Token not in ("}", "COMPAT16", "PE32", "PIC", "TE", "FV_IMAGE", "RAW", "DXE_DEPEX",\\r
3590 "UI", "VERSION", "PEI_DEPEX", "GUID", "SMM_DEPEX"):\r
3591 \r
3592 if self.__Token.startswith('PCD'):\r
3593 self.__UndoToken()\r
3594 self.__GetNextWord()\r
3595 \r
3596 if self.__Token == 'PCD':\r
3597 if not self.__IsToken( "("):\r
3598 raise Warning("expected '('", self.FileName, self.CurrentLineNumber)\r
3599 PcdPair = self.__GetNextPcdName()\r
3600 if not self.__IsToken( ")"):\r
3601 raise Warning("expected ')'", self.FileName, self.CurrentLineNumber)\r
3602 self.__Token = 'PCD('+PcdPair[1]+'.'+PcdPair[0]+')'\r
3603 \r
3604 EfiSectionObj.FileName = self.__Token \r
3605 \r
3606 else:\r
3607 self.__UndoToken()\r
3608 else:\r
3609 raise Warning("expected section file name", self.FileName, self.CurrentLineNumber)\r
3610\r
3611 Obj.SectionList.append(EfiSectionObj)\r
3612 return True\r
3613\r
3614 ## __RuleSectionCouldBeOptional() method\r
3615 #\r
3616 # Get whether a section could be optional\r
3617 #\r
3618 # @param self The object pointer\r
3619 # @param SectionType The section type to check\r
3620 # @retval True section could be optional\r
3621 # @retval False section never optional\r
3622 #\r
3623 def __RuleSectionCouldBeOptional(self, SectionType):\r
3624 if SectionType in ("DXE_DEPEX", "UI", "VERSION", "PEI_DEPEX", "RAW", "SMM_DEPEX"):\r
3625 return True\r
3626 else:\r
3627 return False\r
3628\r
3629 ## __RuleSectionCouldHaveBuildNum() method\r
3630 #\r
3631 # Get whether a section could have build number information\r
3632 #\r
3633 # @param self The object pointer\r
3634 # @param SectionType The section type to check\r
3635 # @retval True section could have build number information\r
3636 # @retval False section never have build number information\r
3637 #\r
3638 def __RuleSectionCouldHaveBuildNum(self, SectionType):\r
3639 if SectionType in ("VERSION"):\r
3640 return True\r
3641 else:\r
3642 return False\r
3643\r
3644 ## __RuleSectionCouldHaveString() method\r
3645 #\r
3646 # Get whether a section could have string\r
3647 #\r
3648 # @param self The object pointer\r
3649 # @param SectionType The section type to check\r
3650 # @retval True section could have string\r
3651 # @retval False section never have string\r
3652 #\r
3653 def __RuleSectionCouldHaveString(self, SectionType):\r
3654 if SectionType in ("UI", "VERSION"):\r
3655 return True\r
3656 else:\r
3657 return False\r
3658\r
3659 ## __CheckRuleSectionFileType() method\r
3660 #\r
3661 # Get whether a section matches a file type\r
3662 #\r
3663 # @param self The object pointer\r
3664 # @param SectionType The section type to check\r
3665 # @param FileType The file type to check\r
3666 #\r
3667 def __CheckRuleSectionFileType(self, SectionType, FileType):\r
3668 if SectionType == "COMPAT16":\r
3669 if FileType not in ("COMPAT16", "SEC_COMPAT16"):\r
3670 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3671 elif SectionType == "PE32":\r
3672 if FileType not in ("PE32", "SEC_PE32"):\r
3673 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3674 elif SectionType == "PIC":\r
3675 if FileType not in ("PIC", "PIC"):\r
3676 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3677 elif SectionType == "TE":\r
3678 if FileType not in ("TE", "SEC_TE"):\r
3679 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3680 elif SectionType == "RAW":\r
3681 if FileType not in ("BIN", "SEC_BIN", "RAW", "ASL", "ACPI"):\r
3682 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3683 elif SectionType == "DXE_DEPEX" or SectionType == "SMM_DEPEX":\r
3684 if FileType not in ("DXE_DEPEX", "SEC_DXE_DEPEX", "SMM_DEPEX"):\r
3685 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3686 elif SectionType == "UI":\r
3687 if FileType not in ("UI", "SEC_UI"):\r
3688 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3689 elif SectionType == "VERSION":\r
3690 if FileType not in ("VERSION", "SEC_VERSION"):\r
3691 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3692 elif SectionType == "PEI_DEPEX":\r
3693 if FileType not in ("PEI_DEPEX", "SEC_PEI_DEPEX"):\r
3694 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3695 elif SectionType == "GUID":\r
3696 if FileType not in ("PE32", "SEC_GUID"):\r
3697 raise Warning("Incorrect section file type '%s'" % FileType, self.FileName, self.CurrentLineNumber)\r
3698\r
3699 ## __GetRuleEncapsulationSection() method\r
3700 #\r
3701 # Get encapsulation section for Rule\r
3702 #\r
3703 # @param self The object pointer\r
3704 # @param Rule for whom section is got\r
3705 # @retval True Successfully find section statement\r
3706 # @retval False Not able to find section statement\r
3707 #\r
3708 def __GetRuleEncapsulationSection(self, Rule):\r
3709\r
3710 if self.__IsKeyword( "COMPRESS"):\r
3711 Type = "PI_STD"\r
3712 if self.__IsKeyword("PI_STD") or self.__IsKeyword("PI_NONE"):\r
3713 Type = self.__Token\r
3714\r
3715 if not self.__IsToken("{"):\r
3716 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
3717\r
3718 CompressSectionObj = CompressSection.CompressSection()\r
3719\r
3720 CompressSectionObj.CompType = Type\r
3721 # Recursive sections...\r
3722 while True:\r
3723 IsEncapsulate = self.__GetRuleEncapsulationSection(CompressSectionObj)\r
3724 IsLeaf = self.__GetEfiSection(CompressSectionObj)\r
3725 if not IsEncapsulate and not IsLeaf:\r
3726 break\r
3727\r
3728 if not self.__IsToken( "}"):\r
3729 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
3730 Rule.SectionList.append(CompressSectionObj)\r
3731\r
3732 return True\r
3733\r
3734 elif self.__IsKeyword( "GUIDED"):\r
3735 GuidValue = None\r
3736 if self.__GetNextGuid():\r
3737 GuidValue = self.__Token\r
3738\r
3739 if self.__IsKeyword( "$(NAMED_GUID)"):\r
3740 GuidValue = self.__Token\r
3741\r
3742 AttribDict = self.__GetGuidAttrib()\r
3743\r
3744 if not self.__IsToken("{"):\r
3745 raise Warning("expected '{'", self.FileName, self.CurrentLineNumber)\r
3746 GuidSectionObj = GuidSection.GuidSection()\r
3747 GuidSectionObj.NameGuid = GuidValue\r
3748 GuidSectionObj.SectionType = "GUIDED"\r
3749 GuidSectionObj.ProcessRequired = AttribDict["PROCESSING_REQUIRED"]\r
3750 GuidSectionObj.AuthStatusValid = AttribDict["AUTH_STATUS_VALID"]\r
3751 GuidSectionObj.ExtraHeaderSize = AttribDict["EXTRA_HEADER_SIZE"]\r
3752\r
3753 # Efi sections...\r
3754 while True:\r
3755 IsEncapsulate = self.__GetRuleEncapsulationSection(GuidSectionObj)\r
3756 IsLeaf = self.__GetEfiSection(GuidSectionObj)\r
3757 if not IsEncapsulate and not IsLeaf:\r
3758 break\r
3759\r
3760 if not self.__IsToken( "}"):\r
3761 raise Warning("expected '}'", self.FileName, self.CurrentLineNumber)\r
3762 Rule.SectionList.append(GuidSectionObj)\r
3763\r
3764 return True\r
3765\r
3766 return False\r
3767\r
3768 ## __GetVtf() method\r
3769 #\r
3770 # Get VTF section contents and store its data into VTF list of self.Profile\r
3771 #\r
3772 # @param self The object pointer\r
3773 # @retval True Successfully find a VTF\r
3774 # @retval False Not able to find a VTF\r
3775 #\r
3776 def __GetVtf(self):\r
3777\r
3778 if not self.__GetNextToken():\r
3779 return False\r
3780\r
3781 S = self.__Token.upper()\r
3782 if S.startswith("[") and not S.startswith("[VTF."):\r
3783 if not S.startswith("[RULE.") and not S.startswith("[OPTIONROM."):\r
3784 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
3785 self.__UndoToken()\r
3786 return False\r
3787\r
3788 self.__UndoToken()\r
3789 if not self.__IsToken("[VTF.", True):\r
3790 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
3791 #print 'Parsing String: %s in File %s, At line: %d, Offset Within Line: %d' \\r
3792 # % (self.Profile.FileLinesList[self.CurrentLineNumber - 1][self.CurrentOffsetWithinLine :], FileLineTuple[0], FileLineTuple[1], self.CurrentOffsetWithinLine)\r
3793 raise Warning("expected [VTF.]", self.FileName, self.CurrentLineNumber)\r
3794\r
3795 if not self.__SkipToToken("."):\r
3796 raise Warning("expected '.'", self.FileName, self.CurrentLineNumber)\r
3797\r
3798 Arch = self.__SkippedChars.rstrip(".").upper()\r
3799 if Arch not in ("IA32", "X64", "IPF", "ARM", "AARCH64"):\r
3800 raise Warning("Unknown Arch '%s'" % Arch, self.FileName, self.CurrentLineNumber)\r
3801\r
3802 if not self.__GetNextWord():\r
3803 raise Warning("expected VTF name", self.FileName, self.CurrentLineNumber)\r
3804 Name = self.__Token.upper()\r
3805\r
3806 VtfObj = Vtf.Vtf()\r
3807 VtfObj.UiName = Name\r
3808 VtfObj.KeyArch = Arch\r
3809\r
3810 if self.__IsToken(","):\r
3811 if not self.__GetNextWord():\r
3812 raise Warning("expected Arch list", self.FileName, self.CurrentLineNumber)\r
3813 if self.__Token.upper() not in ("IA32", "X64", "IPF", "ARM", "AARCH64"):\r
3814 raise Warning("Unknown Arch '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3815 VtfObj.ArchList = self.__Token.upper()\r
3816\r
3817 if not self.__IsToken( "]"):\r
3818 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
3819\r
3820 if self.__IsKeyword("IA32_RST_BIN"):\r
3821 if not self.__IsToken("="):\r
3822 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3823\r
3824 if not self.__GetNextToken():\r
3825 raise Warning("expected Reset file", self.FileName, self.CurrentLineNumber)\r
3826\r
3827 VtfObj.ResetBin = self.__Token\r
3828 if VtfObj.ResetBin.replace('$(WORKSPACE)', '').find('$') == -1:\r
3829 #check for file path\r
3830 ErrorCode, ErrorInfo = PathClass(NormPath(VtfObj.ResetBin), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
3831 if ErrorCode != 0:\r
3832 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
3833\r
3834 while self.__GetComponentStatement(VtfObj):\r
3835 pass\r
3836\r
3837 self.Profile.VtfList.append(VtfObj)\r
3838 return True\r
3839\r
3840 ## __GetComponentStatement() method\r
3841 #\r
3842 # Get components in VTF\r
3843 #\r
3844 # @param self The object pointer\r
3845 # @param VtfObj for whom component is got\r
3846 # @retval True Successfully find a component\r
3847 # @retval False Not able to find a component\r
3848 #\r
3849 def __GetComponentStatement(self, VtfObj):\r
3850\r
3851 if not self.__IsKeyword("COMP_NAME"):\r
3852 return False\r
3853\r
3854 if not self.__IsToken("="):\r
3855 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3856\r
3857 if not self.__GetNextWord():\r
3858 raise Warning("expected Component Name", self.FileName, self.CurrentLineNumber)\r
3859\r
3860 CompStatementObj = ComponentStatement.ComponentStatement()\r
3861 CompStatementObj.CompName = self.__Token\r
3862\r
3863 if not self.__IsKeyword("COMP_LOC"):\r
3864 raise Warning("expected COMP_LOC", self.FileName, self.CurrentLineNumber)\r
3865\r
3866 if not self.__IsToken("="):\r
3867 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3868\r
3869 CompStatementObj.CompLoc = ""\r
3870 if self.__GetNextWord():\r
3871 CompStatementObj.CompLoc = self.__Token\r
3872 if self.__IsToken('|'):\r
3873 if not self.__GetNextWord():\r
3874 raise Warning("Expected Region Name", self.FileName, self.CurrentLineNumber)\r
3875\r
3876 if self.__Token not in ("F", "N", "S"): #, "H", "L", "PH", "PL"): not support\r
3877 raise Warning("Unknown location type '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3878\r
3879 CompStatementObj.FilePos = self.__Token\r
3880 else:\r
3881 self.CurrentLineNumber += 1\r
3882 self.CurrentOffsetWithinLine = 0\r
3883\r
3884 if not self.__IsKeyword("COMP_TYPE"):\r
3885 raise Warning("expected COMP_TYPE", self.FileName, self.CurrentLineNumber)\r
3886\r
3887 if not self.__IsToken("="):\r
3888 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3889\r
3890 if not self.__GetNextToken():\r
3891 raise Warning("expected Component type", self.FileName, self.CurrentLineNumber)\r
3892 if self.__Token not in ("FIT", "PAL_B", "PAL_A", "OEM"):\r
3893 if not self.__Token.startswith("0x") or len(self.__Token) < 3 or len(self.__Token) > 4 or \\r
3894 not self.__HexDigit(self.__Token[2]) or not self.__HexDigit(self.__Token[-1]):\r
3895 raise Warning("Unknown location type '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3896 CompStatementObj.CompType = self.__Token\r
3897\r
3898 if not self.__IsKeyword("COMP_VER"):\r
3899 raise Warning("expected COMP_VER", self.FileName, self.CurrentLineNumber)\r
3900\r
3901 if not self.__IsToken("="):\r
3902 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3903\r
3904 if not self.__GetNextToken():\r
3905 raise Warning("expected Component version", self.FileName, self.CurrentLineNumber)\r
3906\r
3907 Pattern = re.compile('-$|[0-9a-fA-F]{1,2}\.[0-9a-fA-F]{1,2}$', re.DOTALL)\r
3908 if Pattern.match(self.__Token) == None:\r
3909 raise Warning("Unknown version format '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3910 CompStatementObj.CompVer = self.__Token\r
3911\r
3912 if not self.__IsKeyword("COMP_CS"):\r
3913 raise Warning("expected COMP_CS", self.FileName, self.CurrentLineNumber)\r
3914\r
3915 if not self.__IsToken("="):\r
3916 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3917\r
3918 if not self.__GetNextToken():\r
3919 raise Warning("expected Component CS", self.FileName, self.CurrentLineNumber)\r
3920 if self.__Token not in ("1", "0"):\r
3921 raise Warning("Unknown Component CS '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3922 CompStatementObj.CompCs = self.__Token\r
3923\r
3924\r
3925 if not self.__IsKeyword("COMP_BIN"):\r
3926 raise Warning("expected COMP_BIN", self.FileName, self.CurrentLineNumber)\r
3927\r
3928 if not self.__IsToken("="):\r
3929 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3930\r
3931 if not self.__GetNextToken():\r
3932 raise Warning("expected Component file", self.FileName, self.CurrentLineNumber)\r
3933\r
3934 CompStatementObj.CompBin = self.__Token\r
3935 if CompStatementObj.CompBin != '-' and CompStatementObj.CompBin.replace('$(WORKSPACE)', '').find('$') == -1:\r
3936 #check for file path\r
3937 ErrorCode, ErrorInfo = PathClass(NormPath(CompStatementObj.CompBin), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
3938 if ErrorCode != 0:\r
3939 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
3940\r
3941 if not self.__IsKeyword("COMP_SYM"):\r
3942 raise Warning("expected COMP_SYM", self.FileName, self.CurrentLineNumber)\r
3943\r
3944 if not self.__IsToken("="):\r
3945 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3946\r
3947 if not self.__GetNextToken():\r
3948 raise Warning("expected Component symbol file", self.FileName, self.CurrentLineNumber)\r
3949\r
3950 CompStatementObj.CompSym = self.__Token\r
3951 if CompStatementObj.CompSym != '-' and CompStatementObj.CompSym.replace('$(WORKSPACE)', '').find('$') == -1:\r
3952 #check for file path\r
3953 ErrorCode, ErrorInfo = PathClass(NormPath(CompStatementObj.CompSym), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
3954 if ErrorCode != 0:\r
3955 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
3956\r
3957 if not self.__IsKeyword("COMP_SIZE"):\r
3958 raise Warning("expected COMP_SIZE", self.FileName, self.CurrentLineNumber)\r
3959\r
3960 if not self.__IsToken("="):\r
3961 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
3962\r
3963 if self.__IsToken("-"):\r
3964 CompStatementObj.CompSize = self.__Token\r
3965 elif self.__GetNextDecimalNumber():\r
3966 CompStatementObj.CompSize = self.__Token\r
3967 elif self.__GetNextHexNumber():\r
3968 CompStatementObj.CompSize = self.__Token\r
3969 else:\r
3970 raise Warning("Unknown size '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3971\r
3972 VtfObj.ComponentStatementList.append(CompStatementObj)\r
3973 return True\r
3974\r
3975 ## __GetOptionRom() method\r
3976 #\r
3977 # Get OptionROM section contents and store its data into OptionROM list of self.Profile\r
3978 #\r
3979 # @param self The object pointer\r
3980 # @retval True Successfully find a OptionROM\r
3981 # @retval False Not able to find a OptionROM\r
3982 #\r
3983 def __GetOptionRom(self):\r
3984\r
3985 if not self.__GetNextToken():\r
3986 return False\r
3987\r
3988 S = self.__Token.upper()\r
3989 if S.startswith("[") and not S.startswith("[OPTIONROM."):\r
3990 raise Warning("Unknown section or section appear sequence error (The correct sequence should be [FD.], [FV.], [Capsule.], [VTF.], [Rule.], [OptionRom.])", self.FileName, self.CurrentLineNumber)\r
3991 \r
3992 self.__UndoToken()\r
3993 if not self.__IsToken("[OptionRom.", True):\r
3994 raise Warning("Unknown Keyword '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)\r
3995\r
3996 OptRomName = self.__GetUiName()\r
3997\r
3998 if not self.__IsToken( "]"):\r
3999 raise Warning("expected ']'", self.FileName, self.CurrentLineNumber)\r
4000\r
4001 OptRomObj = OptionRom.OPTIONROM()\r
4002 OptRomObj.DriverName = OptRomName\r
4003 self.Profile.OptRomDict[OptRomName] = OptRomObj\r
4004\r
4005 while True:\r
4006 isInf = self.__GetOptRomInfStatement(OptRomObj)\r
4007 isFile = self.__GetOptRomFileStatement(OptRomObj)\r
4008 if not isInf and not isFile:\r
4009 break\r
4010 \r
4011 return True\r
4012\r
4013 ## __GetOptRomInfStatement() method\r
4014 #\r
4015 # Get INF statements\r
4016 #\r
4017 # @param self The object pointer\r
4018 # @param Obj for whom inf statement is got\r
4019 # @retval True Successfully find inf statement\r
4020 # @retval False Not able to find inf statement\r
4021 #\r
4022 def __GetOptRomInfStatement(self, Obj):\r
4023\r
4024 if not self.__IsKeyword( "INF"):\r
4025 return False\r
4026\r
4027 ffsInf = OptRomInfStatement.OptRomInfStatement()\r
4028 self.__GetInfOptions( ffsInf)\r
4029\r
4030 if not self.__GetNextToken():\r
4031 raise Warning("expected INF file path", self.FileName, self.CurrentLineNumber)\r
4032 ffsInf.InfFileName = self.__Token\r
4033 if ffsInf.InfFileName.replace('$(WORKSPACE)', '').find('$') == -1:\r
4034 #check for file path\r
4035 ErrorCode, ErrorInfo = PathClass(NormPath(ffsInf.InfFileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
4036 if ErrorCode != 0:\r
4037 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
4038\r
4039 if not ffsInf.InfFileName in self.Profile.InfList:\r
4040 self.Profile.InfList.append(ffsInf.InfFileName)\r
4041 FileLineTuple = GetRealFileLine(self.FileName, self.CurrentLineNumber)\r
4042 self.Profile.InfFileLineList.append(FileLineTuple)\r
4043\r
4044 \r
4045 self.__GetOptRomOverrides (ffsInf)\r
4046 \r
4047 Obj.FfsList.append(ffsInf)\r
4048 return True\r
4049\r
4050 ## __GetOptRomOverrides() method\r
4051 #\r
4052 # Get overrides for OptROM INF & FILE\r
4053 #\r
4054 # @param self The object pointer\r
4055 # @param FfsInfObj for whom overrides is got\r
4056 #\r
4057 def __GetOptRomOverrides(self, Obj):\r
4058 if self.__IsToken('{'):\r
4059 Overrides = OptionRom.OverrideAttribs()\r
4060 while True:\r
4061 if self.__IsKeyword( "PCI_VENDOR_ID"):\r
4062 if not self.__IsToken( "="):\r
4063 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
4064 if not self.__GetNextHexNumber():\r
4065 raise Warning("expected Hex vendor id", self.FileName, self.CurrentLineNumber)\r
4066 Overrides.PciVendorId = self.__Token\r
4067 continue\r
4068\r
4069 if self.__IsKeyword( "PCI_CLASS_CODE"):\r
4070 if not self.__IsToken( "="):\r
4071 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
4072 if not self.__GetNextHexNumber():\r
4073 raise Warning("expected Hex class code", self.FileName, self.CurrentLineNumber)\r
4074 Overrides.PciClassCode = self.__Token\r
4075 continue\r
4076\r
4077 if self.__IsKeyword( "PCI_DEVICE_ID"):\r
4078 if not self.__IsToken( "="):\r
4079 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
4080 if not self.__GetNextHexNumber():\r
4081 raise Warning("expected Hex device id", self.FileName, self.CurrentLineNumber)\r
4082\r
4083 Overrides.PciDeviceId = self.__Token\r
4084 continue\r
4085\r
4086 if self.__IsKeyword( "PCI_REVISION"):\r
4087 if not self.__IsToken( "="):\r
4088 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
4089 if not self.__GetNextHexNumber():\r
4090 raise Warning("expected Hex revision", self.FileName, self.CurrentLineNumber)\r
4091 Overrides.PciRevision = self.__Token\r
4092 continue\r
4093\r
4094 if self.__IsKeyword( "PCI_COMPRESS"):\r
4095 if not self.__IsToken( "="):\r
4096 raise Warning("expected '='", self.FileName, self.CurrentLineNumber)\r
4097 if not self.__GetNextToken():\r
4098 raise Warning("expected TRUE/FALSE for compress", self.FileName, self.CurrentLineNumber)\r
4099 Overrides.NeedCompress = self.__Token.upper() == 'TRUE'\r
4100 continue\r
4101\r
4102 if self.__IsToken( "}"):\r
4103 break\r
4104 else:\r
4105 EdkLogger.error("FdfParser", FORMAT_INVALID, File=self.FileName, Line=self.CurrentLineNumber)\r
4106\r
4107 Obj.OverrideAttribs = Overrides\r
4108 \r
4109 ## __GetOptRomFileStatement() method\r
4110 #\r
4111 # Get FILE statements\r
4112 #\r
4113 # @param self The object pointer\r
4114 # @param Obj for whom FILE statement is got\r
4115 # @retval True Successfully find FILE statement\r
4116 # @retval False Not able to find FILE statement\r
4117 #\r
4118 def __GetOptRomFileStatement(self, Obj):\r
4119\r
4120 if not self.__IsKeyword( "FILE"):\r
4121 return False\r
4122\r
4123 FfsFileObj = OptRomFileStatement.OptRomFileStatement()\r
4124\r
4125 if not self.__IsKeyword("EFI") and not self.__IsKeyword("BIN"):\r
4126 raise Warning("expected Binary type (EFI/BIN)", self.FileName, self.CurrentLineNumber)\r
4127 FfsFileObj.FileType = self.__Token\r
4128\r
4129 if not self.__GetNextToken():\r
4130 raise Warning("expected File path", self.FileName, self.CurrentLineNumber)\r
4131 FfsFileObj.FileName = self.__Token\r
4132 if FfsFileObj.FileName.replace('$(WORKSPACE)', '').find('$') == -1:\r
4133 #check for file path\r
4134 ErrorCode, ErrorInfo = PathClass(NormPath(FfsFileObj.FileName), GenFdsGlobalVariable.WorkSpaceDir).Validate()\r
4135 if ErrorCode != 0:\r
4136 EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)\r
4137\r
4138 if FfsFileObj.FileType == 'EFI':\r
4139 self.__GetOptRomOverrides(FfsFileObj)\r
4140 \r
4141 Obj.FfsList.append(FfsFileObj)\r
4142\r
4143 return True\r
4144\r
4145 ## __GetCapInFd() method\r
4146 #\r
4147 # Get Cap list contained in FD\r
4148 #\r
4149 # @param self The object pointer\r
4150 # @param FdName FD name\r
4151 # @retval CapList List of Capsule in FD\r
4152 #\r
4153 def __GetCapInFd (self, FdName):\r
4154\r
4155 CapList = []\r
4156 if FdName.upper() in self.Profile.FdDict.keys():\r
4157 FdObj = self.Profile.FdDict[FdName.upper()]\r
4158 for elementRegion in FdObj.RegionList:\r
4159 if elementRegion.RegionType == 'CAPSULE':\r
4160 for elementRegionData in elementRegion.RegionDataList:\r
4161 if elementRegionData.endswith(".cap"):\r
4162 continue\r
4163 if elementRegionData != None and elementRegionData.upper() not in CapList:\r
4164 CapList.append(elementRegionData.upper())\r
4165 return CapList\r
4166\r
4167 ## __GetReferencedFdCapTuple() method\r
4168 #\r
4169 # Get FV and FD list referenced by a capsule image\r
4170 #\r
4171 # @param self The object pointer\r
4172 # @param CapObj Capsule section to be searched\r
4173 # @param RefFdList referenced FD by section\r
4174 # @param RefFvList referenced FV by section\r
4175 #\r
4176 def __GetReferencedFdCapTuple(self, CapObj, RefFdList = [], RefFvList = []):\r
4177\r
4178 for CapsuleDataObj in CapObj.CapsuleDataList :\r
4179 if hasattr(CapsuleDataObj, 'FvName') and CapsuleDataObj.FvName != None and CapsuleDataObj.FvName.upper() not in RefFvList:\r
4180 RefFvList.append (CapsuleDataObj.FvName.upper())\r
4181 elif hasattr(CapsuleDataObj, 'FdName') and CapsuleDataObj.FdName != None and CapsuleDataObj.FdName.upper() not in RefFdList:\r
4182 RefFdList.append (CapsuleDataObj.FdName.upper()) \r
4183 elif CapsuleDataObj.Ffs != None:\r
4184 if isinstance(CapsuleDataObj.Ffs, FfsFileStatement.FileStatement):\r
4185 if CapsuleDataObj.Ffs.FvName != None and CapsuleDataObj.Ffs.FvName.upper() not in RefFvList:\r
4186 RefFvList.append(CapsuleDataObj.Ffs.FvName.upper())\r
4187 elif CapsuleDataObj.Ffs.FdName != None and CapsuleDataObj.Ffs.FdName.upper() not in RefFdList:\r
4188 RefFdList.append(CapsuleDataObj.Ffs.FdName.upper())\r
4189 else:\r
4190 self.__GetReferencedFdFvTupleFromSection(CapsuleDataObj.Ffs, RefFdList, RefFvList)\r
4191\r
4192 ## __GetFvInFd() method\r
4193 #\r
4194 # Get FV list contained in FD\r
4195 #\r
4196 # @param self The object pointer\r
4197 # @param FdName FD name\r
4198 # @retval FvList list of FV in FD\r
4199 #\r
4200 def __GetFvInFd (self, FdName):\r
4201\r
4202 FvList = []\r
4203 if FdName.upper() in self.Profile.FdDict.keys():\r
4204 FdObj = self.Profile.FdDict[FdName.upper()]\r
4205 for elementRegion in FdObj.RegionList:\r
4206 if elementRegion.RegionType == 'FV':\r
4207 for elementRegionData in elementRegion.RegionDataList:\r
4208 if elementRegionData.endswith(".fv"):\r
4209 continue\r
4210 if elementRegionData != None and elementRegionData.upper() not in FvList:\r
4211 FvList.append(elementRegionData.upper())\r
4212 return FvList\r
4213\r
4214 ## __GetReferencedFdFvTuple() method\r
4215 #\r
4216 # Get FD and FV list referenced by a FFS file\r
4217 #\r
4218 # @param self The object pointer\r
4219 # @param FfsFile contains sections to be searched\r
4220 # @param RefFdList referenced FD by section\r
4221 # @param RefFvList referenced FV by section\r
4222 #\r
4223 def __GetReferencedFdFvTuple(self, FvObj, RefFdList = [], RefFvList = []):\r
4224\r
4225 for FfsObj in FvObj.FfsList:\r
4226 if isinstance(FfsObj, FfsFileStatement.FileStatement):\r
4227 if FfsObj.FvName != None and FfsObj.FvName.upper() not in RefFvList:\r
4228 RefFvList.append(FfsObj.FvName.upper())\r
4229 elif FfsObj.FdName != None and FfsObj.FdName.upper() not in RefFdList:\r
4230 RefFdList.append(FfsObj.FdName.upper())\r
4231 else:\r
4232 self.__GetReferencedFdFvTupleFromSection(FfsObj, RefFdList, RefFvList)\r
4233\r
4234 ## __GetReferencedFdFvTupleFromSection() method\r
4235 #\r
4236 # Get FD and FV list referenced by a FFS section\r
4237 #\r
4238 # @param self The object pointer\r
4239 # @param FfsFile contains sections to be searched\r
4240 # @param FdList referenced FD by section\r
4241 # @param FvList referenced FV by section\r
4242 #\r
4243 def __GetReferencedFdFvTupleFromSection(self, FfsFile, FdList = [], FvList = []):\r
4244\r
4245 SectionStack = []\r
4246 SectionStack.extend(FfsFile.SectionList)\r
4247 while SectionStack != []:\r
4248 SectionObj = SectionStack.pop()\r
4249 if isinstance(SectionObj, FvImageSection.FvImageSection):\r
4250 if SectionObj.FvName != None and SectionObj.FvName.upper() not in FvList:\r
4251 FvList.append(SectionObj.FvName.upper())\r
4252 if SectionObj.Fv != None and SectionObj.Fv.UiFvName != None and SectionObj.Fv.UiFvName.upper() not in FvList:\r
4253 FvList.append(SectionObj.Fv.UiFvName.upper())\r
4254 self.__GetReferencedFdFvTuple(SectionObj.Fv, FdList, FvList)\r
4255\r
4256 if isinstance(SectionObj, CompressSection.CompressSection) or isinstance(SectionObj, GuidSection.GuidSection):\r
4257 SectionStack.extend(SectionObj.SectionList)\r
4258\r
4259 ## CycleReferenceCheck() method\r
4260 #\r
4261 # Check whether cycle reference exists in FDF\r
4262 #\r
4263 # @param self The object pointer\r
4264 # @retval True cycle reference exists\r
4265 # @retval False Not exists cycle reference\r
4266 #\r
4267 def CycleReferenceCheck(self):\r
4268 #\r
4269 # Check the cycle between FV and FD image\r
4270 #\r
4271 MaxLength = len (self.Profile.FvDict)\r
4272 for FvName in self.Profile.FvDict.keys():\r
4273 LogStr = "\nCycle Reference Checking for FV: %s\n" % FvName\r
4274 RefFvStack = []\r
4275 RefFvStack.append(FvName)\r
4276 FdAnalyzedList = []\r
4277 \r
4278 Index = 0\r
4279 while RefFvStack != [] and Index < MaxLength:\r
4280 Index = Index + 1\r
4281 FvNameFromStack = RefFvStack.pop()\r
4282 if FvNameFromStack.upper() in self.Profile.FvDict.keys():\r
4283 FvObj = self.Profile.FvDict[FvNameFromStack.upper()]\r
4284 else:\r
4285 continue\r
4286\r
4287 RefFdList = []\r
4288 RefFvList = []\r
4289 self.__GetReferencedFdFvTuple(FvObj, RefFdList, RefFvList)\r
4290\r
4291 for RefFdName in RefFdList:\r
4292 if RefFdName in FdAnalyzedList:\r
4293 continue\r
4294\r
4295 LogStr += "FV %s contains FD %s\n" % (FvNameFromStack, RefFdName)\r
4296 FvInFdList = self.__GetFvInFd(RefFdName)\r
4297 if FvInFdList != []:\r
4298 for FvNameInFd in FvInFdList:\r
4299 LogStr += "FD %s contains FV %s\n" % (RefFdName,FvNameInFd)\r
4300 if FvNameInFd not in RefFvStack:\r
4301 RefFvStack.append(FvNameInFd)\r
4302\r
4303 if FvName in RefFvStack or FvNameFromStack in RefFvStack:\r
4304 EdkLogger.info(LogStr)\r
4305 return True\r
4306 FdAnalyzedList.append(RefFdName)\r
4307\r
4308 for RefFvName in RefFvList:\r
4309 LogStr += "FV %s contains FV %s\n" % (FvNameFromStack, RefFvName)\r
4310 if RefFvName not in RefFvStack:\r
4311 RefFvStack.append(RefFvName)\r
4312\r
4313 if FvName in RefFvStack or FvNameFromStack in RefFvStack:\r
4314 EdkLogger.info(LogStr)\r
4315 return True\r
4316\r
4317 #\r
4318 # Check the cycle between Capsule and FD image\r
4319 #\r
4320 MaxLength = len (self.Profile.CapsuleDict)\r
4321 for CapName in self.Profile.CapsuleDict.keys():\r
4322 #\r
4323 # Capsule image to be checked.\r
4324 #\r
4325 LogStr = "\n\n\nCycle Reference Checking for Capsule: %s\n" % CapName\r
4326 RefCapStack = []\r
4327 RefCapStack.append(CapName)\r
4328 FdAnalyzedList = []\r
4329 FvAnalyzedList = []\r
4330 \r
4331 Index = 0\r
4332 while RefCapStack != [] and Index < MaxLength:\r
4333 Index = Index + 1\r
4334 CapNameFromStack = RefCapStack.pop()\r
4335 if CapNameFromStack.upper() in self.Profile.CapsuleDict.keys():\r
4336 CapObj = self.Profile.CapsuleDict[CapNameFromStack.upper()]\r
4337 else:\r
4338 continue\r
4339\r
4340 RefFvList = []\r
4341 RefFdList = []\r
4342 self.__GetReferencedFdCapTuple(CapObj, RefFdList, RefFvList)\r
4343\r
4344 FvListLength = 0\r
4345 FdListLength = 0\r
4346 while FvListLength < len (RefFvList) or FdListLength < len (RefFdList):\r
4347 for RefFdName in RefFdList:\r
4348 if RefFdName in FdAnalyzedList:\r
4349 continue\r
4350\r
4351 LogStr += "Capsule %s contains FD %s\n" % (CapNameFromStack, RefFdName)\r
4352 CapInFdList = self.__GetCapInFd(RefFdName)\r
4353 if CapInFdList != []:\r
4354 for CapNameInFd in CapInFdList:\r
4355 LogStr += "FD %s contains Capsule %s\n" % (RefFdName,CapNameInFd)\r
4356 if CapNameInFd not in RefCapStack:\r
4357 RefCapStack.append(CapNameInFd)\r
4358\r
4359 if CapName in RefCapStack or CapNameFromStack in RefCapStack:\r
4360 EdkLogger.info(LogStr)\r
4361 return True\r
4362\r
4363 FvInFdList = self.__GetFvInFd(RefFdName)\r
4364 if FvInFdList != []:\r
4365 for FvNameInFd in FvInFdList:\r
4366 LogStr += "FD %s contains FV %s\n" % (RefFdName,FvNameInFd)\r
4367 if FvNameInFd not in RefFvList:\r
4368 RefFvList.append(FvNameInFd)\r
4369\r
4370 FdAnalyzedList.append(RefFdName)\r
4371 #\r
4372 # the number of the parsed FV and FD image\r
4373 #\r
4374 FvListLength = len (RefFvList)\r
4375 FdListLength = len (RefFdList)\r
4376 for RefFvName in RefFvList:\r
4377 if RefFvName in FvAnalyzedList:\r
4378 continue\r
4379 LogStr += "Capsule %s contains FV %s\n" % (CapNameFromStack, RefFvName)\r
4380 if RefFvName.upper() in self.Profile.FvDict.keys():\r
4381 FvObj = self.Profile.FvDict[RefFvName.upper()]\r
4382 else:\r
4383 continue\r
4384 self.__GetReferencedFdFvTuple(FvObj, RefFdList, RefFvList)\r
4385 FvAnalyzedList.append(RefFvName)\r
4386\r
4387 return False\r
4388\r
4389if __name__ == "__main__":\r
4390 import sys\r
4391 try:\r
4392 test_file = sys.argv[1]\r
4393 except IndexError, v:\r
4394 print "Usage: %s filename" % sys.argv[0]\r
4395 sys.exit(1)\r
4396\r
4397 parser = FdfParser(test_file)\r
4398 try:\r
4399 parser.ParseFile()\r
4400 parser.CycleReferenceCheck()\r
4401 except Warning, X:\r
4402 print str(X)\r
4403 else:\r
4404 print "Success!"\r
4405\r