Embedded System Tools Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
Embedded System Tools Reference Manual Embedded Development Kit EDK 10.1, Service Pack 3 R . R © Copyright 2002 – 2008 Xilinx, Inc. All Rights Reserved. XILINX, the Xilinx logo, the Brand Window and other designated brands included herein are trademarks of Xilinx, Inc. The PowerPC® name and logo are registered trademarks of IBM Corp., and used under license. All other trademarks are the property of their respective owners. Disclaimer: Xilinx is disclosing this user guide, manual, release note, and/or specification (the “Documentation”) to you solely for use in the development of designs to operate with Xilinx hardware devices. You may not reproduce, distribute, republish, download, display, post, or transmit the Documentation in any form or by any means including, but not limited to, electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of Xilinx. Xilinx expressly disclaims any liability arising out of your use of the Documentation. Xilinx reserves the right, at its sole discretion, to change the Documentation without notice at any time. Xilinx assumes no obligation to correct any errors contained in the Documentation, or to advise you of any corrections or updates. Xilinx expressly disclaims any liability in connection with technical support or assistance that may be provided to you in connection with the Information. THE DOCUMENTATION IS DISCLOSED TO YOU ”AS-IS” WITH NO WARRANTY OF ANY KIND. XILINX MAKES NO OTHER WARRANTIES, WHETHER EXPRESS, IMPLIED, OR STATUTORY, REGARDING THE DOCUMENTATION, INCLUDING ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT OF THIRD-PARTY RIGHTS. IN NO EVENT WILL XILINX BE LIABLE FOR ANY CONSEQUENTIAL, INDIRECT, EXEMPLARY, SPECIAL, OR INCIDENTAL DAMAGES, INCLUDING ANY LOSS OF DATA OR LOST PROFITS, ARISING FROM YOUR USE OF THE DOCUMENTATION. Embedded System Tools Reference Manual www.xilinx.com EDK 10.1, Service Pack 3 R Preface About This Guide Welcome to the Embedded Development Kit (EDK). This product provides you with a full set of design tools and a wide selection of standard peripherals required to build embedded processor systems based on the MicroBlaze™ soft processor and PowerPC® hard processor. This guide contains information about the embedded system tools included in EDK. These tools, consisting of processor platform tailoring utilities, software application development tools, a full featured debug tool chain, and device drivers and libraries, allow you to fully exploit the power of MicroBlaze and PowerPC processors along with their corresponding peripherals. Guide Contents This guide contains the following chapters: • Chapter 1, “Embedded System and Tools Architecture Overview” • Chapter 2, “Platform Generator (Platgen)” • Chapter 3, “Simulation Model Generator (Simgen)” • Chapter 4, “Library Generator (Libgen)” • Chapter 5, “Virtual Platform Generator (VPgen),” • Chapter 6, “Platform Specification Utility (PsfUtility)” • Chapter 7, “Version Management Tools” • Chapter 9, “Bitstream Initializer (BitInit)” • Chapter 8, “Flash Memory Programming” • Chapter 10, “GNU Compiler Tools” • Chapter 11, “GNU Debugger (GDB)” • Chapter 12, “Xilinx Microprocessor Debugger (XMD)” • Chapter 13, “System ACE File Generator (GenACE)” • Chapter 15, “EDK Shell” • Chapter 14, “Command Line (no window) Mode” • Appendix A, “GNU Utilities” • Appendix B, “Interrupt Management” • Appendix C, “EDK Tcl Interface” • Appendix D, “Glossary” Embedded System Tools Reference Manual www.xilinx.com 3 EDK 10.1, Service Pack 3 R Preface: About This Guide Additional Resources • Xilinx® website: http://www.xilinx.com • Xilinx Answer Browser and technical support WebCase website: http://www.xilinx.com/support • Xilinx Platform Studio and EDK website: http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm • Xilinx Platform Studio and EDK Document website: http://www.xilinx.com/ise/embedded/edk_docs.htm • Xilinx XPS/EDK Supported IP website: http://www.xilinx.com/ise/embedded/edk_ip.htm • Xilinx EDK Example website: http://www.xilinx.com/ise/embedded/edk_examples.htm • Xilinx Tutorial website: http://www.xilinx.com/support/techsup/tutorials/index.htm • Xilinx Data Sheets: http://www.xilinx.com/xlnx/xweb/xil_publications_index.jsp • Xilinx Problem Solvers: http://www.xilinx.com/support/troubleshoot/psolvers.htm • Xilinx ISE® Manuals: http://www.xilinx.com/support/software_manuals.htm • Additional Xilinx Documentation: http://www.xilinx.com/support/library.htm • GNU Manuals: http://www.gnu.org/manual 4 www.xilinx.com Embedded System Tools Reference Manual EDK 10.1, Service Pack 3 Conventions R Conventions This document uses the following conventions. An example illustrates each convention. Typographical Conventions The following typographical conventions are used in this document: Convention Meaning or Use Example Courier font Messages, prompts, and program files speed grade: - 100 that the system displays Literal commands that you enter in a Courier bold syntactical statement. Descriptive text ngdbuild design_name will also reflect this convention. Commands that you select from a menu File → Open Helvetica bold Keyboard shortcuts Ctrl+C Variables in a code syntax statement for which you must supply values. Text ngdbuild design_name within descriptions will also reflect this convention. Italic font Refer To the Development System References to other manuals Reference Guide for more information. If a wire is drawn so that it overlaps Emphasis in text the pin of a symbol, the two nets are not connected. <Courier Italic in angle Variable in a syntax statement for which ngdbuild <design_name> brackets> you must supply values within a Tcl file. An optional entry or parameter. ngdbuild [option_name] Square brackets [ ] However, in bus specifications, such as design_name bus[7:0], they are required. A list of items from which you must Braces { } lowpwr ={on|off} choose one or more Vertical bar | Separates items in a list of choices lowpwr ={on|off} IOB #1: Name = QOUT’ Vertical ellipsis Repetitive material that has been omitted IOB #2: Name = CLKIN’ allow block block_name loc1 loc2 ... Horizontal ellipsis . Repetitive material that has been omitted locn; Embedded System Tools Reference Manual www.xilinx.com 5 EDK 10.1, Service Pack 3 R Preface: About This Guide Online Document The following conventions are used in this document: Convention Meaning or Use Example Refer to the section Cross-reference link to a “Additional Resources” for Blue text location in the current details. document Refer to “Title Formats” in Chapter 1 for details. Go to http://www.xilinx.com Blue, underlined text Hyperlink to a website (URL) for the latest speed files. 6 www.xilinx.com Embedded System Tools Reference Manual EDK 10.1, Service Pack 3 Table of Contents Preface: About This Guide Guide Contents . 3 Additional Resources . 4 Conventions . 5 Typographical Conventions . 5 Online Document . 6 Chapter 1: Embedded System and Tools Architecture Overview About EDK . 19 Additional Resources . 20 Design Process Overview . 20 Hardware Development . 21 Software Development . 21 Verification . 21 Hardware Verification Using Simulation . 21 Software Verification Using Debugging . 21 Device Configuration . 21 An Introduction to EDK Tools and Utilities. 22 Xilinx Platform Studio (XPS) . 24 Xilinx Software Development Kit (SDK) . 24 EDK Command Line or “no window” Mode . 24 The Base System Builder (BSB) Wizard . 25 The Create and Import Peripheral Wizard. 25 Coprocessor Wizard . 26 Platform Generator (Platgen) . 27 Library Generator (Libgen). 29 GNU Compiler Tools (GCC) . 29 Debug Configuration Wizard . 30 Xilinx Microprocessor Debugger (XMD) . 30 GNU Debugger (GDB) . 30 Simulation Model Generator (Simgen) . 30 Simulation Library Compiler (CompEDKLib) . 31 Bus Functional Model Compiler (BFM) . 31 Bitstream Initializer (Bitinit) . 31 System ACE File Generator (GenACE). 31 Flash Memory Programmer . 31 Format Revision (revup) Tool and Version Management Wizard . 32 LibXil Memory File System (LibXil MFS). 32 Platform Specification Utility . 32 Project Creation and Management . 33 Controlling the EDK Flow (Advanced) . 33 Makefiles. 33 Implementation and Download Control Files . 34 Embedded System Tools Reference Manual www.xilinx.com 7 EDK 10.1, Service Pack 3 R Chapter 2: Platform Generator (Platgen) Features. 35 Additional Resources . 36 Tool Requirements. 36 Tool Usage . 36 Tool Options. 36 Load Path . 37 Output Files . 38 HDL Directory . 38 Implementation Directory . 38 Synthesis Directory . ..