


          ******************************************************
          *                                                    *
          *       TMS320C30 HIGH LEVEL LANGUAGE DEBUGGER       *
          *                                                    *
          *                  RELEASE 2.00                      *
          *                                                    *
          ******************************************************







     -PC/AT SYSTEMS-

      DIGITAL SIGNAL PROCESSOR PRODUCTS

      TEXAS INSTRUMENTS
      INCORPORATED































                                                       2547274-9301A



----------------------------------------
TMS320C30 HLL DEBUGGER PACKAGE
Version 2.00
MS-DOS, PC-DOS Systems
----------------------------------------

   This package contains release 2.00 of the Texas Instruments TMS320C30
   High-Level Language and Assembly Language Debugging Tools.  This bulletin
   provides important information about the latest release of the tools.

TABLE OF CONTENTS
-----------------
   1.  Compatibility with XDS1000/XDS500 and software tools.
   2.  Differences Between Debugger Operation and Documentation
   3.  Sample Program
   4.  Use of Expressions

COMPATIBILITY, XDS1000/XDS500 and SOFTWARE TOOLS
-------------------------------------------------

   1.  Fully compatible with all versions of the XDS500 and XDS1000
       hardware.

   2.  Partially compatible with current XDS500 and XDS1000 software and
       system setup.   DO NOT put C30 HLL files in same directory with
       current XDS500 and XDS1000 software.

       The files  xreset.exe, c30reset.exe, resvct.001, and resvct.002 are
       compatible between the current XDS500/XDS1000 and C30 HLL debugger.

       No other XDS500/1000 files are compatible, i.e. your current
       journal files are not usable on the C30 HLL debugger.

   3.  You need the following versions of the TMS320C30 Assembly and 'C'
       tools to use the debugger.  Earlier versions did not include
       complete debugger information.

           TMS320C30 Macro Assembler Tools version 2.0 or higher.
           TMS320C30 'C' Compiler version 2.1 or higher.

   4.  The host must be IBM PC/AT compatible with hard-disk system.
       This software will not execute on a PC or PC/XT host.











                                                       Page 2


SAMPLE PROGRAM
--------------

   A sample program is provided on the C30 HLL disk so that you can get
   your new debugger up and running in a matter of minutes. Check the
   following before begining the debug exercise.

       1. Are you currently in the directory with C30 HLL files?
       2. Have you copied all of files from the C30 HLL disk into this
	  directory?
       3. Is the XDS500/XDS1000 installed and initialized (xreset, c30reset)?
       4. Have you installed your updated 'C' compiler (version 2.1)?
       5. Have you modified your autoexec.bat file correctly?

   If you answer yes to all five questions then you are set to
   try out your new debugger.

   Debugging
   ---------

       1.  Type in the following:

               cl30 -g sample.c sample1.c c30init.asm -z sample.cmd

           This will compile, assemble and link all three files with
           debug information and create two output files "sample.out"
           and "sample.map".

           The file "sample.cmd" sets up the link parameters that
           determine the location of text, data, stack and bss sections.
           Note that the above files have been linked with the standard
           runtime library "rts.lib" supplied with your 'C' compiler.
	   The file "sample.cmd" is compatible with the TMS320C30 Application
	   Board memory map, and may not be usable on your own target system.

       2.  To load the debugger and the "sample.out" file enter the following.

               db30 sample [RETURN]

           If all is well your screen should show the assembly code for
           the routine "c_int00". The debugger comes up in assembly mode
           as there is no 'C' source for "c_int00".  If the debugger did
           not come up properly you may want to review the five questions
           above.










                                                       Page 3



       3.  Since this is a 'C' debugger you probably want to see some 'C' code.
           Type the following.

               go main [RETURN]

           This sets a breakpoint at the function "main" and runs to the
           breakpoint.   Note that as soon as the debugger found some
           'C' code it switched to 'C' mode.

       4.  To execute code you can use either use the mouse or function key
           (to select an execute button), or enter the command:

              step 1000000 [RETURN]

           The debugger should begin stepping through code and updating the
           screen.  This is a bit boring since you really do not see much
           activity except for 'C' code paging up and down on the screen.
	   Press the [ESC] key to stop execution.

       5.  For a bit more excitment, do the following.

              A. Enter  wa main.i [RETURN]     ; Watch "i" in function main
                        wa main.j [RETURN]     ; Watch "j" in function main
                        wa sp[RETURN}          ; Watch stack pointer
                        disp str [RETURN]      ; Display the structure "str"

	      B. You may want to move the display window to the upper right
		 corner of the screen.

              C. Enter step 1000 [RETURN]

           The debugger should be stepping through the code and updating
           windows.  You can stop execution by pressing the [ESC] key or
           pressing a button on the mouse.

       That concludes a brief demo of the debugger.
















                                                       Page 4


USE OF EXPRESSIONS
-------------------

   The TMS320C30 HLL debugger is a powerful debug tool for 'C' as well as
   assembly language debug.  However, to really exercise the debugger's full
   potential you have to use 'C' expressions.  A few expression examples
   are given below.  You can execute these examples with the program
   "sample.out" that you have loaded.

   To see what is going on in the examples enter the following:

       A.  wr [RETURN]                  ; Reset the watch window
       B.  Select the display window. It should be highlighted
       C.  {function key}F4 [RETURN]    ; clears the display window
       D.  disp ai                      ; display array ai
       E.  resize display window so that first 5 items are visible
       D.  mem ai [RETURN]              ; also put ai in memory window

   Example 1:  Modifying the TMS320C30 program counter:

       A.  Click on a PC register and type in the new value.
       B.  Evaluate the following expressions:

               ? pc = main       ; assign pc to address of main
               e pc++            ; increment pc by 1
               ? pc = c_int00    ; set pc to entry of assembly label
               e pc = main + 10  ; set pc to main plus 10
	       e pc = 0x00F00000 ; set pc to SRAM0 base address

   Example 2:  Modifying memory

       A.  Click on value in memory window and modify it.
       B.  Evalute more expressions.

               ? ar0 = ai        ; ar0 now points to array ai
               ? *ar0 = 1        ; ai[0] now equals 1
	       e ai[1] = 2	 ; ai[1] now equals 2
	       ? &ai		 ; returns pointer to ai[0], 0x400849
	       e *((int *)0x400849) += 10  ; ai[0] now equals 11
               ? pi = ai         ; pi points to ai[0]
               ? *(pi+2) = 22    ; ai[2] = 22
               ? pi++            ; increment pi










                                                       Page 5

