--- uae/docs/README 2018/04/24 16:44:33 1.1.1.7 +++ uae/docs/README 2018/04/24 16:48:26 1.1.1.10 @@ -1,4 +1,4 @@ -This is version 0.8.7 of UAE, the Un*x Amiga Emulator. +This is version 0.8.10 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 ======== @@ -235,6 +238,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 +301,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 +557,45 @@ 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. Many implementations of this +interface exist, although only the Linux implementation has been +incorporated into UAE at the moment. 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 +607,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 =======================================