[mirror_edk2.git] / Tools / Source / GenBuild / org / tianocore / build / fpd / FpdParserTask.java

/** @file\r
 This file is ANT task FpdParserTask. \r
 \r
 FpdParserTask is used to parse FPD (Framework Platform Description) and generate\r
 build.out.xml. It is for Package or Platform build use. \r
 \r
 Copyright (c) 2006, Intel Corporation\r
 All rights reserved. This program and the accompanying materials\r
 are licensed and made available under the terms and conditions of the BSD License\r
 which accompanies this distribution.  The full text of the license may be found at\r
 http://opensource.org/licenses/bsd-license.php\r
\r
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 **/\r
package org.tianocore.build.fpd;\r
\r
import java.io.BufferedWriter;\r
import java.io.File;\r
import java.io.FileWriter;\r
import java.util.HashMap;\r
import java.util.Iterator;\r
import java.util.LinkedHashMap;\r
import java.util.LinkedHashSet;\r
import java.util.Map;\r
import java.util.Set;\r
import java.util.Vector;\r
\r
import org.apache.tools.ant.BuildException;\r
import org.apache.tools.ant.Task;\r
import org.apache.tools.ant.taskdefs.Ant;\r
import org.apache.tools.ant.taskdefs.Property;\r
import org.apache.xmlbeans.XmlObject;\r
\r
import org.tianocore.build.global.GlobalData;\r
import org.tianocore.build.global.OutputManager;\r
import org.tianocore.build.global.SurfaceAreaQuery;\r
import org.tianocore.build.id.FpdModuleIdentification;\r
import org.tianocore.build.id.ModuleIdentification;\r
import org.tianocore.build.id.PlatformIdentification;\r
import org.tianocore.pcd.action.ActionMessage;\r
import org.tianocore.build.pcd.action.PlatformPcdPreprocessActionForBuilding;\r
import org.tianocore.build.toolchain.ToolChainAttribute;\r
import org.tianocore.build.toolchain.ToolChainElement;\r
import org.tianocore.build.toolchain.ToolChainMap;\r
import org.tianocore.exception.EdkException;\r
\r
/**\r
  <code>FpdParserTask</code> is an ANT task. The main function is parsing Framework\r
  Platform Descritpion (FPD) XML file and generating its ANT build script for \r
  corresponding platform.  \r
\r
  <p>The task sets global properties PLATFORM, PLATFORM_DIR, PLATFORM_RELATIVE_DIR\r
  and BUILD_DIR. </p>\r
  \r
  <p>The task generates ${PLATFORM}_build.xml file which will be called by top level\r
  build.xml. The task also generate Fv.inf files (File is for Tool GenFvImage) \r
  and flash definition file (File is for Tool FlashMap) if necessary. </p>\r
  \r
  <p>FpdParserTask task stores all FPD information to GlobalData. And parse\r
  tools definition file to set up compiler options for different Target and\r
  different ToolChainTag. </p>\r
  \r
  <p>The method parseFpdFile is also prepared for single module build. </p>\r
  \r
  <p>The usage is (take NT32 Platform for example):</p>\r
\r
  <pre>\r
  &lt;FPDParser platformName="Nt32" /&gt;\r
  </pre>\r
\r
  <p>The task will initialize all information through parsing Framework Database, \r
  SPD, Tool chain configuration files. </p>\r
\r
  @since GenBuild 1.0\r
**/\r
public class FpdParserTask extends Task {\r
    \r
    private String platformName;\r
\r
    private File fpdFile = null;\r
    \r
    private PlatformIdentification platformId;\r
    \r
    ///\r
    /// \r
    ///\r
    private String type;\r
    \r
    ///\r
    /// Mapping from modules identification to out put file name\r
    ///\r
    private Map<FpdModuleIdentification, String> outfiles = new LinkedHashMap<FpdModuleIdentification, String>();\r
\r
    ///\r
    /// Mapping from FV name to its modules\r
    ///\r
    private Map<String, Set<FpdModuleIdentification>> fvs = new HashMap<String, Set<FpdModuleIdentification>>();\r
\r
    ///\r
    /// FpdParserTask can specify some ANT properties. \r
    ///\r
    private Vector<Property> properties = new Vector<Property>();\r
    \r
    private boolean isUnified = true;\r
\r
\r
    /**\r
      Public construct method. It is necessary for ANT task.\r
    **/\r
    public FpdParserTask() {\r
    }\r
\r
    /**\r
     ANT task's entry method. The main steps is described as following: \r
     \r
     <ul>\r
     <li>Initialize global information (Framework DB, SPD files and all MSA files \r
     listed in SPD). This step will execute only once in whole build process;</li>\r
     <li>Parse specified FPD file; </li>\r
     <li>Generate FV.inf files; </li>\r
     <li>Generate PlatformName_build.xml file for Flatform build; </li>\r
     <li>Collect PCD information. </li>\r
     </ul>\r
     \r
     @throws BuildException\r
     Surface area is not valid. \r
    **/\r
    public void execute() throws BuildException {\r
        // Remove !!\r
        if ( fpdFile == null) {\r
            if (platformName == null) {\r
                throw new BuildException("FpdParserTask parameter error. Please specify either the platform name or FPD file!");\r
            }\r
            platformId = GlobalData.getPlatformByName(platformName);\r
            fpdFile = platformId.getFpdFile();\r
        }\r
        \r
        //\r
        // Parse FPD file\r
        //\r
        parseFpdFile();\r
        \r
        //\r
        // Prepare BUILD_DIR\r
        //\r
        isUnified = OutputManager.getInstance().prepareBuildDir(getProject());\r
        \r
        //\r
        // For every Target and ToolChain\r
        //\r
        String[] targetList = GlobalData.getToolChainInfo().getTargets();\r
        for (int i = 0; i < targetList.length; i++){\r
            String[] toolchainList = GlobalData.getToolChainInfo().getTagnames();\r
            for(int j = 0; j < toolchainList.length; j++){\r
                //\r
                // Prepare FV_DIR\r
                //\r
                String ffsCommonDir = getProject().getProperty("BUILD_DIR") + File.separatorChar \r
                                + targetList[i] + File.separatorChar \r
                                + toolchainList[j];\r
                File fvDir = new File(ffsCommonDir + File.separatorChar + "FV");\r
                fvDir.mkdirs();\r
                getProject().setProperty("FV_DIR", fvDir.getPath().replaceAll("(\\\\)", "/"));\r
                \r
                //\r
                // Gen Fv.inf files\r
                //\r
                genFvInfFiles(ffsCommonDir);\r
            }\r
        }\r
\r
        //\r
        // Gen build.xml\r
        //\r
        PlatformBuildFileGenerator fileGenerator = new PlatformBuildFileGenerator(getProject(), outfiles, isUnified);\r
        fileGenerator.genBuildFile();\r
        \r
        //\r
        // Ant call ${PLATFORM}_build.xml\r
        //\r
        \r
        Ant ant = new Ant();\r
        ant.setProject(getProject());\r
        ant.setAntfile(platformId.getFpdFile().getParent() + File.separatorChar + platformId.getName() + "_build.xml");\r
        ant.setTarget(type);\r
        ant.setInheritAll(true);\r
        ant.init();\r
        ant.execute();\r
        \r
//        GlobalData.log.info("Fpd build end. ");\r
    }\r
\r
    /**\r
      Generate Fv.inf files. The Fv.inf file is composed with four \r
      parts: Options, Attributes, Components and Files. The Fv.inf files \r
      will be under FV_DIR.\r
     \r
      @throws BuildException\r
                  File write FV.inf files error. \r
    **/\r
    private void genFvInfFiles(String ffsCommonDir) throws BuildException {\r
        String[] validFv = SurfaceAreaQuery.getFpdValidImageNames();\r
        for (int i = 0; i < validFv.length; i++) {\r
            //\r
            // Get all global variables from FPD and set them to properties\r
            //\r
            String[][] globalVariables = SurfaceAreaQuery.getFpdGlobalVariable();\r
            for (int j = 0; j < globalVariables.length; j++) {\r
                getProject().setProperty(globalVariables[j][0], globalVariables[j][1]);\r
            }\r
\r
            getProject().setProperty("FV_FILENAME", validFv[i]);\r
            \r
            File fvFile = new File(getProject().replaceProperties( getProject().getProperty("FV_DIR") + File.separatorChar + validFv[i] + ".inf"));\r
            fvFile.getParentFile().mkdirs();\r
\r
            try {\r
                FileWriter fw = new FileWriter(fvFile);\r
                BufferedWriter bw = new BufferedWriter(fw);\r
                \r
                //\r
                // Options\r
                //\r
                String[][] options = SurfaceAreaQuery.getFpdOptions(validFv[i]);\r
                if (options.length > 0) {\r
                    bw.write("[options]");\r
                    bw.newLine();\r
                    for (int j = 0; j < options.length; j++) {\r
                        StringBuffer str = new StringBuffer(100);\r
                        str.append(options[j][0]);\r
                        while (str.length() < 40) {\r
                            str.append(' ');\r
                        }\r
                        str.append("=  ");\r
                        str.append(options[j][1]);\r
                        bw.write(getProject().replaceProperties(str.toString()));\r
                        bw.newLine();\r
                    }\r
                    bw.newLine();\r
                }\r
                \r
                //\r
                // Attributes;\r
                //\r
                String[][] attributes = SurfaceAreaQuery.getFpdAttributes(validFv[i]);\r
                if (attributes.length > 0) {\r
                    bw.write("[attributes]");\r
                    bw.newLine();\r
                    for (int j = 0; j < attributes.length; j++) {\r
                        StringBuffer str = new StringBuffer(100);\r
                        str.append(attributes[j][0]);\r
                        while (str.length() < 40) {\r
                            str.append(' ');\r
                        }\r
                        str.append("=  ");\r
                        str.append(attributes[j][1]);\r
                        bw.write(getProject().replaceProperties(str.toString()));\r
                        bw.newLine();\r
                    }\r
                    bw.newLine();\r
                }\r
                \r
                //\r
                // Components\r
                //\r
                String[][] components = SurfaceAreaQuery.getFpdComponents(validFv[i]);\r
                if (components.length > 0) {\r
                    bw.write("[components]");\r
                    bw.newLine();\r
                    for (int j = 0; j < components.length; j++) {\r
                        StringBuffer str = new StringBuffer(100);\r
                        str.append(components[j][0]);\r
                        while (str.length() < 40) {\r
                            str.append(' ');\r
                        }\r
                        str.append("=  ");\r
                        str.append(components[j][1]);\r
                        bw.write(getProject().replaceProperties(str.toString()));\r
                        bw.newLine();\r
                    }\r
                    bw.newLine();\r
                }\r
                \r
                //\r
                // Files\r
                //\r
                Set<FpdModuleIdentification> filesSet = fvs.get(validFv[i]);\r
                if (filesSet != null) {\r
                    FpdModuleIdentification[] files = filesSet.toArray(new FpdModuleIdentification[filesSet.size()]);\r
                    bw.write("[files]");\r
                    bw.newLine();\r
                    for (int j = 0; j < files.length; j++) {\r
                        String str = ffsCommonDir + File.separatorChar + outfiles.get(files[j]);\r
                        bw.write(getProject().replaceProperties("EFI_FILE_NAME = " + str));\r
                        bw.newLine();\r
                    }\r
                }\r
                bw.flush();\r
                bw.close();\r
                fw.close();\r
            } catch (Exception e) {\r
                throw new BuildException("Generation of the FV file [" + fvFile.getPath() + "] failed!\n" + e.getMessage());\r
            }\r
        }\r
    }\r
    /**\r
      This method is used for Single Module Build.\r
      \r
      \r
      @throws BuildException\r
                  FPD file is not valid. \r
    **/\r
    public void parseFpdFile(File fpdFile) throws BuildException {\r
        this.fpdFile = fpdFile;\r
        parseFpdFile();\r
    }\r
\r
    /**\r
      Parse FPD file. \r
     \r
      @throws BuildException\r
                  FPD file is not valid. \r
     **/\r
    private void parseFpdFile() throws BuildException {\r
        try {\r
            XmlObject doc = XmlObject.Factory.parse(fpdFile);\r
            \r
            if (!doc.validate()) {\r
                throw new BuildException("Platform Surface Area file [" + fpdFile.getPath() + "] format is invalid!");\r
            }\r
            \r
            Map<String, XmlObject> map = new HashMap<String, XmlObject>();\r
            map.put("PlatformSurfaceArea", doc);\r
            SurfaceAreaQuery.setDoc(map);\r
\r
            //\r
            // Initialize\r
            //\r
            platformId = SurfaceAreaQuery.getFpdHeader();\r
            platformId.setFpdFile(fpdFile);\r
            getProject().setProperty("PLATFORM", platformId.getName());\r
            getProject().setProperty("PLATFORM_FILE", platformId.getRelativeFpdFile().replaceAll("(\\\\)", "/"));\r
            getProject().setProperty("PLATFORM_DIR", platformId.getFpdFile().getParent().replaceAll("(\\\\)", "/"));\r
            getProject().setProperty("PLATFORM_RELATIVE_DIR", platformId.getPlatformRelativeDir().replaceAll("(\\\\)", "/"));\r
\r
            //\r
            // Build mode. User-defined output dir. \r
            //\r
            String buildMode = SurfaceAreaQuery.getFpdIntermediateDirectories();\r
            String userDefinedOutputDir = SurfaceAreaQuery.getFpdOutputDirectory();\r
\r
            OutputManager.getInstance().setup(userDefinedOutputDir, buildMode);\r
\r
            //\r
            // TBD. Deal PCD and BuildOption related Info\r
            //\r
            GlobalData.setFpdBuildOptions(SurfaceAreaQuery.getFpdBuildOptions());\r
            \r
            GlobalData.setToolChainPlatformInfo(SurfaceAreaQuery.getFpdToolChainInfo());\r
            \r
            //\r
            // Parse all list modules SA\r
            //\r
            parseModuleSAFiles();\r
\r
            //\r
            // TBD. Deal PCD and BuildOption related Info\r
            //\r
            parseToolChainFamilyOptions();\r
            parseToolChainOptions();\r
\r
            SurfaceAreaQuery.setDoc(map);\r
            \r
            //\r
            // Pcd Collection. Call CollectPCDAction to collect pcd info.\r
            //\r
            PlatformPcdPreprocessActionForBuilding ca = new PlatformPcdPreprocessActionForBuilding();\r
            ca.perform(platformId.getFpdFile().getPath(), ActionMessage.NULL_MESSAGE_LEVEL);\r
        } catch (Exception e) {\r
            throw new BuildException("Parsing of the FPD file [" + fpdFile.getPath() + "] failed!\n" + e.getMessage());\r
        }\r
    }\r
\r
\r
    \r
    /**\r
      Parse all modules listed in FPD file. \r
    **/\r
    private void parseModuleSAFiles() throws EdkException{\r
        Map<FpdModuleIdentification, Map<String, XmlObject>> moduleSAs = SurfaceAreaQuery.getFpdModules();\r
\r
        //\r
        // For every Module lists in FPD file.\r
        //\r
        Set<FpdModuleIdentification> keys = moduleSAs.keySet();\r
        Iterator iter = keys.iterator();\r
        while (iter.hasNext()) {\r
            FpdModuleIdentification fpdModuleId = (FpdModuleIdentification) iter.next();\r
            \r
            //\r
            // Judge if Module is existed? \r
            // TBD\r
            \r
            GlobalData.registerFpdModuleSA(fpdModuleId, moduleSAs.get(fpdModuleId));\r
\r
            //\r
            // Put fpdModuleId to the corresponding FV\r
            //\r
            SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
            String fvBinding = SurfaceAreaQuery.getModuleFvBindingKeyword();\r
            SurfaceAreaQuery.pop();\r
\r
            fpdModuleId.setFvBinding(fvBinding);\r
            updateFvs(fvBinding, fpdModuleId);\r
            \r
            //\r
            // Prepare for out put file name\r
            //\r
            ModuleIdentification moduleId = fpdModuleId.getModule();\r
            SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
            String baseName = SurfaceAreaQuery.getModuleOutputFileBasename();\r
            SurfaceAreaQuery.pop();\r
            if (baseName == null) {\r
                baseName = moduleId.getName();\r
            }\r
            outfiles.put(fpdModuleId, fpdModuleId.getArch() + File.separatorChar \r
                         + moduleId.getGuid() + "-" + baseName \r
                         + getSuffix(moduleId.getModuleType()));\r
\r
            //\r
            // parse module build options, if any\r
            // \r
            SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
            GlobalData.addModuleToolChainOption(fpdModuleId, parseModuleBuildOptions(false));\r
            GlobalData.addModuleToolChainFamilyOption(fpdModuleId, parseModuleBuildOptions(true));\r
            SurfaceAreaQuery.pop();\r
        }\r
    }\r
\r
    private ToolChainMap parseModuleBuildOptions(boolean toolChainFamilyFlag) throws EdkException {\r
        String[][] options = SurfaceAreaQuery.getModuleBuildOptions(toolChainFamilyFlag);\r
        if (options == null || options.length == 0) {\r
            return null;\r
        }\r
        return parseOptions(options);\r
    }\r
    \r
    private ToolChainMap parsePlatformBuildOptions(boolean toolChainFamilyFlag) throws EdkException {\r
        String[][] options = SurfaceAreaQuery.getPlatformBuildOptions(toolChainFamilyFlag);\r
        if (options == null || options.length == 0) {\r
            return null;\r
        }\r
        return parseOptions(options);\r
    }\r
\r
    private ToolChainMap parseOptions(String[][] options) throws EdkException {\r
        ToolChainMap map = new ToolChainMap();\r
        int flagIndex = ToolChainElement.ATTRIBUTE.value;\r
\r
        for (int i = 0; i < options.length; ++i) {\r
            String flagString = options[i][flagIndex];\r
            if (flagString == null) {\r
                flagString = "";\r
            }\r
            options[i][flagIndex] = ToolChainAttribute.FLAGS + "";\r
            map.put(options[i], flagString.trim());\r
        }\r
\r
        return map;\r
    }\r
    \r
    private void parseToolChainFamilyOptions() throws EdkException {\r
        GlobalData.setPlatformToolChainFamilyOption(parsePlatformBuildOptions(true));\r
    }\r
\r
    private void parseToolChainOptions() throws EdkException {\r
        GlobalData.setPlatformToolChainOption(parsePlatformBuildOptions(false));\r
    }\r
\r
    /**\r
      Add the current module to corresponding FV. \r
     \r
      @param fvName current FV name\r
      @param moduleName current module identification\r
    **/\r
    private void updateFvs(String fvName, FpdModuleIdentification fpdModuleId) {\r
        if (fvName == null || fvName.trim().length() == 0) {\r
            fvName = "NULL";\r
        }\r
        String[] fvNameArray = fvName.split("[, \t]+");\r
        for (int i = 0; i < fvNameArray.length; i++) {\r
            //\r
            // Put module to corresponding fvName\r
            //\r
            if (fvs.containsKey(fvNameArray[i])) {\r
                Set<FpdModuleIdentification> set = fvs.get(fvNameArray[i]);\r
                set.add(fpdModuleId);\r
            }\r
            else {\r
                Set<FpdModuleIdentification> set = new LinkedHashSet<FpdModuleIdentification>();\r
                set.add(fpdModuleId);\r
                fvs.put(fvNameArray[i], set);\r
            }\r
        }\r
    }\r
\r
    /**\r
      Get the suffix based on module type. Current relationship are listed:  \r
      \r
      <pre>\r
      <b>ModuleType</b>     <b>Suffix</b>\r
      BASE                 .FFS\r
      SEC                  .SEC\r
      PEI_CORE             .PEI\r
      PEIM                 .PEI\r
      DXE_CORE             .DXE\r
      DXE_DRIVER           .DXE\r
      DXE_RUNTIME_DRIVER   .DXE\r
      DXE_SAL_DRIVER       .DXE\r
      DXE_SMM_DRIVER       .DXE\r
      TOOL                 .FFS\r
      UEFI_DRIVER          .DXE\r
      UEFI_APPLICATION     .APP\r
      USER_DEFINED         .FFS\r
      </pre>\r
     \r
      @param moduleType module type\r
      @return\r
      @throws BuildException\r
      If module type is null\r
    **/\r
    public static String getSuffix(String moduleType) throws BuildException {\r
        if (moduleType == null) {\r
            throw new BuildException("Module type is not specified.");\r
        }\r
\r
        String[][] suffix = { { "BASE", ".FFS"},\r
                              { "SEC", ".SEC" }, { "PEI_CORE", ".PEI" }, \r
                              { "PEIM", ".PEI" }, { "DXE_CORE", ".DXE" },\r
                              { "DXE_DRIVER", ".DXE" }, { "DXE_RUNTIME_DRIVER", ".DXE" }, \r
                              { "DXE_SAL_DRIVER", ".DXE" }, { "DXE_SMM_DRIVER", ".DXE" }, \r
                              { "TOOL", ".FFS" }, { "UEFI_DRIVER", ".DXE" },\r
                              { "UEFI_APPLICATION", ".APP" }, { "USER_DEFINED", ".FFS" } };\r
        \r
        for (int i = 0; i < suffix.length; i++) {\r
            if (suffix[i][0].equalsIgnoreCase(moduleType)) {\r
                return suffix[i][1];\r
            }\r
        }\r
        //\r
        // Default is '.FFS'\r
        //\r
        return ".FFS";\r
    }\r
    /**\r
     Add a property. \r
     \r
     @param p property\r
     **/\r
    public void addProperty(Property p) {\r
        properties.addElement(p);\r
    }\r
\r
    public void setPlatformName(String platformName) {\r
        this.platformName = platformName;\r
    }\r
\r
    public void setFpdFile(File fpdFile) {\r
        this.fpdFile = fpdFile;\r
    }\r
\r
    public void setType(String type) {\r
        this.type = type;\r
    }\r
    \r
\r
}\r
Commit	Line	Data
878ddf1f	1	/** @file\r
a29c47e0	2	This file is ANT task FpdParserTask. \r
878ddf1f	3	\r
a29c47e0	4	FpdParserTask is used to parse FPD (Framework Platform Description) and generate\r
a29c47e0	5	build.out.xml. It is for Package or Platform build use. \r
878ddf1f	6	\r
a29c47e0	7	Copyright (c) 2006, Intel Corporation\r
	8	All rights reserved. This program and the accompanying materials\r
	9	are licensed and made available under the terms and conditions of the BSD License\r
	10	which accompanies this distribution. The full text of the license may be found at\r
	11	http://opensource.org/licenses/bsd-license.php\r
	12	\r
	13	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	14	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	15	**/\r
