Installation

The circuit simulation of the Guin-16 CPU was made using Logisim-Evolution, an open-source digital logic simulator, and requires the software to run. The Github repository contains information on downloading the software.

Once Logisim-Evolution is installed, you can clone or download my Github Repository, which contains a circuit file named capstone.circ as well as a folder titled ROMs that contains some tests and sample programs to run on the Guin-16.

Once you've downloaded capstone.circ, you can open Logisim-Evolution and open my CPU by navigating to File → Open → The location of your local version of my circuit.

Run a Program

Once the circuit loads, you can run a program by right clicking on the RAM component (as seen below) and clicking the Edit Contents option from the dropdown.

This will open a large file of hex values, but at the bottom there is an open button to select a pre-defined file to run. I have made some tests and a program named fib.txt that calculates the 19th value in the Fibonacci Sequence. You can also create your own programs using the Opcodes from the Instruction Set.

Once you've loaded your program into RAM, click the Simulate tab on the left side of the screen and click the middle option of the five clock options at the top of the menu. This will run the program in real time, and at a pretty quick pace. If you would like to step through the program one clock tick at a time, you can click the fourth option of the menu, which will progress the CPU by one clock tick.