fox32

(logo by ZenithNeko)

This is the reference emulator of the fox32 platform. See the organization root README for general details.

Getting Started

Quick setup: See the build-all repository to quickly get a working fox32os environment.

Prebuilt Linux binaries of the latest commit are available on the GitHub Actions page.

Releases available on the Releases page are very outdated at the moment and should not be used.

Building

Download the latest release or commit of fox32rom, and place the downloaded fox32.rom file into the root directory of this repo. Then simply run make. The resulting binary will be saved as fox32. Optionally you may build for a different target with make TARGET=<target>, see the Makefile for details.

Usage

The following arguments are valid:

• --verbose: print runtime logs about the options specified below
• --disk <file>: mount the specified file as a disk
• --rom <file>: use the specified file as the boot ROM; defaults to embedded copy of fox32rom
• --memory <mib>: specify the amount of memory in MiB; defaults to 64 MiB
• --scale <multiplier>: scale the display window; can be set at compile time with make SCALE=<multiplier>
• --filtering <mode>: set scale filtering mode for high DPI displays
  • 0 = nearest pixel (default)
  • 1 = linear filtering
• --debug: print a disassembly of each instruction as it runs

The most common use case is passing the fox32os disk image as the first disk: ./fox32 --disk fox32os.img

See encoding.md and cpu.md for information about the instruction set.

License

This project is licensed under the MIT license.