MIC-1 is a simple simulator for the MIC-1 CPU, which was originally described in Andrew S. Tanenbaum’s textbook Structured Computer Organization
Table of Contents
MIC-1 Simulator is an interactive simulator for the MIC-1 CPU. The application is primarily intended to be used by the students of the Faculty of Electrical Engineering in Sarajevo, but everyone is welcome to use it. The idea is that the user, while using the application, gains a better understanding of the principles behind the MIC-1 CPU. The user is able to write code using the supported instruction set, to run the code and to see it being executed through the CPU cycles and/or sub-cycles. While the instructions are being executed the user can keep track of the memory state, control memory state, CPU registers and the different CPU components.
Technologies used:
- JavaFX
- CSS
To run the application follow the steps below.
- First you'll need to install java version 11 or later. Download JDK 11 here.
- Download JavaFX 17 or later here. [optional, needed for cross-platform light .jar]
To run the application you will need to have Java installed, as mentioned in the Prerequisites section. The preferred version is 11 since the app was built using this version.
Windows and Linux users have the option to download fat .jar files which include the needed JavaFX libraries. To run the light .jar file you will need to download JavaFX as explained in the Prerequisites section.
To run the light .jar (cross-platform) file follow these steps:
- Go to Releases
- Choose the latest release and download the MIC-1-Simulator.jar file
- Open up terminal and change directory to where you've downloaded the MIC-1-Simulator.jar file. For example:
cd C:\Users\UserName\Downloads
- Run the folowing command:
Change
java --module-path %PATH-TO-JAVAFX-LIB% --add-modules javafx.controls,javafx.fxml -jar MIC-1-Simulator.jar
%PATH-TO-JAVAFX-LIB%to the path of the lib directory in the javafx-sdk directory which you've downloaded earlier. For example:java --module-path C:\Users\UserName\Downloads\openjfx-17.0.1_windows-x64_bin-sdk\javafx-sdk-17.0.2\lib --add-modules javafx.controls,javafx.fxml -jar MIC-1-Simulator.jar
On Windows and Linux you can choose to run the fat .jar file which comes with the needed JavaFX libraries included. To do so follow these steps:
- Go to Releases
- Choose the latest release and download the MIC-1-Simulator_YOUR-OS.jar file
- Open up terminal and change directory to where you've downloaded the MIC-1-Simulator_YOUR-OS.jar file. For example:
cd C:\Users\UserName\Downloads
- Run the folowing command:
java -jar MIC-1-Simulator_YOUR-OS.jar
Note that YOUR-OS refers to your operating system, so for Linux download and run the MIC-1-Simulator_Linux.jar, and for Windows MIC-1-Simulator_Windows.jar.
On Windows you should also be able to run the fat .jar file as any other application with a double-click on the downloaded .jar file.
To be able to run the app with a double-click on Linux you will first need to make the downloaded .jar file executable. To do so, follow these steps:
- Open up terminal and change directory to where you've downloaded the MIC-1-Simulator_Linux.jar file. For example:
cd ~/Downloads
- Make the .jar executable by running the command:
chmod +x MIC-1-Simulator_Linux.jar
Now you should be able to run the app with a double-click.
These fat .jar files have been tested on Ubuntu 18.04.6 LTS, and on Windows 10 Version 21H2.
Feel free to contribute as much as you like. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Branch (
git checkout -b your-branch) - Commit your Changes (
git commit -m 'Add some Amazing Changes') - Push your Changes (
git push) - Open a Pull Request
Note that the branch naming convention should be as follows feature-your-feature for feature branches, and fix-your-fix for fix branches.
Distributed under the GNU General Public License, version 3. See LICENSE for more information.
Ajdin Becirovic - @Ajdin Becirovic - abecirovic3@etf.unsa.ba
Authors of icons used in the application: