]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Source/Python/GenFds/Region.py
Sync EDKII BaseTools to BaseTools project r2093.
[mirror_edk2.git] / BaseTools / Source / Python / GenFds / Region.py
CommitLineData
30fdf114
LG
1## @file\r
2# process FD Region generation\r
3#\r
6780eef1 4# Copyright (c) 2007 - 2010, Intel Corporation. All rights reserved.<BR>\r
30fdf114 5#\r
40d841f6 6# This program and the accompanying materials\r
30fdf114
LG
7# are licensed and made available under the terms and conditions of the BSD License\r
8# which accompanies this distribution. The full text of the license may be found at\r
9# http://opensource.org/licenses/bsd-license.php\r
10#\r
11# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13#\r
14\r
15##\r
16# Import Modules\r
17#\r
18from struct import *\r
19from GenFdsGlobalVariable import GenFdsGlobalVariable\r
20import StringIO\r
21from CommonDataClass.FdfClass import RegionClassObject\r
22import os\r
fd171542 23from stat import *\r
30fdf114
LG
24from Common import EdkLogger\r
25from Common.BuildToolError import *\r
26\r
30fdf114
LG
27## generate Region\r
28#\r
29#\r
30class Region(RegionClassObject):\r
31\r
32 ## The constructor\r
33 #\r
34 # @param self The object pointer\r
35 #\r
36 def __init__(self):\r
37 RegionClassObject.__init__(self)\r
38\r
39\r
40 ## AddToBuffer()\r
41 #\r
42 # Add region data to the Buffer\r
43 #\r
44 # @param self The object pointer\r
45 # @param Buffer The buffer generated region data will be put\r
46 # @param BaseAddress base address of region\r
47 # @param BlockSize block size of region\r
48 # @param BlockNum How many blocks in region\r
49 # @param ErasePolarity Flash erase polarity\r
50 # @param VtfDict VTF objects\r
51 # @param MacroDict macro value pair\r
52 # @retval string Generated FV file path\r
53 #\r
54\r
fd171542 55 def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBinDict, vtfDict = None, MacroDict = {}):\r
30fdf114 56 Size = self.Size\r
fd171542 57 GenFdsGlobalVariable.InfLogger('\nGenerate Region at Offset 0x%X' % self.Offset)\r
30fdf114
LG
58 GenFdsGlobalVariable.InfLogger(" Region Size = 0x%X" %Size)\r
59 GenFdsGlobalVariable.SharpCounter = 0\r
60\r
61 if self.RegionType == 'FV':\r
62 #\r
63 # Get Fv from FvDict\r
64 #\r
30fdf114 65 self.FvAddress = int(BaseAddress, 16) + self.Offset\r
fd171542 66 FvBaseAddress = '0x%X' %self.FvAddress\r
67 FvOffset = 0\r
30fdf114 68 for RegionData in self.RegionDataList:\r
fd171542 69 FileName = None\r
30fdf114
LG
70 if RegionData.endswith(".fv"):\r
71 RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)\r
72 GenFdsGlobalVariable.InfLogger(' Region FV File Name = .fv : %s'%RegionData)\r
73 if RegionData[1] != ':' :\r
74 RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)\r
75 if not os.path.exists(RegionData):\r
76 EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)\r
77\r
fd171542 78 FileName = RegionData\r
79 elif RegionData.upper() + 'fv' in ImageBinDict.keys():\r
80 GenFdsGlobalVariable.InfLogger(' Region Name = FV')\r
81 FileName = ImageBinDict[RegionData.upper() + 'fv']\r
82 else:\r
83 #\r
84 # Generate FvImage.\r
85 #\r
86 FvObj = None\r
87 if RegionData.upper() in GenFdsGlobalVariable.FdfParser.Profile.FvDict.keys():\r
88 FvObj = GenFdsGlobalVariable.FdfParser.Profile.FvDict.get(RegionData.upper())\r
89\r
90 if FvObj != None :\r
91 GenFdsGlobalVariable.InfLogger(' Region Name = FV')\r
92 #\r
93 # Call GenFv tool\r
94 #\r
6780eef1 95 self.BlockInfoOfRegion(BlockSizeList, FvObj)\r
fd171542 96 self.FvAddress = self.FvAddress + FvOffset\r
97 FvAlignValue = self.GetFvAlignValue(FvObj.FvAlignment)\r
98 if self.FvAddress % FvAlignValue != 0:\r
99 EdkLogger.error("GenFds", GENFDS_ERROR,\r
100 "FV (%s) is NOT %s Aligned!" % (FvObj.UiFvName, FvObj.FvAlignment))\r
101 FvBuffer = StringIO.StringIO('')\r
102 FvBaseAddress = '0x%X' %self.FvAddress\r
6780eef1
LG
103 BlockSize = None\r
104 BlockNum = None\r
fd171542 105 FvObj.AddToBuffer(FvBuffer, FvBaseAddress, BlockSize, BlockNum, ErasePolarity, vtfDict)\r
106 if FvBuffer.len > Size:\r
107 FvBuffer.close()\r
108 EdkLogger.error("GenFds", GENFDS_ERROR,\r
109 "Size of FV (%s) is larger than Region Size 0x%X specified." % (RegionData, Size))\r
110 #\r
111 # Put the generated image into FD buffer.\r
112 #\r
113 Buffer.write(FvBuffer.getvalue())\r
114 FvBuffer.close()\r
115 FvOffset = FvOffset + FvBuffer.len\r
116 Size = Size - FvBuffer.len\r
117 continue\r
118 else:\r
119 EdkLogger.error("GenFds", GENFDS_ERROR, "FV (%s) is NOT described in FDF file!" % (RegionData))\r
120 #\r
121 # Add the exist Fv image into FD buffer\r
122 #\r
123 if FileName != None:\r
124 FileLength = os.stat(FileName)[ST_SIZE]\r
125 if FileLength > Size:\r
30fdf114
LG
126 EdkLogger.error("GenFds", GENFDS_ERROR,\r
127 "Size of FV File (%s) is larger than Region Size 0x%X specified." \\r
128 % (RegionData, Size))\r
fd171542 129 BinFile = open (FileName, 'r+b')\r
130 Buffer.write(BinFile.read())\r
131 BinFile.close()\r
132 Size = Size - FileLength\r
133 #\r
134 # Pad the left buffer\r
135 #\r
136 if Size > 0:\r
137 if (ErasePolarity == '1') :\r
138 PadData = 0xFF\r
139 else :\r
140 PadData = 0\r
141 for i in range(0, Size):\r
142 Buffer.write(pack('B', PadData))\r
30fdf114 143\r
fd171542 144 if self.RegionType == 'CAPSULE':\r
145 #\r
146 # Get Capsule from Capsule Dict\r
147 #\r
148 for RegionData in self.RegionDataList:\r
149 if RegionData.endswith(".cap"):\r
150 RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)\r
151 GenFdsGlobalVariable.InfLogger(' Region CAPSULE Image Name = .cap : %s'%RegionData)\r
152 if RegionData[1] != ':' :\r
153 RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)\r
154 if not os.path.exists(RegionData):\r
155 EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)\r
30fdf114 156\r
fd171542 157 FileName = RegionData\r
158 elif RegionData.upper() + 'cap' in ImageBinDict.keys():\r
159 GenFdsGlobalVariable.InfLogger(' Region Name = CAPSULE')\r
160 FileName = ImageBinDict[RegionData.upper() + 'cap']\r
161 else:\r
30fdf114 162 #\r
fd171542 163 # Generate Capsule image and Put it into FD buffer\r
30fdf114 164 #\r
fd171542 165 CapsuleObj = None\r
166 if RegionData.upper() in GenFdsGlobalVariable.FdfParser.Profile.CapsuleDict.keys():\r
167 CapsuleObj = GenFdsGlobalVariable.FdfParser.Profile.CapsuleDict[RegionData.upper()]\r
30fdf114 168\r
fd171542 169 if CapsuleObj != None :\r
170 CapsuleObj.CapsuleName = RegionData.upper()\r
171 GenFdsGlobalVariable.InfLogger(' Region Name = CAPSULE')\r
172 #\r
173 # Call GenFv tool to generate Capsule Image\r
174 #\r
175 FileName = CapsuleObj.GenCapsule()\r
176 CapsuleObj.CapsuleName = None\r
177 else:\r
178 EdkLogger.error("GenFds", GENFDS_ERROR, "Capsule (%s) is NOT described in FDF file!" % (RegionData))\r
30fdf114 179\r
fd171542 180 #\r
181 # Add the capsule image into FD buffer\r
182 #\r
183 FileLength = os.stat(FileName)[ST_SIZE]\r
184 if FileLength > Size:\r
185 EdkLogger.error("GenFds", GENFDS_ERROR,\r
186 "Size 0x%X of Capsule File (%s) is larger than Region Size 0x%X specified." \\r
187 % (FileLength, RegionData, Size))\r
188 BinFile = open (FileName, 'r+b')\r
30fdf114 189 Buffer.write(BinFile.read())\r
fd171542 190 BinFile.close()\r
191 Size = Size - FileLength\r
192 #\r
193 # Pad the left buffer\r
194 #\r
195 if Size > 0:\r
196 if (ErasePolarity == '1') :\r
197 PadData = 0xFF\r
198 else :\r
199 PadData = 0\r
200 for i in range(0, Size):\r
201 Buffer.write(pack('B', PadData))\r
30fdf114
LG
202\r
203 if self.RegionType == 'FILE':\r
30fdf114
LG
204 for RegionData in self.RegionDataList:\r
205 RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)\r
30fdf114
LG
206 if RegionData[1] != ':' :\r
207 RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)\r
208 if not os.path.exists(RegionData):\r
209 EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)\r
fd171542 210 #\r
211 # Add the file image into FD buffer\r
212 #\r
213 FileLength = os.stat(RegionData)[ST_SIZE]\r
214 if FileLength > Size:\r
30fdf114 215 EdkLogger.error("GenFds", GENFDS_ERROR,\r
fd171542 216 "Size of File (%s) is larger than Region Size 0x%X specified." \\r
217 % (RegionData, Size))\r
218 GenFdsGlobalVariable.InfLogger(' Region File Name = %s'%RegionData)\r
219 BinFile = open (RegionData, 'r+b')\r
220 Buffer.write(BinFile.read())\r
221 BinFile.close()\r
222 Size = Size - FileLength\r
30fdf114 223 #\r
fd171542 224 # Pad the left buffer\r
30fdf114 225 #\r
fd171542 226 if Size > 0:\r
227 if (ErasePolarity == '1') :\r
228 PadData = 0xFF\r
229 else :\r
230 PadData = 0\r
231 for i in range(0, Size):\r
232 Buffer.write(pack('B', PadData))\r
30fdf114
LG
233\r
234 if self.RegionType == 'DATA' :\r
235 GenFdsGlobalVariable.InfLogger(' Region Name = DATA')\r
236 DataSize = 0\r
237 for RegionData in self.RegionDataList:\r
238 Data = RegionData.split(',')\r
239 DataSize = DataSize + len(Data)\r
240 if DataSize > Size:\r
241 EdkLogger.error("GenFds", GENFDS_ERROR, "Size of DATA is larger than Region Size ")\r
242 else:\r
243 for item in Data :\r
244 Buffer.write(pack('B', int(item, 16)))\r
fd171542 245 Size = Size - DataSize\r
246 #\r
247 # Pad the left buffer\r
248 #\r
249 if Size > 0:\r
250 if (ErasePolarity == '1') :\r
30fdf114 251 PadData = 0xFF\r
fd171542 252 else :\r
30fdf114 253 PadData = 0\r
fd171542 254 for i in range(0, Size):\r
30fdf114
LG
255 Buffer.write(pack('B', PadData))\r
256\r
257 if self.RegionType == None:\r
258 GenFdsGlobalVariable.InfLogger(' Region Name = None')\r
259 if (ErasePolarity == '1') :\r
260 PadData = 0xFF\r
261 else :\r
262 PadData = 0\r
263 for i in range(0, Size):\r
264 Buffer.write(pack('B', PadData))\r
265\r
266 def GetFvAlignValue(self, Str):\r
267 AlignValue = 1\r
268 Granu = 1\r
269 Str = Str.strip().upper()\r
270 if Str.endswith('K'):\r
271 Granu = 1024\r
272 Str = Str[:-1]\r
273 elif Str.endswith('M'):\r
274 Granu = 1024*1024\r
275 Str = Str[:-1]\r
276 elif Str.endswith('G'):\r
277 Granu = 1024*1024*1024\r
278 Str = Str[:-1]\r
279 else:\r
280 pass\r
281\r
282 AlignValue = int(Str)*Granu\r
283 return AlignValue\r
6780eef1 284 \r
30fdf114
LG
285 ## BlockSizeOfRegion()\r
286 #\r
287 # @param BlockSizeList List of block information\r
6780eef1 288 # @param FvObj The object for FV\r
30fdf114 289 #\r
6780eef1
LG
290 def BlockInfoOfRegion(self, BlockSizeList, FvObj):\r
291 Start = 0\r
292 End = 0\r
293 RemindingSize = self.Size\r
294 ExpectedList = []\r
295 for (BlockSize, BlockNum, pcd) in BlockSizeList:\r
296 End = Start + BlockSize * BlockNum\r
297 # region not started yet\r
298 if self.Offset >= End:\r
299 Start = End\r
300 continue\r
301 # region located in current blocks \r
302 else:\r
303 # region ended within current blocks\r
304 if self.Offset + self.Size <= End:\r
305 ExpectedList.append((BlockSize, (RemindingSize + BlockSize - 1)/BlockSize))\r
306 break\r
307 # region not ended yet\r
308 else:\r
309 # region not started in middle of current blocks\r
310 if self.Offset <= Start:\r
311 UsedBlockNum = BlockNum\r
312 # region started in middle of current blocks\r
313 else:\r
314 UsedBlockNum = (End - self.Offset)/BlockSize\r
315 Start = End\r
316 ExpectedList.append((BlockSize, UsedBlockNum))\r
317 RemindingSize -= BlockSize * UsedBlockNum\r
318 \r
319 if FvObj.BlockSizeList == []:\r
320 FvObj.BlockSizeList = ExpectedList\r
321 else:\r
322 # first check whether FvObj.BlockSizeList items have only "BlockSize" or "NumBlocks",\r
323 # if so, use ExpectedList\r
324 for Item in FvObj.BlockSizeList:\r
325 if Item[0] == None or Item[1] == None:\r
326 FvObj.BlockSizeList = ExpectedList\r
327 break\r
328 # make sure region size is no smaller than the summed block size in FV\r
329 Sum = 0\r
330 for Item in FvObj.BlockSizeList:\r
331 Sum += Item[0] * Item[1]\r
332 if self.Size < Sum:\r
333 EdkLogger.error("GenFds", GENFDS_ERROR, "Total Size of FV %s 0x%x is larger than Region Size 0x%x "\r
334 %(FvObj.UiFvName, Sum, self.Size))\r
335 # check whether the BlockStatements in FV section is appropriate\r
336 ExpectedListData = ''\r
337 for Item in ExpectedList:\r
338 ExpectedListData += "BlockSize = 0x%x\n\tNumBlocks = 0x%x\n\t"%Item \r
339 Index = 0\r
340 for Item in FvObj.BlockSizeList:\r
341 if Item[0] != ExpectedList[Index][0]:\r
342 EdkLogger.error("GenFds", GENFDS_ERROR, "BlockStatements of FV %s are not align with FD's, suggested FV BlockStatement"\r
343 %FvObj.UiFvName, ExtraData = ExpectedListData)\r
344 elif Item[1] != ExpectedList[Index][1]:\r
345 if (Item[1] < ExpectedList[Index][1]) and (Index == len(FvObj.BlockSizeList) - 1):\r
346 break;\r
347 else:\r
348 EdkLogger.error("GenFds", GENFDS_ERROR, "BlockStatements of FV %s are not align with FD's, suggested FV BlockStatement"\r
349 %FvObj.UiFvName, ExtraData = ExpectedListData)\r
350 else:\r
351 Index += 1\r
30fdf114 352\r
6780eef1 353 \r
30fdf114 354\r