installation instructions.AmiKit_for_Linux.pdf

AmiKit for the Linux Platform Guide v2.1

How to use AmiKit and E-UAE (or UAE).

Written by Tom Newsom.

Additional comments by AmigaPhil.

This document makes no assumptions as to your skills at using E-UAE. Whether you are a first time

user looking for a helping hand at using E-UAE and AmiKit or an old hand at using E-UAE and need

a bit of advice in getting AmiKit to work with it then we hope you find some help for everyone here.

There are subtle differences between UAE and E-UAE that we will discuss at the end of this

document. Everywhere else you can safely swap E-UAE as we go along.

NOTE

Since AmiKit 1.5.0 the installation is automated.

You can still follow the instructions here if you encounter any problems with the installation script.

http://amikit.amiga.sk/

So, let us begin. First you must have E-UAE installed and at least loading up the setup GUI. You can

download either a precompiled binary or the sources from http://www.rcdrummond.net/uae/index.html .

Which ever it is you use we assume from here on that it loads up to the setup GUI.

Now would be a good time to download the Linux port of AmiKit from http://amikit.amiga.sk/ . Make

sure you are in the directory you want AmiKit to reside. You will need this path later when we add it to

the setup GUI. I keep all my emulated Amiga stuff in one directory in my home directory which

I named (imaginatively) Amiga-Emulation. Inside there I keep all hardfiles, eg. Beneath.hdf, ROMs and

anything else Amiga emulation related. I will admit I keep my directory structures all neat and tidy and

that that is not everyone's cup of tea, so there is no hard and fast rules on this, but there are plus

points to this sort of layout which I am not going to go into in this document. You will just have to trust

me. Just to make clear the paths used as examples are taken from my own setup you do not have to

follow them, but if there happens to be a problem and you need extra help sorting it and you post

to the AmiKit forums, it would make helping you a lot easier and therefore quicker if you did.

NOTE: Since AmiKit 1.5.0 the package is distributed as a self-executable archive with the automatic

install script launched upon its extraction, to install the package manually using the instructions below

either unpack the self-executable archive using the --noexec --keep switches (which simply unpacks it

and doesn’t launch the installation script), locate the AmKit-linux-latest.zip archive and follow the

instructions below.

Example how to unpack the executable archive: sh AmiKit-Linux-Installer-1.0.0a.run --noexec --keep

That said. Make a directory called AmiKit, cd to that directory and use unzip to extract those sources

into the directory you just cd'ed into. (Note that in order to make the overall file size smaller the actual

AmiKit.zip archive is located inside another zip archive which should be unpacked first.)

mkdir -p ~/Amiga-Emulation/AmiKit

cd ~/Amiga-Emulation/AmiKit

unzip /path/to/the/amikit/AmiKit.zip

Now you should have the files that make up AmiKit in (if you followed my advice) ~/Amiga-

Emulation/AmiKit/ . These are Amiga binaries and will not run by themselves without some sort

of Amiga emulator running them for you.

There are two distinct .uaerc files (E-UAE configuration files). One for x86 (32bit CPU) and one for

x86_64 (64bit CPU). The x86 one is called .uaerc-x86 and the x86_64 one is called .uaerc-x86_64 .

Depending on your CPU type depends which one you install. If you are unsure on your CPU type then

you can run the command ' uname -m ' (sans quotes) which will show you.

Now, once you know your CPU type you can then either copy one of the configuration files to your

home folder (e.g. /home/<your username>/.uaerc ) where E-UAE will find it automatically (just don’t

forget to rename it to .uaerc ). If, like me, you like to have several E-UAE configurations for different

purposes then you can copy one of the files anywhere you keep your configurations. If you do this

then you will need to run E-UAE with the -f switch. For example:

./uae -f /path/to/your/configurations/uaerc-x86 or ./uae -f /path/to/your/configurations/uaerc-x86_64

NOTE: Using the preconfigured .uaerc-x86 (or .uaerc-x86_64) might not work on all systems

(and results to very slow emulation, jerky mouse). If this is the case better start E-UAE without any

.uaerc (if you already have one in your home directory ( ~/.uaerc ), delete or rename it); E-UAE will

create one anyway with the appropriate default values.

Now if E-UAE is not already running, run it now. You should be looking at the setup GUI in which

E-UAE always starts. This behavior can be changed but for now we need the GUI so we can set it up

for use with AmiKit.

- 2 -

AmiKit itself requires an AmigaOS higher then 3.1. For example, AmigaOS 3.5, AmigaOS 3.5 and so

on. In this document we will be using Amiga Forever http://amikit.amiga.sk/amigaforever.htm which

contains the needed commercial files. If you have AmigaOS3.9 or 3.5 then you will not need Amiga

Forever, so, in place of copying the Amiga Forever CD to hard drive copy which ever version you

have and replace the names (AmigaOS3.9 or AmigaOS3.5) according in the relevant places

throughout this document.

So, we have AmiKit installed and we have our installation media. But, as E-UAE is not yet configured

to use the hosts CD/DVD media we have to work around that. We do that by mounting the Amiga

Forever CD and then copying the CD contents to hard drive.

Again I make a directory in ~/Amiga-Emulation called AmigaForever then I copy the entire CD to that

directory.

mkdir -p ~/Amiga-Emulation/AmigaForever

cp -Rav /mnt/cdrom/* ~/Amiga-Emulation/AmigaForever/

NOTE: This step of copying the whole AmigaForever (or AmigaOS3.5 or AmigaOS3.9) onto HD is

useless IF you have the scsi= and scsi_device= option configured for the host CD drive (see below

in this document). Later, when first run, AmiKit will ask you to insert the OS installation CD in the drive.

NOTE: to make WHDLoad work (the Amiga Game Loader installed in AmiKit) please copy

the ROM3.1 file (in Amiga Forever package it’s named ”amiga-os-310.rom”) to AmiKit/Devs/Kickstarts

folder and name it “kick40068.A4000”. Also copy ROM1.3 file (”amiga-os-130.rom”) to the same

location and name it ”kick34005.A500”. Don’t forget to copy the “rom.key” file there too.

Now we have AmiKit installed and Amiga Forever installed. Now it is time to add those two directories

to E-UAE. If you haven't already fire up E-UAE, start it now. When E-UAE starts up it presents

the setup GUI which looks like the image below.

- 3 -

- 4 -

Looking at the setup GUI, along the tabs across the top you will see ' hard disks '. Click on ' Hard disks '.

Click on the ' Add ' button and you will be presented with the image below.

We first setup AmiKit by clicking on the 'select' button and selecting where you placed the AmiKit files

earlier. Set 'Device name' as DH0 and 'Volume name' as AmiKit. Second setup Amiga Forever

by clicking on ' Add ' then ' Browse ', selecting where you put the Amiga Forever files. Set ' Device name '

as DH1 and ' Volume name ' as AmigaForever .

NOTE: The second setup (AmigaForever) is not needed if the host CD drive is accessible from

the emulation (see my previous comment, and the manual edition of the .uaerc file explained below).

Once that is done we need to tweak a few setting which are visible in the setup GUI, others we need

to edit the ~/.uaerc file directly.

- 5 -

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: