home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / compuserve / P-Code / DSMDOC.TXT < prev    next >
Text File  |  2006-10-19  |  7KB  |  186 lines
  1. O^½║½δ#99/4   D I S - A S S E M B L E R
  2.  
  3. $(C) Andy Cooper 1983,1984,1985
  4. %
  5.  
  6. $121 Clearview Drive
  7. $Downingtown Pa 19335
  8. $(215)269 0804
  9. $
  10. $CIS     71016,1743
  11. $DELPHI  ANDY4820
  12. $
  13.  The disassembler consists of two code
  14.  files. The main or host file is
  15.  DISASMBLR.CODE and the auxillary or
  16.  library file is DISASMSUP.CODE. At run
  17.  TIME disasmsup.code must be linked with
  18.  disasmblr.code. For the P-System to find
  19.  disasmsup.code an entry in USERLIB.TEXT
  20.  on the root volume must exist.
  21.  
  22.  This entry should be:
  23.  
  24. %<diskid>:disasmsup.code
  25.  
  26.  where <diskid> can be a drive (eg #5)
  27.  or a volume name (eg sysdisk).
  28.  
  29.  After creating or updating userlib.text
  30.  with the editor the disassembler can be
  31.  eXecuted from the main status line.
  32.  
  33.  
  34.  O U T P U T
  35.  -----------
  36.  
  37.  The output can be directed to the screen
  38.  or to the printer. If the printer option
  39.  is chosen an additional selection is
  40.  offered.
  41.  
  42.  N(ormal mode produces a full listing
  43.  with headings and page skips.
  44.  
  45.  C(ompressed mode is similar to normal
  46.  however when dis-assembling 9900 code
  47.  the additional words of multi-word
  48.  instructions are not printed. This
  49.  reduces the listing about 25%.
  50.  
  51.  In S(kip mode printing is similar to
  52.  normal however headings and page skips
  53.  are not performed. This is useful if
  54.  many small code segments are being
  55.  decoded (eg following program flow) as
  56.  humongous amounts of paper can be saved.
  57.  
  58.  
  59.  D A T A   S O U R C E
  60.  ---------------------
  61.  
  62.  The next menu allows you to select the
  63.  source of the data to be processed.
  64.  
  65.  R(om will print or dis-assemble data
  66.  from console Rom, console Ram, expansion
  67.  Ram or DSR Rom.
  68.  
  69.  G(rom will print or decode (dis-gpl?)
  70.  data from the console GROM's or cart-
  71.  ridge GROM's.
  72.  
  73.  V(dp will print data from VDP Ram. Note
  74.  that no option is offered to treat VDP
  75.  data as code.
  76.  
  77.  F(ile will take input data from a disk
  78.  file. NOTE: the dis-assembler treats the
  79.  file as a 'memory image' rather than an
  80.  assembler object file. This allows you
  81.  to generate data from various sources
  82.  (eg P-Code grom) and process it with the
  83.  dis-assembler. If the file option is
  84.  chosen the prompt is reissued to find
  85.  out how the data is to be handled. IE
  86.  is it 9900 code (Rom) etc.
  87.  
  88.  
  89.  A D D R E S S   S E L E C T I O N
  90.  ---------------------------------
  91.  
  92.  Address limits to print or decode are
  93.  specified in hex as a start address and
  94.  an end address. 
  95.  
  96.  If the file option was chosen the
  97.  address represents where the code WOULD
  98.  reside if it were in memory. This
  99.  enables the dis-assembler to generate
  100.  jump and branch addresses correctly. See
  101.  also the description of OFFSET later.
  102.  
  103.  If the ROM/RAM option was chosen and the
  104.  address range overlaps DSR rom (4000h -
  105.  5FFFh) an additional prompt is issued
  106.  for the DSR CRU address. You may pick
  107.  one of the predefined addresses (Disk,
  108.  RS232, P-Code) or OTHER which enables
  109.  you to specify a non standard address.
  110.  
  111.  
  112.  F I L E   S E L E C T I O N
  113.  ---------------------------
  114.  
  115.  If the file option was chosen the
  116.  dis-assembler prompts for the file to
  117.  use. If the file is not found the
  118.  prompt is reissued. After the file has
  119.  been opened a prompt for offset appears.
  120.  This allows you to enter in decimal the
  121.  offset in bytes (0 relative) that the
  122.  data to be decoded is in the file.
  123.  
  124.  This is useful if the data to be decoded
  125.  does not start at the beginning of the
  126.  file or you wish to decode a fragment
  127.  of code starting in the middle of the
  128.  file. In combination with the start
  129.  address this enables the dis-assembler
  130.  to generate meaningful jump and branch
  131.  addresses.
  132.  
  133.  
  134.  T I P S   O N   U S E
  135.  ---------------------
  136.  
  137.  When dis-assembling 9900 code there is
  138.  usually embedded data and parameters.
  139.  This will cause the program to produce
  140.  some funny code at times. If the program
  141.  does get 'out of step' it will re-synch
  142.  fairly quickly.
  143.  Try starting at console rom address
  144.  24h. This is the start of the power up
  145.  routine. The workspace address is at
  146.  address 0000h and the code address is
  147.  at 0002h.
  148.  
  149.  Decoding GPL instructions is a little
  150.  harder than 9900 code as they are byte
  151.  oriented. If the dis-assembler (dis-gpl)
  152.  gets out of step it is difficult to get
  153.  re-synchronized. For this reason you
  154.  will need to pay attention when decoding
  155.  GPL instructions.
  156.  Try starting at address 52h. This is the
  157.  GPL power clear routine. This can be
  158.  calculated from the 9900 instruction at
  159.  address 0030h (li R0,20h) which is the
  160.  first GPL instruction to be executed.
  161.  This points to a GPL branch to address
  162.  0052h.
  163.  
  164.  The file option is useful for decoding
  165.  data that is not readily accesible to 
  166.  the dis-assembler. For example some
  167.  initialization code for the P-System
  168.  is moved from P-Code GROM to ram address
  169.  2000h and branched to. It is not prac-
  170.  tical to build the capability ti handle
  171.  specific cases like that into the 
  172.  program. Instead a simple routine can be
  173.  written to dump the code from GROM to a
  174.  file and process it that way. 
  175.  EG. if the code to be dis-assembled is
  176.  dumped to a file and is executed at
  177.  address 2000h you would specify a start
  178.  address of 2000h and an OFFSET of 0.
  179.  If you wished to start at address 2024h
  180.  you would specify a start address of
  181.  2024h and an offset of 36 (decimal).
  182.  This will ensure correct addresses are
  183.  generated. Note that the OFFSET is a
  184.  decimal value of BYTES! This is in case
  185.  the file contains GPL code.