878ddf1f	16	package org.tianocore.build.fpd;\r
	17	\r
	18	import java.io.BufferedWriter;\r
	19	import java.io.File;\r
	20	import java.io.FileWriter;\r
	21	import java.util.HashMap;\r
	22	import java.util.Iterator;\r
	23	import java.util.LinkedHashMap;\r
	24	import java.util.LinkedHashSet;\r
	25	import java.util.Map;\r
	26	import java.util.Set;\r
	27	import java.util.Vector;\r
878ddf1f	28	\r
	29	import org.apache.tools.ant.BuildException;\r
	30	import org.apache.tools.ant.Task;\r
a29c47e0	31	import org.apache.tools.ant.taskdefs.Ant;\r
878ddf1f	32	import org.apache.tools.ant.taskdefs.Property;\r
878ddf1f	33	import org.apache.xmlbeans.XmlObject;\r
878ddf1f	34	\r
	35	import org.tianocore.build.global.GlobalData;\r
	36	import org.tianocore.build.global.OutputManager;\r
878ddf1f	37	import org.tianocore.build.global.SurfaceAreaQuery;\r
a29c47e0	38	import org.tianocore.build.id.FpdModuleIdentification;\r
	39	import org.tianocore.build.id.ModuleIdentification;\r
	40	import org.tianocore.build.id.PlatformIdentification;\r
