E-UAE 0.8.29-WIP4 ================= This is a fork of UAE, the Ubiquitous Amiga Emulator, with an emulation core based on WinUAE. It attempts to bring many of the great features of WinUAE to non-Windows platforms. This version now finally has a name, E-UAE, since that's what everybody was calling it anyway. The 'E' can stand for anything you fancy. Experimental, extreme, exciting, egalitarian, eggplant, . . . Currently it will build and run (with a varying degree of supported features) on Linux and other Unices, Mac OS X, BeOS, AmigaOS itself (either for 68k machines or PPC machines with OS4.0) and the AmigaOS clones AROS and MorphOS. OS X requires either LibSDL or an X server for graphics output, but native graphics are supported on AmigaOS and BeOS, although, at the moment, SDL may be preferred on BeOS since the native driver lacks support for the P96 emulation. E-UAE is open-source software and is made available under the terms of the GPL. See the COPYING file included with the E-UAE archive for details. E-UAE is based on the work of dozens of contributors including Bernd Schmidt (the original author and maintainer of UAE), Bernie Meyer (the author of the x86 JIT compiler), Toni Wilen (the current maintainer of WinUAE), and many more. To make full use of E-UAE you will need access to an image of some version of the Amiga Kickstart ROM (although UAE does include a ROM emulation which may work with some old games). The Amiga Kickstart ROMs are copyrighted material and may not be freely distributed (so don't ask me for a copy). If you don't have an Amiga from which you can legally make a ROM image, a selection of ROM images are available for purchase online from Cloanto (publishers of the Amiga Forever distribution). See http://www.amigaforever.com/ What's new since 0.8.29-WIP3 ============================ * Emulation core from WinUAE 1.3.x merged. * Much more stable on SMP hosts. * Builds on Solaris x86 (with GCC). * Integrated mouse-hack feature merged from WinUAE (this synchronizes the Amiga mouse pointer with the host pointer when E-UAE is running in a window on your desktop) merged from WinUAE. The old AmigaOS mousehack tool is no longer required. * New easier-to-use Linux SCSI-back-end (Jochen Becher). * Experimental GL renderer in SDL display back-end (originally from Jochen Becher but mostly re-written). On most platforms this is yet to offer much over the existing 2D renderer, but on MacOS X it offers significantly better performance. Enabled with 'sdl.use_gl=true'. * Support for the uae-configuration tool. This is an AmigaOS shell command which allows UAE settings to be queried and modified from within the emulation environment. * Better, smoother performance when cpu_speed=real (A500 speed). E-UAE adapts to changing system latencies. * 'Sinc' audio interpolation (Antti Lankila). * Minor performance improvements in interpretive CPU emulator and JIT engine. * Lots of bugs fixes, including: - Broken 'delayed' interrupt handling when JIT was disabled. - Inconsistent refreshing of P96 screens. - Filesystems being mounted twice. - Hardfiles broken following a reset. - Broken detection of XKB path in X11 driver (fix from Peter Volkov). * Lots of code clean-up. * And more... Still to do =========== The following features of WinUAE are not yet supported: * Serial and parallel port emulation. * AHI soundcard emulation. * Catweasel support. * Graphics filters, scaling, etc. * Floppy drive sounds. * Everything else that I've forgotten about. In the pipeline for the full 0.8.29 release ------------------------------------------- * Load/save state dialogs for Gtk+, Cocoa and BeOS. * Rework handling of default floppy/rom/hardfile paths (again, ta to Mr Pimley for the prompt). * Add DGA 2.0 support to X11 driver (for fari, again. ;-). * Further build script improvements. * (maybe) Transition from CVS to SVN repostories. * (maybe) Replace libscg for SCSI emulation support on OS X and BeOS with native methods. Known problems ============== Some significant misfeatures that I know about and am/will be working to fix (eventually): * Only platforms supporting the GTK+ toolkit have a useable configuration GUI (and the GTK+ GUI is still incomplete). * JIT direct memory access only works on Linux/x86 and, by default, you may only emulate up to 32MB of direct ZIII RAM; select more than that and the JIT will fall back on indirect memory access and hence will be slower. This is due to a system limit on the size of a POSIX shared memory segment. You can overcome this limit my modifying the value of the procfs setting, /proc/sys/kernel/shmmax. * Virtual filesystem doesn't support platforms which use UTF-8 for filenames (e.g., OS X, Linux with a UTF-8 locale, etc.). Filenames with characters outside of the core ASCII range will be mangled. * OpenGL renderer is experimental, unfinished and has no error recovery. * Full documentation is lacking. Using E-UAE =========== Documentation is a work-in-progress. See the docs directory. Compiling E-UAE yourself ======================== See the docs/compiling.txt file for more information about building E-UAE. CVS === Details about how to access the CVS repository containing the current development version of E-UAE can be found at: http://sourceforge.net/cvs/?group_id=109723 Contact ======= See http://www.freelists.org/list/uae for details of a mailing list discussing problems with and development of E-UAE. Send bug reports, comments, patches, etc. to the above list or to: Richard Drummond