Assembly-interpreter

This is a 32-bit computer architecture simulator that compiles and runs assembly code defined by the architecture.

Purpose

The intention of the project is to understand how modern computers work.

It's possible to define new microinstructions for the computer following the model in examples/firmware3.hpp, save the microinstruction address in src/assembler/consts.hpp, add them to the array of instructions, and set them into the set_ops(string& line, unsigned long int &oper) function found in src/assembler/assembler.cpp.

Microarchitecture

The model of the microarchitecture is based on the book "Structured Computer Organization" by author Andrew S. Tanenbaum. The instruction set can be found in examples/firmware3.

Here is an illustration of the microarchitecture in a diagram.

Usage

Prerequisites

• GNU C++ Compiler (g++)
• GNU Make installed

On Debian-based Linux distributions, run sudo apt install make g++

How to run?

1. Clone the repository:

   git clone https://github.com/WandersonSoares00/Assembly-interpreter
   

2. Change the directory:

   cd Assembly-interpreter
   

3. Compile the project:

   make all
   

4. Generate a binary of a .asm program with the assembler. Take the program questions/fat.asm as an example, run the following command:

   ./assembler questions/fat.asm outBin
   

5. Copy the binary into memory and run a computer:

   ./comp outBin
   

   By default, the computer prints the words 1 and 2 of memory in the screen to simulate the standard output.

License information

This project is licensed under the GNU General Public License v3.0.