https://github.com/joeyh021/patp

An assembler and emulator for the simple assembly language set out by the PATP specification.
https://github.com/joeyh021/patp

assembly emulator rust

Last synced: 2 months ago
JSON representation

An assembler and emulator for the simple assembly language set out by the PATP specification.

• Host: GitHub
• URL: https://github.com/joeyh021/patp
• Owner: Joeyh021
• License: mit
• Created: 2020-12-08T13:40:18.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-05-14T23:46:14.000Z (over 2 years ago)
• Last Synced: 2024-10-14T12:37:01.865Z (2 months ago)
• Topics: assembly, emulator, rust
• Language: Rust
• Homepage:
• Size: 61.5 KB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

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](Specification.md).

## Usage

The program can be installed with `cargo install patp` . If you don't already have cargo installed, see [here](https://www.rust-lang.org/tools/install) for instructions on how to install rust and cargo.

- `patp emulate ` will execute a binary file and return the final CPU state

- `patp assemble ` will assemble the `.patp` file and create a new binary file

- `patp run ` 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.