Skip to content

A command line utility to create and test programs for the F8ful CPU

License

Notifications You must be signed in to change notification settings

commonkestrel/fateful

Repository files navigation

Fateful

GitHub Workflow Status (with event)

Fateful is a CLI tool foring with my custom CPU, F8ful. It contains an emulator and an assembler. Fateful can be installed through cargo via cargo install --git https://github.com/commonkestrel/fateful.

Assembler

The assembler can be used with the fateful asm or fateful assemble command to assembler f8ful assembly into f8ful machine code. The input and output are both optional, and default to stdin and stdout respectively.

Instructions

There are sixteen instructions in f8ful assembly.

Emulator

Tests

Peripherals

Peripherals are a way to extend the emulator, simulating a memory-mapped peripheral. This is through the use of dynamic library loading, so you can create a peripheral in any language that supports the C ABI.

There is a Rust crate (fateful_peripheral) to make creating peripherals easy.

About

A command line utility to create and test programs for the F8ful CPU

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages