MikeDX/fab-agon-emulator

Agon Light, Agon Light 2, Agon Console8 Emulator for Linux, Windows, any system with libSDL

Fab Agon Emulator

An emulator for the Agon Light, Agon Light 2, and Agon Console8 8-bit computers.

Keyboard Shortcuts

Emulator shortcuts are accessed with the right alt key (AltGr on some keyboards).

• RightAlt-C - Toggle caps-lock
• RightAlt-F - Toggle fullscreen mode
• RightAlt-M - Print ESP32 memory stats to the console
• RightAlt-R - Soft-reset
• RightAlt-Q - Quit

Compiling the Fab Agon Emulator (on Linux)

To make an optimised release build, run:

git submodule update --init
make

Then you can run the emulator with:

./fab-agon-emulator

Changing VDP version

By default, Fab Agon Emulator boots with 1.04 firmware. To start up with 1.03 firmware, run:

./fab-agon-emulator --firmware 1.03

Other command-line options

Read about other command-line options with:

./fab-agon-emulator --help

Compiling for Windows

To build on Windows (mingw)

• Install rustup from https://rustup.rs/
• rustup toolchain install stable-x86_64-pc-windows-gnu
• rustup default stable-x86_64-pc-windows-gnu
• Install make winget install GnuWin32.Make
• add C:\Program Files (x86)\GnuWin32\bin to path
• Install mingw64 from https://github.com/brechtsanders/winlibs_mingw/releases/download/13.2.0mcf-16.0.6-11.0.1-ucrt-r2/winlibs-x86_64-mcf-seh-gcc-13.2.0-llvm-16.0.6-mingw-w64ucrt-11.0.1-r2.zip
• extract to C:\mingw64 and add C:\mingw64\bin to path
• get SDL2 from https://github.com/libsdl-org/SDL/releases/download/release-2.28.3/SDL2-devel-2.28.3-mingw.zip
• extract to C:\Users<user>.rustup\toolchains\stable-x86_64-pc-windows-gnu
• copy SDL2.dll to the root of the project
• run make in the root of the project
• manually copy built vdp*.so files from userspace-vdp to the root of the project
• run cargo run --release in the root of the project