Sovereign 8s.is mirror of standardgalactic/pARMesan
  • C 95.3%
  • Python 4.2%
  • Makefile 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2023-05-14 13:47:43 -04:00
docs update docs 2023-05-14 13:46:14 -04:00
lib fixed RET entry in CHGSTAT_LOOKUP table 2023-05-14 13:39:52 -04:00
src added QoL warning log and a todo 2023-05-14 12:57:09 -04:00
tests Updated all tests to use new addressing syntax and version 6 binaries 2023-05-14 13:40:16 -04:00
.gitignore Moved TODO section to a private TODO.md file 2023-03-13 22:00:30 -04:00
Makefile updated 'evaluate' target 2023-03-05 18:19:34 -05:00
README.md Bump up version in README 2023-05-14 13:46:38 -04:00
run_tests.py during evaluation, fatal log messages are also redirected to .out file 2023-03-07 20:29:58 -05:00

pARMesan

Project Status

The architecture specification is at version 1.1.
The simulator implements architecture specification 1.1. The PARM File Format is currently at revision 6.
The FETA memory image format is currently at revision 1.

General Info

pARMesan is a 16-bit CPU architecture based on AArch64 but with some x86 inspiration. It's meant to be an academic project to get some experience with the nuances of designing an architecture. A pARMesan CPU has 8 general-purpose 16-bit registers and a 16-bit instruction pointer. It can address 64KB of byte-addressable ram, and has support for memory-mapped IO. More detailed documentation can be found in the docs. This repo also contains a C implementation of the architecture.

A Rust implementation of this CPU is planned, and a little work has been done towards that project, found in it's Git repo: bytesize.

An assembler for this ISA is available, called cheesegrater. It is still in the early stages of development, and does not yet have good documentation. It is currently able to assemble some simple programs, which can be found in that repository.

Usage

First, build the project by running make all. This will generate the binary parmesan in the root directory. Now you can run the emulator on an executable via parmesan FILENAME. Run parmesan -h for a more complete list of commands.

Test Format

Each test is a single directory containing the assembly file in SWISS format, a file containing the expected output, and the executable file (currently in PARM format). Optionally, a directory can also contain a FETA memory dump file which will also be incorporated into the test.

After running the test(s), output will be stored in a .out file in the output directory.