Intel® Boot Loader Development Kit (Intel® BLDK) Version 2.0 — UEFI Standard Based Getting Started Guide January 2012 Document Number: 325925-003 INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. A "Mission Critical Application" is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined". Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548- 4725, or go to: http://www.intel.com/design/literature.htm Any software source code reprinted in this document is furnished for informational purposes only and may only be used or copied and no license, express or implied, by estoppel or otherwise, to any of the reprinted source code is granted by this document. Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. Go to: http://www.intel.com/products/processor%5Fnumber/ Code Names are only for use by Intel to identify products, platforms, programs, services, etc. (“products”) in development by Intel that have not been made commercially available to the public, i.e., announced, launched or shipped. They are never to be used as “commercial” names for products. Also, they are not intended to function as trademarks. BlueMoon, BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Inside, Cilk, Core Inside, E-GOLD, i960, Intel, the Intel logo, Intel AppUp, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Insider, the Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel Sponsors of Tomorrow., the Intel Sponsors of Tomorrow. logo, Intel StrataFlash, Intel vPro, Intel XScale, InTru, the InTru logo, the InTru Inside logo, InTru soundmark, Itanium, Itanium Inside, MCS, MMX, Moblin, Pentium, Pentium Inside, Puma, skoool, the skoool logo, SMARTi, Sound Mark, The Creators Project, The Journey Inside, Thunderbolt, Ultrabook, vPro Inside, VTune, Xeon, Xeon Inside, X-GOLD, XMM, X-PMU and XPOSYS are trademarks of Intel Corporation in the U.S. and/or other countries. *Other names and brands may be claimed as the property of others. Copyright © 2012, Intel Corporation. All rights reserved. Intel® Boot Loader Development Kit Version 2.0 — UEFI Standard Based GSG January 2012 2 Document Number: 325925-003 Contents—Intel® BLDK Contents 1.0 About this Manual......................................................................................................5 1.1 Audience............................................................................................................5 1.2 Related Documents and Tools ...............................................................................5 1.3 Notational Conventions and Terminology ................................................................7 2.0 Intel® BLDK Distribution ...........................................................................................8 2.1 Package Naming Convention .................................................................................8 3.0 Installing, Running and Uninstalling the Intel® BLDK Software .................................9 3.1 Unpacking the Intel® BLDK Software .....................................................................9 3.1.1 Before You Begin......................................................................................9 3.1.2 Unpacking the Code Base Package............................................................ 10 3.1.2.1 Build Environment Setup on Windows* ........................................ 11 3.1.2.2 Build Environment Setup on Linux* ............................................. 11 3.2 Unpacking and Installing the Intel® BLDK Development Application ......................... 12 3.2.1 Unpacking and Installing on Windows*...................................................... 12 3.2.2 Unpacking and Installing on Linux*........................................................... 12 3.3 Running the Intel® BLDK Development Application ................................................ 12 3.4 Uninstalling the Intel® BLDK Development Application ........................................... 13 3.4.1 Uninstalling on Windows*........................................................................ 13 3.4.2 Uninstalling on Linux*............................................................................. 14 4.0 Getting Started with the Intel® BLDK ...................................................................... 15 4.1 Creating a Firmware Image ................................................................................ 15 4.1.1 Creating a New Project............................................................................ 15 4.1.2 Configuring the Firmware Image Features ................................................. 17 4.1.3 Selecting Build Mode............................................................................... 17 4.1.4 Creating the Final Firmware Image ........................................................... 18 4.1.5 Updating Firmware ................................................................................. 18 4.1.5.1 Using Hardware SPI Programmer ................................................ 18 4.1.5.2 Using UEFI Shell Application ....................................................... 19 4.1.6 Enabling Fast Boot.................................................................................. 21 4.2 Configuring the Intel® BLDK Development Application............................................ 22 4.2.1 Setting Up the Web Browser and General Settings ...................................... 22 4.2.2 Setting Up the Text Editor ....................................................................... 23 4.2.3 Adding Your Tools .................................................................................. 24 4.2.4 Setting Up the Debug Tools ..................................................................... 25 4.2.5 Setting Up the Update Tools .................................................................... 26 4.2.6 Setting Up the Build Tools ....................................................................... 27 4.2.6.1 Adding a Debug Build Option ...................................................... 28 Figures 1Intel® BLDK Development Application GUI .................................................................. 13 2 New Project: Start Configuration ................................................................................ 15 3 New Project: Create Project....................................................................................... 16 4 New Project: Processor Properties .............................................................................. 17 5 Create Final Firmware File ........................................................................................ 18 6 Mapping the Drives under EFI Shell Environment ......................................................... 20 7 Enabling Fast Boot ................................................................................................... 21 8 Application Preferences............................................................................................. 22 9 Text Editor Preferences............................................................................................. 23 10 My Tools ................................................................................................................. 24 Intel®