R
Embedded System
Tools Reference
Manual
Embedded Development Kit
EDK 8.1i
UG111 (v5.0) October 24, 2005
Embedded System Tools Reference Manual www.xilinx.com UG111 (v5.0) October 24, 2005
.
Xilinx is disclosing this Document and Intellectual Property (hereinafter “the Design”) to you for use in the development of designs to operate
on, or interface with Xilinx FPGAs. Except as stated herein, none of the Design may be copied, reproduced, distributed, republished,
downloaded, displayed, posted, or transmitted 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. Any unauthorized use of the Design may violate copyright
laws, trademark laws, the laws of privacy and publicity, and communications regulations and statutes.
Xilinx does not assume any liability arising out of the application or use of the Design; nor does Xilinx convey any license under its patents,
copyrights, or any rights of others. You are responsible for obtaining any rights you may require for your use or implementation of the Design.
Xilinx reserves the right to make changes, at any time, to the Design as deemed desirable in the sole discretion of Xilinx. Xilinx assumes no
obligation to correct any errors contained herein or to advise you of any correction if such be made. Xilinx will not assume any liability for the
accuracy or correctness of any engineering or technical support or assistance provided to you in connection with the Design.
THE DESIGN IS PROVIDED “AS IS” WITH ALL FAULTS, AND THE ENTIRE RISK AS TO ITS FUNCTION AND IMPLEMENTATION IS
WITH YOU. YOU ACKNOWLEDGE AND AGREE THAT YOU HAVE NOT RELIED ON ANY ORAL OR WRITTEN INFORMATION OR
ADVICE, WHETHER GIVEN BY XILINX, OR ITS AGENTS OR EMPLOYEES. XILINX MAKES NO OTHER WARRANTIES, WHETHER
EXPRESS, IMPLIED, OR STATUTORY, REGARDING THE DESIGN, INCLUDING ANY WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE, TITLE, AND NONINFRINGEMENT OF THIRD-PARTY RIGHTS.
IN NO EVENT WILL XILINX BE LIABLE FOR ANY CONSEQUENTIAL, INDIRECT, EXEMPLARY, SPECIAL, OR INCIDENTAL DAMAGES,
INCLUDING ANY LOST DATA AND LOST PROFITS, ARISING FROM OR RELATING TO YOUR USE OF THE DESIGN, EVEN IF YOU
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE TOTAL CUMULATIVE LIABILITY OF XILINX IN CONNECTION
WITH YOUR USE OF THE DESIGN, WHETHER IN CONTRACT OR TORT OR OTHERWISE, WILL IN NO EVENT EXCEED THE
AMOUNT OF FEES PAID BY YOU TO XILINX HEREUNDER FOR USE OF THE DESIGN. YOU ACKNOWLEDGE THAT THE FEES, IF
ANY, REFLECT THE ALLOCATION OF RISK SET FORTH IN THIS AGREEMENT AND THAT XILINX WOULD NOT MAKE AVAILABLE
THE DESIGN TO YOU WITHOUT THESE LIMITATIONS OF LIABILITY.
The Design is not designed or intended for use in the development of on-line control equipment in hazardous environments requiring fail-
safe controls, such as in the operation of nuclear facilities, aircraft navigation or communications systems, air traffic control, life support, or
weapons systems (“High-Risk Applications”). Xilinx specifically disclaims any express or implied warranties of fitness for such High-Risk
Applications. You represent that use of the Design in such High-Risk Applications is fully at your risk.
Copyright © 1995-2005 Xilinx, Inc. All rights reserved. XILINX, the Xilinx logo, and other designated brands included herein are trademarks
of Xilinx, Inc. PowerPC is a trademark of IBM, Inc. All other trademarks are the property of their respective owners.
R
UG111 (v5.0) October 24, 2005 www.xilinx.com Embedded System Tools Reference Manual
Embedded System Tools Reference Manual
UG111 (v5.0) October 24, 2005
The following table shows the revision history for this document.
Version Revision
06/24/02 1.0 Initial Xilinx® EDK (Embedded Processor Development Kit) release.
08/13/02 1.1 EDK (v3.1) release.
09/02/03 1.3 EDK 6.1 release.
01/30/04 1.4 EDK 6.2i release.
03/19/04 2.0 Updated for service pack release.
08/20/04 3.0 EDK 6.3i release.
02/15/05 4.0 EDK 7.1i release.
04/28/05 4.1 Updated for service pack release.
07/05/05 4.2 Updated for service pack release.
10/24/05 5.0 EDK 8.1i release.
Embedded System Tools Reference Manual www.xilinx.com 5
UG111 (v5.0) October 24, 2005
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 8, “Bitstream Initializer (BitInit)”
• Chapter 9, “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 14, “EDK Shell”
• Chapter 15, “Command Line (no window) Mode”
• Appendix A, “GNU Utilities”
• Appendix B, “Interrupt Management”
• Appendix C, “Glossary”