tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
audk/DuetPkg/ReadMe.txt

85 lines
4.2 KiB
Plaintext
Raw Normal View History

Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
Developer's UEFI Emulation (DUET) on Edk2
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
A. Build DUET image on Windows Platform
========================================
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
1. Tools preparation
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
To build DUET image, Visual Studio is required:
1). Base on below link to create Visual Studio build environment.
https://github.com/tianocore/tianocore.github.io/wiki/Windows-systems
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
2. Build Duet Platform module
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
1). run cmd.exe to open command line window.
2). enter workspace root directory such as c:\edk2_tree
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
3). set the environment variable EDK_TOOLS_BIN to point at the BaseTools binaries directory
i.e., "set EDK_TOOLS_BIN=c:\edk2-BaseTools-win32"
4). run "edksetup.bat"
5). run "build -p DuetPkg\DuetPkgIa32.dsc -a IA32 -t VS2015x86" for IA32 architecture platform (using 64-bit VS2015 for example) or
"build -p DuetPkg\DuetPkgX64.dsc -a X64 -t VS2015x86" for X64 architecture platform.
NOTE: The post build script 'PostBuild.sh' will be automatically called after the build command.
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
Create bootable disk
======================
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
3. Create boot disk
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
The following steps are same for IA32 architecture platform or X64 architecture platform.
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
3.1 Create floppy boot disk
1). enter <Workspace>\DuetPkg directory.
2). Insert a floppy disk to drive
1. update bat file to generate right bootia32.efi/bootx64.efi file according to command line parameters. 2. fix a print error in which a %x in format string exists but the corresponding variable argument is not present! 3. fix CONSUME_MEMORY too small issue. In X64 arch, cpu may cause the paging table is too big and beyond the pei memory scope between EfiMemoryTop and EfimemoryBottom. for example, a cpu support 44bits addressing memory space may occupied ~64M paging table. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9794 6f19259b-4bc3-4df7-8a09-765794883524
2010-01-19 09:28:28 +01:00
3). run "CreateBootDisk.bat floppy a: FAT12 IA32" if floppy drive is a: disk and Arch to boot is IA32.
or
run "CreateBootDisk.bat floppy a: FAT12 X64" if floppy drive is a: disk and Arch to boot is X64.
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
3.2 Create usb boot disk
1). enter <Workspace>\DuetPkg directory.
2). Plugin usb disk
1. update bat file to generate right bootia32.efi/bootx64.efi file according to command line parameters. 2. fix a print error in which a %x in format string exists but the corresponding variable argument is not present! 3. fix CONSUME_MEMORY too small issue. In X64 arch, cpu may cause the paging table is too big and beyond the pei memory scope between EfiMemoryTop and EfimemoryBottom. for example, a cpu support 44bits addressing memory space may occupied ~64M paging table. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9794 6f19259b-4bc3-4df7-8a09-765794883524
2010-01-19 09:28:28 +01:00
3). run "CreateBootDisk.bat usb e: FAT16 IA32" if usb drive is e: and FAT format is FAT16 and Arch to boot is IA32.
or "CreateBootDisk.bat usb e: FAT16 X64" if usb drive is e: and FAT format is FAT16 and Arch to boot is X64.
or "CreateBootDisk.bat usb e: FAT32 IA32" if usb drive is e: and FAT format is FAT32 and Arch to boot is IA32.
or "CreateBootDisk.bat usb e: FAT32 X64" if usb drive is e: and FAT format is FAT32 and Arch to boot is X64.
Add build steps for duet platform. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7234 6f19259b-4bc3-4df7-8a09-765794883524
2009-01-09 08:42:41 +01:00
4). UnPlug usb disk and plugin it again.
1. update bat file to generate right bootia32.efi/bootx64.efi file according to command line parameters. 2. fix a print error in which a %x in format string exists but the corresponding variable argument is not present! 3. fix CONSUME_MEMORY too small issue. In X64 arch, cpu may cause the paging table is too big and beyond the pei memory scope between EfiMemoryTop and EfimemoryBottom. for example, a cpu support 44bits addressing memory space may occupied ~64M paging table. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9794 6f19259b-4bc3-4df7-8a09-765794883524
2010-01-19 09:28:28 +01:00
5). run "CreateBootDisk.bat usb e: FAT16 IA32 step2" if usb drive is e: and FAT format is FAT16 and Arch to boot is IA32.
or "CreateBootDisk.bat usb e: FAT16 X64 step2" if usb drive is e: and FAT format is FAT16 and Arch to boot is X64.
or "CreateBootDisk.bat usb e: FAT32 IA32 step2" if usb drive is e: and FAT format is FAT32 and Arch to boot is IA32.
or "CreateBootDisk.bat usb e: FAT32 X64 step2" if usb drive is e: and FAT format is FAT32 and Arch to boot is X64.
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
B. Build DUET image on Linux Platform
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
======================================
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
1. Tools preparation
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
To build DUET image, GCC installation (4.4+) is required:
1). Base on below link to create GCC build environment.
https://github.com/tianocore/tianocore.github.io/wiki/Using-EDK-II-with-Native-GCC
Refine the readme.txt for Duet platform, update the GCC tool chain to GCC44. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Eric Dong <eric.dong@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15645 6f19259b-4bc3-4df7-8a09-765794883524
2014-07-09 10:30:07 +02:00
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
2. Build Duet Platform module
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
Refine the readme.txt for Duet platform, update the GCC tool chain to GCC44. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Eric Dong <eric.dong@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15645 6f19259b-4bc3-4df7-8a09-765794883524
2014-07-09 10:30:07 +02:00
1). Open the terminal.
2). enter workspace root directory such as /edk2_tree
3). run ". edksetup.sh BaseTools"
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
4). run "build -p DuetPkg/DuetPkgIa32.dsc -a IA32 -t GCC49" for IA32 architecture platform (using GCC 4.9 for example) or
"build -p DuetPkg/DuetPkgX64.dsc -a X64 -t GCC49" for X64 architecture platform.
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
NOTE: The post build script 'PostBuild.sh' will be automatically called after the build command.
After post build action, you should check the size of EfiLdr at $WORKSPACE/Build/DuetPkgIA32(DuetPkgX64)/DEBUG_GCC49 directory, it must less than 470k.
If not, you should manually remove some unnecessary drivers at DuetPkg.fdf file.
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
Steps for build Duet under Linux environment added. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8121 6f19259b-4bc3-4df7-8a09-765794883524
2009-04-17 08:14:23 +02:00
3. Create bootable disk
The following steps are same for IA32 architecture platform or X64 architecture platform.
DuetPkg: Resolve white-space issues for post-build scripts & ReadMe Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:08:35 +01:00
DuetPkg: Add POSTBUILD in DSC files to run post-build automatically https://bugzilla.tianocore.org/show_bug.cgi?id=220 Currently, the post-build scripts PostBuild.bat/PostBuild.sh in DuetPkg need to be run manually. Especially for Windows batch script, it also requires users to set the build options (like tool chain, target and arch) in file Conf/target.txt. If users using command line options via '-t' or '-a', the post-build script won't work properly. The package DSC files now support the feature to execute post-build script automatically by adding a 'POSTBUILD' definition. This feature also passes the build options into the post-build script as parameters. This commit uses this feature to make the post-build works for DuetPkg more user-friendly. Also, ReadMe.txt is updated to reflect the new steps for UEFI Emulation (DUET) development. Cc: Ruiyu Ni <ruiyu.ni@intel.com> Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
2016-11-11 09:21:35 +01:00
3.1 Create floppy boot disk
1). enter /edk2_tree/DuetPkg directory.
2). Insert a floppy disk to drive
3). run "CreateBootDisk.sh" to build floppy drive
such as "./CreateBootDisk.sh floppy /media/floppy0 /dev/fd0 FAT12 IA32"
3.2 Create usb boot disk
1). enter /edk2_tree/DuetPkg directory.
2). Plugin usb disk
3). run "CreateBootDisk.sh" to build usb drive
such as "./CreateBootDisk.sh usb /media/usb0 /dev/sdb0 FAT16 IA32"
4). UnPlug usb disk and plugin it again.
5). run "./CreateBootDisk.sh usb /media/usb0 /dev/sdb0 FAT16 IA32 step2"