Skip to content

Latest commit

 

History

History
59 lines (38 loc) · 2.06 KB

README.md

File metadata and controls

59 lines (38 loc) · 2.06 KB

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.

Microarchitecture diagram

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.