This page describes how to set up the E-UAE Amiga emulator on Ubuntu.Note: As of 05/16/2009, e-uae packages are available in the Ubuntu Universe repositories for Ubuntu 8.10, 9.04, 9.10 and later.
UAE is the UNIX Amiga emulator (Linux is UNIX-like) that allows you to emulate any Amiga system, from the A1000 (the first Amiga) to the A4000 (the latest official "classic" Amiga). The United Arab Emirates is now quite old and quite deserted. However, the UAE port of Windows, dubbed WinUAE, has evolved a lot. Richard Drummond (known for his contributions to the magazine on the Amiga format, now often writes articles for the Linux format) took many of these new features and put them into a cross-platform program called E-UAE (what E stands for is debatable). . UAE is packaged in Ubuntu, but E-UAE is not (yet), so this guide will show you how to install it. E-UAE is Free Software under the GNU GPL.
OBSERVATION:E-UAE emulates Amiga series computers based on Motorola 68000 series processors. However, it does not provide the operating system software or Kickstart ROM images as they are the property of Amiga Inc. The system software OS is not always necessary to run software on an Amiga, as many programs and games can be run by booting directly from the floppy drive, but a fast boot is always required. E-UAE includes a basic kickstart image that may work for some simple games, but a full official kickstart is preferable. To use any of them you need to have some equivalent ROM chips (in an Amiga or purchased separately) or you can legally obtain a Cloanto image.friends foreverSoftware. However, these images are encrypted and come with a decryption key for use with emulators.
I am receiving E-UAE
E-UAE has been available in the Ubuntu repositories since Ubuntu 9.04 (and 8.10 with backports). Just install it via Applications > Add/Remove, System > Administration > Synaptic Package Manager or the following command line:
sudo apt-get install e-uae
Creating E-UAE from source
The E-UAE source code can be found athttp://rcdrummond.net/uae. A direct link to the latest version at the time of writing this article isHere. Put this in a logical place in your home folder. This is the source code and we need to compile it.
First you need to install programs that allow you to create and install software. These can be installed with:
sudo apt-get install build-essential checkinstall
(FIXME: Are development packages needed, for example, SDL packages?)You may also need zlib packages:
sudo apt-get install zlibc zlib1g-dev
Now you need to extract the downloaded bzip2ed tar file. This can usually be done by right-clicking on the file and selecting Extract Here. If not, you can use the command:
tar xf e-uae*
Once extracted, you'll need to enter the newly created folder into a terminal. This is done with:
Where you replace that path with a suitable path for your system. For example, on my system I would write:
Since I put the folder in /home/chris/Files/System/Programs and named it E-UAE. Once we're in the correct directory, we can start configuring and building the source code. First you have to configure it. This is easy to do with the command:
If there are no errors, continue to the next step. (FIXME: What errors can occur? (missing packages?))
Once configured, it must be incorporated into an executable program. This is done with:
It may take a while and you should not get any errors if the setup step worked.
Once the program is created, you can run it from where it is used:
Installation of E-UAE
A better idea would be to install it in the correct places on the system. We create an Ubuntu package containing E-UAE with the command:
sudo checkinstall --install=sim
You must enter your user password. Don't provide any documentation for the package, just provide meaningful attributes. Here's an example:
This package is based on these values:0 - Mantenedor: [root@chris]1 - Summary: [The improved version of UAE, Amiga UNIX Emulator]2 - Name: [e-leg]3 - Version: [0.8.29-WIP2]4 - Launch: [ 1 ]5 - License: [GPL]6 - group: [checkinstall]7 - Arquitectura: [ i386 ]8 - Quellstandort: [E-VAE]9 - Alternative Quellspeicherort: [ ]10 - Requires: [ ]Enter a number to change it, or press Enter to continue:
After entering some logical values, press Enter and the package will be created and installed.
First you need to choose your Kickstart image, Kickstart is the data contained in the ROM chips built into classic Amiga computers. This data boots the computer, contains drivers for the hardware, a short animation of a floppy being inserted into a floppy drive (appearing when there is no floppy, CD/DVD, or hard drive), and some basic parts of the Amiga operating system. (including graphical boot menus). The E-UAE can emulate an Amiga 500 with a simple free software boot, but for full compatibility you need an official proprietary boot that you can buyKloantoas part of their Amiga Forever package.
If you already have an Amiga, you can run the Transrom program on your Amiga to copy the contents of your Kickstart ROM into an image that can be used in E-UAE. Transrom comes with E-UAE, but for me the source code doesn't compile. If you download one of the ready-to-use files fromSitio de Richard Drummondthen you will find the transrom tool in the "Amiga" folder. Later in this guide, you will learn how to transfer files between your Amiga and your Ubuntu computer. To use Transrom, simply put it on your Amiga, open a shell in Workbench and run:
This creates an image called kick.rom on the RAM disk. I find it takes around 15 minutes on my standard 14MHz Amiga 1200. Open the RAM drawer on the desktop to access this file. If you have access to a hard drive but have very little RAM (1MB or less), you can save this image elsewhere by replacing the above command with a different path, although this will slow down the process.
OBSERVATION:I managed to run the Transrom program on my Amigas, but for unknown reasons it didn't produce an image. If you find yourself in such a situation, you can find a starting point on the Internet, probably throughGoogle. Distributing such copyrighted software without a license is illegal, so I can't recommend this method or provide details about sites that might offer it, but it's generally acceptable to get an image this way, as long as you already have one. license for it. the data contained therein, that is; Only download a kickstart image if you already have that kickstart but can't transfer it. This type of activity is generally subject to the same laws that govern your ability to rip CDs to MP3 format, since both activities involve the transfer of licensed data from one medium to another. Don't try to get going this way if it's illegal to do this type of activity where you live.
Once you've decided on Kickstart, you'll need some sort of program to use for the emulator. E-UAE supports both floppy disks and hard drives, so you can boot from either. If you want to use a CDROM (either a physical disk or an "ISO" image), you must provide E-UAE with the disk's mount point as if it were a hard disk partition. For more detailed information on disk access in E-UAE, see the Helpful Information section.
You can start E-UAE with the command:
United Arab Emirates
Or, if you also have the UAE package installed:
If you have the older UAE type installed, there will be no conflicts. However, you can create an alias for E-UAE so that a single command can execute it. This works, for example, with:
sudo ln -s /usr/local/bin/uae /usr/local/bin/euae
This allows you to start UAE normally and start E-UAE with the following command:
Now you can decide if you want to add this command to the application menu. You can do this with the Alacarte menu editor (found in Applications > Accessories). Provide a useful name and comment, and enter the command you use to start E-UAE (usually just "uae", but may be different if you have regular UAE installed as well, see above). Choose a suitable image for the icon (it's easy toCreate a "Boing Ball" Amiga Logo in GIMP. You can also find a suitable image atGoogle)
E-UAE cargo. You may find the interface quite complex, but it is very powerful and easy to use if you stay away from what you don't understand and only deal with the disk image parts. If you want to emulate a specific system, I've created a table of the hardware on each Amiga system below.
There is a bug with Ubuntu Lucid in Ubuntu Meerkat (10.04 to 10.10) and e-uae in the netbook remix interface, the file menu is not showing, which means there is no way to save the settings. The easiest way around this is to exit and reselect gnome or kde as the session in the selection, which will restore the missing files menu. This was fixed in 11.04 Natty Narwhal Netbook Edition.
To get started right away, select the Storage tab and enter where your kickstart image is located. (You should also give him the decryption key for your kickstart if you got it from the Amiga Forever package.) The built-in kickstart replace is used when no file is specified as the kickstart image, but by default there is a "kick.rom" entry that can only be replaced, not removed. The solution is to press the "Save Settings" button and exit E-UAE. There should now be a hidden file called ".uaerc" in your startup folder (if this file does not exist, you should open E-UAE and set the kickstart image to something other than kick.rom and then select "Save Settings". and the file should be there). Now edit this file with a text editor and find a line like this:
Delete the "kick.rom" after the equal sign and save the file. Now when you start E-UAE, the kickstart config should be empty, which will use the override.
Unless you are using a hard drive with AmigaOS already installed, it will probably boot from a floppy disk. On an Amiga, the internal floppy drive is named "DF0:" and will boot by default even if you have a hard drive mounted. If you put a non-bootable disk image in DF0, the Amiga may boot from the disk or it may drop into a shell after the non-bootable disk. It is generally best to put non-boot disk images on external floppy drives ("DF1:", "DF2:", etc.) or wait for the workbench to load before inserting the image. Image files can be swapped at any time, just like you can swap a floppy disk, but you should try not to do this when the drive activity light is on.
To start the emulator after giving it the settings you want it to start, simply click the "Pause" button (which is already pressed, so don't pause the emulation). You can use this button to pause your emulation (for example, if you want to pause a game that cannot normally be paused).
Uso de E-EAU
With the "Reset" button you can reset the emulated Amiga. You can also reset the Amiga by pressing Ctrl-Super-Super (Both are super keys. Super keys are usually "Windows" keys on a PC and "Command" keys on a Mac. On an Amiga they are the "A" keys). In addition, F12-R will reboot the Amiga (a "warm" reboot, like Ctrl-A-A) and F12-Shift-R will perform a "cold" reboot (equivalent to turning the Amiga off and on again).
If you find that E-UAE has issues with the mouse pointer moving at the wrong speed or getting stuck when the Ubuntu pointer touches the edge of the screen, you can press F12-G to hold and release the mouse.
To toggle between full screen mode and windowed mode, you can press F12-S.
If you find E-UAE slow, try turning off the sound emulation (this can be done at any time in the E-UAE control window and does not require restarting the emulated Amiga). "100% accurate" sound emulation has a noticeable effect on performance. To change the emulator's frame rate (skipping frames is less laborious than rendering them all), you can use F12-+ and F12-- (+ and - on thenumeric keyboard).
Classic Amiga computers do not need to be shut down, you can simply exit E-UAE (closing the control window does not stop the emulation, but closing the emulation window closes the entire program, including the control window). F12-Q also ends E -VAE.
Additional documentation can be found in the "docs" folder in your downloaded E-UAE file.
Amiga system information
FIXME: Create a table of processors, graphics chips, RAM, and possibly bench versions.
OBSERVATION:There is no value in emulating a 68060 processor. There are two differences between the 68040 and 68060 chips. The 68060 can go much faster than the 68040 (I heard one is overclocked to 100 MHz, but that's too dangerous), but how do you goes? ?emulate the chip, it does not affect you. The emulation of a 68040 and a 68060 runs at the same speed. The second difference is that to achieve these higher speeds, the 68060 has lost part of the 68040's instruction set. This means that in a real 68060 system, some of the processor's instructions are emulated in software, which works just as well as The processor is capable of working much faster than its predecessors. However, this doesn't work very well on an emulator, since you'd be emulating an emulator, which would cause a huge loss of performance when you could run a 68040 just as well with the full instruction set at the same speed as a 68060. So, "full throttle" would actually be better with an 040 instead of the "full" 060.
Using Floppy Images
Amiga floppy drives are so different from PC floppy drives that PC drives cannot read disks formatted for an Amiga file system. The Amiga floppy drive driver can perfectly handle FAT-formatted disks when using the CrossDOS utility included in Workench 2.1 and later. This means you can't put an Amiga floppy in a PC and run it in E-UAE, but you can use a PC-formatted floppy in your Amiga. To access an Amiga floppy in E-UAE, you need to copy the contents of the floppy into a file (often referred to as an Amiga floppy file and often abbreviated as ADF, as the popularity of WinUAE has led to "extensions files" that work for Microsoft Windows). You can convert an Amiga floppy to an ADF file using the Transdisk utility (located in the same place as Transrom), though be aware that the disk image will contain ALL the data on the floppy. This means that the small amount of space on a formatted floppy disk (for the file system to work with) is too much and the ADF will not fit on a normal floppy disk. Since ADF is just a binary data stream, you can often get good enough compression ratios with Zip, LHA, LZX, or some other compression algorithm to fit on a FAT-formatted disk.
An alternative to creating an ADF and compressing it would be to use the Disk Masher system on your Amiga. This can compress a floppy disk into a file that can be transferred to your PC on a FAT-formatted disk. E-UAE can load DMS disk images into its virtual floppy drives in the same way as ADFs. FIXME: Describes how to use DMS.
There is a hardware alternative calledkatzenwieselwhich allows you to connect an Amiga floppy drive to your PC and access the disks that way. E-UAE currently does not support using such a drive directly, but in combination with a copy command like "dd" you could theoretically create an ADF by dumping the contents of the disk into a file (the definition of an ADF). I've never used either of these devices, so I'm not exactly sure how to handle it.
Using hard drives
There are two types of hard drives in E-UAE. You can give it a real Amiga hard drive or an image of it, or you can give it a folder that you treat as a hard drive partition. Disk Access is very useful in WinUAE because it allows you to connect an Amiga hard drive to your PC and access it through WinUAE. This is slightly less useful on Linux, since Linux can access Amiga-formatted hard drives like any other hard drive, so you're not forced to use E-UAE to copy files to and from that drive. However, using a disk image is actually faster than using a folder, so it's up to you which method you prefer. If you use a folder, you can easily access the files stored in it, and if you use an image, you must mount the partitions in it via the loopback device to access them.
A good bench setup
If you are new to the Amiga, you may find that some libraries are missing, etc. when trying to install the software. Since the Amiga Workbench does not have a package manager like Ubuntu, this is to be expected. One thing that struck me after running the same Amiga systems for over a decade is that libraries and other tools pile up in the workbench partition, and once they reach critical mass, you realize that pretty much everything it works out of the box, in contrast to a similar situation in Microsoft Windows, where the accumulation of orphaned system files leads some users to format the entire drive just to remove these files as they clog the system. For those just starting out with an Amiga system on an emulator, I've created this section to help you create a manageable system.
Since you are not limited by hardware as you have an emulator, I would STRONGLY recommend getting the latest officially released version of AmigaOS for the classic architecture, OS3.9. You can buy this at many online stores and maybe even on eBay. Cloanto sells CDs or ISO images to download fromfriends forever, which comes with all versions of AmigaOS and all Kickstart ROMs. Just like with a Linux system, you'll find that you'll have a much better experience if you partition your drive well. Whether you use a real drive or an image, it is very difficult to resize partitions formatted for an Amiga file system, so you need to do it correctly. If you use one folder for each partition, the size of the drive will always match the size of the Linux partition it's stored on, so you don't have to worry about size. When using folders, E-UAE does all the "partitioning" when you tell it which folders to use. If you are using an image or disk, starting E-UAE from a Workbench disk and inserting the 'Install' disk will bring up the HDToolBox program which will allow you to format your disk/image. (If you want to use OS3.9, you must first configure your drive and install Workbench 3.1, since classic Amigas cannot boot from a CD-ROM drive without the appropriate drivers stored on a hard drive.)
First, you will DEFINITELY have a better experience if you keep your workbench (the core part of the operating system) separate from the rest of your files and programs. If you want to use an image or a real disk, you might want to know that my old Amiga 1200 worked with a 40MB partition for Workbench (version 3.0) for over 10 years with no problem, even with tons of libraries built up. Data storage has become very cheap these days, and since most PC systems come with large 3.5" hard drives, you are not limited by the higher price of 2.5" drives. , which fit comfortably in many Amiga "keyboard" cases, so you probably have thousands of MB available. In that case you would use 100MB or even more for the workbench. Anything over 500MB is ridiculously wasteful in my opinion. It would make sense to make "DH0:" (the first partition on the disk) the workbench partition and give it a volume name like "workbench".
Next, you want a partition to put your programs on. Many programs on the Amiga don't even need to be installed, just run them from anywhere. Create a partition or folder for your programs and assign it to DH1:. I have found two partitioning systems that work well. One is "Workbench", "Applications", "Games", where data is stored individually in each application's folder (for example, Personal Paint puts images in "Applications").:Personal Paintings/Pictures"). If you're using a more Linux-like storage system and want to keep your files separate, a "Workbench" "Programs" "Files" system also works well, with "Programs" drawers labeled " Serious" and "Games". (Please note (these are just suggestions, but I think they work fine). Your third partition should be the "DH2:" drive. If you're looking for sizes, I'd fill in the remaining space and make "Applications" the same size as "Games", since you'll probably have a lot of games, but apps also store their files (like music, pictures, and animations you create) in "Applications", making them about the same size for the other approach , I would fill the drive again and put "Files" about twice the size of "Programs" I usually use a 1.5GB Amiga hard drive which has "Workbench" as 100MB, "Programs" as 400MB and "Files" as 1 GB Even with many games os, animations, images and music installed and backups of all content, it is often only 10% full.
Once you've set up your partitions, all you need to do is run the installer for your language, located on the "Install" disk in the Workbench disk set. After installing Workbench from a floppy disk, you can insert the AmigaOS 3.9 CD and assign the E-UAE to its mount point as if it were a folder used as a disk partition. You should make the device name "CD0:" and give it a volume name of "AmigaOS3.9". With OS3.9 installed, you may want to install some common libraries and tools of which I have compiled a list.
Useful extensions to install
picasso96- Picasso96 is a retargetable graphics system (RTG). Picasso96 has an E-UAE display driver called "uaegfx" and it allows you to use VGA resolutions (like 1280x1024, 1024x768, 800x600, etc.) and full "32-bit colors" (24-bit with alpha) as if the emulator Amiga had an additional built-in graphics card. please consulthttp://winuaehelp.vware.at/emulation/picasso.htmto get configuration information (Important because if your E-UAE configuration is wrong, the modes will not be displayed).
magic menu- A more convenient right-click menu system for the workbench.
MUI- The "Magic User Interface" is a shareware graphical toolkit (similar to GTK and QT on Ubuntu) used by many Amiga programs.
FIXME: Add some more basic libraries, data types, and maybe tools.
Unlike Linux, there are multiple volumes in AmigaOS. This means that floppy drives, hard drive partitions, and all other devices are kept separate. A colon after a location indicates that it is a volume. However, AmigaOS has a different use for volumes. A "map" is used to convert a drawer (Workbench term for directories) into a volume. For example:
Assign OctaMED: Applications: Serious/Music/OctaMED
(FIXME: Is this the correct syntax?)
Create a new volume named "OctaMED". Going into this volume is, in fact, the same as going into the app drawer.:Serious/Music/OctaMED (similar to symbolic links). A unique feature of Atribui is that multiple drawers can be assigned to a single volume. For example, the SOURCES assignment:can point to SYS:Fuentes (SYS:itself is a mapping pointing to the install location of the workbench), Files:Graphics/Fonts, Applications:Serious/Graphics/DeluxePaint/Fonts and more. The contents of all these drawers can be accessed in SOURCES:and save new files in FONTS:stores them in the first allocation, in this case they are stored in SYS:fuentes.
On your new Amiga system, you will find that there are many volumes that do not appear on the workbench screen, such as C:, developer:, S:etc These are all assignments and point to their respective locations in the workbench partition.
Data transfer between Ubuntu and Real Amigas
CrossDOS is software that comes with Workbench 2.1 and later. When copying device "PC0" from "SYS:Device Drivers/Storage" under "SYS:Devs/Device Drivers” and reboot, you have given your DF0 drive the ability to read FAT-formatted floppy disks compatible with PC floppy drives. When formatting a disk as FAT (Note that many Amigas in particular can only access DDs, that is, double-sided, double-density disks, which have a raw size of 880KB and a formatted size of normally 720KB. HD- Floppy disks (high density, 1.44 MB) these Amigas can still be accessed, but they must be formatted as DD disks) You can store files on floppy disks and transfer them between your PC and Amiga. Note that files stored on these disks have their file names shortened from CrossDOS to MSDOS "8.3" for compatibility with Microsoft Windows and MSDOS. (eight capital letters or other characters followed by a period, then three capital letters or other characters at the end) This is often the easiest way to transfer small files between computers.
replace hard drive
If you have a desktop PC and don't mind opening it up, you can transfer a 3.5-inch hard drive between your Amiga and your Ubuntu machine if you want to exchange large amounts of files. To use a 3.5" drive in an Amiga, you either need an Amiga "big box" (usually one of the "thousand" series, A1000, A2000, A4000, etc.) that supports these drives directly or you'll have to use a 3.5" drive. Special IDE cables and power cords for the internal floppy drive to work in an Amiga "keyboard box" Set up the drive on your Amiga machine andarmsIt's like mounting any other disk in Ubuntu, with partition type "affs" (Amiga Fast File System [which is not so fast anymore]). You can save data to Amiga partitions with Ubuntu, but I wouldn't recommend doing this often, as it could damage your Amiga partition.
FIXME: Expand this. Ethernet, serial, possibly parallel.
Repair all FIXME
Fix incorrect wiki handling of Amiga paths (those containing colons)
E-VAE-Home page- Richard Drummond website, the maintainer of E-UAE
friend inc.- The current Amiga company. Community sites may provide better information.
Amineto- A large archive of Amiga software and documents (mainly in LHA format)
Welt friend- A very active community site for Amiga users (including emulators)
Previous 2 The roots- A very useful site with great resources for Amiga emulation