README.TXT ----------------------------------------------------- MIPS Navigator® IDE Copyright (C) 2008 MIPS Technologies, Inc. All rights reserved. ----------------------------------------------------- This software package consists of MIPS SDE Lite, a Cygwin environment (in the case of Windows OSes), a base Eclipse platform, the Eclipse C/C++ Development Tools (CDT) feature, and a set of Eclipse extensions developed by MIPS Technologies, Inc. ---------------------------- RELEASE 1.2.0 - NEW FEATURES ---------------------------- o Integration with Sytem Navigator 2.4.4 Software o Integration with Hot Spot Analyzer o Inclusion of TimeSys 3.00.01 GNU/Linux Cross Compiler Toolchain o More control over debug session startup o Several UI improvements, and other small bug fixes... ------------- PREREQUISITES ------------- If you are using the FS2 System Navigator probe for debug purposes, then version 2.4.4 or later of the System Navigator for MIPS software must be installed separately. --------- LICENSING --------- Debugging a target system using Navigator IDE requires a valid license. A 30 day trial license can be obtained from the FS2 website. For purchased products a serial number will be issued and that serial number can then be used on the FS2 website to obtain a permanent license. All licenses are node-locked to a NIC address. Trial Licenses: http://sl.fs2.com/licenserequest/navigatoreval.html Purchased Licenses: http://sl.fs2.com/licenserequest/navigatorlicense.html After getting a license file, configure Navigator IDE to use the license by opening the Window|Preferences dialog from the main menu bar. Then open the Navigator IDE|FlexLM pane and enter the license file into the appropriate box. ------------- LICENSE TERMS ------------- This software package is made up of several components, some of which were developed by MIPS Technologies, Inc. and others of which were developed by third parties. The third party components used in this package are: * The Cygwin library and various Free Software tools targeted to run in the Cygwin environment. See the terms/cygwin subdirectory of this installation for the terms associated with this component. * A Sun Java Runtime environment. See the terms/jre subdirectory of this installation for the terms associated with this component. * Eclipse Platform and C++ Development Tools feature from the Eclipse Project. See the terms/eclipse subdirectory of this installation for the terms associated with this component. The following components developed by MIPS Technologies are included in this package: * MIPS SDE Lite. See the terms/sde subdirectory of this installation for the terms associated with this component. * All portions of this software package outside the scope of the above-mentioned components. This includes Eclipse plugins developed by MIPS Technologies, Inc. See the terms/mips subdirectory of this installation for the terms associated with these portions. ------------ INSTALLATION ------------ This package is installed by running the installation executable from an administrator-level account. On machines running Linux, the installation may be wrapped in a ZIP file, in which case unzipping needs to be performed as the first step before installation. On Linux, log out and then back in again after installing; the application is installed under /usr/local/mips/navigator-ide. ------------- LINUX ISSUES ------------- The Eclipse Project has tested the Eclipse Platform on Red Hat Enterprise Linux as its representative "reference platform" for Linux. Running this software package on other Linux distributions may be possible, but is not guaranteed to work. For instance, consistent crash problems in specific important area(s) have been noted when attempting to run Eclipse+CDT on Red Hat 9. MIPS Technologies, Inc. has tested this package on Red Hat Enterprise Linux 4 Workstation. ---------- CYGWIN ---------- The Windows version of this software package includes a specially modified Cygwin environment that is intended to coexist (to a greater extent than normally possible) with any other Cygwin environments that might be installed elsewhere on the PC. The modified Cygwin maintains its own mount table that is separate from vanilla Cygwin, and also uses its own separate shared memory area distinct from that of vanilla Cygwin, with the goal of reducing the chance of seeing a "Cygwin mismatch error" when you have other programs running that are using some other version of Cygwin. Cygwin is distributed under the terms of the GNU General Public License, therefore the modified Cygwin is also distributed under the same terms. The source code for the modified Cygwin environment is available at: http://www.fs2.com/cygwin/cygwin-mips-1.0.0-1-package-src.tar.bz2 --------------------- STARTING THE SOFTWARE --------------------- On Windows PCs, start the software from the Start menu (Start -> Programs -> MIPS -> Navigator IDE). On Linux PCs, start the software by invoking: /usr/local/mips/navigator-ide/navigator-ide Please read the Navigator IDE Quick Start Guide for a more detailed introduction to the product.