Page 1
TMS320C2xx Simulator Getting Started Guide 1996 Microprocessor Development Systems...
Page 2
Printed in U.S.A., April 1996 SPRU176 D412015-9741 revision *...
Page 3
TMS320C2xx Simulator Getting Started Guide SPRU176 April 1996 Printed on Recycled Paper...
Page 4
IMPORTANT NOTICE Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any semiconductor product or service without notice, and advises its customers to obtain the latest version of relevant information to verify, before placing orders, that the information being relied on is current.
Page 5
TRADEMARKS HP 9000 Series 700, HP-UX, and PA-RISC are trademarks of Hewlett-Packard Company. MS-DOS and Windows are registered trademarks of Microsoft Corp. OpenWindows, Solaris, and SunOS are trademarks of Sun Microsystems, Inc. PC and PC-DOS is a trademark of International Business Machines Corp. SPARC is a trademark of SPARC International, Inc.
Contents Contents Installing the Simulator and C Source Debugger With DOS ......Lists the hardware and software you need to install the simulator and C source debugger; pro- vides installation instructions for PC systems running MS-DOS or PC-DOS What You Need...
Page 8
Contents Installing the Simulator and C Source Debugger With HP-UX ..... . . Lists the hardware and software you need to install the simulator and C source debugger; pro- vides installation instructions for HP systems running HP-UX What You Need .
Page 9
Chapter 1 Installing the Simulator and C Source Debugger With DOS This chapter provides instructions to help you install the TMS320C2xx simula- tor and the C source debugger on PC systems running MS-DOS or PC-DOS. You can also use the debugger with Windows. When you complete the installa- tion, turn to the TMS320C2xx C Source Debugger User’s Guide .
What You Need 1.1 What You Need To install the ’C2xx C source debugger and simulator, you need the items in the following hardware and software checklists. Hardware checklist Host An IBM PC/AT or 100%-compatible ISA/EISA-based PC with a hard-disk system and a 1.2M floppy-disk drive; a 386 or higher is highly recommended Memory Minimum of 640K bytes;...
What You Need Software checklist Operating system MS-DOS or PC-DOS (version 3.0 or later) Optional: MS-Windows (version 3.0 or later) Software tools TMS320C1x/’C2x/’C2xx/’C5x assembler and linker Optional: TMS320C2x/’C2xx/’C5x C compiler Optional files siminit.cmd is a general-purpose batch file that contains debugger included with the commands.
Step 1: Installing the Simulator and Debugger Software 1.2 Step 1: Installing the Simulator and Debugger Software This section explains how to install the simulator and debugger on a hard-disk system. 1) Make a backup copy of each product disk(s). 2) On your hard disk, create a directory named sim2xx.
Step 2: Setting Up the Debugger Environment 1.3 Step 2: Setting Up the Debugger Environment To ensure that your debugger works correctly, you must identify the items that are listed in Table 1–1. You can specify this information either in an initializa- tion batch file (see page 1-6) or in your autoexec.bat file (see page 1-7).
Step 2: Setting Up the Debugger Environment Defining an initialization batch file To create an initialization file named initdb.bat , follow these steps using a text editor; be careful that no spaces precede the equal (=) sign wherever it ap- pears.
Step 2: Setting Up the Debugger Environment Changing the autoexec.bat file If you are sure that no programs will be affected by changing your autoexec.bat file, you can specify the debugger environment in that file. To change your autoexec.bat file, follow these steps using a text editor; be careful that no spaces precede the equal (=) sign wherever it appears.
Step 3: Verifying the Installation 1.4 Step 3: Verifying the Installation To ensure that you have correctly installed the simulator and debugger soft- ware, enter this command at the system prompt: sim2xx c:\sim2xx\sample You should see a display similar to this one: Load Break Watch...
Using the Debugger With Windows 1.5 Using the Debugger With Windows If you’re using Windows, you can freely move or resize the debugger display on the screen. If the resized display is bigger than the debugger requires, the extra space is not used. If the resized display is smaller than required, the display is clipped.
Chapter 2 Installing the Simulator and C Source Debugger With SunOS This chapter provides instructions to help you install the ’C2xx simulator and the C source debugger on a SPARCstation running SunOS or Solaris When you complete the installation, turn to the TMS320C2xx C Source Debugger User’s Guide .
What You Need 2.1 What You Need To install the ’C2xx C source debugger and simulator, you need the items in the following hardware and software checklists. Hardware checklist Host A SPARCstation or a system that is100% compatible with a SPARCstation 2 class or higher Display Monochrome or color monitor (color recommended)
What You Need Software checklist Operating system OpenWindows version 3.0 (or higher) running under SunOS ver- sion 4.1.3 (or higher) or SunOS version 5.x (also known as Solaris 2.x). Root privileges If you are running SunOS 4.1.x, 5.0, or 5.1, you must have root privi- leges to mount and unmount the CD-ROM.
Step 1: Installing the Simulator and Debugger Software 2.2 Step 1: Installing the Simulator and Debugger Software This section explains how to install the simulator and debugger software on your hard-disk system. The software package is shipped on a CD-ROM. To install the software, you must mount the CD-ROM, copy the files, and unmount the CD-ROM.
Step 1: Installing the Simulator and Debugger Software Copying the files After you mount the CD-ROM, you must create the directory that will contain the debugger software and copy the software to that directory. 1) Create a directory named sim2xx on your hard disk. To create this directory, enter: mkdir / your_pathname /sim2xx 2) Copy the files from the CD-ROM to your hard-disk system:...
Step 2: Setting Up the Debugger Environment 2.3 Step 2: Setting Up the Debugger Environment To ensure that your debugger works correctly, you must identify the items that are listed in Table 2–1. You specify this information in your shell configuration file in your home directory (for example, the .cshrc file for a C shell).
Step 3: Verifying the Installation 2.4 Step 3: Verifying the Installation To ensure that you have correctly installed the simulator and debugger soft- ware, enter this command at the system prompt: sim2xx sample You should see a display similar to this one: Load Break Watch...
Using the Debugger With the X Window System 2.5 Using the Debugger With the X Window System If you’re using the X Window System to run the ’C2xx debugger, you need to know about the keyboard’s special keys, the debugger fonts, and using the de- bugger on a monochrome monitor.
Using the Debugger With the X Window System Changing the debugger font You can change the font of the debugger screen by using the xrdb utility and modifying the .Xdefaults file in your root directory. For example, to change the ’C2xx debugger fonts to Courier, add the following line to the .Xdefaults file: sim2xx*font:courier For more information about using xrdb to change the font, refer to your X...
Page 29
Chapter 3 Simulator Installing the Simulator and C Source Debugger With HP-UX This chapter describes how to install the ’C2xx simulator and the C source de- bugger on an HP9000 series 700 PA-RISC system running HP-UX. When you complete the installation, turn to the TMS320C2xx C Source Debugger User’s Guide .
What You Need 3.1 What You Need To install the ’C2xx C source debugger and simulator, you need the items in the following hardware and software checklists. Hardware checklist Host An HP9000 series 700 PA-RISC system Display Monochrome or color (color recommended) Disk space 2M bytes of disk space Required hardware...
Page 31
What You Need Software checklist Operating system HP-UX 9.x or higher. Root privileges You must have root privileges to mount and unmount the CD-ROM. If you don’t, get help from your system administrator. Software tools TMS320C2xx assembler and linker Optional: TMS320C2xx C compiler Optional files siminit.cmd is a general-purpose batch file that contains debugger included with the...
Step 1: Installing the Simulator and Debugger Software 3.2 Step 1: Installing the Simulator and Debugger Software This section explains how to install the simulator and debugger software on your hard-disk system. The software package is shipped on a CD-ROM. To install the software, you must mount the CD-ROM, copy the files, and unmount the CD-ROM.
Page 33
Step 1: Installing the Simulator and Debugger Software Unmounting the CD-ROM Note: Root Privileges You must have root privileges to unmount the CD-ROM. If you don’t, get help from your system administrator. You must unmount the CD-ROM after copying the files. Enter: umount /cdrom exit Installing the Simulator and C Source Debugger With HP–UX...
Step 2: Setting Up the Debugger Environment 3.3 Step 2: Setting Up the Debugger Environment To ensure that your debugger works correctly, you must identify the items that are listed in Table 3–1. You specify this information in your shell configuration file in your home directory (for example, the .cshrc file for a C shell).
Page 35
Step 2: Setting Up the Debugger Environment Figure 3–1. Sample Shell Configuration File for an X Window System set path statement set path = (. /bin /usr/ucb /usr/contrib/bin /usr/bin \ /usr/openwin/bin /user/fred/sim2xx) setenv D_DIR ”/user/fred/sim2xx” setenv D_SRC ”/user/fred/C2xxsource” Environment setenv DISPLAY ”barney:0” variables setenv D_OPTIONS ”–b”...
Step 3: Verifying the Installation 3.4 Step 3: Verifying the Installation To ensure that you have correctly installed the simulator and debugger soft- ware, enter this command at the system prompt: sim2xx sample You should see a display similar to this one: Load Break Watch...
Using the Debugger With the X Window System 3.5 Using the Debugger With the X Window System If you’re using the X Window System to run the ’C2xx debugger, you need to know about the keyboard’s special keys, the debugger fonts, and using the de- bugger on a monochrome monitor.
Page 38
Using the Debugger With the X Window System Changing the debugger font You can change the font of the debugger screen by using the xrdb utility and modifying the .Xdefaults file in your root directory. For example, to change the fonts of the ’C2xx debugger to Courier, add the following line to the .Xdefaults file: sim2xx*font:courier...
Page 39
Index Index batch files (continued) siminit.cmd HP systems 3-3 arrow keys PC systems 1-3 HP systems 3-9 SPARC systems 2-3 SPARC systems 2-9 –bb debugger option assembler HP systems 3-6 HP systems 3-3 PC systems 1-5 PC systems 1-3 SPARC systems 2-6 SPARC systems 2-3 autoexec.bat file environmental variables 1-5...
Page 40
Index .cshrc file (continued) default (continued) sample screen configuration file HP systems 3-7 HP systems 3-3 SPARC systems 2-7 PC systems 1-3 SPARC systems 2-3 customizing the display HP systems 3-3, 3-10 directories PC systems 1-2, 1-3 auxiliary files SPARC systems 2-3, 2-10 HP systems 3-6 PC systems 1-5 SPARC systems 2-6...
Page 41
Index installation debugger HP systems 3-4 font changes PC systems 1-4 HP systems 3-10 SPARC systems 2-4 SPARC systems 2-10 simulator –font debugger option 1-5 HP systems 3-4 function key mapping PC systems 1-4 HP systems 3-9 SPARC systems 2-4 SPARC systems 2-9 verifying HP systems 3-8...
Page 42
Index mono.clr file root privileges HP systems 3-3 HP systems 3-3 PC systems 1-3 SPARC systems 2-3 SPARC systems 2-3 monochrome monitors color mapping HP systems 3-10 SPARC systems 2-10 mouse requirements –s debugger option HP systems 3-2 HP systems 3-6 PC systems 1-2 PC systems 1-5 SPARC systems 2-2...
Page 43
Index simulator installation (continued) verification HP systems 3-8 –v debugger option PC systems 1-8 HP systems 3-6 SPARC systems 2-8 PC systems 1-5 software SPARC systems 2-6 checklist verifying the installation HP systems 3-3 HP systems 3-8 PC systems 1-3 PC systems 1-8 SPARC systems 2-3 SPARC systems 2-8...