Skip to content
Optimized Amiga emulator for the Raspberry Pi and other ARM boards
C++ C Assembly Objective-C Makefile CMake
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create CONTRIBUTING.md Dec 7, 2018
.idea Simplified type definitions, reversed cfgfile changes Jan 7, 2019
.vs Merge from dev to master Feb 4, 2018
AndroidData Android platform updates Feb 24, 2018
VSLinux Updated VS project files with new preprocessor definition Jan 14, 2019
VisualGDB Updated VisualGDB toolkit version Sep 11, 2019
capsimg @ 067db4c Added submodule "capsimg" for IPF support Feb 9, 2018
conf Add empty directory for configuration, save state ... May 23, 2015
data Merge from dev to master Feb 4, 2018
docs
guisan-dev Replaced GL with SDL_OpenGL header reference in .cpp file also Aug 19, 2019
kickstarts Add empty directory for configuration, save state ... May 23, 2015
psp2data Added initial support for PSVita/PSTV and Switch (WIP) Jan 6, 2019
savestates Add empty directory for configuration, save state ... May 23, 2015
screenshots Add empty directory for configuration, save state ... May 23, 2015
src Merge remote-tracking branch 'origin/dev' Aug 18, 2019
switchdata Added initial support for PSVita/PSTV and Switch (WIP) Jan 6, 2019
whdboot WHDLoad binary (#434) Feb 20, 2019
.gitattributes Merge from dev to master Feb 4, 2018
.gitignore WHDLoad and AutoBooter Update (#430) Feb 13, 2019
.gitmodules Added submodule "capsimg" for IPF support Feb 9, 2018
CMakeLists.txt Added initial support for PSVita/PSTV and Switch (WIP) Jan 6, 2019
COPYING WIP - merge latest sdl1-dev changes into sdl2-dev (warning, not fully… Nov 28, 2017
Makefile add platform sun8i (#510) Sep 10, 2019
PULL_REQUEST_TEMPLATE Create PULL_REQUEST_TEMPLATE Jan 3, 2018
_config.yml Set theme jekyll-theme-slate Dec 7, 2018

README.md

Amiga emulator for the Raspberry Pi and other ARM SoC

Amiberry is an optimized Amiga emulator, for ARM-based boards (like the Raspberry Pi, ASUS Tinkerboard, Odroid XU4, etc). The core emulation comes from WinUAE, but stripped down to remove excess stuff in order to achieve good performance in underpowered boards. It includes JIT CPU and FPU support, to get high-performance results on CPU-intensive emulated environments. On top of that, we have some unique features developed only for Amiberry, such as the WHDLoad booter.

Amiberry requires the SDL framework (https://libsdl.org) for graphics display, input handling and audio out. Currently both SDL1.x and SDL2 are supported, but in the future we'll probably drop support for SDL1 as things move forward. On the RPI platform specifically, we offer a special version which uses Dispmanx directly for the emulation screen, for maximum performance.

Getting SDL2

If you want to run the SDL2 version from the console (i.e. not from the full Desktop), you currently need to compile SDL2 from source on the Raspberry Pi (and possibly other platforms as well). The version bundled with Raspbian is not compiled with support for the "KMSDRM" driver, so it only works under X11.

Follow these steps to download, compile and install SDL2 from source:

https://github.com/midwan/amiberry/wiki/Compile-SDL2-from-source

If you are running Amiberry under the full Desktop instead, you can install the packages directly from the Raspbian repository instead:

  sudo apt install libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev

With SDL2 installed, you can proceed to install Amiberry as follows:

Pre-requisites

Amiberry requires the following packages, besides SDL (v1 or v2) itself:

  sudo apt-get install libxml2-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev

Getting Amiberry

You can clone this repo, like so:

  cd ~
  git clone https://github.com/midwan/amiberry
  cd amiberry

Choosing a target

Amiberry's makefile includes several targets, to cover various platforms. For the Raspberry Pi platform specifically, we offer multiple combinations to get the best performance out of the platform, depending on the environment used:

  • SDL1 with DispmanX back-end for graphics
  • SDL2 with DispmanX back-end for graphics
  • SDL2 with whatever back-end it was configured with (e.g. KMS, OpenGL, X11, etc.)

For the Raspberry Pi specifically, the best performance can be gained by using the DispmanX back-end, because none of the other options offer multi-threaded graphics updates, unfortunately. For other platforms (e.g. using the Mali GPU), multi-threaded updates can be supported using pure SDL2 (and DispmanX is an RPI-only feature anyway).

Compiling a target

You can specify the Platform you want to build as a parameter to the make command. If you do not specify one, the default used will be rpi3-sdl2-dispmanx.

Using SDL1 + DispmanX

For the Raspberry Pi 3(B+) (SDL1 + Dispmanx), type:

  make -j2 PLATFORM=rpi3

For the Raspberry Pi 2 (SDL1 + Dispmanx), type:

  make -j2 PLATFORM=rpi2

For the Raspberry Pi 1/Zero (SDL1 + Dispmanx), type:

  make PLATFORM=rpi1

Using SDL2 + DispmanX

For the Raspberry Pi 4 (SDL2)

  make -j2 PLATFORM=rpi4-sdl2-dispmanx

For the Raspberry Pi 3(B+) (SDL2)

  make -j2 PLATFORM=rpi3-sdl2-dispmanx

For the Raspberry Pi 2 (SDL2):

  make -j2 PLATFORM=rpi2-sdl2-dispmanx

For the Raspberry Pi 1/Zero (SDL2):

  make PLATFORM=rpi1-sdl2-dispmanx

Using SDL2 + whatever back-end it was configured with

For the Raspberry Pi 4 (SDL2)

  make -j2 PLATFORM=rpi4-sdl2

For the Raspberry Pi 3(B+) (SDL2)

  make -j2 PLATFORM=rpi3-sdl2

For the Raspberry Pi 2 (SDL2):

  make -j2 PLATFORM=rpi2-sdl2

For the Raspberry Pi 1/Zero (SDL2):

  make PLATFORM=rpi1-sdl2

For the Odroid XU4 (SDL2):

  make -j6 PLATFORM=xu4

For the ASUS Tinker board (SDL2):

  make -j6 PLATFORM=tinker

For the Odroid C1 (SDL2):

  make -j4 PLATFORM=c1

For the Vero 4k (SDL2):

  make -j4 PLATFORM=vero4k

For the OrangePi PC (SDL2):

  make -j2 PLATFORM=orangepi-pc

You can check the Makefile for a full list of supported platforms!

For more documentation subjects, please check the Wiki page

You can’t perform that action at this time.