Platform Studio User Guide Embedded Development Kit EDK 7.1i UG113 (v4.0) February 15, 2005 R © 2005 Xilinx, Inc. All Rights Reserved. XILINX, the Xilinx logo, and other designated brands included herein are trademarks of Xilinx, Inc. All other trademarks are the property of their respective owners. NOTICE OF DISCLAIMER: Xilinx is providing this design, code, or information "as is." By providing the design, code, or information as one possible implementation of this feature, application, or standard, Xilinx makes no representation that this implementation is free from any claims of infringement. You are responsible for obtaining any rights you may require for your implementation. Xilinx expressly disclaims any warranty whatsoever with respect to the adequacy of the implementation, including but not limited to any warranties or representations that this implementation is free from claims of infringement and any implied warranties of merchantability or fitness for a particular purpose. Platform Studio User Guide www.xilinx.com UG113 (v4.0) February 15, 2005 1-800-255-7778 Platform Studio User Guide UG113 (v4.0) February 15, 2005 The following table shows the revision history for this document. Version Revision 01/31/04 1.0 Initial Xilinx release for EDK 6.2i. 03/12/04 Updated for service pack release. 03/19/04 2.0 Updated for service pack release. 08/20/04 3.0 EDK 6.3i. 02/15/05 4.0 Updated for EDK 7.1i. UG113 (v4.0) February 15, 2005 www.xilinx.com Platform Studio User Guide 1-800-255-7778 Platform Studio User Guide www.xilinx.com UG113 (v4.0) February 15, 2005 1-800-255-7778 R Preface About This Guide This document describes how to use the Xilinx® Embedded Development Kit (EDK). EDK is a series of software tools for designing embedded programmable systems, and it supports designs of processor sub-systems using the IBM PowerPC™ hard processor core and the Xilinx® MicroBlaze™ soft processor core. Guide Contents This manual contains the following chapters. x Chapter 1, “Overview,” gives an overview of Platform Studio™ technology. x Chapter 2, “Creating a Basic Hardware System in XPS,” contains a step-by-step procedure to generate a simple hardware system for EDK-based designs. x Chapter 3, “Writing Applications for a Platform Studio Design,” contains a step-by- step procedure to generate software for EDK-based designs using Xilinx® EDK 7.1i and Xilinx® ISE™ 7.1i software. x Chapter 4, “Address Management,” describes the embedded processor program address management techniques. For advanced address space management, a discussion on linker scripts is also included in this chapter x Chapter 5, “Interrupt Management,” outlines interrupt management in both MicroBlaze and PowerPC. It details the interrupt handling in MicroBlaze and PowerPC, and the role of Libgen for MicroBlaze and PowerPC. x Chapter 6, “Using Xilkernel,” describes Xilkernel, a set of interfaces and functions that allow context switching and resource sharing between applications. x Chapter 7, “Using XilMFS,” describes XilMFS, a memory-based file system library. x Chapter 8, “Simulation in EDK,” describes the HDL simulation flow using EDK and third party software. x Chapter 9, “Debugging in EDK,” describes the basics of debugging a system designed using EDK. x Chapter 10, “Profiling Embedded Designs,” describes the steps to profile a program on hardware using LibXil profile library provided with EDK. x Chapter 11, “System Initialization and Download,” describes the basics of system initialization and download using the Platform Studio tools. Platform Studio User Guide www.xilinx.com 5 UG113 (v4.0) February 15, 2005 1-800-255-7778 R Preface: About This Guide Additional Resources For additional information, go to http://support.xilinx.com. The following table lists some of the resources you can access from this website. You can also directly access these resources using the provided URLs. Table 1-1: Additional Resources Resource Description/URL Tutorials Tutorials covering Xilinx design flows, from design entry to verification and debugging. http://support.xilinx.com/support/techsup/tutorials/index.htm Answer Browser Database of Xilinx solution records. http://support.xilinx.com/xlnx/xil_ans_browser.jsp Application Notes Descriptions of device-specific design techniques and approaches. http://support.xilinx.com/xlnx/xweb/xil_publications_index.jsp ?category=Application+Notes Data Sheets Device-specific information on Xilinx device characteristics, including readback, boundary scan, configuration, length count, and debugging. http://support.xilinx.com/xlnx/xweb/xil_publications_index.jsp Problem Solvers Interactive tools that allow you to troubleshoot your design issues. http://support.xilinx.com/support/troubleshoot/psolvers.htm Tech Tips Latest news, design tips, and patch information for the Xilinx design environment. http://www.support.xilinx.com/xlnx/xil_tt_home.jsp Conventions This document uses the following conventions. An example illustrates each convention. Typographical The following typographical conventions are used in this document: Table 1-2: Typographical Conventions Convention Meaning or Use Example Messages, prompts, and Courier font program files that the system speed grade: - 100 displays Courier bold Literal commands that you ngdbuild design_name enter in a syntactical statement Commands that you select File o Open Helvetica bold from a menu Keyboard shortcuts Ctrl+C 6 www.xilinx.com Platform Studio User Guide 1-800-255-7778 UG113 (v4.0) February 15, 2005 Conventions R Table 1-2: Typographical Conventions (Continued) Convention Meaning or Use Example Variables in a syntax statement for which you must ngdbuild design_name supply values See the Development System Italic font References to other manuals Reference Guide for more information. If a wire is drawn so that it Emphasis in text overlaps the pin of a symbol, the two nets are not connected. An optional entry or parameter. However, in bus ngdbuild [ option_name] Square brackets [ ] specifications, such as design_name bus[7:0], they are required. A list of items from which you Braces { } lowpwr ={on|off} must choose one or more Separates items in a list of Vertical bar | lowpwr ={on|off} choices IOB #1: Name = QOUT’ Vertical ellipsis IOB #2: Name = CLKIN’ . Repetitive material that has . been omitted . Repetitive material that has allow block block_name Horizontal ellipsis . been omitted loc1 loc2 ... locn; Online Document The following conventions are used in this document: Table 1-3: Online Document Conventions Convention Meaning or Use Example See the section “Additional Cross-reference link to a Resources” for details. Blue text location in the current document Refer to “Title Formats” in Chapter 1 for details. Cross-reference link to a See Figure 2-5 in the Virtex-II Red text location in another document Handbook. Go to http://www.xilinx.com Blue, underlined text Hyperlink to a website (URL) for the latest speed files. Platform Studio User Guide www.xilinx.com 7 UG113 (v4.0) February 15, 2005 1-800-255-7778 R Preface: About This Guide 8 www.xilinx.com Platform Studio User Guide 1-800-255-7778 UG113 (v4.0) February 15, 2005 Table of Contents Preface: About This Guide Guide Contents . 5 Additional Resources . 6 Conventions . 6 Typographical. 6 Online Document . 7 Chapter 1: Overview Creating an Embedded Hardware System. 17 Creating Software for the Embedded System . 17 Software Libraries . 17 System Simulation . 18 System Debug and Verification . 18 System Initialization and Download to the Board. 18 Fast Download . 18 Generating an ACE File. 18 Chapter 2: Creating a Basic Hardware System in XPS Overview . 19 Assumptions. 19 Steps. 19 Create a New XPS Project . 20 Select a Target Board . 20 Select the Processor to be Used . 20 Configure the Processor . 21 Configure IO Interfaces . 21 Specify Internal Peripheral Settings . 21 Specify Software Configuration . 21 View System Summary and Generate . 22 View Peripherals and Bus Settings . 22 Generate Bitstream. 22 Download Bitstream and Execute . 23 Chapter 3: Writing Applications for a Platform Studio Design Overview . 25 Assumptions. 25 Steps. 26 Configure Software Settings . 26 View and Set Project Options . 27 Create EDK Software Libraries . 27 Open/Create Your Application(s). 27 View and Set Application Options . 28 Platform Studio User Guide www.xilinx.com 9 UG113 (v4.0) February 15, 2005 1-800-255-7778 R Build Applications . 28 Initialize Bitstreams with Applications. 28 Download and Execute Your Application . 28 Download and Debug Applications Using XMD . 29 Chapter 4: Address Management MicroBlaze Processor. 31 Programs and Memory . 31 Current Address Space Restrictions . 31 Memory and Peripherals Overview . 31 BRAM Size Limits. 31 Special Addresses . 32 OPB Address Range Details . 32 Address Map . ..