d14ebb43	41	import org.tianocore.pcd.action.ActionMessage;\r
af98370e	42	import org.tianocore.build.pcd.action.PlatformPcdPreprocessActionForBuilding;\r
a29c47e0	43	import org.tianocore.build.toolchain.ToolChainAttribute;\r
	44	import org.tianocore.build.toolchain.ToolChainElement;\r
	45	import org.tianocore.build.toolchain.ToolChainMap;\r
136adffc	46	import org.tianocore.exception.EdkException;\r
878ddf1f	47	\r
878ddf1f	48	/**\r
a29c47e0	49	<code>FpdParserTask</code> is an ANT task. The main function is parsing Framework\r
	50	Platform Descritpion (FPD) XML file and generating its ANT build script for \r
	51	corresponding platform. \r
	52	\r
	53	<p>The task sets global properties PLATFORM, PLATFORM_DIR, PLATFORM_RELATIVE_DIR\r
	54	and BUILD_DIR. </p>\r
878ddf1f	55	\r
a29c47e0	56	<p>The task generates ${PLATFORM}_build.xml file which will be called by top level\r
	57	build.xml. The task also generate Fv.inf files (File is for Tool GenFvImage) \r
	58	and flash definition file (File is for Tool FlashMap) if necessary. </p>\r
	59	\r
	60	<p>FpdParserTask task stores all FPD information to GlobalData. And parse\r
	61	tools definition file to set up compiler options for different Target and\r
	62	different ToolChainTag. </p>\r
	63	\r
	64	<p>The method parseFpdFile is also prepared for single module build. </p>\r
878ddf1f	65	\r
a29c47e0	66	<p>The usage is (take NT32 Platform for example):</p>\r
a29c47e0	67	\r
878ddf1f	68	<pre>\r
a29c47e0	69	<FPDParser platformName="Nt32" />\r
878ddf1f	70	</pre>\r
a29c47e0	71	\r
878ddf1f	72	<p>The task will initialize all information through parsing Framework Database, \r
878ddf1f	73	SPD, Tool chain configuration files. </p>\r
a29c47e0	74	\r
878ddf1f	75	@since GenBuild 1.0\r
	76	**/\r
	77	public class FpdParserTask extends Task {\r
a29c47e0	78	\r
a29c47e0	79	private String platformName;\r
878ddf1f	80	\r
a29c47e0	81	private File fpdFile = null;\r
	82	\r
	83	private PlatformIdentification platformId;\r
	84	\r
878ddf1f	85	///\r
a29c47e0	86	/// \r
878ddf1f	87	///\r
a29c47e0	88	private String type;\r
a29c47e0	89	\r
878ddf1f	90	///\r
	91	/// Mapping from modules identification to out put file name\r
	92	///\r
	93	private Map<FpdModuleIdentification, String> outfiles = new LinkedHashMap<FpdModuleIdentification, String>();\r
	94	\r
	95	///\r
	96	/// Mapping from FV name to its modules\r
	97	///\r
a29c47e0	98	private Map<String, Set<FpdModuleIdentification>> fvs = new HashMap<String, Set<FpdModuleIdentification>>();\r
878ddf1f	99	\r
878ddf1f	100	///\r
	101	/// FpdParserTask can specify some ANT properties. \r
	102	///\r
	103	private Vector<Property> properties = new Vector<Property>();\r
a29c47e0	104	\r
a29c47e0	105	private boolean isUnified = true;\r
878ddf1f	106	\r
878ddf1f	107	\r
	108	/**\r
	109	Public construct method. It is necessary for ANT task.\r
	110	**/\r
a29c47e0	111	public FpdParserTask() {\r
878ddf1f	112	}\r
	113	\r
	114	/**\r
a29c47e0	115	ANT task's entry method. The main steps is described as following: \r
	116	\r
	117	<ul>\r
	118	<li>Initialize global information (Framework DB, SPD files and all MSA files \r
	119	listed in SPD). This step will execute only once in whole build process;</li>\r
	120	<li>Parse specified FPD file; </li>\r
	121	<li>Generate FV.inf files; </li>\r
	122	<li>Generate PlatformName_build.xml file for Flatform build; </li>\r
	123	<li>Collect PCD information. </li>\r
	124	</ul>\r
	125	\r
	126	@throws BuildException\r
	127	Surface area is not valid. \r
878ddf1f	128	**/\r
878ddf1f	129	public void execute() throws BuildException {\r
a29c47e0	130	// Remove !!\r
	131	if ( fpdFile == null) {\r
	132	if (platformName == null) {\r
391dbbb1	133	throw new BuildException("FpdParserTask parameter error. Please specify either the platform name or FPD file!");\r
a29c47e0	134	}\r
de4bb9f6	135	platformId = GlobalData.getPlatformByName(platformName);\r
a29c47e0	136	fpdFile = platformId.getFpdFile();\r
	137	}\r
	138	\r
878ddf1f	139	//\r
	140	// Parse FPD file\r
	141	//\r
	142	parseFpdFile();\r
136adffc	143	\r
a29c47e0	144	//\r
a29c47e0	145	// Prepare BUILD_DIR\r
878ddf1f	146	//\r
a29c47e0	147	isUnified = OutputManager.getInstance().prepareBuildDir(getProject());\r
a29c47e0	148	\r
a29c47e0	149	//\r
	150	// For every Target and ToolChain\r
	151	//\r
	152	String[] targetList = GlobalData.getToolChainInfo().getTargets();\r
	153	for (int i = 0; i < targetList.length; i++){\r
	154	String[] toolchainList = GlobalData.getToolChainInfo().getTagnames();\r
	155	for(int j = 0; j < toolchainList.length; j++){\r
	156	//\r
	157	// Prepare FV_DIR\r
	158	//\r
	159	String ffsCommonDir = getProject().getProperty("BUILD_DIR") + File.separatorChar \r
	160	+ targetList[i] + File.separatorChar \r
	161	+ toolchainList[j];\r
	162	File fvDir = new File(ffsCommonDir + File.separatorChar + "FV");\r
	163	fvDir.mkdirs();\r
	164	getProject().setProperty("FV_DIR", fvDir.getPath().replaceAll("(\\\\)", "/"));\r
	165	\r
	166	//\r
	167	// Gen Fv.inf files\r
	168	//\r
	169	genFvInfFiles(ffsCommonDir);\r
	170	}\r
	171	}\r
	172	\r
878ddf1f	173	//\r
	174	// Gen build.xml\r
	175	//\r
01413f0c	176	PlatformBuildFileGenerator fileGenerator = new PlatformBuildFileGenerator(getProject(), outfiles, isUnified);\r
a29c47e0	177	fileGenerator.genBuildFile();\r
	178	\r
	179	//\r
	180	// Ant call ${PLATFORM}_build.xml\r
878ddf1f	181	//\r
136adffc	182	\r
a29c47e0	183	Ant ant = new Ant();\r
	184	ant.setProject(getProject());\r
	185	ant.setAntfile(platformId.getFpdFile().getParent() + File.separatorChar + platformId.getName() + "_build.xml");\r
	186	ant.setTarget(type);\r
	187	ant.setInheritAll(true);\r
	188	ant.init();\r
	189	ant.execute();\r
	190	\r
	191	// GlobalData.log.info("Fpd build end. ");\r
878ddf1f	192	}\r
a29c47e0	193	\r
878ddf1f	194	/**\r
	195	Generate Fv.inf files. The Fv.inf file is composed with four \r
	196	parts: Options, Attributes, Components and Files. The Fv.inf files \r
a29c47e0	197	will be under FV_DIR.\r
a29c47e0	198	\r
878ddf1f	199	@throws BuildException\r
a29c47e0	200	File write FV.inf files error. \r
878ddf1f	201	**/\r
a29c47e0	202	private void genFvInfFiles(String ffsCommonDir) throws BuildException {\r
878ddf1f	203	String[] validFv = SurfaceAreaQuery.getFpdValidImageNames();\r
878ddf1f	204	for (int i = 0; i < validFv.length; i++) {\r
878ddf1f	205	//\r
	206	// Get all global variables from FPD and set them to properties\r
	207	//\r
a29c47e0	208	String[][] globalVariables = SurfaceAreaQuery.getFpdGlobalVariable();\r
878ddf1f	209	for (int j = 0; j < globalVariables.length; j++) {\r
a29c47e0	210	getProject().setProperty(globalVariables[j][0], globalVariables[j][1]);\r
878ddf1f	211	}\r
878ddf1f	212	\r
57cc2ee7	213	getProject().setProperty("FV_FILENAME", validFv[i]);\r
a29c47e0	214	\r
57cc2ee7	215	File fvFile = new File(getProject().replaceProperties( getProject().getProperty("FV_DIR") + File.separatorChar + validFv[i] + ".inf"));\r
878ddf1f	216	fvFile.getParentFile().mkdirs();\r
	217	\r
	218	try {\r
	219	FileWriter fw = new FileWriter(fvFile);\r
	220	BufferedWriter bw = new BufferedWriter(fw);\r
a29c47e0	221	\r
878ddf1f	222	//\r
	223	// Options\r
	224	//\r
	225	String[][] options = SurfaceAreaQuery.getFpdOptions(validFv[i]);\r
	226	if (options.length > 0) {\r
	227	bw.write("[options]");\r
	228	bw.newLine();\r
	229	for (int j = 0; j < options.length; j++) {\r
	230	StringBuffer str = new StringBuffer(100);\r
	231	str.append(options[j][0]);\r
	232	while (str.length() < 40) {\r
	233	str.append(' ');\r
	234	}\r
	235	str.append("= ");\r
	236	str.append(options[j][1]);\r
	237	bw.write(getProject().replaceProperties(str.toString()));\r
	238	bw.newLine();\r
	239	}\r
	240	bw.newLine();\r
	241	}\r
a29c47e0	242	\r
878ddf1f	243	//\r
	244	// Attributes;\r
	245	//\r
a29c47e0	246	String[][] attributes = SurfaceAreaQuery.getFpdAttributes(validFv[i]);\r
878ddf1f	247	if (attributes.length > 0) {\r
	248	bw.write("[attributes]");\r
	249	bw.newLine();\r
	250	for (int j = 0; j < attributes.length; j++) {\r
	251	StringBuffer str = new StringBuffer(100);\r
	252	str.append(attributes[j][0]);\r
	253	while (str.length() < 40) {\r
	254	str.append(' ');\r
	255	}\r
	256	str.append("= ");\r
	257	str.append(attributes[j][1]);\r
a29c47e0	258	bw.write(getProject().replaceProperties(str.toString()));\r
878ddf1f	259	bw.newLine();\r
	260	}\r
	261	bw.newLine();\r
	262	}\r
a29c47e0	263	\r
878ddf1f	264	//\r
	265	// Components\r
	266	//\r
a29c47e0	267	String[][] components = SurfaceAreaQuery.getFpdComponents(validFv[i]);\r
878ddf1f	268	if (components.length > 0) {\r
	269	bw.write("[components]");\r
	270	bw.newLine();\r
	271	for (int j = 0; j < components.length; j++) {\r
	272	StringBuffer str = new StringBuffer(100);\r
	273	str.append(components[j][0]);\r
	274	while (str.length() < 40) {\r
	275	str.append(' ');\r
	276	}\r
	277	str.append("= ");\r
	278	str.append(components[j][1]);\r
a29c47e0	279	bw.write(getProject().replaceProperties(str.toString()));\r
878ddf1f	280	bw.newLine();\r
	281	}\r
	282	bw.newLine();\r
	283	}\r
a29c47e0	284	\r
878ddf1f	285	//\r
	286	// Files\r
	287	//\r
57cc2ee7	288	Set<FpdModuleIdentification> filesSet = fvs.get(validFv[i]);\r
878ddf1f	289	if (filesSet != null) {\r
a29c47e0	290	FpdModuleIdentification[] files = filesSet.toArray(new FpdModuleIdentification[filesSet.size()]);\r
878ddf1f	291	bw.write("[files]");\r
	292	bw.newLine();\r
	293	for (int j = 0; j < files.length; j++) {\r
a29c47e0	294	String str = ffsCommonDir + File.separatorChar + outfiles.get(files[j]);\r
a29c47e0	295	bw.write(getProject().replaceProperties("EFI_FILE_NAME = " + str));\r
878ddf1f	296	bw.newLine();\r
	297	}\r
	298	}\r
	299	bw.flush();\r
	300	bw.close();\r
	301	fw.close();\r
	302	} catch (Exception e) {\r
391dbbb1	303	throw new BuildException("Generation of the FV file [" + fvFile.getPath() + "] failed!\n" + e.getMessage());\r
878ddf1f	304	}\r
	305	}\r
	306	}\r
a29c47e0	307	/**\r
	308	This method is used for Single Module Build.\r
	309	\r
	310	\r
	311	@throws BuildException\r
	312	FPD file is not valid. \r
	313	**/\r
	314	public void parseFpdFile(File fpdFile) throws BuildException {\r
	315	this.fpdFile = fpdFile;\r
	316	parseFpdFile();\r
	317	}\r
878ddf1f	318	\r
	319	/**\r
	320	Parse FPD file. \r
a29c47e0	321	\r
878ddf1f	322	@throws BuildException\r
a29c47e0	323	FPD file is not valid. \r
a29c47e0	324	**/\r
878ddf1f	325	private void parseFpdFile() throws BuildException {\r
878ddf1f	326	try {\r
a29c47e0	327	XmlObject doc = XmlObject.Factory.parse(fpdFile);\r
	328	\r
	329	if (!doc.validate()) {\r
391dbbb1	330	throw new BuildException("Platform Surface Area file [" + fpdFile.getPath() + "] format is invalid!");\r
878ddf1f	331	}\r
a29c47e0	332	\r
	333	Map<String, XmlObject> map = new HashMap<String, XmlObject>();\r
	334	map.put("PlatformSurfaceArea", doc);\r
878ddf1f	335	SurfaceAreaQuery.setDoc(map);\r
8031d48d	336	\r
a29c47e0	337	//\r
	338	// Initialize\r
	339	//\r
	340	platformId = SurfaceAreaQuery.getFpdHeader();\r
	341	platformId.setFpdFile(fpdFile);\r
de4bb9f6	342	getProject().setProperty("PLATFORM", platformId.getName());\r
	343	getProject().setProperty("PLATFORM_FILE", platformId.getRelativeFpdFile().replaceAll("(\\\\)", "/"));\r
	344	getProject().setProperty("PLATFORM_DIR", platformId.getFpdFile().getParent().replaceAll("(\\\\)", "/"));\r
	345	getProject().setProperty("PLATFORM_RELATIVE_DIR", platformId.getPlatformRelativeDir().replaceAll("(\\\\)", "/"));\r
a29c47e0	346	\r
	347	//\r
	348	// Build mode. User-defined output dir. \r
	349	//\r
	350	String buildMode = SurfaceAreaQuery.getFpdIntermediateDirectories();\r
	351	String userDefinedOutputDir = SurfaceAreaQuery.getFpdOutputDirectory();\r
	352	\r
	353	OutputManager.getInstance().setup(userDefinedOutputDir, buildMode);\r
	354	\r
	355	//\r
	356	// TBD. Deal PCD and BuildOption related Info\r
	357	//\r
	358	GlobalData.setFpdBuildOptions(SurfaceAreaQuery.getFpdBuildOptions());\r
	359	\r
	360	GlobalData.setToolChainPlatformInfo(SurfaceAreaQuery.getFpdToolChainInfo());\r
	361	\r
878ddf1f	362	//\r
	363	// Parse all list modules SA\r
	364	//\r
	365	parseModuleSAFiles();\r
a29c47e0	366	\r
	367	//\r
	368	// TBD. Deal PCD and BuildOption related Info\r
	369	//\r
	370	parseToolChainFamilyOptions();\r
	371	parseToolChainOptions();\r
	372	\r
878ddf1f	373	SurfaceAreaQuery.setDoc(map);\r
de4bb9f6	374	\r
	375	//\r
	376	// Pcd Collection. Call CollectPCDAction to collect pcd info.\r
	377	//\r
8b7bd455	378	PlatformPcdPreprocessActionForBuilding ca = new PlatformPcdPreprocessActionForBuilding();\r
8b7bd455	379	ca.perform(platformId.getFpdFile().getPath(), ActionMessage.NULL_MESSAGE_LEVEL);\r
878ddf1f	380	} catch (Exception e) {\r
391dbbb1	381	throw new BuildException("Parsing of the FPD file [" + fpdFile.getPath() + "] failed!\n" + e.getMessage());\r
878ddf1f	382	}\r
	383	}\r
	384	\r
a29c47e0	385	\r
a29c47e0	386	\r
878ddf1f	387	/**\r
	388	Parse all modules listed in FPD file. \r
	389	**/\r
a29c47e0	390	private void parseModuleSAFiles() throws EdkException{\r
a29c47e0	391	Map<FpdModuleIdentification, Map<String, XmlObject>> moduleSAs = SurfaceAreaQuery.getFpdModules();\r
136adffc	392	\r
878ddf1f	393	//\r
	394	// For every Module lists in FPD file.\r
	395	//\r
a29c47e0	396	Set<FpdModuleIdentification> keys = moduleSAs.keySet();\r
	397	Iterator iter = keys.iterator();\r
	398	while (iter.hasNext()) {\r
	399	FpdModuleIdentification fpdModuleId = (FpdModuleIdentification) iter.next();\r
	400	\r
878ddf1f	401	//\r
a29c47e0	402	// Judge if Module is existed? \r
	403	// TBD\r
	404	\r
	405	GlobalData.registerFpdModuleSA(fpdModuleId, moduleSAs.get(fpdModuleId));\r
	406	\r
878ddf1f	407	//\r
a29c47e0	408	// Put fpdModuleId to the corresponding FV\r
878ddf1f	409	//\r
a29c47e0	410	SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
	411	String fvBinding = SurfaceAreaQuery.getModuleFvBindingKeyword();\r
	412	SurfaceAreaQuery.pop();\r
	413	\r
	414	fpdModuleId.setFvBinding(fvBinding);\r
01413f0c	415	updateFvs(fvBinding, fpdModuleId);\r
a29c47e0	416	\r
878ddf1f	417	//\r
a29c47e0	418	// Prepare for out put file name\r
878ddf1f	419	//\r
a29c47e0	420	ModuleIdentification moduleId = fpdModuleId.getModule();\r
	421	SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
	422	String baseName = SurfaceAreaQuery.getModuleOutputFileBasename();\r
	423	SurfaceAreaQuery.pop();\r
	424	if (baseName == null) {\r
	425	baseName = moduleId.getName();\r
878ddf1f	426	}\r
a29c47e0	427	outfiles.put(fpdModuleId, fpdModuleId.getArch() + File.separatorChar \r
	428	+ moduleId.getGuid() + "-" + baseName \r
	429	+ getSuffix(moduleId.getModuleType()));\r
	430	\r
	431	//\r
	432	// parse module build options, if any\r
	433	// \r
	434	SurfaceAreaQuery.push(GlobalData.getDoc(fpdModuleId));\r
	435	GlobalData.addModuleToolChainOption(fpdModuleId, parseModuleBuildOptions(false));\r
	436	GlobalData.addModuleToolChainFamilyOption(fpdModuleId, parseModuleBuildOptions(true));\r
	437	SurfaceAreaQuery.pop();\r
878ddf1f	438	}\r
	439	}\r
	440	\r
a29c47e0	441	private ToolChainMap parseModuleBuildOptions(boolean toolChainFamilyFlag) throws EdkException {\r
	442	String[][] options = SurfaceAreaQuery.getModuleBuildOptions(toolChainFamilyFlag);\r
	443	if (options == null \|\| options.length == 0) {\r
	444	return null;\r
878ddf1f	445	}\r
a29c47e0	446	return parseOptions(options);\r
878ddf1f	447	}\r
878ddf1f	448	\r
a29c47e0	449	private ToolChainMap parsePlatformBuildOptions(boolean toolChainFamilyFlag) throws EdkException {\r
	450	String[][] options = SurfaceAreaQuery.getPlatformBuildOptions(toolChainFamilyFlag);\r
	451	if (options == null \|\| options.length == 0) {\r
	452	return null;\r
878ddf1f	453	}\r
a29c47e0	454	return parseOptions(options);\r
878ddf1f	455	}\r
878ddf1f	456	\r
a29c47e0	457	private ToolChainMap parseOptions(String[][] options) throws EdkException {\r
	458	ToolChainMap map = new ToolChainMap();\r
	459	int flagIndex = ToolChainElement.ATTRIBUTE.value;\r
	460	\r
	461	for (int i = 0; i < options.length; ++i) {\r
	462	String flagString = options[i][flagIndex];\r
	463	if (flagString == null) {\r
	464	flagString = "";\r
	465	}\r
	466	options[i][flagIndex] = ToolChainAttribute.FLAGS + "";\r
	467	map.put(options[i], flagString.trim());\r
	468	}\r
	469	\r
878ddf1f	470	return map;\r
878ddf1f	471	}\r
a29c47e0	472	\r
	473	private void parseToolChainFamilyOptions() throws EdkException {\r
	474	GlobalData.setPlatformToolChainFamilyOption(parsePlatformBuildOptions(true));\r
	475	}\r
	476	\r
	477	private void parseToolChainOptions() throws EdkException {\r
	478	GlobalData.setPlatformToolChainOption(parsePlatformBuildOptions(false));\r
	479	}\r
878ddf1f	480	\r
878ddf1f	481	/**\r
a29c47e0	482	Add the current module to corresponding FV. \r
	483	\r
	484	@param fvName current FV name\r
	485	@param moduleName current module identification\r
878ddf1f	486	**/\r
01413f0c	487	private void updateFvs(String fvName, FpdModuleIdentification fpdModuleId) {\r
fa2da5b1	488	if (fvName == null \|\| fvName.trim().length() == 0) {\r
	489	fvName = "NULL";\r
	490	}\r
57cc2ee7	491	String[] fvNameArray = fvName.split("[, \t]+");\r
a29c47e0	492	for (int i = 0; i < fvNameArray.length; i++) {\r
878ddf1f	493	//\r
a29c47e0	494	// Put module to corresponding fvName\r
878ddf1f	495	//\r
a29c47e0	496	if (fvs.containsKey(fvNameArray[i])) {\r
	497	Set<FpdModuleIdentification> set = fvs.get(fvNameArray[i]);\r
	498	set.add(fpdModuleId);\r
878ddf1f	499	}\r
878ddf1f	500	else {\r
a29c47e0	501	Set<FpdModuleIdentification> set = new LinkedHashSet<FpdModuleIdentification>();\r
	502	set.add(fpdModuleId);\r
	503	fvs.put(fvNameArray[i], set);\r
878ddf1f	504	}\r
878ddf1f	505	}\r
	506	}\r
	507	\r
	508	/**\r
a29c47e0	509	Get the suffix based on module type. Current relationship are listed: \r
878ddf1f	510	\r
a29c47e0	511	<pre>\r
	512	<b>ModuleType</b> <b>Suffix</b>\r
	513	BASE .FFS\r
	514	SEC .SEC\r
	515	PEI_CORE .PEI\r
	516	PEIM .PEI\r
	517	DXE_CORE .DXE\r
	518	DXE_DRIVER .DXE\r
	519	DXE_RUNTIME_DRIVER .DXE\r
	520	DXE_SAL_DRIVER .DXE\r
	521	DXE_SMM_DRIVER .DXE\r
	522	TOOL .FFS\r
	523	UEFI_DRIVER .DXE\r
	524	UEFI_APPLICATION .APP\r
	525	USER_DEFINED .FFS\r
	526	</pre>\r
	527	\r
	528	@param moduleType module type\r
	529	@return\r
	530	@throws BuildException\r
	531	If module type is null\r
878ddf1f	532	**/\r
a29c47e0	533	public static String getSuffix(String moduleType) throws BuildException {\r
	534	if (moduleType == null) {\r
	535	throw new BuildException("Module type is not specified.");\r
	536	}\r
878ddf1f	537	\r
a29c47e0	538	String[][] suffix = { { "BASE", ".FFS"},\r
	539	{ "SEC", ".SEC" }, { "PEI_CORE", ".PEI" }, \r
	540	{ "PEIM", ".PEI" }, { "DXE_CORE", ".DXE" },\r
	541	{ "DXE_DRIVER", ".DXE" }, { "DXE_RUNTIME_DRIVER", ".DXE" }, \r
	542	{ "DXE_SAL_DRIVER", ".DXE" }, { "DXE_SMM_DRIVER", ".DXE" }, \r
	543	{ "TOOL", ".FFS" }, { "UEFI_DRIVER", ".DXE" },\r
	544	{ "UEFI_APPLICATION", ".APP" }, { "USER_DEFINED", ".FFS" } };\r
	545	\r
	546	for (int i = 0; i < suffix.length; i++) {\r
	547	if (suffix[i][0].equalsIgnoreCase(moduleType)) {\r
	548	return suffix[i][1];\r
	549	}\r
	550	}\r
	551	//\r
	552	// Default is '.FFS'\r
	553	//\r
	554	return ".FFS";\r
878ddf1f	555	}\r
878ddf1f	556	/**\r
a29c47e0	557	Add a property. \r
	558	\r
	559	@param p property\r
	560	**/\r
	561	public void addProperty(Property p) {\r
	562	properties.addElement(p);\r
878ddf1f	563	}\r
878ddf1f	564	\r
a29c47e0	565	public void setPlatformName(String platformName) {\r
a29c47e0	566	this.platformName = platformName;\r
878ddf1f	567	}\r
878ddf1f	568	\r
a29c47e0	569	public void setFpdFile(File fpdFile) {\r
a29c47e0	570	this.fpdFile = fpdFile;\r
878ddf1f	571	}\r
878ddf1f	572	\r
a29c47e0	573	public void setType(String type) {\r
a29c47e0	574	this.type = type;\r
878ddf1f	575	}\r
a29c47e0	576	\r
a29c47e0	577	\r
878ddf1f	578	}\r