home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Emulatoren / UAE061.LZH / uae-0.6.1 / README.AMIGA < prev    next >
Encoding:
Text File  |  1996-08-28  |  7.7 KB  |  206 lines
  1.                               UAE-0.6.1
  2.                             AMIGA version
  3.                                    
  4.                           by Samuel Devulder
  5.                        devulder@info.unicaen.fr
  6.  
  7.                               Aug. 1996
  8.                                    
  9.  
  10. INTRODUCTION
  11. ============
  12.  
  13. This the Amiga port of UAE v0.6.1. UAE is the Un*x Amiga Emulator
  14. written by Bernd Schmidt. This port was achieved by me (Samuel
  15. Devulder) and is slightly different from the original AMIGA port by
  16. Olaf Barthel (available in UAE v0.5.3). I thank him for his code that
  17. I used in this version (cybergfx part in awin.c).
  18.  
  19. You should read the README file before this one to know more about uae.
  20. (how to use it, command-line options, what is emulated, and so on...).
  21.  
  22. This port features many things. It is build with the help of ADE
  23. (Amiga Development Enviroment): GCC, ixemul, ... Thus allowing an easy
  24. port of the original unix version to the Amiga without a lot of
  25. modifications. 
  26.  
  27.  
  28. REQUIREMENTS
  29. ============
  30.  
  31. This version will work on any Amiga running at least AmigaOS v2.04 and
  32. is programmed to use AmigaOS v3.0 facilities when available. UAE needs
  33. roughly 8Mb of free ram to run on the Amiga. A fast processor is also
  34. strongly recommended. 
  35.  
  36. Note that you can use UAE under VMM and that uae can run under uae !
  37.  
  38.  
  39. FEATURES
  40. ========
  41.  
  42. The joystick can be used within the emulation, allowing you to play
  43. games without destroying your numeric keypad with the '-J' option :-). 
  44.  
  45. The sound is not emulated as the emulation is too slow on the Amiga to
  46. be usefull.  
  47.  
  48. The CPU emulation is speed up by using ASM code to compute flags
  49. directly from the 680x0 SR/CCR register.
  50.  
  51. It supports all Amiga natives mode as well as cybergraphics mode (that
  52. still needs to be tested; I'm waiting your bug-reports :-). It can run
  53. on a automatically-selected custom screen, or on a user-selected
  54. screen, or on the default public screen. It will dither the output
  55. when not enough colors are available (unless you disable dithering),
  56. and eventually use a grayscale palette if less that 8 colors are
  57. available. This will give you the best graphic output according to
  58. your configuration. (use "uae -h" to know how to selected the
  59. rendering style).
  60.  
  61. You can mount Amiga partitions using the -m option, but as it is only a
  62. port, this version does not allow you to use Amiga disk-drives and you
  63. must use disk-files. Be sure to use unix convention when giving a path
  64. to UAE. For exemple do not do 
  65.  
  66.         CLI> uae -m boot:dh0:path -0 /disks/df0.adf 
  67.  
  68. but rather
  69.  
  70.         CLI> uae -m boot:/dh0/path -0 ../disks/df0.adf
  71.  
  72. This is not a bug, but an ixemul.library feature. May be you can read
  73. floppy disks by using a dev: handler (something like "uae -0
  74. /dev/trackdisk.device/0" might suffice).
  75.  
  76. You can reset the emulator by pressing CTRL-ALT-DEL in UAE's window. I
  77. guess it reminds you something.
  78.  
  79. The F12 key of the X11 version of uae is simulated by pressing
  80. CTRL-SHIFT-ALT-F10 simultanemously. This toggles the mouse emulation
  81. mode and is needed for some games or demos when you find that the
  82. mouse does not work well under UAE.
  83.  
  84.  
  85. HOW TO (RE-)BUILD UAE
  86. =====================
  87.  
  88. If you wish to (re-)build uae, you need to have ADE/gcc correctly
  89. installed (see ftp://ftp.ninemoons.com/pub/ade/). Not all part of ADE
  90. are needed, but be sure to have gcc2.7.2, binutils, autoconf, awk, ... 
  91.  
  92. The default Makefile provided is for a mc68030 microprocessor. If you
  93. wish to have a Makefile tuned for your CPU, just type "sh -c configure". 
  94.  
  95. If you have deleted the file "configure", you can rebuild it from
  96. "configure.in". To do this, just type autoconf in a shell. Although be
  97. warned that ADE's autoconf is somehow buggy and the generated
  98. configure script is likely to generate a wrong "config.cache" file. So
  99. take care about the included configure script as this one is not buggy
  100. (I've modified my /share/autoconf/acgeneral.m4 file to remove that bug).
  101.  
  102. Once your Makefile is generated (if needed), you can modify the file
  103. "config.h" to suit your needs. You can also modify "awin.c" to allow
  104. the support of cybergfx codes (you need to get CGraphX-DevKit.lha from
  105. aminet to do so). 
  106.  
  107. When you have configured uae correctly, type "make" in a shell. Then
  108. 1.5 hours later you get the uae executable (it might be less if you
  109. have a real fast Amiga). I know it's slow, but Amigas are slow (even
  110. those with 060 are not that fast, by today's standards ;-).
  111.  
  112. To compile, 10Mb of free memory should be enough (I have 4Mb, but
  113. virtual memory helps in that case). The resulting directory size is
  114. roughtly 4Mb on my harddrive. Be sure to have a stack of at least
  115. 300Kb when compiling UAE and at least 32kb when UAE is running.
  116.  
  117.  
  118. REMARKS OR BUG-REPORTS
  119. ======================
  120.  
  121. You can send me your remarks and bug-report to:
  122.  
  123.                        devulder@info.unicaen.fr
  124.  
  125.  
  126. MODIFIED FILES
  127. ==============
  128.  
  129. This Amiga port should compile well on other systems than the AmigaOS
  130. as no big hack was needed to do the port. All amiga specific code is
  131. embeded within #ifdef AMIGA / #endif pair.
  132.  
  133. configure.in:   Detection of target amiga.
  134.  
  135. awin.c:         Main Amiga file. It is a port of xwin.c that uses
  136.                 Amiga functions. (file added to the original uae-0.6.1
  137.                 archive).  
  138.  
  139. debug.c:        Code to support ^C break. (see defined(AMIGA)).
  140.  
  141. expansion.c:    Check if malloc() returns NULL.
  142.  
  143. filesys.c:      Deletion of SAS/C code from Olaf's port (ixemul rules :)
  144.  
  145. gencpu.c:       GNU_FLAG_OPT (slight optimisation of flag evaluation
  146.                 using gcc extensions).
  147.                 M68K_FLAG_OPT (uses SR to evaluate flags).
  148.  
  149. gfxutil.c:      Added setup_maxcol() and setup_grey_dither_maxcol() for
  150.                 awin.c to run well. This should not interfere with the
  151.                 unix code.
  152.                 Make a special case for 8bit per pixel in DitherLine(). 
  153.         
  154. main.c:         Call unix parse_cmdline() in case of AMIGA.
  155.                 Use .uaerc in current directory if not found in $HOME.
  156.  
  157. memory.c:       Check if malloc() returns NULL.
  158.  
  159. newcpu.c:       M68K_FLAG_OPT code.
  160.  
  161. os.c:           Joystick emulation code. (I'm sorry to poke the
  162.                 hardware, but the gameport.device is awkward.. I need
  163.                 to have a look at the lowlevel.library).
  164.  
  165. zfile.c:        Special code for lha on unix as I've discovered that
  166.                 cmdline argument was different from lha on the Amiga.
  167.  
  168. include/newcpu.h:
  169.                 M68K_FLAG_OPT code.
  170.  
  171. include/options.h:
  172.                 Define M68K_FLAG_OPT when mc68000 is defined (might
  173.                 help mac version of uae too :-)
  174.                 Special code for fast_memcmp() and memcmpy() in case
  175.                 of m68000+.
  176.                 Defined REGPARAM to make use of gcc __attribute__
  177.                 extension. 
  178.  
  179. include/sysdeps.h:
  180.                 Redefinition of absolute values defined in libamiga.a.
  181.  
  182.  
  183. LAST NOTE
  184. =========
  185.  
  186. Why emulate an Amiga on an Amiga ? That can seem to be a foolish
  187. behaviour.. Actually it is not !
  188.  
  189. Many old games/demos refuse to work well if you are using a 68030+;
  190. even with degrader running. In that case, uae might be usefull.
  191.  
  192. UAE might also help graphic-board owners. With UAE, they can view all
  193. the demos with copper and blitter effects that fails to run on their
  194. graphics board. Or run programs like Deluxe-Paint or Brilliance that
  195. poke the hardware directly.
  196.  
  197. Using uae on a 68040+ Amiga will let you play games or demos on your
  198. workbench, in a perfect multitasking. And that is, believe me, quite
  199. amazing (even on my poor 68030 :-) 
  200.  
  201. The main advantage of uae, will be when PowerPC Amigas will come out.
  202. On these machines, I bet no old programs will run. Those machines will
  203. certainly include a 680x0 emulation enough to run DOS programs, but
  204. certainly not sufficient to run old games. Thanks to UAE, backward
  205. compatibility will not be a problem anymore. UAE is definitely a cool 
  206. thing.