aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 50ddb63e6e9dc9907b23733235c638fe58256785 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# MicSim

Hi! Welcome to MicSim project repo. MicSim is a Mic-1 architecture simulator written in python. It is specially design for studying purpose. 

### How it works ?
It is simple, you have to:
 1. Clone the repo
 2. Execute micsim.py
 3. Enjoy !

### I want to know more about it....
All the architecture components are located in _components_ folder:
 - **ijvm.py** Contains standard IJVM constant
 - **microprogram.py** Contains IJVM implementation that use Mic-1 architecture
 - **caretaker.py** Hold all the Mic-1 architecture components (registers, ram etc..)
 - **ram.py** Contains a simple RAM implementation

### How to load code in memory ?
Simply by editing **ram.txt**. Each line corresponding to a byte entry starting from address 0x0 to whatever to $+\infty$ . Each line can be an IJVM _opcode_ or a random byte. Here is an example of how to add two number:

> BIPUSH<br />
> 12<br />
> BIPUSH<br />
> 5<br />
> IADD<br />