home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / STARLET / GENIENEC / DDTZ25.DOC < prev    next >
Text File  |  2000-06-30  |  10KB  |  215 lines
  1.  
  2.                                    DDTZ v2.5
  3.                                 by C.B. Falconer
  4.                            edited by George A. Havach
  5.  
  6.      Introduction:
  7.      ============
  8.         DDTZ v2.5 is a  complete replacement  for DDT,  Digital  Research's
  9.      famous  Dynamic Debugging Tool,  with improved functionality,  bug ex-
  10.      termination, and full Z80 support.  In general,  DDTZ is fully compat-
  11.      ible with the original utility, but it has extra and extended commands
  12.      and many fewer quirks.  All Z80-specific instructions  can be (dis)as-
  13.      sembled, though in Intel rather then Zilog format.  Furthermore,  DDTZ
  14.      will correctly trace ('T' and 'U' commands) both 8080 and Z80 instruc-
  15.      tions,  depending on which CPU is operating.  On startup,  the program
  16.      announces which CPU it is running on.
  17.  
  18.         The program is invoked by typing
  19.  
  20.         ddtz<ret>
  21.      or
  22.                ddtz [d:]filespec<ret>
  23.  
  24.      In  the second form,  DDTZ will load  the specified file  into  memory
  25.      starting at 0100H,  unless it's a .HEX file that sets its own load ad-
  26.      dress.  Besides reporting the  NEXT  free address and  the PC (program
  27.      counter) after a successful load, DDTZ also shows the number of memory
  28.      pages needed for a  SAVE.  Instead of  having to write  all this down,
  29.      just use  the 'Q' command  at any time to redisplay these three values
  30.      for the current application.
  31.  
  32.         As in DDT,  when a program is loaded above the area holding the 'A'
  33.      and 'L' (and now 'K') command code,  these commands are disabled,  and
  34.      the extra memory  is released to the user.  Thus,  DDTZ can occupy  as
  35.      little as 3K total memory space.  Unlike DDT,  however,  DDTZ will not
  36.      overwrite itself or the system on program loads (except .HEX files).
  37.  
  38.         At initialization,  the stack pointer  (SP)  points to  a return to
  39.      DDTZ,  just like for the CCP.  Thus,  programs that normally return to
  40.      the CCP will be returned to DDTZ.  The 'B' command  reinitializes this
  41.      condition.
  42.  
  43.         The intercept vector copies  the BDOS version number,  etc.,  so an
  44.      object program  does not know that  DDTZ is running  (except for BIOS-
  45.      BDOS vector size). Thus, programs that check the version number should
  46.      execute correctly under DDTZ.
  47.  
  48.         All input parameters can now be entered in any of three formats:
  49.  
  50.         (1) hexadecimal (as in DDT),
  51.         (2) decimal, by adding a leading '#' character,
  52.         (3) ASCII, by enclosing between either single or double quotes;
  53.         either one or two characters are allowed.
  54.  
  55.         Leading blanks in command lines are absorbed.   Either a comma or a
  56.      (single) space  is  a valid delimiter.   Either uppercase or lowercase
  57.      input is accepted.
  58.  
  59.         The default command  (for anything  not otherwise recognizable)  is
  60.      'H'. This allows convenient calculation, along with the other features
  61.      described below.  So, to convert a number, just enter it!
  62.  
  63.         As in DDT,  the prompt character is '-', and the only error message
  64.      is the query ('?'), which generally kicks you back to command mode.
  65.       
  66.  
  67.      New Commands (Over DDT):
  68.      =======================
  69.  
  70.          @   Sets or shows (with no parameter)  the internally stored "base"
  71.         value.  Also used with the 'S' and 'D' commands  as an optional
  72.         parameter  (though without the '@')  to display memory  from an
  73.         arbitrary base marker (offset). When set to zero (the default),
  74.         it does not affect any screen displays.
  75.  
  76.     B   B)egin:   resets  the USER stack pointer  to its initial value,
  77.         such that any program that exits by an RET will return to DDTZ.
  78.         DDTZ provides  a default stack space  of approximately 24 bytes
  79.         for user programs.
  80.      
  81.          C   C)ompare first_address,last_address,against_address:  shows all
  82.         the byte differences between two memory areas, in the format
  83.  
  84.         XXXX aa YYYY bb
  85.  
  86.         where  XXXX and YYYY  are the comparative memory addresses, and
  87.         aa  and  bb  are the corresponding byte values.  Can be used to
  88.         verify  the identity  of two files  by first loading them  into
  89.         different memory areas with the 'R' command (see below).
  90.  
  91.     K   K)eep:  stores the modified memory area to disk under the file-
  92.         name  specified by  the 'I' command,  overwriting  the original
  93.         file from which it was loaded (the user is queried before doing
  94.         so).   By default,  the image of memory from 0100H  through the
  95.         "NEXT" value -1 is saved.  "K first_address,last_address" over-
  96.         rides this and allows writing ANY memory area to a file. Almost
  97.         a necessity for CPM 3.0 (no SAVE!).
  98.  
  99.     Q   Q)uery:  redisplays the "NEXT PC SAVE" report at any time.
  100.  
  101.     W   W)here first_address,last_address,value: searches the specified
  102.         memory area for the value (a 16-bit word, not a byte) and shows
  103.         the locations of all such.  Very useful for finding  CALL's  or
  104.         JMP's to a particular address, etc.
  105.  
  106.     Y   Y)our_option parm1,parm2,address: executes an arbitrary routine
  107.         at the specified address,  with the BC and DE registers  set to
  108.         parm1 and parm2, respectively.
  109.  
  110.     Z   Displays (but does not alter) the Z80's alternate register set,
  111.         including the index registers (disabled if running on an 8080).
  112.         On Z80's,  automatically included  as the last part of the dis-
  113.         play by the 'X' command.
  114.  
  115.  
  116.      Based (Offset) Displays:
  117.      =======================
  118.  
  119.         The 'D' and 'S' commands  can use a stored base value (offset),  as
  120.      set by  the '@' command.  The current @ value  may be overridden for a
  121.      single execution of these commands by adding the base as an extra par-
  122.      ameter  in the command line.  The effect is  to add this value  to the
  123.      first/last address and display accordingly. The address listing on the
  124.      left becomes  XXXX:YYYY,  where XXXX is the offset address and YYYY is
  125.      the actual memory address being displayed.  For example, if you have a 
  126.      data area  located at  42B7H  and wish to  preserve easy access,  just
  127.      enter "@42b7".  Now, "d0,3f" will dump memory starting at 4237H.
  128.  
  129.  
  130.      Further Changes from DDT:
  131.      ========================
  132.  
  133.          A   A)ssemble now accepts  the full Z80 as well as 8080 instruction
  134.         set, although it expects them in Intel rather than Zilog format
  135.         (see notes below  under  the 'L' command).   When in doubt, try
  136.         poking in the hexcode (with the 'S' command) and then  L)isting
  137.         to see what the (dis)assembler recognizes.
  138.  
  139.     D   D)isplay or D)ump  will accept  an optional third parameter  to
  140.         set the base value for a single execution only. Format has been
  141.         cleaned up.
  142.  
  143.     H   H)ex_arithmetic  on two values  also shows  their difference in
  144.         decimal. With only one value, converts to hexadecimal, decimal,
  145.         and ASCII (low-order byte only).
  146.  
  147.     I   I)nput now allows drive specification  (d:...)  and sets up the
  148.         complete  command line,  including  the  second FCB  at address
  149.         006CH on.  Note that the filename may be in lowercase.
  150.  
  151.     L   L)ist now displays the raw hexcode, especially handy when exam-
  152.         ining non-code areas. Intel (8080 style) mnemonics are used, so
  153.         some disassembled instructions may look a little strange. E.g.,
  154.         the Z80's 'IN B,(C)' and 'OUT (C),B'  become  'INP B' and 'OUTP
  155.         B', respectively;  'LD (nnnn),BC' becomes 'SBCD nnnn', 'ADD IX,
  156.         BC' becomes 'DADX B', and 'JP (IX)' becomes 'PCIX'.
  157.  
  158.     R   R)ead  now permits  loading a file into memory  with an offset,
  159.         which  is added  to  the default load address  of 0100H.   When
  160.         reading in  a .HEX file  with  a preset bias,  the  'R' command
  161.         will not transfer control to an invalid execution point.   Ano-
  162.         ther execution of the  'R' command  will reread the input file,
  163.         e.g.:
  164.  
  165.         i blah<ret>
  166.         r<ret>
  167.         ...modify the code and generally mess about...
  168.         r<ret>
  169.  
  170.         The original file  is reloaded,  and the modifications  are re-
  171.         moved.
  172.  
  173.     S   S)ubstitute  or S)et,  like D)isplay,  now accepts  an optional
  174.         second parameter  to set the base value  for a single execution
  175.         only.
  176.  
  177.     T   T)rap/trace  on termination  now shows  the complete CPU state.
  178.         Traps and traces no longer lock up  when  a user RST 7 instruc-
  179.         tion is executed.  Tracing of BDOS/BIOS calls  is heavily trun-
  180.         cated, avoiding clutter and preventing system crashes.
  181.  
  182.     X   eX)amine also shows  what two-byte values  the HL and SP regis-
  183.         ters are actually pointing to. On Z80's, displays the alternate
  184.         register set.
  185.  
  186.      NOTE:  Any use of the 'K' or 'R' command  resets the system DMA trans-
  187.         fer address to the standard default value of 0080H.
  188.  
  189.  
  190.      Command Summary:
  191.      ===============
  192.  
  193.     @ (base)
  194.     a)ssemble first_address
  195.     b)egin {i.e., initialize stack and return}
  196.     c)ompare first_address,last_address,against_address
  197.     d)ump first_address(,last_address[,base])
  198.     f)ill first_address,last_address,value
  199.     g)o_to address(,trap1[,trap2])
  200.     h)ex_arithmetic value1(,value2)
  201.     i)nput FCB_command_line
  202.     k)keep (first_address,last_address)
  203.     l)ist_code first_address(,last_address)
  204.     m)ove first_address,last_address,destination
  205.     q)uery {i.e., display memory parameters for application}
  206.     r)ead_file (offset)
  207.     s)ubstitute_in_memory first_address(,base)
  208.     t)race_execution (count)
  209.     u)ntrace_execution (count)
  210.     w)here_is first_address,last_address,word
  211.     x)amine/change (register)
  212.     y)our_option BC:=parm1,DE:=parm2,call_address
  213.     z)80_register_display
  214. address,last_address,word
  215.     x)amine/change (reg