home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / dev / dis6502-1.0.lha / Dis6502 / Dis6502.docs < prev    next >
Encoding:
Text File  |  1993-12-21  |  2.9 KB  |  80 lines
  1. Short: Disassembler for the 6502-processorfamily (C64,...)
  2.  
  3. Dis6502 v1.00,
  4.  
  5. 6502/6510/8502/8510 disassembler,
  6.  
  7. written by Morten Eriksen, November 1993.
  8.  
  9.  
  10. Preface
  11. =======
  12.  
  13. Dis6502 is SHAREWARE and © copyright 1993 by Morten Eriksen.
  14. If you like this program, please send me $10 (or an equal amount in your
  15. own currency, cash only) and a disk to become a registered user. In return
  16. you will get the latest update. If you've got an email address, you'll get
  17. all future upgrades for free aswell. See end of document for my address.
  18. Further upgrades depends on if I get some registrations.
  19.  
  20. Dis6502 is a disassembler for the 6502-family of microprocessors. It will
  21. turn C64 (or any other 6502-based computer's) binaries into listings of
  22. CPU opcodes.
  23. Dis6502 supports all officially documented opcodes on the 6502-compatible
  24. processorfamily. Future versions will support undocumented opcodes
  25. (optionally), hardwareregister-recognition for the C64 hardwareregisters,
  26. relative offset disassembling, and a lot more. (I'm also planning to make
  27. a 6502-source to 68000-source converter, for easy, perfect conversions of
  28. those old'n'golden C64 games). If there's any interest, I could make a
  29. 6502 (cross)assembler too? (If it's not been done already.)
  30.  
  31.  
  32. Starting Dis6502
  33. ================
  34.  
  35. Start the disassembler by entering the command line:
  36.  
  37.    Dis6502 [loadadr] <filename>
  38.  
  39. Where <filename> is the 6502 binary to be loaded, and <loadadr> is an
  40. optional specification of the absolute address where the binaryfile
  41. will be disassembled relative to. Note: If you don't specify the
  42. <loadadr>, Dis6502 assumes that the loadadress is contained in the
  43. two first bytes of the file (standard C64 loadfile).
  44.  
  45. Here's two examples for you to try if you've got the PlaySid package:
  46.  
  47. Exploding Fist II:
  48. 1. Take a look at this file's icon ("Information" in one of the WB-menus).
  49.   The first number is the loadadress, second number is the initadress and
  50.   third adress is the playadress.
  51. 2. Notice that the Exploding Fist II -music and -musicroutines should be
  52.   loaded to adress $a400.
  53. 3. Start Dis6502 with:
  54.                        Dis6502 $a400 <path>/ExplodingFistII
  55.   (where <path> is the path to the Exploding Fist II musicfile).
  56. 4. Wait a while (yes, I know Dis6502 is a bit slow at the moment, will
  57.   be fixed in next version (promise)).
  58. 5. The disassembled code is now in the file <path>/ExplodingFistII.asm.
  59.  
  60. Revenge of the Mutant Camels:
  61. In this file's icon, the loadadress is 0. This means that this file's
  62. first two bytes contain the actual loadadress. Therefore, start Dis6502
  63. with:
  64.       Dis6502 <path>/RevMutantCamels    (don't specify loadadress)
  65.  
  66. Load the disassembled file, and notice that the file has been diassembled
  67. from $bfc0.
  68.  
  69.  
  70.  
  71. For questions, bug-reports, pat-on-the-backs, registrations, suggestions
  72. and ideas for further upgrades or for anything else, contact me at:
  73.  
  74.     Morten Eriksen
  75.     Jonsborgvn. 18
  76.     7563 Malvik
  77.     NORWAY
  78.  
  79. ..or by email:        mortene@idt.unit.no
  80.