home *** CD-ROM | disk | FTP | other *** search
/ 20 Miles North of Nowhere BBS / 20miles_north_of_nowhere_1996_05_10.zip / 20miles_north_of_nowhere_1996_05_10 / EMULATOR / DUAE060.ZIP / README.DOS < prev    next >
Text File  |  1996-06-22  |  10KB  |  247 lines
  1. This is DosUAE the DOS port of the Un*x Amiga Emulator version 0.6.0 realease
  2.  
  3.  
  4.     First of all don't forget to read the original readme file first.
  5.  
  6.  
  7. 1. What you need to get the DOS version to work
  8.  
  9.     You need a VGA monitor/card, mouse/mouse-driver, and least a 386
  10. computer.
  11.     A VESA BIOS compatable SVGA card and monitor capable of showing
  12. 800x600 resolution in HiColor graphics can enhance the emulation, thought not
  13. really necessary. A normal analog joystick connected at port 201H will also
  14. work.
  15.     That's about it.
  16.  
  17.  
  18. 2. Changes
  19.  
  20.     Now there are two command line parameter for controling the sound
  21. buffer size.
  22.     One is '-b' this is the minimum sound buffer size, this parameter
  23. will be most used when the emulator is running slower them a A500, it will
  24. force that a sample to be played on the sound blaster must have at least
  25. that size, the default size is 1024.
  26.     The other is '-B' this parameter wilk be most used when the emulator
  27. is running faster them a A500, values too big here will produce a lag between
  28. the emulated program and the sound comming out, the default size is 8192.
  29.  
  30.  
  31. 3. Features/Notes
  32.     
  33.     Note that the emulator has some parameter diferent them the unix
  34. version and as reported in the 'readme' file, notabaly the '-d' parameter
  35. works slitly diferrent, and the '-C' and '-B' parameters are only avalible
  36. under DOS, to generate a brief help of uae on a 'uae-help.txt' file execute:
  37.  
  38.     uae -h > uae-help.txt
  39.  
  40.     You can now put frequently used command line switches in the 'uae.rc'
  41. file. Note also that diskimages don't need to have the 'df0.adf' filename,
  42. they can now be invoked with the '-0 <filename>' command line switch. Use
  43. the command 'uae -h' for a brief help on command line options.
  44.     Some people have trouble using the emulator under windows 95, note
  45. that the emulator will be the most stable if you exit windows 95 and enter
  46. the DOS only prompt
  47.     Remember to keep the cwsdpmi.exe program in the same directory of
  48. uae.
  49.     DosUAE has a web page now - http://tinos.pucrs.br/~ggoedert/dosuae.html
  50. it is still in early stage.
  51.  
  52. 3.1 Sound
  53.     
  54.     There is now a preliminary sound support, it's only done for sound
  55. blaster support with 8 bits and 22050 sample frequency, for now it only
  56. works with DMA 1 and IRQ either 5 or 7, it sudh work with any sound blaster
  57. compatible card thought. Note that you must have BLASTER enviroment variable
  58. set to the sound code to work, if you don't have you must set it by hand,
  59. for example if you have a sound blaster compatible card on PORT 220H, IRQ 5
  60. and DMA 1 try running the DOS command:
  61.  
  62.     SET BLASTER=A220 I5 D1
  63.  
  64.     *DO NOT* run this command if you already have the BLASTER enviroment
  65. variable, to check if you already have one run the DOS commad:
  66.  
  67.     SET | more
  68.  
  69.     And look to see if there is any reference to the BLASTER variable.
  70.     If you are not sure what are your sound cards PORT, IRQ and DMA values
  71. look in your sound card manual for factory default values, usualy for sound
  72. blaster cards it is PORT 220H, DMA 1 and IRQ 5 for newer cards and IRQ 7
  73. for older cards, ofcourse this is not necessaraly true, if you miss the
  74. parameters the emulator will hang.
  75.     There are
  76.     Note that the sound code is better used with programs that don't
  77. make high use of graphics, you can disable graphics output hiting
  78. the ScrollLock key (thought this does not turn off blitter calculations),
  79. hitting ScrollLock again turns graphics back on. If the sound code is slowing
  80. too much your emulated program, or if your computer is too slow to make this
  81. feature usefull you can allways turn the support off with the '-S' command
  82. line parameter in uae, like in 'uae -S'.
  83.  
  84. 3.2 Screen resolution
  85.     
  86.     This verion now has a feature that enable correct aspect ratio
  87. at all screnn resolutions, it is activated with the command line option
  88. '-C' , run 'uae -h' for futter details (try 'uae -d0 -C' for playing games -
  89. it's fast, not too beatfull thought).
  90.     Note that if you enable the correct aspect ratio option the emulator
  91. will skip some lines to fit the image on the screen, unless you are running
  92. at the 800x600 resolution.
  93.  
  94. 3.3 Disk Eject/Change
  95.     
  96.     There is a preliminary eject/change disk support.
  97.     To eject a disk use the END key plus one of the F1 or F2 or F3 or
  98. F4 keys, where F1 is for drive DF0,  F2 is for drive DF1, F3 is for drive DF2
  99. and F4 is for drive DF3.
  100.     To change a disk use the HOME key plus one of the F1 or F2 or F3 or
  101. F4 keys, where F1 is for drive DF0,  F2 is for drive DF1, F3 is for drive DF2
  102. and F4 is for drive DF3.
  103.     Note that if you change a disk without ejecting it first the software
  104. running under the emulator will not notice that the disk has changed.
  105.     Note PageUp and RightWindows keys are the RightAmiga key and the
  106. PageDown and LeftWindows are the LeftAmiga key.
  107.  
  108. 3.4 Hardfile
  109.     
  110.     Note that the hardfile in the DOS version is not fixed sized (8 Mega)
  111. as in the unix version, it can have any arbritary size, use makedisk to make
  112. a harfile of the size you desire, this utility can also make small diskfiles
  113. (execute it for details on usage). Remember to format your new
  114. hardfile/diskfile. *WARNING* makedisk will delete your old hardfile file if
  115. requested to do a new one.
  116.  
  117. 3.5 Printer Support
  118.  
  119.     To use the printer you might need to use the '-p' command line
  120. parameter, try using the device that your printer is connected to, for
  121. exemple, use '-p LTP2:' if your printer is in parallel port 2, or you
  122. could try '-p prn'. If nothing works you could still try '-p file' then
  123. do a 'copy /b file prn' when you leave the emulator. The default printing
  124. device is LTP1:.
  125.  
  126.  
  127. 4. Troubles
  128.  
  129.     Note that some diskimages available on the net are compressed with
  130. gzip, they usualy have either a '.gz' extension or a '.bin' extension
  131. (realy '.gz.bin'), anyway if you see one with '.bin' rename it to '.gz'.
  132. You can grab gunzip program at ftp site oak.oakland.edu, this will uncompress
  133. the diskimage.
  134.     Note that some programs (notably the RSI1 demo) need the -s command
  135. line option.
  136.     All error/warnings are now logged in the 'uae.log' file, if you
  137. have troubles, examining it might help you out, *BEAWARE* that if you use
  138. some corrupted disk image or rom the log file will grow until it fills your
  139. winchester...
  140.     If you are having trouble starting the graphics mode maybe your card
  141. does not have a built-in BIOS VESA interface, usualy it can be loaded from
  142. a TSR program that comes with the SVGA card utilities, there is also a
  143. universal VESA BIOS interface program called univbe, with can be downloaded
  144. with ftp from oak.oakland.edu. If you are still having problems try making a
  145. boot disk with only the VESA BIOS program and the mouse driver. Now there
  146. are also low resolution modes that work on all vga cards, if nothing works
  147. try the '-d 2' command line parameter.
  148.  
  149.  
  150. 5. Recompiling the DOS port (Programmers only)
  151.  
  152.     I used DJGPP 2.0 compiler and the LIBGRX 2.0 graphics library to make
  153. this port.
  154.     The original source file can be found at Bernd's web page.
  155.     My modifications are contained in the 'dospatch.gz' patch file. Use
  156. the following commands to apply it on the original source (in a unix system):
  157.  
  158.     gunzip dospatch.gz
  159.     patch -p0 < dospatch
  160.  
  161.     DJGPP 2.0 and LIBGRX 2.0 packages can be found at www.delorie.com
  162. www site, they are both free software.
  163.     Note that if you have problems extracting the dos code i managed
  164. to put the role DOS source in a zip file, look at the DosUAE web page for
  165. it (http://tinos.pucrs.br/~ggoedert/dosuae.html).
  166.  
  167.  
  168. 6. ChangeLog
  169.  
  170. Version 0.6.0
  171.     * Optimize a little the sound blaster code.
  172.     * Two sound buffer sizes, minumum and maximum.
  173. Version 0.5.4b
  174.     * Preliminary sound support, only done for sound blaster 8 bits
  175.       22050 sample frequency, only works with DMA 1 and IRQ either 5 or
  176.       7.
  177.     * Sound buffer size command line option implemented
  178.     * Some impirical printer support debuging (since i don't have a
  179.       printer)
  180.     * Lock variables used by interrupt handlers, might increase stability
  181.       of the emulator for machines with little memory.
  182. Version 0.5.4
  183.     * Less Optimized version removed
  184.     * Script flag forced off on the filesys support
  185.     * Correct aspected ratio command line option added, works with any
  186.       resolution now
  187. Version 0.5.3
  188.     * Less Optimized version made
  189.     * Disk Change/Eject implemented
  190.     * CPU keyboard reset fixed
  191.     * SVGA asm code optimized a bit
  192.     * SVGA 640x480 mode implemented
  193.     * Normal DOS slaches (/) are now support in the filesys mount
  194.     * Script and Exec flags are now forced on the filesys support
  195.     * Printer support ported from unix code
  196. Version 0.5.2
  197.     * SVGA asm code remade
  198.     * VGA low-res modes implemented
  199.     * Joystick button bug fixed
  200.     * Keyboard support finished (extended keys)
  201.     * Arbritary size hardfile implemented
  202.     * Makedisk redone to support arbritary size hardfile
  203. Version 0.5.0
  204.     * Linux Assembler code ported to DOS
  205.     * SVGA asm code remade
  206.     * Makedisk utilitie created (make hardfile and diskfiles)
  207.     * Mouse support redone (interrupt)
  208. Version 0.4.4
  209.     * DPMI/EMS version implemented with DJGPP 2.0
  210.     * SVGA asm code remade
  211.     * SVGA Hicolor/64k mode implemented with libgrx 2.0
  212.     * Joystick support implemented (pooling port 201H)
  213.     * Disable messages command line option removed
  214.     * Logging of messages into 'uae.log' file
  215.     * Hardfile bug fixed
  216. Version 0.4.1
  217.     * First public realese
  218.     * EMS only version implemented with DJGPP 1.12.maint4
  219.     * No graphics mode implemneted (Doh!)
  220.     * SVGA 800x600 256 and HiColor/32k modes implemented with libgrx
  221.       1.03.maint1 (and some speed up hacks)
  222.     * Keyboard support implemented (interrupt)
  223.     * Mouse support implemented (pooling)
  224.     * Filesys fixed to work with DOS
  225.     * Disable messages command line option implemented
  226.  
  227.  
  228. 7. Contacting the DOS port author
  229.  
  230.     If you have any comments, sugestions or bugfixes you can send
  231. to my email adress:
  232.  
  233. ggoedert@music.pucrs.br
  234.  
  235.     Just don't send me emails during weekends, because for some
  236. odd/strange/mad reason the universaty turns off the computer i have
  237. email access on weekends, all other days are ok, even at night.
  238.     You can contact me by normal mail also:
  239.  
  240. Gustavo Goedert
  241. Rua Francisco Braga, 239
  242. Porto Alegre, RS
  243. CEP 91530-330
  244. BRAZIL
  245.  
  246. PS: Please forgive my poor english. :)
  247.