Skip to content

jiweixing/aars

Repository files navigation

README

BIT-AARS : ARM Simulator in Java

1. Introduction

BIT-AARS is a ARM simulator for teaching designed by Pengxiang Li and Donghai Liao based on MARS ansd RARS, a MIPS simulator in Java and a Risc-V simulator in Java.

2. Supported Instructions

The most of basic instructions set ARM 7.3.
Directives and macro are supported.
A few pseudo-instructions are supportet. we noticed that it's not enough and will be enriched in the future version.
For specific support instructions, please refer to the help documentation.

3. Installing and Running

Java JRE 1.6 or above is required. Download jar file in directory .\bin and Run it from console

$ java -jar BIT-AARS.jar 

1
There are mainly four sections in the main UI.
The first and second section are menu and tool bar.
The third section is "Edit/Excute" section, in which you can edit your code or watch the simulation result.
The fourth section is a console to display the output and reports of assembling and simulation.

Here is an exmaple to show you how to use the simulator:
Click File→Open, and follow the instructions in section 4→(2) to find the examples. Copy and paste the example in the edit page.
2 3

Go to Run→Assemble to assemble the asm code. You will see the execute page, in which there are source code, basic format of each code, binary code, code address(section 1), the memory(section 2) of and registers(section 3).
4
5
Then all the work have been done. Just use run, step and other command in the tool bar(next to the assemble button) to run the code and watch the outcomes.

About the source code:

The main class is in Aars.java and other source codes are in help, images and Aars, in case anyone want to compile or read the code

4. Examples

(1. Open Aars.jar, find Help→Aars→Examples, where two example are presented.
(2. Open directory .\asm_examples. More examples will be found to implement Bubblesort and calculate fibonacci.

5. Future Work

More pseudo-instrucions to be added.
Syscall will be adjusted to follow the general use of register in ARM

Please feel free to contact us([email protected]), if you have any questions about this project.

About

BIT-AARS - ARM Assembly and Runtime Simulato

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published