AmiKIT XE Installation on FS-UAE
Written and created by Espen Skog
Thank you to Ján Zahurančik for making AmiKit and the donation of
the full AmiKit XE allowing me to make this guide
LIMITATIONS AND DISCLAIMER: This author of this guide does not take any responsibility for whatever data or setup you might lose. You should always back up things before trying any of the steps in this tutorial. This guide is unofficial and based on current versions of FS-UAE and AmiKitXE, thus changes in either solutions may render this guide outdated. The launching of native OSX apps thru Rabbithole is not supported but work is currently being done to achieve this for full Rabbithole functionality under FS-UAE. Again – if you are following this guide, make sure you back up your current AmiKit setup in case you want to roll back to the default AmiKit setup with Wine and WinUAE. Do not email the author of AmiKit if you have any problems or questions in regards to this guide.
Purchase AmiKit XE from the official page http://www.amikit.amiga.sk. Download and Install AmiKit XE on your Mac according to the installation procedure. This means opening the DMG package and dragging AmiKit over to your Applications folder, starting it and following the on screen prompts until the whole setup process is done. Refer to the manual if needed.
PS! You will of course need e.g. OS39 ISO file + kickstarts to properly install AmiKit.
When AmiKit installation is done and you are finished setting up the screenmodes and so on, boot up your AmiKit and make sure it all works fine. Upgrade to Workbench 3.1.4 and run all the Live Updates if you like. When you are done and happy with this, you must ask yourself the following question:
“Am I satisfied and happy – or do I want to proceed to migrate things over to FS-UAE ?”
If the answer is that you feel fine with using wine+winuae like it is, you can stop reading here and enjoy your newly installed AmiKit on your Mac.
But if the answer is that you really want to use FS-UAE as your emulator instead of WinUAE on your mac, then you should read on.
Background for this tutorial…
So – many are probably like me. They use a Mac because they don’t find themselves happy with Windows operating system. If you are like me – then you probably don’t like the thought of having Wine and WInUAE running on your Mac (and messing up your perfectly Microsoft Free operating system with DLL files and Wine stuff J )
But, since AmiKit comes with WinUAE (and Wine to run it) you need to find a way to host AmiKit under another emulator – like FS-UAE instead (which in my opinion is a super great Amiga emulator for Mac).
This tutorial will help you get your AmiKit over from the WinUAE emulator to the FS-UAE emulator. This might sound easy! Just take that hardfile and boot it up in FS-UAE instead, right ? Wrong! J The hardfile which AmiKit runs on is in a format which FS-UAE does not boot up straight out of the box. If you try – FS-UAE will just guru at boot. The reason is, if I recall correctly, because the hardfile image on AmiKit uses the Dynamic HDF format.
So the next part of this tutorial will show you how you get your newly set up AmiKit hardfile to run on FS-UAE.
I have prepared a 2GB Hardfile for you which is pre-formatted and setup with Professional File System 3.5 so that this shitjob is done in advance and you don’t have to do it. The hardfile is empty (I cannot provide neither the OS or AmiKit itself as they are not free) so what we are going to do now is to mount the new 2GB hardfile in parallel with your AmiKit hardfile and copy all fies from one drive to the other.
STEP 1: Download the empty fs-uae compatible hardfile
- First – you must download the empty 2GB hardfile from: here
NOTE: The ZIP file is very small, but once unzipped it is 2GB.
STEP 2: Configure WinUAE under AmiKit to mount the new hardfile
- Open AmiKit from your Applications folder and click “Configure”.
- Now click on the HARDWARE->CD&HARDDRIVES meny on the left most side.
- Choose the newly downloaded hardfile (unzip it first) and click OK
- Then click “Start” on the lower button row to start the emulation.
When it boots up, it should look like this:
- Open up a shell by clicking the icon to the right of the magnifying glass on the icon row at the bottom of the screen. It should look like this:
- Type the following command and hit enter:
This process will copy ALL files from the native AmiKit hardfile over to our new FS-UAE compatible hardfile (called AK00: for now). Don’t worry – we will change AK00: to AK0: at a later point 🙂
(NOTE: This copy process might take from 15-30 minutes depending on your system)
- Now, open HDToolBox from the menu as shown below:
The output from HDToolBox should show you the same output as in the image below:
- Click on the 2GB drive and the click the “Partition Drive” button.
- Change the Partition Name from AK00 to AK0 (beware: these are zero’s and not O’s)
Change it from:
- Hit enter and the Click the “Save” button. This will bring you back to the main screen.
- Exit HDToolBox.
Now we need to rename the new harddrive to its proper name before we reboot.
- Right click “AmiKit00” and select “Rename” (Beware: Make sure you right click on AmiKit00 and not AmiKit)
- Enter the new name “AmiKit” and hit OK.
- EXIT your AmiKIT/WinUAE Emulation window. You are almost finished!
STEP 3: Setting up in FS-UAE
Now that we have successfully set up the new hardfile and copied ALL the files from the native AmiKit hardfiles over to our new FS-UAE hardfile, we can start up FS-UAE and begin configuring it.
Before that – you should have downloaded and installed the latest FS-UAE for your Mac (actually, it should work for Linux as well). Please follow the instructions on the screenshots below to set up FS-UAE Launcher with the proper settings for AmiKit to boot smoothly.
- Create a new Configuration (in this case it is called TEST KIT).
- Choose A4000 and 3.1 ROM
- Set Amiga Joystick = NO HOST DEVICE
Choose the PFS-AmiKitXE_2GB.hdf file as your first disk by clicking the grey document-icon (right to the yellow icon) to pop a requester so you can choose your hardfile.
Then (VERY important not to for get this) create a directory called “Rabbithole” and “Dropbox” on a place on your system disk. For instance on your desktop. Then Create the 3rd and the 4th entry according to the picture below. Keep in mind to click the “Yellow Folder” icon to create these two directory links. You could probably also point to your real Dropbox folder if you have one.
- Set ChipMem to 8MB
- Set Zorro III Fastmem to 128MB (or more if you like)
- Set Graphic Card RAM to 128MB
- Set Amiga Joystick to No Host Device
(in my experience, if if do not do this, they keyboard arrows do not work as they are interpreted as joystick movements which is very annoying under CLI if you wanna use keys to move the cursor)
- Set Graphics Card = UAEGFX Zorro III
- Set UAE bdssocket.library = Enabled
- Set CPU = 68040-NOMMU
- Set JIT = Enabled
- Turn off floppy sounds if you hate them 🙂
Click the SAVE BUTTON (the red arrow right to the “TEST KIT” name to save your new config.
STEP 4: Booting up FS-UAE and tuning the screenmode…
Everything is now ready and you are good to go. If you have done everything according to this guide, you should be able to hit “START” in FS-UAE.
Here is what to expect from the first boot:
- It will show 5-20 seconds of black screen (don’t worry – just wait)
- Then you should see (only the first time you boot) a progress bar which load up to 100% on the top of the screen and then nothing seems to happen for a while
- Just wait 2-3 minutes and all the sudden the workbench shows up in a dull 8 colorgray/blue color like on the picture below (THIS IS NORMAL!)
Hit Right Amiga+E (or right CME+E) to open a file request and enter Screenmode and hit OK. Or you can navigate to the the screenmode icon under Prefs I you like. Never the less, just open “Screenmode” somehow 🙂
- Now scroll down to 1600x1080x32bit.
- Select it and click SAVE
You will be prompted with 2-3 requesters like the one below and just click SAVE and RETRY afew times until they go away.
After 2-3 requester clicks, you should see a beautiful blue desktop like this:
(we are very close now)
It is time to reboot to getall things in order (as you might see – the task bare is missing).
- Reboot by pressing Left CMD+R (or restart the emulation in your preferred way)
After reboot the emulation should boot up perfectly into this nice full AmiKit XE Workbench Screen as seen in the picture below (look – the taskbar is back!)
STEP 5: Final words…
So – you successfully migrated AmiKit from the WinUAE hardfile over to a hardfile for FSUAE. You can now run Morpheus and do a Live Update and use your AmiKit XE. We are finished!
GOOD JOB – you did well.
You can now use AmiKit XE normally and run Live updates and so on. Enjoy! 🙂
UPDATE #01 – AUGUST 2019 – Speed Control:
There is a need to point out that there is no quick way, like on WinUAE, to set the cpu_throttle. This means that when you set up FS-UAE in 040-NOMMU mode, it will suck your host-cpu dry and your cpu fan will most likely run like crazy (mine does!).
So — to fix that, I have set a manual config value for FS-UAE which speeds down things a little. Enough to keep my CPU fan silent when idling in FS-UAE. My goal was to find a cpu_throttle value which worked for my hardware in terms of spinning fast enough to keep emulation to a nice level, without the CPU fan going crazy 🙂
Beware that the “perfect” value for cpu_throttle varies from system to system. My host system is a I7 with 8MB Ram and running on 3GHz. So I found out which cpu_throttle which worked best or my setup. Your setup might require a different value to operate as you wish. It’s just a process of trying out different values in increments of 100’s until you feel ok with speed vs. noise ratio.
In the illustration above, you can see that I have added a CPU Throttle of -400. This works perfect for me and the HW on my host laptop. The fan runs silent and the emulation is good for my workbench use.
The CPU_Throttle values range from -900 to 5000.
- uae_cpu_throttle = -900 <– Lowest speed
- uae_cpu_throttle = -400 <– Quite low speed — but works good on my setup
- uae_cpu_throttle = 5000 <– Max speed.
So to sum things up. Work your way up from -900 up to a value which works for your hardware setup. If you want the max speed, just set it to 5000 or you can also skip the option as default is 5000 (max) and maybe you don’t care about fan noise 🙂 If you are on a laptop, you might care more about the speed and heat than if you run on a desktop machine.
If you want to really tone things down, and mostly work in Workbench, you can add even more parameters:
uae_cpu_throttle = -400
video_format = rgb565
video_sync = off
So, enjoy this little update and I hope it helps if you are a little annoyed about your laptop fan noise.