emulator

An emulator that utilizes its own instruction set arcitecture and even comes with an assembler.

You can use this emulator as an entry into learning assembly, or even model your own emulator after this for educational purposes.

Installation

To get started simply clone this repository

git clone https://github.com/Jelvani/emulator

Usage

To get started, navigate to the directory of the reposity in Linux and run:

make

Now that the code is compiled, you can run the sample fibonnacci program that comes with the repository. First you must use the assembler to generate the machine code that is to be run:

./assembler fibonacci.txt

This will produce a file called output.txt

This file contains the machine code generated by the assembler. We can now have the emulator run this program by calling:

./vm output.txt

You should see an output containing the state of each register after the execution of each intruction.

Release History

• 0.0.5
  • Alpha Release
  • TODO: Add access to memory

Authors

• Alborz Jelvani - Initial Work - Personal Website

Contributing

1. Fork it (https://github.com/Jelvani/emulator)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request