Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install patp

It will make the patp command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall patp uninstalls.

Back to the crate overview.

Readme

PATP toolkit

This is an assembler and emulator for the PATP (Pedagogically Advanced Teaching Processor), a simple microprocessor designed for teaching CS132 Computer Organisation and Architecture at The University of Warwick. The processor specification and assembly language documentation is outlined in the specification.

Usage

The program can be installed with cargo install patp . If you don't already have cargo installed, see here for instructions on how to install rust and cargo.

patp emulate <file> will execute a binary file and return the final CPU state
patp assemble <file> will assemble the .patp file and create a new binary file
patp run <file> will assemble and then execute a file

If you'd prefer to download the source and compile yourself, clone the repo and run cargo build. cargo test will also run all the unit test, verifying the correctness of the assembler and emulator.