home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / 68000ASM.ZIP / README < prev    next >
Text File  |  1989-04-10  |  3KB  |  89 lines
  1.  
  2. Distribution Notes                                 68000 Assembler/Simulator
  3. 8/4/89                                             Version 1.0
  4.  
  5.  
  6.  
  7. DESCRIPTION:
  8.  
  9.     This product is meant to provide a learning tool and/or a useful 
  10.     cross-development tool for people doing MC68000 software development.
  11.     It contains two separate programs:
  12.  
  13.     1. A 68000 cross-assembler which produces text output in S-record
  14.        format suitable for downloading to single-board 68000 computers
  15.        or PROM burners.
  16.  
  17.     2. A 68000 simulator which allows debugging of the 68000 source
  18.        by reading the S-record output produced by the assembler.  The
  19.        simulator mimics the operation of the 68000 microprocessor as
  20.        documented in the 68000 Programmer's Reference Manual.
  21.  
  22.     The source code is provided for several reasons.  The user may want
  23.     to modify the programs' behavior, add features of his own, port the 
  24.     programs to different machines, or fix bugs if they come up.
  25.  
  26.     These programs were written at North Carolina State University's
  27.     Electrical and Computer Engineering department.
  28.  
  29.  
  30.  
  31. CONTENTS:
  32.  
  33.     The contents of this disk are as follows :
  34.  
  35.         EXE.ARC         -- Executable files and user manuals
  36.         ASM-SRC.ARC     -- Cross-Assembler's C source code
  37.         SIM-SRC.ARC     -- Simulator's C source code
  38.         TST.ARC         -- Sample 68000 source files
  39.  
  40.  
  41.  
  42. PROBLEM WITH THE SIMULATOR:
  43.  
  44.     There is an undocumented problem with the simulator.  It won't allow
  45.     use of the memory between addresses 1000 (hex) and 1003 (hex) 
  46.     inclusive because those are the addresses that the simulated 6850
  47.     chip maps its registers to.  The 6850 is was implemented in a
  48.     previous simulator version but has been disabled for this version.
  49.     The simulator's address space is 64K of memory from address 0 to
  50.     address FFFF (hex).
  51.  
  52.  
  53.  
  54. DISTRIBUTION:
  55.  
  56.     The contents of this disk are public domain.  You may use the 
  57.     source code in your applications, and you may copy and distribute 
  58.     the disk freely with the notable exception that you may not charge
  59.     more than a minimal handling fee for distributing it.
  60.  
  61.  
  62.  
  63.  
  64. NOTES ON THE SOURCE CODE:
  65.  
  66.     The two programs were originally written on a VAX 11/750 and later
  67.     ported to the PC.  The source code provided on this diskette 
  68.     was compiled with the Microsoft C 5.0 compiler.  It should be
  69.     possible, of course, to compile this code with any C compiler
  70.     that uses 16-bit integers with minimal modifications.  VAX source 
  71.     code is available by contacting me at the address below.
  72.  
  73.  
  74.  
  75. COMMENTS:
  76.  
  77.     Comments and suggestions for improving this product are welcome.
  78.     You may reach me at:
  79.  
  80.     e-mail :   shaban@ece36h.ncsu.edu  (internet)
  81.  
  82.     or
  83.  
  84.     US mail:   Marwan Shaban
  85.                PO Box 19494
  86.                Raleigh, NC  27619
  87.  
  88.  
  89.