X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=BaseTools%2FReadMe.txt;h=37691e98fd985b01d06e72ccb5347a1238ddf8aa;hp=0345aa5f509b22b7ba0e1a1fdcdede75084b6261;hb=0677cc4925d580f7016ac092dc591be0ebe03495;hpb=1252ae4c4200b2675439287bb53e2e8295a1bb6a diff --git a/BaseTools/ReadMe.txt b/BaseTools/ReadMe.txt index 0345aa5f50..37691e98fd 100644 --- a/BaseTools/ReadMe.txt +++ b/BaseTools/ReadMe.txt @@ -1,16 +1,55 @@ This directory contains the next generation of EDK II build tools and template files. Templates are located in the Conf directory, while the tools executables for -Microsoft Windows 32-bit Operating Systems are located in the Bin\Win32 directory. +Microsoft Windows 32-bit Operating Systems are located in the Bin\Win32 directory, other +directory contatins tools source. -The binary tools will be updated only after passing developer testing. +1. Build step to generate the binary tools. -The BaseTools package will be updated with new tools only after all testing on a set -of binary tools has successfully completed. +=== Windows/Visual Studio Notes === + +To build the BaseTools, you should run the standard vsvars32.bat script. + +In addition to this, you should set the following environment variables: + + * EDK_TOOLS_PATH - Path to the BaseTools sub directory under the edk2 tree + * BASE_TOOLS_PATH - The directory where the BaseTools source is located. + (It is the same directory where this README.txt is located.) + * PYTHON_FREEZER_PATH - Path to where the python freezer tool is installed + +After this, you can run the toolsetup.bat file, which is in the same +directory as this file. It should setup the remainder of the environment, +and build the tools if necessary. + +Please also refer to the 'BuildNotes.txt' file for more information on +building under Windows. + +=== Unix-like operating systems === + +To build on Unix-like operating systems, you only need to type 'make' in +the base directory of the project. + +=== Ubuntu Notes === + +On Ubuntu, the following command should install all the necessary build +packages to build all the C BaseTools: + + sudo apt-get install build-essentials uuid-dev + +=== Python sqlite3 module === +On Windows, the cx_freeze will not copy the sqlite3.dll to the frozen +binary directory (the same directory as build.exe and GenFds.exe). +Please copy it manually from \DLLs. + +The Python distributed with most recent Linux will have sqlite3 module +built in. If not, please install sqlit3 package separately. + +2. The binary tools will be updated only after passing developer testing. Current state of the tools is Proto-Type - not all tool functions have been implemented and there may be bugs in these tools. These tools are under constant development at this time. +3. Tool usage introduction. BaseTools Simple Usage: 1) Change the directory to the EDK2 root directory, where the edksetup.bat is 2) Run "edksetup.bat NewBuild" @@ -27,8 +66,8 @@ Notes: or modules because the AutoGen.* files have been be removed. The "makefile" itself cannot generate AutoGen.* files. Only "build" command can. 3) All .exe binary file including C and python tools are generated from: - r1655 \BaseTools\Source\ - + r1911 \BaseTools\Source\. + Brief usage for Migration Tool MigrationMsa2Inf.exe: 1. Command line format: MigrationMsa2Inf [options] @@ -86,30 +125,7 @@ Brief usage for Migration Tool MigrationMsa2Inf.exe: f. When tool generates [LibraryClasses] section, the recommended library instances are lost. (No impact to build) 7. Pyton Source - r682 \BaseTools\Source\Python\MigrationMsa2Inf - - -Brief Usage for PcdSyntax Update: -Usage: - PcdSyntaxUpdate.exe -It searches all INF, DEC and DSC file under and update them with the following rules: -1. Update INF files to conform to INF spec 0.44: - a. Rename PCD section name: e.g. [PcdsFeatureFlag] -> [FeaturePcd] - b. Adjust PCD section item format: e.g. PcdDebugClearMemoryValue|gEfiMdePkgTokenSpaceGuid -> gEfiMdePkgTokenSpaceGuid.PcdDebugClearMemoryValue - c. Update the syntax of binary INF file (not PCD related) -2. Update DEC files to confirm to DEC spec 0.36 - Adjust PCD section item format: e.g. PcdWinNtPhysicalDisk|0x00001000|gEfiNt32PkgTokenSpaceGuid|VOID*|L"E:RW;245760;512"-> gEfiNt32PkgTokenSpaceGuid.PcdWinNtFlashFvRecoverySize|0x0|UINT32|0x00001011 -3. Update DSC files to confirm to DSC spec - a. Adjust string/array typed PCD item format: e.g. PcdWinNtMemorySizeForSecMain|gEfiNt32PkgTokenSpaceGuid|L"64!64"|12 -> gEfiNt32PkgTokenSpaceGuid.PcdWinNtMemorySizeForSecMain|L"64!64"|VOID*|12 - b. Adjust non-string/array typed PCD item format: e.g. PcdWinNtBootMode|gEfiNt32PkgTokenSpaceGuid|1 -> gEfiNt32PkgTokenSpaceGuid.PcdWinNtBootMode|1 - c. Update the override library class in [Components] section: e.g. - { - PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf - } - To - { - PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf - } + BaseTools\Source\Python\MigrationMsa2Inf Brief usage for Migration Tool Spd2Dec.exe: 1. Command line format: @@ -125,7 +141,7 @@ Brief usage for Migration Tool Spd2Dec.exe: Example a & b are equivalent to migrate Nt32 package SPD file from EDKII to EDKII' snytax. 6. Pyton Source - r777 \BaseTools\Source\Python\spd2Dec + BaseTools\Source\Python\spd2dec Brief usage for Migration Tool Fpd2Dsc.exe: 1. Command line format: @@ -149,6 +165,6 @@ Brief usage for Migration Tool Fpd2Dsc.exe: b. If MSA file which is corresponds to module guid could not be found in currect workspace, tool will dump the module guid. 7. Pyton Source - r767 \BaseTools\Source\Python\Fpd2Dsc + BaseTools\Source\Python\fpd2dsc -27-September-2007 +4-Mar-2010