Raspberry Pi Workshop

These instructions document the configuration of a Raspberry Pi Model B (v3) as a dedicated Amiga Emulation station.  The distribution used is Raspbian Jessie (based on Debian).  However, the same instructions should work on other versions of both the Pi and OS with little to no modifications.

Firstly, install RaraspberryPi3spbian.  For dedicated emulation use I suggest Raspbian Lite;  this omits X (desktop) components so will ensure all CPU cycles are available to the emulator.  The full desktop distribution can be used but will require additional configuration not covered here.

A DHCP address should be allocated when a network cable is connected.  The command ‘ifconfig eth0’ should return a valid IP address.  If using wifi, ‘ifconfig wlan0’ should do similar although I won’t cover setup of wifi here (see documentation available here).

From this point onwards I assume the Pi is installed and connected to the internet.

Firstly, we need to expand the disk partition and file system to use all available space on the SD card.  From the command line type ‘sudo raspi-config’ and hit enter.  From the menu, select ‘Expand System’, then ‘Finish’.  When asked, select ‘reboot’.

Once rebooted, we want to update the list of available packages and install any updates.

sudo aptitude update
sudo aptitude upgrade

If these commands fail you may not have aptitude available, install aptitude by ‘sudo apt-get install aptitude’ then retry the above.

We also need two additional packages, installed by:-

sudo aptitude install libguichan-sdl-0.8.1-1 libguichan-0.8.1-1

Select ‘y’ and install.

Next we download the UAE4ALL package:-

wget http://fdarcel.free.fr/uae4all2-rpi-chips-0_5.bz2

Once downloaded, we need to unpack the archive:-

tar -xvjf uae4all2-rpi-chips-0_5.bz2

Now, the directory uae4all2-rpi will contain two binaries (uae4all-rpi1 and uae4all-rpi2) for the Raspberry Pi 1 and 2 respectively.  You could just do the following to start/test the emulator:-UAE4ALLPI

cd uae4all2-rpi
./uae4all-rpi2

However, we want to start the emulator automatically, on boot.  Type the following, being very careful with the syntax:-

cat > .bash_profile
clear; echo “Booting Amiga…”; sleep 3; cd uae4all2-rpil ./uae4all-rpi2

Then hit CTRL-C and you should be returned to the prompt.  The command above creates a file .bash_profile which is read on login.  We print “Booting Amiga…” then wait for a few seconds as this give you the opportunity to quit (just hit CTRL-C if needed).

kickstart13If you’ve not made any mistakes, you should now be able to logout (type ‘logout’ or simply hit CTRL-D) and you should be automatically logged back in and UAE4ALL should start.  From here you can customise to your liking!

At any point during emulation, the F11 key should show the emulator options.

User Input