MIPS SDE 6.X Programmers' Guide
Total Page:16
File Type:pdf, Size:1020Kb
TECHNOLOGIES MIPS® SDE 6.x Programmers’ Guide Document Number: MD00428 Revision 1.17 April 4, 2007 MIPS Technologies, Inc 1225 Charleston Road Mountain View,CA94043-1353 Copyright © 1995-2007 MIPS Technologies, Inc. All rights reserved. Copyright © 1995-2007 MIPS Technologies, Inc. All rights reserved. Unpublished rights (if any) reserved under the copyright laws of the United States of America and other countries. This document contains information that is proprietary to MIPS Technologies, Inc. (‘‘MIPS Technologies’’). Any copying, reproducing, modifying or use of this information (in whole or in part) that is not expressly permitted in writing by MIPS Technologies or an authorized third party is strictly prohibited. At a minimum, this information is protected under unfair competition and copyright laws. Violations thereof may result in criminal penalties and fines. Anydocument provided in source format (i.e., in a modifiable form such as in FrameMaker or Microsoft Word format) is subject to use and distribution restrictions that are independent of and supplemental to anyand all confidentiality restrictions. UNDER NO CIRCUMSTANCES MAYADOCUMENT PROVIDED IN SOURCE FORMATBEDISTRIBUTED TOATHIRD PARTY IN SOURCE FORMATWITHOUT THE EXPRESS WRITTEN PERMISSION OF MIPS TECHNOLOGIES, INC. MIPS Technologies reserves the right to change the information contained in this document to improve function, design or otherwise. MIPS Technologies does not assume anyliability arising out of the application or use of this information, or of anyerror or omission in such information. Anywarranties, whether express, statutory,implied or otherwise, including but not limited to the implied warranties of merchantability or fitness for a particular purpose, are excluded. Except as expressly provided in anywritten license agreement from MIPS Technologies or an authorized third party,the furnishing of this document does not give recipient anylicense to anyintellectual property rights, including anypatent rights, that coverthe information in this document. The information contained in this document shall not be exported, reexported, transferred, or released, directly or indirectly,inviolation of the lawofany country or international law, regulation, treaty,Executive Order,statute, amendments or supplements thereto. Should a conflict arise regarding the export, reexport, transfer,orrelease of the information contained in this document, the laws of the United States of America shall be the governing law. The information contained in this document constitutes one or more of the following: commercial computer software, commercial computer software documentation or other commercial items. If the user of this information, or anyrelated documentation of anykind, including related technical data or manuals, is an agency, department, or other entity of the United States government (‘‘Government’’), the use, duplication, reproduction, release, modification, disclosure, or transfer of this information, or anyrelated documentation of anykind, is restricted in accordance with Federal Acquisition Regulation 12.212 for civilian agencies and Defense Federal Acquisition Regulation Supplement 227.7202 for military agencies. The use of this information by the Government is further restricted in accordance with the terms of the license agreement(s) and/or applicable contract terms and conditions covering this information from MIPS Technologies or an authorized third party. MIPS, MIPS I, MIPS II, MIPS III, MIPS IV,MIPS V,MIPS−3D, MIPS16, MIPS16e, MIPS32, MIPS64, MIPS−Based, MIPSsim, MIPSpro, MIPS Technologies logo, MIPS RISC CERTIFIED POWER logo, MIPS−VERIFIED, 4K, 4Kc, 4Km, 4Kp, 4KE, 4KEc, 4KEm, 4KEp, 4KS, 4KSc, 4KSd, M4K, 5K, 5Kc, 5Kf, 20K, 20Kc, 24K, 24Kc, 24Kf, 24KE, 24KEc, 24KEf, 25Kf, 34K, 34Kc, 34Kf, R3000, R4000, R5000, ASMACRO, Atlas, ‘‘At the core of the user experience.’’,BusBridge, CorExtend, CoreFPGA, CoreLV, EC, JALGO, Malta, MDMX, MGB, PDtrace, the Pipeline, Pro Series, QuickMIPS, SEAD, SEAD−2, SmartMIPS, SOC−it, and YAMON are trademarks or registered trademarks of MIPS Technologies, Inc. in the United States and other countries. All other trademarks referred to herein are the property of their respective owners. Template: B1.15, Built with tags: 2B MIPS32/MIPS64 SUM 2 MIPS® SDE 6.x Programmers’ Guide, Revision 1.17 Copyright © 1995-2007 MIPS Technologies, Inc. All rights reserved. Open Source Copyright Notices Manyofthe utilities contained in this package are derivedfrom Free Software Foundation code, which require this notice: This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version. This program is distributed in the hope that it will be useful, butWITHOUT ANY WARRANTY;without eventhe implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. Youshould have receivedacopyofthe GNU General Public License along with this program; if not, write to the Free Software Foundation, 675 Mass Ave,Cambridge, MA 02139, USA. See also http://www.fsf.org/licenses/licenses.html. The Windows version of MIPS® SDE is built using the Cygwin programming environment, produced by RedHat/Cygnus at http://www.cygwin.com, and is distributed under the terms of the GNU General Public License and Cygwin API license, see http://cygwin.com/licensing.html. Some of the target libraries contain modules which require this acknowledgement: This product includes software developed by the University of California, Berkeleyand its contributors. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open CompanyLtd. X/Open is a trademark of X/Open CompanyLtd. POSIX is a registered trademark of the Institute of Electrical and Electronics Engineers, Inc. ThreadX® is a registered trademark of Express Logic, Inc. Formore details on howthese copyrights affect the code that you develop using MIPS® SDE, see Appendix A ‘‘Copyrights’’. MIPS® SDE 6.x Programmers’ Guide, Revision 1.17 3 Copyright © 1995-2007 MIPS Technologies, Inc. All rights reserved. Table of Contents Chapter 1 Introduction ..................................................................................................................................................12 What’sinMIPS® SDE 6.x.........................................................................................................................12 The MIPS® SDE lite subset .......................................................................................................................12 Getting working fast ..................................................................................................................................12 Other reading.............................................................................................................................................13 Other toolchain documentation .................................................................................................................13 Chapter 2 SDE on UNIX and Windows ........................................................................................................................14 2.1 SDE on Windows and ‘‘Cygwin’’...................................................................................................................14 2.1.1 File pathnames in Windows with Cygwin ...........................................................................................14 2.1.2 Textand binary files in Cygwin ...........................................................................................................15 2.2 Environment variables .....................................................................................................................................15 Chapter 3 Installation ....................................................................................................................................................17 3.1 Minimum System Requirements.....................................................................................................................17 3.2 Environment Variable Setup............................................................................................................................17 3.3 Installation.......................................................................................................................................................17 What’sinthe internet download? ............................................................................................................17 Where should you install your package? ................................................................................................18 Install MIPSsim™ simulator and probes .................................................................................................18 Remove old SDE.....................................................................................................................................18 Windows: Install Cygwin........................................................................................................................19 Install SDE ..............................................................................................................................................21 3.4 Multi-User Installation....................................................................................................................................22