lulzzz / vulcan Goto Github PK

This project forked from vmmc2/vulcan

0.0 1.0 0.0 2.48 MB

RISC-V Instruction Set Simulator (Built for education).

License: MIT License

Kotlin 0.08% HTML 1.73% Swift 0.25% Objective-C 0.02% Dart 97.78% CSS 0.13%

vulcan's Introduction

Vulcan

RISC-V Instruction Set Simulator Built For Education.

RV32I Extension.
Visualization of programming counter(pc), machine code and original instructions side-by-side.
Embedded editor inside Vulcan.
Integer registers visualization.
Single precision floating-point registers visualization.
Memory visualization.

Unfortunately, by the time that I did the initial version, Flutter Web does not support responsive web apps. Because of it, one must use Vulcan in fullscreen mode. Otherwise, the app will throw overflow exceptions.

You must be familiar with RISC-V Assembly in order to use Vulcan properly. If you want to learn about it, you can check the documentation folder inside this repository.

You must go to the "Editor" tab and write your code inside the editor. When you are done, press the "Simulate" button.

First of all, you must install the Dart SDK in your computer: https://dart.dev/
Then, you need to install the Flutter framework: https://flutter.dev/
Since Vulcan is a Flutter WebApp, you must install the Web extension. More info can be found here: https://flutter.dev/docs/get-started/web
After that, you can download this repository as a zip folder. Extract it in your machine. In the command line, get inside it and finally run the following command:

flutter run -d chrome

If you find any bugs, errors or strange behavior, feel free to open an issue. The only thing that I ask is to provide a detailed explanation of the bug/error/strange behavior. If possible, provide a screenshot.