git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9257 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			326 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			326 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
## @file
 | 
						|
# process FD Region generation
 | 
						|
#
 | 
						|
#  Copyright (c) 2007, Intel Corporation
 | 
						|
#
 | 
						|
#  All rights reserved. This program and the accompanying materials
 | 
						|
#  are licensed and made available under the terms and conditions of the BSD License
 | 
						|
#  which accompanies this distribution.  The full text of the license may be found at
 | 
						|
#  http://opensource.org/licenses/bsd-license.php
 | 
						|
#
 | 
						|
#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 | 
						|
#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | 
						|
#
 | 
						|
 | 
						|
##
 | 
						|
# Import Modules
 | 
						|
#
 | 
						|
from struct import *
 | 
						|
from GenFdsGlobalVariable import GenFdsGlobalVariable
 | 
						|
import StringIO
 | 
						|
from CommonDataClass.FdfClass import RegionClassObject
 | 
						|
import os
 | 
						|
from stat import *
 | 
						|
from Common import EdkLogger
 | 
						|
from Common.BuildToolError import *
 | 
						|
 | 
						|
## generate Region
 | 
						|
#
 | 
						|
#
 | 
						|
class Region(RegionClassObject):
 | 
						|
 | 
						|
    ## The constructor
 | 
						|
    #
 | 
						|
    #   @param  self        The object pointer
 | 
						|
    #
 | 
						|
    def __init__(self):
 | 
						|
        RegionClassObject.__init__(self)
 | 
						|
 | 
						|
 | 
						|
    ## AddToBuffer()
 | 
						|
    #
 | 
						|
    #   Add region data to the Buffer
 | 
						|
    #
 | 
						|
    #   @param  self        The object pointer
 | 
						|
    #   @param  Buffer      The buffer generated region data will be put
 | 
						|
    #   @param  BaseAddress base address of region
 | 
						|
    #   @param  BlockSize   block size of region
 | 
						|
    #   @param  BlockNum    How many blocks in region
 | 
						|
    #   @param  ErasePolarity      Flash erase polarity
 | 
						|
    #   @param  VtfDict     VTF objects
 | 
						|
    #   @param  MacroDict   macro value pair
 | 
						|
    #   @retval string      Generated FV file path
 | 
						|
    #
 | 
						|
 | 
						|
    def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBinDict, vtfDict = None, MacroDict = {}):
 | 
						|
        Size = self.Size
 | 
						|
        GenFdsGlobalVariable.InfLogger('\nGenerate Region at Offset 0x%X' % self.Offset)
 | 
						|
        GenFdsGlobalVariable.InfLogger("   Region Size = 0x%X" %Size)
 | 
						|
        GenFdsGlobalVariable.SharpCounter = 0
 | 
						|
 | 
						|
        if self.RegionType == 'FV':
 | 
						|
            #
 | 
						|
            # Get Fv from FvDict
 | 
						|
            #
 | 
						|
            RegionBlockSize = self.BlockSizeOfRegion(BlockSizeList)
 | 
						|
            RegionBlockNum = self.BlockNumOfRegion(RegionBlockSize)
 | 
						|
 | 
						|
            self.FvAddress = int(BaseAddress, 16) + self.Offset
 | 
						|
            FvBaseAddress  = '0x%X' %self.FvAddress
 | 
						|
            FvOffset       = 0
 | 
						|
            for RegionData in self.RegionDataList:
 | 
						|
                FileName = None
 | 
						|
                if RegionData.endswith(".fv"):
 | 
						|
                    RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
 | 
						|
                    GenFdsGlobalVariable.InfLogger('   Region FV File Name = .fv : %s'%RegionData)
 | 
						|
                    if RegionData[1] != ':' :
 | 
						|
                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
 | 
						|
                    if not os.path.exists(RegionData):
 | 
						|
                        EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
 | 
						|
 | 
						|
                    FileName = RegionData
 | 
						|
                elif RegionData.upper() + 'fv' in ImageBinDict.keys():
 | 
						|
                    GenFdsGlobalVariable.InfLogger('   Region Name = FV')
 | 
						|
                    FileName = ImageBinDict[RegionData.upper() + 'fv']
 | 
						|
                else:
 | 
						|
                    #
 | 
						|
                    # Generate FvImage.
 | 
						|
                    #
 | 
						|
                    FvObj = None
 | 
						|
                    if RegionData.upper() in GenFdsGlobalVariable.FdfParser.Profile.FvDict.keys():
 | 
						|
                        FvObj = GenFdsGlobalVariable.FdfParser.Profile.FvDict.get(RegionData.upper())
 | 
						|
 | 
						|
                    if FvObj != None :
 | 
						|
                        GenFdsGlobalVariable.InfLogger('   Region Name = FV')
 | 
						|
                        #
 | 
						|
                        # Call GenFv tool
 | 
						|
                        #
 | 
						|
                        BlockSize = RegionBlockSize
 | 
						|
                        BlockNum = RegionBlockNum
 | 
						|
                        if FvObj.BlockSizeList != []:
 | 
						|
                            if FvObj.BlockSizeList[0][0] != None:
 | 
						|
                                BlockSize = FvObj.BlockSizeList[0][0]
 | 
						|
                            if FvObj.BlockSizeList[0][1] != None:
 | 
						|
                                BlockNum = FvObj.BlockSizeList[0][1]
 | 
						|
                        self.FvAddress = self.FvAddress + FvOffset
 | 
						|
                        FvAlignValue = self.GetFvAlignValue(FvObj.FvAlignment)
 | 
						|
                        if self.FvAddress % FvAlignValue != 0:
 | 
						|
                            EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                            "FV (%s) is NOT %s Aligned!" % (FvObj.UiFvName, FvObj.FvAlignment))
 | 
						|
                        FvBuffer = StringIO.StringIO('')
 | 
						|
                        FvBaseAddress = '0x%X' %self.FvAddress
 | 
						|
                        FvObj.AddToBuffer(FvBuffer, FvBaseAddress, BlockSize, BlockNum, ErasePolarity, vtfDict)
 | 
						|
                        if FvBuffer.len > Size:
 | 
						|
                            FvBuffer.close()
 | 
						|
                            EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                            "Size of FV (%s) is larger than Region Size 0x%X specified." % (RegionData, Size))
 | 
						|
                        #
 | 
						|
                        # Put the generated image into FD buffer.
 | 
						|
                        #
 | 
						|
                        Buffer.write(FvBuffer.getvalue())
 | 
						|
                        FvBuffer.close()
 | 
						|
                        FvOffset = FvOffset + FvBuffer.len
 | 
						|
                        Size = Size - FvBuffer.len
 | 
						|
                        continue
 | 
						|
                    else:
 | 
						|
                        EdkLogger.error("GenFds", GENFDS_ERROR, "FV (%s) is NOT described in FDF file!" % (RegionData))
 | 
						|
                #
 | 
						|
                # Add the exist Fv image into FD buffer
 | 
						|
                #
 | 
						|
                if FileName != None:
 | 
						|
                    FileLength = os.stat(FileName)[ST_SIZE]
 | 
						|
                    if FileLength > Size:
 | 
						|
                        EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                        "Size of FV File (%s) is larger than Region Size 0x%X specified." \
 | 
						|
                                        % (RegionData, Size))
 | 
						|
                    BinFile = open (FileName, 'r+b')
 | 
						|
                    Buffer.write(BinFile.read())
 | 
						|
                    BinFile.close()
 | 
						|
                    Size = Size - FileLength
 | 
						|
            #
 | 
						|
            # Pad the left buffer
 | 
						|
            #
 | 
						|
            if Size > 0:
 | 
						|
                if (ErasePolarity == '1') :
 | 
						|
                    PadData = 0xFF
 | 
						|
                else :
 | 
						|
                    PadData = 0
 | 
						|
                for i in range(0, Size):
 | 
						|
                    Buffer.write(pack('B', PadData))
 | 
						|
 | 
						|
        if self.RegionType == 'CAPSULE':
 | 
						|
            #
 | 
						|
            # Get Capsule from Capsule Dict
 | 
						|
            #
 | 
						|
            for RegionData in self.RegionDataList:
 | 
						|
                if RegionData.endswith(".cap"):
 | 
						|
                    RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
 | 
						|
                    GenFdsGlobalVariable.InfLogger('   Region CAPSULE Image Name = .cap : %s'%RegionData)
 | 
						|
                    if RegionData[1] != ':' :
 | 
						|
                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
 | 
						|
                    if not os.path.exists(RegionData):
 | 
						|
                        EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
 | 
						|
 | 
						|
                    FileName = RegionData
 | 
						|
                elif RegionData.upper() + 'cap' in ImageBinDict.keys():
 | 
						|
                    GenFdsGlobalVariable.InfLogger('   Region Name = CAPSULE')
 | 
						|
                    FileName = ImageBinDict[RegionData.upper() + 'cap']
 | 
						|
                else:
 | 
						|
                    #
 | 
						|
                    # Generate Capsule image and Put it into FD buffer
 | 
						|
                    #
 | 
						|
                    CapsuleObj = None
 | 
						|
                    if RegionData.upper() in GenFdsGlobalVariable.FdfParser.Profile.CapsuleDict.keys():
 | 
						|
                        CapsuleObj = GenFdsGlobalVariable.FdfParser.Profile.CapsuleDict[RegionData.upper()]
 | 
						|
 | 
						|
                    if CapsuleObj != None :
 | 
						|
                        CapsuleObj.CapsuleName = RegionData.upper()
 | 
						|
                        GenFdsGlobalVariable.InfLogger('   Region Name = CAPSULE')
 | 
						|
                        #
 | 
						|
                        # Call GenFv tool to generate Capsule Image
 | 
						|
                        #
 | 
						|
                        FileName = CapsuleObj.GenCapsule()
 | 
						|
                        CapsuleObj.CapsuleName = None
 | 
						|
                    else:
 | 
						|
                        EdkLogger.error("GenFds", GENFDS_ERROR, "Capsule (%s) is NOT described in FDF file!" % (RegionData))
 | 
						|
 | 
						|
                #
 | 
						|
                # Add the capsule image into FD buffer
 | 
						|
                #
 | 
						|
                FileLength = os.stat(FileName)[ST_SIZE]
 | 
						|
                if FileLength > Size:
 | 
						|
                    EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                    "Size 0x%X of Capsule File (%s) is larger than Region Size 0x%X specified." \
 | 
						|
                                    % (FileLength, RegionData, Size))
 | 
						|
                BinFile = open (FileName, 'r+b')
 | 
						|
                Buffer.write(BinFile.read())
 | 
						|
                BinFile.close()
 | 
						|
                Size = Size - FileLength
 | 
						|
            #
 | 
						|
            # Pad the left buffer
 | 
						|
            #
 | 
						|
            if Size > 0:
 | 
						|
                if (ErasePolarity == '1') :
 | 
						|
                    PadData = 0xFF
 | 
						|
                else :
 | 
						|
                    PadData = 0
 | 
						|
                for i in range(0, Size):
 | 
						|
                    Buffer.write(pack('B', PadData))
 | 
						|
 | 
						|
        if self.RegionType == 'FILE':
 | 
						|
            for RegionData in self.RegionDataList:
 | 
						|
                RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
 | 
						|
                if RegionData[1] != ':' :
 | 
						|
                    RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
 | 
						|
                if not os.path.exists(RegionData):
 | 
						|
                    EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
 | 
						|
                #
 | 
						|
                # Add the file image into FD buffer
 | 
						|
                #
 | 
						|
                FileLength = os.stat(RegionData)[ST_SIZE]
 | 
						|
                if FileLength > Size:
 | 
						|
                    EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                    "Size of File (%s) is larger than Region Size 0x%X specified." \
 | 
						|
                                    % (RegionData, Size))
 | 
						|
                GenFdsGlobalVariable.InfLogger('   Region File Name = %s'%RegionData)
 | 
						|
                BinFile = open (RegionData, 'r+b')
 | 
						|
                Buffer.write(BinFile.read())
 | 
						|
                BinFile.close()
 | 
						|
                Size = Size - FileLength
 | 
						|
            #
 | 
						|
            # Pad the left buffer
 | 
						|
            #
 | 
						|
            if Size > 0:
 | 
						|
                if (ErasePolarity == '1') :
 | 
						|
                    PadData = 0xFF
 | 
						|
                else :
 | 
						|
                    PadData = 0
 | 
						|
                for i in range(0, Size):
 | 
						|
                    Buffer.write(pack('B', PadData))
 | 
						|
 | 
						|
        if self.RegionType == 'DATA' :
 | 
						|
            GenFdsGlobalVariable.InfLogger('   Region Name = DATA')
 | 
						|
            DataSize = 0
 | 
						|
            for RegionData in self.RegionDataList:
 | 
						|
                Data = RegionData.split(',')
 | 
						|
                DataSize = DataSize + len(Data)
 | 
						|
                if DataSize > Size:
 | 
						|
                   EdkLogger.error("GenFds", GENFDS_ERROR, "Size of DATA is larger than Region Size ")
 | 
						|
                else:
 | 
						|
                    for item in Data :
 | 
						|
                        Buffer.write(pack('B', int(item, 16)))
 | 
						|
                Size = Size - DataSize
 | 
						|
            #
 | 
						|
            # Pad the left buffer
 | 
						|
            #
 | 
						|
            if Size > 0:
 | 
						|
                if (ErasePolarity == '1') :
 | 
						|
                    PadData = 0xFF
 | 
						|
                else :
 | 
						|
                    PadData = 0
 | 
						|
                for i in range(0, Size):
 | 
						|
                    Buffer.write(pack('B', PadData))
 | 
						|
 | 
						|
        if self.RegionType == None:
 | 
						|
            GenFdsGlobalVariable.InfLogger('   Region Name = None')
 | 
						|
            if (ErasePolarity == '1') :
 | 
						|
                PadData = 0xFF
 | 
						|
            else :
 | 
						|
                PadData = 0
 | 
						|
            for i in range(0, Size):
 | 
						|
                Buffer.write(pack('B', PadData))
 | 
						|
 | 
						|
    def GetFvAlignValue(self, Str):
 | 
						|
        AlignValue = 1
 | 
						|
        Granu = 1
 | 
						|
        Str = Str.strip().upper()
 | 
						|
        if Str.endswith('K'):
 | 
						|
            Granu = 1024
 | 
						|
            Str = Str[:-1]
 | 
						|
        elif Str.endswith('M'):
 | 
						|
            Granu = 1024*1024
 | 
						|
            Str = Str[:-1]
 | 
						|
        elif Str.endswith('G'):
 | 
						|
            Granu = 1024*1024*1024
 | 
						|
            Str = Str[:-1]
 | 
						|
        else:
 | 
						|
            pass
 | 
						|
 | 
						|
        AlignValue = int(Str)*Granu
 | 
						|
        return AlignValue
 | 
						|
    ## BlockSizeOfRegion()
 | 
						|
    #
 | 
						|
    #   @param  BlockSizeList        List of block information
 | 
						|
    #   @retval int                  Block size of region
 | 
						|
    #
 | 
						|
    def BlockSizeOfRegion(self, BlockSizeList):
 | 
						|
        Offset = 0x00
 | 
						|
        BlockSize = 0
 | 
						|
        for item in BlockSizeList:
 | 
						|
            Offset = Offset + item[0]  * item[1]
 | 
						|
            GenFdsGlobalVariable.VerboseLogger ("Offset = 0x%X" %Offset)
 | 
						|
            GenFdsGlobalVariable.VerboseLogger ("self.Offset 0x%X" %self.Offset)
 | 
						|
 | 
						|
            if self.Offset < Offset :
 | 
						|
                if Offset - self.Offset < self.Size:
 | 
						|
                    EdkLogger.error("GenFds", GENFDS_ERROR,
 | 
						|
                                    "Region at Offset 0x%X can NOT fit into Block array with BlockSize %X" \
 | 
						|
                                    % (self.Offset, item[0]))
 | 
						|
                BlockSize = item[0]
 | 
						|
                GenFdsGlobalVariable.VerboseLogger ("BlockSize = %X" %BlockSize)
 | 
						|
                return BlockSize
 | 
						|
        return BlockSize
 | 
						|
 | 
						|
    ## BlockNumOfRegion()
 | 
						|
    #
 | 
						|
    #   @param  BlockSize            block size of region
 | 
						|
    #   @retval int                  Block number of region
 | 
						|
    #
 | 
						|
    def BlockNumOfRegion (self, BlockSize):
 | 
						|
        if BlockSize == 0 :
 | 
						|
            EdkLogger.error("GenFds", GENFDS_ERROR, "Region: %s is not in the FD address scope!" % self.Offset)
 | 
						|
        BlockNum = self.Size / BlockSize
 | 
						|
        GenFdsGlobalVariable.VerboseLogger ("BlockNum = 0x%X" %BlockNum)
 | 
						|
        return BlockNum
 | 
						|
 |