Ptools

The tools

Find the documentation for the tools here:

• Assembler: Assembles PASM programs into intermediate PASM programs (resolved labels, base instructions only), or ASCII representations of PISA binaries, or actual PISA binaries.

• Disassembler: Disassembles PISA binaries to basic PASM programs.

• CPU simulator: An ISA simulator to simulate the execution of PISA programs on a PISA processor. Shows the final processor state, the instruction-by-instruction traces and has a debug mode.

• RAM Init: Initializes RAM images from a textual description of the RAM. Meant to be used to generate initial RAM images to feed the CPU simulator.

• HDL simulator: Simulating circuits described using PHDL.

Installation

The build.sh script can be used to build all the executables (using dune build). It places them all in the executables directory. Add it to your PATH to invoke the executables from any directory.

λ:~/ptools⟩ ./build.sh 
Buliding executables...
Assembler        :    Build successful.
Disassembler     :    Build successful.
CPU simulator    :    Build successful.
RAM Init         :    Build successful.
HDL simulator    :    Build successful.
Building successful. Placing executables in ./executables
Script executed.

λ:~/ptools⟩ ls -l executables
assembler
cpusim
dis
hdl-simulator
ram-init

Source code

The source code for all of the tools can be viewd on our GitLab repository.