home *** CD-ROM | disk | FTP | other *** search
/ messroms.de / 2007-01-13_www.messroms.de.zip / VZ200 / TOOLS / DZ80.ZIP / readme.txt < prev    next >
Text File  |  1999-12-09  |  3KB  |  72 lines
  1. DZ80 - freeware Z80 symbolic disassembler
  2.  
  3. This software is free for any use. The author cannot be held
  4. responsible for any problems it might cause, in no case. If
  5. you don't understand or accept this, delete dz80 immediately.
  6.  
  7. Purpose:
  8.   DZ80 was written to allow a rather sophisticated disassembly of
  9.   programs for the Z80 microprocessor. It was written to disassemble
  10.   (and understand) the BASIC ROM of the Colour Genie.
  11.  
  12. Operation:
  13.   You call dz80.exe with a filename of a data file containing the
  14.   Z80 code you want to disassemble. There are several options too:
  15.   -a assembly output, no address and data columns
  16.   -t input file is in the Colour Genie *.cas machine code tape format
  17.   -i print block info (starting and ending address)
  18.   -o load from specified offset
  19.   -j DEF file options
  20.      -jd include cgdos.def (Colour DOS symbol definitions)
  21.      -jc file is a Colour Compiler output (with relocator code)
  22.  
  23. DEF file format:
  24.   The standard symbols and data type definitions are always included
  25.   from the file cgenie.def. DZ80 tries to read symbol and data type
  26.   information from a additional file by the name <inputfilename>.def,
  27.   so if you want to disassemble 'myprog.bin' you should have a file
  28.   'myprog.def' too.
  29.   The format of the DEF files is as follows:
  30.  
  31.   addr1 option    name/comment
  32.   addr2 option    name/comment
  33.   ...
  34.  
  35.   addrX is a (up to) 4 digit hexadezimal address.
  36.   option is one or two characters, describing the type of that entry.
  37.   name/comment is either a symbol name or a free form comment.
  38.  
  39.   options:
  40.   +  comment    add the comment after the disassembled opcode (same line)
  41.   ;  comment    block comment, this is inserted in extra lines
  42.   =  symbol    generic symbol value (ala EQU)
  43.   c  [symbol]    code beginning with this address [and optional symbol name]
  44.   b  [symbol]    byte sized data starts here [and optional symbol name]
  45.   7  [symbol]    7bit data starts here [and optional symbol name]
  46.   a  [symbol]    ASCII data starts here [and optional symbol name]
  47.   w  [symbol]    word sized data starts here [and optional symbol name]
  48.   e  [symbol]    entry point data (words pointing to code) [and optional symbol name]
  49.   s  [symbol]    single precision floating point [and optional symbol name]
  50.   d  [symbol]    double precision floating point [and optional symbol name]
  51.   oc [symbol]    words containing offsets to code [and optional symbol name]
  52.   o7 [symbol]    words containing offsets to 7bit data [and optional symbol name]
  53.   oa [symbol]    words containing offsets to ASCII data [and optional symbol name]
  54.   ob [symbol]    words containing offsets to byte data [and optional symbol name]
  55.   ow [symbol]    words containing offsets to word data [and optional symbol name]
  56.   ow [symbol]    words containing offsets to entry points [and optional symbol name]
  57.  
  58. Included files:
  59.   The EXE is currently translated with CGENIE defined to 0, so it
  60.   by default includes the CGENIE.DEF files and the CGDOS.DEF file if the
  61.   -jd switch is given.
  62.  
  63. Request:
  64.   The tables arent very complete and certainly wrong in some parts.
  65.   If you find time to check and correct them, your help would be very
  66.   appreciated and I would of course publish your improved tables.
  67.  
  68. Regards,
  69.  
  70. Juergen Buchmueller <pullmoll@t-online.de>
  71.  
  72.