Python 3 [the script installs the remaining requisite libraries] Do not use Homebrew to install Python3. Rust and Cargo [Rust's package manager. Install via rustlang website]
In order to install the simulator and use it, use the Source code option to download the directory needed to build the application on your computer.
Once you unzip the source and navigate to its inner folder, run the following command with your terminal:
sh run.sh
This will install the requirements for the simulator and run PyInstaller to create an executable.
Once the script is finished, you can run the application file in the dist folder within this inner folder [i.e. app.exe for Windows, app.app for MacOS], and this will let you run the application.
You can open files with the Open File option, and select a file with .s or .legv8 with valid LEGV8 assembly to run it. You can step or reset, and all the text entry fields let you add values for memory or registers in the respective views. Errors show up in the errors section on the simulator and deeper errors with the program go in the logfile that is in the dist directory after the app runs. You must hit return to confirm your edits to any registers or memory. Note that you need to enter arrays in manually for running code on arrays, with addressing done manually. A config file system is planned for next release.
You can open an Issue on GitHub here and add screenshots of the simulator and logfiles or contact me at aramachandra[at]umass[dot]edu with this information if there's a deeper error with your code running with the simulator.
Check the legv8sim.tex file as an overview of the system's goals.
Not really a version of the simulator, but rather Sublime editor's highlighting syntax defined so that I can use a particular parsing library that got put into a package. Future verison(s) will include support for more code editors to have LEG-V8 syntax highlighting.
Vim syntax highlighting, to make legv8sim editor-agnostic in terms of development so that you can edit the files on most of the common editors but you run it all on the same simulator. To view the source for this part of the project, go to the legv8-vim branch as they needed to be separated for reducing the bulk of the plugin.
VSCode syntax highlighting brings another editor that is supported with the syntax highlighting grammar designed in this project. To view the source for this part of the project, go to the legv8-vscode branch.
[demo of version 1.2's syntax highlighting]
Nano now supported! To view source, go to the legv8-nano branch.
[demo of version 1.3's syntax highlighting]
- Huge thank you to @generic-github-user for design advice (this would be substantively more ugly without your genius)
- LEG-V8 Green Card
- Computer Organization and Design: The Hardware/Software Interface ARM Edition by D. Patterson and J. Hennessy, Morgan Kaufmann, 2016. ISBN: 978-012-8017333.