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 >
Wrap
Text File
|
1996-06-22
|
10KB
|
247 lines
This is DosUAE the DOS port of the Un*x Amiga Emulator version 0.6.0 realease
First of all don't forget to read the original readme file first.
1. What you need to get the DOS version to work
You need a VGA monitor/card, mouse/mouse-driver, and least a 386
computer.
A VESA BIOS compatable SVGA card and monitor capable of showing
800x600 resolution in HiColor graphics can enhance the emulation, thought not
really necessary. A normal analog joystick connected at port 201H will also
work.
That's about it.
2. Changes
Now there are two command line parameter for controling the sound
buffer size.
One is '-b' this is the minimum sound buffer size, this parameter
will be most used when the emulator is running slower them a A500, it will
force that a sample to be played on the sound blaster must have at least
that size, the default size is 1024.
The other is '-B' this parameter wilk be most used when the emulator
is running faster them a A500, values too big here will produce a lag between
the emulated program and the sound comming out, the default size is 8192.
3. Features/Notes
Note that the emulator has some parameter diferent them the unix
version and as reported in the 'readme' file, notabaly the '-d' parameter
works slitly diferrent, and the '-C' and '-B' parameters are only avalible
under DOS, to generate a brief help of uae on a 'uae-help.txt' file execute:
uae -h > uae-help.txt
You can now put frequently used command line switches in the 'uae.rc'
file. Note also that diskimages don't need to have the 'df0.adf' filename,
they can now be invoked with the '-0 <filename>' command line switch. Use
the command 'uae -h' for a brief help on command line options.
Some people have trouble using the emulator under windows 95, note
that the emulator will be the most stable if you exit windows 95 and enter
the DOS only prompt
Remember to keep the cwsdpmi.exe program in the same directory of
uae.
DosUAE has a web page now - http://tinos.pucrs.br/~ggoedert/dosuae.html
it is still in early stage.
3.1 Sound
There is now a preliminary sound support, it's only done for sound
blaster support with 8 bits and 22050 sample frequency, for now it only
works with DMA 1 and IRQ either 5 or 7, it sudh work with any sound blaster
compatible card thought. Note that you must have BLASTER enviroment variable
set to the sound code to work, if you don't have you must set it by hand,
for example if you have a sound blaster compatible card on PORT 220H, IRQ 5
and DMA 1 try running the DOS command:
SET BLASTER=A220 I5 D1
*DO NOT* run this command if you already have the BLASTER enviroment
variable, to check if you already have one run the DOS commad:
SET | more
And look to see if there is any reference to the BLASTER variable.
If you are not sure what are your sound cards PORT, IRQ and DMA values
look in your sound card manual for factory default values, usualy for sound
blaster cards it is PORT 220H, DMA 1 and IRQ 5 for newer cards and IRQ 7
for older cards, ofcourse this is not necessaraly true, if you miss the
parameters the emulator will hang.
There are
Note that the sound code is better used with programs that don't
make high use of graphics, you can disable graphics output hiting
the ScrollLock key (thought this does not turn off blitter calculations),
hitting ScrollLock again turns graphics back on. If the sound code is slowing
too much your emulated program, or if your computer is too slow to make this
feature usefull you can allways turn the support off with the '-S' command
line parameter in uae, like in 'uae -S'.
3.2 Screen resolution
This verion now has a feature that enable correct aspect ratio
at all screnn resolutions, it is activated with the command line option
'-C' , run 'uae -h' for futter details (try 'uae -d0 -C' for playing games -
it's fast, not too beatfull thought).
Note that if you enable the correct aspect ratio option the emulator
will skip some lines to fit the image on the screen, unless you are running
at the 800x600 resolution.
3.3 Disk Eject/Change
There is a preliminary eject/change disk support.
To eject a disk use the END key plus one of the F1 or F2 or F3 or
F4 keys, where F1 is for drive DF0, F2 is for drive DF1, F3 is for drive DF2
and F4 is for drive DF3.
To change a disk use the HOME key plus one of the F1 or F2 or F3 or
F4 keys, where F1 is for drive DF0, F2 is for drive DF1, F3 is for drive DF2
and F4 is for drive DF3.
Note that if you change a disk without ejecting it first the software
running under the emulator will not notice that the disk has changed.
Note PageUp and RightWindows keys are the RightAmiga key and the
PageDown and LeftWindows are the LeftAmiga key.
3.4 Hardfile
Note that the hardfile in the DOS version is not fixed sized (8 Mega)
as in the unix version, it can have any arbritary size, use makedisk to make
a harfile of the size you desire, this utility can also make small diskfiles
(execute it for details on usage). Remember to format your new
hardfile/diskfile. *WARNING* makedisk will delete your old hardfile file if
requested to do a new one.
3.5 Printer Support
To use the printer you might need to use the '-p' command line
parameter, try using the device that your printer is connected to, for
exemple, use '-p LTP2:' if your printer is in parallel port 2, or you
could try '-p prn'. If nothing works you could still try '-p file' then
do a 'copy /b file prn' when you leave the emulator. The default printing
device is LTP1:.
4. Troubles
Note that some diskimages available on the net are compressed with
gzip, they usualy have either a '.gz' extension or a '.bin' extension
(realy '.gz.bin'), anyway if you see one with '.bin' rename it to '.gz'.
You can grab gunzip program at ftp site oak.oakland.edu, this will uncompress
the diskimage.
Note that some programs (notably the RSI1 demo) need the -s command
line option.
All error/warnings are now logged in the 'uae.log' file, if you
have troubles, examining it might help you out, *BEAWARE* that if you use
some corrupted disk image or rom the log file will grow until it fills your
winchester...
If you are having trouble starting the graphics mode maybe your card
does not have a built-in BIOS VESA interface, usualy it can be loaded from
a TSR program that comes with the SVGA card utilities, there is also a
universal VESA BIOS interface program called univbe, with can be downloaded
with ftp from oak.oakland.edu. If you are still having problems try making a
boot disk with only the VESA BIOS program and the mouse driver. Now there
are also low resolution modes that work on all vga cards, if nothing works
try the '-d 2' command line parameter.
5. Recompiling the DOS port (Programmers only)
I used DJGPP 2.0 compiler and the LIBGRX 2.0 graphics library to make
this port.
The original source file can be found at Bernd's web page.
My modifications are contained in the 'dospatch.gz' patch file. Use
the following commands to apply it on the original source (in a unix system):
gunzip dospatch.gz
patch -p0 < dospatch
DJGPP 2.0 and LIBGRX 2.0 packages can be found at www.delorie.com
www site, they are both free software.
Note that if you have problems extracting the dos code i managed
to put the role DOS source in a zip file, look at the DosUAE web page for
it (http://tinos.pucrs.br/~ggoedert/dosuae.html).
6. ChangeLog
Version 0.6.0
* Optimize a little the sound blaster code.
* Two sound buffer sizes, minumum and maximum.
Version 0.5.4b
* Preliminary sound support, only done for sound blaster 8 bits
22050 sample frequency, only works with DMA 1 and IRQ either 5 or
7.
* Sound buffer size command line option implemented
* Some impirical printer support debuging (since i don't have a
printer)
* Lock variables used by interrupt handlers, might increase stability
of the emulator for machines with little memory.
Version 0.5.4
* Less Optimized version removed
* Script flag forced off on the filesys support
* Correct aspected ratio command line option added, works with any
resolution now
Version 0.5.3
* Less Optimized version made
* Disk Change/Eject implemented
* CPU keyboard reset fixed
* SVGA asm code optimized a bit
* SVGA 640x480 mode implemented
* Normal DOS slaches (/) are now support in the filesys mount
* Script and Exec flags are now forced on the filesys support
* Printer support ported from unix code
Version 0.5.2
* SVGA asm code remade
* VGA low-res modes implemented
* Joystick button bug fixed
* Keyboard support finished (extended keys)
* Arbritary size hardfile implemented
* Makedisk redone to support arbritary size hardfile
Version 0.5.0
* Linux Assembler code ported to DOS
* SVGA asm code remade
* Makedisk utilitie created (make hardfile and diskfiles)
* Mouse support redone (interrupt)
Version 0.4.4
* DPMI/EMS version implemented with DJGPP 2.0
* SVGA asm code remade
* SVGA Hicolor/64k mode implemented with libgrx 2.0
* Joystick support implemented (pooling port 201H)
* Disable messages command line option removed
* Logging of messages into 'uae.log' file
* Hardfile bug fixed
Version 0.4.1
* First public realese
* EMS only version implemented with DJGPP 1.12.maint4
* No graphics mode implemneted (Doh!)
* SVGA 800x600 256 and HiColor/32k modes implemented with libgrx
1.03.maint1 (and some speed up hacks)
* Keyboard support implemented (interrupt)
* Mouse support implemented (pooling)
* Filesys fixed to work with DOS
* Disable messages command line option implemented
7. Contacting the DOS port author
If you have any comments, sugestions or bugfixes you can send
to my email adress:
ggoedert@music.pucrs.br
Just don't send me emails during weekends, because for some
odd/strange/mad reason the universaty turns off the computer i have
email access on weekends, all other days are ok, even at night.
You can contact me by normal mail also:
Gustavo Goedert
Rua Francisco Braga, 239
Porto Alegre, RS
CEP 91530-330
BRAZIL
PS: Please forgive my poor english. :)