Skip to content

LoungeCPP/pir-8-emu

Repository files navigation

pir-8-emu TravisCI build status AppVeyorCI build status Licence Crates.io version

Implementation of the pir-8 ISA.

Installation

From Crates.io

Start by obtaining Rust from https://rustup.rs, and BearLibTerminal. Afterwards, run

cargo install pir-8-emu

After the installation process finishes, move onto the manpages to see how to emulate or {dis,}assemble your code.

If you've encountered a problem during the installation, do not hesitate to open an issue here.

From Debian repository

The following line in /etc/apt/sources.list:

deb https://debian.nabijaczleweli.xyz stable main

With my PGP key (the two URLs are interchangeable):

wget -O- https://debian.nabijaczleweli.xyz/nabijaczleweli.gpg.key | sudo apt-key add
# or
sudo wget -O/etc/apt/trusted.gpg.d/nabijaczleweli.asc https://keybase.io/nabijaczleweli/pgp_keys.asc

Then the usual

sudo apt update
sudo apt install pir-8-emu pir-8-emu-binutils pir-8-emu-devel

will work on x86_64 and i686.

pir-8-emu includes the emulator, and is the only package that depends on libbearlibterminal, which is also included in the repository.
pir-8-emu-binutils contains the {dis,}assembler, and
pir-8-emu-devel has the example and devel header for emulated hardware components.

See the repository README for more information.

From pre-built executables

Alternatively, have a glance over at the releases page, which hosts Windows and Linux x86_64 binaries, including BLT.

Installation should be a matter of downloading and unpacking them, and copying somewhere to your $PATH and/or $LD_LIBRARY_PATH.

Special thanks

To all who support further development on Patreon, in particular:

  • ThePhD