Fork of https://github.com/fox32-arch/fox32, mirrored at https://github.com/xeniagda/fox32-mirror

Go to file

Ry 30f76602a7 Add support for cross-compiling for Windows		2022-12-26 17:22:48 -08:00
.github/workflows	Build Linux binaries of each commit	2022-10-26 18:49:26 -07:00
docs	Update README	2022-10-26 18:21:15 -07:00
src	Add support for cross-compiling for Windows	2022-12-26 17:22:48 -08:00
.gitignore	Generate fox32rom.h dynamically	2022-10-26 18:11:59 -07:00
LICENSE	Update license	2022-10-26 18:20:55 -07:00
Makefile	Add support for cross-compiling for Windows	2022-12-26 17:22:48 -08:00
README.md	Better argument parsing	2022-10-27 15:30:50 -07:00

README.md

fox32

fox32 (stylized in all lowercase) is a 32 bit fantasy computer architecture, with a custom operating system and user interface inspired by various classic computers.

Getting Started

Note: This software is still very much in an early stage, and is currently more focused towards developers rather than end-users.

Stable releases are available on the Releases page.

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

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.

Usage

The following arguments are valid: - --disk <file>: mount the specified file as a disk - --rom <file>: use the specified file as the boot ROM. if this argument is not specified then the embedded copy of fox32rom is used - --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 for information about the instruction set.

License

This project is licensed under the MIT license.