home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / MATH / C25SIM.ZIP / c25sim.hlp < prev    next >
Text File  |  1994-02-05  |  7KB  |  157 lines
  1. QUICK COMMAND REFERENCE
  2. load        Load hex and map files
  3. listing        Load listing file (default extension: LST)
  4. wp        Write program memory
  5. rp        Read program memory
  6. wd        Write data memory
  7. rd        Read data memory
  8. mr        Modify a C25 register
  9. pwait        Program memory wait state
  10. dwait        Data memory wait state
  11. bp        Set a breakpoint
  12. clrbps        Clear all breakpoint
  13. go        Run N steps or until next breakpoint
  14. cycles        Run for N processor cycles
  15. reset        Reset the C25
  16. bkgnd        Run C25 continuously as background process (or stop)
  17. int        Manually trigger an interrupt
  18. symbols        Show symbol table
  19. match?        Find all global labels matching current PC
  20. quit        Quit this program
  21.  
  22. Use Home, End, PageUp, PageDown, and up and down arrows to navigate, any
  23. other key returns to the simulator.
  24.  
  25. Function keys:    F1 => view this help file
  26.         F2 => view source listing file
  27.         F3 => view symbol table
  28.         F4 => execute one instruction (active only in simulator)
  29.         F5 => string search (active only in viewer)
  30.         F6 => repeat string search (active only in viewer)
  31.  
  32. MORE DETAILS ON COMMANDS
  33.  
  34. Commands are case-insensitive. "WP", "Wp", "wP", and "wp" are all valid.
  35.  
  36. Many commands take numerical arguments. Numbers are interpreted as decimal
  37. by default, and are interpreted as hexadecimal if they have the prefix "0x",
  38. as in C. Numerical arguments can be decimal numbers (29), hexadecimal
  39. numbers (0x1234), or global symbols defined in the MAP file. Assuming there
  40. is a global symbol "_interrupt_handler", these would all be acceptable ways
  41. to set a breakpoint.
  42.  
  43.     bp 0x53
  44.     bp 83
  45.     bp _interrupt_handler
  46.  
  47. "Go" takes an optional numerical argument. If no argument is used, "go" will
  48. execute code until either a breakpoint is hit, or a key is pressed on the
  49. keyboard. If an argument is given, "go" will stop on either of those
  50. conditions, or when that number of instructions have been executed.
  51.  
  52. "steps" and "cycles" each take a number, respectively specifying how many
  53. instructions or processor cycles to execute.
  54.  
  55. "wp" and "wd" take two numerical arguments, an address followed by data.
  56.  
  57. "bp" takes on numerical argument, an address, and sets a breakpoint there.
  58.  
  59. "rp" and "rd" take an address, and optionally a second address. If two
  60. addresses are specified, then a range of memory values is displayed, up to
  61. but not including the second address, for example:
  62.  
  63.     READY> rd 0x1C00 0x1C10
  64.     Data memory
  65.     1C00 - 1234 5678 0246 1357 1234 5678 0246 1357
  66.     1C08 - 1234 5678 0246 1357 1234 5678 0246 1357
  67.  
  68. "load" takes a filename, and loads Intel hex files for C25 code, and a Texas
  69. Instruments map file, if one exists. For more details, see the description
  70. below of the functions load_hex_files() and load_map_file().
  71.  
  72. "listing" takes a filename, and loads a new source listing file. This can be
  73. viewed by pressing the F2 key. While in the listing view screen, you can
  74. navigate with Home, End, PageUp, PageDown, and the up and down arrow keys.
  75. Press any other key to return to the simulator. If the simulator is invoked
  76. with a filename argument, it will try to load a listing file automatically.
  77. If the argument is "FOO", the simulator will look for "FOO.LST". If an
  78. extension is specified, it will use that.
  79.  
  80. "symbols" prints the symbol table (extracted from the MAP file), showing the
  81. names of globally defined symbols and their hexadecimal values.
  82.  
  83. "match?" prints the names of all globally defined symbols whose values match
  84. the current PC.
  85.  
  86. "mr" takes the name of a register, followed by a new value to assign that
  87. register. The valid register names are: arp ov ovm intm dp arb cnf tc sxm c
  88. hm fsm xf fo txm pm pc t sp ar0 ar1 ar2 ar3 ar4 ar5 ar6 ar7 bio acc p drr
  89. dxr tim prd imr greg.
  90.  
  91. "pwait" and "dwait" set up wait states for ranges of program and data
  92. memory. To specify a range of program memory with two wait states from
  93. address 0x800 to 0xFFF, type "pwait 0x800 0xFFF 2". "dwait" works the same
  94. way for data memory. Up to twenty ranges can be specified for program
  95. memory, and another twenty for data memory.
  96.  
  97. "int" takes an interrupt type name, and manually triggers an interrupt of
  98. that type. The valid C25 interrupts are: RS, INT0, INT1, INT2, TINT, RINT,
  99. XINT, TRAP.
  100.  
  101. MORE DETAILS ON THE FILE VIEWER
  102.  
  103. The file viewer lets you conveniently view text files from the simulator.
  104. At any time while simulating, you may press the F1 key to view this help
  105. file, the F2 key to view the source listing, or the F3 key to view the
  106. symbol table. When in the file viewer, you can navigate using the Home,
  107. End, PageUp, PageDown, and up and down arrow keys.
  108.  
  109. Within the file viewer you can search for a string of text. Press F5 and
  110. you will be prompted for the string to be searched for. The first line, at
  111. or after your current position, that contains that string will be moved to
  112. the top of the screen. When you press the F6 key, the next line containing
  113. that string will be moved to the top of the screen. If the string is not
  114. found, a warning to that effect will appear.
  115.  
  116.  
  117. ########################################################################
  118.  
  119. THIS IS A FREE DEMO VERSION OF A SIMULATOR FOR THE TI TMS320C25. YOU MAY
  120. USE, COPY, AND DISTRIBUTE IT. PLEASE DO NOT ALTER OR DELETE ANY OF THE
  121. INCLUDED FILES, OR ADD NEW ONES.
  122.  
  123. ########################################################################
  124.  
  125. The following C25 instructions have been disabled in this version of the
  126. simulator:
  127.  
  128. APAC LTA LTD LTP LTS MAC MACD MPYA MPYS MPYU SPAC SQRA SQRS
  129.  
  130. You may use this freeware version all you want. You may use, copy and
  131. distribute it as much as you like, provided that you do not add files to it,
  132. delete files from it, or change its files.
  133.  
  134. Other than these instructions being disabled, and the prompt in C25SIM.EXE
  135. being "DEMO>" instead of "READY>", this software is identical to the
  136. full-featured C25SIM package. The reasoning behind this approach is to allow
  137. you to make a fully informed decision about purchasing this software. The
  138. C25SIM software includes an OBJ file for the simulator engine so that you
  139. can write a customized simulator specific to your application. You may want
  140. to explore this before making your purchasing decision.
  141.  
  142. To order the full-featured C25SIM package, send a check or money order for
  143. $80.00 to
  144.  
  145.     Will Ware
  146.     26 Beacon St., Apt. 34B
  147.     Burlington, MA  01803
  148.  
  149. Your package will include software that executes all the C25 instructions, a
  150. printed manual, periodic software updates as they occur, and technical
  151. support via electronic mail. My email address is:
  152.  
  153.     72143,315            for Compuserve
  154.  
  155.     72143.315@compuserve.com    for Internet
  156.  
  157.