--- uae/docs/README 2018/04/24 16:44:33 1.1.1.7 +++ uae/docs/README 2018/04/24 16:56:13 1.1.1.15 @@ -1,4 +1,4 @@ -This is version 0.8.7 of UAE, the Un*x Amiga Emulator. +This is version 0.8.15 of UAE, the Un*x Amiga Emulator. Versions numbered 0.8.x are beta versions, to be used for development only. If you are only a user of UAE, you are better off using the latest 0.7.x @@ -15,6 +15,9 @@ for UAE. See the file COPYING that is included in the top level directory of this archive for details. +The SCSI code distributed with UAE is also available under the terms of the +GPL and was written by J. Schilling. + Overview ======== @@ -85,8 +88,7 @@ Not emulated: or BSD. - The AGA chipset (A4000/A1200). This chipset has enhanced capabilites for up to 256 colors in all resolutions. -- Serial port emulation exists but doesn't work too well (someone tell me when - that's no longer true, I don't use it). +- Serial port emulation exists but doesn't work too well. Since the PC floppy controller can't read Amiga disks (yes, that's a fact), floppy access has to be emulated differently: Floppies are emulated by means @@ -167,9 +169,16 @@ kickstart_rom_file=file [default=kick.ro joyport0=mode [default=mouse] Specify how to emulate joystick port 0. You can use "mouse", "joy0", or "joy1" to use the corresponding input devices of your machine, or you can - select several different keyboard replacements for a joystick: "kbd1" for - the numeric pad with '0' as fire button, "kbd2" for the cursor keys with - right control as fire button and c is T/F/H/B with Alt as fire button. + select several different keyboard replacements for a joystick: + "kbd1" for the numeric pad. '0' is the fire button. Three keys on the + numeric pad act as autofire toggle: '.' (or ',' depending on your + keyboard language), Enter and the division key. + "kbd2" for the cursor keys with right control key as fire button and the + right shift key as autofire toggle + "kbd3" for T/F/H/B with the left Alt key as fire button and the left Shift + key as autofire toggle. + The autofire toggle keys will turn on autofire (25 shots per second), it + will stay enabled until you hit the autofire toggle again. joyport1=mode [default=joy0] Like joyport0, but for the Amiga's joystick port 1. use_gui=bool [default=yes] @@ -202,6 +211,10 @@ cpu_compatible=bool [default=no] If enabled, a slower but slightly more accurate variant of the CPU emulation will be used. This is needed for some types of copy protection, among other things. This is only meaningful for a CPU type of "68000". +nr_floppies=n [default=4] + The emulator will emulate this many external floppy drives. Some very old + games apparently have problems if this is larger than 1, but for all normal + programs the default is good enough. Emulating external devices (harddisk, CD-ROM, printer, serial port): filesystem=access,volume:path [default=no filesystems mounted] @@ -235,6 +248,17 @@ sound_min_buff=n sound_max_buff=n [default varies across UAE versions on different OS types] You can specify the minimum and maximum size of the sound buffer. Smaller buffers reduce latency. Usually only the minimum size is used. +sound_interpol=type [default none] + Normally, sound samples are output exactly as they are computed, without + any post-processing. This can generate errors in the sound output when the + output frequency isn't an even multiple of the input frequency. These + errors are usuable perceived as a high-frequency noise. + There are currently two types of interpolation available, both under + experimentation. You can use either "rh" or "crux" as value for this + option. Note that no interpolation is supported for 8 bit output; you need + to use 16 bit output to hear a difference. If you have any comments about + the effects of either method on audio quality, I'd be very interested to + hear them. Memory options: bogomem_size=n [default=0] @@ -287,7 +311,7 @@ gfx_color_mode=mode [default=8bit] Color modes: 8bit (256 colors), 15bit (32768 colors), 16bit (65536 colors), 8bit_dithered (256 colors, with dithering to improve quality), 4bit_dithered (16 colors, dithered); 32bit (16 million colors) -gxfcard_size=n [default=0] +gfxcard_size=n [default=0] Emulate a Picasso 96 compatible graphics card with n MB graphics memory. This requires that you use set the CPU type to "68020" or higher, and that you do not use 24 bit addressing. @@ -543,6 +567,52 @@ After that is complete, reboot, and you modes from the ScreenModes program. +UAE SCSI device +=============== + +To enable SCSI support, use --enable-scsi-device when running configure. +The emulator provides a uaescsi.device. This device only supports +direct SCSI, which is sufficient to run applications like MakeCD. The +device does not support reading or writing with the normal Exec commands, +so you cannot mount filesystems on it right now. + +The unit numbers of the uaescsi.device follow the Amiga SCSI +conventions: unit number "xyz" maps to the lun y of target z on bus +x. Wide SCSI busses can have targets with numbers larger than 9. In +this case the uaescsi.device pretends that there is another SCSI +bus. To avoid confusion, all available SCSI targets are listed +together with their unit number when starting UAE. Devices cannot be +added while the emulator is running. Reseting it is not sufficient +either for technical reasons. + +The implementation of the uaescsi.device uses cdrecord's libscg as +interface to the native SCSI system. The Linux implementation of this +library used to be included into UAE, but now the library as generated +by the cdrecord source package (ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/) +is used. As the library is not distributed seperately, you will have +to get the whole cdrecord sources, compile it and then make several +header and lib files available to the compiler if (and only if) building +UAE with SCSI support. The script "src/install_libscg" copies the files +required for the libscg in cdrecord 1.8.1. + +Using threads is strongly recommended, because some SCSI commands can +run for extended periods of time and would block the whole emulation +during this time without threads. Use --enable-threads when starting +configure. + +Depending on the hosts capabilities the uaescsi.device may be limited +compared to other Amiga SCSI devices. The Linux kernel by default only +allows 32KB of data per SCSI command and does not always perform SCSI +requests in parallel. + +Setting the chunk size in MakeCD to 30KB is already too much and +causes an IO error -4 (IOERR_BADLENGTH), because the setting is only +used as a guideline. You can work around this by setting the Tooltypes +BUFFER_CHUNK_XXX to 29. On a Pentium II 350MHz with Adaptec UW SCSI +controller on board on-the-fly copying was possible from a Philips +CDD2600 (SCSI) to a Yamaha CRW4416E (IDE) at 4x. + + The UAE_CONTROL program ======================= @@ -554,6 +624,15 @@ with Kick 2.0 and upwards. Copy these tw use for harddisk emulation. They should be self-explanatory. +The timehack +============ + +Another tool in the "amiga" subdirectory, timehack, synchronizes the +emulated Amiga's system time with the host's time every second. This +is useful when the emulation is not done in real-time or is suspended +completely. + + Quick overview of the debugger commands ======================================= @@ -604,17 +683,14 @@ UAE. The new "official" UAE page is located at -http://www.freiburg.linux.de/~uae + http://www.freiburg.linux.de/~uae thanks to Stefan Reinauer who is now maintaining it. There, you will find links to other UAE pages. One which is especially useful is the "UAE Discussion Board" set up by Gustavo Goedert, the address is -http://www.netrunner.com.br/dosuae/uaeboard/index.html - -Not quite as good as a newsgroup due to braindamaged reader software -(Ratscope), but still a blessing. + http://amiga.nvg.org/uaeboard There is supposedly a newsgroup named "alt.emulators.amiga", but I don't get it here. @@ -627,7 +703,7 @@ Petter Schau has written another Amiga e written in x86 assembly and only runs under DOS. It's quite compatible and generally faster than UAE. The Fellow homepage is at -http://www.geocities.com/SiliconValley/Peaks/5244/ + http://www.geocities.com/SiliconValley/Peaks/5244/ Thanks & Acknowledgements @@ -657,6 +733,12 @@ Special thanks to: world... - Jens Schönfeld, inventor of the Catweasel controller, donated one controller card. + - Jürgen Beck, maintainer of the Amiga emulation web site "Back to the + Roots" (http://back2roots.emuunlim.com) and everyone else who spends + time writing to software companies asking for permission to distribute + old Amiga games. + - all the software companies who allow distribution of their Amiga games on + sites like "Back to the Roots". Authors/Maintainers @@ -719,6 +801,11 @@ pOS port: Available: Not quite sure yet. Sourcecode: Included in the main source. Should compile OK. +OS/2 port: + Pressenna Sockalingasamy + Available: ftp://hobbes.nmsu.edu/pub/os2/apps/emulator/uae2_0810_a1.zip + Sourcecode: working on including it + XFree86/OS2 port: Krister Bergman Available: http://www.kuai.se/~bellman/html/xfreeapps.html