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